I can take a try, but probably next week. I'm using currently Asciddoctor in another project.
On 27.01.2015 10:34, Gert Vanthienen wrote: > Hi JB, > > Yeah, I know - had a look at that and it looks great too! Both > solutions look like excellent alternatives to me. We still need > someone to do the actual migration for ServiceMix though, don't we? > > Regards, > > Gert Vanthienen > > > On Tue, Jan 27, 2015 at 10:24 AM, Jean-Baptiste Onofré <[email protected]> > wrote: >> Hi Gert, >> >> Achim already pushed on Karaf the "migration" to AsciiDoc. >> >> Regards >> JB >> >> >> On 01/27/2015 10:22 AM, Gert Vanthienen wrote: >>> L.S., >>> >>> >>> Between Wim's original Sphinx proposal and AsciiDoc, it seems like the >>> latter has more votes for it. So, next step: anyone up for taking a >>> stab at transforming the current Scalate docs into AsciiDoc? Perhaps >>> in a set of branches next to our current docs branches? >>> >>> >>> Regards, >>> >>> Gert Vanthienen >>> >>> >>> On Sat, Jan 24, 2015 at 12:49 AM, Wim Verreydt <[email protected]> wrote: >>>> Hi, >>>> >>>> A while ago I figured that the ServiceMix documentation could use an >>>> upgrade. Instead of fixing everything I took the chance to experiment with >>>> some suitable frameworks like Middleman, Jekyll and Sphinx. >>>> >>>> The first two did not really made thing easier but Sphinx >>>> (http://sphinx-doc.org/) seems like a big improvement. It is beïng used in >>>> a >>>> lot of non-python projects these days so it should lower the learning curve >>>> an effort to contribute documentation. >>>> >>>> I started out with the well known theme provided by readthedocs.org >>>> (https://github.com/snide/sphinx_rtd_theme) and added some custom >>>> functionality like an terminal window in CSS that should replace the >>>> screenshots in our current documentation. >>>> >>>> Just to test I ported the first two guides of the ServiceMix >>>> documentation. >>>> You can find the project at https://github.com/wimve/smx-doc-sphinx and a >>>> html build at >>>> https://dl.dropboxusercontent.com/u/1528761/smx-doc-sphinx/index.html >>>> >>>> Let me know what you think! If this is considered to be an improvement >>>> I'll continue to port the rest of our guides. >>>> >>>> Regards, >>>> >>>> Wim Verreydt >> >> -- >> Jean-Baptiste Onofré >> [email protected] >> http://blog.nanthrax.net >> Talend - http://www.talend.com -- Krzysztof Sobkowiak JEE & OSS Architect | Senior Solution Architect @ Capgemini | Committer @ ASF Capgemini <http://www.pl.capgemini.com/> | Software Solutions Center <http://www.pl.capgemini-sdm.com/> | Wroclaw e-mail: [email protected] <mailto:[email protected]> | Twitter: @KSobkowiak Calendar: http://goo.gl/yvsebC
