summaryrefslogtreecommitdiff
path: root/instruktion.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'instruktion.mdwn')
-rw-r--r--instruktion.mdwn138
1 files changed, 111 insertions, 27 deletions
diff --git a/instruktion.mdwn b/instruktion.mdwn
index ca343b18..49a6e7da 100644
--- a/instruktion.mdwn
+++ b/instruktion.mdwn
@@ -4,61 +4,144 @@ Du kan skrive og redigere, formattere teksten samt oprette nye sider og henvisni
Du kan endvidere lægge billeder op.
##Skrivning og formattering
-Under 'Rediger' vises teksten i et redigeringsfelt. Se i første omgang, hvordan teksten her er opmærket, prøv at skrive et eller andet og markere det, og se effekten under 'Preview'. Når du har brug for flere muligheder for opmærkning, så kig i anden omgang under 'Formatting help'. Der findes flere muligheder end du ser der, men det skulle tilfredsstille de fleste behov.
+Under 'Rediger' vises teksten i et redigeringsfelt. Se i første omgang,
+hvordan teksten her er opmærket, prøv at skrive et eller andet og markere
+det, og se effekten under 'Preview'. Når du har brug for flere muligheder
+for opmærkning, så kig i anden omgang under 'Formatting help'. Der findes
+flere muligheder end du ser der, men det skulle tilfredsstille de basale
+behov.
-Selv om der er mulighed for det i systemet, så er det kun i orden på denne hjemmeside at udtrykke sig med tre niveauer overskrifter, altså H1, H2 og H3, udtrykt med hhv 1, 2 eller 3 havelåger (#), og en type fremhævelser (*). Store bogstaver er forbudt.
+Selv om der er mulighed for det i systemet, så er det kun nødvendigt med
+tre overskriftniveauer, H1, H2 og H3, udtrykt med hhv 1, 2 eller 3
+"havelåger" (#), og en type fremhævelser (*).
+
+Brug ikke store bogstaver i overskrifterne.
Jeg sætter de 'forbudte' typer til 'blinking', så er de nemme at spotte.
-Du vil måske have andre udtryksbehov end den lille palet nu giver mulighed for. Skriv dem på todolisten.
+Du vil måske have andre udtryksbehov end den eksisterende palet giver
+mulighed for. Skriv dem på todolisten.
-Beskriv helst i kommentarfeltet hvad ændringen består i, før den godkendes. Det støtter historikværktøjet og er en uvurderlig hjælp, hvis der bliver brug for at tilbageføre ændringer.
+Beskriv helst i kommentarfeltet hvad din opdatering består i, før den godkendes.
+Det støtter historikværktøjet og er en uvurderlig hjælp, hvis der bliver
+brug for at tilbageføre ændringer.
-Hvis teksten ikke er færdigskrevet, så skriv meget gerne en note om det. Du kan fx skrive FIXME: og så en beskrivelse. Før publicering kan hele websitet afsøges for FIXME:'er og rettes igennem.
+Hvis teksten ikke er færdigskrevet, så skriv meget gerne en note om det.
+Du kan fx skrive FIXME: og så en beskrivelse. Før publicering kan hele
+websitet afsøges for FIXME:'er og rettes igennem.
##Henvisninger
-Du kan henvise til andre sider på dette website eller til eksterne hjemmesider. Se (og kopier evt.) koderne i denne tekst under 'Rediger'.
+Du kan henvise til andre sider på dette website eller til eksterne
+hjemmesider. Se (og kopier evt.) koderne i denne tekst.
Henvisninger til emailadresser og url'er laves sådan her:
-<siri@jones.dk>
+\<siri@jones.dk>
Vil du have en anden tekst til at stå der, kan det se sådan ud:
-[skriv til mig](mailto:siri@jones.dk)
-(Gå ind under 'rediger' for at se hvordan det ser ud.)
+\[skriv til mig](mailto:siri@jones.dk)
Vil du henvise til en side internt på sitet gøres det sådan her:
-[[kontakt]]
+\[[kontakt]]
eller sådan:
-[[kontakt mig|kontakt]]
+\[[kontakt mig|kontakt]]
+
+## Notebox
+[[!template id=note text="""Eksempel på notebox"""]]
+\[[!template id=note text="""Eksempel på notebox"""]]
##Oprettelse af nye sider
-Du kan oprette en side ved at henvise til den. Så dannes der et link med et spørgsmålstegn foran. Spørgsmålstegnet (og linket) er kun synligt fra administrationswebsitet. Siden danner sig selv, når du trykker på linket, og herefter kan den redigeres. Når siden er dannet, forsvinder spørgsmålstegnet.
+* Opret en side ved at henvise til den fra en anden side: Skriv et link
+til den fx \[[tivoli]] eller \[[Zoologisk Have|zoo]]. Se navngivning
+herunder. Gem.
+
+* Et link med et foranstillet spørgsmålstegn dannes. Spørgsmålstegnet
+(og linket) er kun synligt fra administrationswebsitet. Det udtrykker at
+det er et link til en ikke eksisterende side.
+
+* Tryk på spørgsmålstegnet \?Tivoli for at danne og åbne den nye side,
+herefter kan den redigeres. Når siden er dannet, forsvinder spørgsmålstegnet.
+
+* Før du gemmer sidens første redigering, vælg sidens placering i
+drop-downmenuen over redigeringsfeltet.
-Undgå at oprette sider uden tekst, men vent til der er noget at skrive, om det så bare er en enkelt linie. Det er så kedeligt at komme til en tom side!
+* Giv siden tags efter de inline oversigter, den skal
+dukke op i.
###Navngivning af sider
-Specialtegn, store bogstaver og mellemrum er forbudt i navngivningen. Døb sider med omhu, så navnet er så kort og præcist beskrivende for indholdet som muligt, fx. kontakt - så bliver det også et pænt link: http://www.byvandring.nu/kontakt
+Specialtegn, store bogstaver og mellemrum er forbudt i navngivningen.
+Døb sider med omhu, så navnet er så kort og præcist beskrivende for
+indholdet som muligt, fx. kontakt - så bliver det også et pænt link:
+http://www.byvandring.nu/kontakt
+
+### Sletning af sider
+Du kan ikke slette sider, men er der en side du vil have skjult, kan du
+gøre det ved at sørge for, at der ikke er nogen henvisninger eller aktive
+tags til siden. Og send mig en mail om det, eller bedre: skriv det på
+todo-siden.
+
+##Paths
+Sider bliver automatisk lagt i roden hvis man opretter dem derfra, men
+før en ny side godkendes, kan placeringen vælges i den lille drop-down
+valgbar over redigeringsvinduet.
+
+\[[!meta title="lirum larum og katten lægger æg"]]
+\[[!meta date="1970-08-01"]]
+
+## Inline sider
+\[[!if test="included()" then="""
+Denne tekst er en teasertekst. Den kan kun ses i inline visninger af siden"""
+else="""
+Resten af teksten står her.
+"""]]
+
+### Rækkefølge
+Inline pages lægger sig pr. default med seneste redigeringstidspunkt
+øverst. Det kan styres med det magiske \[[!meta date="1970-08-01"]] direktiv.
+
+## Billeder
+Du kan lægge billeder på en side.
+Det foregår i to tempi: Først vedhæftes billedet - det er en valgmulighed
+under redigeringsvinduet. Derefter refereres til billedet med et billedlink.
+Du kan markere, hvor i teksten, billedet skal være. Det lægger sig til venstre.
+
+Billeders navne må i lighed med sidernes navne ikke indeholde danske tegn,
+mellemrum eller store bogstaver.
-###Sletning af sider
-Du kan ikke slette sider, men er der en side du vil have skjult, kan du gøre det ved at sørge for, at der ikke er nogen henvisninger til siden. Og send mig en mail om det, eller bedre: skriv det på en todo-side.
+### Billedlinks
+[[!img billedtitel.jpg link=kontakt title="Den lille Havfrue"]]
-##Vedhæftning af billeder
-Du kan vedhæfte billeder til en side. Du kan markere, hvor i teksten, billedet skal være, men du styrer ikke selv, om det lægger sig til højre eller venstre eller centreret. Det gør webdesigneren. Størrelsen på billederne aftaler vi nøjere, men hold dig ikke tilbage med at lægge billeder op på de sider, du har billeder til.
+* link til en anden side, skriv link="sidenavn"
+* intet link skrives link="none"
+* alt-tekster skrives også i henvisningen, skriv alt="Solnedgang gennem et fabriksvindue"
+* størrelse
-Det foregår i to tempi: Først vedhæftes billedet - det er en valgmulighed under redigeringsvinduet. Derefter refereres til billedet med en lille stump kode.
+## Billeder
+*Standardformater* til fx. 4:3 (300:225)format, firkantet format.
+Muligvis også "friseformat" på 3:1 (300:100): En bredde på 600px i 3.4
+bredformat passer nogenlunde med klummebredden i standard vinduesvisning.
+Brug evt. et nedskaleret eller beskåret billede til inline visning. Det
+tager ikke så meget plads op og giver smagsprøverne den her "blog roll"
+feeling. Desværre kan Ikiwiki ikke gøre dette automatisk.
-Billeders navne må i lighed med sidernes navne ikke indeholde danske tegn, mellemrum eller store bogstaver.
+\[[!img dieselvindue.jpg size=300x]]
-### Billedlinks
-[[!img billedtitel.jpg link=kontakt title=Den lille Havfrue]]
+## PDF upload
+Upload en pdf-fil ligesom en billedfil og lav en henvisning (link). Det
+er god stil at skrive hvor meget den fylder. Husk korrekt navngivning.
+
+## Tagging
+Et "tag" ser således ud:
-Hvis ikke billedlinket skal føre til (en tom side med) billedet selv, skrives link=none.
+\[[!tag cykel]]
+\[[!tag cykel undervisning todo]]
-###Tagging
-[[!tag tagnavn]]
-Tags må i lighed med andre navne ikke indeholde danske specialtegn, mellemrum eller store bogstaver.
+Tags må i lighed med andre navne ikke indeholde danske specialtegn,
+mellemrum eller store bogstaver.
-####Valide tags til at starte med
+For overskuelighedens skyld er det på dette site konvention at tags
+placeres i bunden af siderne.
+
+###Valide tags til at starte med
* ture
* city (for ture i indre by)
@@ -86,6 +169,7 @@ Tags må i lighed med andre navne ikke indeholde danske specialtegn, mellemrum e
* artikler
+
#Hvad gør vi nu?
Se [[todo]]