techtonik Fri Nov 5 15:14:25 2004 EDT
Modified files:
/phpdoc/htmlhelp README.txt
Log:
DocBook XSL stylesheets updated to version 1.66.1
XSL customizing layer rewritten
xCHM building process is alive again
http://cvs.php.net/diff.php/phpdoc/htmlhelp/README.txt?r1=1.8&r2=1.9&ty=u
Index: phpdoc/htmlhelp/README.txt
diff -u phpdoc/htmlhelp/README.txt:1.8 phpdoc/htmlhelp/README.txt:1.9
--- phpdoc/htmlhelp/README.txt:1.8 Mon Sep 6 16:34:43 2004
+++ phpdoc/htmlhelp/README.txt Fri Nov 5 15:14:20 2004
@@ -16,24 +16,8 @@
How to build a CHM manual with this system?
- 0. Ensure that you have the latest phpdoc checkout,
- but that your XSL folder is dated 2002.12.31 23:00:00,
- since if you use XSL sheets from after this timestamp,
- the customizations will not work. Use the cvs date tag
- to get this version:
-
- From the phpdoc root directory:
- cvs update -dP -D"December 31, 2002 11:00pm" xsl
-
- # ensure the version information is up-to-date and that
- # html doctypes are included
- cvs up -A xsl/version.xml xsl/docbook/html/chunker.xsl
-
- {Volunteer to fix the customizations if you are willing
- to, but otherwise you cannot do much more but use the old
- sheets}
-
- Ensure however that the xsl/version.xml file is up to date,
+ 0. Ensure that you have the latest phpdoc checkout and the
+ version information in xsl/version.xml is up-to-date,
so you will build the latest function version information
into the CHM.
@@ -45,24 +29,8 @@
"--with-xsltproc=path" option to explicitly
provide the XSLTProc path.
- 3. Replace @DOCBOOKXSL_HTML@ with ./docbook/html/chunk.xsl in
- xsl/htmlhelp-db.xsl (do this after any configure runs). This
- is needed, since the new XSL sheets require no configuration,
- and since you are using old sheets, you need to do configuration
- yourself.
-
- 4. Add
-
- <xsl:template match="collabname" mode="titlepage.mode">
- <xsl:apply-templates />
- </xsl:template>
-
- <xsl:param name="chunker.output.doctype-system"
select="'http://www.w3.org/TR/html4/loose.dtd'"/>
- <xsl:param name="chunker.output.doctype-public" select="'-//W3C//DTD HTML 4.01
Transitional//EN'"/>
-
- to xsl/html-common.xsl.
- 5. Run "make chm_xsl"
+ 3. Run "make chm_xsl"
If xsltproc encounters errors in the XML files,
correct the errors, commit them to phpdoc, and
@@ -72,22 +40,22 @@
After this step the HTML files to start are in
phpdoc/htmlhelp/html
- 6. Get the actual mirrors.inc file from
+ 4. Get the actual mirrors.inc file from
http://ANY_MIRROR.php.net/include/mirrors.inc
and save into the directory where the
make_chm.bat resides (overwrite old one if
one exists).
- 7. Get all the user notes from
+ 5. Get all the user notes from
http://ANY_MIRROR.php.net/backend/notes/all.bz2,
extract its contents (using bunzip2 all.bz2, for example),
and place the resulting "all" file to the same folder where
the make_chm.bat resides.
- 8. Copy local_vars.php.src to local_vars.php and
+ 6. Copy local_vars.php.src to local_vars.php and
adjust settings as needed.
- 9. Now run make_chm.bat
+ 7. Now run make_chm.bat
Well, this is quite manual right now, and there are
some problems need fixing (see the TODO.txt file too).
