In POSHDOC files document metadata and content is strictly separated.
ToDo Metadata is placed in the head element, in the
body/article/headerand in the
body/article/footerelement. The header is only used to hold the document title inside a
<h1>element, optionally followed by a document subtitle inside a
Content is placed inside a
body/article/sectionelement between header and footer.
With content structure we define hierarchical structuring of content, i.e. sections, subsection and so on. In POSHDOC pages and documents this is done with HTML headers, in collections the hierarchy corresponds to the underlying directory hierarchy. One means of access to the content elements are Content Listings
- Todo Headings
- Headings are the primary means of content structure.
ToDo: move the following paragraphs to Topic
The primary means of structuring a HTML document are the
<h*>elements. Inside the content section,
h2is the top level heading,
h6are the successive subheadings.
A POSHDOC without
<h*>content structuring is called a ToDo Topic .
- POSHDOC software should be able to cope gracefully with
<h6>headings inside the content section. Also, ToDo presentation can be adjusted differently for
body/article/section/h1. However the
start-with-h2-in-contentconvention copes with the fact, that most browser by default will present the title and the first heading exactly the same way, which hampers proofreading in the browser.
- ToDo Content Listings
- Top level definition lists are used to structure POSHDOC collections.