Schematron

Figure 727. Schematron on top of RelaxNG

Figure 728. Example: xml:id and permalink

<chapter id="introduction" ❶> ...
  <section xml:id="firstSection" ❶>
    <title>First section</title>
    <para>A stable link</para>
  </section>
  <section> <!-- no xml:id attribute-->
    <title>Second section</title>
    <para>No stable link</para> ...

<!-- file introduction.html -->
<html>
  ...
<h2 id="firstSection" ❶>First section</h2>
<p>A stable link</p>

<h2 id="d03213" ❷>Second section</h2>
<p>No stable link</p>

❶	Defining chunk's base name `introduction.html`.
❶	Stable target `http://...introduction.html#firstSection`.
❷	Instable target `http://...introduction.html#d03213`.

Figure 729. Using Display #Anchors

❶	The page's URI based on `xml:id` value `introduction`.
❷	Stable `https://.../introduction.html#firstSection`.
❸	Unstable `https://.../introduction.html#d03213`

Figure 730. Considerations author based permalink

Requirement

Important elements (<chapter>, <section>, <table>...) must provide an xml:id value.

Implementation choices

Modify underlying RelaxNG schema.

Result: Restricted schema (Inheritance relationship)
Add Schematron integrity rule on top of schema.

Figure 731. Schematron permalink rule

<s:pattern>
  <s:title>Mandatory Id definition constraint</s:title>
  <s:rule context="db:chapter|db:section|db:table|db:qandaset">
    <s:assert test="@xml:id"
       >Each chapter,section, table ... must have a unique id.</s:assert>
  </s:rule>
</s:pattern>

Prev	Up	Next
Top level elements	Home	Customizing

Docbook