1 files changed, 172 insertions, 50 deletions
diff --git a/instruktion.mdwn b/instruktion.mdwn
index 3454caf1..2144f87c 100644
--- a/instruktion.mdwn
+++ b/instruktion.mdwn
@@ -1,86 +1,208 @@
-#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'.
+[[!toc levels=3 startlevel=2]]
+
+
+# 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 (*).
 
-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.
+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'.
+## 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>
+\<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]]
+
+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"]]
+
+Det eksterne link virker i billeder, men åbner ikke i et andet vindue. (TODO)
+
+## Notebox
+[[!template id=note text="""Eksempel på notebox"""]]
+\[[!template id=note text="""Eksempel på notebox"""]]
+
+## Sådan laves en tabel
+
+[[!table data="""
+første kolonne	|anden kolonne	|tredie...	|osv.
+anden række	|do		|do		|do
+tredie række	|do		|osv.
+"""]]
+
+\[[!table data="""  
+første kolonne	|anden kolonne	|tredie...	|osv.  
+anden række	|do		|do		|do  
+tredie række	|do		|osv.  
+\"""]]
 
-##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.
 
-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!
+## Oprettelse af nye sider
 
-###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
+ * 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.
 
-###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.
+### 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
 
-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.
+### 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.
 
-##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.
+## 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"]]
 
-Billeders navne må i lighed med sidernes navne ikke indeholde danske tegn, mellemrum eller store bogstaver.
+## 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 som udgangspunkt 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.
+
+Billednavne må ikke indeholde store bogstaver, mellemrum og specialtegn (æ, ø, å).
+Placer gerne billeder i /img for enklere deling på tværs.
 
 ### Billedlinks
-[[!img billedtitel.jpg link=kontakt title=Den lille Havfrue]]
+\[[!img billedtitel.jpg link=kontakt title="Den lille Havfrue"]]
+
+ * 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
+
+ * 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.
 
-Hvis ikke billedlinket skal føre til (en tom side med) billedet selv, skrives link=none.
+## Tagging
 
-#Hvad gør vi nu?
+Et "tag" ser sådan ud:
 
-Se [[todo]]
+\[[!tag cykel]]
+\[[!tag cykel undervisning todo]]
 
+Tags må ikke indeholde danske specialtegn, mellemrum eller store bogstaver.
 
-##[[Turliste|tours]]
-* [[city]] // [[Slotsholmen]] - [[Havnen]] - [[Sightseeing]]  
-* [[Udenfor Voldene|Kvarterer]] // [[Norrebro]] - [[Vesterbro]] - [[Bispebjerg og Nordvest|Bispebjerg]] - [[Islandsbrygge]]  
-* [[cykelture]] // [[Fronten]]
-* Historieture // [[Barok]] - [[oplysning]]
-* [[Byudvikling]]
+Følg konventionen for dette site, placér tags i bunden af siderne.
 
-##[[Virksomheder]] - (produkter)
-* [[events]] //
-* [[skoler]] //
-* [[undervisning]]
+### Valide tags
 
-##[[Produkter]]
-##[[Priser]]
-##[[kontakt|contact]]
-* [[guider]] //
-* [[Dialog med Byen|Dialog]]
+ * 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
 
-## Baggrund
-## Aktuelle ture index
-## Faste ture index
+# Hvad gør vi nu?
 
-[[mission]]
+Se [[todo]] ...