Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Add jupyter-book #19

Closed
ashwinvis opened this issue Apr 8, 2020 · 4 comments · Fixed by #38
Closed

Add jupyter-book #19

ashwinvis opened this issue Apr 8, 2020 · 4 comments · Fixed by #38

Comments

@ashwinvis
Copy link
Member

Enhancement of bookdown tool. Interactive online books. Jupyter + Jekyll

https://github.com/jupyter/jupyter-book
@ashwinvis
Copy link
Member Author

The project has moved to a new home:

https://github.com/executablebooks/jupyter-book

The flavour of markdown being used is called MyST

@ashwinvis ashwinvis mentioned this issue May 24, 2020
Closed
@maehr
Copy link
Member

maehr commented Aug 13, 2020

Jupyter-book just made a big leap forward (and ditched jekyll) https://blog.jupyter.org/announcing-the-new-jupyter-book-cbf7aa8bc72e

@ashwinvis
Copy link
Member Author

ashwinvis commented Aug 13, 2020 •
edited
Loading

On one hand, I feel it is about time we should include jupyter-book here. I heard it mentioned several times in the past months and it has started to get adopted by users to write content: like this. On the other hand I am unsure how it achieves anything that Sphinx (or equivalent documentation generator) would allow you to do with some extensions and a good template.

@maehr
Copy link
Member

maehr commented Aug 14, 2020

Since I do not work with notebooks but with plain Markdown, I cannot give a competent assessment. I know that it is based on Sphinx and already has a template and the right extensions.

@ashwinvis ashwinvis mentioned this issue Aug 31, 2020
Closed
ashwinvis added a commit that referenced this issue Nov 29, 2020
@ashwinvis
MyST and jupyter book
72b60ee 
Closes #19 and #29
@ashwinvis ashwinvis mentioned this issue Nov 29, 2020
Merged
6 tasks
@maehr maehr closed this as completed in #38 Nov 29, 2020
maehr pushed a commit that referenced this issue Nov 29, 2020
@ashwinvis
MyST and jupyter book (#38)
b35c252 
* MyST and jupyter book

Closes #19 and #29

* Contribute h2 -> h3

Try to make linter happy
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
None yet
Projects
None yet
Milestone
No milestone
Development

Successfully merging a pull request may close this issue.

MyST and jupyter book writing-resources/awesome-scientific-writing
2 participants
@ashwinvis @maehr