Re: docbook plugin
On 13 Oct 2006, at 16:39, pjungwir wrote: ir. ing. Jan Dockx wrote: http://cvs.peopleware.be/training/maven/maven2/ buildLifecyclePhases.html hope this helps. Thanks. That is the best table I've seen so far. I eventually figured this out by looking here: https://svn.apache.org/repos/asf/maven/components/tags/maven-2.0.4/ maven-core/src/main/resources/META-INF/plexus/components.xml One thing I still don't understand: most of the lists out there don't mention the initialize phase. The list you posted has it, but in brackets with no description. Why is that? Because, as far as I understand, it is there only for internal reasons, and not for plugins to be used. Maven developers might confirm or deny this … Paul -- View this message in context: http://www.nabble.com/docbook-plugin- tf2408569.html#a6796874 Sent from the Maven - Users mailing list archive at Nabble.com. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] ** Attachment: Extremely Witty Signature.doc
Re: docbook plugin
http://cvs.peopleware.be/training/maven/maven2/ buildLifecyclePhases.html hope this helps. On 9 Oct 2006, at 23:50, pjungwir wrote: Jacek Laskowski-4 wrote: On 10/9/06, Andr?s [EMAIL PROTECTED] wrote: I don't know about such a pre-site phase. Indeed, I think there's no site phase either. Is it a typo, or I'm missing something?. It's executed right before the 'site' phase. Run 'mvn site' and see what happens. I went to that link, but I don't see any reference to phases. I also checked the lifecycle doc here: http://maven.apache.org/guides/introduction/introduction-to-the- lifecycle.html That doesn't mention the site or pre-site phases. I suppose generating a site must be a different lifecycle from a regular build. Can you point me to a description of how this works? What are all the phases when you say mvn site? Thanks, Paul -- View this message in context: http://www.nabble.com/docbook-plugin- tf2408569.html#a6726350 Sent from the Maven - Users mailing list archive at Nabble.com. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] […] my biggest problem is finding out how to do things. (in a mail on the Maven Users List)
Re: docbook plugin
ir. ing. Jan Dockx wrote: http://cvs.peopleware.be/training/maven/maven2/buildLifecyclePhases.html hope this helps. Thanks. That is the best table I've seen so far. I eventually figured this out by looking here: https://svn.apache.org/repos/asf/maven/components/tags/maven-2.0.4/maven-core/src/main/resources/META-INF/plexus/components.xml One thing I still don't understand: most of the lists out there don't mention the initialize phase. The list you posted has it, but in brackets with no description. Why is that? Paul -- View this message in context: http://www.nabble.com/docbook-plugin-tf2408569.html#a6796874 Sent from the Maven - Users mailing list archive at Nabble.com. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: docbook plugin
Hi. It depends. You can use mine if you're looking for: * Configuration of the stylesheets using the plugin configuration mechanism; * A solution that has everything included in the actual plugin; (No manual downloading of stylesheets or the DTD) * Entity resolution using entities defined in your POM; * PDF generation; * Man pages generation; * A non-codehaus implementation. http://www.agilejava.com/docbkx/docbkx-maven-plugin/ http://www.agilejava.com/docbkx/docbkx-samples/html/manual.html However, if you want to use Simplified DocBook, then you first need to create a dedicated jar containing the DTD, similar to the DocBook 4.4 version found here: http://www.agilejava.com/maven/org/docbook/docbook-xml/4.4/ (Note that is actually nothing but the DocBook DTD distribution unzipped, jarred and uploaded together with a POM.) The plugin will pick up the catalog file in the jar and use that to dynamically resolve the DTD and all other relevant entities. Thanks, I'll be trying that out. Bye. /lexi - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: docbook plugin
Wilfred, I've searched for about half an hour but could not find any installation instructuons for your plugin. Yes I saw some pom fragments - but how do I install/download your plugin? Which pluginRepository should I use? I'd really appreciate a ready-to-use sample project. Bye. /lexi - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
RE: docbook plugin
Hi Aleksei, I'll add to the manual that - at this stage - you need to add my personal repository (http://agilejava.com/maven/) to your list of repositories. I have been trying to get the plugin uploaded to the central repository, but for some reason you can only upload plugins if you set up an rsync synchronisation process, and I haven't been able to do that yet. In the meanwhile, simply hook up to my own repository. There is in fact a samples project with a sample POM here: http://86.85.236.224/svn/docbkx/trunk/docbkx-samples/pom.xml (However, it's missing the required repository section I'll make sure that's getting added.) Hope it helps. Wilfred -Original Message- From: Aleksei Valikov [mailto:[EMAIL PROTECTED] Sent: Tue 10/10/2006 10:37 AM To: Maven Users List Subject: Re: docbook plugin Wilfred, I've searched for about half an hour but could not find any installation instructuons for your plugin. Yes I saw some pom fragments - but how do I install/download your plugin? Which pluginRepository should I use? I'd really appreciate a ready-to-use sample project. Bye. /lexi - 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]
Re: docbook plugin
Ok, I fixed my problem with the pre-site phase. It was because I was
invoking mvn site:site instead of mvn site, so I was invoking the
plug-in instead of the phase.
Aleksei asked for the plugin configuration:
El 10/10/2006 10:37, Aleksei Valikov escribió:
Wilfred,
I've searched for about half an hour but could not find any
installation instructuons for your plugin. Yes I saw some pom
fragments - but how do I install/download your plugin? Which
pluginRepository should I use?
I'd really appreciate a ready-to-use sample project.
This is my particular POM (notice it contains my own directories
configuration):
build
plugins
plugin
groupIdcom.agilejava.docbkx/groupId
artifactIddocbkx-maven-plugin/artifactId
version1.69.1.7/version
executions
execution
goals
goalgenerate-html/goal
goalgenerate-pdf/goal
/goals
phasepre-site/phase
/execution
/executions
dependencies
dependency
groupIdorg.docbook/groupId
artifactIddocbook-xml/artifactId
version4.4/version
scoperuntime/scope
/dependency
/dependencies
configuration
chunkedOutputtrue/chunkedOutput
xincludeSupporttrue/xincludeSupport
sourceDirectory${basedir}/src/main/site/docbook/sourceDirectory
targetDirectory${basedir}/target/site/docs/targetDirectory
/configuration
/plugin
/plugins
/build
pluginRepositories
pluginRepository
idagilejava/id
urlhttp://www.agilejava.com/maven//url
snapshots
enabledtrue/enabled
/snapshots
/pluginRepository
/pluginRepositories
Hope it helps you,
Andrés Viedma
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
Re: docbook plugin
Hi.
Ok, I fixed my problem with the pre-site phase. It was because I was
invoking mvn site:site instead of mvn site, so I was invoking the
plug-in instead of the phase.
Aleksei asked for the plugin configuration:
El 10/10/2006 10:37, Aleksei Valikov escribió:
Wilfred,
I've searched for about half an hour but could not find any
installation instructuons for your plugin. Yes I saw some pom
fragments - but how do I install/download your plugin? Which
pluginRepository should I use?
I'd really appreciate a ready-to-use sample project.
This is my particular POM (notice it contains my own directories
configuration):
build
plugins
plugin
groupIdcom.agilejava.docbkx/groupId
artifactIddocbkx-maven-plugin/artifactId
version1.69.1.7/version
executions
execution
goals
goalgenerate-html/goal
goalgenerate-pdf/goal
/goals
phasepre-site/phase
/execution
/executions
dependencies
dependency
groupIdorg.docbook/groupId
artifactIddocbook-xml/artifactId
version4.4/version
scoperuntime/scope
/dependency
/dependencies
configuration
chunkedOutputtrue/chunkedOutput
xincludeSupporttrue/xincludeSupport
sourceDirectory${basedir}/src/main/site/docbook/sourceDirectory
targetDirectory${basedir}/target/site/docs/targetDirectory
/configuration
/plugin
/plugins
/build
pluginRepositories
pluginRepository
idagilejava/id
urlhttp://www.agilejava.com/maven//url
snapshots
enabledtrue/enabled
/snapshots
/pluginRepository
/pluginRepositories
Thanks a lot folks, this helps.
In any case what I think would be nice is some kind of a ZIP assembly which
represents a complete and independent project. You know, just unpack and run mvn
site and see the magic.
I'll also report when I've integrated the plugin.
Bye.
/lexi
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
Re: docbook plugin
Hi. I'll add to the manual that - at this stage - you need to add my personal repository (http://agilejava.com/maven/) to your list of repositories. I have been trying to get the plugin uploaded to the central repository, but for some reason you can only upload plugins if you set up an rsync synchronisation process, and I haven't been able to do that yet. In the meanwhile, simply hook up to my own repository. There is in fact a samples project with a sample POM here: http://86.85.236.224/svn/docbkx/trunk/docbkx-samples/pom.xml (However, it's missing the required repository section I'll make sure that's getting added.) Hope it helps. Wow, great, it worked out! I have yet another small question. My doc (reference/reference.xml) includes some images (reference/images/a.gif etc.). How do I instruct Maven/docbkx plugin to copy the images together with generated html/pdf? Right now I get reference.html reference.fo reference.pdf in the output folder. I'd like these to be accompanied with images/**/*.*. I'd be grateful if you give me a clue. Thanks again for your time and a great plugin. Bye. /lexi - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: docbook plugin
It depends. You can use mine if you're looking for: * Configuration of the stylesheets using the plugin configuration mechanism; * A solution that has everything included in the actual plugin; (No manual downloading of stylesheets or the DTD) * Entity resolution using entities defined in your POM; * PDF generation; * Man pages generation; * A non-codehaus implementation. http://www.agilejava.com/docbkx/docbkx-maven-plugin/ http://www.agilejava.com/docbkx/docbkx-samples/html/manual.html However, if you want to use Simplified DocBook, then you first need to create a dedicated jar containing the DTD, similar to the DocBook 4.4 version found here: http://www.agilejava.com/maven/org/docbook/docbook-xml/4.4/ (Note that is actually nothing but the DocBook DTD distribution unzipped, jarred and uploaded together with a POM.) The plugin will pick up the catalog file in the jar and use that to dynamically resolve the DTD and all other relevant entities. Cheers, Wilfred On Mon, 2006-10-09 at 10:25 +0200, Aleksei Valikov wrote: Hi folks, Which docbook plugin would you recommend to use? Just like many people I previously used DocBook XSLTs and builds from Hibernate documentation. My projects are now ported to Maven and I'd like to port documentation generation as well. I've found several plugins that seem to do the job, but I got no idea which one is usable. I have documents in simplified DocBook. Bye. /lexi - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] Wilfred Springer | Software Architect | TomTom | [EMAIL PROTECTED] | +31 646 720 990 - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: docbook plugin
El 09/10/2006 15:32, Wilfred Springer escribió: It depends. You can use mine (...) Wilfred, I'm taking a look at your docbook plug-in. It looks great, but I've seen something strange in the user guide: execution goals goalgenerate-html/goal /goals phasepre-site/phase /execution I don't know about such a pre-site phase. Indeed, I think there's no site phase either. Is it a typo, or I'm missing something?. Thanks in advance. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: docbook plugin
On 10/9/06, Andrés [EMAIL PROTECTED] wrote: I don't know about such a pre-site phase. Indeed, I think there's no site phase either. Is it a typo, or I'm missing something?. It's executed right before the 'site' phase. Run 'mvn site' and see what happens. @see http://maven.apache.org/guides/mini/guide-site.html Jacek -- Jacek Laskowski http://www.laskowski.net.pl - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: docbook plugin
Jacek Laskowski-4 wrote: On 10/9/06, Andr?s [EMAIL PROTECTED] wrote: I don't know about such a pre-site phase. Indeed, I think there's no site phase either. Is it a typo, or I'm missing something?. It's executed right before the 'site' phase. Run 'mvn site' and see what happens. I went to that link, but I don't see any reference to phases. I also checked the lifecycle doc here: http://maven.apache.org/guides/introduction/introduction-to-the-lifecycle.html That doesn't mention the site or pre-site phases. I suppose generating a site must be a different lifecycle from a regular build. Can you point me to a description of how this works? What are all the phases when you say mvn site? Thanks, Paul -- View this message in context: http://www.nabble.com/docbook-plugin-tf2408569.html#a6726350 Sent from the Maven - Users mailing list archive at Nabble.com. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
RE: docbook plugin
Hi Andres,
There *is* actually a pre-site phase, however it's part of a different
lifecycle. If you generate a site ('mvn site'), then Maven will first execute
all plugins bound to the 'pre-site' phase, and then all plugins bound to the
'site' phase, including the 'site:generate' plugin.
Hope it helps.
Thanks,
Wilfred
-Original Message-
From: Andrés [mailto:[EMAIL PROTECTED]
Sent: Mon 10/9/2006 7:34 PM
To: Maven Users List
Subject: Re: docbook plugin
El 09/10/2006 15:32, Wilfred Springer escribió:
It depends. You can use mine
(...)
Wilfred, I'm taking a look at your docbook plug-in. It looks great, but
I've seen something strange in the user guide:
execution
goals
goalgenerate-html/goal
/goals
phasepre-site/phase
/execution
I don't know about such a pre-site phase. Indeed, I think there's no
site phase either. Is it a typo, or I'm missing something?.
Thanks in advance.
-
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]
RE: docbook plugin
Hello, Thanks for your answer. How many different lifecycles are there? The only one I've seen documented is the build lifecycle. It sounds like there is at least one more, containing the pre-site and site phases. I also see that plugins can create their own lifecycles and assign them an id: http://maven.apache.org/developers/mojo-api-specification.html http://maven.apache.org/guides/introduction/introduction-to-the-lifecycle.html I checked the site plugin to see if that's what is going on, but grepping didn't turn up any references to pre-site. So I guess this is built into maven? Thanks, Paul -- View this message in context: http://www.nabble.com/docbook-plugin-tf2408569.html#a6730396 Sent from the Maven - Users mailing list archive at Nabble.com. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
RE: docbook plugin
If found out about it in Mergere's Maven 2 book. -Original Message- From: pjungwir [mailto:[EMAIL PROTECTED] Sent: Mon 10/9/2006 11:50 PM To: users@maven.apache.org Subject: Re: docbook plugin Jacek Laskowski-4 wrote: On 10/9/06, Andr?s [EMAIL PROTECTED] wrote: I don't know about such a pre-site phase. Indeed, I think there's no site phase either. Is it a typo, or I'm missing something?. It's executed right before the 'site' phase. Run 'mvn site' and see what happens. I went to that link, but I don't see any reference to phases. I also checked the lifecycle doc here: http://maven.apache.org/guides/introduction/introduction-to-the-lifecycle.html That doesn't mention the site or pre-site phases. I suppose generating a site must be a different lifecycle from a regular build. Can you point me to a description of how this works? What are all the phases when you say mvn site? Thanks, Paul -- View this message in context: http://www.nabble.com/docbook-plugin-tf2408569.html#a6726350 Sent from the Maven - Users mailing list archive at Nabble.com. - 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]
RE: docbook plugin
Wilfred Springer-3 wrote: If found out about it in Mergere's Maven 2 book. Ah, sure enough. Thanks very much! On page 258: pre-site (unbound by default) site (bound to site:site) post-site (unbound by default) site-deploy (bound to site:deploy) -- View this message in context: http://www.nabble.com/docbook-plugin-tf2408569.html#a6730470 Sent from the Maven - Users mailing list archive at Nabble.com. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: docbook plugin - how to ??
Hi Felipe, I've crafted another DocBook plugin. (In order to prevent naming conflicts conveniently called Maven Docbkx Plugin.) Since I was in the same situation you were and had to let go of my Ant scripts, I've kind of taken the opportunity to turn into something that is *at least* as usable as the old Ant scripts, but you want to check it our yourselves. Find (outdated) documentation at http://www.agilejava.com/docbkx/ and search my blog at http://www.agilejava.com/blog/ for more information. I will try to update the documentation as soon as I get my home SVN server back online Here are my blog entries that you might find useful. You should probably read them in the given order. http://agilejava.com/blog/?p=31 http://agilejava.com/blog/?p=36 http://agilejava.com/blog/?p=37 http://agilejava.com/blog/?p=38 http://agilejava.com/blog/?p=45 Cheers, Wilfred On Fri, 2006-06-16 at 13:58 +0200, Felipe Gaúcho wrote: Dear Bolcina, first of all thank you very much for the friendly responses... I have an old project that uses DocBook to generate its documentations in PDF format (https://cejug-classifieds.dev.java.net/).. everything works fine on the old versions of Maven.. in fact my maven script is a set of ANT calls.. the documentation folder is self-contained because it can produce documents offline... the problems started when I decided to update the maven version :)) for now, I can't compile a simple example through the plugin just because the plugin seem not to work... do you have a command line I can use to install the plugin ? I tested several options here and nothing happens... best regards, Felipe Gaucho On 6/16/06, Borut Bolčina [EMAIL PROTECTED] wrote: Subject: Maven for documentation http://mail-archives.apache.org/mod_mbox/maven-users/200605.mbox/[EMAIL PROTECTED] On 16.6.2006 13:48, Felipe Gaúcho wrote: sorry, the link sent me to a page with hundred of entries.. which one ? On 6/16/06, Borut Bolčina [EMAIL PROTECTED] wrote: See my post http://mail-archives.apache.org/mod_mbox/maven-users/200605.mbox/browser which unfortunately no one commented on. Anyway, don't loose hope. Borut On 16.6.2006 10:22, Felipe Gaúcho wrote: Dear friends, I'm trying to use the docbook plugin of maven 2.0.4 but something is getting wrong :)) any tip ? C:\ mvn --version Maven version: 2.0.4 c:\ mvn plugin:download -DgroupId=maven-plugins -DartifactId=maven-sdocbook-plugin -Dversion=1.4.1 [INFO] Scanning for projects... [INFO] Searching repository for plugin with prefix: 'help'. [INFO] org.apache.maven.plugins: checking for updates from central [INFO] org.codehaus.mojo: checking for updates from central [INFO] artifact org.apache.maven.plugins:maven-help-plugin: checking for updates from central [INFO] [INFO] Building Maven Default Project [INFO]task-segment: [help:describe] (aggregator-style) [INFO] [INFO] [help:describe] [INFO] Searching repository for plugin with prefix: 'install'. [INFO] [ERROR] BUILD FAILURE [INFO] [INFO] Plugin could not be found. If you believe it is correct, check your pluginGroups setting, and run with -U to update the remote configuration [INFO] [INFO] For more information, run Maven with the -e switch [INFO] [INFO] Total time: 6 seconds [INFO] Finished at: Fri Jun 16 10:18:18 CEST 2006 [INFO] Final Memory: 2M/5M [INFO] - 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]
Re: docbook plugin - how to ??
2006/6/16, Felipe Gaúcho [EMAIL PROTECTED]: Dear friends, I'm trying to use the docbook plugin of maven 2.0.4 but something is getting wrong :)) any tip ? Please, take a look at http://mojo.codehaus.org/docbook-maven-plugin/. Best regards Jose
Re: docbook plugin - how to ??
See my post http://mail-archives.apache.org/mod_mbox/maven-users/200605.mbox/browser which unfortunately no one commented on. Anyway, don't loose hope. Borut On 16.6.2006 10:22, Felipe Gaúcho wrote: Dear friends, I'm trying to use the docbook plugin of maven 2.0.4 but something is getting wrong :)) any tip ? C:\ mvn --version Maven version: 2.0.4 c:\ mvn plugin:download -DgroupId=maven-plugins -DartifactId=maven-sdocbook-plugin -Dversion=1.4.1 [INFO] Scanning for projects... [INFO] Searching repository for plugin with prefix: 'help'. [INFO] org.apache.maven.plugins: checking for updates from central [INFO] org.codehaus.mojo: checking for updates from central [INFO] artifact org.apache.maven.plugins:maven-help-plugin: checking for updates from central [INFO] [INFO] Building Maven Default Project [INFO]task-segment: [help:describe] (aggregator-style) [INFO] [INFO] [help:describe] [INFO] Searching repository for plugin with prefix: 'install'. [INFO] [ERROR] BUILD FAILURE [INFO] [INFO] Plugin could not be found. If you believe it is correct, check your pluginGroups setting, and run with -U to update the remote configuration [INFO] [INFO] For more information, run Maven with the -e switch [INFO] [INFO] Total time: 6 seconds [INFO] Finished at: Fri Jun 16 10:18:18 CEST 2006 [INFO] Final Memory: 2M/5M [INFO] - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: docbook plugin - how to ??
sorry, the link sent me to a page with hundred of entries.. which one ? On 6/16/06, Borut Bolčina [EMAIL PROTECTED] wrote: See my post http://mail-archives.apache.org/mod_mbox/maven-users/200605.mbox/browser which unfortunately no one commented on. Anyway, don't loose hope. Borut On 16.6.2006 10:22, Felipe Gaúcho wrote: Dear friends, I'm trying to use the docbook plugin of maven 2.0.4 but something is getting wrong :)) any tip ? C:\ mvn --version Maven version: 2.0.4 c:\ mvn plugin:download -DgroupId=maven-plugins -DartifactId=maven-sdocbook-plugin -Dversion=1.4.1 [INFO] Scanning for projects... [INFO] Searching repository for plugin with prefix: 'help'. [INFO] org.apache.maven.plugins: checking for updates from central [INFO] org.codehaus.mojo: checking for updates from central [INFO] artifact org.apache.maven.plugins:maven-help-plugin: checking for updates from central [INFO] [INFO] Building Maven Default Project [INFO]task-segment: [help:describe] (aggregator-style) [INFO] [INFO] [help:describe] [INFO] Searching repository for plugin with prefix: 'install'. [INFO] [ERROR] BUILD FAILURE [INFO] [INFO] Plugin could not be found. If you believe it is correct, check your pluginGroups setting, and run with -U to update the remote configuration [INFO] [INFO] For more information, run Maven with the -e switch [INFO] [INFO] Total time: 6 seconds [INFO] Finished at: Fri Jun 16 10:18:18 CEST 2006 [INFO] Final Memory: 2M/5M [INFO] - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: docbook plugin - how to ??
Subject: Maven for documentation http://mail-archives.apache.org/mod_mbox/maven-users/200605.mbox/[EMAIL PROTECTED] On 16.6.2006 13:48, Felipe Gaúcho wrote: sorry, the link sent me to a page with hundred of entries.. which one ? On 6/16/06, Borut Bolčina [EMAIL PROTECTED] wrote: See my post http://mail-archives.apache.org/mod_mbox/maven-users/200605.mbox/browser which unfortunately no one commented on. Anyway, don't loose hope. Borut On 16.6.2006 10:22, Felipe Gaúcho wrote: Dear friends, I'm trying to use the docbook plugin of maven 2.0.4 but something is getting wrong :)) any tip ? C:\ mvn --version Maven version: 2.0.4 c:\ mvn plugin:download -DgroupId=maven-plugins -DartifactId=maven-sdocbook-plugin -Dversion=1.4.1 [INFO] Scanning for projects... [INFO] Searching repository for plugin with prefix: 'help'. [INFO] org.apache.maven.plugins: checking for updates from central [INFO] org.codehaus.mojo: checking for updates from central [INFO] artifact org.apache.maven.plugins:maven-help-plugin: checking for updates from central [INFO] [INFO] Building Maven Default Project [INFO]task-segment: [help:describe] (aggregator-style) [INFO] [INFO] [help:describe] [INFO] Searching repository for plugin with prefix: 'install'. [INFO] [ERROR] BUILD FAILURE [INFO] [INFO] Plugin could not be found. If you believe it is correct, check your pluginGroups setting, and run with -U to update the remote configuration [INFO] [INFO] For more information, run Maven with the -e switch [INFO] [INFO] Total time: 6 seconds [INFO] Finished at: Fri Jun 16 10:18:18 CEST 2006 [INFO] Final Memory: 2M/5M [INFO] - 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]
Re: docbook plugin - how to ??
Dear Bolcina, first of all thank you very much for the friendly responses... I have an old project that uses DocBook to generate its documentations in PDF format (https://cejug-classifieds.dev.java.net/).. everything works fine on the old versions of Maven.. in fact my maven script is a set of ANT calls.. the documentation folder is self-contained because it can produce documents offline... the problems started when I decided to update the maven version :)) for now, I can't compile a simple example through the plugin just because the plugin seem not to work... do you have a command line I can use to install the plugin ? I tested several options here and nothing happens... best regards, Felipe Gaucho On 6/16/06, Borut Bolčina [EMAIL PROTECTED] wrote: Subject: Maven for documentation http://mail-archives.apache.org/mod_mbox/maven-users/200605.mbox/[EMAIL PROTECTED] On 16.6.2006 13:48, Felipe Gaúcho wrote: sorry, the link sent me to a page with hundred of entries.. which one ? On 6/16/06, Borut Bolčina [EMAIL PROTECTED] wrote: See my post http://mail-archives.apache.org/mod_mbox/maven-users/200605.mbox/browser which unfortunately no one commented on. Anyway, don't loose hope. Borut On 16.6.2006 10:22, Felipe Gaúcho wrote: Dear friends, I'm trying to use the docbook plugin of maven 2.0.4 but something is getting wrong :)) any tip ? C:\ mvn --version Maven version: 2.0.4 c:\ mvn plugin:download -DgroupId=maven-plugins -DartifactId=maven-sdocbook-plugin -Dversion=1.4.1 [INFO] Scanning for projects... [INFO] Searching repository for plugin with prefix: 'help'. [INFO] org.apache.maven.plugins: checking for updates from central [INFO] org.codehaus.mojo: checking for updates from central [INFO] artifact org.apache.maven.plugins:maven-help-plugin: checking for updates from central [INFO] [INFO] Building Maven Default Project [INFO]task-segment: [help:describe] (aggregator-style) [INFO] [INFO] [help:describe] [INFO] Searching repository for plugin with prefix: 'install'. [INFO] [ERROR] BUILD FAILURE [INFO] [INFO] Plugin could not be found. If you believe it is correct, check your pluginGroups setting, and run with -U to update the remote configuration [INFO] [INFO] For more information, run Maven with the -e switch [INFO] [INFO] Total time: 6 seconds [INFO] Finished at: Fri Jun 16 10:18:18 CEST 2006 [INFO] Final Memory: 2M/5M [INFO] - 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]
Re: docbook plugin - how to ??
Hello Felipe, I have this in my build pom's section plugins plugin artifactIdmaven-site-plugin/artifactId groupIdorg.apache.maven.plugins/groupId version2.0-beta-5/version configuration inputEncodingutf-8/inputEncoding outputEncodingutf-8/outputEncoding /configuration /plugin /plugins /build but haven't build any docbook document in weeks now, I'll check later at home, now I am a bit busy. On 16.6.2006 13:58, Felipe Gaúcho wrote: Dear Bolcina, first of all thank you very much for the friendly responses... I have an old project that uses DocBook to generate its documentations in PDF format (https://cejug-classifieds.dev.java.net/).. everything works fine on the old versions of Maven.. in fact my maven script is a set of ANT calls.. the documentation folder is self-contained because it can produce documents offline... the problems started when I decided to update the maven version :)) for now, I can't compile a simple example through the plugin just because the plugin seem not to work... do you have a command line I can use to install the plugin ? I tested several options here and nothing happens... best regards, Felipe Gaucho On 6/16/06, Borut Bolčina [EMAIL PROTECTED] wrote: Subject: Maven for documentation http://mail-archives.apache.org/mod_mbox/maven-users/200605.mbox/[EMAIL PROTECTED] On 16.6.2006 13:48, Felipe Gaúcho wrote: sorry, the link sent me to a page with hundred of entries.. which one ? On 6/16/06, Borut Bolčina [EMAIL PROTECTED] wrote: See my post http://mail-archives.apache.org/mod_mbox/maven-users/200605.mbox/browser which unfortunately no one commented on. Anyway, don't loose hope. Borut On 16.6.2006 10:22, Felipe Gaúcho wrote: Dear friends, I'm trying to use the docbook plugin of maven 2.0.4 but something is getting wrong :)) any tip ? C:\ mvn --version Maven version: 2.0.4 c:\ mvn plugin:download -DgroupId=maven-plugins -DartifactId=maven-sdocbook-plugin -Dversion=1.4.1 [INFO] Scanning for projects... [INFO] Searching repository for plugin with prefix: 'help'. [INFO] org.apache.maven.plugins: checking for updates from central [INFO] org.codehaus.mojo: checking for updates from central [INFO] artifact org.apache.maven.plugins:maven-help-plugin: checking for updates from central [INFO] [INFO] Building Maven Default Project [INFO] task-segment: [help:describe] (aggregator-style) [INFO] [INFO] [help:describe] [INFO] Searching repository for plugin with prefix: 'install'. [INFO] [ERROR] BUILD FAILURE [INFO] [INFO] Plugin could not be found. If you believe it is correct, check your pluginGroups setting, and run with -U to update the remote configuration [INFO] [INFO] For more information, run Maven with the -e switch [INFO] [INFO] Total time: 6 seconds [INFO] Finished at: Fri Jun 16 10:18:18 CEST 2006 [INFO] Final Memory: 2M/5M [INFO] - 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] -- -- Naključna izjava tedna iz tednika Mladina:
RE: Docbook plugin
Hi, I have had this need in the past... Maybe you can have a look on a Wiki like PyWikiServer (http://sourceforge.net/projects/pywikiserver) that encoding files in DocBook format Best regards, Jacques -Message d'origine- De : Jose Gonzalez Gomez [mailto:[EMAIL PROTECTED] Envoyé : jeudi 24 novembre 2005 09:38 À : Maven Users List Objet : Docbook plugin Hi there, I have a preliminary version of a Docbook plugin for Maven2. Here is my typical use case: I use to write project documentation (at least requirements) using Unified Process artifacts (Software requirements specification, actors specification, glossary, risk list, use case specifications,...). My main objective is to have a lot of small, manageable and interlinked documents that form the whole documentation and that can be easily browsed using an Internet browser. To achieve this I use Docbook articles with cross references between documents using olink. In order to transform this documents into a browsable web, you must supply a olink database to the Docbook stylesheets to enable external link resolution. The plugin scans existing Docbook files and automatically generates the olink database using the standard stylesheets. Once the database is created, transforms every document (no chunking nor toc) using the provided database. The only requirement for this to work is to use a predefined schema to build the name of referenced documents (very easy). I know this is a very focused use case and implementation, so I would like to know if there is interest in this to publish it as open source, and maybe add more requirements and flexibility to it... Best regards Jose - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] -- Ce message est protege par les regles relatives au secret des correspondances ; il peut en outre contenir des informations a caractere confidentiel ou protegees par differentes regles et notamment le secret des affaires ; il est etabli a destination exclusive de son destinataire. Toute divulgation, utilisation, diffusion ou reproduction (totale ou partielle) de ce message, ou des informations qu'il contient, doit etre prealablement autorisee. Tout message electronique est susceptible d'alteration et son integrite ne peut etre assuree. Les AGF declinent toute responsabilite au titre de ce message s'il a ete modifie ou falsifie. Si vous n'etes pas destinataire de ce message, merci de le detruire immediatement et d'avertir l'expediteur de l'erreur de distribution et de la destruction du message. This message is protected by the secrecy of correspondence rules ; furthermore it may contain privileged or confidential information that is protected by law, notably by the secrecy of business relations rule ; it is intended solely for the attention of the addressee . Any disclosure, use, dissemination or reproduction (either whole or partial) of this message or the information contained herein is strictly prohibited without prior consent. Any electronic message is susceptible to alteration and its integrity can not be assured. AGF declines any responsibility for this message in the event of alteration or falsification.. If you are not the intended recipient, please destroy it immediately and notify the sender of the wrong delivery and the mail deletion. -- - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: Docbook plugin
Well, it seems that URL doesn't point directly to the thread :o( Try this: http://www.mail-archive.com/users@maven.apache.org/msg25757.html 2005/11/25, Jose Gonzalez Gomez [EMAIL PROTECTED]: http://mail-archives.apache.org/mod_mbox/maven-users/200510.mbox/browser 2005/11/25, Jeff Jensen [EMAIL PROTECTED]: The last thread I recall on this topic is that Doxia has a very minor support of Docbook. Is this not true anymore? -Original Message- From: Emmanuel Venisse [mailto:[EMAIL PROTECTED] Sent: Thursday, November 24, 2005 11:25 AM To: Maven Users List Subject: Re: Docbook plugin docbook is supported by doxia Emmanuel Rune Fauske a écrit : Hi Jose We're just looking into using docbook for both integrated help and the user manual, so a maven docbook plugin would really be appreciated. -- Rune On 11/24/05, Jeff Jensen [EMAIL PROTECTED] wrote: Hi Jose, Fantastic! ...if there is interest..., yes there is! I will need docbook from Maven in the near future. And your auto olink db generation sounds great! -Original Message- From: Jose Gonzalez Gomez [mailto:[EMAIL PROTECTED] Sent: Thursday, November 24, 2005 2:38 AM To: Maven Users List Subject: Docbook plugin Hi there, I have a preliminary version of a Docbook plugin for Maven2. Here is my typical use case: I use to write project documentation (at least requirements) using Unified Process artifacts (Software requirements specification, actors specification, glossary, risk list, use case specifications,...). My main objective is to have a lot of small, manageable and interlinked documents that form the whole documentation and that can be easily browsed using an Internet browser. To achieve this I use Docbook articles with cross references between documents using olink. In order to transform this documents into a browsable web, you must supply a olink database to the Docbook stylesheets to enable external link resolution. The plugin scans existing Docbook files and automatically generates the olink database using the standard stylesheets. Once the database is created, transforms every document (no chunking nor toc) using the provided database. The only requirement for this to work is to use a predefined schema to build the name of referenced documents (very easy). I know this is a very focused use case and implementation, so I would like to know if there is interest in this to publish it as open source, and maybe add more requirements and flexibility to it... Best regards Jose - 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] - 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]
Re: Docbook plugin
http://mail-archives.apache.org/mod_mbox/maven-users/200510.mbox/browser 2005/11/25, Jeff Jensen [EMAIL PROTECTED]: The last thread I recall on this topic is that Doxia has a very minor support of Docbook. Is this not true anymore? -Original Message- From: Emmanuel Venisse [mailto:[EMAIL PROTECTED] Sent: Thursday, November 24, 2005 11:25 AM To: Maven Users List Subject: Re: Docbook plugin docbook is supported by doxia Emmanuel Rune Fauske a écrit : Hi Jose We're just looking into using docbook for both integrated help and the user manual, so a maven docbook plugin would really be appreciated. -- Rune On 11/24/05, Jeff Jensen [EMAIL PROTECTED] wrote: Hi Jose, Fantastic! ...if there is interest..., yes there is! I will need docbook from Maven in the near future. And your auto olink db generation sounds great! -Original Message- From: Jose Gonzalez Gomez [mailto:[EMAIL PROTECTED] Sent: Thursday, November 24, 2005 2:38 AM To: Maven Users List Subject: Docbook plugin Hi there, I have a preliminary version of a Docbook plugin for Maven2. Here is my typical use case: I use to write project documentation (at least requirements) using Unified Process artifacts (Software requirements specification, actors specification, glossary, risk list, use case specifications,...). My main objective is to have a lot of small, manageable and interlinked documents that form the whole documentation and that can be easily browsed using an Internet browser. To achieve this I use Docbook articles with cross references between documents using olink. In order to transform this documents into a browsable web, you must supply a olink database to the Docbook stylesheets to enable external link resolution. The plugin scans existing Docbook files and automatically generates the olink database using the standard stylesheets. Once the database is created, transforms every document (no chunking nor toc) using the provided database. The only requirement for this to work is to use a predefined schema to build the name of referenced documents (very easy). I know this is a very focused use case and implementation, so I would like to know if there is interest in this to publish it as open source, and maybe add more requirements and flexibility to it... Best regards Jose - 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] - 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]
Re: Docbook plugin
I don't think that patch solves all the points I mentioned in that thread, although it's a great step forward, as now you won't lose information from tags not included in the Doxia parser. Any way, I still think having a separate Docbook plugin for certain tasks makes sense. Best regards Jose 2005/11/25, Emmanuel Venisse [EMAIL PROTECTED]: we have a patch for it (http://jira.codehaus.org/browse/DOXIA-24) with a big support Emmanuel Jeff Jensen a écrit : The last thread I recall on this topic is that Doxia has a very minor support of Docbook. Is this not true anymore? -Original Message- From: Emmanuel Venisse [mailto:[EMAIL PROTECTED] Sent: Thursday, November 24, 2005 11:25 AM To: Maven Users List Subject: Re: Docbook plugin docbook is supported by doxia Emmanuel Rune Fauske a écrit : Hi Jose We're just looking into using docbook for both integrated help and the user manual, so a maven docbook plugin would really be appreciated. -- Rune On 11/24/05, Jeff Jensen [EMAIL PROTECTED] wrote: Hi Jose, Fantastic! ...if there is interest..., yes there is! I will need docbook from Maven in the near future. And your auto olink db generation sounds great! -Original Message- From: Jose Gonzalez Gomez [mailto:[EMAIL PROTECTED] Sent: Thursday, November 24, 2005 2:38 AM To: Maven Users List Subject: Docbook plugin Hi there, I have a preliminary version of a Docbook plugin for Maven2. Here is my typical use case: I use to write project documentation (at least requirements) using Unified Process artifacts (Software requirements specification, actors specification, glossary, risk list, use case specifications,...). My main objective is to have a lot of small, manageable and interlinked documents that form the whole documentation and that can be easily browsed using an Internet browser. To achieve this I use Docbook articles with cross references between documents using olink. In order to transform this documents into a browsable web, you must supply a olink database to the Docbook stylesheets to enable external link resolution. The plugin scans existing Docbook files and automatically generates the olink database using the standard stylesheets. Once the database is created, transforms every document (no chunking nor toc) using the provided database. The only requirement for this to work is to use a predefined schema to build the name of referenced documents (very easy). I know this is a very focused use case and implementation, so I would like to know if there is interest in this to publish it as open source, and maybe add more requirements and flexibility to it... Best regards Jose - 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] - 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] - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
RE: Docbook plugin
Hi Jose, Fantastic! ...if there is interest..., yes there is! I will need docbook from Maven in the near future. And your auto olink db generation sounds great! -Original Message- From: Jose Gonzalez Gomez [mailto:[EMAIL PROTECTED] Sent: Thursday, November 24, 2005 2:38 AM To: Maven Users List Subject: Docbook plugin Hi there, I have a preliminary version of a Docbook plugin for Maven2. Here is my typical use case: I use to write project documentation (at least requirements) using Unified Process artifacts (Software requirements specification, actors specification, glossary, risk list, use case specifications,...). My main objective is to have a lot of small, manageable and interlinked documents that form the whole documentation and that can be easily browsed using an Internet browser. To achieve this I use Docbook articles with cross references between documents using olink. In order to transform this documents into a browsable web, you must supply a olink database to the Docbook stylesheets to enable external link resolution. The plugin scans existing Docbook files and automatically generates the olink database using the standard stylesheets. Once the database is created, transforms every document (no chunking nor toc) using the provided database. The only requirement for this to work is to use a predefined schema to build the name of referenced documents (very easy). I know this is a very focused use case and implementation, so I would like to know if there is interest in this to publish it as open source, and maybe add more requirements and flexibility to it... Best regards Jose - 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]
Re: Docbook plugin
Hi Jose We're just looking into using docbook for both integrated help and the user manual, so a maven docbook plugin would really be appreciated. -- Rune On 11/24/05, Jeff Jensen [EMAIL PROTECTED] wrote: Hi Jose, Fantastic! ...if there is interest..., yes there is! I will need docbook from Maven in the near future. And your auto olink db generation sounds great! -Original Message- From: Jose Gonzalez Gomez [mailto:[EMAIL PROTECTED] Sent: Thursday, November 24, 2005 2:38 AM To: Maven Users List Subject: Docbook plugin Hi there, I have a preliminary version of a Docbook plugin for Maven2. Here is my typical use case: I use to write project documentation (at least requirements) using Unified Process artifacts (Software requirements specification, actors specification, glossary, risk list, use case specifications,...). My main objective is to have a lot of small, manageable and interlinked documents that form the whole documentation and that can be easily browsed using an Internet browser. To achieve this I use Docbook articles with cross references between documents using olink. In order to transform this documents into a browsable web, you must supply a olink database to the Docbook stylesheets to enable external link resolution. The plugin scans existing Docbook files and automatically generates the olink database using the standard stylesheets. Once the database is created, transforms every document (no chunking nor toc) using the provided database. The only requirement for this to work is to use a predefined schema to build the name of referenced documents (very easy). I know this is a very focused use case and implementation, so I would like to know if there is interest in this to publish it as open source, and maybe add more requirements and flexibility to it... Best regards Jose - 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]
Re: Docbook plugin
docbook is supported by doxia Emmanuel Rune Fauske a écrit : Hi Jose We're just looking into using docbook for both integrated help and the user manual, so a maven docbook plugin would really be appreciated. -- Rune On 11/24/05, Jeff Jensen [EMAIL PROTECTED] wrote: Hi Jose, Fantastic! ...if there is interest..., yes there is! I will need docbook from Maven in the near future. And your auto olink db generation sounds great! -Original Message- From: Jose Gonzalez Gomez [mailto:[EMAIL PROTECTED] Sent: Thursday, November 24, 2005 2:38 AM To: Maven Users List Subject: Docbook plugin Hi there, I have a preliminary version of a Docbook plugin for Maven2. Here is my typical use case: I use to write project documentation (at least requirements) using Unified Process artifacts (Software requirements specification, actors specification, glossary, risk list, use case specifications,...). My main objective is to have a lot of small, manageable and interlinked documents that form the whole documentation and that can be easily browsed using an Internet browser. To achieve this I use Docbook articles with cross references between documents using olink. In order to transform this documents into a browsable web, you must supply a olink database to the Docbook stylesheets to enable external link resolution. The plugin scans existing Docbook files and automatically generates the olink database using the standard stylesheets. Once the database is created, transforms every document (no chunking nor toc) using the provided database. The only requirement for this to work is to use a predefined schema to build the name of referenced documents (very easy). I know this is a very focused use case and implementation, so I would like to know if there is interest in this to publish it as open source, and maybe add more requirements and flexibility to it... Best regards Jose - 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] - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
RE: Docbook plugin
The last thread I recall on this topic is that Doxia has a very minor support of Docbook. Is this not true anymore? -Original Message- From: Emmanuel Venisse [mailto:[EMAIL PROTECTED] Sent: Thursday, November 24, 2005 11:25 AM To: Maven Users List Subject: Re: Docbook plugin docbook is supported by doxia Emmanuel Rune Fauske a écrit : Hi Jose We're just looking into using docbook for both integrated help and the user manual, so a maven docbook plugin would really be appreciated. -- Rune On 11/24/05, Jeff Jensen [EMAIL PROTECTED] wrote: Hi Jose, Fantastic! ...if there is interest..., yes there is! I will need docbook from Maven in the near future. And your auto olink db generation sounds great! -Original Message- From: Jose Gonzalez Gomez [mailto:[EMAIL PROTECTED] Sent: Thursday, November 24, 2005 2:38 AM To: Maven Users List Subject: Docbook plugin Hi there, I have a preliminary version of a Docbook plugin for Maven2. Here is my typical use case: I use to write project documentation (at least requirements) using Unified Process artifacts (Software requirements specification, actors specification, glossary, risk list, use case specifications,...). My main objective is to have a lot of small, manageable and interlinked documents that form the whole documentation and that can be easily browsed using an Internet browser. To achieve this I use Docbook articles with cross references between documents using olink. In order to transform this documents into a browsable web, you must supply a olink database to the Docbook stylesheets to enable external link resolution. The plugin scans existing Docbook files and automatically generates the olink database using the standard stylesheets. Once the database is created, transforms every document (no chunking nor toc) using the provided database. The only requirement for this to work is to use a predefined schema to build the name of referenced documents (very easy). I know this is a very focused use case and implementation, so I would like to know if there is interest in this to publish it as open source, and maybe add more requirements and flexibility to it... Best regards Jose - 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] - 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]
