Qrux wrote: > On Jun 2, 2012, at 9:22 PM, Bruce Dubbs wrote: > >> This is mostly for Matt, but others may take note. >> >> I was adding new pages to LFS and had a hard time getting pkg-config to >> be recognized by jhalfs. What I found out was that the xml code: >> >> <?dbhtml filename="pkg-config.html"?> >> >> and the file name >> >> pkg-config-0.26-internal-glib.tar.gz >> >> are related. > > Other than history, is there a reason that LFS has to be XML first, > then parsed into scripts by automated systems? > > How about inverting it? We could have LFS scripts, and when it's > time to render the book, simply add some steps to that process to > "inject" the contents of those scripts? > > The scripts don't have to be "working scripts", per se, but simply the > snippets in the book. > > Point being, automated systems could take these scripts (perhaps with > comment-based annotations) and wrap whatever else they needed to > around them (e.g., package systems). > > Surely, this would kill many birds with one stone; i.e., it would be > possible to have release faster (since the root work-product is code), > and if the book is rendered from the scripts, it would allow better > testing by automated systems. > > And, since the book remains a work-product, (regardless of it being > rendered partly from scripts--which would be transparent to the > reader), it would still give folks the flexibility to roll their own > customizations. > > This also has the benefit, then, of being treatable as a more regular > software project; i.e., the code can be released as soon as it's been > tested (which would be easier to verify if multiple automated systems > could demonstrate that a particular snapshot/release-candidate built > properly). Then, the book can follow. > > This seems like a way for a broader technical audience to contribute > to the project in technical ways, without getting caught up in the > strangeness that is editing the book; i.e., there must be more people > who are Unix/Linux hackers than there are people who are versed in > editing DocBook XML and also happen to be hackers.
That sounds like a great idea. Why don't you prototype it so we can see how it works and we can compare the output to the current book. -- Bruce -- http://linuxfromscratch.org/mailman/listinfo/lfs-dev FAQ: http://www.linuxfromscratch.org/faq/ Unsubscribe: See the above information page
