|
23 | 23 |
|
24 | 24 | from semver import __version__ # noqa: E402 |
25 | 25 |
|
| 26 | + |
26 | 27 | # -- General configuration ------------------------------------------------ |
27 | 28 |
|
28 | 29 | # If your documentation needs a minimal Sphinx version, state it here. |
|
94 | 95 | # The theme to use for HTML and HTML Help pages. See the documentation for |
95 | 96 | # a list of builtin themes. |
96 | 97 | # |
97 | | -# html_theme = 'alabaster' |
98 | | -html_theme = "sphinx_rtd_theme" |
| 98 | +html_theme = "alabaster" |
| 99 | +templates_path = ["_templates"] |
99 | 100 |
|
100 | | -# Theme options are theme-specific and customize the look and feel of a theme |
101 | | -# further. For a list of options available for each theme, see the |
102 | | -# documentation. |
103 | | -# |
104 | | -# html_theme_options = {} |
| 101 | +GITHUB_URL = "https://github.com/python-semver/python-semver" |
| 102 | + |
| 103 | +html_theme_options = { |
| 104 | + # -- Basics |
| 105 | + #: Text blurb about your project to appear under the logo: |
| 106 | + # "description": "Semantic versioning", |
| 107 | + #: Makes the sidebar "fixed" or pinned in place: |
| 108 | + "fixed_sidebar": True, |
| 109 | + #: Relative path to $PROJECT/_static to logo image: |
| 110 | + # "logo": "logo.svg", |
| 111 | + #: Set to true to insert your site's project name under |
| 112 | + #: the logo: |
| 113 | + # "logo_name": True, |
| 114 | + #: CSS width specifier controller default sidebar width: |
| 115 | + "sidebar_width": "25%", |
| 116 | + #: CSS width specifier controlling default content/page width: |
| 117 | + "page_width": "auto", |
| 118 | + #: CSS width specifier controlling default body text width: |
| 119 | + "body_max_width": "auto", |
| 120 | + # |
| 121 | + # -- Service Links and Badges |
| 122 | + #: Contains project name and user of GitHub: |
| 123 | + "github_user": "python-semver", |
| 124 | + "github_repo": "python-semver", |
| 125 | + #: whether to link to your GitHub: |
| 126 | + "github_button": True, |
| 127 | + #: |
| 128 | + "github_type": "star", |
| 129 | + #: whether to apply a ‘Fork me on Github’ banner |
| 130 | + #: in the top right corner of the page: |
| 131 | + # "github_banner": True, |
| 132 | + # |
| 133 | + # -- Non-service sidebar control |
| 134 | + #: Dictionary mapping link names to link targets: |
| 135 | + "extra_nav_links": { |
| 136 | + "PyPI": "https://pypi.org/project/semver/", |
| 137 | + "Libraries.io": "https://libraries.io/pypi/semver", |
| 138 | + }, |
| 139 | + #: Boolean determining whether all TOC entries that |
| 140 | + #: are not ancestors of the current page are collapsed: |
| 141 | + "sidebar_collapse": True, |
| 142 | + # |
| 143 | + # -- Header/footer options |
| 144 | + #: used to display next and previous links above and |
| 145 | + #: below the main page content |
| 146 | + "show_relbars": True, |
| 147 | + "show_relbar_top": True, |
| 148 | + # |
| 149 | + # -- Style colors |
| 150 | + # "anchor": "", |
| 151 | + # "anchor_hover_bg": "", |
| 152 | + # "anchor_hover_fg": "", |
| 153 | + "narrow_sidebar_fg": "lightgray", |
| 154 | + # |
| 155 | + # -- Fonts |
| 156 | + # "code_font_size": "", |
| 157 | + "font_family": "", |
| 158 | + "head_font_family": "", |
| 159 | + "font_size": "1.25rem", |
| 160 | +} |
105 | 161 |
|
106 | | -# Add any paths that contain custom static files (such as style sheets) here, |
107 | | -# relative to this directory. They are copied after the builtin static files, |
108 | | -# so a file named "default.css" will overwrite the builtin "default.css". |
109 | 162 | html_static_path = ["_static"] |
| 163 | +html_css_files = ["css/semver.css"] |
110 | 164 |
|
111 | | -html_css_files = ["css/default.css"] |
112 | | - |
113 | | -# Custom sidebar templates, must be a dictionary that maps document names |
114 | | -# to template names. |
115 | | -# |
116 | | -# This is required for the alabaster theme |
117 | | -# refs: http://alabaster.readthedocs.io/en/latest/installation.html#sidebars |
118 | | -html_sidebars = { |
119 | | - "**": [ |
120 | | - "about.html", |
121 | | - "navigation.html", |
122 | | - "relations.html", # needs 'show_related': True theme option to display |
123 | | - "searchbox.html", |
124 | | - "donate.html", |
125 | | - ] |
126 | | -} |
127 | | - |
128 | | -html_logo = "logo.svg" |
| 165 | +# html_logo = "logo.svg" |
129 | 166 |
|
130 | 167 | # -- Options for HTMLHelp output ------------------------------------------ |
131 | 168 |
|
|
0 commit comments