X-Git-Url: https://jxself.org/git/?p=ibg.git;a=blobdiff_plain;f=conf.py;h=d7cd39c416efe6328b594eaff2b9ab8fc36d71a2;hp=540662e056fc6d0ac6401dfcd00bbab04b8872a1;hb=4261ff48a6357e2af0957f5e1b88bdc022243d16;hpb=fd8f547191457928785b8bc38570b05205f369ac diff --git a/conf.py b/conf.py index 540662e..d7cd39c 100644 --- a/conf.py +++ b/conf.py @@ -17,6 +17,10 @@ import sys import string import codecs +import alabaster +if alabaster.version.__version_info__ < (0, 7, 8): + raise RuntimeError("requires albaster 0.7.8 or newer") + # 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. @@ -110,10 +114,8 @@ default_role = "any" # output. They are ignored by default. #show_authors = False -# Global substitutions. -rst_epilog = """ -.. |DM4| replace:: *Inform Designer's Manual* -""" +# Global definitions. +rst_prolog = open("config/defs.rst").read() # External links. extlinks = { @@ -135,6 +137,9 @@ highlight_language = 'none' # If true, `todo` and `todoList` produce output, else they produce nothing. todo_include_todos = True +# Turn off default domain. +primary_domain = None + # -- Options for HTML output ---------------------------------------------- @@ -142,6 +147,9 @@ todo_include_todos = True # a list of builtin themes. html_theme = 'alabaster' +# Override a few things with local CSS style. +html_style = "ibg.css" + # Theme options are theme-specific and customize the look and feel of a theme # further. For a list of options available for each theme, see the # documentation. @@ -150,6 +158,7 @@ html_theme_options = { 'head_font_family': 'Georgia', 'page_width': '1050px', 'show_related': True, + 'fixed_sidebar': True, } # Add any paths that contain custom themes here, relative to this directory. @@ -174,7 +183,7 @@ html_title = project # Add any paths that contain custom static files (such as style sheets) here, # relative to this directory. They are copied after the builtin static files, # so a file named "default.css" will overwrite the builtin "default.css". -#html_static_path = ['static'] +html_static_path = ['static'] # Add any extra paths that contain custom files (such as robots.txt or # .htaccess) here, relative to this directory. These files are copied