Re: cvs commit: xml-fop/src/documentation/content/xdocs/dev book.xml
On Mon, Nov 08, 2004 at 01:43:51PM -0800, Clay Leeds wrote: I suspect this could be a problem for the Forrest site-generation process[1]: Specifying menus with book.xml Historically, menus in Forrest have been generated from a book.xml file, one per directory. This mechanism is still available, and if a book.xml is found, it will be used in preference to the menu generated by the site.xml file. The book.xml files can use site: URIs to ease the maintenance burden that led to obsolescence of book.xml files. In general, however, we recommend that users avoid book.xml files. Is it possible for you to rename that file so it doesn't conflict? (I'm hoping it is trivial for you to change that file name. Perhaps fop-=dni-book.xml or something). If not, I'll see if I can come up with some other solution, although my guess is that any workaround will preclude it from having the same look feel as the rest of the FOP web site. A shame; I thought book.xml was the right name for this file. Renamed to DnI.xml. Simon -- Simon Pepping home page: http://www.leverkruid.nl
Re: cvs commit: xml-fop/src/documentation/content/xdocs/dev book.xml
On Nov 9, 2004, at 11:58 AM, Simon Pepping wrote: On Mon, Nov 08, 2004 at 01:43:51PM -0800, Clay Leeds wrote: I suspect this could be a problem for the Forrest site-generation process[1]: Specifying menus with book.xml Historically, menus in Forrest have been generated from a book.xml file, one per directory. This mechanism is still available, and if a book.xml is found, it will be used in preference to the menu generated by the site.xml file. The book.xml files can use site: URIs to ease the maintenance burden that led to obsolescence of book.xml files. In general, however, we recommend that users avoid book.xml files. Is it possible for you to rename that file so it doesn't conflict? (I'm hoping it is trivial for you to change that file name. Perhaps fop-=dni-book.xml or something). If not, I'll see if I can come up with some other solution, although my guess is that any workaround will preclude it from having the same look feel as the rest of the FOP web site. A shame; I thought book.xml was the right name for this file. Renamed to DnI.xml. Simon Perhaps it is the correct name for the file. IMHO, perhaps forrest should pre-pend for_ in front of filenames (e.g., for_book.xml, for_site.xml, for_tabs.xml, etc.) like this to prevent this types of problems. Forrest already was having problems where they were using 'site.xml' and outputting site.html and 'site.pdf' (they changed the latter two to wholesite.html and wholesite.pdf...). Anyway, thanks for making the change. It means that the DnI stuff can be skinned (as I mentioned previously, the book.xml in there made forrest think that it had it's own 'book.xml' file for that directory, so it wouldn't use site.xml file (which defines the site navigation structure). Web Maestro Clay -- Clay Leeds - [EMAIL PROTECTED] Webmaster/Developer - Medata, Inc. - http://www.medata.com/ PGP Public Key: https://mail.medata.com/pgp/cleeds.asc
Re: cvs commit: xml-fop/src/documentation/content/xdocs/dev book.xml
Clay, On Sun, Nov 07, 2004 at 08:48:23PM -0800, Clay Leeds wrote: Simon, Does the book.xml file in your DnI section serve any specific purpose (DnI-related), or is it to follow the common coding/forrest convention? I ask, because the use of book.xml is deprecated in Forrest-0.6 in favor of the site-wide src/documentation/content/xdocs/site.xml file. book.xml is the top-level file that calls in all the chapters. It is indispensible, it is _the_ book, so to speak. I compared it with the book files you have removed. I see that it has a different purpose. The other book files seem to define menus. Regards, Simon On Nov 7, 2004, at 8:26 PM, [EMAIL PROTECTED] wrote: clay2004/11/07 20:26:29 Removed: src/documentation/content/xdocs book.xml src/documentation/content/xdocs/design book.xml src/documentation/content/xdocs/design/alt.design book.xml src/documentation/content/xdocs/design/alt.design/properties book.xml src/documentation/content/xdocs/dev book.xml Log: removed all book.xml files (except DnI) Web Maestro Clay -- Clay Leeds - [EMAIL PROTECTED] Webmaster/Developer - Medata, Inc. - http://www.medata.com/ PGP Public Key: https://mail.medata.com/pgp/cleeds.asc -- Simon Pepping home page: http://www.leverkruid.nl
Re: cvs commit: xml-fop/src/documentation/content/xdocs/dev book.xml
On Nov 8, 2004, at 12:48 PM, Simon Pepping wrote: Clay, On Sun, Nov 07, 2004 at 08:48:23PM -0800, Clay Leeds wrote: Simon, Does the book.xml file in your DnI section serve any specific purpose (DnI-related), or is it to follow the common coding/forrest convention? I ask, because the use of book.xml is deprecated in Forrest-0.6 in favor of the site-wide src/documentation/content/xdocs/site.xml file. book.xml is the top-level file that calls in all the chapters. It is indispensible, it is _the_ book, so to speak. I compared it with the book files you have removed. I see that it has a different purpose. The other book files seem to define menus. Regards, Simon I suspect this could be a problem for the Forrest site-generation process[1]: Specifying menus with book.xml Historically, menus in Forrest have been generated from a book.xml file, one per directory. This mechanism is still available, and if a book.xml is found, it will be used in preference to the menu generated by the site.xml file. The book.xml files can use site: URIs to ease the maintenance burden that led to obsolescence of book.xml files. In general, however, we recommend that users avoid book.xml files. Is it possible for you to rename that file so it doesn't conflict? (I'm hoping it is trivial for you to change that file name. Perhaps fop-=dni-book.xml or something). If not, I'll see if I can come up with some other solution, although my guess is that any workaround will preclude it from having the same look feel as the rest of the FOP web site. [1] http://forrest.apache.org/docs/linking.html#book-menu-selection Web Maestro Clay -- Clay Leeds - [EMAIL PROTECTED] Webmaster/Developer - Medata, Inc. - http://www.medata.com/ PGP Public Key: https://mail.medata.com/pgp/cleeds.asc
Re: cvs commit: xml-fop/src/documentation/content/xdocs/dev book.xml
Simon, Does the book.xml file in your DnI section serve any specific purpose (DnI-related), or is it to follow the common coding/forrest convention? I ask, because the use of book.xml is deprecated in Forrest-0.6 in favor of the site-wide src/documentation/content/xdocs/site.xml file. On Nov 7, 2004, at 8:26 PM, [EMAIL PROTECTED] wrote: clay2004/11/07 20:26:29 Removed: src/documentation/content/xdocs book.xml src/documentation/content/xdocs/design book.xml src/documentation/content/xdocs/design/alt.design book.xml src/documentation/content/xdocs/design/alt.design/properties book.xml src/documentation/content/xdocs/dev book.xml Log: removed all book.xml files (except DnI) Web Maestro Clay -- Clay Leeds - [EMAIL PROTECTED] Webmaster/Developer - Medata, Inc. - http://www.medata.com/ PGP Public Key: https://mail.medata.com/pgp/cleeds.asc
cvs commit: xml-fop/src/documentation/content/xdocs/dev book.xml
jeremias2003/05/29 14:41:33 Modified:src/documentation/content/xdocs/dev book.xml Log: Remove link to examples Submitted by: Glen Mazza [EMAIL PROTECTED] Revision ChangesPath 1.26 +0 -1 xml-fop/src/documentation/content/xdocs/dev/book.xml Index: book.xml === RCS file: /home/cvs/xml-fop/src/documentation/content/xdocs/dev/book.xml,v retrieving revision 1.25 retrieving revision 1.26 diff -u -r1.25 -r1.26 --- book.xml 15 May 2003 16:44:52 - 1.25 +++ book.xml 29 May 2003 21:41:33 - 1.26 @@ -31,7 +31,6 @@ /menu menu label=Resources menu-item label=FAQs href=faq.html/ - menu-item label=Examples href=examples.html/ menu-item label=Tools href=tools.html/ external label=ViewCVS href=http://cvs.apache.org/viewcvs.cgi/xml-fop/ /menu - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: xml-fop/src/documentation/content/xdocs/dev book.xml
vmote 2003/04/06 21:22:59 Modified:src/documentation/content/xdocs/dev book.xml Log: Move testing.xml to dev area. Revision ChangesPath 1.13 +1 -0 xml-fop/src/documentation/content/xdocs/dev/book.xml Index: book.xml === RCS file: /home/cvs/xml-fop/src/documentation/content/xdocs/dev/book.xml,v retrieving revision 1.12 retrieving revision 1.13 diff -u -r1.12 -r1.13 --- book.xml 7 Apr 2003 00:55:01 - 1.12 +++ book.xml 7 Apr 2003 04:22:59 - 1.13 @@ -28,6 +28,7 @@ external label=FOP Wiki href=http://nagoya.apache.org/wiki/apachewiki.cgi?FOPProjectPages/ menu-item label=Design href=../design/index.html/ menu-item label=Tools href=tools.html/ + menu-item label=Testing href=testing.html/ external label=Patch queue href=http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=NEWamp;bug_status=ASSIGNEDamp;bug_status=REOPENEDamp;email1=amp;emailtype1=substringamp;emailassigned_to1=1amp;email2=amp;emailtype2=substringamp;emailreporter2=1amp;bugidtype=includeamp;bug_id=amp;changedin=amp;votes=amp;chfieldfrom=amp;chfieldto=Nowamp;chfieldvalue=amp;product=Fopamp;short_desc=%5BPATCH%5Damp;short_desc_type=allwordssubstramp;long_desc=amp;long_desc_type=allwordssubstramp;bug_file_loc=amp;bug_file_loc_type=allwordssubstramp;keywords=amp;keywords_type=anywordsamp;field0-0-0=noopamp;type0-0-0=noopamp;value0-0-0=amp;namedcmd=Fop+allamp;newqueryname=fop+patch+queueamp;tofooter=1amp;order=Reuse+same+sort+as+last+time/ /menu /book - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: xml-fop/src/documentation/content/xdocs/dev book.xml configuration.xml examples.xml extensions.xml faq.xml index.xml svg.xml
keiron 2002/11/18 23:57:29 Modified:src/documentation/content/xdocs book.xml bugs.xml compiling.xml compliance.xml configuration.xml download.xml embedding.xml examples.xml extensions.xml faq.xml fonts.xml gethelp.xml implemented.xml index.xml involved.xml license.xml limitations.xml news.xml output.xml relnotes.xml resources.xml running.xml status.xml svg.xml tabs.xml testing.xml src/documentation/content/xdocs/design architecture.xml areas.xml book.xml breakpos.xml embedding.xml extending.xml fotree.xml index.xml layout.xml optimise.xml properties.xml renderers.xml status.xml useragent.xml src/documentation/content/xdocs/dev book.xml configuration.xml examples.xml extensions.xml faq.xml index.xml svg.xml Log: The attached patch file contains: 1. Valid URIs for all xdoc DTD declarations. 2. Some minor changes for xdoc documents that were discovered to be invalid after the DTD declarations were fixed. 3. Changed tabs.xml so that the 2nd tab on our site will now read Redesign instead of dev (this was discussed in a recent thread). Submitted By: [EMAIL PROTECTED] (Victor Mote) Revision ChangesPath 1.7 +3 -1 xml-fop/src/documentation/content/xdocs/book.xml Index: book.xml === RCS file: /home/cvs/xml-fop/src/documentation/content/xdocs/book.xml,v retrieving revision 1.6 retrieving revision 1.7 diff -u -r1.6 -r1.7 --- book.xml 13 Nov 2002 12:21:28 - 1.6 +++ book.xml 19 Nov 2002 07:57:27 - 1.7 @@ -1,5 +1,7 @@ ?xml version=1.0 encoding=UTF-8? - !DOCTYPE book PUBLIC -//APACHE//DTD Cocoon Documentation Book V1.0//EN book-cocoon-v10.dtd + !DOCTYPE book PUBLIC -//APACHE//DTD Cocoon Documentation Book V1.0//EN + http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-cocoon2/src/documentation/xdocs/dtd/book-cocoon-v10.dtd; + book software=FOP title=FOP 1.3 +2 -1 xml-fop/src/documentation/content/xdocs/bugs.xml Index: bugs.xml === RCS file: /home/cvs/xml-fop/src/documentation/content/xdocs/bugs.xml,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- bugs.xml 18 Nov 2002 12:47:16 - 1.2 +++ bugs.xml 19 Nov 2002 07:57:27 - 1.3 @@ -1,5 +1,6 @@ ?xml version=1.0 standalone=no? -!DOCTYPE document PUBLIC -//APACHE//DTD Documentation V1.1//EN document-v11.dtd +!DOCTYPE document PUBLIC -//APACHE//DTD Documentation V1.1//EN + http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-forrest/src/resources/schema/dtd/document-v11.dtd; document header 1.2 +2 -1 xml-fop/src/documentation/content/xdocs/compiling.xml Index: compiling.xml === RCS file: /home/cvs/xml-fop/src/documentation/content/xdocs/compiling.xml,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- compiling.xml 4 Nov 2002 16:20:51 - 1.1 +++ compiling.xml 19 Nov 2002 07:57:27 - 1.2 @@ -1,5 +1,6 @@ ?xml version=1.0 standalone=no? -!DOCTYPE document PUBLIC -//APACHE//DTD Documentation V1.1//EN document-v11.dtd +!DOCTYPE document PUBLIC -//APACHE//DTD Documentation V1.1//EN + http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-forrest/src/resources/schema/dtd/document-v11.dtd; document header 1.2 +2 -1 xml-fop/src/documentation/content/xdocs/compliance.xml Index: compliance.xml === RCS file: /home/cvs/xml-fop/src/documentation/content/xdocs/compliance.xml,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- compliance.xml13 Nov 2002 12:21:30 - 1.1 +++ compliance.xml19 Nov 2002 07:57:27 - 1.2 @@ -1,5 +1,6 @@ ?xml version=1.0 encoding=UTF-8? -!--DOCTYPE compliance PUBLIC -//APACHE//DTD Compliance V1.0//EN compliance-v10.dtd-- +!DOCTYPE compliance PUBLIC -//APACHE//DTD Compliance V1.0//EN + http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-fop/src/documentation/resources/schema/dtd/compliance-v10.dtd?rev=1.1; compliance head 1.2 +2 -1 xml-fop/src/documentation/content/xdocs/configuration.xml Index: configuration.xml === RCS file: /home/cvs/xml-fop/src/documentation/content/xdocs/configuration.xml,v retrieving revision 1.1 retrieving
cvs commit: xml-fop/src/documentation/content/xdocs/dev book.xml extensions.xml
keiron 2002/11/07 00:15:01 Modified:src/documentation/content/xdocs book.xml src/documentation/content/xdocs/dev book.xml extensions.xml Added: src/documentation/content/xdocs/design architecture.xml areas.xml book.xml breakpos.xml embedding.xml extending.xml fotree.xml index.xml layout.xml optimise.xml properties.xml renderers.xml status.xml useragent.xml Log: converted design docs to forrest needs updating Revision ChangesPath 1.5 +11 -3 xml-fop/src/documentation/content/xdocs/book.xml Index: book.xml === RCS file: /home/cvs/xml-fop/src/documentation/content/xdocs/book.xml,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- book.xml 4 Nov 2002 16:20:51 - 1.4 +++ book.xml 7 Nov 2002 08:15:01 - 1.5 @@ -13,32 +13,40 @@ menu-item label=Download href=download.html/ menu-item label=Release Notes href=relnotes.html/ menu-item label=Getting Help href=gethelp.html/ + menu-item label=Examples href=examples.html/ +/menu +menu label=Project menu-item label=Status href=status.html/ menu-item label=Changes href=changes.html/ menu-item label=Todo href=todo.html/ +/menu +menu label=Using FOP menu-item label=Running href=running.html/ menu-item label=Embedding href=embedding.html/ menu-item label=Output Formats href=output.html/ menu-item label=Implemented href=implemented.html/ menu-item label=Limitations href=limitations.html/ +/menu +menu label=Extras menu-item label=SVG href=svg.html/ menu-item label=Extensions href=extensions.html/ menu-item label=Fonts href=fonts.html/ menu-item label=Configuration href=configuration.html/ +/menu +menu label=Developing menu-item label=Getting Involved href=involved.html/ menu-item label=Compiling href=compiling.html/ menu-item label=Testing href=testing.html/ +/menu +menu label=Resources menu-item label=Bugs href=bugs.html/ menu-item label=Resources href=resources.html/ menu-item label=License href=license.html/ - - menu-item label=Examples href=examples.html/ - external label=Patch queue href=http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=NEWamp;bug_status=ASSIGNEDamp;bug_status=REOPENEDamp;email1=amp;emailtype1=substringamp;emailassigned_to1=1amp;email2=amp;emailtype2=substringamp;emailreporter2=1amp;bugidtype=includeamp;bug_id=amp;changedin=amp;votes=amp;chfieldfrom=amp;chfieldto=Nowamp;chfieldvalue=amp;product=Fopamp;short_desc=%5BPATCH%5Damp;short_desc_type=allwordssubstramp;long_desc=amp;long_desc_type=allwordssubstramp;bug_file_loc=amp;bug_file_loc_type=allwordssubstramp;keywords=amp;keywords_type=anywordsamp;field0-0-0=noopamp;type0-0-0=noopamp;value0-0-0=amp;namedcmd=Fop+allamp;newqueryname=fop+patch+queueamp;tofooter=1amp;order=Reuse+same+sort+as+last+time/ /menu /book 1.1 xml-fop/src/documentation/content/xdocs/design/architecture.xml Index: architecture.xml === ?xml version=1.0 standalone=no? !DOCTYPE document PUBLIC -//APACHE//DTD Documentation V1.1//EN document-v11.dtd document header titleArchitecture/title subtitleArchitecture information for FOP/subtitle authors person name=Arved Sandstrom email=/ /authors /header body section titleFOP Mechanics/title section titleIntroduction/title p The overall process is controlled by emorg.apache.fop.apps.Driver/em. This class handles the FO Tree building, renderers, output and logging. /p p The process in general is that the FO document is sent to the tree builder via SAX events. This creates an FO Tree. The FO Tree is then handled by the layout processor which converts the FO Tree into an area tree. This area tree is then given to the renderer and the renderer converts the area tree into a stream of data containing the output document. /p /section section titleFormatting Object Tree/title p The class emorg.apache.fop.fo.FOTreeBuilder/em is responsible for actually constructing the FO tree. The key SAX events used are /p pcodestartElement()/code,/p pcodeendElement()/code and codecharacters()/code./p pAll formatting objects derive from abstract class emorg.apache.fop.fo.FONode/em. The other FO classes inherit from emFONode/em as follows:/p
