Show More
@@ -1,57 +1,57 | |||||
1 | ================================================================ |
|
1 | ================================================================ | |
2 | nbconvert: conversion utilities for the IPython notebook format |
|
2 | nbconvert: conversion utilities for the IPython notebook format | |
3 | ================================================================ |
|
3 | ================================================================ | |
4 |
|
4 | |||
5 | Overview |
|
5 | Overview | |
6 | ======== |
|
6 | ======== | |
7 |
|
7 | |||
8 | nbconvert provides command line utilities to convert to and from IPython |
|
8 | nbconvert provides command line utilities to convert to and from IPython | |
9 | notebooks and standard formats: |
|
9 | notebooks and standard formats: | |
10 |
|
10 | |||
11 | - ReST |
|
11 | - ReST | |
12 | - Markdown |
|
12 | - Markdown | |
13 | - HTML |
|
13 | - HTML | |
14 |
|
14 | |||
15 | - Python script |
|
15 | - Python script | |
16 |
|
16 | |||
17 | As these tools mature, these utilities will be merged into IPython. |
|
17 | As these tools mature, these utilities will be merged into IPython. | |
18 |
|
18 | |||
19 | Requirements |
|
19 | Requirements | |
20 | ============ |
|
20 | ============ | |
21 |
|
21 | |||
22 | The latest development version of doctest is required. This can be installed |
|
22 | The latest development version of doctest is required. This can be installed | |
23 | via :: |
|
23 | via :: | |
24 |
|
24 | |||
25 | $ curl http://docutils.svn.sourceforge.net/viewvc/docutils/trunk/docutils/?view=tar > docutils.tgz |
|
25 | $ curl http://docutils.svn.sourceforge.net/viewvc/docutils/trunk/docutils/?view=tar > docutils.tgz | |
26 | $ pip install -U docutils.gz |
|
26 | $ pip install -U docutils.tgz | |
27 |
|
27 | |||
28 | Nbconvert also needs the `pandoc multiformat converter |
|
28 | Nbconvert also needs the `pandoc multiformat converter | |
29 | <http://johnmacfarlane.net/pandoc>`_ to do the actual text conversions. Pandoc |
|
29 | <http://johnmacfarlane.net/pandoc>`_ to do the actual text conversions. Pandoc | |
30 | is included in most linux distributions package managers, and the author's |
|
30 | is included in most linux distributions package managers, and the author's | |
31 | website contains links to Mac OS X and Windows installers. |
|
31 | website contains links to Mac OS X and Windows installers. | |
32 |
|
32 | |||
33 | For conversion to HTML, pygments is also required |
|
33 | For conversion to HTML, pygments is also required | |
34 | :: |
|
34 | :: | |
35 |
|
35 | |||
36 | $ pip install pygments |
|
36 | $ pip install pygments | |
37 |
|
37 | |||
38 |
|
38 | |||
39 |
|
39 | |||
40 | Running Tests |
|
40 | Running Tests | |
41 | ============= |
|
41 | ============= | |
42 | :: |
|
42 | :: | |
43 |
|
43 | |||
44 | $ pip install nose |
|
44 | $ pip install nose | |
45 | $ nosetests |
|
45 | $ nosetests | |
46 |
|
46 | |||
47 |
|
47 | |||
48 | Using nbconvert |
|
48 | Using nbconvert | |
49 | =============== |
|
49 | =============== | |
50 |
|
50 | |||
51 | You will need to either put the source repository in your ``$PATH`` or symlink |
|
51 | You will need to either put the source repository in your ``$PATH`` or symlink | |
52 | the ``nbconvert.py`` script, as well as the ``css`` and ``js`` subdirectories |
|
52 | the ``nbconvert.py`` script, as well as the ``css`` and ``js`` subdirectories | |
53 | to a directory in your ``$PATH``. Once this is done, you can call it as:: |
|
53 | to a directory in your ``$PATH``. Once this is done, you can call it as:: | |
54 |
|
54 | |||
55 | nbconvert -f <FORMAT> notebook.ipynb |
|
55 | nbconvert -f <FORMAT> notebook.ipynb | |
56 |
|
56 | |||
57 | Use ``nbconvert -h`` for up to date help on the available formats. |
|
57 | Use ``nbconvert -h`` for up to date help on the available formats. |
General Comments 0
You need to be logged in to leave comments.
Login now