| How To Convert a UserBase Manual to Docbook | Current message text |
|---|---|
| ↓...to Docbook/Page display title/nl | Een UserBase-handleiding omzetten naar Docbook |
| ↓... UserBase Manual to Docbook/1/nl | == Inleiding == |
| ↓... UserBase Manual to Docbook/2/nl | Het beschreven proces is niet afgewerkt, de code is lelijk, niet intelligent genoeg, enzovoorts... het enige excuus is dat het werkt {{Smiley}}. |
| ↓... UserBase Manual to Docbook/3/nl | Wil je meehelpen om het proces te verbeteren, heb je goede kennis van Python, en ken je de Docbook-standaarden, dan kun je meehelpen om de procedure te verbeteren. Contacteer [[User_talk:Yurchor|Yurchor]] (Engels) als je kunt helpen. |
| ↓... UserBase Manual to Docbook/4/nl | == Pagina's klaarmaken voor het omzetten == |
| ↓... UserBase Manual to Docbook/5/nl | * Controleer of de pagina's van de handleiding de [[Special:myLanguage/Tasks_and_Tools|auteursrichtlijnen voor UserBase]] en de [[Special:myLanguage/Typographical_Guidelines|typografische richtlijnen]] in acht nemen. |
| ↓... UserBase Manual to Docbook/6/nl | * Controleer of iedere pagina een kop heeft die overeenkomt met het niveau van de pagina in de inhoudsopgave. |
| ↓... UserBase Manual to Docbook/7/nl | :{| |+Referentietabel |- ! UserBase ! Docbook ! Opmerkingen |- | ==Section== | <chapter> |- | ===Section=== | <sect1> |- | ====Section==== | <sect2> |- | =====Section===== | <sect3> |- | ======Section====== | <sect4> | ''Vermijd dit niveau indien mogelijk'' |} |
| ↓... UserBase Manual to Docbook/8/nl | * Controleer of alle tabelcellen een spatie achter het verticale-streep-karakter hebben. Dit komt overeen met [http://en.wikipedia.org/wiki/Help:Table de traditionele Wiki-opmaak]. |
| ↓... UserBase Manual to Docbook/9/nl | * Maak de opmaak van de naam van de toepassing eenduidig (gebruik niet '''Amarok'''s, maar '''Amarok's'''). |
| ↓...UserBase Manual to Docbook/10/nl | * Zorg ervoor dat ''alle'' afbeeldingen in PNG-formaat zijn. |
| ↓...UserBase Manual to Docbook/11/nl | * Verwijder alle niet-afdrukbare karakters uit afbeeldingsnamen. |
| ↓...UserBase Manual to Docbook/12/nl | === Het exporteren === |
| ↓...UserBase Manual to Docbook/13/nl | * Bereid de lijst van pagina's voor (u moet van de UserBase-addressen <nowiki>http://userbase.kde.org</nowiki> afhalen). Voorbeeld voor '''Amarok''': |
| ↓...UserBase Manual to Docbook/14/nl | {{Input|1=Amarok Amarok/QuickStartGuide Amarok/QuickStartGuide/GettingStarted Amarok/QuickStartGuide/TheAmarokWindow Amarok/QuickStartGuide/TheMusicCollection Amarok/QuickStartGuide/Playlists Amarok/QuickStartGuide/TheContextView Amarok/QuickStartGuide/HowToDealWithProblems Amarok/QuickStartGuide/Glossary Amarok/Manual/AmarokWindow Amarok/Manual/AmarokWindow/Toolbar Amarok/Manual/AmarokWindow/MediaSources Amarok/Manual/AmarokWindow/ContextPane Amarok/Manual/AmarokWindow/PlaylistPane Amarok/Manual/ConfiguringAmarok Amarok/Manual/AdvancedFeatures Amarok/Manual/AdvancedFeatures/CollectionScanning Amarok/Manual/AdvancedFeatures/CoverManager Amarok/Manual/AdvancedFeatures/DynamicPlaylists Amarok/Manual/AdvancedFeatures/AutomaticPlaylistGenerator Amarok/Manual/AdvancedFeatures/ExternalDatabase Amarok/Manual/AdvancedFeatures/AFT Amarok/Manual/AdvancedFeatures/Moodbar Amarok/Manual/AdvancedFeatures/WorkingWithMediaDevices Amarok/Manual/AdvancedFeatures/SavedPlaylists Amarok/Manual/AdvancedFeatures/PlaylistFiltering Amarok/Manual/AdvancedFeatures/QueueManager Amarok/Manual/AdvancedFeatures/SearchInCollection Amarok/Manual/AdvancedFeatures/TagEditor Amarok/Manual/AdvancedFeatures/OrganizeCollection Amarok/Manual/AdvancedFeatures/Transcoding Amarok/Manual/AdvancedFeatures/ScriptManager Amarok/Manual/AdvancedFeatures/RemoteCollections Amarok/Manual/AdvancedFeatures/RemoteCollections/Ampache Amarok/Manual/AdvancedFeatures/RemoteCollections/DAAP Amarok/Manual/AdvancedFeatures/RemoteCollections/Samba Amarok/Manual/AdvancedFeatures/RemoteCollections/UPnP Amarok/Manual/MenuAndCommandReference/AmarokMenu Amarok/Manual/MenuAndCommandReference/ViewMenu Amarok/Manual/MenuAndCommandReference/Playlist Amarok/Manual/MenuAndCommandReference/Tools Amarok/Manual/MenuAndCommandReference/Settings Amarok/Manual/MenuAndCommandReference/Help Amarok/Manual/KeybindingReference Amarok/Manual/KeybindingReference/GlobalShortcuts Amarok/Manual/KeybindingReference/AmarokShortcuts Amarok/Manual/TroubleshootingAndCommonProblems Amarok/Manual/AmarokOnOtherPlatforms/Non-KDE Desktops Amarok/Manual/AmarokOnOtherPlatforms/Windows Amarok/Manual/AmarokOnOtherPlatforms/OSX Amarok/Manual/FAQ Amarok/Manual/Credits_and_License}} |
| ↓...UserBase Manual to Docbook/15/nl | {{Tip|1=Je kunt de complete lijst met pagina's voor een applicatie verkrijgen met het volgende script:<!--}}--> |
| ↓...UserBase Manual to Docbook/16/nl | {{Input|1=<nowiki><DPL> nottitlematch = %/__|%/zh-%|%(%) titlematch = Amarok% namespace = Main columns = 1 format = ,\n* [[%PAGE%|%TITLE%]],, </DPL></nowiki>}} |
| ↓...UserBase Manual to Docbook/17/nl | <!--{{-->Vervang '''''Amarok''''' door de naam van het programma, zet het op je gebruikerspagina, en klik op <menuchoice>Voorbeeld</menuchoice>. Zet de pagina's op dezelfde volgorde als de inhoud van de handleiding. }} |
| ↓...UserBase Manual to Docbook/18/nl | * Ga naar de [[Special:Export|Exporteer-pagina]]. |
| ↓...UserBase Manual to Docbook/19/nl | * Plak de paginalijst in het grote invoerveld. |
| ↓...UserBase Manual to Docbook/20/nl | * Klik op <menuchoice>Exporteren</menuchoice>. [[File:XML_export.png|350px|center|thumb|Exporteren van de Amarok-handleiding]] |
| ↓...UserBase Manual to Docbook/21/nl | * Save the file. The saved file will be called <tt>Manual.xml</tt> in what follows. |
| ↓...UserBase Manual to Docbook/22/nl | ===Conversion=== |
| ↓...UserBase Manual to Docbook/23/nl | * Install Subversion package for your system. |
| ↓...UserBase Manual to Docbook/24/nl | * Checkout the latest version of conversion script: {{Input|1=svn checkout --depth=files <nowiki>svn://anonsvn.kde.org/home/kde/branches/work/doc/</nowiki>}} |
| ↓...UserBase Manual to Docbook/25/nl | * Copy <tt>Manual.xml</tt> to the script folder. |
| ↓...UserBase Manual to Docbook/26/nl | * Run {{Input|1=python wiki2docbook.py Manual.xml}} if you want to download all screenshots (it takes some time to download all images from UserBase, grep and wget should be installed), or {{Input|1=python wiki2docbook.py -s Manual.xml}} if you need not to download images. |
| ↓...UserBase Manual to Docbook/27/nl | ===Post-processing=== |
| ↓...UserBase Manual to Docbook/28/nl | * Rename <tt>Manual.xml.docbook</tt> to <tt>index.docbook</tt>. |
| ↓...UserBase Manual to Docbook/29/nl | * Check if conversion was done correctly: {{Input|1=checkXML index.docbook}} |
| ↓...UserBase Manual to Docbook/30/nl | * Fix the errors (better on UserBase pages). |
| ↓...UserBase Manual to Docbook/31/nl | * Convert docbook to HTML: {{Input|1=meinproc4 index.docbook}} |
| ↓...UserBase Manual to Docbook/32/nl | * Check HTML pages (all images should be visible, links should not lead to 404-pages). |
| ↓...UserBase Manual to Docbook/33/nl | * Replace big images by thumbnails using '''convert''' from '''ImageMagick''' |
| ↓...UserBase Manual to Docbook/34/nl | * Fix links in docbook, so they lead to docbook section, not UserBase pages. |
| ↓...UserBase Manual to Docbook/35/nl | * Fix application name according to KDE entity list. |
| ↓...UserBase Manual to Docbook/36/nl | * Copy <tt>index.docbook</tt> and images to your <tt>/doc</tt> folder and commit them to repository. [[File:K3b_docs.png|350px|center|thumb|K3b docs on UserBase in Opera and converted page in Konqueror.]] |
| ↓...UserBase Manual to Docbook/37/nl | [[Category:Translator_Help]] |
KDE TechBase 