1 files changed, 186 insertions, 28 deletions
diff --git a/instruktion.mdwn b/instruktion.mdwn
index d3deee15..2144f87c 100644
--- a/instruktion.mdwn
+++ b/instruktion.mdwn
@@ -1,50 +1,208 @@
-#Hvad kan du?
+[[!toc levels=3 startlevel=2]]
 
-Du kan skrive og redigere, formattere teksten samt oprette nye sider og henvisninger, så snart du er logget på. Anvisning om pålogning kommer frem, når du trykker på 'Rediger'.
+
+# Hvad kan du?
+Du kan skrive og redigere, formattere teksten samt oprette nye sider og henvisninger,
+så snart du er logget på. Anvisning om pålogning kommer frem, når du trykker på 'Rediger'.
 
 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.
+## 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 basale
+behov.
+
+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 eksisterende palet giver
+mulighed for. Skriv dem på todolisten.
+
+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.
+
+## Henvisninger
+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>
+
+Vil du have en anden tekst til at stå der, kan det se sådan ud:
+\[skriv til mig](mailto:siri@jones.dk)
+
+Vil du henvise til en side internt på sitet gøres det sådan her:
+\[[kontakt]]
+eller sådan:
+\[[kontakt mig|kontakt]]
+
+Link der åbner i et andet vindue:
+
+<a href="https://sirireiter.dk/" target="_blank">
+Link til mig</a>
+
+\<a href="https://sirireiter.dk/" target="_blank">
+Link til mig</a>
+
+[[!img byudvikling/overformynderiet.jpg class=solo link="https://sirireiter.dk/" target="_blank"]]
+\[[!img byudvikling/overformynderiet.jpg class=solo link="https://sirireiter.dk/" target="_blank"]]
 
-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.
+Det eksterne link virker i billeder, men åbner ikke i et andet vindue. (TODO)
 
-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
+## Notebox
+[[!template id=note text="""Eksempel på notebox"""]]
+\[[!template id=note text="""Eksempel på notebox"""]]
 
-Du kan henvise til andre sider på dette website eller til eksterne hjemmesider. Se (og kopier evt.) koderne i denne tekst under 'Rediger'.
-Oprettelse af nye sider
+## Sådan laves en tabel
 
-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.
+[[!table data="""
+første kolonne	|anden kolonne	|tredie...	|osv.
+anden række	|do		|do		|do
+tredie række	|do		|osv.
+"""]]
 
-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!
-#Navngivning af sider
+\[[!table data="""  
+første kolonne	|anden kolonne	|tredie...	|osv.  
+anden række	|do		|do		|do  
+tredie række	|do		|osv.  
+\"""]]
 
-Navngiv siderne på engelsk. 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. contact - så bliver det også et pænt link: http://www.byvandring.nu/contact
 
-Selve henvisningen til siden kan fint skrives på dansk, fx kontakt. Æ, ø og å er ok, mellemrum fungerer ikke p.t.
-#Sletning af sider
+## Oprettelse af nye 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.
+ * 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.
+ * Giv siden tags efter de inline oversigter, den skal
+dukke op i.
 
-Lad gerne tekster ligge og flyde; man ved aldrig, hvad de kan inspirere til. I øjeblikket er det flere sider end du kan se, jeg knapper dem sammen hurtigst muligt.
-#Vedhæftning af billeder
+### 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:
+https://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.
 
-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.
+## 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.
 
-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.
+\[[!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.
+"""]]
 
-FIXME Alt-tekster og billedlinks
+### Rækkefølge
+Inline pages lægger sig som udgangspunkt med seneste redigeringstidspunkt
+øverst. Det kan styres med det magiske \[[!meta date="1970-08-01"]] direktiv.
+
+## Billeder
 
-Billeders navne må i lighed med sidernes navne ikke indeholde danske tegn, mellemrum eller store bogstaver.
-#Hvad gør vi nu?
+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.
+
+Billednavne må ikke indeholde store bogstaver, mellemrum og specialtegn (æ, ø, å).
+Placer gerne billeder i /img for enklere deling på tværs.
 
-Det vigtigste her og nu er at komme i gang. Overskriv denne side, flyt indholdet til en anden side eller skriv oven for denne tekst så længe du har brug for at kunne læse den. Du kan fx lave en liste med links til de nye sider - og dermed et index.
+### Billedlinks
+\[[!img billedtitel.jpg link=kontakt title="Den lille Havfrue"]]
 
-Jeg vil løbende rette udseendet til.
-#Næste step
+ * 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 - dette frarådes, da det er problematisk især for inline visninger.
+
+### Formater
 
-Når der er noget tekst med en vis volumen er det lettere at arbejde med designet. Det bliver let at se, hvor det vil være godt med billeder.
+ * Vejviseren inlinebillede (altid bredformat: 500 px class=blog
+ * Klummebredde billede: bredformat 600 px class=solo
+ * Klumme højformat: 300 px bredt class=tall
+ * Inline turoversigter: bredformat 200 px class=overview
+ * Frisebilleder i turbeskrivelser: bredformat 200 px class=deco
+ * Forsidebilleder: 480x240 px bredformat - styrer Siri
+ * Topbar billeder: 1600x500 px bredformat - styrer Siri
+ * Turlistesmåbilleder: 267x100 px bredformat class=flex
+
+
+## PDF upload
+
+Upload en pdf-fil ligesom en billedfil og lav en henvisning (link).
+Husk korrekt placering af filen under den side, der skal linke til den.  
+
+Skriv ved linket, hvor meget filen fylder. Det er god stil.
+
+## Tagging
+
+Et "tag" ser sådan ud:
+
+\[[!tag cykel]]
+\[[!tag cykel undervisning todo]]
+
+Tags må ikke indeholde danske specialtegn, mellemrum eller store bogstaver.
+
+Følg konventionen for dette site, placér tags i bunden af siderne.
+
+### Valide tags
+
+ * ture
+ * city (for ture i indre by)
+ * sightseeing
+ * havnen
+ * slotsholmen
+ * vesterbro
+ * norrebro
+ * bispebjerg
+ * bryggen
+ * sydhavnen
+ * cykel(ture)
+ * udflugter
+ * jul
+ * sejl(ture)
+ * historie(ture)
+ * dybde
+ * undervisning
+ * byudvikling
+ * talks (eller foredrag)
+ * events
+ * aktuelt
+ * blog
+ * vejviseren (indlæg i Vejviseren skal også tagges med blog!)
+ * artikel
+
+# Hvad gør vi nu?
 
-Og der er et godt udgangspunkt for at lægge en helt overordnet struktur for navigationen.
+Se [[todo]] ...