Wikibooks:Stilmanual

Fra Wikibooks, den frie samling af lærebøger

Formålet med stilmanualen er at beskrive den ideelle opbygning af bøgerne i Wikibooks, skabe en sammenhæng imellem wikibøgerne og forbedre den samlede brugbarhed af Wikibooks.

Nye skribenter bør huske på at klar, informativ og upartisk tekst altid er mere vigtig end stil, præsentation og formatering. Det forventes ikke og det kræves ikke at nogen følger en eneste af nedenstående regler.

Se hvordan redigerer jeg en side for flere oplysninger om hvordan man bruger de forskellige ting nævnt nedenfor. Denne artikel fokuserer mest på hvornår man skal bruge en bestemt stil, ikke hvordan den bruges.

Se også Navngivning for oplysninger om hvordan bøger og moduler bør navngives.

Struktur[redigér]

Wikibooks bør følge den følgende struktur.

Bogens første side (siden med bogens titel), bør indeholde en kort introduktion til bogen, efterfulgt af overskriften Indholdsfortegnelse og en punktopstillet liste over bogens moduler, ekstra overskrifter kan tilføjes for at vise bogens struktur.

Link[redigér]

Bøger med en stor understruktur bør indeholde links i hvert modul til navigering inden for bogens struktur. En metode er at lave en skabelon med de nødvendige links, og sætte skabelonen på de relevante sider.

Overskrifter[redigér]

Overskrifter bør bruges til at skabe overblik over layoutet. Overordnet information bør mærkes med overskrift 1 "==" (to lig-med tegn, underordnet information bør mærkes med overskrift 2 "===" (tre lig-med tegn), og så videre, for eksempel:

== Dyr ==
Der er mange slags dyr.

=== Katte ===
Katte er dyr.

=== Hunde ===
Hunde er dyr.

Det første bogstav i en overskrift bør altid være stort, men lad resten være små, med mindre det er egennavne.

Undgå links i overskrifter. Afhængig af opsætning og browser har nogle brugere svært ved at se dem rigtigt. Det er meget bedre at putte links i den første sætning under overskriften.

Alle tal bør efterfølges af en dertil hørende SI-enhed, hvis der findes sådan en, som enhver videnskabelig tekst ville have det. Der bruges dansk kommasætning til decimaltal.

  • 23 m
  • 43,76 m/s
  • 3.445,02 A/s²
  • 21 °C (som er en undtagelse, da SI-enheden for temperatur er K for Kelvin, dog er grader celsius så udbredt på dansk, at det ofte er det bedste valg for de fleste bøger).

Stavning[redigér]

Dansk er det foretrukne sprog på den danske Wikibooks, og man bør så vidt muligt følge retskrivningsordbogen.

Kun hvis der ikke eksisterer nogen dansk oversættelse, eller den udenlandske version er den mest brugte i det danske sprog, kan den udenlandske stavemåde bruges.

For eksempel hedder det harddisk i stedet for det danske ord fastpladelager som stort set aldrig bruges på dansk.

Tegnsætning[redigér]

Tegnsætning bør så vidt muligt følge dansk retstavning, sådan som den er foreskrevet af Dansk Sprognævn.

Citater[redigér]

Citater bør angives i kursiv og i anførelsestegn. Eksempelvis:

"Jeg tænker, derfor er jeg" - Rene Descartes

Kilder/henvisninger[redigér]

Kilder og henvisninger til andre steder på internettet bør så vidt muligt angives med et afsnit nederst i artiklen, så det er klart for læseren hvornår et et link leder vedkommende væk fra Wikibooks. Eksempel:

 ==Ekstern henvisning==
 *[http://www.danmark.dk/ Danmark.dk]

- der vil komme til at se således ud:

Ekstern henvisning

Indeholder en eksterne henvisning også kilden til oplysningerne, skriver "Ekstern kilde/henvisning".

Det kan være en god ide at sætte en eller to gode eksterne links, evt. på en separat side, så læseren kan finde yderligere information, men at lave links til ti eksterne steder giver ingen ekstra værdi til bogen. Vi laver en samling af frie bøger, ikke en ny linksamling.

At lave links til en søgemaskine som for eksempel Google giver ingen ekstra værdi til bogen. De fleste brugere vil selv kunne finde ud af at bruge deres favoritsøgemaskine til at finde yderligere information.

Se også Wikibooks:Kilder for oplysninger om de forskellige kilder der frit kan (og ikke kan) bruges for den danske Wikibooks.

Litteraturangivelsers typografi[redigér]

Det følgende system anvendes af alle engelske (amerikanske, osv.) forlæggere og tidsskriftredaktører og i den engelske Wikibooks. Det er også anbefalelsesværdigt i andre danske skrifter, og betyder følgende:

Titler på bøger og tidsskrifter sættes i kursiv.

Titler på ikke selvstændigt udgivne skrifter, som et kapitel i en bog, en afhandling i et tidsskrift, et enkelt digt, osv., sættes i antikva, gerne i anførselstegn.

Er en bog udkommet som en del af en serie, skrives seriens navn i parentes med antikva.

Skal man anføre land, by eller forlag? Nogle synes at angivelsen af forlag er overflødig (hvad skal den bruges til?), men den er gængs, dels i medicinsk litteratur, dels i amerikansk litteratur. Er byen velkendt, er angivelsen af landet unødvendig.

Fiktive eksempler:

Jensen, Anton. "Tre skuespillere", Nordisk tidskrift för dramaturgi, 1963, side 76-89.
Kristensen, Per. "Til hende", i hans Samlede digte, Odense 1988, side 14.
Grylbo, Aase. Thomas Fincke (Acta historica scientiarum naturalium, 25.) Kbh. 1974.

For kilder der findes i digitaliseret form på WWW og som man kan linke til, er det ikke nødvendigt at angive sidenummer, eksempelvis:

"Steen Steensen Blicher" i Salmonsens konversationsleksikon, 1915

Bemærk at såvel artiklen (normal stil i citationstegn, ekstern henvisning) som værkets titel (kursiv stil, intern henvisning) er links i dette tilfælde.

Illustrationer[redigér]

Sættes så vidt muligt øverst til højre for teksten. Dette er dog ikke nogen helt fast regel; hvis du for eksempel har et portræt med et hoved der kigger til højre, så ser det som regel bedst ud i venstre side (kiggende ind i teksten).

Standarden for at sætte illustrationer øverst til højre er denne:

[[Billede:picture.jpg|thumb|Tekst til billedet]]

Angiv på illustrationens side, hvor den kommer fra - evt. med link til kilden - og hvem der har lavet den, samt hvad den illustrerer.

Simple tabeller[redigér]

En linje der starter med et mellemrum bliver automatisk vist med en skrifttype hvor alle tegn har samme bredde. Dette kan bruges til at lave simple tabeller.

foo     bar     baz
alpha   beta    gamma

En linje der starter med et mellemrum, og uden andet indhold på linjen giver en ekstra tom linje, det kan være en lidt forvirrende fejl, eller måske lige det du ønsker.

Eller måske ikke.

Wikitabeller[redigér]

Der findes en wiki-syntaks for tabeller, så man ikke behøver at bruge HTML. Her er et eksempel:

Overskriften
Kolonneoverskrift Anden kolonne
A 1
B 2
C 3

Skrives som:

{| border="2"
|+Overskriften
|-
! Kolonneoverskrift
! Anden kolonne
|-
| A || 1
|-
| B || 2
|-
| C || 3
|}

Læse mere om Tabeller her.

Hold det simpelt[redigér]

Det er lettere for dig, og dem der følger efter dig, hvis du ikke gør det alt for indviklet.

Det er lettere at vise Wikibooks, og lettere at redigere og tilføje til moduler, hvis vi ikke laver det mere indviklet end hvad der er nødvendigt for at vise informationen på en brugbar og forståelig måde.

Undgå derfor at bruge HTML-kode, hvor det ikke er strengt nødvendigt - brug hellere Wikibooks’ indbyggede formateringsmuligheder.

Skabeloner[redigér]

Som nævnt i forbindelse med artikler med flertydige navne ({{flertydig}}) kan man lave skabeloner til at sætte ind i sine artikler. En skabelon oprettes ved at man skriver følgende i URL-linjen:

http://da.wikipedia.org/wiki/Skabelon:XXX jiebusd

hvor XXX er navnet eller titlen på den side, du vil bruge.

Fil:Hgjregdnittye

Herefter redigeres siden på normal vis.

Nye skabeloner tilføjes listen over skabeloner.