<?xml version="1.0" encoding="utf-8"?>
<article version="5.0" xml:lang="en"
	 xmlns="http://docbook.org/ns/docbook"
	 xmlns:xi="http://www.w3.org/2001/XInclude"
	 xmlns:xlink="http://www.w3.org/1999/xlink">
  <info>
    <title>A Creative Commons Licenced Docbook Article</title>
    <titleabbrev>CC Docbook</titleabbrev>
    <author>
      <personname>
	<firstname>Fredrik</firstname>
	<surname>Unger</surname>
      </personname>
    </author>
    <pubdate>2011-02-17</pubdate>
    <copyright>
      <year>2011</year>
      <holder xlink:href="http://article.tree.se/tools/docbook/cc">Fredrik Unger</holder>
      <holder xlink:href="http://article.tree.se/tools/docbook/cc">John Smith</holder>
      <license  type="cc by" v="2.5" jurisdiction="se" />
      <license  type="cl" xlink:href="http://article.tree.se/license">Tree.se License</license>
    </copyright>
  </info>
  <para>
    This documents try to inclue ways to express the copyright license
    of the document and the document objects using the Creative Commons
    licences. It tries to expand the copyright tag in a natural way
    and provide expected output via an xsl stylsheet extention.
  </para>
  <para>
    Many documents online created with docbook is using Creative
    Commons license.  To simplify its use, CC licensing, and inclusion
    of images etc would maybe increase the use of the license.
  </para>
  <section><title>Including an image in the document</title>
  <mediaobject>
    <imageobject>
      <info>
	<copyright>
	  <year>2011</year>
	  <holder xlink:href="http://article.tree.se/tools/docbook/line.png">Fredrik Unger</holder>
	  <license type="cc by" v="3.0" jurisdiction="us" />
	</copyright>
      </info>
      <imagedata fileref="line.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>A black line</phrase>
    </textobject>
    <caption>
      <para>
	A black line
      </para>
    </caption>
  </mediaobject>
  <para>
    The document <link xlink:href="cc.en.xml">cc.en.xml</link> is the
    source for document <link xlink:href="cc.html">cc.html</link>
    generated with the <link xlink:href="cc.xsl">cc.xsl</link>
    extention stylesheet. To accomodate this change in the content
    model the <link xlink:href="cc.rnc">cc.rnc</link> was used to
    validate the document. The changes were devloped under Debian and
    the Docbook distribution stylesheets and schema files are read
    from the default location. A <link
    xlink:href="Makefile">Makefile</link> is provided to generate the
    documents included in this distribution.
  </para>
  <para>
    The original <link
    xlink:href="http://www.docbook.org/tdg5/en/html/copyright.html">copyright
    content model</link> includes only <tag>holder</tag> and
    <tag>year</tag>.  The creative commons expresses other information
    important to the copyright as well.
  </para>
  <para>
    To properly accomodate creative commons the tag <tag>license</tag>
    was added.  The optional information to the licence which can be
    provided in the <link
    xlink:href="http://creativecommons.org/choose/">CC licence
    tool</link> were added using the <tag>holder</tag> element.  An
    extra element might be needed to separate the holder from the CC
    attribute output. Or maybe the stylesheet can be changed to know
    the difference.
  </para>
  <para>
    There are also licence information that can be taken from the <link
    xlink:href="http://creativecommons.org/publicdomain/">Public
    domain tool</link> and <link
    xlink:href="http://creativecommons.org/choose/zero/">CC0
    tool</link>. Also the the ability to keep some rights were taken
    into account with the <link
    xlink:href="http://wiki.creativecommons.org/CCPlus">CC+</link>
    licence.
  </para>
  <para>
    The <link
    xlink:href="http://wiki.creativecommons.org/Marking">markup
    suggestions</link> can be used as a guideline in designing the
    docbook output.
  </para>
  </section>
  <section><title>Future work</title>
  <para>
    This is an initial attempt to accomodate Creative Commons and
    other licenses in Docbook, using a method that will produce the
    needed output independent of target, including the known CC
    graphics.
  </para>
  </section>
</article>
