X-Git-Url: https://jxself.org/git/?p=ibg.git;a=blobdiff_plain;f=conf.py;h=956d4bc187847f645e8a898e5c55e0945f91485e;hp=402eb1c74da80ee0bd6b5adca3b68e4e06044587;hb=abd9bb494e05d4ddebd8363875ba4bd63f993171;hpb=871a8b3e34b3fdb8594fa1faa63210c0ef048aa1 diff --git a/conf.py b/conf.py index 402eb1c..956d4bc 100644 --- a/conf.py +++ b/conf.py @@ -20,12 +20,16 @@ import codecs # If extensions (or modules to document with autodoc) are in another directory, # add these directories to sys.path here. If the directory is relative to the # documentation root, use os.path.abspath to make it absolute, like shown here. -sys.path.insert(0, os.path.abspath('tools')) +sys.path.insert(0, ".") -from transcript import TranscriptLexer +import tools.sphinxpatch + +from tools.inform import InformLexer +from tools.transcript import TranscriptLexer # Setup function. def setup(app): + app.add_lexer('inform', InformLexer()) app.add_lexer('transcript', TranscriptLexer()) # -- General configuration ------------------------------------------------ @@ -38,6 +42,7 @@ def setup(app): # ones. extensions = [ 'sphinx.ext.todo', + 'tools.blockdiag', ] # Add any paths that contain templates here, relative to this directory. @@ -87,7 +92,7 @@ language = None # List of patterns, relative to source directory, that match files and # directories to ignore when looking for source files. -exclude_patterns = ['config', 'output'] +exclude_patterns = ['config', 'output', 'tables'] # The reST default role (used for this markup: `text`) to use for all # documents. @@ -105,7 +110,7 @@ default_role = "any" #show_authors = False # The name of the Pygments (syntax highlighting) style to use. -pygments_style = 'default' +pygments_style = 'friendly' # The default Pygments highlight language. highlight_language = 'none' @@ -226,7 +231,7 @@ htmlhelp_basename = 'IBG' # -- Options for LaTeX output --------------------------------------------- # Title page information. -latex_image = "harry1" +latex_image = "harry_col" latex_image_title = "First Steps" latex_image_info = "(watercolour and crayon on paper, 2002) Harry Firth (2000-)" latex_image_path = os.path.join('images', latex_image + '.png') @@ -285,7 +290,7 @@ latex_documents = [ #latex_use_parts = False # If true, show page references after internal links. -latex_show_pagerefs = False +latex_show_pagerefs = True # If true, show URL addresses after external links. #latex_show_urls = False @@ -331,3 +336,30 @@ texinfo_documents = [ # If true, do not generate a @detailmenu in the "Top" node's menu. #texinfo_no_detailmenu = False + + +# -- Options for block diagrams ------------------------------------------- + +# The paths to truetype fonts. blockdiag_fontpath option accepts both +# single path string and list of paths. +blockdiag_fontpath = [] + +# The path to fontmap definitions. +blockdiag_fontmap = "" + +# Render diagrams in antialias mode or not. +blockdiag_antialias = True + +# Render diagrams as transparency or not. +blockdiag_transparency = True + +# The output image format at generating HTML docs ("PNG" or "SVG"). +blockdiag_html_image_format = "SVG" + +# The output image format at generating PDF docs (through LaTeX). ("PNG" or +# "PDF"). When a value of PDF is specified, you can get clear diagram +# images. In which case, reportlab library is required. +blockdiag_latex_image_format = "PNG" + +# Enable debug mode of blockdiag. +blockdiag_debug = False