Changeset 143 for trunk/docs
- Timestamp:
- 02/27/12 13:47:56 (12 years ago)
- Location:
- trunk/docs/docs_dev
- Files:
-
- 3 added
- 2 edited
Legend:
- Unmodified
- Added
- Removed
-
trunk/docs/docs_dev/Makefile
r137 r143 3 3 4 4 # You can set these variables from the command line. 5 SPHINXOPTS = 5 SPHINXOPTS = 6 6 SPHINXBUILD = sphinx-build 7 7 PAPER = … … 11 11 PAPEROPT_a4 = -D latex_paper_size=a4 12 12 PAPEROPT_letter = -D latex_paper_size=letter 13 ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) source 13 ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) source 14 14 15 .PHONY: help clean html dirhtml pickle json htmlhelp qthelp latexchanges linkcheck doctest15 .PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest 16 16 17 17 help: 18 18 @echo "Please use \`make <target>' where <target> is one of" 19 @echo " html to make standalone HTML files" 20 @echo " dirhtml to make HTML files named index.html in directories" 21 @echo " pickle to make pickle files" 22 @echo " json to make JSON files" 23 @echo " htmlhelp to make HTML files and a HTML help project" 24 @echo " qthelp to make HTML files and a qthelp project" 25 @echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter" 26 @echo " changes to make an overview of all changed/added/deprecated items" 27 @echo " linkcheck to check all external links for integrity" 28 @echo " doctest to run all doctests embedded in the documentation (if enabled)" 19 @echo " html to make standalone HTML files" 20 @echo " dirhtml to make HTML files named index.html in directories" 21 @echo " singlehtml to make a single large HTML file" 22 @echo " pickle to make pickle files" 23 @echo " json to make JSON files" 24 @echo " htmlhelp to make HTML files and a HTML help project" 25 @echo " qthelp to make HTML files and a qthelp project" 26 @echo " devhelp to make HTML files and a Devhelp project" 27 @echo " epub to make an epub" 28 @echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter" 29 @echo " latexpdf to make LaTeX files and run them through pdflatex" 30 @echo " text to make text files" 31 @echo " man to make manual pages" 32 @echo " changes to make an overview of all changed/added/deprecated items" 33 @echo " linkcheck to check all external links for integrity" 34 @echo " doctest to run all doctests embedded in the documentation (if enabled)" 29 35 30 36 clean: … … 40 46 @echo 41 47 @echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml." 48 49 singlehtml: 50 $(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml 51 @echo 52 @echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml." 42 53 43 54 pickle: … … 62 73 @echo "Build finished; now you can run "qcollectiongenerator" with the" \ 63 74 ".qhcp project file in $(BUILDDIR)/qthelp, like this:" 64 @echo "# qcollectiongenerator $(BUILDDIR)/qthelp/ superbib.qhcp"75 @echo "# qcollectiongenerator $(BUILDDIR)/qthelp/SUPERBIB.qhcp" 65 76 @echo "To view the help file:" 66 @echo "# assistant -collectionFile $(BUILDDIR)/qthelp/superbib.qhc" 77 @echo "# assistant -collectionFile $(BUILDDIR)/qthelp/SUPERBIB.qhc" 78 79 devhelp: 80 $(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp 81 @echo 82 @echo "Build finished." 83 @echo "To view the help file:" 84 @echo "# mkdir -p $$HOME/.local/share/devhelp/SUPERBIB" 85 @echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/SUPERBIB" 86 @echo "# devhelp" 87 88 epub: 89 $(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub 90 @echo 91 @echo "Build finished. The epub file is in $(BUILDDIR)/epub." 67 92 68 93 latex: … … 70 95 @echo 71 96 @echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex." 72 @echo "Run \`make all-pdf' or \`make all-ps' in that directory to" \ 73 "run these through (pdf)latex." 97 @echo "Run \`make' in that directory to run these through (pdf)latex" \ 98 "(use \`make latexpdf' here to do that automatically)." 99 100 latexpdf: 101 $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex 102 @echo "Running LaTeX files through pdflatex..." 103 make -C $(BUILDDIR)/latex all-pdf 104 @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex." 105 106 text: 107 $(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text 108 @echo 109 @echo "Build finished. The text files are in $(BUILDDIR)/text." 110 111 man: 112 $(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man 113 @echo 114 @echo "Build finished. The manual pages are in $(BUILDDIR)/man." 74 115 75 116 changes: -
trunk/docs/docs_dev/source/conf.py
r140 r143 1 1 # -*- coding: utf-8 -*- 2 2 # 3 # superbibdocumentation build configuration file, created by4 # sphinx-quickstart on Wed Mar 10 16:19:33 2010.3 # SUPERBIB documentation build configuration file, created by 4 # sphinx-quickstart on Mon Feb 27 13:21:08 2012. 5 5 # 6 6 # This file is execfile()d with the current directory set to its containing dir. … … 11 11 # All configuration values have a default; values that are commented out 12 12 # serve to show the default. 13 #14 #+15 #16 # TODO17 # ====18 #19 # - fplod 20100621T075245Z aedon.locean-ipsl.upmc.fr (Darwin)20 #21 # * use a specific index.rst for man troff22 # * find a way to avoird hard coded man pages name here (should be in23 # adm/makefile)24 #25 # EVOLUTIONS26 # ==========27 #28 # $Id$29 #30 # * produce man page for almost all shell scripts31 #32 #-33 13 34 14 import sys, os … … 37 17 # add these directories to sys.path here. If the directory is relative to the 38 18 # documentation root, use os.path.abspath to make it absolute, like shown here. 39 sys.path.append(os.path.abspath('/usr/home/fplod/src/superbib_ws/adm/sphinx_tmpdir/source/')) 40 19 #sys.path.insert(0, os.path.abspath('.')) 41 20 42 21 # -- General configuration ----------------------------------------------------- 22 23 # If your documentation needs a minimal Sphinx version, state it here. 24 #needs_sphinx = '1.0' 43 25 44 26 # Add any Sphinx extension module names here, as strings. They can be extensions 45 27 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones. 46 extensions = ['sphinx.ext.todo'] 47 todo_include_todos = True 48 28 extensions = ['sphinx.ext.autodoc', 'sphinx.ext.doctest', 'sphinx.ext.intersphinx', 'sphinx.ext.todo', 'sphinx.ext.coverage', 'sphinx.ext.pngmath', 'sphinx.ext.ifconfig', 'sphinx.ext.viewcode'] 49 29 50 30 # Add any paths that contain templates here, relative to this directory. … … 55 35 56 36 # The encoding of source files. 57 source_encoding = 'iso-8859-15'37 #source_encoding = 'utf-8-sig' 58 38 59 39 # The master toctree document. … … 61 41 62 42 # General information about the project. 63 project = u' superbib'64 copyright = u'201 0, CNRS'43 project = u'SUPERBIB' 44 copyright = u'2012, fp' 65 45 66 46 # The version info for the project you're documenting, acts as replacement for … … 69 49 # 70 50 # The short X.Y version. 71 version = ' 1.0.0'51 version = '2.0' 72 52 # The full version, including alpha/beta/rc tags. 73 release = ' 1.0.0'53 release = '2.0' 74 54 75 55 # The language for content autogenerated by Sphinx. Refer to documentation 76 56 # for a list of supported languages. 77 language = 'en' 57 #language = None 78 58 79 59 # There are two options for replacing |today|: either, you set today to some … … 82 62 # Else, today_fmt is used as the format for a strftime call. 83 63 #today_fmt = '%B %d, %Y' 84 today_fmt = '%Y%m%d' 85 86 # List of documents that shouldn't be included in the build. 87 #unused_docs = [] 88 89 # List of directories, relative to source directory, that shouldn't be searched 90 # for source files. 91 exclude_trees = [] 92 93 exclude_dirnames = ['.svn'] 64 65 # List of patterns, relative to source directory, that match files and 66 # directories to ignore when looking for source files. 67 exclude_patterns = [] 94 68 95 69 # The reST default role (used for this markup: `text`) to use for all documents. … … 111 85 112 86 # A list of ignored prefixes for module index sorting. 113 modindex_common_prefix = []87 #modindex_common_prefix = [] 114 88 115 89 116 90 # -- Options for HTML output --------------------------------------------------- 117 91 118 # The theme to use for HTML and HTML Help pages. Major themes that come with119 # Sphinx are currently 'default' and 'sphinxdoc'.92 # The theme to use for HTML and HTML Help pages. See the documentation for 93 # a list of builtin themes. 120 94 html_theme = 'default' 121 95 … … 162 136 # Additional templates that should be rendered to pages, maps page names to 163 137 # template names. 164 html_additional_pages = {'index': 'index.html'}138 #html_additional_pages = {} 165 139 166 140 # If false, no module index is generated. 167 html_use_modindex= True141 #html_domain_indices = True 168 142 169 143 # If false, no index is generated. 170 html_use_index = True144 #html_use_index = True 171 145 172 146 # If true, the index is split into individual pages for each letter. … … 174 148 175 149 # If true, links to the reST sources are added to the pages. 176 html_show_sourcelink = False 150 #html_show_sourcelink = True 151 152 # If true, "Created using Sphinx" is shown in the HTML footer. Default is True. 153 #html_show_sphinx = True 154 155 # If true, "(C) Copyright ..." is shown in the HTML footer. Default is True. 156 #html_show_copyright = True 177 157 178 158 # If true, an OpenSearch description file will be output, and all pages will … … 181 161 #html_use_opensearch = '' 182 162 183 # If nonempty, this is the file name suffix for HTML files (e.g. ".xhtml").184 #html_file_suffix = ''163 # This is the file name suffix for HTML files (e.g. ".xhtml"). 164 #html_file_suffix = None 185 165 186 166 # Output file base name for HTML help builder. 187 htmlhelp_basename = ' superbib_tools'167 htmlhelp_basename = 'SUPERBIBdoc' 188 168 189 169 … … 199 179 # (source start file, target name, title, author, documentclass [howto/manual]). 200 180 latex_documents = [ 201 ('index', ' superbib.tex', u'Superbib toolsDocumentation',202 u' Francoise Pinsard', 'manual'),181 ('index', 'SUPERBIB.tex', u'SUPERBIB Documentation', 182 u'fp', 'manual'), 203 183 ] 204 184 … … 211 191 #latex_use_parts = False 212 192 193 # If true, show page references after internal links. 194 #latex_show_pagerefs = False 195 196 # If true, show URL addresses after external links. 197 #latex_show_urls = False 198 213 199 # Additional stuff for the LaTeX preamble. 214 200 #latex_preamble = '' … … 218 204 219 205 # If false, no module index is generated. 220 #latex_ use_modindex= True221 222 keep_warnings = 'True' 206 #latex_domain_indices = True 207 208 223 209 # -- Options for manual page output -------------------------------------------- 224 210 … … 226 212 # (source start file, name, description, authors, manual section). 227 213 man_pages = [ 228 ('index', 'SUPERBIB', u'SUPERBIB Documentation', [u'fp'], 1), 229 ('before.sh', 'before.sh', u'before.sh Documentation', [u'fp'], 1), 230 ('bibopa.sh', 'bibopa.sh', u'bibopa.sh Documentation', [u'fp'], 1), 231 ('install.sh', 'install.sh', u'install.sh Documentation', [u'fp'], 1), 232 ('linkchecker.sh', 'linkchecker.sh', u'linkchecker.sh Documentation', [u'fp'], 1), 233 ('mailtouser.sh', 'mailtouser.sh', u'mailtouser.sh Documentation', [u'fp'], 1), 234 ('superbib_profile.sh', 'superbib_profile.sh', u'superbib_profile.sh Documentation', [u'fp'], 1), 235 ('twindoi.sh', 'twindoi.sh', u'twindoi.sh Documentation', [u'fp'], 1) 214 ('index', 'superbib', u'SUPERBIB Documentation', 215 [u'fp'], 1) 236 216 ] 217 218 219 # -- Options for Epub output --------------------------------------------------- 220 221 # Bibliographic Dublin Core info. 222 epub_title = u'SUPERBIB' 223 epub_author = u'fp' 224 epub_publisher = u'fp' 225 epub_copyright = u'2012, fp' 226 227 # The language of the text. It defaults to the language option 228 # or en if the language is not set. 229 #epub_language = '' 230 231 # The scheme of the identifier. Typical schemes are ISBN or URL. 232 #epub_scheme = '' 233 234 # The unique identifier of the text. This can be a ISBN number 235 # or the project homepage. 236 #epub_identifier = '' 237 238 # A unique identification for the text. 239 #epub_uid = '' 240 241 # HTML files that should be inserted before the pages created by sphinx. 242 # The format is a list of tuples containing the path and title. 243 #epub_pre_files = [] 244 245 # HTML files shat should be inserted after the pages created by sphinx. 246 # The format is a list of tuples containing the path and title. 247 #epub_post_files = [] 248 249 # A list of files that should not be packed into the epub file. 250 #epub_exclude_files = [] 251 252 # The depth of the table of contents in toc.ncx. 253 #epub_tocdepth = 3 254 255 # Allow duplicate toc entries. 256 #epub_tocdup = True 257 258 259 # Example configuration for intersphinx: refer to the Python standard library. 260 intersphinx_mapping = {'http://docs.python.org/': None}
Note: See TracChangeset
for help on using the changeset viewer.