sphinx

sphinx copied to clipboard

Update the web theme used in Sphinx' documentation

20

### Context _This issue is not a specific proposal, but I wanted to see if others in the community agree with me here, in the hopes that this might lead...

choldgraf

Modernising the `basic` theme

4

The `basic` theme is showing its age -- non-responsive, and not really a great advert for Sphinx out-of-the-box. Improving it is tricky though, as almost every theme relies on it...

AA-Turner

Clean way to include JavaScript frameworks in themes or extensions

11

Hi! Due to the latest changes about removing Javascript frameworks (#10070), we are thinking what's the best way to require/include jQuery from downstream in a clean way. This is from...

humitos

display the line numbers using sphinx.ext.viewcode?

2

I'm using the [sphinx.ext.viewcode](https://www.sphinx-doc.org/en/master/usage/extensions/viewcode.html) to document my API. Is it possible to display the line numbers on the produced code-block and if yes how ? I've tried to find an...

12rambau

Label after 'only' directive not found for xref

4

### Describe the bug I'm getting the following error: `Failed to create a cross reference. A title or caption not found: troubleshooting` For a cross-reference to a label that appears...

josuegomes

> > At some point we should also evaluate the stable of default themes and if that needs a refresh, but I think the basic work is more pressing. >...

pradyunsg

[docs] Show nested pages of sections as collapsible menus in the sidebar

3

The current sidebar implementation only shows the next level of pages below the current level. This makes it difficult for users to understand the context of the current page relative...

choldgraf

[docs] Button to show sidebar on mobile

1

With the new documentation refresh, the sidebar hides itself on mobile. This is a challenge for users that primarily use the sidebar to navigate to the pages they want (which...

choldgraf

[docs] Put in-page header navigation in a secondary sidebar

1

Currently, the theme puts in-page header navigation in the primary sidebar to the left:  However, it has become standard across modern documentation engines to use a three-column layout and...

choldgraf

Cannot update document object from my own SphinxPostTransform

1

### Describe the bug I try to add nodes in top of a document during my SphinxPostTransform (ClassListTransform) with the insert method. I'm doing the same method in ClassDirectiveDoc and...

dachym