Akoma Ntoso Subschema Generator

for Release 22/07/2012 - Akoma Ntoso 2.0 (Beta)

Akoma Ntoso is a standard to define simple, technology-neutral representations of Parliamentary Documents for e-Parliament services in a Pan-African context and provides an enabling framework for the effective exchange of "machine readable" Parliamentary Documents such as legislation, debate record, minutes, etc.

Akoma Ntoso uses XML Schema to define the XML vocabulary and grammatical constraints of its documents, and makes it possible to either use the general schema or to use simpler custom subschemas as long as they produce valid Akoma Ntoso documents.

The Akoma Ntoso Subschema Generator can therefore be used to generate subschemas that are guaranteed to generate valid Akoma Ntoso documents by restricting the vocabulary to only those elements and attributes that are actually needed in specific situations.

The Akoma Ntoso subschema generator is an XProc-based application written by Fabio Vitali of the University of Bologna (contact: fabio@cs.unibo.it).

Preset combinations
À la carte

Acts All elements for describing acts and existing legislative documents

The combination 'Acts' contains the following modules:

Core elements (core)
Legislative documents (legislativeDocs)
Acts (act)
Titled block (tblock)
Semantic inline elements (semantic)
Advanced references (advancedRefs)
Modifications (modifications)
Special elements (specials)
Typographical delimiters (delimiters)
Authorial Note (authorialNote)
HTML table model (table)

Bills All elements for describing bills and legislative documents being drafted and discussed

The combination 'Bills' contains the following modules:

Core elements (core)
Legislative documents (legislativeDocs)
Bills (bill)
Titled block (tblock)
Semantic inline elements (semantic)
Advanced references (advancedRefs)
Special elements (specials)
Typographical delimiters (delimiters)
Authorial Note (authorialNote)
HTML table model (table)

Amendments All elements for describing amendments and amendment lists

The combination 'Amendments' contains the following modules:

Core elements (core)
Collections of smaller documents (collectionDocs)
Amendment list (amendmentList)
Legislative documents (legislativeDocs)
Amendments (amendmentDocs)
Additional preface elements (advancedPreface)
Special elements (specials)
Authorial Note (authorialNote)

Debates and hansards All elements for describing hansards and debates

The combination 'Debates and hansards' contains the following modules:

Core elements (core)
Parliamentary debates and hansards (debateDocs)
Debates (debate)
Table of content (toc)
Additional preface elements (advancedPreface)
Typographical delimiters (delimiters)
Authorial Note (authorialNote)

Judgements All elements for describing judgements and sentences

The combination 'Judgements' contains the following modules:

Core elements (core)
Judgements (judgementDocs)
Titled block (tblock)
Additional preface elements (advancedPreface)
Authorial Note (authorialNote)

Minutes All elements for describing minutes in a Parliament setting

The combination 'Minutes' contains the following modules:

Core elements (core)
Parliamentary debates and hansards (debateDocs)
Debate reports (debateReport)
Debates (debate)
Titled block (tblock)
Table of content (toc)
Additional preface elements (advancedPreface)
Semantic inline elements (semantic)
Advanced references (advancedRefs)

Order of the Day All elements for describing orders of the day in a Parliament setting

The combination 'Order of the Day' contains the following modules:

Core elements (core)
Titled block (tblock)
Table of content (toc)
Authorial Note (authorialNote)

Reports All elements for describing reports in a Parliament setting

The combination 'Reports' contains the following modules:

Core elements (core)
Titled block (tblock)
Table of content (toc)
Additional preface elements (advancedPreface)
Semantic inline elements (semantic)
Authorial Note (authorialNote)
HTML table model (table)

Official Gazette All elements for describing Official Gazettes

The combination 'Official Gazette' contains the following modules:

Core elements (core)
Collections of smaller documents (collectionDocs)
Official Gazette (officialGazette)
Legislative documents (legislativeDocs)
Acts (act)
Titled block (tblock)
Semantic inline elements (semantic)
Advanced references (advancedRefs)
Modifications (modifications)
Special elements (specials)
Typographical delimiters (delimiters)
Authorial Note (authorialNote)
HTML table model (table)

Document Modules	Core Modules
Legislative documents (code: legislativeDocs) typical hierarchical elements of legislative documents clause, section, part, paragraph, chapter, and title Acts (code: act) legislative document act Bills (code: bill) legislative document bill Optional hierarchy (code: optHierarchy) optional hierarchical elements article, book, tome, division and list Small hierarchical elements (code: smallHierarchy) hierarchical elements of smaller fragments of a hierarchy, such as point, indent, alinea Additional hierarchy (code: additionalHierarchy) infrequent hierarchical elements subsection, subpart, subparagraph, subchapter, subtitle, subclause and sublist Transitional section (code: transitionalSection) transitional, a hierarchical element containing transitory clauses, often at the end of the whole hierarchy Modifications (code: modifications) elements for modification acts mod, mmod, rmod, quotedText and quotedStructure Metadata for the analysis of modification acts: amendments and relative metadata Parliamentary debates and hansards (code: debateDocs) Document elements debateReport and debate Named structural elements administrationOfOath, declarationOfVote, communication, petitions, papers, noticesOfMotion, question, address, proceduralMotion, pointOfOrder Generic structural container debateSection Content elements speech, question, answer, other, scene inline element remark for editorial remarks (e.g., applauses, laughters, etc.) and element recordedTime to explicit mention a time in a debate Metadata for the analysis of debate: voting and quorum analysis Debate reports (code: debateReport) Document type debateReport Debates (code: debate) Document type debate Judgements (code: judgementDocs) Document type judgement Structural elements introduction, background, motivation and decision Preface elements courtType, neutralCitation, party and judge Metadata for the analysis of judgements: judicial arguments Amendments (code: amendmentDocs) Document type amendment Structural elements amendmentHeading, amendmentContent, amendmentReference and amendmentJustification Collections of smaller documents (code: collectionDocs) Document types amendmentList, officialGazette and documentCollection Amendment list (code: amendmentList) A document containing lists of amendments Official Gazette (code: officialGazette) A document containing sequences of acts and other legislative documents	Required elements of the schema (code: core) Document element doc Shared structural elements coverPage, preamble, preface, conclusions, attachments, heading for structured and hierarchical elements num, heading, subheading Elements for lists: list, listIntroduction, item, and listConclusion Basic Inline elements for prefaces docType, docTitle, docNumber, docProponent, and docDate. Element for document signature signature Simple legal reference ref References to end notes noteRef Basic generic container, block and inline from HTML: div, p, span and br Basic metadata elements for FRBR levels: FRBRWork, FRBRExpression, FRBRManifestation, FRBRItem Basic metadata elements for libraries: publication and classification Basic metadata elements for ontological specification: temporalData containing timeIntervals, references, all TLC elements, notes Substructures in prefaces and preambles (code: prefaceSubstructures) Substructures such as recitals, recital, citations, citation and longTitle Titled block (code: tblock) The element tblock (titled block) is used to specify a container for blocks introduced by heading elements, similarly to a hierarchical structure. Table of content (code: toc) the element toc (Table of Content) is used as a container of many individual items of the toc (element tocItem) Legislative preface elements (code: legislativePreface) Additional Preface elements for legislative documents such as legislature, session, shortTitle. Additional preface elements (code: advancedPreface) Additional Preface elements such as docPurpose, docCommittee, docIntroducer, docStage, docStatus and docJurisdiction. Semantic inline elements (code: semantic) Inline elements with a precise meaning: date, entity, person and def Advanced references (code: advancedRefs) Elements for sophisticated legal references mref (multiple references) and rref (range of references) Elements for publishing (code: publishing) inline elements for the specification of publishing additions such as ins, del and omissis Special elements (code: specials) Special elements are two elements used in specific circumnstances, such as placeholder, an inline element containing the text of a computable expression (e.g., '30 days after the publication of this act') that can be replaced editorially with an actual value and fillIn, an inline element to represent (e.g., as a dotted line) the space where a eprson can fill in a value for a printed form Typographical delimiters (code: delimiters) Elements for the definition of typographical delimitation of line (eol) and page (eop) Extracts (code: extract) inline and popup elements extractStructure and extractText for the specification of extracts from other documents. Authorial Note (code: authorialNote) Element authorialNote for the specification of authoritative (non-editorial) notes that are out of the main flow of the text, yet are part of the official authoritative text. Additional generic containers (code: additionalGeneric) Element foreign for the inclusion of structures not expressable with Akoma Ntoso (such as SVG graphics or MathML mathematical formulas) Container proprietary for the specification of metadata elements not belonging to Akoma Ntoso and presentation for the specification of presentations styles (e.g., CSS fragments) for the visual rendering of elements of the document Generic elements (code: generic) Non-specific elements that can be applied to any context as long as they respect the corresponding type of content model: hcontainer, container, block, inline, marker Elements from HTML (code: html) Elements introduced in HTML used here with the same meaning and purpose: b, i, u, sup, sub, a, img, ul, ol, li HTML table model (code: table) Elements for table structures taken from HTML: table, tr, th, td Advanced metadata (code: advancedMetadata) Advanced metadata specifications for specific needs: componentInfo and preservation Elements for the specification of lifecycle and workflow of documents Components (code: components) Elements components and component for the specification of parts and fragments of composite documents

Document Modules

Core Modules

Legislative documents (code: legislativeDocs)

typical hierarchical elements of legislative documents clause, section, part, paragraph, chapter, and title

Acts (code: act)

legislative document act

Bills (code: bill)

legislative document bill

Optional hierarchy (code: optHierarchy)

optional hierarchical elements article, book, tome, division and list

Small hierarchical elements (code: smallHierarchy)

hierarchical elements of smaller fragments of a hierarchy, such as point, indent, alinea

Additional hierarchy (code: additionalHierarchy)

infrequent hierarchical elements subsection, subpart, subparagraph, subchapter, subtitle, subclause and sublist

Transitional section (code: transitionalSection)

transitional, a hierarchical element containing transitory clauses, often at the end of the whole hierarchy

Modifications (code: modifications)

elements for modification acts mod, mmod, rmod, quotedText and quotedStructure
Metadata for the analysis of modification acts: amendments and relative metadata

Parliamentary debates and hansards (code: debateDocs)

Document elements debateReport and debate
Named structural elements administrationOfOath, declarationOfVote, communication, petitions, papers, noticesOfMotion, question, address, proceduralMotion, pointOfOrder
Generic structural container debateSection
Content elements speech, question, answer, other, scene
inline element remark for editorial remarks (e.g., applauses, laughters, etc.) and element recordedTime to explicit mention a time in a debate
Metadata for the analysis of debate: voting and quorum analysis

Debate reports (code: debateReport)

Document type debateReport

Debates (code: debate)

Document type debate

Judgements (code: judgementDocs)

Document type judgement
Structural elements introduction, background, motivation and decision
Preface elements courtType, neutralCitation, party and judge
Metadata for the analysis of judgements: judicial arguments

Amendments (code: amendmentDocs)

Document type amendment
Structural elements amendmentHeading, amendmentContent, amendmentReference and amendmentJustification

Collections of smaller documents (code: collectionDocs)

Document types amendmentList, officialGazette and documentCollection

Amendment list (code: amendmentList)

A document containing lists of amendments

Official Gazette (code: officialGazette)

A document containing sequences of acts and other legislative documents

Required elements of the schema (code: core)

Document element doc
Shared structural elements coverPage, preamble, preface, conclusions, attachments,
heading for structured and hierarchical elements num, heading, subheading
Elements for lists: list, listIntroduction, item, and listConclusion
Basic Inline elements for prefaces docType, docTitle, docNumber, docProponent, and docDate.
Element for document signature signature
Simple legal reference ref
References to end notes noteRef
Basic generic container, block and inline from HTML: div, p, span and br
Basic metadata elements for FRBR levels: FRBRWork, FRBRExpression, FRBRManifestation, FRBRItem
Basic metadata elements for libraries: publication and classification
Basic metadata elements for ontological specification: temporalData containing timeIntervals, references, all TLC elements, notes

Substructures in prefaces and preambles (code: prefaceSubstructures)

Substructures such as recitals, recital, citations, citation and longTitle

Titled block (code: tblock)

The element tblock (titled block) is used to specify a container for blocks introduced by heading elements, similarly to a hierarchical structure.

Table of content (code: toc)

the element toc (Table of Content) is used as a container of many individual items of the toc (element tocItem)

Legislative preface elements (code: legislativePreface)

Additional Preface elements for legislative documents such as legislature, session, shortTitle.

Additional preface elements (code: advancedPreface)

Additional Preface elements such as docPurpose, docCommittee, docIntroducer, docStage, docStatus and docJurisdiction.

Semantic inline elements (code: semantic)

Inline elements with a precise meaning: date, entity, person and def

Advanced references (code: advancedRefs)

Elements for sophisticated legal references mref (multiple references) and rref (range of references)

Elements for publishing (code: publishing)

inline elements for the specification of publishing additions such as ins, del and omissis

Special elements (code: specials)

Special elements are two elements used in specific circumnstances, such as placeholder, an inline element containing the text of a computable expression (e.g., '30 days after the publication of this act') that can be replaced editorially with an actual value and fillIn, an inline element to represent (e.g., as a dotted line) the space where a eprson can fill in a value for a printed form

Typographical delimiters (code: delimiters)

Elements for the definition of typographical delimitation of line (eol) and page (eop)

Extracts (code: extract)

inline and popup elements extractStructure and extractText for the specification of extracts from other documents.

Authorial Note (code: authorialNote)

Element authorialNote for the specification of authoritative (non-editorial) notes that are out of the main flow of the text, yet are part of the official authoritative text.

Additional generic containers (code: additionalGeneric)

Element foreign for the inclusion of structures not expressable with Akoma Ntoso (such as SVG graphics or MathML mathematical formulas)
Container proprietary for the specification of metadata elements not belonging to Akoma Ntoso and presentation for the specification of presentations styles (e.g., CSS fragments) for the visual rendering of elements of the document

Generic elements (code: generic)

Non-specific elements that can be applied to any context as long as they respect the corresponding type of content model: hcontainer, container, block, inline, marker

Elements from HTML (code: html)

Elements introduced in HTML used here with the same meaning and purpose: b, i, u, sup, sub, a, img, ul, ol, li

HTML table model (code: table)

Elements for table structures taken from HTML: table, tr, th, td

Advanced metadata (code: advancedMetadata)

Advanced metadata specifications for specific needs: componentInfo and preservation
Elements for the specification of lifecycle and workflow of documents

Components (code: components)

Elements components and component for the specification of parts and fragments of composite documents

Click on the checkbox near the name of the desired module. By clicking on "More details" a list of the elements contained in the relevant module is shown. Show all details

The application will generate a subschema of Akoma Ntoso with the following name:

Selected modules:

The application will generate a zip package called .zip containing an XML schema called .xsd, a DTD called .dtd and a DTD++ schema called .dpp.

The current release of the Akoma Ntoso subschema generator is version 1.0 (2011-05-07).

You can download the Akoma Ntoso subschema generator, it is free software licensed under the terms of the GNU General Public License version 2 or later.