Z39.98 Authoring and Interchange Framework Primer

From zedwiki

19 December 2011

Editors:

James Pritchett, Recording for the Blind & Dyslexic

Markus Gylling, DAISY Consortium

Matt Garrish, Invited Expert

Introduction

This document provides an introduction to the technologies and concepts behind the Z39.98-2012 Authoring and Interchange Framework (Z39.98-AI Framework). It is intended to be read along with the normative specification documents, especially the Z39.98-2012 Authoring and Interchange Framework for Adaptive XML Publishing Specification. The intended audience includes Z39.98-AI document creators, as well as developers who will be creating and working with systems that operate on Z39.98-AI documents, or who will be developing new Z39.98-AI profiles. It assumes a basic understanding of XML, XML Namespaces, and XML schema languages.

Table of Contents

1. 1. Z39.98-AI profiles
2. 1. 1.1 A simple Z39.98-AI document
   2. 1.2 Default namespace
   3. 1.3 Default RDFa profile
   4. 1.4 Identifying profiles
   5. 1. 1.4.1 Profile resources
   6. 1.5 Metadata
   7. 1.6 The document content
   8. 1.7 Validating the document
3. 2. Modules and Namespaces
4. 1. 2.1. A more complex document
   2. 2.2. Schemas and modules
   3. 2.3. Including other markup: namespaces
5. 3. Adding semantic inflections
6. 1. 3.1. A more meaningful example
   2. 3.2. The role attribute
   3. 3.3. Role vocabularies
   4. 3.4. Using role in Z39.98-AI documents
   5. 3.5. Custom role vocabularies
7. 4. Advanced functions of profiles: features
8. 1. 4.1. Introduction to Z39.98-AI features
   2. 4.2. An example using the MathML feature
   3. 4.3. Features and informative schemas
9. 5. Metadata in Detail
10. 1. 5.1. Referencing metadata in external resources
    2. 5.2. Making the document itself the metadata resource

List of Examples

1. 1.1. A minimal Z39.98-AI document
2. 1.2. Using terms from a default vocabulary
3. 1.3. Declaring a vocabulary prefix
4. 1.4. Using prefixed terms
5. 1.5. Identifying the profile
6. 1.6. Profile resource directory (partial)
7. 1.7. Basic document: metadata
8. 2.1. A more complex Z39.98-AI document
9. 2.2. Table of contents from example document
10. 2.3. Declaration and use of the ITS namespace
11. 3.1. A document with detailed frontmatter
12. 3.2. RDFa representation of "title page" role
13. 3.3. Section with titlepage role
14. 4.1. Document with math
15. 4.2. Identifying a profile and a feature
16. 5.1. Referencing an external metadata record: MODS
17. 5.2. External metadata record: MODS
18. 5.3. Internal metadata record: RDFa