Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Move indexsidebar.html and switchers.js to docsbuild-scripts #90

Closed
@JulienPalard

Description

@JulienPalard

The idea is that the cpython Doc/ repository should just care about building the documentation, not linking to other builds and languages from docs.python.org.

Building multiple versions, multiple languages, and linking them together is the role of docsbuild-scripts.

This would also avoid the need to updateswitchers.js andindexsidebar.html on every cpython branch for every new cpython release and every new language.

What would need to change:

  • Dropswitchers=1 fromcpython/Doc/Makefile
  • Dropif switchers block incpython/tools/templates/layout.html. it already has an alternative. Add anid to the<li> so it can be easily found by the newswitchers.js as the placeholders are dropped.
  • Moveswitchers.js to docsbuild-scripts and make it use the<li> new id instead of placeholders if they are not found, and maybe fallback to find the place from other ways so it can work on old branches without commiting to them.
  • Write a generic "indexsidebar.html" for local builds, to be commited in cpython, and move the "cross-linked" version of indexsidebar in docsbuild-scripts.
  • Move {% trans %} tags in dummy.html so they can still be translated even if versionned in docsbuild-scripts (it's the only remaining part in cpython, hope it won't change too often).

We then need aclean way for docsbuild-scripts to edit the HTML to make it load switchers.js.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions


      [8]ページ先頭

      ©2009-2025 Movatter.jp