Division Annotation¶
Structure annotation representing some kind of division, typically used for chapters, sections, subsections (up to the set definition). Divisions may be nested at will, and may include almost all kinds of other structure elements.
Specification¶
Annotation Category: | |
---|---|
Declaration: |
|
Version History: | |
Since the beginning |
|
Element: |
|
API Class: |
|
Required Attributes: | |
Optional Attributes: | |
|
|
Accepted Data: |
|
Valid Context: |
|
Set Definitions: | |
You can use any of the following existing set definitions or simply create your own: * `https://raw.githubusercontent.com/proycon/folia/master/setdefinitions/divisions.foliaset.xml`_ |
Description & Examples¶
The structure element <div>
is used to create divisions and subdivisions within a text.
Each division may be of a particular class pertaining to a set defining all possible classes, common classes for this annotation type would be chapter, section, subsection. A set, however, is not mandatory for most types of structure, so divisions may be set-less.
Divisions and other structural units are often numbered, think for example of chapters and sections. The number, as it was in the source document, can be encoded in the n attribute of the structure annotation element.
Divisions should never be used for marking paragraphs, sentences or other smaller structural entities for which FoLiA provides explicit structural element. Divisions only cover large structures.
The following example shows a FoLiA document with structured divisions with headers and paragraphs. It does not provide any further tokenisation.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 | <?xml version="1.0" encoding="utf-8"?>
<FoLiA xmlns="http://ilk.uvt.nl/folia" version="2.0" xml:id="example">
<metadata>
<annotations>
<text-annotation>
<annotator processor="p1" />
</text-annotation>
<division-annotation set="https://raw.githubusercontent.com/LanguageMachines/uctodata/master/setdefinitions/divisions.foliaset.xml">
<annotator processor="p1" />
</division-annotation>
<head-annotation>
<annotator processor="p1" />
</head-annotation>
<paragraph-annotation>
<annotator processor="p1" />
</paragraph-annotation>
</annotations>
<provenance>
<processor xml:id="p1" name="proycon" type="manual" />
</provenance>
</metadata>
<text xml:id="example.text">
<div xml:id="example.div.1" class="chapter" n="1">
<head>
<t>Chapter 1: In the beginning</t>
</head>
<div xml:id="example.div.1.1" class="section" n="1.1">
<head>
<t>Section 1.1: The first steps</t>
</head>
<p xml:id="example.div.1.1.p.1">
<t>And so the first paragraph commences...</t>
</p>
</div>
</div>
</text>
</FoLiA>
|