Skip to content

Consider a jb-journal TOC format #31

Description

@choldgraf

I was recently in a meeting where we were talking about building an end-to-end pipeline for publishing using Jupyter notebooks + md files etc as inputs.

It made me wonder if we could define another TOC format that is designed for a collection of papers. This would essentially be a way to generalize the jb-article format to include multiple papers, so maybe it'd be as simple as:

format: jb-journal
root: index
articles:
- title: some title
  sections:
  - The rest is the same as jb-article
- title: some other
  sections:
  - The rest is the same as jb-article

What would be even more interesting is if we could trigger different doctree logic depending on the TOC format. For example, maybe if it's an article, then sections have the option of being concatenated into a single page, rather than existing as unique URLs each (basically, the same behavior as singlehtml but at the level of a toctree rather than for the whole site.

(obviously this is a future issue and not blocking on an early release)

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions