Writing an Application Manual/da

Bemærkninger

Manualer vil blive inkluderet som undersider af programmets hovedside. For nemheds skyld vil jeg omtale hovedsiden som Prognavn. Strukturen bliver så noget i retning af:

• Prognavn
  • Prognavn/Vink og tips
• Prognavn/Manual # Indholdsfortegnelse
  • Prognavn/Manual/En introduktion til Prognavn
  • Prognavn/Manual/Konfigurationsmuligheder
  • Prognavn/Manual/Første gang du bruger Prognavn
  • Prognavn/Manual/afsnit 1
  • Prognavn/Manual/afsnit xxx
  • Prognavn/Manual/Vink og tips
  • Prognavn/Manual/Fejlløsning
  • Prognavn/Manual/Programfejl
  • Prognavn/Manual/Involver dig #link til techbase etc

Husk!

Undgå enhver brug sætningstegn i sidenavne — sætningstegn som spørgsmålstegn og punktummer giver alvorlige problemer for wikisoftwaren, ikke mindst for oversættelsessystemet.

Du vil få brug for en testområde til at eksperimentere med afsnitoverskrifter og sider. Du kan enten bruge din personlige UserBase-side eller diskussionssiden knyttet til det område, hvor du arbejder. Det er en stor hjælp, hvis du fjerner alt, hvad du ikke længere skal bruge, når du er færdig med det.

Udvikling af en manual

Under udviklingen af din manual er det som regel bedst at holde den adskilt fra de almindelige UserBase-sider. Nogle foretrækker at redigere deres udkast som undersider til deres Talk:-side. Vi har også et særligt navnerum, Draft:, til dette formål.

For at lave indholdssiden til din manual skriver du blot http://userbase.kde.org/Draft:Appname/Manual i browserens adresselinje eller skriver linket [[Draft:Appname/Manual]] på en side og klikker så på det. På begge måder kommer du til en side, som siger, at den ønskede side ikke eksisterer, men at du kan oprette den ved at klikke på et link.

Indhold

• Når du har lavet din plan (det kan være en langvarig proces), så lav links til alle de sider, du vil skrive i indholdsfortegnelsen. Du kan selvfølgelig altid indsætte et afsnit senere, hvis du opdager, at du har glemt noget.

Skriv manualen

• Brug de røde links til at lave siderne og skriv et afsnit ad gangen.

• På diskussionssiden kan du notere alt det, som du skal kigge på senere, så som links, der ikke kan laves endnu.

Husk!

Det er vigtigt at være konsistent, ikke mindst i manualer, så her er nogle almindelige regler:

• Vær omhyggelig med overskriftniveauer — vi starter på andet niveau med == (Mediawiki bruge topniveauet til sidenavne)

• Sørg for at se her og på Opgaver og værktøjer og Typografiske retningslinjer med jævne mellemrum

• Tjek, at alle tabelceller har et mellemrumstegn efter "pipe"-tegnet. Denne regel følger traditionel wiki-formattering.

• Vær konsistent i formatteringen af programnavne (undgå at skrive Amaroks, skriv Amarok's — på dansk dog Amaroks).

• Sørg for, at alle billeder er i PNG-format (du kan også bruge JPEG, men i så fald bør du konvertere dem til PNG senere). Gør dit arbejde nemmere ved at konvertere dem fra begyndelsen af .

• Fjern alle blanktegn fra billednavne.

Søgning i manualen

Før eller siden kan du få brug for at finde noget, som du skrev tidligere, men ikke kan huske hvor. Wiki'ens søgeboks er nok ikke ideel, medmindre den streng, du søger efter er meget specifik. Du kan få meget bedre kontrol over søgningen ved at bruge udvidelsen DPL. Hvis du for eksempel skal finde de sider i din manual, som indeholder en vis streng, så kan du føje følgende til hvilken side som helst:

<DPL>
  titlematch = %Appname/Manual%
  namespace = Draft
  include = *
  includematch = /string to search for/
  resultsheader = Manual Pages:
  format = ,\n* [[%PAGE%|%TITLE%]]\n,,
</DPL>

Du kan finde flere eksempler på brugen af DPL på User:Claus_chr/DPL.

Forbered manualen for oversættelse

• Den nødvendige tilpasning af markup'en er beskrevet på Preparing a Page for Translation. Følg denne guide, da nogle gamle markup-stile ikke længere er relevante.