Documentation
Elements
- <a>
- <altRepresentation>
- <aside>
- <assessment>
- <author>
- <backcover>
- <blockquote>
- <body>
- <bodymatter>
- <caption>
- <code>
- <cover>
- <dd>
- <dl>
- <document>
- <dt>
- <em>
- <figure>
- <figureGroup>
- <frame>
- <frontcover>
- <frontmatter>
- <hd>
- <img>
- <indicators>
- <input>
- <jacketcopy>
- <legend>
- <li>
- <line>
- <linegroup>
- <list>
- <meta>
- <metadata>
- <note>
- <noteRef>
- <p>
- <pagebreak>
- <poem>
- <publication>
- <pullquote>
- <rearmatter>
- <section>
- <source>
- <span>
- <sub>
- <subtitle>
- <sup>
- <table>
- <tbody>
- <td>
- <tfoot>
- <th>
- <thead>
- <title>
- <tr>
All right!
Language codes
This book series primarily contains Dutch, xml:lang="nl-NL", and British English, xml:lang="en-GB". Depending on educational level, determine which main language should be assigned to <publication>-element as instructed in ps-form.
NOTE: instructions below are based on <publication xml:lang="en-GB">
Book structure
See Sectioning for general information.
Use following template:
<frontmatter>
<section level="1" role="titlePage">
<hd>All Right!</hd>
<hd xml:lang="nl-NL">ENGELS VOOR DE BOVENBOUW</hd>
<hd>STUDENT'S BOOK</hd>
<hd xml:lang="nl-NL">1 VMBO-BK</hd>
</section>
<hd>Classroom English</hd>
...
<section level="1" role="toc">
<hd level="1">Contents</hd>
...
</section>
<section level="1" role="introduction">
<hd>Aan de slag met All Right!</hd>
...
</section>
</frontmatter>
<bodymatter>
<section level="1" role="chapter">
<hd level="1" number="1"">Unit 1 England</hd>
...
<section level="2" role="subChapter">
<hd level="2" number="1">LESSON 1 Crossing Borders</hd>
...
</section>
<section level="2" role="practice">
<hd level="2">Study box</hd>
...
</section>
</section>
</bodymatter>
<rearmatter>
<section level="1" role="appendix">
<hd level="1">Speaking card A</hd>
...
</section>
...
<section level="1" role="colophon">
<hd level="1" xml:lang="nl-NL">Colofon</hd>
...
</section>
</rearmatter>
Opening subchapters

<section level="2" role="subChapter">
<hd level="2" number="2">Lesson 2 Listening</hd>
<hd xml:lang="nl-NL">LEERDOELEN</hd>
<list listType="unordered" bulletType="circle" xml:lang="nl-NL">
<li>Je kunt vragen ...</li>
...
</list>
<hd>Grammar <img alt="online" role="informative" src="/..." type="pictogram"/></hd>
<list listType="unordered" bulletType="circle" xml:lang="nl-NL">
<li>Persoonlijke ...</li>
...
</list>
<hd>Words <img alt="online" role="informative" src="/..." type="pictogram"/></hd>
<list listType="unordered" bulletType="circle">
<li>School</li>
</list>
...
</section>
Study box

<section level="2" role="practice">
<hd level="2">Study box</hd>
<hd number="2">Lesson 2 Listening</hd>
<hd><em type="bold">WORDS</em> Clothing <img alt="online" role="informative" src="/..." type="pictogram"/> Practise online</hd>
...
Speaking cards
Process lists in “Speaking cards …” containing triangles using example below:

<section level="1" role="appendix">
<hd level="1">Speaking cards A</hd>
<img alt="" role="informative" src="/img/..." type="drawing"/>
<hd>1A</hd>
<p xml:lang="nl-NL">Voer een gesprek met je klasgenoot. Je gaat wat over jezelf vertellen. Gebruik hierbij de <em type="italic">expressions</em>.</p>
<list listType="unordered" bulletType="predefined">
<li bullet="▷" xml:lang="nl-NL">Groet je klasgenoot.</li>
...
Table of contents
See Tables of contents for general information.
Use following template:

<list role="toc" listType="ordered" numberType="predefined">
<li><img alt="" role="informative" src="/..." type="photo"/> Unit 1 England <a type="pageRef" href="#pb-8">8</a></li>
<li><img alt="" role="informative" src="/..." type="photo"/> Unit 2 Scotland <a type="pageRef" href="#pb-46">46</a></li>
<li><img alt="" role="informative" src="/..." type="photo"/> Unit 3 New York <a type="pageRef" href="#pb-84">84</a></li>
<li><img alt="" role="informative" src="/..." type="photo"/> Unit 4 Canada <a type="pageRef" href="#pb-120">120</a></li>
<li><img alt="" role="informative" src="/..." type="photo"/> Unit 5 Ireland <a type="pageRef" href="#pb-156">156</a></li>
<li><img alt="" role="informative" src="/..." type="photo"/> Unit 6 New Zealand <a type="pageRef" href="#pb-194">194</a></li>
</list>
<p fontStyles="bold" xml:lang="nl-NL">Naslagwerk</p>
<list role="toc" listType="ordered" numberType="predefined" xml:lang="nl-NL">
<li>Speaking Cards <a type="pageRef" href="#pb-234">234</a></li>
<li>Index grammatica <a type="pageRef" href="#pb-238">238</a></li>
<li>Onregelmatige werkwoorden <a type="pageRef" href="#pb-239">239</a></li>
</list>
Table of contents in chapters
Process more detailed table of contents of individual chapters as follows:

<list role="toc" listType="ordered" numberType="predefined">
<li number="1">Crossing Borders <a type="pageRef" href="#pb-10">10</a></li>
<li number="2">Listening <a type="pageRef" href="#pb-12">12</a></li>
<li number="3">Speaking <a type="pageRef" href="#pb-17">17</a></li>
<li number="4">Reading <a type="pageRef" href="#pb-23">23</a></li>
<li number="5">Writing <a type="pageRef" href="#pb-31">31</a></li>
<li number="6">Literature <a type="pageRef" href="#pb-38">38</a></li>
</list>
Frames

<frame>
<title>Text</title>
<hd>The History of Pancake Day</hd>
...
<dl>
<dt>celebrated</td>
<dd xml:lang="nl-NL">gevierd</td>
<dt>Lent</td>
<dd xml:lang="nl-NL">vastenperiode</td>
</dl>
</frame>


<p foregroundColor="red" xml:lang="nl-NL"><img alt="Test jezelf" role="informative" src="/..." type="pictogram"/> Maak <em type="italic">Test jezelf</em>.</p>
<p foregroundColor="red" xml:lang="nl-NL">Heb je nog ...</p>
Conversations

<frame>
<title>Text</title>
<hd>Strapped for Time</hd>
<figure>
<img alt="" role="informative" src="/..." type="photo"/>
</figure>
<p fontStyles="bold">Pippa and Saïd ...</p>
<p><em type="bold" foregroundColor="lightGreen">Pippa:</em> Can you check ...</p>
...
</frame>
Assessments
Notebook paper

<hd backgroundColor="lightGreen" fontStyles="bold">WARMING UP</hd>
<assessment>
<title number="1" label="assessment">1</title>
<indicators>
<img alt="audio/video" role="informative" src="/..." type="pictogram"/>
</indicators>
<p xml:lang="nl-NL">Maak deze ...</p>
<p><input type="textarea" id="input-..."/></p>
</assessment>
Indicators

<hd backgroundColor="lightGreen" fontStyles="bold">WARMING UP</hd>
<assessment>
<title number="1" label="assessment">1</title>
<indicators>
<img alt="audio/video" role="informative" src="/..." type="pictogram"/>
<p backgroundColor="lightPurple">PAIR WORK</p>
</indicators>
<p xml:lang="nl-NL">Luister naar ...</p>
...
</assessment>
Icons
The pictograms that you encounter throughout the book should be processed as image. If they occur within an assessment, process them within <indicators>. Otherwise process as inline image. Please fill the alt attribute with the value displayed in the table below.
See Pictograms.
| pictogram | value alt attribute |
|---|---|
| audio/video | |
| online | |
| Test jezelf |
Grammar/Expressions
Depending on format, process content in Grammar and Expression boxes with definition lists, tables etc.
Example of content which should be processed with definition list:

<frame>
<title>Grammar</title>
<subtitle xml:lang="nl-NL">'Zijn': <em type="italic" xml:lang="en-GB">to be</em> (vragen)</subtitle>
<p><img alt="online" role="informative" src="/..." type="pictogram"/> Practise online</p>
<p xml:lang="nl-NL">In vragen ...</p>
<dl>
<dt><em type="bold italic">Am I</em> <em type="italic">clever?</em></dt>
<dd xml:lang="nl-NL">Ben ik slim?</dd>
...
</dl>
</frame>
Example of content which should be processed with list:
