This repository holds the source of an exhibit accompanying the
"You Only Write Thrice" paper published at
Rethinking ML Papers -- ICLR 2021 Workshop.
The built book is hosted on GitHub Pages and is available under
https://so-cool.github.io/you-only-write-thrice/.
The online document is accompanied by reveal.js slides composed
from a Markdown Notebook that is also a source document
underlying a section of the online article.
A static snapshot of the slides is built with the jupyter nbconvert
conversion tool -- see the build_slides.sh
script for more details.
The slides can also be launched with RISE -- from a Jupyter Notebook
through MyBinder -- to allow interactive and executable content.
Therefore, in our workflow a single source file may produce:
- computational notebooks;
- static and interactive slides; and
- sections of an online document/book.
- Pull the book repository
git clone https://github.com/so-cool/you-only-write-thrice.git cd you-only-write-thrice
- Install Jupyter Book (
requirements-article.txt
) and slides execution requirements (requirements-slides.txt
)pip install -r requirements-article.txt pip install -r requirements-slides.txt
- Build the book
jb build .
- Build the slides
./build_slides.sh
- Open the html build
or run it as a server (to get the embedded SlidesLive window to work)
open _build/html/index.html
python -m http.server --directory _build/html open http://localhost:8000