Kahtarina, Yes, phase two integration of the resulting html and pdf into the maven generated site is still to be determined (TBD). I see output generated in target\docs\docbook, \target\generated-docbooks\html, and \target\generated-docbooks\pdf I gather that the addition of a unique goal is required to add the required link in Navigation.xml. Others in the community may offer advise on that piece, I've recall threads along that line but not specific to weaving in docbook artifacts.
Good hunting, Sean -----Original Message----- From: Katharina Hahn [mailto:[EMAIL PROTECTED] Sent: Monday, July 18, 2005 10:27 AM To: Maven Users List Subject: Re: problems generating documentation pages with docbook and site Hi Sean, thanks for you help. Though I don't get the expected output since I don't quite understand phase 2. Running sdocbook generates plain html-pages of the project's documentation. What exactly do I have to do next, to integrate this plain html into the maven based generated site? Best Regards, Katharina Sean Hennessy schrieb: >Katharina, > ><sect><title>Work in progress: Maven [M1] Docbook project artifacts >transformation.</title> <para>Phase one transformation of Docbook XML >based project documentation is accomplished with maven sdocbook plugin >and Win command line used here. >Phase two TBD will integrate these project documentation and design >artifacts into the xdoc based maven artifacts on the generated site. ></para> ><para> ><programlisting> >::%MAVEN_HOME%\bin\maven sdocbook:info >-Dmaven.sdocbook.use.entityresolver=true >-Dmaven.sdocbook.catalogmanager.properties=C:\usr\local\share\sdl\xmlV4 . >2\catalogManager.properties -Dmaven.sdocbook.src.dir=./dbkdir >%MAVEN_HOME%\bin\maven sdocbook -Dmaven.sdocbook.src.dir=./dbkdir > > >>exp1.log >> >> ></programlisting> ></para> ></sect> > >Best Regards, >Sean > >-----Original Message----- >From: Katharina Hahn [mailto:[EMAIL PROTECTED] >Sent: Monday, July 18, 2005 8:04 AM >To: [email protected] >Subject: problems generating documentation pages with docbook and site > > >Hi all, > >I have a problem whose solutions seems to be quiet easy but still I >cannot figure out how to solve it. Maybe someone can help me: > >I would like to use docbook-files for project documentation and >integrate those docbook-files into the projects html-page generated by >the goal 'site'. > >My approach on attaining this goal until now was to use the >docbook-plugin: Using the docbook-plugin to generate xdoc-files out of >docbook-files, the output directory of the xdoc-files is >${basedir}/target/generated-xdocs. Copying and pasting the generated >xdoc-file (e.g. index.xml) to the ${basedir}/xdocs now enables to use >the goal 'site' to integrate the this documentation into the generated >project-webpage. > >I tried to get rid of the step of copying the files manually by using >the property maven.gen.docs=${basedir}/xdocs to direct the generated >xdoc-files to the specified folder. Using this, the transformation of >docbook into xdocs into the specified folder worked fine. But then >running the goal 'site' overwrites the generated xdoc-file in folder >/xdocs and generates the documentation out of the properties.xml. > >Does anyone know how to solve this problem (or maybe even knows a >smarter way how to use docbook files for the maven goal 'site')? > >Thanks in advance, >Katharina > >--------------------------------------------------------------------- >To unsubscribe, e-mail: [EMAIL PROTECTED] >For additional commands, e-mail: [EMAIL PROTECTED] > > >--------------------------------------------------------------------- >To unsubscribe, e-mail: [EMAIL PROTECTED] >For additional commands, e-mail: [EMAIL PROTECTED] > > --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
