Recent Changes · Search:

Support the Project

Wikipublisher

PmWiki

edit SideBar

Wikipublisher.WikibookDTD History

Hide minor edits - Show changes to output

26 March 2009 at 02:39 PM by Craig - typo on word support third bullet point
Changed line 14 from:
!Division styles have limited suport! The wikibook dtd allows multiple block tags to be wrapped in a <group> tag, which is treated as a minipage. This area is under development. At the moment, groups are treated on a case-by-case basis. Significant additional work will be needed to create a mechanism for translating css properties to their typesetting equivalents. This will require a separate project, but only if there is sufficient demand.
to:
!Division styles have limited support! The wikibook dtd allows multiple block tags to be wrapped in a <group> tag, which is treated as a minipage. This area is under development. At the moment, groups are treated on a case-by-case basis. Significant additional work will be needed to create a mechanism for translating css properties to their typesetting equivalents. This will require a separate project, but only if there is sufficient demand.
15 February 2006 at 04:49 PM by John Rankin - WikiBook becomes Wikibook
Changed lines 16-17 from:
The wikibook dtd can be inspected at http://www.wikipublisher.org/dtd/wikibook.dtd, or browsed at WikiBook.HomePage.
to:
The wikibook dtd can be inspected at http://www.wikipublisher.org/dtd/wikibook.dtd, or browsed at Wikibook.HomePage.
12 February 2006 at 03:50 PM by dg - added link to DTD browser
Changed lines 16-17 from:
The wikibook dtd can be inspected at http://www.wikipublisher.org/dtd/wikibook.dtd.
to:
The wikibook dtd can be inspected at http://www.wikipublisher.org/dtd/wikibook.dtd, or browsed at WikiBook.HomePage.
28 September 2005 at 12:23 PM by John Rankin - expand explanation
Changed line 1 from:
The [[Wikipublisher]] library instructs PmWiki to generate xml output to a print-oriented {DTD|document type definition}. This appeared to be a more promising route than directly converting the xhtml for several reasons:
to:
The [[Wikipublisher]] library instructs PmWiki to generate xml output to a print-oriented {DTD|document type definition}. This appeared to be a more straightforward route than directly converting the xhtml for several reasons:
Changed lines 4-5 from:
* wiki markup is simple and nearly (but not totally) media-agnostic -- it primarily describes a page's content
to:
* wiki markup is simple and largely (but not totally) media-agnostic -- it primarily describes a page's content
Added lines 8-15:
The wikibook dtd describes the ''structure'' of the page's content, not its presentation. Presentation is left to the typesetting engine and is controlled, to a degree, through <meta> tags and their attributes. This approach generally works well, but it has some limitations, many arising from the physical differences between a scrolling colour screen and a fixed-size sheet of paper.

!Style information is partially supported! There are major differences between the css-based model used in xhtml (and implicit in PmWiki) and the structure-based approach used in the typesetting engine. Currently, there is no print equivalent to the rich style options found in xhtml. The approach taken is to translate those style options with recognisable equivalents (inline styles such as text colour blue), and ignore the rest (block styles such as place a red dotted border around this paragraph with a pale blue background).

!Much, but not all, tabular material is supported! True tables are supported well. Headings, captions, cell alignment and text wrap all map to their print equivalents. Where tables are used as a way to control the presentation of complex material, it currently works less well, especially with very long cells. It treats complex cells as "minipages" and keeps the content together on a page. As a result, if the cell contains more than a page of content, some will fall off the end of the page.

!Division styles have limited suport! The wikibook dtd allows multiple block tags to be wrapped in a <group> tag, which is treated as a minipage. This area is under development. At the moment, groups are treated on a case-by-case basis. Significant additional work will be needed to create a mechanism for translating css properties to their typesetting equivalents. This will require a separate project, but only if there is sufficient demand.
Deleted lines 17-27:
The dtd describes the ''structure'' of the page's content, not its presentation. This approach generally works well, but it has some limitations, many arising from the physical differences between a scrolling colour screen and a fixed-size sheet of paper:

* style information is partially supported::
There are major differences between the css-based model used in xhtml (and implicit in PmWiki) and the structure-based approach used in the typesetting engine. Currently, there is no print equivalent to the rich style options found in xhtml. The approach taken is to translate those style options with recognisable equivalents (inline styles such as text colour blue), and ignore the rest (block styles such as place a red dotted border around this paragraph with a pale blue background).

* much, but not all, tabular material is supported::
True tables are supported well. Headings, captions, cell alignment and text wrap all map to their print equivalents. Where tables are used as a way to control the presentation of complex material, it currently works less well, especially with very long cells. It treats complex cells as "minipages" and keeps the content together on a page. As a result, if the cell contains more than a page of content, some will fall off the end of the page.

* division styles have limited suport::
The wikibook dtd allows multiple block tags to be wrapped in a <group> tag, which is treated as a minipage. This area is under development. At the moment, groups are treated on a case-by-case basis.
27 September 2005 at 07:29 PM by John Rankin - tidy prose
Changed lines 4-5 from:
* wiki markup is largely (but not totally) media-agnostic -- it is primarily a simple way to describe content
to:
* wiki markup is simple and nearly (but not totally) media-agnostic -- it primarily describes a page's content
Changed lines 8-11 from:
The dtd can be inspected at http://www.wikipublisher.org/dtd/wikibook.dtd.

The wikibook dtd describes the ''structure'' of the page's content, not its presentation. This approach generally works well, but it has some limitations, many arising from the physical differences between a scrolling colour screen and a fixed-size sheet of paper:
to:
The wikibook dtd can be inspected at http://www.wikipublisher.org/dtd/wikibook.dtd.

The dtd describes the ''structure'' of the page's content, not its presentation. This approach generally works well, but it has some limitations, many arising from the physical differences between a scrolling colour screen and a fixed-size sheet of paper:
Changed line 15 from:
* some, but not all, tabular material is supported::
to:
* much, but not all, tabular material is supported::
Changed lines 18-20 from:
* divisional styling has limited suport::
The wikibook dtd allows multiple block tags to be wrapped in a <group> tag, which is treated as a minipage. This area is under development.
to:
* division styles have limited suport::
The wikibook dtd allows multiple block tags to be wrapped in a <group> tag, which is treated as a minipage. This area is under development. At the moment, groups are treated on a case-by-case basis.
27 September 2005 at 03:38 PM by John Rankin - define page
Added lines 1-21:
The [[Wikipublisher]] library instructs PmWiki to generate xml output to a print-oriented {DTD|document type definition}. This appeared to be a more promising route than directly converting the xhtml for several reasons:
* xhtml doesn't directly support common print features, such as footnotes and page cross-references
* xhtml includes a number of constructs which are web-specific, such as forms and tool tips
* wiki markup is largely (but not totally) media-agnostic -- it is primarily a simple way to describe content

Investigations led to the [[tbook dtd -> http://tbookdtd.sourceforge.net/]] project on Sourceforge. Mapping the tbook entities to wiki markup showed that most (but not all) wiki markups had tbook xml equivalents. The wikipublisher project extended the tbook dtd to support all core PmWiki markups plus a number of MarkupExtensions. To avoid confusion, the new dtd is called "wikibook".

The dtd can be inspected at http://www.wikipublisher.org/dtd/wikibook.dtd.

The wikibook dtd describes the ''structure'' of the page's content, not its presentation. This approach generally works well, but it has some limitations, many arising from the physical differences between a scrolling colour screen and a fixed-size sheet of paper:

* style information is partially supported::
There are major differences between the css-based model used in xhtml (and implicit in PmWiki) and the structure-based approach used in the typesetting engine. Currently, there is no print equivalent to the rich style options found in xhtml. The approach taken is to translate those style options with recognisable equivalents (inline styles such as text colour blue), and ignore the rest (block styles such as place a red dotted border around this paragraph with a pale blue background).

* some, but not all, tabular material is supported::
True tables are supported well. Headings, captions, cell alignment and text wrap all map to their print equivalents. Where tables are used as a way to control the presentation of complex material, it currently works less well, especially with very long cells. It treats complex cells as "minipages" and keeps the content together on a page. As a result, if the cell contains more than a page of content, some will fall off the end of the page.

* divisional styling has limited suport::
The wikibook dtd allows multiple block tags to be wrapped in a <group> tag, which is treated as a minipage. This area is under development.

<<|UserGuide|>>
Creative Commons License
Edit · History · Print · Recent Changes · Search · Links
Page last modified on 26 March 2009 at 02:39 PM