Alan Feuerbacher wrote:
I gather that you LFS folks write the LFS and BLFS books directly in
XML. Am I right?
Yes. Actually Docbook.
http://www.docbook.org/tdg51/en/html/docbook.html
The real key is in the custom stylesheets which took some magic
incantations to write. We don't change them very often.
In any case, I'm wondering how you go about writing the documentation.
Like about any author. Decide what to write and revise.
Installing BLFS got me curious about a lot of things I knew nothing
about before, including XML. So I've been reading a lot of material new
to me to try to understand the mechanics of how you guys maintain the
books. I've looked over several BLFS book pages in XML, and there's
obviously a lot of work that goes into writing and maintaining these
books. And a lot of automation, which I'm also curious about.
The automation is mostly in the Makefile which is also hand written. We
also have several bash (and a few php) scripts we wrote to support the
different things that we find are needed. Generally the scripts don't
change much and are not terribly long.
-- Bruce
--
http://lists.linuxfromscratch.org/listinfo/blfs-support
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page
