History

MinRK 458dcd12e3 make markdown heading input match output size		11 years ago
..
auth	s/base_project_url/base_url/	12 years ago
base	Get pre_get to work and make session logs when adapter changes	11 years ago
files	use ?download=1 to trigger download in /files/	11 years ago
kernelspecs	Kernel resource handlers now require authenticated user	12 years ago
nbconvert	move mime-bundle data to rich output.data	11 years ago
notebook	remove unused project_dir	12 years ago
services	update html/js to nbformat 4	11 years ago
static	make markdown heading input match output size	11 years ago
templates	Merge pull request #6554 from Carreau/itsallaboutme	11 years ago
terminal	Fix terminals with Tornado 3	11 years ago
tests	output[mime/type] -> output.data[mime/type] in javascript	11 years ago
tree	remove unused TreeRedirectHandler	12 years ago
widgets	jupyter -> IPython	11 years ago
README.md	use invoke instead of fabric	11 years ago
__init__.py	add install_nbextension at top-level IPython.html	12 years ago
__main__.py	add `python -m` entry points for everything	12 years ago
log.py	minor notebook logging changes	12 years ago
nbextensions.py	add utils.path.ensure_dir_exists	12 years ago
notebookapp.py	Multiple terminals and conditional initialisation	11 years ago
tasks.py	require less >= 1.7.5	11 years ago
utils.py	update contents per further review	12 years ago

README.md

IPython Notebook development

Development dependencies

Developers of the IPython Notebook will need to install the following tools:

invoke
node.js
less (npm install -g less)

Components

We are moving to a model where our JavaScript dependencies are managed using bower. These packages are installed in static/components and committed into a separate git repo ipython/ipython-components. Our dependencies are described in the file static/components/bower.json. To update our bower packages, run bower install in this directory.

less

If you edit our .less files you will need to run the less compiler to build our minified css files. This can be done by running python setup.py css from the root of the repository. If you are working frequently with .less files please consider installing git hooks that rebuild the css files and corresponding maps in ${RepoRoot}/git-hooks/install-hooks.sh.

JavaScript Documentation

How to Build/ view the doc for JavaScript. JavaScript documentation should follow a style close to JSDoc one, so you should be able to build them with your favorite documentation builder. Still the documentation comment are mainly written to be read with YUI doc. You can either build a static version, or start a YUIdoc server that will live update the doc at every page request.

To do so, you will need to install YUIdoc.

Install NodeJS

Node is a browser less javascript interpreter. To install it please refer to the documentation for your platform. Install also NPM (node package manager) if it does not come bundled with it.

Get YUIdoc

npm does by default install package in ./node_modules instead of doing a system wide install. I'll leave you to yuidoc docs if you want to make a system wide install.

First, cd into js directory :

cd IPython/html/static/js/
# install yuidoc
npm install yuidocjs

Run YUIdoc server

From IPython/html/static/js/

# run yuidoc for install dir 
./node_modules/yuidocjs/lib/cli.js --server .

Follow the instruction and the documentation should be available on localhost:3000

Omitting --server will build a static version in the out folder by default.