IntenseWebs/sphinx
3
0
Fork 0
mirror of https://github.com/sphinx-doc/sphinx.git synced 2025-02-25 18:55:22 -06:00
Code Issues Packages Projects Releases Wiki Activity

Move jinja external to svn.python.org, extend Makefile.

Browse Source
This commit is contained in:
Georg Brandl 2007-08-10 05:59:40 +00:00
parent b1271fa623
commit e61378d74f
4 changed files with 40 additions and 32 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

31
Doc-26/Makefile
View File

@ -3,10 +3,14 @@
# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
# #
PYTHON = python # You can set these variables from the command line.
SVNROOT = http://svn.python.org/projects PYTHON ?= python
SVNROOT ?= http://svn.python.org/projects
SPHINXOPTS ?=
.PHONY: help checkout html web htmlhelp clean ALLSPHINXOPTS = -b$(BUILDER) -dbuild/doctrees $(SPHINXOPTS) . build/$(BUILDER)
.PHONY: help checkout update build html web htmlhelp clean
help: help:
@echo "Please use \`make <target>' where <target> is one of" @echo "Please use \`make <target>' where <target> is one of"
@ -33,24 +37,23 @@ update:
svn update tools/docutils svn update tools/docutils
svn update tools/pygments svn update tools/pygments
html: checkout build: checkout
mkdir -p build/html build/doctrees mkdir -p build/$(BUILDER) build/doctrees
$(PYTHON) tools/sphinx-build.py -bhtml -dbuild/doctrees . build/html $(PYTHON) tools/sphinx-build.py $(ALLSPHINXOPTS)
@echo @echo
html: BUILDER = html
html: build
@echo "Build finished. The HTML pages are in build/html." @echo "Build finished. The HTML pages are in build/html."
web: checkout web: BUILDER = web
mkdir -p build/web build/doctrees web: build
$(PYTHON) tools/sphinx-build.py -bweb -dbuild/doctrees . build/web
@echo
@echo "Build finished; now you can run" @echo "Build finished; now you can run"
@echo " PYTHONPATH=tools $(PYTHON) -m sphinx.web build/web" @echo " PYTHONPATH=tools $(PYTHON) -m sphinx.web build/web"
@echo "to start the server." @echo "to start the server."
htmlhelp: checkout htmlhelp: BUILDER = htmlhelp
mkdir -p build/hhp build/doctrees htmlhelp: build
$(PYTHON) tools/sphinx-build.py -bhtmlhelp -dbuild/doctrees . build/hhp
@echo
@echo "Build finished; now you can run HTML Help Workshop with the" \ @echo "Build finished; now you can run HTML Help Workshop with the" \
"build/hhp/pydoc.hhp project file." "build/hhp/pydoc.hhp project file."

5
Doc-26/README.txt
View File

@ -16,8 +16,9 @@ Building the docs
You need to install Python 2.5 or higher; the toolset used to build the docs are You need to install Python 2.5 or higher; the toolset used to build the docs are
written in Python. The toolset used to build the documentation is called written in Python. The toolset used to build the documentation is called
*Sphinx*, it is not included in this tree, but maintained separately in the *Sphinx*, it is not included in this tree, but maintained separately in the
Python Subversion repository. Also needed are Jinja, a templating engine, and Python Subversion repository. Also needed are Jinja, a templating engine
optionally Pygments, a code highlighter. (included in Sphinx as a Subversion external), and optionally Pygments, a code
highlighter.
Using make Using make

31
Doc-3k/Makefile
View File

@ -3,10 +3,14 @@
# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
# #
PYTHON = python # You can set these variables from the command line.
SVNROOT = http://svn.python.org/projects PYTHON ?= python
SVNROOT ?= http://svn.python.org/projects
SPHINXOPTS ?=
.PHONY: help checkout html web htmlhelp clean ALLSPHINXOPTS = -b$(BUILDER) -dbuild/doctrees $(SPHINXOPTS) . build/$(BUILDER)
.PHONY: help checkout update build html web htmlhelp clean
help: help:
@echo "Please use \`make <target>' where <target> is one of" @echo "Please use \`make <target>' where <target> is one of"
@ -33,24 +37,23 @@ update:
svn update tools/docutils svn update tools/docutils
svn update tools/pygments svn update tools/pygments
html: checkout build: checkout
mkdir -p build/html build/doctrees mkdir -p build/$(BUILDER) build/doctrees
$(PYTHON) tools/sphinx-build.py -bhtml -dbuild/doctrees . build/html $(PYTHON) tools/sphinx-build.py $(ALLSPHINXOPTS)
@echo @echo
html: BUILDER = html
html: build
@echo "Build finished. The HTML pages are in build/html." @echo "Build finished. The HTML pages are in build/html."
web: checkout web: BUILDER = web
mkdir -p build/web build/doctrees web: build
$(PYTHON) tools/sphinx-build.py -bweb -dbuild/doctrees . build/web
@echo
@echo "Build finished; now you can run" @echo "Build finished; now you can run"
@echo " PYTHONPATH=tools $(PYTHON) -m sphinx.web build/web" @echo " PYTHONPATH=tools $(PYTHON) -m sphinx.web build/web"
@echo "to start the server." @echo "to start the server."
htmlhelp: checkout htmlhelp: BUILDER = htmlhelp
mkdir -p build/hhp build/doctrees htmlhelp: build
$(PYTHON) tools/sphinx-build.py -bhtmlhelp -dbuild/doctrees . build/hhp
@echo
@echo "Build finished; now you can run HTML Help Workshop with the" \ @echo "Build finished; now you can run HTML Help Workshop with the" \
"build/hhp/pydoc.hhp project file." "build/hhp/pydoc.hhp project file."

5
Doc-3k/README.txt
View File

@ -16,8 +16,9 @@ Building the docs
You need to install Python 2.5 or higher; the toolset used to build the docs are You need to install Python 2.5 or higher; the toolset used to build the docs are
written in Python. The toolset used to build the documentation is called written in Python. The toolset used to build the documentation is called
*Sphinx*, it is not included in this tree, but maintained separately in the *Sphinx*, it is not included in this tree, but maintained separately in the
Python Subversion repository. Also needed are Jinja, a templating engine, and Python Subversion repository. Also needed are Jinja, a templating engine
optionally Pygments, a code highlighter. (included in Sphinx as a Subversion external), and optionally Pygments, a code
highlighter.
Using make Using make