Hi Nicolas, Definitively yes !
I was trying a similar approach with Jelly/markdown, but due to several issues and lack of time i stopped there. I'm fine with asciidoc. Could you tell us how you imagine the next steps ? Will xooki only be used to produced toc ? What will be the flow to edit documentation pages ? 2014-12-29 23:21 GMT+01:00 Nicolas Lalevée <nicolas.lale...@hibnet.org>: > Hi, > > I like xooki because it manages well the templating of the web pages, and > it manage well how to build a toc. I hate when documentation is not « > browsable », like in a wiki, and xooki handle it well. > > But is is quite slow, generating Ivy’s documentation can takes minutes. > And on macos jrunscript is considered as a graphical app, so it get the > focus. Launching it repeatedly makes the Mac unusable because every few > second there is a new jrunscript app getting the focus. > And the only web browser in which you can do inline editing is Firefox. It > is a good web browser but unfortunately it is not my default one. > > Manually rewriting the entire doc in another template engine is out the > question. And I don’t want to lose the automatic build of the toc. > > So, as a defi, I wondered if I could make xooki.js generate something in a > template language rather than .html, and still generate that toc. > > I don’t know much any template language, even Markdown. On paper, asciidoc > looks better to me, and some Linus recommends it, so let’s try it so I can > have a little experience with it. > > A few hours of hacking later, doing dirty code in js, using Asciidoctor, > coming down to write some Ruby (oh my!), I have something working. Hence my > last commit in a dedicated branch in Ivy: xooki2asciidoc > > You can test it. To generate the asciidoc files: > ant -f build-doc.xml generate-asciidoc > To generate the html files from the asciidoc files (in few seconds!): > ant -f build-doc.xml generate-doc > And open build/doc/index.html to see the result > > This is a proof of concept, the conversion of the html tags barely works, > but the toc is functional. > > So what do you think ? Would you consider changing of template language ? > If so would it be asciidoc ? > > Is there any objection ? I spent some time on it for fun (and passing time > because of some quite late trains), I won’t mind if this is thrown away; > but I would like to know if there are some so I won’t continue it. > > Nicolas > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: dev-unsubscr...@ant.apache.org > For additional commands, e-mail: dev-h...@ant.apache.org > > -- Jean Louis Boudart Independent consultant Apache EasyAnt commiter http://ant.apache.org/easyant/
