mirror of
https://github.com/pypa/pip
synced 2023-12-13 21:30:23 +01:00
Merge pull request #9012 from pradyunsg/switch-to-furo
This commit is contained in:
commit
6c26ea2e23
|
@ -155,7 +155,6 @@ def setup(app: Sphinx) -> Dict[str, Union[bool, str]]:
|
||||||
rebuild=rebuild_trigger,
|
rebuild=rebuild_trigger,
|
||||||
)
|
)
|
||||||
|
|
||||||
app.add_css_file('important-admonition.css')
|
|
||||||
app.connect('source-read', _modify_rst_document_source_on_read)
|
app.connect('source-read', _modify_rst_document_source_on_read)
|
||||||
|
|
||||||
return {
|
return {
|
||||||
|
|
|
@ -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);
|
|
||||||
}
|
|
|
@ -94,7 +94,8 @@ with open(pip_init) as f:
|
||||||
# We have this here because readthedocs plays tricks sometimes and there seems
|
# 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
|
# 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.
|
# 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
|
# The language for content autogenerated by Sphinx. Refer to documentation
|
||||||
# for a list of supported languages.
|
# for a list of supported languages.
|
||||||
|
@ -127,9 +128,6 @@ exclude_patterns = ['build/']
|
||||||
# output. They are ignored by default.
|
# output. They are ignored by default.
|
||||||
# show_authors = False
|
# 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.
|
# A list of ignored prefixes for module index sorting.
|
||||||
# modindex_common_prefix = []
|
# 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
|
# The theme to use for HTML and HTML Help pages. Major themes that come with
|
||||||
# Sphinx are currently 'default' and 'sphinxdoc'.
|
# 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
|
# 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
|
# further. For a list of options available for each theme, see the
|
||||||
# documentation.
|
# documentation.
|
||||||
html_theme_options = {
|
html_theme_options = {}
|
||||||
'collapsiblesidebar': True,
|
|
||||||
'externalrefs': True,
|
|
||||||
'navigation_depth': 3,
|
|
||||||
'issues_url': 'https://github.com/pypa/pip/issues',
|
|
||||||
'codebgcolor': '#eeffcc',
|
|
||||||
'codetextcolor': '#333333',
|
|
||||||
}
|
|
||||||
|
|
||||||
# Add any paths that contain custom themes here, relative to this directory.
|
# 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
|
# The name for this set of Sphinx documents. If None, it defaults to
|
||||||
# "<project> v<release> documentation".
|
# "<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.
|
# A shorter title for the navigation bar. Default is the same as html_title.
|
||||||
# html_short_title = None
|
# html_short_title = None
|
||||||
|
@ -181,7 +172,7 @@ html_theme_options = {
|
||||||
# Add any paths that contain custom static files (such as style sheets) here,
|
# 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,
|
# relative to this directory. They are copied after the builtin static files,
|
||||||
# so a file named "default.css" will overwrite the builtin "default.css".
|
# 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,
|
# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
|
||||||
# using the given strftime format.
|
# using the given strftime format.
|
||||||
|
@ -204,10 +195,7 @@ smartquotes = True
|
||||||
smartquotes_action = "qe"
|
smartquotes_action = "qe"
|
||||||
|
|
||||||
# Custom sidebar templates, maps document names to template names.
|
# Custom sidebar templates, maps document names to template names.
|
||||||
html_sidebars = {
|
html_sidebars = {}
|
||||||
'**': ['localtoc.html', 'relations.html'],
|
|
||||||
'index': ['localtoc.html']
|
|
||||||
}
|
|
||||||
|
|
||||||
# Additional templates that should be rendered to pages, maps page names to
|
# Additional templates that should be rendered to pages, maps page names to
|
||||||
# template names.
|
# 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_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_email = 'Docs UX Team <docs-feedback+ux/pip.pypa.io@pypa.io>'
|
||||||
docs_feedback_excluded_documents = { # these won't have any banners
|
docs_feedback_excluded_documents = { # these won't have any banners
|
||||||
'news',
|
'news', 'reference/index',
|
||||||
}
|
}
|
||||||
docs_feedback_questions_list = (
|
docs_feedback_questions_list = (
|
||||||
'What problem were you trying to solve when you came to this page?',
|
'What problem were you trying to solve when you came to this page?',
|
||||||
|
|
|
@ -4,7 +4,6 @@
|
||||||
developers welcome your help to complete this documentation. If you're
|
developers welcome your help to complete this documentation. If you're
|
||||||
interested in helping out, please let us know in the `tracking issue`_.
|
interested in helping out, please let us know in the `tracking issue`_.
|
||||||
|
|
||||||
.. contents::
|
|
||||||
|
|
||||||
****************************
|
****************************
|
||||||
Broad functionality overview
|
Broad functionality overview
|
||||||
|
|
|
@ -2,7 +2,6 @@
|
||||||
pip
|
pip
|
||||||
===
|
===
|
||||||
|
|
||||||
.. contents::
|
|
||||||
|
|
||||||
Usage
|
Usage
|
||||||
*****
|
*****
|
||||||
|
|
|
@ -4,7 +4,6 @@
|
||||||
pip cache
|
pip cache
|
||||||
---------
|
---------
|
||||||
|
|
||||||
.. contents::
|
|
||||||
|
|
||||||
Usage
|
Usage
|
||||||
*****
|
*****
|
||||||
|
|
|
@ -4,8 +4,6 @@
|
||||||
pip check
|
pip check
|
||||||
=========
|
=========
|
||||||
|
|
||||||
.. contents::
|
|
||||||
|
|
||||||
|
|
||||||
Usage
|
Usage
|
||||||
=====
|
=====
|
||||||
|
|
|
@ -5,8 +5,6 @@
|
||||||
pip config
|
pip config
|
||||||
==========
|
==========
|
||||||
|
|
||||||
.. contents::
|
|
||||||
|
|
||||||
|
|
||||||
Usage
|
Usage
|
||||||
=====
|
=====
|
||||||
|
|
|
@ -4,8 +4,6 @@
|
||||||
pip debug
|
pip debug
|
||||||
=========
|
=========
|
||||||
|
|
||||||
.. contents::
|
|
||||||
|
|
||||||
|
|
||||||
Usage
|
Usage
|
||||||
=====
|
=====
|
||||||
|
|
|
@ -5,8 +5,6 @@
|
||||||
pip download
|
pip download
|
||||||
============
|
============
|
||||||
|
|
||||||
.. contents::
|
|
||||||
|
|
||||||
|
|
||||||
Usage
|
Usage
|
||||||
=====
|
=====
|
||||||
|
|
|
@ -5,8 +5,6 @@
|
||||||
pip freeze
|
pip freeze
|
||||||
==========
|
==========
|
||||||
|
|
||||||
.. contents::
|
|
||||||
|
|
||||||
|
|
||||||
Usage
|
Usage
|
||||||
=====
|
=====
|
||||||
|
|
|
@ -4,8 +4,6 @@
|
||||||
pip hash
|
pip hash
|
||||||
========
|
========
|
||||||
|
|
||||||
.. contents::
|
|
||||||
|
|
||||||
|
|
||||||
Usage
|
Usage
|
||||||
=====
|
=====
|
||||||
|
|
|
@ -4,7 +4,6 @@
|
||||||
pip install
|
pip install
|
||||||
===========
|
===========
|
||||||
|
|
||||||
.. contents::
|
|
||||||
|
|
||||||
|
|
||||||
Usage
|
Usage
|
||||||
|
|
|
@ -4,7 +4,6 @@
|
||||||
pip list
|
pip list
|
||||||
========
|
========
|
||||||
|
|
||||||
.. contents::
|
|
||||||
|
|
||||||
|
|
||||||
Usage
|
Usage
|
||||||
|
|
|
@ -4,7 +4,6 @@
|
||||||
pip search
|
pip search
|
||||||
==========
|
==========
|
||||||
|
|
||||||
.. contents::
|
|
||||||
|
|
||||||
|
|
||||||
Usage
|
Usage
|
||||||
|
|
|
@ -4,7 +4,6 @@
|
||||||
pip show
|
pip show
|
||||||
========
|
========
|
||||||
|
|
||||||
.. contents::
|
|
||||||
|
|
||||||
|
|
||||||
Usage
|
Usage
|
||||||
|
|
|
@ -4,7 +4,6 @@
|
||||||
pip uninstall
|
pip uninstall
|
||||||
=============
|
=============
|
||||||
|
|
||||||
.. contents::
|
|
||||||
|
|
||||||
|
|
||||||
Usage
|
Usage
|
||||||
|
|
|
@ -5,7 +5,6 @@
|
||||||
pip wheel
|
pip wheel
|
||||||
=========
|
=========
|
||||||
|
|
||||||
.. contents::
|
|
||||||
|
|
||||||
|
|
||||||
Usage
|
Usage
|
||||||
|
|
|
@ -2,8 +2,6 @@
|
||||||
User Guide
|
User Guide
|
||||||
==========
|
==========
|
||||||
|
|
||||||
.. contents::
|
|
||||||
|
|
||||||
|
|
||||||
Running pip
|
Running pip
|
||||||
===========
|
===========
|
||||||
|
|
|
@ -1,6 +1,5 @@
|
||||||
sphinx == 3.2.1
|
sphinx == 3.2.1
|
||||||
git+https://github.com/python/python-docs-theme.git#egg=python-docs-theme
|
furo
|
||||||
git+https://github.com/pypa/pypa-docs-theme.git#egg=pypa-docs-theme
|
|
||||||
sphinx-inline-tabs
|
sphinx-inline-tabs
|
||||||
|
|
||||||
# `docs.pipext` uses pip's internals to generate documentation. So, we install
|
# `docs.pipext` uses pip's internals to generate documentation. So, we install
|
||||||
|
|
Loading…
Reference in a new issue