Hi, I guess, you'd get some feedback in https://www.python.org/community/sigs/current/doc-sig/

• [ ] ENH: add <edit on github> links to every docs page user should have github account

• [ ] ENH: responsive breakpoints for mobile devices what breakpoints? is it related to <see below>

• [ ] ENH: interactive code examples (in WASM with pyodide like JupyterLite)

could be more generic/flexible: iframe, brython/skulpt, wasm, native app (maybe VSCode plugin)

On Wed, Sep 22, 2021 at 10:35 PM Wes Turner wes.turner@gmail.com wrote:

Where would be the best place to discuss or just improve the CPython docs sphinx theme? What would Python need in a {PyData,} Sphinx theme fork:

• [ ] ENH: add <edit on github> links to every docs page

• [ ] ENH: responsive breakpoints for mobile devices

• [ ] ENH: responsive fonts

• [ ] ENH: toggle-able dark theme

• [ ] ENH: interactive code examples (in WASM with pyodide like JupyterLite)

• [ ] ENH?: Two sidebars: {Global TOC} {Content} {Document TOC}

The PyData theme [bandwagon, feature justification, maintenance burden justification] Src: https://github.com/pydata/pydata-sphinx-theme Docs: https://pydata-sphinx-theme.readthedocs.io/en/latest/

Other sites that are using this theme:

- Pandas: https://pandas.pydata.org/docs/
- NumPy: https://numpy.org/doc/stable/
- SciPy: https://scipy.github.io/devdocs/
- NetworkX: https://networkx.org/documentation/latest/
- Bokeh: https://docs.bokeh.org/en/latest/
- JupyterHub and Binder: https://docs.mybinder.org/,
http://z2jh.jupyter.org/en/latest/,
https://repo2docker.readthedocs.io/en/latest/,
https://jupyterhub-team-compass.readthedocs.io/en/latest/
- Jupyter Book beta version uses an extension of this theme:
https://beta.jupyterbook.org
- Fairlearn: https://fairlearn.org/main/about/

The sphinx-book-theme theme (Jupyter Book theme) has a few possibly necessary features for the {CPython, Devguide, *} docs: https://github.com/executablebooks/sphinx-book-theme https://sphinx-book-theme.readthedocs.io/en/latest/ ::

A Sphinx theme with a clean design, support for interactive content, and a
modern book-like look and feel.

Flexible content layout: Inspired by beautiful online books, such as the
Edward Tufte CSS guide

Visual classes designed for Jupyter Notebooks: Cell inputs, outputs, and
interactive functionality are all supported.

Launch buttons for online interactivity: For pages that are built with
computational material, connect your site to an online BinderHub for
interactive content.

Bootstrap 4: To style visual elements and add functionality.

International: All text integrated in the theme is translated to the
specified Sphinx language.

https://github.com/python/cpython/blob/main/Doc/conf.py#L68 :

html_theme = 'python_docs_theme'

https://github.com/python/cpython/blob/main/Doc/requirements.txt#L12

# The theme used by the documentation is stored separately, so we need
# to install that as well.
python-docs-theme

Pypi: https://pypi.org/project/python-docs-theme/ Src: https://github.com/python/python-docs-theme/

What are some better ways to add {Source RST, Source, Edit, History, and Annotate} links to every sphinx doc page than sphinxcontrib-srclinks? https://github.com/westurner/sphinxcontrib-srclinks#usage

• sphinxcontrib-srclinks: Source RST, Source, Edit, History, and Annotate, Clone URL

  • [ ] copy clone URL to clipboard button

• pydata-theme: 'Edit this page' on the document TOC sidebar

• sphinx-book-theme: {gh, bb, gl} icon > 'Suggest edit'

• [ ] ENH: add collapsible sidebar to whatever is chosen as a suitable replacement for the current non-responsive theme

---

Pythonedu-wg mailing list -- pythonedu-wg@python.org To unsubscribe send an email to pythonedu-wg-leave@python.org https://mail.python.org/mailman3/lists/pythonedu-wg.python.org/ Member address: jurgis.pralgauskis@gmail.com

-- Jurgis Pralgauskis tel: 8-616 77613; Don't worry, be happy and make things better ;) https://galvosukykla.wordpress.com/