FYI: I was not aware this existed http://asciidoctor.org/docs/asciidoctorj/
Using AsciidoctorJ, you can convert AsciiDoc content or analyze the structure of a
parsed AsciiDoc document from Java and other JVM languages.
I see at least DocBook as backend option. We now from DocBook we can have
Le 16/06/2015 09:48, Jacques Le Roux a écrit :
FYI: I was not aware this existed http://asciidoctor.org/docs/asciidoctorj/
Using AsciidoctorJ, you can convert AsciiDoc content or analyze the structure of a
parsed AsciiDoc document from Java and other JVM languages.
I see at least DocBook as
Paul has raised a really key point - it's not only developers that we
want to help document OFBiz. I like the idea of having something that is
simple to use that gives a lot of flexibility and allows anyone to
contribute.
We have the Community Day coming up on Saturday and I'm going to do
On 14/06/2015 7:08 PM, Paul Foxworthy wrote:
Hi all,
Ron Wheeler wrote
I expect that everyone has an IDE that can edit and validate XML. All
the other tools required are free.
...
OFBiz is pretty XML intensive so I would be surprised if OFBiz
developers did not use an IDE that can validate
I said:
When I last looked into DITA quite a few years ago, it seemed to be a
heavyweight thing that only made sense if you wanted multiple destinations
Jacques said:
So you think Docbook (more aimed to create book when DITA is more of
online help
kind, I read) or AsciiDoc are not able
Hi all,
Ron Wheeler wrote
I expect that everyone has an IDE that can edit and validate XML. All
the other tools required are free.
...
OFBiz is pretty XML intensive so I would be surprised if OFBiz
developers did not use an IDE that can validate XML.
Do we only want developers to
On 06/06/2015 5:19 PM, Jacques Le Roux wrote:
Le 06/06/2015 08:10, Paul Foxworthy a écrit :
Sharan-F wrote
I'm a bit unclear about what you are suggesting.
* Is it about replacing the Docbook implementation we currently have
within OFBiz with something else (e.g Asciidoc)?
* Is it
: Paul Foxworthy p...@cohsoft.com.a Pau
To: dev@ofbiz.apache.org
Sent: Saturday, 6 June, 2015 9:10:28 AM
Subject: Re: Possible Documentation and help solutions - DITA
Sharan-F wrote
I'm a bit unclear about what you are suggesting.
* Is it about replacing the Docbook implementation we currently
towards keeping
DocBook, but if a PoC shows how DITA can shine, then why not!
Taher Alkhateeb
- Original Message -
From: Paul Foxworthy p...@cohsoft.com.a Pau
To: dev@ofbiz.apache.org
Sent: Saturday, 6 June, 2015 9:10:28 AM
Subject: Re: Possible Documentation and help solutions - DITA
Sharan-F wrote
I'm a bit unclear about what you are suggesting.
* Is it about replacing the Docbook implementation we currently have
within OFBiz with something else (e.g Asciidoc)?
* Is it about extracting the Docbook content from what we currently
have in OFBiz and then
Sharan-F wrote
Confluence is the Apache approved tools for wiki so we still need to work
within this constraint for now. In any case – I think we firstly need to
do some review of the all the documentation we have before we start
structuring it.
Hi Sharan,
There is a free tool to import
Le 06/06/2015 08:10, Paul Foxworthy a écrit :
Sharan-F wrote
I'm a bit unclear about what you are suggesting.
* Is it about replacing the Docbook implementation we currently have
within OFBiz with something else (e.g Asciidoc)?
* Is it about extracting the Docbook content from what
June, 2015 9:10:28 AM
Subject: Re: Possible Documentation and help solutions - DITA
Sharan-F wrote
I'm a bit unclear about what you are suggesting.
* Is it about replacing the Docbook implementation we currently have
within OFBiz with something else (e.g Asciidoc)?
* Is it about extracting
Hi Taher
Thanks for the response.
I think that working through your action list would be a really good move so
am happy to work on it.
I think we'll need to take this discussion off the mailing list as it is
because we will need to share files (such as the ones that dont work etc) so
I will
-
From: Sharan-F sharan.f...@gmail.com
To: dev@ofbiz.apache.org
Sent: Thursday, 4 June, 2015 11:01:58 AM
Subject: Re: Possible Documentation and help solutions - DITA
Hi Taher
It would be good to understand what exactly is missing from our Docbook
implementation. It might be that we
Hi Taher
It would be good to understand what exactly is missing from our Docbook
implementation. It might be that we have set the tags at a specific level
(e.g section etc) which means that we cant use chapters etc.
I'm still thinking but the main thing that concerns me is this.
There is a
I am willing to work on a DITA PoC.
Ron
On 04/06/2015 4:01 AM, Sharan-F wrote:
Hi Taher
It would be good to understand what exactly is missing from our Docbook
implementation. It might be that we have set the tags at a specific level
(e.g section etc) which means that we cant use chapters
There are free tools - Eclipse/STS if you do not already have an IDE.
The publishing tool DITA-OT is open source.
There are tools that can be purchased.
I have not purchased anything.
On 03/06/2015 4:47 AM, Paul Foxworthy wrote:
Hi Ron,
For serious use of DITA, would it be necessary to
On 03/06/2015 5:09 AM, Sharan Foga wrote:
Hi Paul
I've got some other threads open on the user mailing lists about
documentation strategies because I wanted to get some feedback from
the user community and I'm a bit unclear about what you are suggesting.
* Is it about replacing the Docbook
Hi Ron,
For serious use of DITA, would it be necessary to invest in specialist
tools? That would be a real barrier for an open source project.
I've have had good results in another project using AsciiDoc, which is a
wiki-like markup language. Unlike Markdown and all those others, it's not
Alkhateeb
- Original Message -
From: Paul Foxworthy p...@cohsoft.com.au
To: dev@ofbiz.apache.org, rwhee...@artifact-software.com
Sent: Wednesday, 3 June, 2015 11:47:52 AM
Subject: Re: Possible Documentation and help solutions - DITA
Hi Ron,
For serious use of DITA, would it be necessary
: Wednesday, 3 June, 2015 11:47:52 AM
Subject: Re: Possible Documentation and help solutions - DITA
Hi Ron,
For serious use of DITA, would it be necessary to invest in specialist
tools? That would be a real barrier for an open source project.
I've have had good results in another project using
Hi Paul
I've got some other threads open on the user mailing lists about
documentation strategies because I wanted to get some feedback from the
user community and I'm a bit unclear about what you are suggesting.
* Is it about replacing the Docbook implementation we currently have
within
and improve what we are doing now).
My 2 cents
Taher Alkhateeb
- Original Message -
From: Paul Foxworthy p...@cohsoft.com.au
To: dev@ofbiz.apache.org, rwhee...@artifact-software.com
Sent: Wednesday, 3 June, 2015 11:47:52 AM
Subject: Re: Possible Documentation and help solutions - DITA
Hi Ron
would it change and improve what we are doing now).
My 2 cents
Taher Alkhateeb
- Original Message -
From: Paul Foxworthy p...@cohsoft.com.au
To: dev@ofbiz.apache.org, rwhee...@artifact-software.com
Sent: Wednesday, 3 June, 2015 11:47:52 AM
Subject: Re: Possible Documentation and help
- Original Message -
From: Paul Foxworthy p...@cohsoft.com.au
To: dev@ofbiz.apache.org, rwhee...@artifact-software.com
Sent: Wednesday, 3 June, 2015 11:47:52 AM
Subject: Re: Possible Documentation and help solutions - DITA
Hi Ron,
For serious use of DITA, would it be necessary to invest
Message -
From: Sharan-F sharan.f...@gmail.com
To: dev@ofbiz.apache.org
Sent: Wednesday, 3 June, 2015 3:32:02 PM
Subject: Re: Possible Documentation and help solutions - DITA
Hi Taher
I've just had a go with the validating the HR Guide file. When I ran the
validation the only message I
:39:44 PM
Subject: Re: Possible Documentation and help solutions - DITA
Hi Taher
That's a good point - no I didn't do that. I don't know how to do it -
do you have any instructions so I can try it?
Thanks
Sharan
On 03/06/15 12:20, Taher Alkhateeb wrote:
Hi Sharan,
Interesting, did
Hi Taher
I've just had a go with the validating the HR Guide file. When I ran the
validation the only message I got was that it stripped the namespace before
processing.
The output file was fine (I didnt include the path to the images so they are
coming out as blank frames) but everything else
29 matches
Mail list logo