The Apache Forrest xdocs document-v1.3 DTD NOTICE The content of this document doesn't make any sense at all. ABSTRACT This is a demonstration document using all possible elements in the current Apache Forrest xdocs document-v13.dtd Table Of Contents ================= Sample Content Block and inline elements Various presentation formats Using sections Sections, the sequel Section 2.1 Showing preformatted source code Using tables Using figures DTD changes Changes since document-v12 Changes since document-v11 ** Note ** This is a demonstration document using all possible elements in the current Apache Forrest xdocs document-v13.dtd (See the DTD changes [Link: #changes] section at the bottom.) ---------------------------------------------------------------------------- Sample Content ============== Hint: See the xml source to see how the various elements are used and see theDTD reference documentation [Link: http://forrest.apache.org/docs/dtd-docs.html]. Block and inline elements ------------------------- This is a simple paragraph. Most documents contain a fair amount of paragraphs. Paragraphs are called
. With the
attribute, you can declare that whitespace should be preserved, without implying it is in any other way special. This next paragraph has a class attribute of 'quote'. CSS can be used to present this
in a different style than
the other paragraphs. The handling of this quoted paragraph is
defined in the ):
* Here is a simple list item (
element in the previous item?
* Also, we have and elements to show content aboveor belowthe
text baseline.
* There is a facility to emphasize certain words using the
elements.
* We can use [Icon: feather] element: [Image: another feather],
which offers the ability to refer to an image map.
* We have elements for hyperlinking:
::
Use this to link [Link: faq.html] to another document. As per normal,
this will open the new document in the same browser window.
::
Use this to link [Link: #section] to the named anchor in the current
document.
::
Use this to link [Link: faq.html#forrest] to another document and go
to the named anchor. This will open the new document in the same
browser window.
::
was used inside the previous list item. We could put another
* unordered list
* inside the list item
A sample nested table
+---------------------------------+---------------------------------+
| Or even tables.. | +-----------------------------+ |
| | | inside tables.. | |
| | +-----------------------------+ |
+---------------------------------+---------------------------------+
| or inside lists, but I believe | |
| this liberty gets quickly | |
| quite hairy as you see. | |
+---------------------------------+---------------------------------+
So far for the in-line elements, let's look at some paragraph-level
elements.
** Fixme (SN) **
The
element is used when the author can't express himself
clearly using normal sentences ;-)
------------------------------------------------------------------------
** Warning **
Sleep deprivation can be the result of being involved in an open
source project. (a.k.a. the element.
[Figure: The fine Forrest logo]
DTD changes
===========
See the generatedDTD reference documentation [Link:
http://forrest.apache.org/docs/dtd-docs.html].
Changes since document-v12
--------------------------
All v1.2 docs will work fine as v1.3 DTD. The main change is the
addition of a @class attribute to every element, which enables the
"extra-css" section in the skinconf to be put to good use.
Changes since document-v11
--------------------------
doc-v12 enhances doc-v11 by relaxing various restrictions that were
found to be unnecessary.
* Links ((link|jump|fork) and inline elements (br|img|icon|acronym) are
allowed inside title.
* Paragraphs (p|source|note|warning|fixme), table and figure|anchor are
allowed inside li.
* Paragraphs (p|source|note|warning|fixme), lists (ol|ul|dl), table,
figure|anchor are allowed inside definition lists (dd) and tables (td
and dh).
* Inline content
(strong|em|code|sub|sup|br|img|icon|acronym|link|jump|fork) is allowed
in strong and em.