summaryrefslogtreecommitdiff
path: root/instruktion
diff options
context:
space:
mode:
authorJonas Smedegaard <dr@jones.dk>2020-03-16 19:15:01 +0100
committerJonas Smedegaard <dr@jones.dk>2024-04-06 10:36:37 +0200
commite30097f4a9ffc42d57df2c463ae4770b61ff8769 (patch)
treed81a0f0c0153d99346cb1e123f7bc656991086b4 /instruktion
parentc0be7d8b7c4caa1e1077e91912e93dac6c4e6470 (diff)
rename *.mdwn to */index.md, except index/topbar/farbar/sidebar files
command: ``` perl -MPath::Tiny -WE 'use strict; path(".")->visit(sub{return unless -f && /\.mdwn$/; my $stem=$_->basename(".mdwn"); my $new=$_->sibling($stem,"index.md"); return if $stem =~ /^index|topbar|sidebar|farbar|footer$/ || $new->exists; $new->parent->mkpath; system("git","mv", $_, $new)},{recurse=>1})' ```
Diffstat (limited to 'instruktion')
-rw-r--r--instruktion/index.md208
1 files changed, 208 insertions, 0 deletions
diff --git a/instruktion/index.md b/instruktion/index.md
new file mode 100644
index 00000000..bd13436f
--- /dev/null
+++ b/instruktion/index.md
@@ -0,0 +1,208 @@
+[[!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</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
+
+ * 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]] ...