Task: applying a creative commons license to an OMDoc file

The goal of this task is to choose a creative-commons license then apply it in the OMDoc file using jEditOQMath.

Prerequisite

create-a-collection

Applications That Should be Running

jEditOQMath, ActiveMath, web-browser

Task description

• we first identify the URL to the appropriate license description, here is how to obtain a Creative Commons Attribution Sharealike, my recommendation for re-usable shared content:
  • using your web-browser go to creative-commons.org
  • click license your work
  • you should land on a page in (one of) the language(s) of your country
  • choose the options that you wish apply to your license. For the license above, choose allow commercial usage and allow modifications as long as published under the same license
  • press choose license
  • you should obtain a page with advice on how to embed the license in several document formats
  • there should also be a link see how the license will look which is a link to a human-readable description of the license, linked to a legally formal text, copy that link. In my case, it was http://creativecommons.org/licenses/by-sa/2.0/de/
• we now apply this license to the complete omdoc element in the file first.oqmath that we created while starting a collection:
  • in jEditOQMath, open the file first.oqmath
  • near the top, find the opening tag <omdoc> (which could have an id attribute maybe)
  • shortly below, an opening tag <metadata> should appear which, typically, contains Title and Contributor elements. Insert an empty line before the </metadata> closing tag.
  • insert then, the element Rights with a content as follows:

-

<Rights>Distributed under the license
    <omlet type="hyperlink" 
     data="http://creativecommons.org/licenses/by-sa/2.0/de/">Creative`
        Commons Attribution Share-alike</omlet>.
  </Rights>

• -
  • save the file (C-S), select the AntFarm Tab on the left, find the appropriate build-file of your collection, double-click it (or select it and press the running man)
  • wait till the console pane which appeared on the bottom of the window tells you BUILD SUCCESSFUL
• we now observe how, in ActiveMath, this license grant can be seen:
  • go, with your web-browser, to your ActiveMath
  • open the book of your collection, find the page that has been produced by first.oqmath (typically, My first OMDoc)
  • click the title of any item of this page, the Item menu appears
  • choose See copyright statement (or See contributors)
  • a little window should pop-up with the text that we have put inside the Rights element
  • the text of the license title should be clickable… to the human-readable license