since this isnt a module its self its a little odd to do this but toctree cant make arbitrary cross-references. Also added some usage examples: http://www.blender.org/documentation/250PythonDoc/bpy.data.html
25 lines
1.1 KiB
Bash
Executable File
25 lines
1.1 KiB
Bash
Executable File
#!/bin/sh
|
|
# run from the blender source dir
|
|
# bash source/blender/python/doc/sphinx_doc_gen.sh
|
|
# ssh upload means you need an account on the server
|
|
|
|
BLENDER="./blender.bin"
|
|
SSH_HOST="ideasman42@emo.blender.org"
|
|
SSH_UPLOAD="/data/www/vhosts/www.blender.org/documentation/250PythonDoc"
|
|
|
|
# dont delete existing docs, now partial updates are used for quick builds.
|
|
$BLENDER --background --python ./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@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
|