Example document for validation with a catalog
+— via the DOCTYPE public identifier and XML namespace URIs —
+rather than containing explicit references to a DTD and a schema
+— via the DOCTYPE system identifier and xsi:schemaLocation attribute.
+
\ No newline at end of file
diff --git a/confluence-page-template.xml b/confluence-page-template.xml
new file mode 100644
index 0000000..67aff00
--- /dev/null
+++ b/confluence-page-template.xml
@@ -0,0 +1,5 @@
+
+
+
+
+
diff --git a/confluence-ri.xsd b/confluence-ri.xsd
new file mode 100644
index 0000000..2e9c08e
--- /dev/null
+++ b/confluence-ri.xsd
@@ -0,0 +1,138 @@
+
+
+
+
+
+ Confluence page source XML schema: resource identifiers.
+
+ Last updated 2012-05-04.
+
+ Developed by Graham Hannington (Confluence user; no other affiliation with Atlassian).
+
+ Copyright (c) 2012, Fundi Software.
+ All rights reserved.
+
+ Distributed under the BSD 2-Clause license.
+
+
+
+
+
+
+ Confluence resource identifiers
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Confluence page
+
+
+
+
+
+
+
+
+
+
+
+ Confluence blog post
+
+
+
+
+
+
+
+
+
+
+
+
+ Confluence attachment
+
+
+
+
+
+
+
+
+
+
+
+
+
+ URL
+
+
+
+
+
+
+
+
+
+
+ Shortcut
+
+
+
+
+
+
+
+
+
+
+
+ Confluence user
+
+
+
+
+
+
+
+
+
+
+ Confluence space
+
+
+
+
+
+
+
+
+
+
+ Content entity
+
+
+
+
+
+
+
+
diff --git a/confluence-xhtml.xsd b/confluence-xhtml.xsd
new file mode 100644
index 0000000..abec9b0
--- /dev/null
+++ b/confluence-xhtml.xsd
@@ -0,0 +1,719 @@
+
+
+
+
+
+ Confluence page source XML schema:
+ elements and attributes that have the same name as in XHTML 1.0 Strict,
+ with the following exceptions:
+ XHTML 1.0 Transitional s (strikethrough) and u (underline) elements;
+ proprietary data-atlassian-layout attribute on div elements.
+
+ Last updated 2012-05-04.
+
+ Developed by Graham Hannington (Confluence user; no other affiliation with Atlassian).
+
+ Copyright (c) 2012, Fundi Software.
+ All rights reserved.
+
+ Distributed under the BSD 2-Clause license.
+
+
+
+
+
+
+
+
+
+ Imported names
+
+
+
+
+
+
+
+ A single character, as per section 2.2 of [XML]
+
+
+
+
+
+
+
+
+
+
+ One or more digits
+
+
+
+
+
+
+
+
+
+
+ A Uniform Resource Identifier, see [RFC2396]
+
+
+
+
+
+
+
+
+ Style sheet data
+
+
+
+
+
+
+
+
+ Used for titles etc.
+
+
+
+
+
+
+
+ Generic attributes
+
+
+
+
+
+
+
+ associated style info
+
+
+
+
+
+
+
+ Text elements
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ "Inline" covers inline or "text-level" elements
+
+
+
+
+
+
+
+
+
+
+
+ Block-level elements
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ "Flow" mixes block and inline and is used for list items etc.
+
+
+
+
+
+
+
+
+
+
+
+
+ Content models for exclusions
+
+
+
+
+
+
+ a elements use "Inline" excluding a
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ pre uses "Inline" excluding big, small, sup or sup
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Generic language/style container
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Paragraph
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Headings:
+ There are six levels of headings from h1 (the most important)
+ to h6 (the least important).
+
+
+
+
+
+
+ Heading 1
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Heading 2
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Heading 3
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Heading 4
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Heading 5
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Heading 6
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Lists
+
+
+
+
+
+
+ Unordered (bullet) list
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Ordered (numbered) list
+
+
+
+
+
+
+
+
+
+
+
+
+
+ List item
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Horizontal rule
+
+
+
+
+
+
+
+
+ Preformatted text
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Block-like quotation
+
+
+
+
+
+
+
+ Deleted Text
+
+
+
+
+
+
+
+ Anchor:
+ Content is "Inline" except that anchors shouldn't be nested
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Inline elements
+
+
+
+
+
+
+ Generic language/style container
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Forced line break
+
+
+
+
+
+
+
+
+
+
+ Emphasis
+
+
+
+
+
+
+
+ Strong emphasis
+
+
+
+
+
+
+
+ Program code
+
+
+
+
+
+
+
+ Citation. (Cannot be entered directly using the Confluence rich text editor, but you can use the wiki markup dialog to insert it. For example: ??This is a citation??
+
+
+
+
+
+
+
+ Subscript
+
+
+
+
+
+
+
+ Superscript
+
+
+
+
+
+
+
+ Italic font
+
+
+
+
+
+
+
+ Bold font
+
+
+
+
+
+
+
+ Bigger font
+
+
+
+
+
+
+
+ Smaller font
+
+
+
+
+
+
+
+ Underline (from XHTML 1.0 Transitional, not Strict)
+
+
+
+
+
+
+
+ Strikethrough (from XHTML 1.0 Transitional, not Strict)
+
+
+
+
+
+
+ Tables
+
+
+
+
+
+
+ Table
+
+
+
+
+
+
+
+
+
+
+
+
+ Table body
+
+
+
+
+
+
+
+
+
+
+
+
+ Table row
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Table header cell
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Table data cell
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/confluence.dtd b/confluence.dtd
new file mode 100644
index 0000000..eaa2125
--- /dev/null
+++ b/confluence.dtd
@@ -0,0 +1,367 @@
+
+
+
+
+
+%HTMLlat1;
+
+
+%HTMLsymbol;
+
+
+%HTMLspecial;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/confluence.xsd b/confluence.xsd
new file mode 100644
index 0000000..204805b
--- /dev/null
+++ b/confluence.xsd
@@ -0,0 +1,222 @@
+
+
+
+
+
+ Confluence page XML schema:
+ "master" schema, defining document root element (confluence)
+ and other markup in the same namespace.
+
+ Last updated 2012-05-04.
+
+ Developed by Graham Hannington (Confluence user; no other affiliation with Atlassian).
+
+ Copyright (c) 2012, Fundi Software.
+ All rights reserved.
+
+ Distributed under the BSD 2-Clause license.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Root element of Confluence page or blog post
+
+
+
+
+
+
+
+ Confluence macro
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Rich text body of Confluence macro. A macro can contain only one (either rich or plain) text body.
+
+
+
+
+
+
+
+ Plain text body of Confluence macro. A macro can contain only one (either rich or plain) text body.
+
+
+
+
+
+
+
+
+
+
+ Default (no name) parameter of Confluence macro. A macro can contain only one default parameter.
+
+
+
+
+
+
+
+
+ Named parameter of Confluence macro. A macro can contain many named parameters.
+
+
+
+
+
+
+
+
+
+
+
+ Image
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Link
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Link body. A link can contain only one (either rich or plain text) body.
+
+
+
+
+
+
+
+ Plain text link body. A link can contain only one (either rich or plain text) body.
+
+
+
+
+
+
+
+
+ Emoticon
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/confluence2xhtml.xsl b/confluence2xhtml.xsl
new file mode 100644
index 0000000..b4fb2fb
--- /dev/null
+++ b/confluence2xhtml.xsl
@@ -0,0 +1,151 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Confluence page
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ="
+
+
+
+
+
+ "
+
+
+
+
\ No newline at end of file
diff --git a/index.html b/index.html
new file mode 100644
index 0000000..348efc6
--- /dev/null
+++ b/index.html
@@ -0,0 +1,823 @@
+
+
+
+
+
+
+XML schema for the Confluence storage format
+
+
+
+
Edit Confluence storage format content (page source XML) in a validating XML editor
+
Validate Confluence storage format content using a validating XML parser
+
Understand the structure of the Confluence storage format
+
+
+
This repository contains:
+
+
An XML W3C Schema 1.0 document (XSD) for the Confluence storage format (actually, a set of XSDs: one for each namespace)
+
An XML document type definition (DTD) for the Confluence storage format
+
Various related sample files (including Wikifier, a web-based "Confluence XML to wiki markup" converter)
+
+
+
Support
+
This repository is developed by Graham Hannington
+(Confluence user; no other affiliation with Atlassian). Feedback welcome.
+
+
+
Disclaimer
+
This repository was developed by a Confluence user, not by Atlassian.
+
For background information about the development of this package,
+see the Feedback on Confluence Storage Format page on the Atlassian Documentation website.
The following procedure assumes that you have extracted all of the files in this package into one directory.
+
Procedure
+
+
Open the supplied file confluence-page-example.xml in your XML editor.
+
"Play" (edit the contents).
+
Explore the DTD/XSD-aware features of your XML editor, such as
+(depending on your particular editor):
+
+
Selection lists of elements that can be inserted at the current cursor position
+
Autocompletion (including automatic insertion of required elements and attributes)
+
Online documentation (gleaned from the annotations in the schema)
+
+
+
+
Editing XML copied from the Confluence Source Editor plugin
+
About this task
+
The Confluence Source Editor plugin ("advanced editor") displays the source of a page as an XML snippet:
+a collection of XML elements, without a single root element.
+
To edit the source as a document in a validating XML editor, you need to wrap the snippet in a root element.
+
This package supplies example XML documents that use the root element name ac:confluence.
+
Before you begin
+
You will need:
+
+
Confluence 4 with the Source Editor plugin ("advanced editor").
+
A validating XML editor.
+
+
Procedure
+
+
In your XML editor, open the supplied file confluence-page-template.xml.
+
In Confluence:
+
+
Edit a page (open a page in the rich text editor).
+
Open the page in the source editor.
+
Press Ctrl+A to select all of the source.
+
Press Ctrl+C to copy the source to the Clipboard.
+
+
In your XML editor:
+
+
Select the following comment:
+
+<!-- Replace this comment with your page source -->
+
+
+
Press Ctrl+V to paste the source copied from Confluence.
+
Edit the source.
+
When you have finished editing, select the source between the <ac:confluence> start tag and the </ac:confluence> end tag.
+Do not select <ac:confluence> or </ac:confluence>.
+
Copy the selected source to the Clipboard.
+
+
+
In Confluence, press Ctrl+V to paste the edited source into the Source Editor plugin, replacing the original source.
+
+
Editing XML accessed via WebDAV
+
The Confluence WebDAV plugin serves page source in the same manner as the Confluence Source Editor plugin: as an XML snippet (without a root element),
+rather than an XML document; and with the file extension .txt, rather than, say, .xml.
+
Similar to the previous procedure for working with the Confluence Source Editor plugin, you need to wrap the snippet in a root element,
+and then unwrap it before saving it back to Confluence.
This technique requires the DTD/XSDs to be in the same directory as the document (.xml).
+(You can also use relative or absolute references to another directory.)
+
However, if your XML editor supports catalogs, then your documents do not need to explicitly refer to the correct location of the DTD/XSDs.
+Instead, the XML editor uses a catalog to locate these files.
+
A catalog is a file that maps:
+
+
The formal public identifier (FPI) of a DOCTYPE to the location of the corresponding DTD
+
A namespace URI in a schemaLocation attribute to the location of the corresponding XSD
+
+
(This specific mapping behavior applies to files that you are accessing via a file system
+— which is typical of a document editing environment — rather than via the web.)
+
The supplied file confluence-page-template-for-catalog.xml is an example of a document that you can use with a catalog.
+The schemaLocation attribute is the same as before; the only difference is the DOCTYPE, which contains an FPI followed by a system identifier:
+
+<!DOCTYPE ac:confluence PUBLIC "-//Atlassian//Confluence 4 Page//EN" "http://www.atlassian.com/schema/confluence/4/confluence.dtd">
+
+
(The system identifier does not, in practice, need to point to an actual resource;
+the XML editor will, by preference, attempt to locate the DTD via the catalog, using the FPI).
+
A catalog is supplied in the file catalog.xml.
+
The method for making a catalog available to an editor depends on the particular editor.
+
Using a catalog with Altova XMLSpy
+
Edit RootCatalog.xml in the XMLSpy installation folder
+(for example, C:\Program Files\Altova\XMLSpy2012\),
+and insert the following element before
+the </catalog> end tag:
+
+<nextCatalog catalog="drive letter:/directory path to Confluence schema package/catalog.xml"/>
+
+
Restart XMLSpy.
+
Using a catalog with jEdit
+
Click Plugins ► Plugin Options... ► XML ► Catalogs, click the + (plus sign) button, and then select the supplied catalog.xml.
+
Restart jEdit.
+
Tip: In my experience, clicking ► Plugins ► XML ► Clear Resource Cache is not always effective.
+
Contents of this repository
+
+
+
File
+
Description
+
+
+
catalog.xml
+
OASIS XML catalog
+
+
+
confluence.dtd
+
Document type definition (DTD)
+
+
+
confluence.xsd
+
Master XSD (W3C XML 1.0 Schema document)
+
+
+
confluence2xhtml.xsl
+
XSLT stylesheet: transforms Confluence storage format into XHTML (more like the rich text editor display than a "preview")
+
+
+
confluence-page-example.xml
+
Example Confluence page source XML document
+
+
+
confluence-page-example-with-xslt.xml
+
Example Confluence page source XML document containing a reference to the XSLT stylesheet confluence2xhtml.xsl (tip: open this in Firefox)
+
+
+
confluence-page-example-with-xslt-wiki.xml
+
Example Confluence page source XML document containing a reference to the XSLT stylesheet wikifier/confluence2wiki.xsl (tip: open this in Firefox)
+
+
+
confluence-page-template.xml
+
Example Confluence page source XML document with empty body
+
+
+
confluence-page-template-for-catalog.xml
+
Example Confluence page source XML document for use with catalog (no explicit reference to local copy of DTD/XSD)
Wikifier is a web-based test harness for the XSLT stylesheet confluence2wiki.xsl
+(supplied in the wikifier directory)
+that transforms Confluence XML into wiki markup.
+
To convert Confluence XML to wiki markup:
+
+
Copy Confluence XML from the Confluence Source Editor plugin to your
+clipboard. (Or, equivalently, copy the Confluence XML contents of a .txt
+ file served by the Confluence WebDAV plugin.)
+
Go to the Wikifier web page.
+(Or host Wikifier on your own server, using the files supplied in the wikifier directory.)
+
+
Paste (press Ctrl+V) the Confluence XML into the text area under the "Confluence XML" heading.
+
+
To copy the wiki markup from Wikifier to your clipboard:
+
+
Select the text under the "Wiki markup" heading (tip: press Ctrl+A).
+
Copy (press Ctrl+C) the selected text to your clipboard.
+
+
Wikifier does not send your Confluence XML to a
+server; all processing of your Confluence XML is done client-side.
+
I have tested Wikifier in the following web browsers: IE9, and current
+"production" versions of Chrome, Firefox, and Safari (all on Windows).
+
Tip: Instead of using Wikifier, you can paste your XML into the supplied file
+confluence-page-example-with-xslt-wiki.xml, and then open the file in Firefox to see the converted wiki markup.
+
What Wikifier is, and is not
+
Wikifier is a minimal test harness for the XSLT stylesheet I have developed
+to convert Confluence XML to wiki markup.
+
The XSLT stylesheet is by no means complete. I welcome your feedback. If
+Wikifier does not correctly convert some Confluence XML, please let me
+know, and I will do what I can (no promises, though).
+
Wikifier is not a replacement for the Confluence 3 wiki markup editor view.
+
Wikifier is only a test harness; it is not intended to be a fully fledged
+application. The XSLT stylesheet took me about a day and a half to
+develop; same again for Wikifier (my cross-browser JavaScript coding
+skills are both rudimentary and extremely rusty!).
+
Why I developed the XSLT stylesheet
+
I developed the XSLT stylesheet for the following use case: to copy
+relatively simple content from the current version of Confluence (4) to
+the current version of JIRA (4).
+
I did not develop the XSLT stylesheet to bring wiki markup back to Confluence.
+However, if you want to, you can paste the wiki markup from Wikifier into:
+
+
Confluence 4, using the Insert ► Wiki Markup option of the rich text editor
+
Confluence 3, using the wiki markup editor view
+
+
The XSLT stylesheet could be used as the "heart" of a plugin, although I have no immediate plan to do that.
+
Round-tripping?
+
Bear in mind the following comment from Paul Curren (Atlassian):
+
+
Wiki markup can only represent a subset of what can be represented in XHTML.
+
+
What Paul says is true. For example, if you paste Confluence XML table
+markup (which is, in this specific case, XHTML markup) with merged cells
+ into Wikifier, the resulting wiki markup will retain the table cell
+contents, but will not retain the merged cell formatting.
+
Also from Paul, also true:
+
+
just about anything is possible with appropriate development effort
+
+
I can imagine that it might, perhaps, be possible to develop new
+Confluence 3 macros to match new capabilities in Confluence 4, and have
+an XSLT stylesheet transform such Confluence 4 syntax into these new
+macros (or even, say, as the contents of the existing Confluence 3 HTML
+macro). For me, though, this is a purely academic issue. I can now copy
+content from Confluence to JIRA, which is what I was after.
+
Tips
+
DTD, or XSD and DTD, but not just XSD
+
To validate Confluence page source, you need either:
+
+
The DTD (confluence.dtd, and the xhtml1-*.ent files it depends on)
+
The XSD (confluence.xsd, and the *.xsd files that it depends on) and the DTD
+
+
You cannot validate Confluence page source with only the XSD, because Confluence page source
+can contain references to character entities (for example, —) that can only be
+defined in a DTD. If you attempt to validate Confluence page source that contains character
+entity references, but you do not refer to the DTD, you will get an XML parsing error.
+
Development notes
+
Testing
+
The DTD/XSDs have been tested using the following Confluence page source:
+
+
A handful of pages that I have created myself using the Confluence rich text editor
+(designed to exercise the full range of markup that the rich text editor can generate).
+
A few hundred pages converted from Confluence 3 (with some editing in Confluence 4) on my local Confluence 4 sandbox installation.
A Confluence export consists of a .zip file containing a single entities.xml file, which contains page source inside <property name="body"> elements.
+
I wrote a script to extract the contents of these elements into individual XML files, which I then validated using a Windows batch (.bat) file that calls xmllint, like this:
+
+for %%f in ("*.xml") do "%_xmllint%" --noent --nowarning --noout --loaddtd --schema "%_schema%" "%%f" >> c:\temp\log.txt 2>&1
+
+
where:
+
+
The current directory contains the .xml files to be validated
+
The environment variable _xmllint contains the path of the xmllint executable
+
The environment variable _schema contains the path of confluence.xsd
+(xmllint does not look for schemaLocation attributes)
+
The .xml files contain the following DOCTYPE:
+
+<!DOCTYPE ac:confluence SYSTEM "confluence.dtd">
+
+
for the --loaddtd option.
+
+
+
+
Tip: The <property name="body"> elements in entities.xml wrap the page contents in a CDATA section.
+The page contents can also contain CDATA sections. However, nested CDATA sections are not allowed in XML, so, to avoid this issue,
+the ]]> terminators of the CDATA sections in the page contents contain a space (]] >). When extracting the page contents
+into individual XML files, you need to remove these spaces.
+
Coined names and identifiers (not approved by Atlassian)
+
Highlighted items in the following listing are my own coinage, not approved by Atlassian:
If Atlassian plans to publish multiple XML vocabularies for Confluence — perhaps blog posts might not have quite the same vocabulary? —
+then perhaps ac:page might be a better choice of name for this root element (more specific).
+
I used the namespace prefix ac: (coined by Atlassian: I assume, perhaps incorrectly, that this is an abbreviation of "Atlassian Confluence") for the root element, to:
+
+
Avoid coining another namespace
+
Avoid including the root element in the default namespace (that is, elements without a namespace prefix),
+because Atlassian has so far used that namespace for elements and attributes that use the same names as XHTML elements and attributes.
For the default namespace, I deliberately have not used the XHTML namespace name "http://www.w3.org/1999/xhtml".
+Elements and attributes in the Confluence storage format that have the same names as elements and attributes in XHTML do not necessarily have the same constraints
+(for example, the contexts in which elements and attributes can appear). To use the XHTML namespace for these elements and attributes would be, at best, misleading.
+
A namespace name must match the format of a URI, but there need not be an actual resource at that URI.
+I have coined URIs based on my observations of current common practice.
+
I have deliberately terminated the URIs with slashes.
+
I'm least confident about my coinage for the URI of the default namespace; specifically, the way it ends in just ".../4/" (the Confluence version),
+compared to the other two namespace URIs, ".../4/ac/" and ".../4/ri/".
+I could not think of an appropriate choice of term to describe this default namespace. ".../4/xhtml/" felt wrong to me, for reasons already described,
+but it might be justifiable, as long as it is interpreted as "elements and attributes with the same names as XHTML elements and attributes", as opposed to "XHTML".
+
+
Known issues
+
General
+
+
When using xmllint, you must specify the --nowarning option to suppress warnings about loading a schema that has already been loaded. Suggestions welcome.
+
+
Wikifier
+
+
In browsers except IE, Wikifier supports only a very limited set of
+character entity references. I might fix this later, if there's demand.
+
Wikifier shouldn't, but currently does, allow text directly under the "root"
+level without an enclosing XML element. For example, Wikifier allows
+"illegal text":
+<p>Text inside a paragraph element.</p>
+illegal text
+
+
+
+
+
To do
+
No promises, but here's what I have in mind:
+
+
Refine the DTD/XSD constraints based on responses from Atlassian to the questions that I have asked on the
+Confluence Storage Format page
+
Enhance the annotations in the schema
+
+
+
Acknowledgements
+
I wish to thank the following people for their assistance and/or encouragement in developing this package:
+
+
Shannon Greywalker (Confluence user)
+
I only know Shannon through comments on the Confluence website. What Shannon writes is worth reading.
+
Sarah Maddox (Atlassian)
+
Sarah pointed me to the exported Confluence Documentation that Atlassian makes available for download, and
+gave me tips on finding the page source inside. That source was a valuable bucket of test cases for developing the DTD/XSDs.
+
Other Atlassians (in particular, Paul Curren)
+
Thank you for taking the time to respond to my comments openly, positively, and constructively. It's sincerely appreciated.
+
+
Change log
+
Most recent changes first:
+
+
+
Date yyyy-mm-dd
+
Description
+
+
+
2024-09-26
+
Stored these files in GitHub, published as a GitHub Pages site.
+
+
+
2012-06-06
+
Prettified this readme.
+
+
+
2012-05-01
+
+
+
Added a license statement
+
Added source files for Wikifier (in the wikifier subdirectory), which converts Confluence XML to wiki markup
+
Added confluence-page-example-with-xslt-wiki.xml (open this in Firefox to see its Confluence XML converted to wiki markup)
+
+
+
+
+
2012-04-23
+
+
+
Corrected catalog-related tips in this readme
+
Refined DTD comments after testing with the Eclipse XML editor
Refined DTD after testing against Atlassian's own Confluence Documentation source
+
Added XSD (constraints match DTD, as far as possible)
+
Added catalog and related sample files
+
+
+
+
+
2012-04-13
+
+
+
Refined DTD after further experimentation to see what markup the rich text editor can create
+
Added example Confluence page source file (containing a variety of markup; open this in your favorite validating XML editor), with a variant that refers to an XSLT stylesheet (below)
+
Added "Confluence to XHTML" XSLT stylesheet (confluence2xhtml.xsl)
+
+
+
+
+
2012-04-12
+
First draft of DTD.
+
+
+
License
+
This package and its contents are distributed under the BSD 2-Clause license (also known as the Simplified BSD license):
Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+
Redistributions of source code must retain the above copyright notice,
+this list of conditions and the following disclaimer.
+
Redistributions in binary form must reproduce the above copyright notice,
+this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ Note that local names in this namespace are intended to be
+ defined only by the World Wide Web Consortium or its subgroups.
+ The names currently defined in this namespace are listed below.
+ They should not be used with conflicting semantics by any Working
+ Group, specification, or document instance.
+
+ denotes an attribute whose value
+ is a language code for the natural language of the content of
+ any element; its value is inherited. This name is reserved
+ by virtue of its definition in the XML specification.
+
+
+
+
Notes
+
+ Attempting to install the relevant ISO 2- and 3-letter
+ codes as the enumerated possible values is probably never
+ going to be a realistic possibility.
+
+ The union allows for the 'un-declaration' of xml:lang with
+ the empty string.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
space (as an attribute name)
+
+ denotes an attribute whose
+ value is a keyword indicating what whitespace processing
+ discipline is intended for the content of the element; its
+ value is inherited. This name is reserved by virtue of its
+ definition in the XML specification.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
base (as an attribute name)
+
+ denotes an attribute whose value
+ provides a URI to be used as the base for interpreting any
+ relative URIs in the scope of the element on which it
+ appears; its value is inherited. This name is reserved
+ by virtue of its definition in the XML Base specification.
+ denotes an attribute whose value
+ should be interpreted as if declared to be of type ID.
+ This name is reserved by virtue of its definition in the
+ xml:id specification.
+ denotes Jon Bosak, the chair of
+ the original XML Working Group. This name is reserved by
+ the following decision of the W3C XML Plenary and
+ XML Coordination groups:
+
+
+
+ In appreciation for his vision, leadership and
+ dedication the W3C XML Plenary on this 10th day of
+ February, 2000, reserves for Jon Bosak in perpetuity
+ the XML name "xml:Father".
+
+ This schema defines attributes and an attribute group suitable
+ for use by schemas wishing to allow xml:base,
+ xml:lang, xml:space or
+ xml:id attributes on elements they define.
+
+
+ To enable this, such a schema must import this schema for
+ the XML namespace, e.g. as follows:
+
+ The schema document at that URI may however change in the future,
+ in order to remain compatible with the latest version of XML
+ Schema itself, or with the XML namespace itself. In other words,
+ if the XML Schema or XML namespaces change, the version of this
+ document at
+ http://www.w3.org/2001/xml.xsd
+
+ will change accordingly; the version at
+
+ http://www.w3.org/2009/01/xml.xsd
+
+ will not change.
+
+
+ Previous dated (and unchanging) versions of this schema
+ document are at:
+