atom feed9 messages in org.apache.ofbiz.userRe: discussion: document proposal.
FromSent OnAttachments
Hans BakkerAug 27, 2009 9:10 pm 
Todd BurdeineiAug 27, 2009 11:04 pm 
Adrian CrumAug 28, 2009 7:24 am 
Jacques Le RouxAug 29, 2009 7:23 am 
Sharan-FAug 30, 2009 1:47 pm 
Jacques Le RouxSep 1, 2009 11:29 pm 
Jacques Le RouxSep 1, 2009 11:43 pm 
Jacques Le RouxSep 1, 2009 11:45 pm 
Jacques Le RouxSep 24, 2009 2:27 am 
Subject:Re: discussion: document proposal.
From:Jacques Le Roux (jacq@les7arts.com)
Date:Sep 1, 2009 11:29:24 pm
List:org.apache.ofbiz.user

As I don't want to learn all Docbook tags, I tried to install the Vex editor as
a plugin in Eclipse (Ganymede == 3.4) but it's not working (and is a known issue). So I found a solution here
http://www.nabble.com/Re%3A-Error-message-when-starting-eclipse-w-VEX-plugin-p13036761.html It works but when I load it asks me about the version of docbook documents I
use. I searched in ML but I'm not quite sure about it, any ideas ? BTW it looks like using OpenOffice (with a plugin?) could be a better solution http://xml.openoffice.org/xmerge/docbook/UserGuide.html...

What I want to do is to put tips like that
http://markmail.org/message/73e5wtnb2m4w4ikw in the online help. For instance
this one would be at the page https://localhost:8443/webtools/control/runService. I'm sure this would be a great benefit for everybody

Thanks

Jacques

From: "Sharan-F" <shar@gmail.com>

Thanks for all the work Hans - its sounds fantastic. Will take a look to see if there is anything I can help with.

Sharan

Jacques Le Roux-2 wrote:

Yes, bravo Hans! We have just to learn docBook now (but sounds easy)...

From: "Adrian Crum" <adri@hlmksw.com>

This sounds great! Thanks Hans!

Hans Bakker wrote:

Your input is required:

You probably noticed the big update? My Apologies for its size but i think it is worth the effort.

To understand quickly where I am talking about, upgrade your local version, reload your seed data (or run ant-install) and go to: content -> content -> navigate -> documents -> 'apache ofbiz in html format'

Then you will see the xml document in file: /applications/commonext/documents/ApacheOfbiz.xml in html format.

The pdf format does not yet work...(Anybody can help: see comment in svn)

----------------------------------------------------------------------- The proposal is to move the documents from docs.ofbiz.org to the ofbiz content manager.

----------------------------------------------------------------------- What are the advantages?

1. No external system required for documentation 2. The content of the internal help files can be used within the documentation 3. The documentation always has the same version as the system (It is part of it) 4. The content is stored in a internationally accepted 'DocBook' (www.docbook.org) format 5. The content can be easily presented in the selected visual schemas (To be implemented)

What is the opinion of the community?