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
25 changed files with 53 additions and 98 deletions
|
@ -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 {
|
||||
|
|
|
@ -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
|
||||
# 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?',
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -2,7 +2,6 @@
|
|||
pip
|
||||
===
|
||||
|
||||
.. contents::
|
||||
|
||||
Usage
|
||||
*****
|
||||
|
|
|
@ -4,7 +4,6 @@
|
|||
pip cache
|
||||
---------
|
||||
|
||||
.. contents::
|
||||
|
||||
Usage
|
||||
*****
|
||||
|
|
|
@ -4,8 +4,6 @@
|
|||
pip check
|
||||
=========
|
||||
|
||||
.. contents::
|
||||
|
||||
|
||||
Usage
|
||||
=====
|
||||
|
|
|
@ -5,8 +5,6 @@
|
|||
pip config
|
||||
==========
|
||||
|
||||
.. contents::
|
||||
|
||||
|
||||
Usage
|
||||
=====
|
||||
|
|
|
@ -4,8 +4,6 @@
|
|||
pip debug
|
||||
=========
|
||||
|
||||
.. contents::
|
||||
|
||||
|
||||
Usage
|
||||
=====
|
||||
|
|
|
@ -5,8 +5,6 @@
|
|||
pip download
|
||||
============
|
||||
|
||||
.. contents::
|
||||
|
||||
|
||||
Usage
|
||||
=====
|
||||
|
|
|
@ -5,8 +5,6 @@
|
|||
pip freeze
|
||||
==========
|
||||
|
||||
.. contents::
|
||||
|
||||
|
||||
Usage
|
||||
=====
|
||||
|
|
|
@ -4,8 +4,6 @@
|
|||
pip hash
|
||||
========
|
||||
|
||||
.. contents::
|
||||
|
||||
|
||||
Usage
|
||||
=====
|
||||
|
|
|
@ -4,7 +4,6 @@
|
|||
pip install
|
||||
===========
|
||||
|
||||
.. contents::
|
||||
|
||||
|
||||
Usage
|
||||
|
|
|
@ -4,7 +4,6 @@
|
|||
pip list
|
||||
========
|
||||
|
||||
.. contents::
|
||||
|
||||
|
||||
Usage
|
||||
|
|
|
@ -4,7 +4,6 @@
|
|||
pip search
|
||||
==========
|
||||
|
||||
.. contents::
|
||||
|
||||
|
||||
Usage
|
||||
|
|
|
@ -4,7 +4,6 @@
|
|||
pip show
|
||||
========
|
||||
|
||||
.. contents::
|
||||
|
||||
|
||||
Usage
|
||||
|
|
|
@ -4,7 +4,6 @@
|
|||
pip uninstall
|
||||
=============
|
||||
|
||||
.. contents::
|
||||
|
||||
|
||||
Usage
|
||||
|
|
|
@ -5,7 +5,6 @@
|
|||
pip wheel
|
||||
=========
|
||||
|
||||
.. contents::
|
||||
|
||||
|
||||
Usage
|
||||
|
|
|
@ -2,8 +2,6 @@
|
|||
User Guide
|
||||
==========
|
||||
|
||||
.. contents::
|
||||
|
||||
|
||||
Running pip
|
||||
===========
|
||||
|
|
|
@ -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
|
||||
|
|
Loading…
Reference in a new issue