FICO Xpress Optimization Examples Repository: Using moseldoc

defining and using annotations
text handling
generating XML and HTML files with Mosel
subroutines
use of 'datablock' functionality

The moseldoc program can be used from Mosel:

mosel moseldoc -- mddoc.bim

where the BIM file to which it is applied (here: mddoc.bim) must have been compiled specifying the option '-D'. Note that if no filename is specified moseldoc will display a help text and terminate with an error. It is possible to use wildcards such as '*.bim' meaning all bim files in current directory.

Alternatively, the program can be turned into an executable using 'deploy' with the command (requires a C compiler):

mosel comp -s moseldoc.mos -o deploy.exe:moseldoc

The resulting program expects as its parameters a list of files:

moseldoc mddoc.bim

When compiling moseldoc, the 'datablock' functionality is used to include some styles file for the webpage layout. The provided set of files also contains the dictionary template (.pot) generated with the xprnls tool and sets of translations for German and French.

The file 'mddoc.mos' contains examples of using the 'doc' annotations markup and a detailed description of the functionality available through moseldoc. Processing this file with one of the commands shown above will generate the documentation for moseldoc.

Further explanation of this example: 'Mosel Language Reference', Section 2.19 Documenting models using annotations and 'Mosel User Guide', Section 18.2 moseldoc: Generating model documentation.

msgid "" msgstr "" "Project-Id-Version: moseldoc\n" "POT-Creation-Date: 2021-07-06 15:30+0200\n" "PO-Revision-Date: 2021-07-06 15:56+0200\n" "Last-Translator: Yves Colombani\n" "Language: fr\n" "Content-Type: text/plain; charset=ISO8859-15\n" msgid "" "\n" "Usage: %s [-f] [-u] [-xml|-ixml|-html] [-o of] [-i sp] bimf|mosf [bimf|mosf...]\n" "\n" msgstr "" "\n" "Usage: %s [-f] [-u] [-xml|-ixml|-html] [-o of] [-i sp] bimf|mosf [bimf|mosf...]\n" "\n" msgid "! Target location `%s' not found\n" msgstr "! Destination `%s' non trouv�e\n" msgid "+ Creating `%000T' from `%000T'\n" msgstr "+ Cr�ation de `%000T' depuis `%000T'\n" msgid "+ Directory `%000T' already exists. Not regenerating it.\n" msgstr "+ Le r�pertoire `%000T' existe d�j� (non reg�n�r�)\n" msgid "+ Directory `%000T' cannot be created. Ignored.\n" msgstr "+ �chec � la cr�ation du r�pertoire `%000T' (ignor�)\n" msgid "+ File `%000T' already exists. Not regenerating it.\n" msgstr "+ Le fichier `%000T' existe d�j� (non reg�n�r�)\n" msgid "+ File `%000T' cannot be loaded. Ignored.\n" msgstr "+ Le fichier `%000T' ne peut �tre charg� (ignor�)\n" msgid "+ File `%000T' does not contain any `doc.' annotation. Ignored.\n" msgstr "+ Le fichier `%000T' ne contient aucune annotation `doc.' (ignor�)\n" msgid "+ File `%000T' does not include documentation annotations. Ignored.\n" msgstr "+ Le fichier `%000T' ne contient aucune annotation de documentation (ignor�\n" msgid "Annotation '%000T' not found (%s)\n" msgstr "L'annotation '%000T' est introuvable (%s)\n" msgid "Cannot find argument `%000T' for value `%000T' (ignored)\n" msgstr "L'argument `%000T' ne peut �tre trouv� pour la valeur`%000T' (ignor�)\n" msgid "Cannot group `%s' with `%s' (name not found)\n" msgstr "`%s' ne peut �tre group� avec `%s' (identificateur introuvable)\n" msgid "Control parameter '%000T' not found (%s)\n" msgstr "Le param�tre de contr�le '%000T' est introuvable (%s)\n" msgid "" "Generate documentation from annotated bim files or mosel sources.\n" " -f force creation of the document even if it already exists\n" " -u keep documentation of annotations that are not defined via 'mc.def'\n" " -xml generate only the XML file\n" " -ixml generate only the XML file without header/root node (for inclusion)\n" " -html generate only the HTML document (from an existing XML file)\n" " -o of write to file 'of' if xml, or directory 'of' if html\n" " -i sp add 'sp' to the list of paths for file inclusion\n" " -e exit on XML error\n" msgstr "" "G�n�re une documentation depuis du code Mosel annot� (source ou binaire).\n" " -f force la cr�ation du document m�me si il existe d�j�\n" " -u conserve la documentation des annotations non d�finies via 'mc.def'\n" " -xml g�n�re le XML seulement\n" " -ixml g�n�re le XML seulement sans ent�te ni racine (pour inclusion)\n" " -html g�n�re le document HTML � partir d'un XML existant\n" " -o of sauvegarde dans 'of' si xml, ou dans le r�pertoire 'of' si html\n" " -i sp ajoute 'sp' � la liste des chemins pour l'inclusion de fichier\n" " -e abandon en cas d'erreur dans le XML\n" msgid "Link date" msgstr "Date de cr�ation" msgid "Root node `%s' does not exist\n" msgstr "Le noeud racine `%s' n'existe pas\n" msgid "" "The XML file '%000T' could not be loaded (%s)\n" "\n" msgstr "" "Le fichier XML `%000T' ne peut �tre charg� (%s)\n" "\n" msgid "" "The XML file '%000T' does not contain any chapter or section (%s)\n" "\n" msgstr "" "Le fichier XML '%000T' ne contient ni chapitre ni section (%s)\n" "\n" msgid "" "The XML file '%000T' includes a section and target location is not defined (%s)\n" "\n" msgstr "" "Le fichier XML '%000T' inclut une section mais le point d'insertion n'est pas d�fini (%s)\n" "\n" msgid "" "The following text is not valid XML (%s):\n" "%000T\n" msgstr "" "Le texte ci-dessous n'est pas du XML valide (%s):\n" "%000T\n" msgid "Topics covered in this chapter:" msgstr "Sujets couverts par ce chapitre:" msgid "abort" msgstr "abandon" msgid "ignored" msgstr "ignor�"