incubator-odf-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r1010270 [12/13] - in /websites/staging/odftoolkit/trunk/content: ./ odftoolkit/ odftoolkit/GSoC/ odftoolkit/docs/ odftoolkit/docs/governance/ odftoolkit/odfdom/ odftoolkit/simple/ odftoolkit/simple/demo/ odftoolkit/simple/document/ odftool...
Date Tue, 11 Apr 2017 23:13:31 GMT
Modified: websites/staging/odftoolkit/trunk/content/odftoolkit/simple/gettingstartguide.html
==============================================================================
--- websites/staging/odftoolkit/trunk/content/odftoolkit/simple/gettingstartguide.html (original)
+++ websites/staging/odftoolkit/trunk/content/odftoolkit/simple/gettingstartguide.html Tue Apr 11 23:13:30 2017
@@ -50,7 +50,18 @@
   <div id="clear"></div>
   
   <div id="sidenav">
-    <h1 id="general">General</h1>
+    <style type="text/css">
+/* The following code is added by mdx_elementid.py
+   It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+  visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<h1 id="general">General<a class="headerlink" href="#general" title="Permanent link">&para;</a></h1>
 <ul>
 <li><a href="/odftoolkit/index.html">About</a></li>
 <li><a href="/odftoolkit/downloads.html">Downloads</a></li>
@@ -58,21 +69,21 @@
 <li><a href="/odftoolkit/license.html">License</a></li>
 <li><a href="/odftoolkit/privacy.html">Privacy Policy</a></li>
 </ul>
-<h1 id="components">Components</h1>
+<h1 id="components">Components<a class="headerlink" href="#components" title="Permanent link">&para;</a></h1>
 <ul>
 <li><a href="/odftoolkit/odfdom/index.html">ODFDOM</a></li>
 <li><a href="/odftoolkit/simple/index.html">Simple API</a></li>
 <li><a href="/odftoolkit/conformance/ODFValidator.html">ODF Validator</a></li>
 <li><a href="/odftoolkit/xsltrunner/ODFXSLTRunner.html">XSLT Runner</a></li>
 </ul>
-<h1 id="community">Community</h1>
+<h1 id="community">Community<a class="headerlink" href="#community" title="Permanent link">&para;</a></h1>
 <ul>
 <li><a href="/odftoolkit/get-involved.html">Get Involved</a></li>
 <li><a href="/odftoolkit/mailing-lists.html">Mailing Lists</a></li>
 <li><a href="/odftoolkit/people.html">People</a></li>
 <li><a href="/odftoolkit/community-faqs.html">Community FAQs</a></li>
 </ul>
-<h1 id="development">Development</h1>
+<h1 id="development">Development<a class="headerlink" href="#development" title="Permanent link">&para;</a></h1>
 <ul>
 <li><a href="/odftoolkit/source.html">Source Code</a></li>
 <li><a href="https://issues.apache.org/jira/browse/ODFTOOLKIT">Bug Tracker</a></li>
@@ -80,13 +91,12 @@
 <li><a href="/odftoolkit/website-local.html">Website</a></li>
 <li><a href="/odftoolkit/developer-faqs.html">Developer FAQs</a></li>
 </ul>
-<h1 id="ppmc">PPMC</h1>
+<h1 id="ppmc">PPMC<a class="headerlink" href="#ppmc" title="Permanent link">&para;</a></h1>
 <ul>
 <li><a href="/odftoolkit/ppmc-faqs.html">PPMC FAQs</a></li>
-<li><a href="/odftoolkit/odftoolkit-release-guide.html">Release Guide</a> <br />
-</li>
+<li><a href="/odftoolkit/odftoolkit-release-guide.html">Release Guide</a>   </li>
 </ul>
-<h1 id="asf">ASF</h1>
+<h1 id="asf">ASF<a class="headerlink" href="#asf" title="Permanent link">&para;</a></h1>
 <ul>
 <li><a href="http://www.apache.org">Apache Software Foundation</a></li>
 <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
@@ -96,7 +106,18 @@
   <div id="contenta">
   
     
-    <h2 id="getting-start-guide"><strong>Getting Start Guide</strong></h2>
+    <style type="text/css">
+/* The following code is added by mdx_elementid.py
+   It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+  visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<h2 id="getting-start-guide"><strong>Getting Start Guide</strong><a class="headerlink" href="#getting-start-guide" title="Permanent link">&para;</a></h2>
 <p>This start guide shows how to use the Simple ODF API to create a text document with image, paragraph, list and table in OpenDocument format (ODF). In about 40 lines of code, you will be able to produce an OpenDocument Format text document named HelloWorld.odt that looks like this:</p>
 <p><img alt="demo file" src="helloworld.png" /></p>
 <p><strong>Prerequisites</strong></p>
@@ -111,39 +132,39 @@
 <p>In addition, you need to download <a href="helloworld.zip">the resource file</a> of this demo.</p>
 <p><strong>Code</strong></p>
 <p>We write all of the code needed to create the document in the HelloWorld class. For simplicity, the code is wrapped in main method directly, package declaration is omitted and hard code is also included in this program. </p>
-<div class="codehilite"><pre><span class="nb">import</span> <span class="n">java</span><span class="o">.</span><span class="n">net</span><span class="o">.</span><span class="n">URI</span><span class="p">;</span>
+<div class="codehilite"><pre><span class="n">import</span> <span class="n">java</span><span class="p">.</span><span class="n">net</span><span class="p">.</span><span class="n">URI</span><span class="p">;</span>
 
-<span class="nb">import</span> <span class="n">org</span><span class="o">.</span><span class="n">odftoolkit</span><span class="o">.</span><span class="n">simple</span><span class="o">.</span><span class="n">TextDocument</span><span class="p">;</span>
-<span class="nb">import</span> <span class="n">org</span><span class="o">.</span><span class="n">odftoolkit</span><span class="o">.</span><span class="n">simple</span><span class="o">.</span><span class="n">table</span><span class="o">.</span><span class="n">Cell</span><span class="p">;</span>
-<span class="nb">import</span> <span class="n">org</span><span class="o">.</span><span class="n">odftoolkit</span><span class="o">.</span><span class="n">simple</span><span class="o">.</span><span class="n">table</span><span class="o">.</span><span class="n">Table</span><span class="p">;</span>
-<span class="nb">import</span> <span class="n">org</span><span class="o">.</span><span class="n">odftoolkit</span><span class="o">.</span><span class="n">simple</span><span class="o">.</span><span class="n">text</span><span class="o">.</span><span class="n">list</span><span class="o">.</span><span class="n">List</span><span class="p">;</span>
+<span class="n">import</span> <span class="n">org</span><span class="p">.</span><span class="n">odftoolkit</span><span class="p">.</span><span class="n">simple</span><span class="p">.</span><span class="n">TextDocument</span><span class="p">;</span>
+<span class="n">import</span> <span class="n">org</span><span class="p">.</span><span class="n">odftoolkit</span><span class="p">.</span><span class="n">simple</span><span class="p">.</span><span class="n">table</span><span class="p">.</span><span class="n">Cell</span><span class="p">;</span>
+<span class="n">import</span> <span class="n">org</span><span class="p">.</span><span class="n">odftoolkit</span><span class="p">.</span><span class="n">simple</span><span class="p">.</span><span class="n">table</span><span class="p">.</span><span class="n">Table</span><span class="p">;</span>
+<span class="n">import</span> <span class="n">org</span><span class="p">.</span><span class="n">odftoolkit</span><span class="p">.</span><span class="n">simple</span><span class="p">.</span><span class="n">text</span><span class="p">.</span><span class="n">list</span><span class="p">.</span><span class="n">List</span><span class="p">;</span>
 
 <span class="n">public</span> <span class="n">class</span> <span class="n">HelloWorld</span> <span class="p">{</span>
-    <span class="n">public</span> <span class="n">static</span> <span class="n">void</span> <span class="n">main</span><span class="p">(</span><span class="n">String</span><span class="o">[]</span> <span class="n">args</span><span class="p">)</span> <span class="p">{</span>
+    <span class="n">public</span> <span class="n">static</span> <span class="n">void</span> <span class="n">main</span><span class="p">(</span><span class="n">String</span><span class="p">[]</span> <span class="n">args</span><span class="p">)</span> <span class="p">{</span>
         <span class="n">TextDocument</span> <span class="n">outputOdt</span><span class="p">;</span>
-        <span class="n">try</span> <span class="p">{</span>
-            <span class="n">outputOdt</span> <span class="o">=</span> <span class="n">TextDocument</span><span class="o">.</span><span class="n">newTextDocument</span><span class="p">();</span>
+        <span class="k">try</span> <span class="p">{</span>
+            <span class="n">outputOdt</span> <span class="p">=</span> <span class="n">TextDocument</span><span class="p">.</span><span class="n">newTextDocument</span><span class="p">();</span>
 
-            <span class="sr">//</span> <span class="n">add</span> <span class="n">image</span>
-            <span class="n">outputOdt</span><span class="o">.</span><span class="n">newImage</span><span class="p">(</span><span class="k">new</span> <span class="n">URI</span><span class="p">(</span><span class="s">&quot;odf-logo.png&quot;</span><span class="p">));</span>
+            <span class="o">//</span> <span class="n">add</span> <span class="n">image</span>
+            <span class="n">outputOdt</span><span class="p">.</span><span class="n">newImage</span><span class="p">(</span><span class="n">new</span> <span class="n">URI</span><span class="p">(</span>&quot;<span class="n">odf</span><span class="o">-</span><span class="n">logo</span><span class="p">.</span><span class="n">png</span>&quot;<span class="p">));</span>
 
-            <span class="sr">//</span> <span class="n">add</span> <span class="n">paragraph</span>
-            <span class="n">outputOdt</span><span class="o">.</span><span class="n">addParagraph</span><span class="p">(</span><span class="s">&quot;Hello World, Hello Simple ODF!&quot;</span><span class="p">);</span>
+            <span class="o">//</span> <span class="n">add</span> <span class="n">paragraph</span>
+            <span class="n">outputOdt</span><span class="p">.</span><span class="n">addParagraph</span><span class="p">(</span>&quot;<span class="n">Hello</span> <span class="n">World</span><span class="p">,</span> <span class="n">Hello</span> <span class="n">Simple</span> <span class="n">ODF</span>!&quot;<span class="p">);</span>
 
-            <span class="sr">//</span> <span class="n">add</span> <span class="n">list</span>
-            <span class="n">outputOdt</span><span class="o">.</span><span class="n">addParagraph</span><span class="p">(</span><span class="s">&quot;The following is a list.&quot;</span><span class="p">);</span>
-            <span class="n">List</span> <span class="n">list</span> <span class="o">=</span> <span class="n">outputOdt</span><span class="o">.</span><span class="n">addList</span><span class="p">();</span>
-            <span class="n">String</span><span class="o">[]</span> <span class="n">items</span> <span class="o">=</span> <span class="p">{</span><span class="s">&quot;item1&quot;</span><span class="p">,</span> <span class="s">&quot;item2&quot;</span><span class="p">,</span> <span class="s">&quot;item3&quot;</span><span class="p">};</span>
-            <span class="n">list</span><span class="o">.</span><span class="n">addItems</span><span class="p">(</span><span class="n">items</span><span class="p">);</span>
-
-            <span class="sr">//</span> <span class="n">add</span> <span class="n">table</span>
-            <span class="n">Table</span> <span class="n">table</span> <span class="o">=</span> <span class="n">outputOdt</span><span class="o">.</span><span class="n">addTable</span><span class="p">(</span><span class="mi">2</span><span class="p">,</span> <span class="mi">2</span><span class="p">);</span>
-            <span class="n">Cell</span> <span class="n">cell</span> <span class="o">=</span> <span class="n">table</span><span class="o">.</span><span class="n">getCellByPosition</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">);</span>
-            <span class="n">cell</span><span class="o">.</span><span class="n">setStringValue</span><span class="p">(</span><span class="s">&quot;Hello World!&quot;</span><span class="p">);</span>
-
-            <span class="n">outputOdt</span><span class="o">.</span><span class="n">save</span><span class="p">(</span><span class="s">&quot;HelloWorld.odt&quot;</span><span class="p">);</span>
-        <span class="p">}</span> <span class="n">catch</span> <span class="p">(</span><span class="n">Exception</span> <span class="n">e</span><span class="p">)</span> <span class="p">{</span>
-            <span class="n">System</span><span class="o">.</span><span class="n">err</span><span class="o">.</span><span class="n">println</span><span class="p">(</span><span class="s">&quot;ERROR: unable to create output file.&quot;</span><span class="p">);</span>
+            <span class="o">//</span> <span class="n">add</span> <span class="n">list</span>
+            <span class="n">outputOdt</span><span class="p">.</span><span class="n">addParagraph</span><span class="p">(</span>&quot;<span class="n">The</span> <span class="n">following</span> <span class="n">is</span> <span class="n">a</span> <span class="n">list</span><span class="p">.</span>&quot;<span class="p">);</span>
+            <span class="n">List</span> <span class="n">list</span> <span class="p">=</span> <span class="n">outputOdt</span><span class="p">.</span><span class="n">addList</span><span class="p">();</span>
+            <span class="n">String</span><span class="p">[]</span> <span class="n">items</span> <span class="p">=</span> <span class="p">{</span>&quot;<span class="n">item1</span>&quot;<span class="p">,</span> &quot;<span class="n">item2</span>&quot;<span class="p">,</span> &quot;<span class="n">item3</span>&quot;<span class="p">};</span>
+            <span class="n">list</span><span class="p">.</span><span class="n">addItems</span><span class="p">(</span><span class="n">items</span><span class="p">);</span>
+
+            <span class="o">//</span> <span class="n">add</span> <span class="n">table</span>
+            <span class="n">Table</span> <span class="n">table</span> <span class="p">=</span> <span class="n">outputOdt</span><span class="p">.</span><span class="n">addTable</span><span class="p">(</span>2<span class="p">,</span> 2<span class="p">);</span>
+            <span class="n">Cell</span> <span class="n">cell</span> <span class="p">=</span> <span class="n">table</span><span class="p">.</span><span class="n">getCellByPosition</span><span class="p">(</span>0<span class="p">,</span> 0<span class="p">);</span>
+            <span class="n">cell</span><span class="p">.</span><span class="n">setStringValue</span><span class="p">(</span>&quot;<span class="n">Hello</span> <span class="n">World</span>!&quot;<span class="p">);</span>
+
+            <span class="n">outputOdt</span><span class="p">.</span><span class="n">save</span><span class="p">(</span>&quot;<span class="n">HelloWorld</span><span class="p">.</span><span class="n">odt</span>&quot;<span class="p">);</span>
+        <span class="p">}</span> <span class="k">catch</span> <span class="p">(</span><span class="n">Exception</span> <span class="n">e</span><span class="p">)</span> <span class="p">{</span>
+            <span class="n">System</span><span class="p">.</span><span class="n">err</span><span class="p">.</span><span class="n">println</span><span class="p">(</span>&quot;<span class="n">ERROR</span><span class="p">:</span> <span class="n">unable</span> <span class="n">to</span> <span class="n">create</span> <span class="n">output</span> <span class="n">file</span><span class="p">.</span>&quot;<span class="p">);</span>
         <span class="p">}</span>
     <span class="p">}</span>
 <span class="p">}</span>
@@ -151,25 +172,25 @@
 
 
 <p>The TextDocument class has these convenient methods: </p>
-<div class="codehilite"><pre>    <span class="sr">//</span> <span class="n">Creates</span> <span class="n">a</span> <span class="k">new</span> <span class="n">text</span> <span class="n">document</span> <span class="n">that</span> <span class="n">contains</span> <span class="n">an</span> <span class="n">empty</span> <span class="n">paragraph</span><span class="o">.</span>
-    <span class="n">TextDocument</span><span class="o">.</span><span class="n">newTextDocument</span><span class="p">();</span>
-    <span class="sr">//</span> <span class="n">Puts</span> <span class="n">the</span> <span class="n">image</span> <span class="n">at</span> <span class="n">the</span> <span class="n">given</span> <span class="n">location</span> <span class="n">at</span> <span class="n">the</span> <span class="n">end</span> <span class="n">of</span> <span class="n">the</span> <span class="n">document</span><span class="o">.</span>
-    <span class="n">TextDocument</span><span class="o">.</span><span class="n">newImage</span><span class="p">(</span><span class="n">URI</span> <span class="n">location</span><span class="p">)</span>
-    <span class="sr">//</span> <span class="n">Creates</span> <span class="n">a</span> <span class="k">new</span> <span class="n">paragraph</span> <span class="n">with</span> <span class="n">the</span> <span class="n">given</span> <span class="n">content</span> <span class="ow">and</span> <span class="n">appends</span> <span class="n">it</span> <span class="n">to</span> <span class="n">the</span> <span class="n">end</span> <span class="n">of</span> <span class="n">the</span> <span class="n">document</span><span class="o">.</span>
-    <span class="n">TextDocument</span><span class="o">.</span><span class="n">addParagraph</span><span class="p">(</span><span class="n">String</span> <span class="n">content</span><span class="p">)</span>
-    <span class="sr">//</span> <span class="n">Creates</span> <span class="n">a</span> <span class="k">new</span><span class="p">,</span> <span class="n">empty</span> <span class="n">list</span> <span class="ow">and</span> <span class="n">appends</span> <span class="n">it</span> <span class="n">to</span> <span class="n">the</span> <span class="n">end</span> <span class="n">of</span> <span class="n">the</span> <span class="n">document</span> <span class="n">you</span><span class="err">&#39;</span><span class="n">re</span> <span class="n">building</span><span class="o">.</span> <span class="n">You</span> <span class="n">can</span> <span class="n">add</span> <span class="n">items</span> <span class="k">for</span> <span class="n">this</span> <span class="n">list</span><span class="o">.</span>
-    <span class="n">TextDocument</span><span class="o">.</span><span class="n">addList</span><span class="p">()</span>
-    <span class="sr">//</span> <span class="n">Creates</span> <span class="n">a</span> <span class="k">new</span> <span class="n">table</span> <span class="n">with</span> <span class="n">columnCount</span> <span class="n">columns</span> <span class="ow">and</span> <span class="n">rowCount</span> <span class="n">rows</span><span class="o">.</span> <span class="n">You</span> <span class="n">can</span> <span class="n">get</span> <span class="n">the</span> <span class="n">cell</span> <span class="n">at</span> <span class="n">given</span> <span class="n">position</span> <span class="ow">and</span> <span class="n">set</span> <span class="n">its</span> <span class="n">content</span><span class="o">.</span>
-    <span class="n">TextDocument</span><span class="o">.</span><span class="n">addTable</span><span class="p">(</span><span class="nb">int</span> <span class="n">columnCount</span><span class="p">,</span> <span class="nb">int</span> <span class="n">rowCount</span><span class="p">);</span>
-    <span class="sr">//</span> <span class="n">Saves</span> <span class="n">the</span> <span class="n">document</span> <span class="n">at</span> <span class="n">the</span> <span class="n">given</span> <span class="n">path</span><span class="o">.</span> 
-    <span class="n">TextDocument</span><span class="o">.</span><span class="n">save</span><span class="p">(</span><span class="n">String</span> <span class="n">path</span><span class="p">)</span>
+<div class="codehilite"><pre>    <span class="o">//</span> <span class="n">Creates</span> <span class="n">a</span> <span class="n">new</span> <span class="n">text</span> <span class="n">document</span> <span class="n">that</span> <span class="n">contains</span> <span class="n">an</span> <span class="n">empty</span> <span class="n">paragraph</span><span class="p">.</span>
+    <span class="n">TextDocument</span><span class="p">.</span><span class="n">newTextDocument</span><span class="p">();</span>
+    <span class="o">//</span> <span class="n">Puts</span> <span class="n">the</span> <span class="n">image</span> <span class="n">at</span> <span class="n">the</span> <span class="n">given</span> <span class="n">location</span> <span class="n">at</span> <span class="n">the</span> <span class="k">end</span> <span class="n">of</span> <span class="n">the</span> <span class="n">document</span><span class="p">.</span>
+    <span class="n">TextDocument</span><span class="p">.</span><span class="n">newImage</span><span class="p">(</span><span class="n">URI</span> <span class="n">location</span><span class="p">)</span>
+    <span class="o">//</span> <span class="n">Creates</span> <span class="n">a</span> <span class="n">new</span> <span class="n">paragraph</span> <span class="n">with</span> <span class="n">the</span> <span class="n">given</span> <span class="n">content</span> <span class="n">and</span> <span class="n">appends</span> <span class="n">it</span> <span class="n">to</span> <span class="n">the</span> <span class="k">end</span> <span class="n">of</span> <span class="n">the</span> <span class="n">document</span><span class="p">.</span>
+    <span class="n">TextDocument</span><span class="p">.</span><span class="n">addParagraph</span><span class="p">(</span><span class="n">String</span> <span class="n">content</span><span class="p">)</span>
+    <span class="o">//</span> <span class="n">Creates</span> <span class="n">a</span> <span class="n">new</span><span class="p">,</span> <span class="n">empty</span> <span class="n">list</span> <span class="n">and</span> <span class="n">appends</span> <span class="n">it</span> <span class="n">to</span> <span class="n">the</span> <span class="k">end</span> <span class="n">of</span> <span class="n">the</span> <span class="n">document</span> <span class="n">you</span><span class="o">&#39;</span><span class="n">re</span> <span class="n">building</span><span class="p">.</span> <span class="n">You</span> <span class="n">can</span> <span class="n">add</span> <span class="n">items</span> <span class="k">for</span> <span class="n">this</span> <span class="n">list</span><span class="p">.</span>
+    <span class="n">TextDocument</span><span class="p">.</span><span class="n">addList</span><span class="p">()</span>
+    <span class="o">//</span> <span class="n">Creates</span> <span class="n">a</span> <span class="n">new</span> <span class="n">table</span> <span class="n">with</span> <span class="n">columnCount</span> <span class="n">columns</span> <span class="n">and</span> <span class="n">rowCount</span> <span class="n">rows</span><span class="p">.</span> <span class="n">You</span> <span class="n">can</span> <span class="n">get</span> <span class="n">the</span> <span class="n">cell</span> <span class="n">at</span> <span class="n">given</span> <span class="n">position</span> <span class="n">and</span> <span class="n">set</span> <span class="n">its</span> <span class="n">content</span><span class="p">.</span>
+    <span class="n">TextDocument</span><span class="p">.</span><span class="n">addTable</span><span class="p">(</span><span class="n">int</span> <span class="n">columnCount</span><span class="p">,</span> <span class="n">int</span> <span class="n">rowCount</span><span class="p">);</span>
+    <span class="o">//</span> <span class="n">Saves</span> <span class="n">the</span> <span class="n">document</span> <span class="n">at</span> <span class="n">the</span> <span class="n">given</span> <span class="n">path</span><span class="p">.</span> 
+    <span class="n">TextDocument</span><span class="p">.</span><span class="n">save</span><span class="p">(</span><span class="n">String</span> <span class="n">path</span><span class="p">)</span>
 </pre></div>
 
 
 <p><strong>Building and Running</strong></p>
 <p>If you use Eclipse, you can just run this class as a Java Application. If you use command line, please complie code and run it with the following commands:</p>
-<div class="codehilite"><pre><span class="n">javac</span> <span class="o">-</span><span class="n">cp</span> <span class="n">lib</span><span class="sr">/odfdom-java-0.8.7.jar:lib/sim</span><span class="n">ple</span><span class="o">-</span><span class="n">odf</span><span class="o">-</span><span class="mf">0.6.6</span><span class="o">.</span><span class="n">jar</span> <span class="n">HelloWorld</span><span class="o">.</span><span class="n">java</span>
-<span class="n">java</span> <span class="o">-</span><span class="n">cp</span> <span class="n">lib</span><span class="sr">/odfdom-java-0.8.7.jar:lib/sim</span><span class="n">ple</span><span class="o">-</span><span class="n">odf</span><span class="o">-</span><span class="mf">0.6.6</span><span class="o">.</span><span class="n">jar:lib</span><span class="o">/</span><span class="n">xercesImpl</span><span class="o">.</span><span class="n">jar:</span><span class="o">.</span> <span class="n">HelloWorld</span>
+<div class="codehilite"><pre><span class="n">javac</span> <span class="o">-</span><span class="n">cp</span> <span class="n">lib</span><span class="o">/</span><span class="n">odfdom</span><span class="o">-</span><span class="n">java</span><span class="o">-</span>0<span class="p">.</span>8<span class="p">.</span>7<span class="p">.</span><span class="n">jar</span><span class="p">:</span><span class="n">lib</span><span class="o">/</span><span class="n">simple</span><span class="o">-</span><span class="n">odf</span><span class="o">-</span>0<span class="p">.</span>6<span class="p">.</span>6<span class="p">.</span><span class="n">jar</span> <span class="n">HelloWorld</span><span class="p">.</span><span class="n">java</span>
+<span class="n">java</span> <span class="o">-</span><span class="n">cp</span> <span class="n">lib</span><span class="o">/</span><span class="n">odfdom</span><span class="o">-</span><span class="n">java</span><span class="o">-</span>0<span class="p">.</span>8<span class="p">.</span>7<span class="p">.</span><span class="n">jar</span><span class="p">:</span><span class="n">lib</span><span class="o">/</span><span class="n">simple</span><span class="o">-</span><span class="n">odf</span><span class="o">-</span>0<span class="p">.</span>6<span class="p">.</span>6<span class="p">.</span><span class="n">jar</span><span class="p">:</span><span class="n">lib</span><span class="o">/</span><span class="n">xercesImpl</span><span class="p">.</span><span class="n">jar</span><span class="p">:.</span> <span class="n">HelloWorld</span>
 </pre></div>
 
 

Modified: websites/staging/odftoolkit/trunk/content/odftoolkit/svn-basics.html
==============================================================================
--- websites/staging/odftoolkit/trunk/content/odftoolkit/svn-basics.html (original)
+++ websites/staging/odftoolkit/trunk/content/odftoolkit/svn-basics.html Tue Apr 11 23:13:30 2017
@@ -50,7 +50,18 @@
   <div id="clear"></div>
   
   <div id="sidenav">
-    <h1 id="general">General</h1>
+    <style type="text/css">
+/* The following code is added by mdx_elementid.py
+   It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+  visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<h1 id="general">General<a class="headerlink" href="#general" title="Permanent link">&para;</a></h1>
 <ul>
 <li><a href="/odftoolkit/index.html">About</a></li>
 <li><a href="/odftoolkit/downloads.html">Downloads</a></li>
@@ -58,21 +69,21 @@
 <li><a href="/odftoolkit/license.html">License</a></li>
 <li><a href="/odftoolkit/privacy.html">Privacy Policy</a></li>
 </ul>
-<h1 id="components">Components</h1>
+<h1 id="components">Components<a class="headerlink" href="#components" title="Permanent link">&para;</a></h1>
 <ul>
 <li><a href="/odftoolkit/odfdom/index.html">ODFDOM</a></li>
 <li><a href="/odftoolkit/simple/index.html">Simple API</a></li>
 <li><a href="/odftoolkit/conformance/ODFValidator.html">ODF Validator</a></li>
 <li><a href="/odftoolkit/xsltrunner/ODFXSLTRunner.html">XSLT Runner</a></li>
 </ul>
-<h1 id="community">Community</h1>
+<h1 id="community">Community<a class="headerlink" href="#community" title="Permanent link">&para;</a></h1>
 <ul>
 <li><a href="/odftoolkit/get-involved.html">Get Involved</a></li>
 <li><a href="/odftoolkit/mailing-lists.html">Mailing Lists</a></li>
 <li><a href="/odftoolkit/people.html">People</a></li>
 <li><a href="/odftoolkit/community-faqs.html">Community FAQs</a></li>
 </ul>
-<h1 id="development">Development</h1>
+<h1 id="development">Development<a class="headerlink" href="#development" title="Permanent link">&para;</a></h1>
 <ul>
 <li><a href="/odftoolkit/source.html">Source Code</a></li>
 <li><a href="https://issues.apache.org/jira/browse/ODFTOOLKIT">Bug Tracker</a></li>
@@ -80,13 +91,12 @@
 <li><a href="/odftoolkit/website-local.html">Website</a></li>
 <li><a href="/odftoolkit/developer-faqs.html">Developer FAQs</a></li>
 </ul>
-<h1 id="ppmc">PPMC</h1>
+<h1 id="ppmc">PPMC<a class="headerlink" href="#ppmc" title="Permanent link">&para;</a></h1>
 <ul>
 <li><a href="/odftoolkit/ppmc-faqs.html">PPMC FAQs</a></li>
-<li><a href="/odftoolkit/odftoolkit-release-guide.html">Release Guide</a> <br />
-</li>
+<li><a href="/odftoolkit/odftoolkit-release-guide.html">Release Guide</a>   </li>
 </ul>
-<h1 id="asf">ASF</h1>
+<h1 id="asf">ASF<a class="headerlink" href="#asf" title="Permanent link">&para;</a></h1>
 <ul>
 <li><a href="http://www.apache.org">Apache Software Foundation</a></li>
 <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
@@ -96,7 +106,18 @@
   <div id="contenta">
   
     <h1 class="title">Subversion Basics</h1>
-    <p>We use <a href="http://subversion.apache.org">Apache Subversion</a> for version control. For a complete reference on Subversion see the <a href="http://svnbook.red-bean.com">Subversion Book</a>. You can <a href="http://svn.apache.org/viewvc/incubator/odf/trunk">browse our repository</a> in your web browser.</p>
+    <style type="text/css">
+/* The following code is added by mdx_elementid.py
+   It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+  visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<p>We use <a href="http://subversion.apache.org">Apache Subversion</a> for version control. For a complete reference on Subversion see the <a href="http://svnbook.red-bean.com">Subversion Book</a>. You can <a href="http://svn.apache.org/viewvc/incubator/odf/trunk">browse our repository</a> in your web browser.</p>
 <p>This page gives instructions on performing basic development tasks using the Subversion Command-Line Client. This instruction assumes you have Apache Subversion installed.</p>
 <ul>
 <li><a href="#overview">Overview</a> </li>
@@ -109,18 +130,18 @@
 <li><a href="#creating_and_submitting_patches">Creating and Submitting Patches</a></li>
 <li><a href="#further_information">Further Information</a></li>
 </ul>
-<h2 id="overview">Overview</h2>
+<h2 id="overview">Overview<a class="headerlink" href="#overview" title="Permanent link">&para;</a></h2>
 <p>You begin using Subversion by copying a directory from a remote repository to a local directory on your file system. This is known as a checkout of a working copy.</p>
 <p>Subversion uses a copy-modify-merge model meaning that you can add and edit files and directories in your working copy like any other files on your system, but you should use subversion commands for everything else such as <code>svn copy</code> and <code>svn move</code> instead of the operating system commands.</p>
-<h2 id="sub-commands-and-abbreviations">Sub-commands and Abbreviations</h2>
+<h2 id="sub-commands-and-abbreviations">Sub-commands and Abbreviations<a class="headerlink" href="#sub-commands-and-abbreviations" title="Permanent link">&para;</a></h2>
 <p>Subversion commands can be run from a command shell such as Bash on Linux. The subversion client command is <code>svn</code> followed by optional sub-commands, options, and arguments.</p>
 <p>Show the program version and modules</p>
-<div class="codehilite"><pre><span class="nv">$</span> <span class="nv">svn</span> <span class="o">--</span><span class="n">version</span>
+<div class="codehilite"><pre>$ <span class="n">svn</span> <span class="o">--</span><span class="n">version</span>
 </pre></div>
 
 
 <p>Run a sub-command</p>
-<div class="codehilite"><pre><span class="nv">$</span> <span class="nv">svn</span> <span class="sr">&lt;subcommand&gt;</span> <span class="p">[</span><span class="n">options</span><span class="p">]</span> <span class="p">[</span><span class="n">args</span><span class="p">]</span>
+<div class="codehilite"><pre>$ <span class="n">svn</span> <span class="o">&lt;</span><span class="n">subcommand</span><span class="o">&gt;</span> <span class="p">[</span><span class="n">options</span><span class="p">]</span> <span class="p">[</span><span class="n">args</span><span class="p">]</span>
 </pre></div>
 
 
@@ -140,14 +161,14 @@
 <li><code>status</code> - Print the status of working copy files and directories</li>
 <li><code>update</code> - Bring changes from the repository into your working copy</li>
 </ul>
-<h2 id="client-configuration">Client Configuration</h2>
+<h2 id="client-configuration">Client Configuration<a class="headerlink" href="#client-configuration" title="Permanent link">&para;</a></h2>
 <p>Committers need to <a href="http://www.apache.org/dev/version-control.html#https-svn-config">configure their Subversion client</a> to handle the differences in line endings of text files on different operating systems.</p>
 <p>There are instances where Subversion may need to open an editor. You need to have the environment variable EDITOR set to the editor you would like to use. To set it for the current terminal session in Bash (your path may differ):</p>
-<div class="codehilite"><pre><span class="nv">$</span> <span class="nv">export</span> <span class="n">EDITOR</span><span class="o">=</span><span class="sr">/usr/</span><span class="n">bin</span><span class="o">/</span><span class="n">vim</span>
+<div class="codehilite"><pre>$ <span class="n">export</span> <span class="n">EDITOR</span><span class="p">=</span><span class="o">/</span><span class="n">usr</span><span class="o">/</span><span class="n">bin</span><span class="o">/</span><span class="n">vim</span>
 </pre></div>
 
 
-<h2 id="repository-layout">Repository Layout</h2>
+<h2 id="repository-layout">Repository Layout<a class="headerlink" href="#repository-layout" title="Permanent link">&para;</a></h2>
 <p>The Odf repository layout uses the following top-level directories <code>branches</code>, <code>site</code>, <code>tags</code>, and <code>trunk</code>.</p>
 <ul>
 <li><code>branches</code> - Contains branches used for continued development of a specific version, experimental versions, or for  developing features to be merged into the trunk or a branch later. (needs examples)</li>
@@ -156,22 +177,22 @@
 <li><code>trunk</code> - Contains the current source code.
 For more information see the <a href="http://www.apache.org/dev/contributors.html#svnbasics">Contributors Tech Guide</a>.</li>
 </ul>
-<h2 id="getting-the-source-code">Getting the source code</h2>
+<h2 id="getting-the-source-code">Getting the source code<a class="headerlink" href="#getting-the-source-code" title="Permanent link">&para;</a></h2>
 <p>From the parent directory of where you want the working copy. In this example the <code>odf-trunk</code> directory will be created if it does not exist.</p>
-<div class="codehilite"><pre><span class="nv">$</span> <span class="nv">svn</span> <span class="n">co</span> <span class="n">https:</span><span class="sr">//s</span><span class="n">vn</span><span class="o">.</span><span class="n">apache</span><span class="o">.</span><span class="n">org</span><span class="sr">/repos/</span><span class="n">asf</span><span class="sr">/incubator/o</span><span class="n">df</span><span class="o">/</span><span class="n">trunk</span> <span class="n">odf</span><span class="o">-</span><span class="n">trunk</span>
+<div class="codehilite"><pre>$ <span class="n">svn</span> <span class="n">co</span> <span class="n">https</span><span class="p">:</span><span class="o">//</span><span class="n">svn</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">org</span><span class="o">/</span><span class="n">repos</span><span class="o">/</span><span class="n">asf</span><span class="o">/</span><span class="n">incubator</span><span class="o">/</span><span class="n">odf</span><span class="o">/</span><span class="n">trunk</span> <span class="n">odf</span><span class="o">-</span><span class="n">trunk</span>
 <span class="n">A</span>    <span class="n">odf</span><span class="o">-</span><span class="n">trunk</span><span class="o">/</span><span class="n">tools</span>
-<span class="n">A</span>    <span class="n">odf</span><span class="o">-</span><span class="n">trunk</span><span class="sr">/tools/</span><span class="n">dev</span>
-<span class="n">A</span>    <span class="n">odf</span><span class="o">-</span><span class="n">trunk</span><span class="sr">/tools/</span><span class="n">dev</span><span class="o">/</span><span class="n">fetch</span><span class="o">-</span><span class="n">all</span><span class="o">-</span><span class="n">cws</span><span class="o">.</span><span class="n">sh</span>
-<span class="n">A</span>    <span class="n">odf</span><span class="o">-</span><span class="n">trunk</span><span class="sr">/tools/</span><span class="n">dev</span><span class="o">/</span><span class="n">cws</span><span class="o">-</span><span class="n">list</span><span class="o">.</span><span class="n">txt</span>
-<span class="n">A</span>    <span class="n">odf</span><span class="o">-</span><span class="n">trunk</span><span class="sr">/tools/</span><span class="n">dev</span><span class="o">/</span><span class="n">fetch</span><span class="o">-</span><span class="n">all</span><span class="o">-</span><span class="n">web</span><span class="o">.</span><span class="n">sh</span>
-<span class="n">A</span>    <span class="n">odf</span><span class="o">-</span><span class="n">trunk</span><span class="sr">/tools/</span><span class="n">dev</span><span class="o">/</span><span class="n">web</span><span class="o">-</span><span class="n">list</span><span class="o">.</span><span class="n">txt</span>
-<span class="n">A</span>    <span class="n">odf</span><span class="o">-</span><span class="n">trunk</span><span class="sr">/tools/</span><span class="n">dev</span><span class="o">/</span><span class="n">single</span><span class="o">-</span><span class="n">hg</span><span class="o">.</span><span class="n">sh</span>
-<span class="n">Checked</span> <span class="n">out</span> <span class="n">revision</span> <span class="mi">1145818</span><span class="o">.</span>
+<span class="n">A</span>    <span class="n">odf</span><span class="o">-</span><span class="n">trunk</span><span class="o">/</span><span class="n">tools</span><span class="o">/</span><span class="n">dev</span>
+<span class="n">A</span>    <span class="n">odf</span><span class="o">-</span><span class="n">trunk</span><span class="o">/</span><span class="n">tools</span><span class="o">/</span><span class="n">dev</span><span class="o">/</span><span class="n">fetch</span><span class="o">-</span><span class="n">all</span><span class="o">-</span><span class="n">cws</span><span class="p">.</span><span class="n">sh</span>
+<span class="n">A</span>    <span class="n">odf</span><span class="o">-</span><span class="n">trunk</span><span class="o">/</span><span class="n">tools</span><span class="o">/</span><span class="n">dev</span><span class="o">/</span><span class="n">cws</span><span class="o">-</span><span class="n">list</span><span class="p">.</span><span class="n">txt</span>
+<span class="n">A</span>    <span class="n">odf</span><span class="o">-</span><span class="n">trunk</span><span class="o">/</span><span class="n">tools</span><span class="o">/</span><span class="n">dev</span><span class="o">/</span><span class="n">fetch</span><span class="o">-</span><span class="n">all</span><span class="o">-</span><span class="n">web</span><span class="p">.</span><span class="n">sh</span>
+<span class="n">A</span>    <span class="n">odf</span><span class="o">-</span><span class="n">trunk</span><span class="o">/</span><span class="n">tools</span><span class="o">/</span><span class="n">dev</span><span class="o">/</span><span class="n">web</span><span class="o">-</span><span class="n">list</span><span class="p">.</span><span class="n">txt</span>
+<span class="n">A</span>    <span class="n">odf</span><span class="o">-</span><span class="n">trunk</span><span class="o">/</span><span class="n">tools</span><span class="o">/</span><span class="n">dev</span><span class="o">/</span><span class="n">single</span><span class="o">-</span><span class="n">hg</span><span class="p">.</span><span class="n">sh</span>
+<span class="n">Checked</span> <span class="n">out</span> <span class="n">revision</span> 1145818<span class="p">.</span>
 </pre></div>
 
 
 <p>"A" indicates file or directory is "Added" to working copy</p>
-<h2 id="basic-work-cycle">Basic Work Cycle</h2>
+<h2 id="basic-work-cycle">Basic Work Cycle<a class="headerlink" href="#basic-work-cycle" title="Permanent link">&para;</a></h2>
 <ul>
 <li>Update your working copy - For this you use the <code>svn update</code> command</li>
 <li>Make changes - For this you may edit files in an editor, or use the <code>svn add</code>, <code>svn delete</code>, <code>svn copy</code>, <code>svn-move</code> commands</li>
@@ -180,87 +201,87 @@ For more information see the <a href="ht
 <li>Resolve Conflicts - There is a chance others have committed changes while you have been changing your working copy. You should run the <code>svn update</code> command to bring your copy up to date. This may create a local conflict where someone may have added a file with a name that you also want to add, or may have made changes to the same line of a file as you. For this use the <code>svn resolve</code> command.</li>
 <li>Publish Changes - For this you use the <code>svn commit</code> command</li>
 </ul>
-<h3 id="adding-a-file">Adding a File</h3>
+<h3 id="adding-a-file">Adding a File<a class="headerlink" href="#adding-a-file" title="Permanent link">&para;</a></h3>
 <p>After creating the file "test-file.txt" in the working copy.</p>
-<div class="codehilite"><pre><span class="nv">$</span> <span class="nv">svn</span> <span class="n">status</span>
-<span class="p">?</span>       <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="o">.</span><span class="n">txt</span>
+<div class="codehilite"><pre>$ <span class="n">svn</span> <span class="n">status</span>
+?       <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="p">.</span><span class="n">txt</span>
 </pre></div>
 
 
 <p>? indicates test-file.txt is not under version control</p>
-<h3 id="scheduling-a-file-for-addition-to-repository">Scheduling a file for addition to repository</h3>
-<div class="codehilite"><pre><span class="nv">$</span> <span class="nv">svn</span> <span class="n">add</span> <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="o">.</span><span class="n">txt</span>
-<span class="n">A</span>         <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="o">.</span><span class="n">txt</span>
+<h3 id="scheduling-a-file-for-addition-to-repository">Scheduling a file for addition to repository<a class="headerlink" href="#scheduling-a-file-for-addition-to-repository" title="Permanent link">&para;</a></h3>
+<div class="codehilite"><pre>$ <span class="n">svn</span> <span class="n">add</span> <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="p">.</span><span class="n">txt</span>
+<span class="n">A</span>         <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="p">.</span><span class="n">txt</span>
 
-<span class="nv">$</span> <span class="nv">svn</span> <span class="n">status</span>
-<span class="n">A</span>       <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="o">.</span><span class="n">txt</span>
+$ <span class="n">svn</span> <span class="n">status</span>
+<span class="n">A</span>       <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="p">.</span><span class="n">txt</span>
 </pre></div>
 
 
 <p>"A" indicates file is scheduled for addition</p>
-<h3 id="running-a-diff">Running a diff</h3>
-<div class="codehilite"><pre><span class="nv">$</span> <span class="nv">svn</span> <span class="n">diff</span>
-<span class="n">Index:</span> <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="o">.</span><span class="n">txt</span>
-<span class="o">===================================================================</span>
-<span class="o">---</span> <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="o">.</span><span class="n">txt</span>   <span class="p">(</span><span class="n">revision</span> <span class="mi">0</span><span class="p">)</span>
-<span class="o">+++</span> <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="o">.</span><span class="n">txt</span>   <span class="p">(</span><span class="n">revision</span> <span class="mi">0</span><span class="p">)</span>
-<span class="nv">@@</span> <span class="err">-</span><span class="nv">0</span><span class="p">,</span><span class="mi">0</span> <span class="o">+</span><span class="mi">1</span> <span class="nv">@@</span>
-<span class="err">+</span><span class="nv">This</span> <span class="n">is</span> <span class="n">a</span> <span class="n">test</span> <span class="n">file</span> <span class="k">for</span> <span class="n">svn</span><span class="o">-</span><span class="n">basics</span><span class="o">.</span>
+<h3 id="running-a-diff">Running a diff<a class="headerlink" href="#running-a-diff" title="Permanent link">&para;</a></h3>
+<div class="codehilite"><pre>$ <span class="n">svn</span> <span class="n">diff</span>
+<span class="n">Index</span><span class="p">:</span> <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="p">.</span><span class="n">txt</span>
+<span class="o">==================================================================</span><span class="p">=</span>
+<span class="o">---</span> <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="p">.</span><span class="n">txt</span>   <span class="p">(</span><span class="n">revision</span> 0<span class="p">)</span>
+<span class="o">+++</span> <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="p">.</span><span class="n">txt</span>   <span class="p">(</span><span class="n">revision</span> 0<span class="p">)</span>
+<span class="p">@@</span> <span class="o">-</span>0<span class="p">,</span>0 <span class="o">+</span>1 <span class="p">@@</span>
+<span class="o">+</span><span class="n">This</span> <span class="n">is</span> <span class="n">a</span> <span class="n">test</span> <span class="n">file</span> <span class="k">for</span> <span class="n">svn</span><span class="o">-</span><span class="n">basics</span><span class="p">.</span>
 
-<span class="n">Property</span> <span class="n">changes</span> <span class="n">on:</span> <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="o">.</span><span class="n">txt</span>
+<span class="n">Property</span> <span class="n">changes</span> <span class="n">on</span><span class="p">:</span> <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="p">.</span><span class="n">txt</span>
 <span class="n">___________________________________________________________________</span>
-<span class="n">Added:</span> <span class="n">svn:eol</span><span class="o">-</span><span class="n">style</span>
+<span class="n">Added</span><span class="p">:</span> <span class="n">svn</span><span class="p">:</span><span class="n">eol</span><span class="o">-</span><span class="n">style</span>
    <span class="o">+</span> <span class="n">native</span>
 </pre></div>
 
 
-<h3 id="committing-a-file">Committing a file</h3>
-<div class="codehilite"><pre><span class="nv">$</span> <span class="nv">svn</span> <span class="n">commit</span> <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="o">.</span><span class="n">txt</span> <span class="o">-</span><span class="n">m</span> <span class="s">&quot;added test-file.txt&quot;</span>
-<span class="n">Adding</span>         <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="o">.</span><span class="n">txt</span>
-<span class="n">Transmitting</span> <span class="n">file</span> <span class="n">data</span> <span class="o">.</span>
-<span class="n">Committed</span> <span class="n">revision</span> <span class="mi">2</span><span class="o">.</span>
+<h3 id="committing-a-file">Committing a file<a class="headerlink" href="#committing-a-file" title="Permanent link">&para;</a></h3>
+<div class="codehilite"><pre>$ <span class="n">svn</span> <span class="n">commit</span> <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="p">.</span><span class="n">txt</span> <span class="o">-</span><span class="n">m</span> &quot;<span class="n">added</span> <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="p">.</span><span class="n">txt</span>&quot;
+<span class="n">Adding</span>         <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="p">.</span><span class="n">txt</span>
+<span class="n">Transmitting</span> <span class="n">file</span> <span class="n">data</span> <span class="p">.</span>
+<span class="n">Committed</span> <span class="n">revision</span> 2<span class="p">.</span>
 </pre></div>
 
 
-<h3 id="update-the-working-copy">Update the working copy</h3>
-<div class="codehilite"><pre><span class="nv">$</span> <span class="nv">svn</span> <span class="n">update</span>
-<span class="n">U</span>    <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="o">.</span><span class="n">txt</span>
-<span class="n">Updated</span> <span class="n">to</span> <span class="n">revision</span> <span class="mi">3</span><span class="o">.</span>
+<h3 id="update-the-working-copy">Update the working copy<a class="headerlink" href="#update-the-working-copy" title="Permanent link">&para;</a></h3>
+<div class="codehilite"><pre>$ <span class="n">svn</span> <span class="n">update</span>
+<span class="n">U</span>    <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="p">.</span><span class="n">txt</span>
+<span class="n">Updated</span> <span class="n">to</span> <span class="n">revision</span> 3<span class="p">.</span>
 </pre></div>
 
 
 <p>"U" indicates an "Update" to a file or directory</p>
 <p>Modify the file (this example uses the vim editor)</p>
-<div class="codehilite"><pre><span class="nv">$</span> <span class="nv">vim</span> <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="o">.</span><span class="n">txt</span>
+<div class="codehilite"><pre>$ <span class="n">vim</span> <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="p">.</span><span class="n">txt</span>
 </pre></div>
 
 
-<h3 id="check-the-status">Check the Status</h3>
-<div class="codehilite"><pre><span class="nv">$</span> <span class="nv">svn</span> <span class="n">status</span>
-<span class="n">M</span>       <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="o">.</span><span class="n">txt</span>
+<h3 id="check-the-status">Check the Status<a class="headerlink" href="#check-the-status" title="Permanent link">&para;</a></h3>
+<div class="codehilite"><pre>$ <span class="n">svn</span> <span class="n">status</span>
+<span class="n">M</span>       <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="p">.</span><span class="n">txt</span>
 </pre></div>
 
 
 <p>"M" indicates the file has been "Modified"</p>
-<div class="codehilite"><pre><span class="nv">$</span> <span class="nv">svn</span> <span class="n">diff</span>
-<span class="n">Index:</span> <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="o">.</span><span class="n">txt</span>
-<span class="o">===================================================================</span>
-<span class="o">---</span> <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="o">.</span><span class="n">txt</span>   <span class="p">(</span><span class="n">revision</span> <span class="mi">3</span><span class="p">)</span>
-<span class="o">+++</span> <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="o">.</span><span class="n">txt</span>   <span class="p">(</span><span class="n">working</span> <span class="n">copy</span><span class="p">)</span>
-<span class="nv">@@</span> <span class="err">-</span><span class="nv">1</span><span class="p">,</span><span class="mi">2</span> <span class="o">+</span><span class="mi">1</span><span class="p">,</span><span class="mi">3</span> <span class="nv">@@</span>
- <span class="nv">This</span> <span class="n">is</span> <span class="n">a</span> <span class="n">test</span> <span class="n">file</span> <span class="k">for</span> <span class="n">svn</span><span class="o">-</span><span class="n">basics</span><span class="o">.</span>
- <span class="n">This</span> <span class="n">is</span> <span class="n">a</span> <span class="k">new</span> <span class="n">line</span> <span class="n">added</span> <span class="n">by</span> <span class="n">someone</span> <span class="k">else</span><span class="o">.</span>
-<span class="o">+</span><span class="n">This</span> <span class="n">line</span> <span class="n">added</span> <span class="n">by</span> <span class="n">me</span><span class="o">.</span>
+<div class="codehilite"><pre>$ <span class="n">svn</span> <span class="n">diff</span>
+<span class="n">Index</span><span class="p">:</span> <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="p">.</span><span class="n">txt</span>
+<span class="o">==================================================================</span><span class="p">=</span>
+<span class="o">---</span> <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="p">.</span><span class="n">txt</span>   <span class="p">(</span><span class="n">revision</span> 3<span class="p">)</span>
+<span class="o">+++</span> <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="p">.</span><span class="n">txt</span>   <span class="p">(</span><span class="n">working</span> <span class="n">copy</span><span class="p">)</span>
+<span class="p">@@</span> <span class="o">-</span>1<span class="p">,</span>2 <span class="o">+</span>1<span class="p">,</span>3 <span class="p">@@</span>
+ <span class="n">This</span> <span class="n">is</span> <span class="n">a</span> <span class="n">test</span> <span class="n">file</span> <span class="k">for</span> <span class="n">svn</span><span class="o">-</span><span class="n">basics</span><span class="p">.</span>
+ <span class="n">This</span> <span class="n">is</span> <span class="n">a</span> <span class="n">new</span> <span class="n">line</span> <span class="n">added</span> <span class="n">by</span> <span class="n">someone</span> <span class="k">else</span><span class="p">.</span>
+<span class="o">+</span><span class="n">This</span> <span class="n">line</span> <span class="n">added</span> <span class="n">by</span> <span class="n">me</span><span class="p">.</span>
 </pre></div>
 
 
-<h3 id="resolving-conflicts">Resolving Conflicts</h3>
+<h3 id="resolving-conflicts">Resolving Conflicts<a class="headerlink" href="#resolving-conflicts" title="Permanent link">&para;</a></h3>
 <p>Suppose someone edits the same line as you before you commit</p>
-<div class="codehilite"><pre><span class="nv">$</span> <span class="nv">svn</span> <span class="n">update</span>
-<span class="n">Conflict</span> <span class="n">discovered</span> <span class="n">in</span> <span class="s">&#39;test-file.txt&#39;</span><span class="o">.</span>
-<span class="n">Select:</span> <span class="p">(</span><span class="n">p</span><span class="p">)</span> <span class="n">postpone</span><span class="p">,</span> <span class="p">(</span><span class="n">df</span><span class="p">)</span> <span class="n">diff</span><span class="o">-</span><span class="n">full</span><span class="p">,</span> <span class="p">(</span><span class="n">e</span><span class="p">)</span> <span class="n">edit</span><span class="p">,</span>
+<div class="codehilite"><pre>$ <span class="n">svn</span> <span class="n">update</span>
+<span class="n">Conflict</span> <span class="n">discovered</span> <span class="n">in</span> <span class="s">&#39;test-file.txt&#39;</span><span class="p">.</span>
+<span class="n">Select</span><span class="p">:</span> <span class="p">(</span><span class="n">p</span><span class="p">)</span> <span class="n">postpone</span><span class="p">,</span> <span class="p">(</span><span class="n">df</span><span class="p">)</span> <span class="n">diff</span><span class="o">-</span><span class="n">full</span><span class="p">,</span> <span class="p">(</span><span class="n">e</span><span class="p">)</span> <span class="n">edit</span><span class="p">,</span>
         <span class="p">(</span><span class="n">mc</span><span class="p">)</span> <span class="n">mine</span><span class="o">-</span><span class="n">conflict</span><span class="p">,</span> <span class="p">(</span><span class="n">tc</span><span class="p">)</span> <span class="n">theirs</span><span class="o">-</span><span class="n">conflict</span><span class="p">,</span>
-        <span class="p">(</span><span class="n">s</span><span class="p">)</span> <span class="n">show</span> <span class="n">all</span> <span class="n">options:</span>
+        <span class="p">(</span><span class="n">s</span><span class="p">)</span> <span class="n">show</span> <span class="n">all</span> <span class="n">options</span><span class="p">:</span>
 </pre></div>
 
 
@@ -283,41 +304,41 @@ Select: (p) postpone, (df) diff-full, (e
 
 
 <p>If you choose <code>e</code>, Subversion will launch an editor with both sets of changes included for you to edit. You can save your changes in the editor and then select <code>r</code> (for resolved).</p>
-<div class="codehilite"><pre><span class="n">G</span>    <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="o">.</span><span class="n">txt</span>
-<span class="n">Updated</span> <span class="n">to</span> <span class="n">revision</span> <span class="mi">4</span><span class="o">.</span>
+<div class="codehilite"><pre><span class="n">G</span>    <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="p">.</span><span class="n">txt</span>
+<span class="n">Updated</span> <span class="n">to</span> <span class="n">revision</span> 4<span class="p">.</span>
 </pre></div>
 
 
 <p>"G" indicates "merGed"</p>
-<h3 id="committing-the-changes">Committing the Changes</h3>
+<h3 id="committing-the-changes">Committing the Changes<a class="headerlink" href="#committing-the-changes" title="Permanent link">&para;</a></h3>
 <p>Only Committers can commit directly to the repository. The following example shows using your Apache ID and password.</p>
-<div class="codehilite"><pre><span class="nv">$</span> <span class="nv">svn</span> <span class="n">commit</span> <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="o">.</span><span class="n">txt</span> <span class="o">--</span><span class="n">username</span> <span class="n">your</span><span class="o">-</span><span class="n">name</span> <span class="o">--</span><span class="n">password</span> <span class="n">your</span><span class="o">-</span><span class="n">password</span> <span class="o">\</span>
-  <span class="o">-</span><span class="n">m</span> <span class="s">&quot;added new line&quot;</span>
-<span class="n">Sending</span>        <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="o">.</span><span class="n">txt</span>
-<span class="n">Transmitting</span> <span class="n">file</span> <span class="n">data</span> <span class="o">.</span>
-<span class="n">Committed</span> <span class="n">revision</span> <span class="mi">5</span><span class="o">.</span>
+<div class="codehilite"><pre>$ <span class="n">svn</span> <span class="n">commit</span> <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="p">.</span><span class="n">txt</span> <span class="o">--</span><span class="n">username</span> <span class="n">your</span><span class="o">-</span><span class="n">name</span> <span class="o">--</span><span class="n">password</span> <span class="n">your</span><span class="o">-</span><span class="n">password</span> <span class="o">\</span>
+  <span class="o">-</span><span class="n">m</span> &quot;<span class="n">added</span> <span class="n">new</span> <span class="n">line</span>&quot;
+<span class="n">Sending</span>        <span class="n">test</span><span class="o">-</span><span class="n">file</span><span class="p">.</span><span class="n">txt</span>
+<span class="n">Transmitting</span> <span class="n">file</span> <span class="n">data</span> <span class="p">.</span>
+<span class="n">Committed</span> <span class="n">revision</span> 5<span class="p">.</span>
 </pre></div>
 
 
 <p>For further information see the <a href="http://svnbook.red-bean.com/nightly/en/svn.tour.cycle.html">Basic Work Cycle</a> page from <a href="http://svnbook.red-bean.com">Subversion Book</a>.</p>
-<h2 id="committing-changes-by-others">Committing Changes By Others</h2>
+<h2 id="committing-changes-by-others">Committing Changes By Others<a class="headerlink" href="#committing-changes-by-others" title="Permanent link">&para;</a></h2>
 <p>See the <a href="http://www.apache.org/dev/committers.html#applying-patches">Applying Patches</a> section of the Committer FAQ page.</p>
 <p>Example similar to one on Committer FAQ:</p>
-<div class="codehilite"><pre><span class="n">Issue</span> <span class="c1">#43835:</span>
-<span class="n">Added</span> <span class="n">some</span> <span class="n">cool</span> <span class="k">new</span> <span class="n">feature</span><span class="o">.</span>
-<span class="n">Submitted</span> <span class="n">by:</span> <span class="n">John</span> <span class="n">Doe</span> <span class="sr">&lt;john.doe.at.null.org&gt;</span>
+<div class="codehilite"><pre><span class="n">Issue</span> #43835<span class="p">:</span>
+<span class="n">Added</span> <span class="n">some</span> <span class="n">cool</span> <span class="n">new</span> <span class="n">feature</span><span class="p">.</span>
+<span class="n">Submitted</span> <span class="n">by</span><span class="p">:</span> <span class="n">John</span> <span class="n">Doe</span> <span class="o">&lt;</span><span class="n">john</span><span class="p">.</span><span class="n">doe</span><span class="p">.</span><span class="n">at</span><span class="p">.</span><span class="n">null</span><span class="p">.</span><span class="n">org</span><span class="o">&gt;</span>
 </pre></div>
 
 
 <p>Using the <code>-m (--message)</code> option only allows a single line log message. To commit a multi-line message use the <code>-F (--file)</code> option (with a previously created file) or use neither -m or -F and an editor will be started.</p>
-<h2 id="creating-and-submitting-patches">Creating and Submitting Patches</h2>
+<h2 id="creating-and-submitting-patches">Creating and Submitting Patches<a class="headerlink" href="#creating-and-submitting-patches" title="Permanent link">&para;</a></h2>
 <p>See the <a href="http://www.apache.org/dev/contributors.html#patches">Sending in Patches</a> section on the Contributors Tech Guide page.</p>
 <p>Create the patch file from <code>svn diff</code> where <code>your-patch-name.patch</code> is the full path to the patch file to create.</p>
-<div class="codehilite"><pre><span class="n">svn</span> <span class="n">diff</span> <span class="o">&gt;</span> <span class="n">your</span><span class="o">-</span><span class="n">patch</span><span class="o">-</span><span class="n">name</span><span class="o">.</span><span class="n">patch</span>
+<div class="codehilite"><pre><span class="n">svn</span> <span class="n">diff</span> <span class="o">&gt;</span> <span class="n">your</span><span class="o">-</span><span class="n">patch</span><span class="o">-</span><span class="n">name</span><span class="p">.</span><span class="n">patch</span>
 </pre></div>
 
 
-<h2 id="further-information">Further Information</h2>
+<h2 id="further-information">Further Information<a class="headerlink" href="#further-information" title="Permanent link">&para;</a></h2>
 <p>For more information see: </p>
 <ul>
 <li><a href="http://subversion.apache.org">Apache Subversion Project</a></li>

Modified: websites/staging/odftoolkit/trunk/content/odftoolkit/website-local.html
==============================================================================
--- websites/staging/odftoolkit/trunk/content/odftoolkit/website-local.html (original)
+++ websites/staging/odftoolkit/trunk/content/odftoolkit/website-local.html Tue Apr 11 23:13:30 2017
@@ -50,7 +50,18 @@
   <div id="clear"></div>
   
   <div id="sidenav">
-    <h1 id="general">General</h1>
+    <style type="text/css">
+/* The following code is added by mdx_elementid.py
+   It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+  visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<h1 id="general">General<a class="headerlink" href="#general" title="Permanent link">&para;</a></h1>
 <ul>
 <li><a href="/odftoolkit/index.html">About</a></li>
 <li><a href="/odftoolkit/downloads.html">Downloads</a></li>
@@ -58,21 +69,21 @@
 <li><a href="/odftoolkit/license.html">License</a></li>
 <li><a href="/odftoolkit/privacy.html">Privacy Policy</a></li>
 </ul>
-<h1 id="components">Components</h1>
+<h1 id="components">Components<a class="headerlink" href="#components" title="Permanent link">&para;</a></h1>
 <ul>
 <li><a href="/odftoolkit/odfdom/index.html">ODFDOM</a></li>
 <li><a href="/odftoolkit/simple/index.html">Simple API</a></li>
 <li><a href="/odftoolkit/conformance/ODFValidator.html">ODF Validator</a></li>
 <li><a href="/odftoolkit/xsltrunner/ODFXSLTRunner.html">XSLT Runner</a></li>
 </ul>
-<h1 id="community">Community</h1>
+<h1 id="community">Community<a class="headerlink" href="#community" title="Permanent link">&para;</a></h1>
 <ul>
 <li><a href="/odftoolkit/get-involved.html">Get Involved</a></li>
 <li><a href="/odftoolkit/mailing-lists.html">Mailing Lists</a></li>
 <li><a href="/odftoolkit/people.html">People</a></li>
 <li><a href="/odftoolkit/community-faqs.html">Community FAQs</a></li>
 </ul>
-<h1 id="development">Development</h1>
+<h1 id="development">Development<a class="headerlink" href="#development" title="Permanent link">&para;</a></h1>
 <ul>
 <li><a href="/odftoolkit/source.html">Source Code</a></li>
 <li><a href="https://issues.apache.org/jira/browse/ODFTOOLKIT">Bug Tracker</a></li>
@@ -80,13 +91,12 @@
 <li><a href="/odftoolkit/website-local.html">Website</a></li>
 <li><a href="/odftoolkit/developer-faqs.html">Developer FAQs</a></li>
 </ul>
-<h1 id="ppmc">PPMC</h1>
+<h1 id="ppmc">PPMC<a class="headerlink" href="#ppmc" title="Permanent link">&para;</a></h1>
 <ul>
 <li><a href="/odftoolkit/ppmc-faqs.html">PPMC FAQs</a></li>
-<li><a href="/odftoolkit/odftoolkit-release-guide.html">Release Guide</a> <br />
-</li>
+<li><a href="/odftoolkit/odftoolkit-release-guide.html">Release Guide</a>   </li>
 </ul>
-<h1 id="asf">ASF</h1>
+<h1 id="asf">ASF<a class="headerlink" href="#asf" title="Permanent link">&para;</a></h1>
 <ul>
 <li><a href="http://www.apache.org">Apache Software Foundation</a></li>
 <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
@@ -96,7 +106,18 @@
   <div id="contenta">
   
     <h1 class="title">Website Development</h1>
-    <p>We use <a href="http://subversion.apache.org">Apache Subversion</a> for version control. You can <a href="http://svn.apache.org/viewvc/incubator/odf/site/trunk">browse our 
+    <style type="text/css">
+/* The following code is added by mdx_elementid.py
+   It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+  visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<p>We use <a href="http://subversion.apache.org">Apache Subversion</a> for version control. You can <a href="http://svn.apache.org/viewvc/incubator/odf/site/trunk">browse our 
 repository</a> in your web browser.</p>
 <p>Quick editing of the site is available for committers using the Apache CMS
 <a href="docs/edit-cms.html">from your browser.</a></p>
@@ -107,55 +128,55 @@ repository</a> in your web browser.</p>
 <li><a href="#local-development">Local Development</a> - How to build and test locally.</li>
 <li><a href="#submitting-your-results">Submitting Your Results</a> - How to contribute your edits.</li>
 </ul>
-<h2 id="setup">Setup</h2>
-<h3 id="create-a-directory-on-your-computer">Create a directory on your computer.</h3>
-<div class="codehilite"><pre><span class="nb">mkdir</span> <span class="n">odf</span><span class="o">-</span><span class="n">site</span>
+<h2 id="setup">Setup<a class="headerlink" href="#setup" title="Permanent link">&para;</a></h2>
+<h3 id="create-a-directory-on-your-computer">Create a directory on your computer.<a class="headerlink" href="#create-a-directory-on-your-computer" title="Permanent link">&para;</a></h3>
+<div class="codehilite"><pre><span class="n">mkdir</span> <span class="n">odf</span><span class="o">-</span><span class="n">site</span>
 <span class="n">cd</span> <span class="n">odf</span><span class="o">-</span><span class="n">site</span>
 </pre></div>
 
 
-<h3 id="download-the-svn-repos-for-the-odf-site">Download the svn repos for the Odf site.</h3>
-<div class="codehilite"><pre><span class="n">svn</span> <span class="n">co</span> <span class="n">https:</span><span class="sr">//s</span><span class="n">vn</span><span class="o">.</span><span class="n">apache</span><span class="o">.</span><span class="n">org</span><span class="sr">/repos/</span><span class="n">asf</span><span class="sr">/incubator/o</span><span class="n">df</span><span class="sr">/site/</span><span class="n">trunk</span> <span class="n">site</span>
+<h3 id="download-the-svn-repos-for-the-odf-site">Download the svn repos for the Odf site.<a class="headerlink" href="#download-the-svn-repos-for-the-odf-site" title="Permanent link">&para;</a></h3>
+<div class="codehilite"><pre><span class="n">svn</span> <span class="n">co</span> <span class="n">https</span><span class="p">:</span><span class="o">//</span><span class="n">svn</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">org</span><span class="o">/</span><span class="n">repos</span><span class="o">/</span><span class="n">asf</span><span class="o">/</span><span class="n">incubator</span><span class="o">/</span><span class="n">odf</span><span class="o">/</span><span class="n">site</span><span class="o">/</span><span class="n">trunk</span> <span class="n">site</span>
 </pre></div>
 
 
-<h3 id="download-the-svn-repos-for-the-apache-cms">Download the svn repos for the Apache CMS.</h3>
-<div class="codehilite"><pre><span class="n">svn</span> <span class="n">co</span> <span class="n">https:</span><span class="sr">//s</span><span class="n">vn</span><span class="o">.</span><span class="n">apache</span><span class="o">.</span><span class="n">org</span><span class="sr">/repos/i</span><span class="n">nfra</span><span class="sr">/websites/cms</span><span class="o">/</span> <span class="n">cms</span>
+<h3 id="download-the-svn-repos-for-the-apache-cms">Download the svn repos for the Apache CMS.<a class="headerlink" href="#download-the-svn-repos-for-the-apache-cms" title="Permanent link">&para;</a></h3>
+<div class="codehilite"><pre><span class="n">svn</span> <span class="n">co</span> <span class="n">https</span><span class="p">:</span><span class="o">//</span><span class="n">svn</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">org</span><span class="o">/</span><span class="n">repos</span><span class="o">/</span><span class="n">infra</span><span class="o">/</span><span class="n">websites</span><span class="o">/</span><span class="n">cms</span><span class="o">/</span> <span class="n">cms</span>
 </pre></div>
 
 
-<h3 id="install-python-dependencies">Install Python dependencies.</h3>
+<h3 id="install-python-dependencies">Install Python dependencies.<a class="headerlink" href="#install-python-dependencies" title="Permanent link">&para;</a></h3>
 <p>Adapted from the <a href="http://www.apache.org/dev/cmsref.html#local-build">Apache CMS Reference</a></p>
 <p>The easiest way to install the dependencies is to use Python setuptools.</p>
-<h4 id="check-your-version-of-python">Check your version of Python</h4>
+<h4 id="check-your-version-of-python">Check your version of Python<a class="headerlink" href="#check-your-version-of-python" title="Permanent link">&para;</a></h4>
 <div class="codehilite"><pre><span class="n">python</span> <span class="o">--</span><span class="n">version</span>
 </pre></div>
 
 
-<h4 id="follow-the-installation-instructions-for-setuptools">Follow the installation instructions for <a href="http://pypi.python.org/pypi/setuptools">setuptools</a>.</h4>
-<h4 id="install-dependencies">Install dependencies</h4>
+<h4 id="follow-the-installation-instructions-for-setuptools">Follow the installation instructions for <a href="http://pypi.python.org/pypi/setuptools">setuptools</a>.<a class="headerlink" href="#follow-the-installation-instructions-for-setuptools" title="Permanent link">&para;</a></h4>
+<h4 id="install-dependencies">Install dependencies<a class="headerlink" href="#install-dependencies" title="Permanent link">&para;</a></h4>
 <div class="codehilite"><pre><span class="n">sudo</span> <span class="n">easy_install</span> <span class="n">Pygments</span>
 <span class="n">sudo</span> <span class="n">easy_install</span> <span class="n">ElementTree</span>
 <span class="n">sudo</span> <span class="n">easy_install</span> <span class="n">Markdown</span>
 </pre></div>
 
 
-<h2 id="directory-layout">Directory Layout</h2>
-<h4 id="content-directory">Content directory</h4>
+<h2 id="directory-layout">Directory Layout<a class="headerlink" href="#directory-layout" title="Permanent link">&para;</a></h2>
+<h4 id="content-directory">Content directory<a class="headerlink" href="#content-directory" title="Permanent link">&para;</a></h4>
 <p>The <code>site/content/odftoolkit</code> directory contains web content - markdown, html, javascript, css, images and other files. Files that do not fit recognized patterns from <code>site/lib/path.pm</code> are copied as is to the web site during the build.</p>
-<h4 id="templates-directory">Templates directory</h4>
+<h4 id="templates-directory">Templates directory<a class="headerlink" href="#templates-directory" title="Permanent link">&para;</a></h4>
 <p>The <code>site/templates</code> directory contains the html skeletons used during the site build.</p>
 <ul>
 <li><code>skeleton.html</code> - our current html page template.</li>
 <li><code>sidenav.mdtext</code> - markdown of the side navigation panel.</li>
 </ul>
-<h4 id="lib-directory">Lib directory</h4>
+<h4 id="lib-directory">Lib directory<a class="headerlink" href="#lib-directory" title="Permanent link">&para;</a></h4>
 <p>The <code>site/lib</code> directory contains two python modules that determine how content files are processed during the site build.</p>
 <ul>
 <li><code>path.pm</code> - maps file patterns like <code>.mdtext</code> into the view building routines. We can expand to cover other patterns.</li>
 <li><code>view.pm</code> - a set of python subroutines for converting content into web pages.</li>
 </ul>
-<h4 id="build-tools">Build tools</h4>
+<h4 id="build-tools">Build tools<a class="headerlink" href="#build-tools" title="Permanent link">&para;</a></h4>
 <p>You can find the CMS build tools in the <code>cms</code> directory.</p>
 <ul>
 <li><code>cms/build/</code> - perl scripts for building the site and markdown extensions.</li>
@@ -163,39 +184,39 @@ repository</a> in your web browser.</p>
 <li><code>cms/webgui/</code> - the webgui behind the <code>bookmarklet</code>.</li>
 </ul>
 <p>These can be extended locally. Before any changes become part of our process they will need to be cleared with Apache Infrastructure. We'll need to submit patches. These should be additive or be bug fixes.</p>
-<h2 id="local-development">Local Development</h2>
-<h3 id="edit-the-site">Edit the site</h3>
+<h2 id="local-development">Local Development<a class="headerlink" href="#local-development" title="Permanent link">&para;</a></h2>
+<h3 id="edit-the-site">Edit the site<a class="headerlink" href="#edit-the-site" title="Permanent link">&para;</a></h3>
 <p>Using your favorite editors edit the site content, templates, and lib scripts.</p>
-<h3 id="python-markdown-daemon">Python Markdown Daemon</h3>
+<h3 id="python-markdown-daemon">Python Markdown Daemon<a class="headerlink" href="#python-markdown-daemon" title="Permanent link">&para;</a></h3>
 <p>Start the Python Markdown daemon.</p>
-<div class="codehilite"><pre><span class="n">export</span> <span class="n">MARKDOWN_SOCKET</span><span class="o">=</span><span class="sb">`pwd`</span><span class="o">/</span><span class="n">markdown</span><span class="o">.</span><span class="nb">socket</span> <span class="n">PYTHONPATH</span><span class="o">=</span><span class="sb">`pwd`</span>
-<span class="n">python</span> <span class="n">cms</span><span class="sr">/build/m</span><span class="n">arkdownd</span><span class="o">.</span><span class="n">py</span>
+<div class="codehilite"><pre><span class="n">export</span> <span class="n">MARKDOWN_SOCKET</span><span class="p">=</span>`<span class="n">pwd</span>`<span class="o">/</span><span class="n">markdown</span><span class="p">.</span><span class="n">socket</span> <span class="n">PYTHONPATH</span><span class="p">=</span>`<span class="n">pwd</span>`
+<span class="n">python</span> <span class="n">cms</span><span class="o">/</span><span class="n">build</span><span class="o">/</span><span class="n">markdownd</span><span class="p">.</span><span class="n">py</span>
 </pre></div>
 
 
-<h3 id="build-the-site">Build the site.</h3>
-<div class="codehilite"><pre><span class="n">cms</span><span class="sr">/build/</span><span class="n">build_site</span><span class="o">.</span><span class="n">pl</span> <span class="o">--</span><span class="n">source</span><span class="o">-</span><span class="n">base</span> <span class="n">site</span> <span class="o">--</span><span class="n">target</span><span class="o">-</span><span class="n">base</span> <span class="n">www</span>
+<h3 id="build-the-site">Build the site.<a class="headerlink" href="#build-the-site" title="Permanent link">&para;</a></h3>
+<div class="codehilite"><pre><span class="n">cms</span><span class="o">/</span><span class="n">build</span><span class="o">/</span><span class="n">build_site</span><span class="p">.</span><span class="n">pl</span> <span class="o">--</span><span class="n">source</span><span class="o">-</span><span class="n">base</span> <span class="n">site</span> <span class="o">--</span><span class="n">target</span><span class="o">-</span><span class="n">base</span> <span class="n">www</span>
 </pre></div>
 
 
-<h3 id="copy-the-site-to-your-computers-web-server">Copy the site to your computer's web server.</h3>
+<h3 id="copy-the-site-to-your-computers-web-server">Copy the site to your computer's web server.<a class="headerlink" href="#copy-the-site-to-your-computers-web-server" title="Permanent link">&para;</a></h3>
 <p>On my Mac:</p>
-<div class="codehilite"><pre><span class="n">sudo</span> <span class="n">scp</span> <span class="o">-</span><span class="n">rp</span> <span class="n">www</span><span class="sr">/content/o</span><span class="n">dftoolkit</span> <span class="sr">/Library/</span><span class="n">WebServer</span><span class="sr">/Documents/</span><span class="o">.</span>
+<div class="codehilite"><pre><span class="n">sudo</span> <span class="n">scp</span> <span class="o">-</span><span class="n">rp</span> <span class="n">www</span><span class="o">/</span><span class="n">content</span><span class="o">/</span><span class="n">odftoolkit</span> <span class="o">/</span><span class="n">Library</span><span class="o">/</span><span class="n">WebServer</span><span class="o">/</span><span class="n">Documents</span><span class="o">/</span><span class="p">.</span>
 </pre></div>
 
 
 <p>The site is then available with <a href="http://localhost/odftoolkit">http://localhost/odftoolkit/</a>.</p>
 <p>Or serve the site directly using the Python SimpleHTTPServer:</p>
-<div class="codehilite"><pre><span class="p">(</span><span class="n">cd</span> <span class="n">www</span><span class="sr">/content/</span> <span class="o">&amp;&amp;</span> <span class="n">python</span> <span class="o">-</span><span class="n">m</span> <span class="n">SimpleHTTPServer</span> <span class="mi">8080</span><span class="p">)</span>
+<div class="codehilite"><pre><span class="p">(</span><span class="n">cd</span> <span class="n">www</span><span class="o">/</span><span class="n">content</span><span class="o">/</span> <span class="o">&amp;&amp;</span> <span class="n">python</span> <span class="o">-</span><span class="n">m</span> <span class="n">SimpleHTTPServer</span> 8080<span class="p">)</span>
 </pre></div>
 
 
 <p>The site is then available with <a href="http://localhost:8080/odftoolkit/">http://localhost:8080/odftoolkit/</a>.</p>
-<h2 id="submitting-your-results">Submitting your results.</h2>
-<h3 id="committer">Committer</h3>
+<h2 id="submitting-your-results">Submitting your results.<a class="headerlink" href="#submitting-your-results" title="Permanent link">&para;</a></h2>
+<h3 id="committer">Committer<a class="headerlink" href="#committer" title="Permanent link">&para;</a></h3>
 <p>Do the appropriate combination of svn status, svn add, and svn commits. Commits will cause staging rebuilds.
 See <a href="docs/edit-cms.html">How to Edit the ODF Toolkit Website</a></p>
-<h3 id="contributor">Contributor</h3>
+<h3 id="contributor">Contributor<a class="headerlink" href="#contributor" title="Permanent link">&para;</a></h3>
 <p>(Add instructions on creating patches.)</p>
 <p>For further information see the <a href="http://www.apache.org/dev/version-control.html">Apache Source Code Repository</a> page.</p>
   </div>



Mime
View raw message