|
5 | 5 | from os.path import dirname, relpath
|
6 | 6 |
|
7 | 7 | import alagitpull
|
| 8 | +from recommonmark.transform import AutoStructify |
8 | 9 |
|
9 | 10 | import libtmux # NOQA
|
10 | 11 | from libtmux import test # NOQA
|
|
30 | 31 | 'sphinx.ext.napoleon',
|
31 | 32 | 'alagitpull',
|
32 | 33 | 'sphinx_issues',
|
| 34 | + 'recommonmark', |
33 | 35 | ]
|
34 | 36 |
|
| 37 | +# app setup hook |
| 38 | +def setup(app): |
| 39 | + app.add_config_value( |
| 40 | + 'recommonmark_config', |
| 41 | + { |
| 42 | + #'url_resolver': lambda url: github_doc_root + url, |
| 43 | + 'enable_auto_toc_tree': True, |
| 44 | + 'auto_toc_tree_section': 'Contents', |
| 45 | + 'auto_code_block': True, |
| 46 | + 'enable_eval_rst': True, |
| 47 | + }, |
| 48 | + True, |
| 49 | + ) |
| 50 | + app.add_transform(AutoStructify) |
| 51 | + |
| 52 | + |
35 | 53 | issues_github_path = about['__github__'].replace('https://github.com/', '')
|
36 | 54 |
|
37 | 55 | templates_path = ['_templates']
|
38 | 56 |
|
39 |
| -source_suffix = '.rst' |
| 57 | +source_suffix = {'.rst': 'restructuredtext', '.md': 'markdown'} |
40 | 58 |
|
41 | 59 | master_doc = 'index'
|
42 | 60 |
|
|
61 | 79 | 'github_banner': True,
|
62 | 80 | 'projects': alagitpull.projects,
|
63 | 81 | 'project_name': about['__title__'],
|
| 82 | + 'project_title': about['__title__'], |
| 83 | + 'project_description': about['__description__'], |
| 84 | + 'project_url': about['__docs__'], |
| 85 | + 'show_meta_manifest_tag': True, |
| 86 | + 'show_meta_og_tags': True, |
| 87 | + 'show_meta_app_icon_tags': True, |
64 | 88 | }
|
65 | 89 | alagitpull_internal_hosts = ['libtmux.git-pull.com', '0.0.0.0']
|
66 | 90 | alagitpull_external_hosts_new_window = True
|
|
78 | 102 |
|
79 | 103 | html_theme_path = ['_themes']
|
80 | 104 | html_static_path = ['_static']
|
| 105 | +html_extra_path = ['manifest.json'] |
81 | 106 |
|
82 | 107 | htmlhelp_basename = '%sdoc' % about['__title__']
|
83 | 108 |
|
|
0 commit comments