Merge pull request #9012 from pradyunsg/switch-to-furo

This commit is contained in:
Pradyun Gedam 2020-11-14 02:05:36 +05:30 committed by GitHub
commit 6c26ea2e23
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
25 changed files with 53 additions and 98 deletions

View File

@ -155,7 +155,6 @@ def setup(app: Sphinx) -> Dict[str, Union[bool, str]]:
rebuild=rebuild_trigger,
)
app.add_css_file('important-admonition.css')
app.connect('source-read', _modify_rst_document_source_on_read)
return {

View File

@ -1,8 +0,0 @@
.admonition.important {
background-color: rgb(219, 250, 244);
border: 1px solid rgb(26, 188, 156);
}
.admonition.important>.admonition-title {
color: rgb(26, 188, 156);
}

View File

@ -94,7 +94,8 @@ with open(pip_init) as f:
# We have this here because readthedocs plays tricks sometimes and there seems
# to be a heisenbug, related to the version of pip discovered. This is here to
# help debug that if someone decides to do that in the future.
print(version)
print("pip version:", version)
print("pip release:", release)
# The language for content autogenerated by Sphinx. Refer to documentation
# for a list of supported languages.
@ -127,9 +128,6 @@ exclude_patterns = ['build/']
# output. They are ignored by default.
# show_authors = False
# The name of the Pygments (syntax highlighting) style to use.
pygments_style = 'sphinx'
# A list of ignored prefixes for module index sorting.
# modindex_common_prefix = []
@ -146,25 +144,18 @@ sphinx_tabs_nowarn = True
# The theme to use for HTML and HTML Help pages. Major themes that come with
# Sphinx are currently 'default' and 'sphinxdoc'.
html_theme = "pypa_theme"
html_theme = "furo"
# 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.
html_theme_options = {
'collapsiblesidebar': True,
'externalrefs': True,
'navigation_depth': 3,
'issues_url': 'https://github.com/pypa/pip/issues',
'codebgcolor': '#eeffcc',
'codetextcolor': '#333333',
}
html_theme_options = {}
# Add any paths that contain custom themes here, relative to this directory.
# The name for this set of Sphinx documents. If None, it defaults to
# "<project> v<release> documentation".
# html_title = None
html_title = f"{project} documentation v{release}"
# A shorter title for the navigation bar. Default is the same as html_title.
# html_short_title = None
@ -181,7 +172,7 @@ html_theme_options = {
# 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 = []
# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
# using the given strftime format.
@ -204,10 +195,7 @@ smartquotes = True
smartquotes_action = "qe"
# Custom sidebar templates, maps document names to template names.
html_sidebars = {
'**': ['localtoc.html', 'relations.html'],
'index': ['localtoc.html']
}
html_sidebars = {}
# Additional templates that should be rendered to pages, maps page names to
# template names.
@ -321,7 +309,7 @@ docs_feedback_admonition_type = 'important'
docs_feedback_big_doc_lines = 50 # bigger docs will have a banner on top
docs_feedback_email = 'Docs UX Team <docs-feedback+ux/pip.pypa.io@pypa.io>'
docs_feedback_excluded_documents = { # these won't have any banners
'news',
'news', 'reference/index',
}
docs_feedback_questions_list = (
'What problem were you trying to solve when you came to this page?',

View File

@ -4,7 +4,6 @@
developers welcome your help to complete this documentation. If you're
interested in helping out, please let us know in the `tracking issue`_.
.. contents::
****************************
Broad functionality overview

View File

@ -2,7 +2,6 @@
pip
===
.. contents::
Usage
*****

View File

@ -4,7 +4,6 @@
pip cache
---------
.. contents::
Usage
*****

View File

@ -4,8 +4,6 @@
pip check
=========
.. contents::
Usage
=====

View File

@ -5,8 +5,6 @@
pip config
==========
.. contents::
Usage
=====

View File

@ -4,8 +4,6 @@
pip debug
=========
.. contents::
Usage
=====

View File

@ -5,8 +5,6 @@
pip download
============
.. contents::
Usage
=====

View File

@ -5,8 +5,6 @@
pip freeze
==========
.. contents::
Usage
=====

View File

@ -4,8 +4,6 @@
pip hash
========
.. contents::
Usage
=====

View File

@ -4,7 +4,6 @@
pip install
===========
.. contents::
Usage

View File

@ -4,7 +4,6 @@
pip list
========
.. contents::
Usage

View File

@ -4,7 +4,6 @@
pip search
==========
.. contents::
Usage

View File

@ -4,7 +4,6 @@
pip show
========
.. contents::
Usage

View File

@ -4,7 +4,6 @@
pip uninstall
=============
.. contents::
Usage

View File

@ -5,7 +5,6 @@
pip wheel
=========
.. contents::
Usage

View File

@ -2,8 +2,6 @@
User Guide
==========
.. contents::
Running pip
===========

View File

@ -1,6 +1,5 @@
sphinx == 3.2.1
git+https://github.com/python/python-docs-theme.git#egg=python-docs-theme
git+https://github.com/pypa/pypa-docs-theme.git#egg=pypa-docs-theme
furo
sphinx-inline-tabs
# `docs.pipext` uses pip's internals to generate documentation. So, we install