A document has been updated:
http://cocoon.zones.apache.org/daisy/documentation/1418.html
Document ID: 1418
Branch: main
Language: default
Name: How to publish docs to cocoon.apache.org (unchanged)
Document Type: Cocoon Document (unchanged)
Updated on: 10/12/07 6:57:01 AM
Updated by: Reinhard Pötz
A new version has been created, state: publish
Parts
=====
Content
-------
This part has been updated.
Mime type: text/xml (unchanged)
File name: (unchanged)
Size: 1423 bytes (previous version: 37 bytes)
Content diff:
--- <html><body><p>TODO</p></body></html>
+++ <html>
+++ <body>
+++
+++ <p>If you want to publish the Cocoon docs you can follow one of those two
paths:
+++ </p>
+++
+++ <ul>
+++ <li>use the nightly build on cocoon.zones.apache.org</li>
+++ <li>build the docs at your local machine</li>
+++ </ul>
+++
+++ <h1>Use the nightly build</h1>
+++
+++ <p>There is a nightly build (runs at 2am UTC) of our docs available at
+++ cocoon.zones.apache.org. Login via ssh and use the 'maven' user:</p>
+++
+++ <pre>sudo su - maven</pre>
+++
+++ <p>Then change to</p>
+++
+++ <pre>cd ~/svn-site-generation</pre>
+++
+++ <p>There you will find a directory <tt>svn-docs</tt>. It contains a recent
+++ checkout (= part of the nightly docs build) and the result of the docs
+++ generation process copied over. Using</p>
+++
+++ <pre>svn st svn-docs</pre>
+++
+++ <p>will show you all the differences.</p>
+++
+++ <p>If you want to add all the newly generated docs run</p>
+++
+++ <pre>svn st | grep "\?" | awk '{print $2}' | xargs svn add
+++ </pre>
+++
+++ <p>which will recursivly add all new documents.<br/>
+++ When you now what you want to add to the official site, run</p>
+++
+++ <pre>svn ci [path]</pre>
+++
+++ <p>That's it. When the docs are committed to the SVN, they will be published
+++ within the next 60 minutes.</p>
+++
+++ <h1>Build the docs locally</h1>
+++
+++ <p>Actually it's the same as using the nightly build. The only difference is
+++ that you have to build the docs yourself. The <a href="daisy:1256">How to
build
+++ the docs locally guide</a> explains how you can do this. Then follow the
steps
+++ from above.</p>
+++
+++ </body>
+++ </html>
