X-Git-Url: https://jxself.org/git/?a=blobdiff_plain;f=conf.py;h=540662e056fc6d0ac6401dfcd00bbab04b8872a1;hb=8c07ba7a686f62f8c5d7511c2d29e9c05a9edc04;hp=7546c7521c18936f4d56ae803ab097280522dbcf;hpb=d243892ad9717d0d1cbb0dbc941b229b24a7f09e;p=ibg.git diff --git a/conf.py b/conf.py index 7546c75..540662e 100644 --- a/conf.py +++ b/conf.py @@ -22,10 +22,14 @@ import codecs # documentation root, use os.path.abspath to make it absolute, like shown here. sys.path.insert(0, ".") +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', + 'sphinx.ext.extlinks', 'tools.blockdiag', ] @@ -88,7 +93,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,8 +110,18 @@ default_role = "any" # output. They are ignored by default. #show_authors = False +# Global substitutions. +rst_epilog = """ +.. |DM4| replace:: *Inform Designer's Manual* +""" + +# External links. +extlinks = { + 'dm4': ("http://inform-fiction.org/manual/html/%s", ""), +} + # The name of the Pygments (syntax highlighting) style to use. -pygments_style = 'default' +pygments_style = 'friendly' # The default Pygments highlight language. highlight_language = 'none' @@ -227,7 +242,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') @@ -286,7 +301,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