cocoon-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From da...@cocoon.zones.apache.org
Subject [DAISY] Updated: How to publish docs to cocoon.apache.org
Date Fri, 12 Oct 2007 06:57:24 GMT
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>


Mime
View raw message