meta

meta copied to clipboard

Improve book theme modularity and standardize HTML structure

20

### Problem statement Our `sphinx-book-theme` has a sub-optimal underlying configuration, which makes it unnecessarily difficult to maintain, extend, and sub-theme (we care about sub-theming so that things like the quantecon...

AakashGfude

Style Guide for Writing Sphinx Extensions

1

The documentation for writing `sphinx` extensions can be confusing and incomplete. It would be nice to put together a style guide that captures some of the learning from the `ebp`...

mmcky

Bugs and feature requests related to latex

7

Putting together a list of issues/discussions related to **latex** in ebp repos here. Which will help us get a holistic view, possible approaches, and tracking progress(the list is in progress)....

AakashGfude

Create a myst-markdown repository as a ref implementation for myst

8

Now that myst markdown is becoming more well known, people may wish to use it in contexts that we did not expect, or extend it for other tools, languages, etc....

choldgraf

Roll out pre-commit GH action to repos

1

As implemented in https://github.com/executablebooks/sphinx-book-theme/pull/172, there is actually now https://github.com/pre-commit/action instead of the direct implementation I've used in most other repos - [x] jupyter-book (https://github.com/executablebooks/jupyter-book/issues/825) - [x] myst-nb - [x] myst-parser...

chrisjsewell

Extended table syntax for MyST

6

Might be useful, to handle e.g. multi-line/row/column cells etc, see e.g. - RST tables: https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#tables - Pandoc tables: https://pandoc.org/MANUAL.html#tables Also I quite like list-tables: https://docutils.sourceforge.io/docs/ref/rst/directives.html#list-table Basically what is a good...

chrisjsewell

We released v0.15 of the MyST parser a few weeks back, we should write up a little post about the updates. Let's try to follow the same pattern as our...

choldgraf

We currently have a [markdown-it plugin template](https://github.com/executablebooks/markdown-it-plugin-template) to help others build their own `markdown-it` plugins. We've also got the [`mdit-py-plugins`](https://github.com/executablebooks/mdit-py-plugins) repository, which has a collection of Python plugins for the...

choldgraf

Create a template for Sphinx extensions

3

# Background I've found myself often creating new Sphinx extensions from scratch. Each time I do this, there are a bunch of semi-random questions to ask around how to structure...

choldgraf

Order example gallery by popularity

9

I would find it rather useful if the gallery is (roughly) ordered by the popularity of the project rather than the current random shuffle for each deployment (random by page...

bsipocz