_Does DocGen solve your problem? Does it fits to your needs? Is it useful? Any suggestion? Please_ "tell us your opinion":http://forge.isotrol.org/boards/2/topics/show/11 _and needs and we will study them._ h1. DocGen Wiki |*Name*| DocGen Plugout for Bouml | |/2. *Authors*| Nicolas Bertet (Project Manager / Function Responsible) | | José Manuel Portero García (Designer / Developer) | |*Most recent version*| "Version 1.0.3":http://redmine.isotrol.org/versions/show/20 | |*Availability*| Bouml 4.13.1 / OpenOffice 2.4 | |*State*| Improving functionality | |*License*| GNU General Public License v.3 | |*Download sources*| "Sources":http://redmine.isotrol.org/attachments/download/136/docgen-plugout-bouml-v1.0.3-src.zip "Subversion URL":https://svn.isotrol.org/ORG00004_DocGenBOUML login: anonymous password: anonymous| |*Download binaries*| "Binaries":http://redmine.isotrol.org/attachments/download/134/docgen-plugout-bouml-v1.0.3-bin.zip | p=. !LOGO_BOUML.png!:http://bouml.free.fr !LOGO_OPENUP.png!:http://epf.eclipse.org/wikis/openup/ !LOGO_OPENOFFICE.png!:www.openoffice.org h1. Compatibility |\5. *Compatibility with Bouml* | | Plugout version | *4.11* | *4.12.x* | *4.13.x* | *4.16.2* | | *1.0.3* | !http://forge.isotrol.org/attachments/98/cancel.png! | !http://forge.isotrol.org/attachments/98/cancel.png! | !http://forge.isotrol.org/attachments/97/accept.png! | !http://forge.isotrol.org/attachments/97/accept.png! | |\4. *Compatibility with OpenOffice* | | Plugout version | *2.4* | *3.0* | *3.1* | | *1.0.3* | !http://forge.isotrol.org/attachments/97/accept.png! | !http://forge.isotrol.org/attachments/97/accept.png! | !http://forge.isotrol.org/attachments/97/accept.png! | |\4. *Compatibility with Java* | | Plugout version | *J2SDK/J2RE - 1.4* | *JDK/JRE - 5.0* | *JDK/JRE - 6* | | *1.0.3* | !http://forge.isotrol.org/attachments/98/cancel.png! | !http://forge.isotrol.org/attachments/97/accept.png! | !http://forge.isotrol.org/attachments/97/accept.png! | |\8. *Compatibility with Operating Systems* | | Plugout version | *Windows XP* | *Windows Vista* | *Windows 7* |*MacOS* | *Ubuntu* | *Debian* | *Other Linux Distributions* | | *1.0.3* | !http://forge.isotrol.org/attachments/97/accept.png! | !http://forge.isotrol.org/attachments/97/accept.png! | !http://forge.isotrol.org/attachments/99/error.png! | !http://forge.isotrol.org/attachments/98/cancel.png! | !http://forge.isotrol.org/attachments/97/accept.png! | !http://forge.isotrol.org/attachments/97/accept.png! | !http://forge.isotrol.org/attachments/99/error.png! | h1. Description / Features DocGen is a "Bouml":http://bouml.free.fr/ plugout that allows you to generate automatically "OpenUP":http://epf.eclipse.org/wikis/openup/ documentation. It's a practical tool that allows you to update dynamically the documentation of your project. DocGen extracts text and diagrams from a Bouml project and inserts them in a OpenOffice Document. It's preconfigured with a generic template and three definition files of Analysis, Design and Architecture "OpenUP":http://epf.eclipse.org/wikis/openup/ based documents. It allows to insert predefined tables and link external images to insert in the document. You can define your own template and file definitions. It's as easy as writing a OpenOffice Writer document and editing a XML file respectively. h1. Requirements * "Ubuntu":http://www.ubuntu.com/getubuntu/download / "Debian":http://www.debian.org/distrib/ftplist (maybe others but not tested) or Windows XP/Vista * Java Runtime Environment. "Version 5":http://java.sun.com/javase/downloads/index_jdk5.jsp or "Version 6":http://java.sun.com/javase/downloads/index.jsp. * "OpenOffice 2.4":http://download.openoffice.org/2.4.2/index.html / "OpenOffice 3.1":http://download.openoffice.org/ * "Bouml":http://bouml.free.fr/download.html >=4.13.1 h1. Installation Copy docgen.jar in your Bouml directory (usually */usr/lib/bouml* if you use Linux or *C:\Program Files\Bouml* if you use Windows). Open *Template_UP* and save a copy for your use. It contains several classes, text, and contents to test the document generator. You can delete and replace some of them to generate the documents of your software project. * *docgen.jar* contains source code, document template and document definitions. It's able tu run on Windows and Linux (Ubuntu and Debian tested). * *Template_UP* is a project compatible with the definitions of the generic template. It's configured with tools to generate documents, link images and launch user interface extensions to fill tables. If you use Windows, replace the "tools":http://redmine.isotrol.org/attachments/download/46/tools file for the Windows adapted version. h1. Screenshots and results You can see several screenshots of this application: h2. Bouml browser with template. !SCRSHT01.jpg! h2. User interface extension. !SCRSHT02.jpg! h2. Image linker. !SCRSHT03.jpg! h2. Generating analysis document. !SCRSHT04.jpg! h2. Resulting documents: These are examples of generated documents: attachment:Analysis_Document.odt, attachment:Design_Document.odt, attachment:Architecture_Document.odt h1. Source code The last version is version:1.0.2 and you can download source code from Functionality is divided in two projects: OpenOfficeAPI and DocumentGenerator. * *OpenOfficeAPI*: It's a simple API to insert contents in a OO Writer documents. It uses the classes explained in "StarOffice Programming Guide":http://api.openoffice.org/basic/man/tutorial/tutorial.pdf. Originally, it needs to copy four jars in OpenOffice lib directory, but we have modified Bootstrap.java class to avoid it. * *Document Generator*: It includes an Java empty plugout to implement communication with Bouml and packages to implement definition readers. It reads XML definitions, searches contents in Bouml browser and write them in a ODT document. You can modify the document afterwards. h1. Definition files Definition files tells you how to fill the document. You define: * Document properties and variables. * Static text. * Descriptions (long text in item). * Diagrams (PNG images). * Images (External images). * Tables. h1. Sample use # Open template and select options "Generate Analysis Document", "Generate Design Document" or "Generate Architecture Document". # Images can be added in the XML file as item. You can also add one in a "view". You should do this: ## Create a package and stereotype it as "image". ## Call plugout "Link External Image". (NOTE: Sometimes it fails if it's in home folder). ## If you want, you can add a description of the image in the package description. # Try to open a user interface extension in one of these paths: 
/Documents/Analysis Model
/Documents/Design Model
/Documents/Architecture Model
/Documents/Analysis Model/Documents
/Documents/Design Model/Documents
/Documents/Architecture Model/Documents
/Analysis Model/Logic View/Use Case Analysis/Mapping Analysis Mechanisms to Analysis Classes
/Design Model/Architecture Design/Mechanisms and Frameworks/Analysis, Design and Implementation Mechanisms
/Design Model/Architecture Design/Logic View/Design Elements/Mapping Analysis Classes to Design Elements
/Design Model/Architecture Design/Logic View/Design Elements/Mapping Design Elements to Proprietary Packages
/Design Model/Architecture Design/Quality Factors
h1. Known bugs and TODO * Sometimes images are generated with an incorrect size. * Sometimes index pages are not correctly updated. * Sections "Changes Register" and "Document Distribution" of the document extension are not printed in the document. * Implement configuration windows to select an external XML definition file and template. h1. Guides and documents [[Detailed installation guide for Ubuntu and Debian]] [[Interpret Definition Files]] [[How to implement OpenUP with Bouml and DocGen]] h1. Links * http://bouml.free.fr * http://epf.eclipse.org/wikis/openup/ * http://www.openoffice.org