Atom Vocabulary for Wiki Metadata

Abstract

This document specifies Extension elements for the Atom Syndication Format used for description of wiki metadata.

Authors

Copyright

Copyright © 2018 Paulina Laura Emilia

Atom Vocabulary for Wiki Metadata is licensed under a Creative Commons Attribution 4.0 International License.

Status of this document

This document is a working draft of a proposed specification. Its contents may be subject to change at any moment.

Changelog

2018-05-14
Removed proposed categorization schemes. It is better to refer to well-defined SKOS concept schemes instead.

1. Introduction

This document specifies Extension elements for the Atom Syndication Format (RFC 4287) useful for description of metadata specific to the wiki engines.

It is based on, and mostly compatible with the proposed RSS 1.0 Wiki Module (ModWiki).

1.1 Namespace

The XML Namespaces URI (REC-xml-names) for XML elements defined in this document is https://wandystan.eu/ns/AtomWiki. The preferred XML namespace prefix for elements in this namespace is wiki.

1.2 Notational conventions

The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in RFC 2119.

Terms “Extension element”, “Simple Extension element”, “Structured Extension element”, “Text construct” and “Person construct” are to be interpreted as described in RFC 4287.

The namespace prefix wiki: is used for the Namespace URI identified in section 1.1 of this document. The namespace prefix atom: is used for the Namespace URI identified in section 1.2 of the RFC 4287.

2. Extension element definitions

2.1 wiki:editsummary

The human-readable summary of the change to the page. The content and attributes of this element MUST be the same as in the Atom Text constructs.

wiki:version is a Structured Extension element and MUST be a child of atom:entry or atom:source.

2.2 wiki:host

The host associated with the person that edited the wiki page. The content of this element MUST be either an IP address or a hostname; they MAY be partially masked.

wiki:host is a Simple Extension element and MUST be a child of an Atom Person construct.

2.3 wiki:importance

The importance of the change to the page. The content of this element SHOULD be either “major” or “minor”.

wiki:version is a Simple Extension element and MUST be a child of atom:entry or atom:source.

2.4 wiki:status

The status of the change to the page. The content of this element SHOULD be one of the “new”, “updated”, or “deleted”.

wiki:version is a Simple Extension element and MUST be a child of atom:entry or atom:source.

2.5 wiki:version

The version of the wiki page. The content of this element MUST be an identifier that unambiguously identifies version of the page inside the wiki website.

wiki:version is a Simple Extension element and MUST be a child of atom:entry or atom:source.

3. References

3.1 Normative references

REC-xml-names

T. Bray et al., “Namespaces in XML 1.0 (Third Edition)”, W3C Recommendation, 8 December 2009.

RFC 2119

S. Bradner, “Key words for use in RFCs to Indicate Requirement Levels”, RFC 2119, March 1997.

RFC 4287

M. Nottingham, R. Sayre, “The Atom Syndication Format”, RFC 4287, December 2005.

3.2 Informative references

ModWiki

RDF Site Summary 1.0 Module: Wiki”, MeatballWiki.