jupyter / governance

The governance process and model for Project Jupyter
https://jupyter.org/governance/index.html
Creative Commons Zero v1.0 Universal
82 stars 71 forks source link

Would it be possible to define info in a data file ? #224

Open Carreau opened 4 months ago

Carreau commented 4 months ago

Mostly people.md and likely a few other things.

On Jupyter.github.io most pages are generated from a yaml data file:

https://github.com/jupyter/jupyter.github.io/blob/main/about.html#L22-L74 for example.

This would make it easier to include the same informations on multiple page instead of having to synchronize instead of always having to jump between multiple pages.

choldgraf commented 4 months ago

I do this all the time with Sphinx, definitely possible!

One example is the executablebooks gallery

https://executablebooks.org/en/latest/gallery/

Which is generated from a yaml file. The code to do that is here

https://github.com/executablebooks/meta/blob/main/docs%2Fconf.py#L104

You could also do this outside of conf.py if you used a jupyter notebook w a cell that outputted markdown (so it'd be parsed as Myst)

westurner commented 4 months ago

Are there directives for {displaying, editing, validating} "YAML" {JSON, JSON-LD, YAML, YAML-LD, JSON Schema,} in {docutils, sphinx / myST, jupyter-book, nbdev, IPython.display, or nbsphinx, }?

Use Cases:

On Mon, May 27, 2024, 11:09 AM Chris Holdgraf @.***> wrote:

I do this all the time with Sphinx, definitely possible!

One example is the executablebooks gallery

https://executablebooks.org/en/latest/gallery/

Which is generated from a yaml file. The code to do that is here

https://github.com/executablebooks/meta/blob/main/docs%2Fconf.py#L104

You could also do this outside of conf.py if you used a jupyter notebook w a cell that outputted markdown (so it'd be parsed as Myst)

— Reply to this email directly, view it on GitHub https://github.com/jupyter/governance/issues/224#issuecomment-2133669970, or unsubscribe https://github.com/notifications/unsubscribe-auth/AAAMNSYORZLS2D7DPU5AQRTZENEEPAVCNFSM6AAAAABIK3B33OVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDCMZTGY3DSOJXGA . You are receiving this because you are subscribed to this thread.Message ID: @.***>