Systemmanual Corda/Instrato 7.0 – administrator
   [For Judith: QR-kode « (⇧) » CordaFont-eksempler]

CordaFont

CordaFont gjør det mulig å endre tekstegenskaper i en og samme tekstboks (CordaFont er ikke mulig å bruke i Tekstfelt, kun i Tekstboks). Admin styrer dette ved hjelp av noe vi kaller en «CordaFont-tag». Den kan se slik ut:

<CordaFont font="Helvetica" size="10" leading="12">

All tekst etter denne taggen vil få egenskapene som er angitt her. Det er veldig viktig at CordaFont skrives på akkurat denne måten. Det er ikke nødvendig å ha "" rundt verdiene untatt i tilfeller der navnet inneholder mellomrom. Men å bruke "" er en veldig fin vane å legge seg til. Egenskaper som ikke angis i taggen hentes fra egenskapene til tekstboksen eller fra forrige CordaFont-tag.

ps. Dette er en liten funksjonsendring fra gamle Corda-versjoner. I versjon 1.6-2.1 ble noen av verdiene som tidligere var definert av en CordaFont-tag «opphevet» og hentet fra tekstboksen når man kun skrev <CordaFont>. Det fungerte noe inkonsekvent, og ble derfor endret fra og med versjon 3.0. Men det vil si at på en server som er blitt oppgradert fra 2.1 (eller eldre) til 3.0 (eller nyere), bør man gå igjennom elementer som har brukt denne funksjonen og oppdatere disse.

CordaFont-generator
CordaFont-generator

CordaFont-generator

Når du oppretter eller redigerer en tekstboks, vil det ligge en «CordaFont-generator» til høyre for verdi-feltet. Her ligger valg og innskrivingsfelter for alle mulighetene du har. Når du endrer noe, f.eks. endrer font, vil korrekt tag bli generert i boksen under. Kopier denne, og lim den inn der du trenger den i verdi-feltet til venstre.

Følgende CordaFont-tagger kan brukes:

  • Font
    Settes med koden «font=», «fontname=» eller «name=». Fontnavnet som skrives inn må skrivesnøyaktig slik som du finner den i fontlisten. Med mellomrom, strek, understrek og det hele. Fonten trenger ikke å være aktivert i Fonter.
  • Fontstørrelse
    Settes med koden «size=» eller «fontsize=». Størrelsen oppgis i punkt eller i prosent. Når tallet angir punktstørrelsen skrives bare tallet inn, men skal tallet angi prosent, må %-tegnet inn etter tallet: size="80%". Ved bruk av prosent vil fontstørrelsen bli prosent-andelen av punktverdien du har fylt ut på tekstboks-egenskapene eller den forrige CordaFont-taggen.
  • Linjeavstand
    Settes med koden «leading=» eller «linespace=». Setter ny linjeavstand. Verdien oppgis i punkter, men den kan også oppgis i prosent, f.eks. leading="120%" for å få Quark-standard. Tag med linjeavstand må settes på den linjen den skal gjelde for.
  • Understrek
    Settes med koden «underline=» og verdi "true" eller "false". Taggen settes foran og bak et ord eller en setning som skal ha understrek:
    «Et <CordaFont underline="true">{{eksempel}}<CordaFont underline="false"> hvor en variabel blir understreket, men ikke teksten rundt.»
  • AvoidBreak
    Settes med koden «avoidbreak=» og verdi "true" eller "false". Taggen settes foran og bak et ord eller en gruppe av ord som ikke skal linjedeles.
  • Horisontal skalering
    Settes med koden «horscal=» og setter ny verdi for horisontal skalering. Default er 100 %. En verdi under 100% smalner teksten, og en verdi over 100% gjør teksten bredere. Det er ikke mulig å skalere tekst i Corda på noen annen måte enn ved hjelp av CordaFont. Alternativet er å laste opp en modifisert font-fil der fonten er blitt skalert.
  • Kerning
    Settes med koden «kerning=» og setter ny kerning. Negativt tall kniper teksten, mens positivt tall sperrer.
  • Justering
    Settes med koden «alignment=» eller «justify=» og kan ha disse verdiene for justering av teksten etter taggen: left, right, center, justify eller forcejustify. Forcejustify prøver i det lengste å også blokkjustere siste linje i et avsnitt.
  • Fontfarge
    Settes med koden «color=» eller «colour=» og setter ny farge på fonten. Fargen må være opprettet i Farger og i likhet med Fonttyper må navnet skrives inn nøyaktig slik navnet er angitt i «Farger».
  • Fyllmønster
    For den valgte fargen er det mulig å definere hvordan farge skal presenteres. Dette styres med to CordaFont-tagger: «textrendering=» og «strokewidth=». Textrendering kan ha én av følgende tre verdier: both (default), fill eller stroke. Strokewidth har en tallverdi for strektykkelse som angis i punkter. Dersom fargen har et fyllmønster vil disse valgene være viktige for å unngå å få strek rundt bokstavene.
  • Strekfarge
    For å kunne «outline» en tekst, bruk «strokecolor=» og fargenavn fra Corda-farger. For å definere tykkelsen på streken, bruk «strokewidth=». Dersom «strokecolor» brukes uten å definere «fillcolor», blir fyllfarge gjennomsiktig.
  • Strektykkelse
    Defineres med «strokewidth=», og angis i punkter. Brukes sammen med «strokecolor».
  • Fyllfarge
    Defineres med «fillcolor=» og fargenavn fra Corda-farger. «fillcolor» brukes sammen med «strokecolor» dersom fyll ikke skal være gjennomsiktig.
  • Textrendering
    Når én av funksjonene for fyll- og/eller strekfarge brukes, må ofte taggen «textrendering=» også legges til. Denne styrer hvordan fyll og strek skal presenteres. Verdi her er enten «fill», «stroke» eller «both». Textrendering må defineres etter at farger er definert i taggen.
  • Understrek
    Hvis man ønsker å bruke en annen farge enn tekstfargen på understrek valgt i editor, gjøres dette ved å sette «fillcolor=» og «strokecolor=». Tekstfargen bestemmes av «fillcolor», strekfargen av «strokecolor». I tillegg kan man endre tykkelse på understrek og avstand fra teksten ved å bruke kommandoene «underlinewidth=» og «underlineposition=». De to sistnevnte defineres i henholdsvis antall punkter og prosent. NB: For at dette skal vises korrekt, må «textrendering» være satt til «fill» og plasseres sist i CordaFont-tagen. Les mer.
  • Droppskygge
    En tekst kan ha droppskygge. Denne er ikke uttonet, men kan være transparent. Dette styret med CordaFont-taggen «shadow=». Her defineres 4 variabler adskilt med semikolon: "horisontal justering;vertikal justering;fargenavn;opasitet". f.eks. shadow="10;10;Process Black;30" Verdien som skrives inn som horisontal/vertikal justering er en % av fontstørrelsen som skyggen skal plasseres i forhold til teksten. Positiv verdi plasserer skyggen over / til høyre. Negativ verdi plasserer skyggen under / til venstre.
  • Venstre innrykk
    Settes med koden «leftindent=». Angis i millimeter. Etter denne taggen vil all tekst få et venstreinnrykk. Denne taggen kan brukes til å lage hengende inntrykk. Se eksempel 6 på neste side. (For å lage punktlister, kan man bruke «* » i starten på linjen. Innrykk vil da være lik linjeavstand på tekstboksen). Innrykket nullstilles ved å sette leftindent="0".
  • Høyre innrykk
    Settes med koden «rightindent=». Angis i millimeter. Etter denne taggen vil all tekst få et høyreinnrykk. Innrykket nullstilles ved å sette rightindent="0".
  • Linjal
    Gjør det mulig å benytte tabulator i en tekstboks. Settes med koden «tabstop=». Du setter alle tabulatorstoppene i én tag, og lister dem opp mellom en strek "-".
    F.eks.: <CordaFont tabstop="5L-15R-30C-40D" decimal="44">. 
    Det første tallet i hver tabulatorstopp er avstand i millimeter fra tekstblokkstart og bort til tabulatoren. Bokstaven (L, R, C eller D) angir hvordan teksten under tabulatoren skal justeres (left/right/center/desimal).
    Taggen «decimal=» (eller «desimal=») definerer hva som er desimal-tegnet med ASCII-koden til dette tegnet. 44 er ASCII-koden for komma (se ASCII-tabell). Standard desimaltegn er punktum, og trenger derfor ikke å defineres i «decimal».
    I tekstboksen må du i steden for å trykke tabulator på tastaturet, skrive inn kommandoen «\t» for tabulator. Tabulatorstoppene vil gjelde for tekstboksen helt til du definerer nye tabstopper, eller til du setter <CordaFont tabstop="0">
  • Leader
    Bruker sammen med linjal/tabstop for å angi at den tabulator kan ha fylltekst foran seg på linjen. Leader settes med «leader=», og kan være ett eller flere tegn. For eksempel «.» (punktum) eller « -» (mellomrom+bildestrek). Leader-definisjonen gjelder kun den første tabulatoren etter at leader er satt. Det er per i dag ikke mulig å definere at leaderen skal gjelde en bestemt satt tabstop. For å lage en meny eller innholdsliste hvor hver linje har en leader, må det dermed per i dag lages variabler for hver linje. Se eksempel 7 på neste side.
  • Textrise
    Settes med koden «textrise=» og hever eller senker teksten. Positivt tall hever, og negativ tall senker. Kan kombineres med fontsize for å få sub- eller superskript (F.eks. 102). Når teksteditoren i Corda setter superscript automatisk brukes disse verdiene: <CordaFont fontsize="70%" textrise="30%">
    For å gå tilbake til normal font igjen: <CordaFont fontsize="142.8%" textrise="0"> (fontsize kan selvfølgelig også settes til den punktverdien teksten hadde i utgangspunktet).
  • Encoding
    Settes med koden «encoding="builtin"» og må settes i taggen dersom fonten er en ornament-font, f.eks. Zapf Dingbats. Brukes ikke denne taggen er det encoding="WinAnsi" som gjelder og som er den som brukes som default/automatisk. Så det er bare i tilfeller der en ornamentfont skal brukes at du trenger å bekymre seg for encoding-taggen. Må brukes sammen med «textlen» (under).
  • Textlen
    Må brukes sammen med koden «encoding="builtin"» og må settes i taggen dersom fonten er en ornament-font, f.eks. Zapf Dingbats. Verdien angir antall tegn, inklusive ev. mellomrom, fram til neste CordaFont-tag med ny font, eller tekstslutt. Se eksempel 5 på neste side.
  • Functions
    OpenType-fonter kan inneholde tegnvarianter som kan styres av CordaFont, f.eks. SmallCaps, tallformat, ligaturer osv. Funksjoner settes med koden «functions=», f.eks. «functions="smcp"» for SmallCaps. Tilgjengelige funksjoner med eksempler kan sees her. Blant de viktigste funksjonene kan nevnes: «smcp», SmallCaps; «frac», formater 1/2 som ½; «onum», formaterer tall som «old-style»; «lnum», formaterer tall på majuskelhøyde; «sups», formaterer alle tall som superscript; «sinf», formaterer tall som subscript for brukt i kjemiske formler.
  • Avoidwordsplitting
    Støttes kun av pdfLib > 9.0. Hindrer orddeling i tekstflyten. Settes med koden «avoidwordsplitting=» og verdi "true" eller "false".

Se eksempler på bruk av CordaFont i neste kapittel. Se også et eksempel på bruk av variabler sammen med CordaFont i kapittelet Variabler eksempler.

OBS ved bruk av editor

Dersom tekstboksen inneholder flere variabler og er satt til å bruke editor, må størrelsen som er satt på tekstboksen og størrelsen som er satt som CordaFont-tag foran tekstboksvariablene som bruker editor, være den samme. Det samme gjelder fonten som er valgt. Når editoren skal velge hvilken font som er f.eks. halvfetfont, vil den sjekke hvilken font som er satt på tekstboksen, og bruke halvfetfont som er definert på denne fonten. Og når den skal gå tilbake til normal tekst igjen vil den se på tekstboksen for å finne størrelsen den skal sette på teksten.