XMetaL brukerveiledning

Dette dokumentet gir en introduksjon til bruk av XMetaL author versjon 4 for brukere ved UiO. XMetaL er en editor for å redigere XML-dokumenter. I denne sammenhengen er det fokus på hvordan du kan redigere XML-dokumenter som ligger på webområder som bruker Vortex. XMetaL benyttes først og fremst til spesialtilpassede XML-baserte publiseringsløsninger ved UiO slik som Administrative håndbøker. Programvaren kan installeres på lokal maskin (kun for Windows), og er også tilgjengelig på terminalserver.

Før du starter med å redigere Vortex-dokumenter i XMetaL anbefaler vi deg å lese gjennom veiledningene som beskriver hvordan du via nettleseren administrerer mapper, dokumenter, rettigheter mm: Vortex hjelp, Webredigering av XML-dokumenter i Vortex og Administrasjon av webdokumenter.

Innhold

• Å komme i gang
• Åpne og redigere dokumenter i XMetaL
• Grunnleggende om XMetaL
• Vise dokumentet med og uten koder
• Sette inn elementer (Element list)
• Sette inn attributter (Attribute inspector)
• Validere dokumentet
• Ordliste
• Hjelp

Å komme i gang

Se informasjon i programvaredatabasen for hvordan du får XMetaL installert på lokal maskin. Du starter programmet ved å velge "XMetaL Editor" fra Start-menyen eller ved å klikke på ikonet på skrivebordet se figur:

Alternativt kan du logge inn på terminalserveren 'antilope' og bruke programmet der. I programvaredatabasen finner du også informasjon om hva som skal til for å få tilgang til XMetaL på 'antilope'. Du finner kommandoen for å opprette forbindelse til terminalserveren via Start-menyen og logger inn med ditt vanlige brukernavn og passord, se figur:

Åpne og redigere dokumenter i XMetaL

Du kan åpne, redigere og lagre XML-dokumenter i Vortex. For å redigere dokumenter starter du med å finne fram til riktig sted på web, f.eks. http://www.uio.no/admhb/reglhb/it og klikke på "administrer dette dokumentet" nederst i høyre hjørne, se figur:

Under arkfanen 'Om dokumentet' finner du en WebDAV adresse, eks https://www-dav.uio.no/admhb/reglhb/it/index.xml. Dette er adressen du skal bruke for å åpne, redigere og lagre dokumenter i XMetaL, se figur:

• Kopier redigerings-urlen (WebDAV adressen)
• Start XMetaL, velg "Open" fra "File-menyen" og lim inn redigerings-urlen, se figur. Du vil da få opp dokumentet i XMetaL samtidig som det låses slik at andre brukere ikke kan redigere på det samtidig. Det låses opp igjen når du lukker dokumentet med "Close" eller avslutter XMetaL med kommandoen "Exit".
  

• Rediger dokumentet i XMetaL
• Lagre dokumentet ved å velge "Save" fra "File-menyen" og vips så er endringene tilgjengelig i web.

Dersom du ønsker å opprette et nytt dokument i Vortex og redigere dette i XMetaL gjør du dette på samme måte som for andre dokumenter i Vortex. Bruk en av malene for tomt XML-dokument (tom.xml) eller spesialtilpasset mal, eksempelvis mal som brukes i Administrative håndbøker (reglement.xml).

For å opprette et nytt dokument må du

• Administrere mappen du ønsker at dokumentet skal ligge i.
  
• Velge "Nytt dokument" oppe til høyre på i flappen "Innhold i mappen".
• Velg f.eks. tom.xml i listen over dokumenttyper. Gi dokumentet et passende navn, eks index.xml (skal alltid slutte med '.xml') og klikk på "Opprett".
• Under arkfanen 'Om dokumentet' vil du nå finne WebDAV adressen til dokumentet, og det kan redigeres på samme måte som nevnt over for eksisterende dokumenter.
  

Grunnlegende om XMetaL

For å redigere dokumenter i XMetaL er det noen kommandoer du må kjenne til. Noen av disse vil du kjenne igjen fra andre programmer, slik som "Open", "Save", "Undo", "Redo", "Copy", "Paste" og "Exit". Her omtales de viktigste kommandoene som kommer i tillegg til disse.

Det er også noen grunnleggende funksjoner i XMetaL du bør kjenne til. Figuren viser et XML-dokument som er åpnet i XMetaL, og vises med "Tags on". Eksempel på start- og sluttkode er markert med rødt. Det er pil til der markøren (cursor) er plassert og til hvilke elementer som vises i "element list" som mulige elementer å sette inn i dokumentet. I dette tilfellet er markøren innenfor et avsnitts-element, og det er mulig å sette inn elementer for fet, fotnote, kursiv og weblenke. Hvilke elementer som er mulige vil variere avhengig av hva slags type dokument du redigerer. Når du flytter markøren rundt i dokumentet vil du se at elementene i elementlista varierer. Dette eksemplet er hentet fra maler/koder som er tilrettelagt for Administrative håndbøker.

Vise dokumentet med og uten koder

Ved å velge kommandoer i "View"-menyen kan du se dokumentet i ulike views, se figur under. Det er fire muligheter, hhv "Plain text" for å vise innholdet som ren tekst, "Tags on" for å fremheve kodene i teksten, "Normal" for å vise innholdet uten kodene og "Page preview" for å vise innholdet i Internet explorer. Den siste er beregnet på at det er tilrettelagt stilark i CSS for å definere layouten.

Innholdet i dokumentet endres ikke selv om du ser på det i ulike "views". Når du redigerer skal du bruke "Tags on" slik at du får fremhevet start- og sluttkodene.

Sette inn elementer (Element list)

Alt innhold i dokumentet skal skrives innenfor ett eller flere elementer. Elementene fungerer som merkelapper på informasjonen, og de vil variere for ulike dokumenttyper. For et emne kan merkelappene være emnekode, studiepoeng, anbefalte forkunnskaper etc. For et reglement kan merkelappene være saksbehandler, dato etc. Du bør kjenne til hvilke elementer som er akutelle å bruke i XML-dokumentet du skal redigere i.

XMetaL viser til enhver tid hvilke elementer du kan sette inn i dokumentet. Dersom du flytter markøren rundt i dokumentet vil du se at du får fram ulike valg i listen over elementer. For å få fram listen over mulige elementer velger du "Element list" fra "View-"menyen eller "Element" fra "Insert"-menyen, se figur under.



For å sette inn et element dobbeltklikker du på det elementet du ønsker å bruke fra elementlista eller merker ønsket element og trykker på "apply"-knappen. Når du har valgt et element kan du skrive direkte inn i dette eller velge et nytt element.

Elementene er satt sammen som et hierarki der kun bestemte elementer er lovlige innenfor andre elementer. Det er f.eks. ikke lov til å sette inn "tittel-element" i "epost-element", mens det er lov å sette mange elementer inn i et "avsnitt-element".

Sette inn attributter (Attribute inspector)

I tillegg til Elementlista finnes det en attributtliste over mulig tilleggsinformasjon til elementene. Sett markøren innenfor det elementet som du ønsker å redigere og velg Attribute Inspector fra View-menyen for å få fram oversikt over attributtene.

Du får da fram et eget vindu som viser hvilke attributter som gjelder for det elementet du har markøren innenfor.

Validere dokumentet

All kode som er i filene følger spesielle regler (XML-skjema). Disse reglene skal det være vanskelig å bryte, men det kan skje feil i koden. Hver gang du lagrer et dokument vil det bli testet for feil. Det er også mulig å kjøre en slik test manuelt ved å velge "validate document" fra "tools"-menyen eller ved å trykke F9, se figur under.

Dersom det er noe feil i kodingen vil du få tilbakemelding på det med henvisning til hvor i dokumentet det er oppdaget en feil. Dersom dokumentet er uten feilkoding vil du får melding om at dokumentet er "sucessfully validated".

Ordliste

I utgangspunktet er det et sett med ordlister som følger med programmet når XMetaL installeres, derav engelsk. For å få norsk ordliste tilgjengelig er det noen tilleggsfiler som må kopieres fra P: til riktig mappe i ditt oppsett (P:\lisens\xmetal\xmetal4\xmetal\program
files\Corel\Shared\XMetaL\Writing Tools\10.0\wt10no.lex til C:\Program Files\Corel\Shared\XMetaL\Writing Tools\10.0).

Du bruker ordlister ved å velge "Spell Checker" fra "Tools"-menyen.

Hjelp

I "Help"-menyen finner du ytterligere informasjon om muligheter i XMetaL.

---

Redaksjon: XML-gruppen, saus-xml@usit.uio.no
Dokument opprettet: 26.06.2006, endret: 22.06.2007Administrer dette dokumentet