26 .PHONY: help clean html web pickle htmlhelp latex changes linkcheck |
26 .PHONY: help clean html web pickle htmlhelp latex changes linkcheck |
27 |
27 |
28 help: |
28 help: |
29 @echo "Please use \`make <target>' where <target> is one of" |
29 @echo "Please use \`make <target>' where <target> is one of" |
30 @echo " all to make standalone HTML files, developer manual and API doc" |
30 @echo " all to make standalone HTML files, developer manual and API doc" |
31 @echo " apidoc to make API doc" |
|
32 @echo " html to make standalone HTML files" |
31 @echo " html to make standalone HTML files" |
33 @echo "--- " |
32 @echo "--- " |
34 @echo " pickle to make pickle files (usable by e.g. sphinx-web)" |
33 @echo " pickle to make pickle files (usable by e.g. sphinx-web)" |
35 @echo " htmlhelp to make HTML files and a HTML help project" |
34 @echo " htmlhelp to make HTML files and a HTML help project" |
36 @echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter" |
35 @echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter" |
37 @echo " changes to make an overview over all changed/added/deprecated items" |
36 @echo " changes to make an overview over all changed/added/deprecated items" |
38 @echo " linkcheck to check all external links for integrity" |
37 @echo " linkcheck to check all external links for integrity" |
39 |
38 |
40 clean: |
39 clean: |
41 rm -rf apidoc/ |
|
42 rm -f *.html |
40 rm -f *.html |
43 -rm -rf ${BUILDDIR}/* |
41 -rm -rf ${BUILDDIR}/* |
44 -rm -rf ${BUILDJS} |
42 -rm -rf ${BUILDJS} |
45 |
43 |
46 all: ${TARGET} apidoc html |
44 all: ${TARGET} html |
47 |
45 |
48 %.html: %.txt |
46 %.html: %.txt |
49 ${MKHTML} ${MKHTMLOPTS} $< |
47 ${MKHTML} ${MKHTMLOPTS} $< |
50 |
|
51 #apydoc: |
|
52 # epydoc --html -o epydoc/ -n ../server/*.py ../core/*.py ../common/*.py ../server/*/*.py ../modpython/*/*.py ../common/*/*.py |
|
53 apidoc: |
|
54 epydoc --html -o apidoc -n "cubicweb" --exclude=setup --exclude=__pkginfo__ ../../../ |
|
55 |
48 |
56 # run sphinx ### |
49 # run sphinx ### |
57 html: js |
50 html: js |
58 mkdir -p ${BUILDDIR}/html ${BUILDDIR}/doctrees |
51 mkdir -p ${BUILDDIR}/html ${BUILDDIR}/doctrees |
59 $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) ${BUILDDIR}/html |
52 $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) ${BUILDDIR}/html |