Initial effort at compiling book. #69
Merged
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
To compile the book, you’ll need to update to the latest pandoc (1.19.2) from https://github.com/jgm/pandoc/releases/tag/1.19.2.1 and install takluyver’s bookbook (with pip). I think you also need to have Clawpack installed for Python 3. Once you have all that, run the shell script: ./make_book.sh The script generates a bunch of new notebook files with numbers in front of them, and those are used to compile the book. You can remove the extra notebooks afterward by doing rm 0?-*.ipynb The set of notebooks to be included, and their order, is determined by the list at the beginning of `make_chapters.py`. For the moment I’ve just included three sample chapters. Cells can be omitted (hidden) in the book output. For instance, the cells with import statements have been hidden. To set a cell to be hidden, open the notebook and select view -> cell toolbar -> tags. Then add the tag ‘hide’ to the desired cell(s). To use the static versions of the widgets, I’m just doing a search and replace. This means that the following code should appear by itself on some line of the notebook: from ipywidgets import interact bookbook expects that each notebook begins with a Markdown cell containing a level-1 header, which will be the chapter title. I removed the messages printed by snapshot_widgets because they are a bit of a nuisance in the book.
|
The pdf looks great, thanks for getting this going! I'll add a few comments later and try out the scripts... |
* master: Fix a couple more typos. Fix a typo. Don't show delta shocks when t=0. Add exercise regarding low Froude number limit. Add references and notes on large Froude number limit in pressureless flow chapter.
|
I added more chapters. If you're experimenting with changing the formatting of the book, it's probably convenient to edit Here's a PDF with 8 chapters and about 100 pages: riemann.pdf This is not all the chapters we have drafted, but I think it includes all the ones that are in reasonably polished shape (and some that perhaps are not). |
Cross references are now properly converted from markdown to latex.
* master: Updated nbstripout to remove metadata Merged pull request Editorial changes to Tammann notebook. Added characterisitics Added section in negative pressure Minor changes to examples Put repeated code into a function. Update Docker.md Update Docker.md Minor update to TammannNB Forgot to nbstrip on previous commit Added examples to Euler Tammann NB Updated Tammann book revert dirty notebooks commited by accident Add clawpack to Dockerfile and instructions for pulling from riemann@master Added Dockerfile and Docker.md Added very small versions of the phase plane interactive apps Added interactive pplane html apps
Include preface in pdf. Use \small for code in pdf. Use SVG backend so that graphics are in vector format. Adjust figure and font sizes to work with SVG backend. Plot Riemann solution and phase plane together for nonlinear elasticity. Fix numerous minor issues in notebooks.
This was referenced May 1, 2017
|
I suggest closing this in favor of #71. |
Also update gitignore.
|
Could we just merge this and then merge #71? Then there will be a less massive set of changes to review there. |
ketch
changed the title
|
And yes, I'd like to go ahead and merge this. |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
To compile the book, you’ll need to update to the latest pandoc (1.19.2) from
https://github.com/jgm/pandoc/releases/tag/1.19.2.1 and install takluyver’s
bookbook (with pip). I think you also need to have Clawpack installed for
Python 3.
Once you have all that, run the shell script:
The script generates a bunch of new notebook files with numbers in front of
them, and those are used to compile the book. You can remove the extra
notebooks afterward by doing
The set of notebooks to be included, and their order, is determined by the list
at the beginning of
make_chapters.py. For the moment I’ve just includedthree sample chapters.
Cells can be omitted (hidden) in the book output. For instance, the cells with
import statements have been hidden. To set a cell to be hidden, open the
notebook and select view -> cell toolbar -> tags. Then add the tag ‘hide’ to
the desired cell(s).
To use the static versions of the widgets, I’m just doing a search and replace.
This means that the following code should appear by itself on some line of the
notebook:
bookbook expects that each notebook begins with a Markdown cell containing a
level-1 header, which will be the chapter title.
I removed the messages printed by snapshot_widgets because they are a bit of a
nuisance in the book.
For convenience, a copy of the pdf is attached to this message.
riemann.pdf