Documentation/Help/da

LibreOffices Hjælp undergik en radikal ændring med version 6.1 og vises nu i systemets browser.

Introduktion til redigering af LibreOffice Hjælp
LibreOffice Hjælp-sider er tekstsider i XML (Extensive Markup Language). Her er der et sammendrag, der hjælper dig med at bidrage til Hjælp-projektet:

Dokumentation til Hjælp-redigering
Et minimalt kendskab til XML eller endda HTML er nødvendigt. The XML til LibreOffices Hjælp (også kendt som XHP) er ikke svært at fatte, hvis du kender de grundliggende ideer i XML. Det vil være nyttigt til små ændringer, indtil du bliver mere fortrolig med, hvad du må og ikke må i LibreOffice Hjælp-filer.

Dokumentation til forståelse, affattelse og redigering af LibreOffice Hjælp kan findes i online version. Disse wiki-sider er under revision og forbedring og vil følge udviklingen i LibreOffice Hjælp-ressourcer.

Den vigtigste wiki-side til XHP er side 2: XHP Referencer.

Den originale PDF-bog er tilgængelig: [[Media:OOo2HelpAuthoring.pdf|Forstå, affat og rediger OpenOffice.org HELP (PDF)]]. Bemærk, at denne bog nu er forældet.

Rediger LibreOffice Hjælp-filer direkte i gerrit
En fyldestgørende side om emnet er tilgængelig her

Kilder til LibreOffice Hjælp med git
Kilderne til LibreOffice Hjælp findes i git. Hvis du allerede har konfigureret gerrit, kan du: Eller alternativt er du nødt til at gøre: From then on, you work with the git repository in the normal way:


 * For at få de nyeste strenge skriver du
 * for at sende dine ændringer til godkendelse pusher du til gerrit. Se venligst, hvordan du gør det, senere på denne side.

Læs Hvordan sættes gerrit op første gang og Hvordan sendes en rettelse til korrektur. Hvis du har problemer med opsætningen, kontakt venligst udviklerne på -kanalen på freenode, de vil være glade for at hjælpe dig!

Kilder til Hjælp som pakket arkiv
Indrømmet, git er den sikreste måde at få den seneste kildekode til hjælp. Men hvis git ikke er en løsning for dig, kan du downloade Hjælp-kildefilen som en tarball og dekomprimere den til din arbejdsmappe.

For at downloade den seneste kildekode til Hjælp ser du efter den seneste version på denne side

http://download.documentfoundation.org/libreoffice/src/X.Y.Z/ hvor X, Y and Z skal erstattes af den seneste version. For eksempel (24. maj 2017) er X.Y.Z 5.4.0.

Rediger Hjælp
Der findes en kort manual, der beskriver, hvordan Hjælp-indholdet skal affattes here.

Sådan findes den fil, der skal arbejdes på
Når du har kilderne til Hjælpen og strengen, du vil ændre (som at ændre den "brede vifte af muligheder" på https://help.libreoffice.org/Writer/Writer_Features#Designing_and_Structuring), gør du: Dette returnerer dette til dig: source/text/swriter/main0503.xhp:$[officename] offers ... hvis betyder, at denne findes i

Med tekst-baseret redigering
Praktisk talt enhver tekstbehandler kan åbne filen  (det er fx Kate i KDE, gedit i Gnome eller Notepad2 i Windows. Måske vil du bruge vim eller en anden professionel xml-redigering).


 * 1) Åbn en Hjælp-fil i menuen  eller med funktionen  fra en filhåndtering (fx i KDE, højreklik på filen og vælg  på kontekstmenuen).
 * 2) Fordi filerne kan være meget store og have et stort antal xml-mærker, du bruge funktionen Find (sædvanligvis  eller ).
 * 3) Lav de nødvendige ændringer (hvis du ikke er fortrolig med xml-mærker i Hjælp-filer, skal du sikre dig, at du ikke har rørt dem).
 * 4) Gem filen.

Den metode er god, når vi har brug for at lave mindre rettelser uden at røre XML-mærkernene, fx for at rette en slåfejl.

Med XHP-redigeringsassistenten
Dokumentation af XHP-redigeringen giver nogen hjælp med at tjekke gengivelsen af .xhp-filerne. Den understøtter ikke alle xhp-mærker, men dækker et rimeligt udvalg. XHP-redigeringen giver ikke DTD-overenstemmelse, hvilket betyder, at stadig omhu er nødvendig under redigering af en .xhpfil.

Forstå strukturen i LibreOffice Hjælp-filer
LibreOffice Hjælp-filen er sammensat af flere obligatoriske dele. Se på dette guidede eksempel.

Hvordan verificeres ændringer
Hvis du laver ændringer eller opretter en ny side i Hjælp, er det en god ide at tjekke, hvordan den vil se ud i brugerfladen. Du skal konstruere LibreOffices Hjælp.

Den første gang har du brug for at konstruere LibreOffice. For fremtiden kan det gøres ved at opdatere versionen fra tid til anden. Flere oplysninger om konstruktionen af LibreOffice kan findes på disse sider: til Linux, til Windows og til macOS.

Den lokale Hjælp
Brug indstillingen  til , når du konstruerer LibreOffice

Den resulterende konstruktion er placeret i  sammen med mange ledsage-filer, der er nødvendige til at styre siderne. Åbn filen  fra din browser eller tryk på  i din LibreOffice-konstruktion for at få adgang til Hjælp-elementets side.

Online-Hjælpen
Brug indstillingen  til , når du bygger LibreOffice

Den resulterende konstruktion er placeret i  sammen med mange ledsage-filer, der nødvendige til at styre filerne. For at navigere lokalt i Online-hjælp-konstruktionen, indstiller du en webserver i din computer og får den til at åbne siden  https://localhost//instdir/help/X.Y/index.html .

Hvordan sendes den tilbage til godkendelse (via gerrit)
Gerrit er et værktøj, som tillader en let korrektur på ændrimger, som går ind i LibreOffice. Følg instruktionerne på Hvordan sendes en rettelse til korrektur, Hjælp bruger den samme arbejdsgang. De præcise trin findes i artiklen om undermoduler.

If you want to create a new change, create a new branch:

Edit the files in helpcontent2 and commit your changes inside the directory. While in the helpcontent2 directory, submit to Gerrit with this command

Once your submodule patch is merged, you can delete 'my_branch':

By using the ./g script, you do not need to worry about git submodule update.

hvis du så får en gerrit-fejl om ikke at have et Ændrings-ID, kør så denne kommando i Hjælpens rodmappe Hvis denne kommando ikke hjælper, følger du rådet i fejlen "Vink: for automatisk at indsætte Ændrings-ID installerer du krogen".

Se også

 * Instructions on how to work with offline help and the authoring tool
 * Regina's samling af problemer med forfatterværktøj