Le 30 mai 08 à 13:22, Aditya Mahajan a écrit :

On Fri, 30 May 2008, Gour wrote:

...

Some of the more popular markup-formats are AsciiDoc (http://www.methods.co.nz/asciidoc/index.html) and reStructuredText (http://docutils.sourceforge.net/rst.html), but according to what I see both are missing ConTeXt back-end (latex only) :-(

Any suggestion for 'popular' markup with ConTexT back-end?

Have a look at pandoc which converts markdown to ConTeXt and also to many other formats including html. There was also some discussion for conversion to OO, but I do not know the current status of that.

http://johnmacfarlane.net/pandoc/

Just some remarks/questions: - docbook seems to be the standard for describing documentation data, - dblatex seams to be a currently good supported tools for **easely** provide pdf output from docbook input, and cutomize the output with .xsl parameters or LaTeX .sty files - dbcontext seams not to be maintained very much - ConTeXt seams to be able to directly parse xml without external tools So, what about make ConTeXt directly reading dokbook file and output pdf file? I see the http://www.leverkruid.eu/context/index.html page from Simon Pepping. But it seems that this project is down. If ConTeXt provide an easy way for translate docbook to pdf file (usable by a non (ie. not yet) ConTeXt user as dblatex is), I think poeple could switch to ConTeXt only for that feature (not everybody have dependency with LaTeX!) Then the problem would resume to find a good "yourPreferedWikiFormat" to docbook... (I'v not seen any "t-bocbook" file on http://dl.contextgarden.net/modules) -- Maurice

Le 3 juin 08 à 09:43, Wolfgang Schuster a écrit :

On Tue, Jun 3, 2008 at 8:48 AM, Maurice Diamantini wrote:

...

Just some remarks/questions: - docbook seems to be the standard for describing documentation data, - dblatex seams to be a currently good supported tools for **easely** provide pdf output from docbook input, and cutomize the output with .xsl parameters or LaTeX .sty files - dbcontext seams not to be maintained very much

I don't think the code in the module is nowadays a good example for writing a module because many low level commands are redefined and it should work now out of the box with the current code or better witth MkIV.

...

- ConTeXt seams to be able to directly parse xml without external tools

So, what about make ConTeXt directly reading dokbook file and output pdf file? I see the http://www.leverkruid.eu/context/index.html page from Simon Pepping. But it seems that this project is down.

The module you mention above is the only (complete?) docbook style but ConTeXt provides cals table support by default and mapping for the basic elements to ConTeXt shouldn't be a problem, give us the information what do you need and we write a module.

Thank you very much, you confirm that the "DocbookInContext" from Simon Pepping is still the way to go. I've no specific request, I just forward some interest by the web community to converting from docbook to pdf more or less automaticaly. I fact, my original interest come from the work of the jelix team (a MVC php Framwork) whose documentation was only online (dokuwiki). Following some user feedback, Jelix team have then generate docbook from that wiki filesss+ and make pdf file thanks to the (not maintained) db2latex tool. I look after a more uptodate tool (for further customisation) and found dblatex as mention on the (french) forum: http://jelix.org/forums/read.php?10,2680,page=4#msg-2872 The result was that the simple command: dblatex jelix-manual.xml produce a "correct" (i.e. readable) jelix-manual.pdf file without any customisation (with default table of content, correct verbatim, ...) which was not the case for db2latex. But then, any customisation will be a latex style, which is more hacking than ConTeXt (I think so, but I'm sure you agree ;-) Nevertheless, the first criterion was that it just works in simple case. If some magic command (or a simple tutorial) like : texexec --docbook jelix-manual.xml do some equivalent work than the above dblatex, no doubt that the ConTeXt community will increase by more than 100%! Cordialement, -- Maurice

On Tue, Jun 3, 2008 at 3:00 PM, Maurice Diamantini wrote:

Le 3 juin 08 à 09:43, Wolfgang Schuster a écrit :

...

On Tue, Jun 3, 2008 at 8:48 AM, Maurice Diamantini wrote:

...

Just some remarks/questions: - docbook seems to be the standard for describing documentation data, - dblatex seams to be a currently good supported tools for **easely** provide pdf output from docbook input, and cutomize the output with .xsl parameters or LaTeX .sty files - dbcontext seams not to be maintained very much

I don't think the code in the module is nowadays a good example for writing a module because many low level commands are redefined and it should work now out of the box with the current code or better witth MkIV.

...

- ConTeXt seams to be able to directly parse xml without external tools

So, what about make ConTeXt directly reading dokbook file and output pdf file? I see the http://www.leverkruid.eu/context/index.html page from Simon Pepping. But it seems that this project is down.

The module you mention above is the only (complete?) docbook style but ConTeXt provides cals table support by default and mapping for the basic elements to ConTeXt shouldn't be a problem, give us the information what do you need and we write a module.

Thank you very much, you confirm that the "DocbookInContext" from Simon Pepping is still the way to go.

No, I meant we should better start from scratch, as Hans told the code is bad style and you should avoid to redefine core or low level macros.

I've no specific request, I just forward some interest by the web community to converting from docbook to pdf more or less automaticaly. I fact, my original interest come from the work of the jelix team (a MVC php Framwork) whose documentation was only online (dokuwiki). Following some user feedback, Jelix team have then generate docbook from that wiki filesss+ and make pdf file thanks to the (not maintained) db2latex tool. I look after a more uptodate tool (for further customisation) and found dblatex as mention on the (french) forum:

http://jelix.org/forums/read.php?10,2680,page=4#msg-2872

Looks like spain to me ;-)

The result was that the simple command:

dblatex jelix-manual.xml

produce a "correct" (i.e. readable) jelix-manual.pdf file without any customisation (with default table of content, correct verbatim, ...) which was not the case for db2latex. But then, any customisation will be a latex style, which is more hacking than ConTeXt (I think so, but I'm sure you agree ;-)

One of the easiest things with ConTeXt, you could change the header style with \setupheader[...][..,..=..,..], you need only a extra file with all your settings.

Nevertheless, the first criterion was that it just works in simple case. If some magic command (or a simple tutorial) like :

texexec --docbook jelix-manual.xml

better texexec --ctx=docbook jelix-manual.xml

do some equivalent work than the above dblatex, no doubt that the ConTeXt community will increase by more than 100%!

Cordialement, -- Maurice

Wolfgang

...

...

...

...

"Maurice" == Maurice Diamantini writes:

Maurice> About docbook: -------------- Maurice> But one current need is about docbook, because file already Maurice> exists as a "dokuwiki hacked" generated file (by a php expert Maurice> from jelix team) ! So other wiki format is not an option? Maurice> docbook is request Export Docbook to html and then import (e.g. with pandoc) into e.g. markdown ;) Maurice> But Gour said alsewhere:

...

...it doesn’t handle tables,...

pandoc's extended markdown handles tables. Which ghc? Sincerely, Gour -- Gour | Zagreb, Croatia | GPG key: C6E7162D ----------------------------------------------------------------

...

...

...

...

"Maurice" == Maurice Diamantini writes:

Maurice> Le 4 juin 08 à 15:34, Gour a écrit : Hello! Maurice> port info ghc => ghc 6.8.2, Revision 3, lang/ghc (Variants: Maurice> universal, darwin_6, darwin_7, darwin_8_powerpc, darwin_8_i386, Maurice> darwin_9_powerpc, darwin_9_i386, no_opengl) http://haskell.org/ Here is the reply from pandoc main developer: "This problem was introduced when MacPorts updated to the most recent version of the haddock documentation tool. I submitted a patch to MacPorts a long time ago, but nobody has committed it to the repository. (The committer who looked at the patch has had trouble building GHC 6.8.2 on his Mac, so he can't test the pandoc patch.) There's a description of a workaround here: http://groups.google.com/group/pandoc-discuss/browse_thread/thread/c9ecef594..." Sincerely, Gour -- Gour | Zagreb, Croatia | GPG key: C6E7162D ----------------------------------------------------------------

(other message not related to ConTeXt could now be send off-list please) true. My problems is "What is out of topic in this mailing list ? " :)

-- luigi

On Fri, Jun 6, 2008 at 7:57 AM, Maurice Diamantini wrote:

Le 5 juin 08 à 09:15, luigi scarso a écrit :

...

...

(other message not related to ConTeXt could now be send off-list please)

true. My problems is: "What is out of topic in this mailing list ? " :)

Because the problem was about installing GHC (an Haskell compiler) on osX with macports tool. Haskel language is requested as a dependancy for Pandoc. no no, there was a misunderstand. What I mean is : it' very hard to define that a subject if off topic in this mailing list. For example, I don't consider this an out-of-topic subject.

-- luigi

...

...

...

...

"Maurice" == Maurice Diamantini writes:

Maurice> Just some remarks/questions: - docbook seems to be the standard Maurice> for describing documentation data, - dblatex seams to be a Maurice> currently good supported tools for **easely** provide pdf Maurice> output from docbook input, and cutomize the output with .xsl Maurice> parameters or LaTeX .sty files - dbcontext seams not to be Maurice> maintained very much - ConTeXt seams to be able to directly Maurice> parse xml without external tools Heh, for me (and I'm not alone), docbook is an overkill for many documentation tasks - way too big :-/ Maurice> If ConTeXt provide an easy way for translate docbook to pdf Maurice> file (usable by a non (ie. not yet) ConTeXt user as dblatex Maurice> is), I think poeple could switch to ConTeXt only for that Maurice> feature (not everybody have dependency with LaTeX!) Then the Maurice> problem would resume to find a good "yourPreferedWikiFormat" to Maurice> docbook... (I'v not seen any "t-bocbook" file on Maurice> http://dl.contextgarden.net/modules) Take a look at http://johnmacfarlane.net/pandoc/ - it uses 'extended' markdown syntax and can export to ConTeXt. If pandoc would not be enough for our documentation needs, I'd probably look at reST or Asciidoc which do Docbook, but no ConTeXt back-end :-( Sincerely, Gour -- Gour | Zagreb, Croatia | GPG key: C6E7162D ----------------------------------------------------------------