René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Move indexsidebar.html and switchers.js to docsbuild-scripts","articleBody":"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.\r\n\r\nBuilding multiple versions, multiple languages, and linking them together is the role of docsbuild-scripts.\r\n\r\nThis would also avoid the need to update `switchers.js` and `indexsidebar.html` on every cpython branch for every new cpython release and every new language.\r\n\r\nWhat would need to change:\r\n\r\n- Drop `switchers=1` from `cpython/Doc/Makefile`\r\n- Drop `if switchers` block in `cpython/tools/templates/layout.html`. it already has an alternative. Add an `id` to the `\u003cli\u003e` so it can be easily found by the new `switchers.js` as the placeholders are dropped.\r\n- Move `switchers.js` to docsbuild-scripts and make it use the `\u003cli\u003e` 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.\r\n- Write a generic \"indexsidebar.html\" for local builds, to be commited in cpython, and move the \"cross-linked\" version of indexsidebar in docsbuild-scripts.\r\n- 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).\r\n\r\nWe then need a **clean** way for docsbuild-scripts to edit the HTML to make it load switchers.js.","author":{"url":"https://github.com/JulienPalard","@type":"Person","name":"JulienPalard"},"datePublished":"2020-06-04T20:43:36.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":3},"url":"https://github.com/90/docsbuild-scripts/issues/90"}