[Epydoc-commits] SF.net SVN: epydoc: [1772] trunk/epydoc

[<ed...@us...>]

Revision: 1772
          http://epydoc.svn.sourceforge.net/epydoc/?rev=1772&view=rev
Author:   edloper
Date:     2008-02-23 19:43:33 -0800 (Sat, 23 Feb 2008)

Log Message:
-----------
- Added section to the manual's reference chapter, talking about how
  to customize latex/pdf output.

Modified Paths:
--------------
    trunk/epydoc/Makefile
    trunk/epydoc/doc/manual-reference.txt

Modified: trunk/epydoc/Makefile
===================================================================
--- trunk/epydoc/Makefile	2008-02-24 03:42:42 UTC (rev 1771)
+++ trunk/epydoc/Makefile	2008-02-24 03:43:33 UTC (rev 1772)
@@ -17,7 +17,7 @@
 MANUAL_SRC = $(wildcard doc/manual-*.txt)
 
 # What version of python to use?
-PYTHON = python
+PYTHON = python2.5
 
 # The location of the webpage.
 HOST = shell.sf.net
@@ -43,9 +43,9 @@
 EPYDOC = $(PYTHON) src/epydoc/cli.py
 export PYTHONPATH=src/
 
-# Options for rst->html converter
 RST2HTML = $(PYTHON) src/tools/rst2html.py
 MKDISPATCH = $(PYTHON) src/tools/mkdispatch.py
+STY2HTML = $(PYTHON) src/tools/sty2html.py
 
 DOCTEST_HTML_FILES := \
     $(DOCTESTS:src/epydoc/test/%.doctest=$(HTML_DOCTEST)/%.html)
@@ -110,10 +110,11 @@
 
 manual-html: $(MANUAL_HTML_FILES)
 
-$(HTML_MANUAL)/epydoc.html: doc/manual.txt $(MANUAL_SRC)
+$(HTML_MANUAL)/epydoc.html: doc/manual.txt $(MANUAL_SRC) \
+                            doc/epydoc-style-list.txt
 	$(RST2HTML) doc/manual.txt $@ --template=doc/rst-template.txt
 
-$(HTML_MANUAL)/manual-%.html: doc/manual-%.txt
+$(HTML_MANUAL)/manual-%.html: doc/manual-%.txt doc/epydoc-style-list.txt
 	echo ".. include:: ../$<"        > doc/tmp.txt
 	$(MKDISPATCH) $(MANUAL_SRC)     >> doc/tmp.txt
 	$(RST2HTML) doc/tmp.txt $@ --template=doc/rst-template.txt
@@ -234,6 +235,11 @@
 	       --docformat plaintext -v --graph all $(PY_SRC)
 	rm -rf profile.tmp hotshot.out
 
+# Convert standard style files to html
+doc/epydoc-style-list.txt: src/epydoc/docwriter/latex_sty.py \
+                           src/tools/sty2html.py
+	$(STY2HTML) $(WEBDIR)
+
 ##//////////////////////////////////////////////////////////////////////
 ## Standard Library docs
 ##//////////////////////////////////////////////////////////////////////

Modified: trunk/epydoc/doc/manual-reference.txt
===================================================================
--- trunk/epydoc/doc/manual-reference.txt	2008-02-24 03:42:42 UTC (rev 1771)
+++ trunk/epydoc/doc/manual-reference.txt	2008-02-24 03:43:33 UTC (rev 1772)
@@ -294,6 +294,22 @@
     **#fail-on: error**
 
 
+Customizing LaTeX and PDF Output
+--------------------------------
+
+Epydoc's LaTeX output, and the outputs that are derived from it (dvi,
+ps, and pdf), can be customized by creating a custom LaTeX style file.
+To help you create custom stylesheets, a complete description of the
+specialized LaTeX commands that epydoc uses to generate its output is
+available here:
+
+- `Epydoc LaTeX Style Reference <epydoc-latex-demo.html>`__
+
+Additionaly, you may find it useful to look at the builtin style files
+that epydoc provides:
+
+.. include:: epydoc-style-list.txt
+
 Warnings and Errors
 -------------------
 


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.