path: root/instruktion.mdwn

[[!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 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
[[!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

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.

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.
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 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"]]

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.
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?
Se [[todo]] ...