Welkom bij het vierde en laatste deel van deze serie blogs. Eerder hebben we een PHP preprocessor gemaakt, waarmee enkele kleine problemen in de Drupal documentatie opgelost werden. Daarvoor in deel 1 hebben we ons systeem voorbereid en in deel 2 zijn de belangrijkste items van Doxygen geconfigureerd. Lees deel 3a en deel 3b voor het werk aan de PHP Preprocessor. Deze keer gebruiken we mijn eigen DoxyAssist programma om veel van het werk te automatiseren. Tijd om de documentatie nuttig te maken!

Voor mijn serie blogs over Drupal documentatie en de Qt Assistant, wilde ik modulaire API documentatie krijgen. Alles - Drupal Core en alle geïnstalleerde modules - op de grote hoop gooien werd namelijk erg rommelig. Aan de andere kant, alles helemaal gescheiden is ook weer omslachtig. Ik had een hulpje nodig dat automatisch nieuwe modules ontdekt en de documentatie in elkaar zet voor me. Daarna alles bundelen in één Qt Help Collection met de nodige filters, zodat ik alles samen of elke module's documentatie apart kan bekijken en snel kan wisselen binnen één interface. En dat is DoxyAssist!

Weet je nog hoe we de vorige keer Doxygen commentaar in Drupal dusdanig verwerkte, zodat het ook in de uitvoer van Doxygen er goed uit zou zien? Tijd voor een nieuw deel in de serie, en we gaan nog even door met reparaties. Moet je de boel nog goed opzetten, omdat je de eerdere delen misschien gemist hebt? Lees dan eerst delen 1, 2 en vooral 3a voordat je verder gaat. Deze keer: het werkend krijgen van speciale HTML documentatie zoals de Forms API. Beginnen maar!

Welkom terug! Het is een tijd geleden sinds ik deel een en twee van deze serie heb gepost (ja, ik moet vaker bloggen...). Weet je nog dat ik de Drupal documentatie in de Qt Assistant, een handige viewer voor documentatie, aan het zetten was? Mooi. Ik heb goed nieuws: ik heb weer wat tijd gestoken in het in orde krijgen van de documentatie. Dus we gaan gelijk door!

In het vorige deel van deze walk-through hebben we de nodige software geïnstalleerd om de Drupal API documentatie in de Qt Assistant te krijgen. De volgende stap is om de Drupal documentatie te genereren zodat we er doorheen kunnen bladeren, zoeken en meer. Als je dat nog niet gedaan hebt, lees dan eerst deel 1 zodat je zeker weet dat je de goede software geïnstalleerd hebt...

Als je mijn blog ook maar enigszins volgt, weet je dat ik KDE 4 als desktop omgeving heb. Ik heb ook een hoop ontwikkeld (vooral wat aangeklooid tot nu toe, alleen tContact is gepubliceerd) voor Drupal. Een van de programma's die mij daarbij helpt is de Qt Assistant, die bij Qt 4 en later meegeleverd wordt. Het is een snel programma om documentatie te lezen, met een goede index om razendsnel die kleine details van elke functie in Qt 4 op te kunnen zoeken... of Drupal. Ik zal je laten zien hoe ik de boel heb aangepakt.

Oh, als je niet zoveel hebt met al deze technische zooi: je hoeft niet verder te lezen, natuurlijk...