Skip to content
master
Switch branches/tags
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
bin
 
 
 
 
 
 
 
 
 
 
 
 

DSPnote: Create Notebooks with Interactive Figures

Demo articles:

DSPnote is a static site generator specialized in creating notebooks with interactive figures. Some features:

  • Generative audio scripts with parameters: scripts written in Sporth can be included directly in the text, with an optional block diagram, and run in-browser with sliders to control variables
  • WebGL shaders with parameters: GLSL ES fragment shaders can be included, with auto-generated image fallbacks
  • Math typesetting; code blocks with syntax highlighting

Installing and Using

DSPnote requires Python 3. The following commands should work similarly on all platforms. Clone or download the repository (master branch), and in the resulting folder, run the command:

pip3 install -e .

This installs, along with its dependencies, the tool dspnote-gen, which takes a single argument: a directory containing a dspnote project. An example project is included, and the article can be generated by running:

dspnote-gen example

This will generate the site to example/out. Change to this directory and run the following command to serve the site locally:

python3 -m http.server 8000

Then, point your browser to http://localhost:8000/exampleNote. For a more complex example project, see pac-dev/notes.

To create a new project, copy the example folder and modify it. Each Markdown file in the content subfolder will generate an article. Assets for each article (eg. GLSL sources, images) are in a folder of the same name alongside the Markdown file.

Prior Art

About

Create Notebooks with Interactive Figures

Resources

Releases

No releases published

Packages

No packages published

Languages