| # What is the doco pub? |
| This publication is created with the aim to be a generic documentation publication for Apache wide usage. |
| |
| The first projects to test it are the Apache Forrest and the Apache Lenya project. |
| |
| The idea is to manage the content via the Apache Lenya CMS and export it via Apache Forrest. |
| |
| # How to install? |
| ## Download |
| You need to have the svn head of lenya and forrest: |
| svn co https://svn.apache.org/repos/asf/lenya/trunk lenya-trunk |
| svn co https://svn.apache.org/repos/asf/forrest/trunk forrest-trunk |
| |
| Further you need to download the doco pub: |
| svn co https://svn.apache.org/repos/asf/lenya/sandbox/doco doco |
| |
| We will refer to the checkouts {lenya-trunk} for lenya and {forrest-trunk} for forrest |
| and {doco} for the doco pub. |
| |
| ## Install forrest/lenya |
| Follow |
| http://forrest.apache.org/docs_0_80/build.html |
| and |
| http://lenya.apache.org/1_4/installation/source_version.html |
| |
| ##Install lenya docu pub. |
| Since we are using a specific pub we need to tell lenya about it. |
| In your {lenya-trunk}/local.build.properties |
| *** NOTE: |
| *** If you not yet have them do |
| *** cp {lenya-trunk}/build.properties {lenya-trunk}/local.build.properties) |
| you need to |
| 1) add the pub: |
| pubs.root.dirs={doco}:{pubs.root.dirs.more.pubs} |
| 2) add the modules: |
| modules.root.dirs={doco}/modules:{modules.root.dirs.more.modules} |
| 3) change the default port |
| web.app.server.jetty.port=9999 |
| |
| Since we are using an external content dir we will need to override the publication.xconf |
| 1) cp {doco}/config/publication.xconf {doco}/config/local.publication.xconf |
| 2) change <content-dir src="/home/thorsten/src/apache/forrest-trunk/whiteboard/doco"/> to |
| <content-dir src="{forrest-trunk}/whiteboard/doco"/> for forrest (we will start with this) |
| |
| # Start |
| ## CMS mode |
| For authoring start lenya with |
| {lenya-trunk}/build.sh |
| {lenya-trunk}/lenya.sh |
| http://localhost:9999/doco/authoring/index.html |
| ## Render mode |
| To render your lenya site with forrest first you will need to deploy |
| locally some plugins (first time and after ./build.sh clean) and then start forrest. |
| 1) deploy locally |
| cd {forrest-trunk}/whiteboard/plugins/org.apache.forrest.themes.core |
| $FORREST_HOME/tools/ant/bin/ant local-deploy |
| cd ../org.apache.forrest.plugin.internal.dispatcher |
| $FORREST_HOME/tools/ant/bin/ant local-deploy |
| cd ../org.apache.forrest.plugin.input.Lenya |
| $FORREST_HOME/tools/ant/bin/ant local-deploy |
| 2) Run forrest, run ;) |
| cd $FORREST_HOME/whiteboard/doco |
| forrest run |
| http://localhost:8888/index.html |
| |
| WARNING |
| This is a prototype ONLY for now, do not use it in production!!! |
| |
| NOTE |
| For now we are rendering the authoring area only and do not support |
| the live are. This will change. |
| |
| TODO |
| * lenya |
| - create forrest enabler usecase in lenya/doco. We need a basic usecase that adds forrest |
| specific files to a lenya pub. |
| - create a forrest export usecase in lenya/doco. We need a basic usecase that |
| communicate via ant with forrest and invoke e.g. forrestbot, forrest site, ... |