[Bf-blender-cvs] SVN commit: /data/svn/bf-blender [27613] branches/render25/source/blender/ python/doc: shell script for building and uploading html and pdf reference doc

[Campbell Barton]

Revision: 27613
          http://projects.blender.org/plugins/scmsvn/viewcvs.php?view=rev&root=bf-blender&revision=27613
Author:   campbellbarton
Date:     2010-03-19 12:57:39 +0100 (Fri, 19 Mar 2010)

Log Message:
-----------
shell script for building and uploading html and pdf reference doc

Modified Paths:
--------------
    branches/render25/source/blender/python/doc/sphinx_doc_gen.py

Added Paths:
-----------
    branches/render25/source/blender/python/doc/sphinx_doc_gen.sh

Modified: branches/render25/source/blender/python/doc/sphinx_doc_gen.py
===================================================================
--- branches/render25/source/blender/python/doc/sphinx_doc_gen.py	2010-03-19 09:22:00 UTC (rev 27612)
+++ branches/render25/source/blender/python/doc/sphinx_doc_gen.py	2010-03-19 11:57:39 UTC (rev 27613)
@@ -277,6 +277,8 @@
     fw("\n")
     fw("An introduction to blender and python can be found at <http://wiki.blender.org/index.php/Dev:2.5/Py/API/Intro>\n")
     fw("\n")
+    fw("`A PDF version of this document is also available <blender_python_reference_250.pdf>`__\n")
+    fw("\n")
     fw(".. warning:: The Python API in Blender is **UNSTABLE**, It should only be used for testing, any script written now may break in future releases.\n")
     fw("   \n")
     fw("   The following areas are subject to change.\n")

Added: branches/render25/source/blender/python/doc/sphinx_doc_gen.sh
===================================================================
--- branches/render25/source/blender/python/doc/sphinx_doc_gen.sh	                        (rev 0)
+++ branches/render25/source/blender/python/doc/sphinx_doc_gen.sh	2010-03-19 11:57:39 UTC (rev 27613)
@@ -0,0 +1,25 @@
+#!/bin/sh
+# run from the blender source dir
+#   bash source/blender/python/doc/sphinx_doc_gen.sh
+# ssh upload means you need a login into the server
+
+BLENDER="./blender.bin"
+SSH_HOST="ideasman42 at emo.blender.org"
+SSH_UPLOAD="/data/www/vhosts/www.blender.org/documentation/250PythonDoc"
+
+# clear doc dir
+rm -rf ./source/blender/python/doc/sphinx-in ./source/blender/python/doc/sphinx-out
+$BLENDER -b -P ./source/blender/python/doc/sphinx_doc_gen.py
+
+# html
+sphinx-build source/blender/python/doc/sphinx-in source/blender/python/doc/sphinx-out
+cp source/blender/python/doc/sphinx-out/contents.html source/blender/python/doc/sphinx-out/index.html
+ssh ideasman42 at emo.blender.org 'rm -rf '$SSH_UPLOAD'/*'
+rsync --progress -avze "ssh -p 22" /b/source/blender/python/doc/sphinx-out/* $SSH_HOST:$SSH_UPLOAD/
+
+# pdf
+sphinx-build -b latex source/blender/python/doc/sphinx-in source/blender/python/doc/sphinx-out
+cd source/blender/python/doc/sphinx-out
+make
+cd ../../../../../
+rsync --progress -avze "ssh -p 22" source/blender/python/doc/sphinx-out/contents.pdf $SSH_HOST:$SSH_UPLOAD/blender_python_reference_250.pdf