On Sat, 2006-11-04 at 13:05, KP Kirchdoerfer wrote:
> Am Freitag, 3. November 2006 15:54 schrieb Mike Noyes:
> > Here is a typical subset of output from a cron run of doc-build.sh. Note
> > all the ID recommended lines.
> >
> > ID recommended on section: What is the LEAF "Bering" distribution ?
> > ID recommended on section: Why Bering ?
> > Writing bk01ch01s02.html for section
> > ID recommended on section: Feedback
>
> [deleted a very long list of similar entries]
>
> Mike,
>
> is adding an ID to every section _required_ or recommended when writing new
> chapters?
KP,
Recommended. Norman Walsh changed this in the DocBook XSL release a
while back.
Now that the chunking level is set to chapter, only chapters their
parents should have IDs.
Note: doc-build.sh output will still generate recommendations
for sections, but they won't affect us.
> I remember we did have a usable documentation some time ago without giving
> every section an ID.
We had the generic auto-generated docbook filenames for most chapters.
The ones with ID attributes use(d) use.id.as.filename.
Example: http://leaf-project.org/doc/buc-install.html
--
Mike Noyes <mhnoyes at users.sourceforge.net>
http://sourceforge.net/users/mhnoyes/
SF.net Projects: leaf, phpwebsite, phpwebsite-comm, sitedocs
-------------------------------------------------------------------------
Using Tomcat but need to do more? Need to support web services, security?
Get stuff done quickly with pre-integrated technology to make your job easier
Download IBM WebSphere Application Server v.1.0.1 based on Apache Geronimo
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642
_______________________________________________
leaf-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/leaf-devel
