I strongly dislike the idea of moving the book to Markdown. Mostly because I myself use the XML source for various tasks, amongst others generate Makefiles with an XSLT, and I know jhalfs does the same.
Secondly, I don’t see what anybody would win on this conversion, apart from a human readable source. The main contributors of the book as far as I’m concerned hasn’t expressed a dissatisfaction with the current structure of the book, at least not enough to motivate a complete overhaul of the entire structure of the book. PS. If you really want the book in Markdown you could just render it with XSLT from the booksource. On Mon, Nov 3, 2014 at 11:41 PM, Tim Tassonis <[email protected]> wrote: > On 11/03/2014 06:58 PM, Richard Melville wrote: > > > > > > On 3 November 2014 17:51, Bruce Dubbs <[email protected] > > <mailto:[email protected]>> wrote: > > Kevin Lyda wrote: > > On Sun, Nov 2, 2014 at 10:45 PM, Armin K. <[email protected] > > <mailto:[email protected]>> wrote: > > For instance I'd be interested in switching the book over to > > markdown > > from docbook which I think would make it more accessible. > > We have 15 years of experience tweaking Docbook based files to do > > several tasks. We do a lot more maintenance work behind the scenes > > with the XML files than just render HTML. > > > > Since I've never heard of markdown, I don't see how it would make it > > more accessible. > > > > > > It's a ruby package. > > No, it's not a ruby package, markdown is just a definition of converting > plain-text files to html, honouring a few formatting hints for titles, > lists, bold/italic and other stuff. Implementations for perl, php and > apparently ruby are available. It's great to put documentation written > as plaintext on a website, as the source is a regular, readable textfile > and when converted to html, it looks a bit nicer. It would be > well-suited as a guide to write hints, but I doubt it's a good idea for > the book. As soon as you start to do funky stuff, it's not so readable > anymore in plain, so the whole idea of it is gone. > > > Kind regards > Tim > > > -- > http://lists.linuxfromscratch.org/listinfo/lfs-dev > FAQ: http://www.linuxfromscratch.org/faq/ > Unsubscribe: See the above information page >
-- http://lists.linuxfromscratch.org/listinfo/lfs-dev FAQ: http://www.linuxfromscratch.org/faq/ Unsubscribe: See the above information page
