Atom Vocabulary for Wiki Metadata: historyczna wersja
Podgląd
Abstract
This document specifies Extension elements and categorization schemes for the Atom Syndication Format used for description of wiki metadata.
Authors
- Paulina Laura Emilia <vilene -at- posteo -dot- net>
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.
1. Introduction
This document specifies Extension elements and categorization schemes 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#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”, “Person construct” and “categorization scheme” 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. Categorization schemes
Names of categorization schemes defined in this section, when preceded by the Namespace URI identified in section 1.1 of this document (e.g. https://wandystan.eu/ns/AtomWiki#Namespace), are intended to be used as the values of the scheme attribute of the atom:category element.
3.1 Category
Categories are used to group together related pages. Wiki pages MAY have more than one category associated with them.
3.2 Namespace
Namespaces are collections of pages linked by a single topic or purpose. They can differ from each other in their appearance or behavior. Wiki pages SHOULD NOT have more than one namespace associated with them.
4. References
4.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.
4.2 Informative references
- ModWiki
“RDF Site Summary 1.0 Module: Wiki”, MeatballWiki.