Principes et organisation de la documentation Apache OFBiz
Généralités
La documentation OFBiz est constituée d'un certain nombre de fichiers au format docbook.
En général, les fichiers sont stockés à l'intérieur de chacun des composants, soit dans le répertoire 'document' soit dans le répertoire data/helpdata.
La grammaire DocBook est stockée dans le répertoire application/content/dtd et les feuilles de style sont stockées dans le répertoire applications/content/templates/docbook.
Le système de la documentation OFBiz utilise le composant gestion de contenu.
Un élément de contenu est défini par un 'content' et un 'dataresource'. La définition des types d'enregistrement de ces éléments de contenu
peut être trouvée à la fin du fichier /application/content/data/ContentType.xml. Ils sont dans ce fichier car la documentation et le
fichier d'aide sont considérés comme essentiels pour les opérations d'Apache OFBiz donc des données de base ('seed').
Si vous souhaitez avoir des exemples de fichier au format DocBook, regardez les fichiers suivants :
Un exemple pour un chapitre d'un composant :
applications/accounting/documents/Accounting.xml
Un exemple pour un écran d'aide :
applications/accounting/data/helpdata/HELP_ACCOUNTING_main.xml
Un exemple de création d'éléments de contenu :
applications/accounting/data/AccountingHelpData.xml
Contribuer à la réalistaion d'un nouvel écran d'aide, en quelques étapes.
Il y a une différence entre les écrans portlet et 'normaux'. Si une page contient une portlet, l'aide générale du composant 'myportal'
est montrée avec, à la fin, la liste des portlets utilisées dans cette page. L'aide peut être obtenue en cliquant sur la portlet concernée.
Pages normales.
Si vous voulez créer un nouveau menu d'aide pour un écran, vous aurez besoin de faire ce qui suit :
Dans le HelpLink.ftl dé-commentez la variable ${helpTopic} ce qui la fera apparaître en haut à droite de votre écran.
Dans le composant spécifique data/helpData, créez le fichier HELP_${helpTopic}.xml. Vous pourrez trouver un fichier d'exemple comme HELP_ACCOUNTING_main.xml
Mettez à jour/créez data/${componentName}HelpData.xml, vous pourrez trouver comme exemple le fichier AccountingHelpData.xml. Si vous le créez, pensez à ajouter une ligne dans le fichier ofbiz-component.xml pour que les données soient chargées.
Charger le fichier de données et le ficher d'aide devrait s'afficher lorsque vous cliquerez sur le bouton d'aide.
Committer les changements dans le référentiel SVN ou créez un fichier diff et joignez-le à un jira.
Si le texte d'aide est utile à la documentation d'OFBiz, incluez-le dans les fichiers du répertoire où se trouve le document.
Contribuer à la réalisation d'un nouvel écran d'aide Portlet.
Les portlets sont normalement définies et expliquées dans le fichier ${component name}PortletData.xml . Si vous voulez un example
d'une portlet avec un écran d'aide déjà existant, regardez WorkEffortPortletData.xml
Les enregistrements pour les élément de contenu pour le fichier d'aide sont définis avec la définition de la portlet.
Le fichier d'aide est stocké dans le composant concerné (répertoire : data/helpdata) et se nomme HELP_PORTLET_${portletId}.xml.
L'internationalisation du système d'aide
Comme le système d'aide utilise le composant gestion de contenus, l'internationalisation des fichiers d'aide est très facile car
c'est une des fonctions basiques des éléments de contenu. Si vous voulez faire une traduction d'un fichier d'aide déjà existant, faites-en
une copie dans le même répertoire et rendez-le unique en y ajoutant le "_languageCode" à la fin. Créez, comme ce fut fait pour la
version anglaise, un enregistrement 'dataresource' et 'content' dans le fichier data/${componentName}HelpData.xml . Puis créez un
enregistrement d'association d'éléments de contenu (ContentAssoc) dans le fichier data/${componentName}HelpData.xml pour lier ce
nouveau fichier et le fichier anglais avec comme type de lien 'ALTERNATE_LOCALE'. Ci-desous un exemple de la déclaration de la
traduction en néerlandais du fichier d'aide racine (provenant de : ContentHelpData.xml)
<!-- how to create alternative locales -->
<DataResource dataResourceId="HELP_ROOT_NL" localeString="nl" dataResourceTypeId="OFBIZ_FILE"
objectInfo="applications/content/data/helpdata/HELP_ROOT_NL.xml" dataTemplateTypeId="NONE" statusId="CTNT_IN_PROGRESS"
dataResourceName="Help system root" mimeTypeId="text/xml" isPublic="Y" />
<Content contentId="HELP_ROOT_NL" contentTypeId="DOCUMENT" templateDataResourceId="HELP_TEMPL"
dataResourceId="HELP_ROOT_NL" localeString="nl" statusId="CTNT_IN_PROGRESS"
contentName="Help system root in dutch" mimeTypeId="text/html"/>
<ContentAssoc contentId="HELP_ROOT" contentIdTo="HELP_ROOT_NL"
contentAssocTypeId="ALTERNATE_LOCALE" fromDate="2006-01-12 01:01:01"/>
L'affichage dans la langue de l'utilisateur est donc complétement automatique.