Am Freitag, 4. Mai 2018, 15:41:05 CEST schrieb Moritz Mœller (The Ritz): > On May 3, 2018 11:24:52 PM Andreas Schneider <a...@cryptomilk.org> wrote: > > On Thursday, 3 May 2018 21:09:59 CEST KOVÁCS István wrote: > 'Something more lightweight?' > > restructedtext, which is what a lot of projects use to write documentation > e.g. using sphinx or pandoc. > > +1. Use Spinx (which is based on ReST). > You can publish automatically on readthedocs from github.
Can that also be turned into HTML matching the website [0]? We have some XSLT for that [1], and keeping the look of the website is essential. > This step, if taken though, S > suggests separating the docs from the code, repo wise. We will do that eventually anyway. > .mm Tobias > P.S.: I would be available to help with conversion to Spinx/ReST, if that > ever happens. sweet :-) [0] https://www.darktable.org/usermanual/en/ [1] https://github.com/darktable-org/darktable/blob/master/doc/usermanual/xsl/ darktable_html_dtorg.xsl
signature.asc
Description: This is a digitally signed message part.