Skip to content
(Auto) generate notebooks from your source code. Useful for ACM-ICPC
Branch: master
Clone or download
pin3da Merge pull request #12 from pin3da/dependabot/npm_and_yarn/js-yaml-3.…

Bump js-yaml from 3.12.0 to 3.13.1
Latest commit d3d0116 Jul 12, 2019


Build Status

(Auto) generate notebooks from your source code. Useful for ACM-ICPC


This generator works in both Linux and Windows, so check how to install texlive in your OS.

texlive for Linux:

aptitude install texlive

texlive for Windows:

download installer (install-tl-Windows.exe) from


npm install -g notebook-generator


Usage: notebook-generator <source_dir> [options]

Auto generate notebooks from your source code

    -V, --version             output the version number
    -a --author <name>        author's name to be added in the notebook
    -i --initials <initials>  initials of the author to be placed in the upper-right corner of all pages
    -o --output <filename>    output file for the notebook. (default: "./notebook.pdf")
    -s --size <size>          font size is allowed 8, 9, 10, 11, 12, 14, 17, 20 pt (default: "10")
    -c --columns <amount>     number of columns is allowed 2, 3. (default: "2")
    -p --paper <size>         paper size is allowed letterpaper, a4paper, a5paper. (default: "letterpaper")
    -h, --help                output usage information
    -I --image <source>       cover image to be added in the notebook.


notebook-generator ./ --output /tmp/team_reference.pdf
notebook-generator ./ --author "Universidad Tecnologica de Pereira" --initials UTP --size 12 --columns 3 --paper a4paper --image ./in-silicon

The second one will create a 'notebook.pdf' file in the current directory.

Example PDF

Here you can find an example


The notebook generator will add your source code with syntax highlight, additionally you can add .tex files which will be rendered as latex code.


  • Try to use up to 3 "levels" in your source code.
  • Use spaces insead of underscore (in the filenames) to print a prettier TOC.

Manuel Pineda & Diego Restrepo

You can’t perform that action at this time.