Permalink
Browse files

Added instructions how developer.plone.org builds are done

  • Loading branch information...
1 parent cf2d921 commit 77908d02d117f984e7c690735fe50ce70b4c1630 @miohtama miohtama committed Oct 16, 2012
View
2 doc-holliday.sh
@@ -7,7 +7,7 @@
#
-deploy_target=/tmp/test-deploy
+deploy_target=/var/www/developer.plone.org/var/public_html
# http://stackoverflow.com/questions/3258243/git-check-if-pull-needed
git pull | grep -q -v 'Already up-to-date.' && changed=1
View
35 source/reference_manuals/active/writing/crosslinking.rst
@@ -25,7 +25,7 @@ collective.developermanual has a section *Reference manuals*
* Manuals will be hosted under *developers.plone.org* domain
-Benefits of having the documentation in developers.plone.org
+Benefits of having the documentation in developer.plone.org
================================================================
The main benefit of having your manual in *developers.plone.org*
@@ -76,4 +76,35 @@ See that your manual gets correctly added in the index::
``conf.py`` creates symlinks in ``source/reference_manuals/external``. If you manage
to mess them reset the situation with the command::
- rm source/reference_manuals/external/*
+ rm source/reference_manuals/external/*
+
+developer.plone.org builds
+================================================
+
+``developer.plone.org`` documentation builds are
+done on *deus2.plone.org* machine in ``/var/www/developer.plone.org``
+folder. They are done by running
+`doc-holliday.sh update script <https://github.com/collective/collective.developermanual/blob/master/doc-holliday.sh>`_ in a crontab created by *deployment.cfg*.
+
+We are looking forward to get our documentation hosted back to *readthedocs.org*, but currently *readthedocs.org*
+do not have buildout support needed in our use case. In any case the docs are plain HTML files.
+
+The deployment is done as following::
+
+ sudo -i
+ mkdir /var/www/developer.plone.org
+ chown apache:apache
+ /var/www/developer.plone.org
+ cd /var/www
+ sudo -u apache git clone git://github.com/collective/collective.developermanual.git developer.plone.org
+ cd developer.plone.org
+ sudo -u apache python bootstrap.py
+ sudo -u apache bin/buildout -c deployment.cfg
+
+The folder where final static HTML files lie is ``/var/www/developer.plone.org/var/public_html``.
+
+
+
+
+
+
View
2 source/reference_manuals/active/writing/nursinghome.rst
@@ -14,7 +14,7 @@ for documentation which is no longer under active maintenance.
This includes
-* Old content from plone.org
+* Old content from plone.org which has been migrated to Sphinx format
* Content from Plone Developer Documentation where the documentation
team feels it no longer reflects the modern Plone versions

0 comments on commit 77908d0

Please sign in to comment.