Browse Source

Fixed #19266 -- Added Texinfo documentation target

Thanks orontee for the report and initial patch.
Claude Paroz 12 years ago
parent
commit
a79d920a56
3 changed files with 25 additions and 0 deletions
  1. 6 0
      docs/Makefile
  2. 10 0
      docs/conf.py
  3. 9 0
      docs/make.bat

+ 6 - 0
docs/Makefile

@@ -31,6 +31,7 @@ help:
 	@echo "  latexpdf   to make LaTeX files and run them through pdflatex"
 	@echo "  text       to make text files"
 	@echo "  man        to make manual pages"
+	@echo "  texinfo    to make a Texinfo source file"
 	@echo "  gettext    to make PO message catalogs"
 	@echo "  changes    to make an overview of all changed/added/deprecated items"
 	@echo "  linkcheck  to check all external links for integrity"
@@ -116,6 +117,11 @@ man:
 	@echo
 	@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
 
+texinfo:
+	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
+	@echo
+	@echo "Build finished; the Texinfo files are in $(BUILDDIR)/texinfo."
+
 gettext:
 	$(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
 	@echo

+ 10 - 0
docs/conf.py

@@ -248,6 +248,16 @@ man_pages = [
 ]
 
 
+# -- Options for Texinfo output ------------------------------------------------
+
+# List of tuples (startdocname, targetname, title, author, dir_entry,
+# description, category, toctree_only)
+texinfo_documents=[(
+    master_doc, "django", "", "", "Django",
+    "Documentation of the Django framework", "Web development", False
+)]
+
+
 # -- Options for Epub output ---------------------------------------------------
 
 # Bibliographic Dublin Core info.

+ 9 - 0
docs/make.bat

@@ -29,6 +29,7 @@ if "%1" == "help" (
 	echo.  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter
 	echo.  text       to make text files
 	echo.  man        to make manual pages
+	echo.  texinfo    to make a Texinfo source file
 	echo.  gettext    to make PO message catalogs
 	echo.  changes    to make an overview over all changed/added/deprecated items
 	echo.  linkcheck  to check all external links for integrity
@@ -143,6 +144,14 @@ if "%1" == "man" (
 	goto end
 )
 
+if "%1" == "texinfo" (
+	%SPHINXBUILD% -b texinfo %ALLSPHINXOPTS% %BUILDDIR%/texinfo
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Build finished. The Texinfo files are in %BUILDDIR%/texinfo.
+	goto end
+)
+
 if "%%1" == "gettext" (
 	%SPHINXBUILD% -b gettext %I18NSPHINXOPTS% %BUILDDIR%/locale
 	if errorlevel 1 exit /b 1