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
