212 lines
8.1 KiB
Plaintext
212 lines
8.1 KiB
Plaintext
|
Metadata-Version: 2.1
|
||
|
Name: nbconvert
|
||
|
Version: 7.2.6
|
||
|
Summary: Converting Jupyter Notebooks
|
||
|
Project-URL: Homepage, https://jupyter.org
|
||
|
Author-email: Jupyter Development Team <jupyter@googlegroups.com>
|
||
|
License: # Licensing terms
|
||
|
|
||
|
This project is licensed under the terms of the Modified BSD License
|
||
|
(also known as New or Revised or 3-Clause BSD), as follows:
|
||
|
|
||
|
- Copyright (c) 2001-2015, IPython Development Team
|
||
|
- Copyright (c) 2015-, Jupyter Development Team
|
||
|
|
||
|
All rights reserved.
|
||
|
|
||
|
Redistribution and use in source and binary forms, with or without
|
||
|
modification, are permitted provided that the following conditions are met:
|
||
|
|
||
|
Redistributions of source code must retain the above copyright notice, this
|
||
|
list of conditions and the following disclaimer.
|
||
|
|
||
|
Redistributions in binary form must reproduce the above copyright notice, this
|
||
|
list of conditions and the following disclaimer in the documentation and/or
|
||
|
other materials provided with the distribution.
|
||
|
|
||
|
Neither the name of the Jupyter Development Team nor the names of its
|
||
|
contributors may be used to endorse or promote products derived from this
|
||
|
software without specific prior written permission.
|
||
|
|
||
|
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
|
||
|
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
|
||
|
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||
|
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
|
||
|
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
||
|
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
||
|
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
|
||
|
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
|
||
|
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
||
|
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||
|
|
||
|
## About the Jupyter Development Team
|
||
|
|
||
|
The Jupyter Development Team is the set of all contributors to the Jupyter project.
|
||
|
This includes all of the Jupyter subprojects.
|
||
|
|
||
|
The core team that coordinates development on GitHub can be found here:
|
||
|
https://github.com/jupyter/.
|
||
|
|
||
|
## Our Copyright Policy
|
||
|
|
||
|
Jupyter uses a shared copyright model. Each contributor maintains copyright
|
||
|
over their contributions to Jupyter. But, it is important to note that these
|
||
|
contributions are typically only changes to the repositories. Thus, the Jupyter
|
||
|
source code, in its entirety is not the copyright of any single person or
|
||
|
institution. Instead, it is the collective copyright of the entire Jupyter
|
||
|
Development Team. If individual contributors want to maintain a record of what
|
||
|
changes/contributions they have specific copyright on, they should indicate
|
||
|
their copyright in the commit message of the change, when they commit the
|
||
|
change to one of the Jupyter repositories.
|
||
|
|
||
|
With this in mind, the following banner should be used in any source code file
|
||
|
to indicate the copyright and license terms:
|
||
|
|
||
|
# Copyright (c) Jupyter Development Team.
|
||
|
# Distributed under the terms of the Modified BSD License.
|
||
|
License-File: LICENSE
|
||
|
Keywords: Interactive,Interpreter,Shell,Web
|
||
|
Classifier: Intended Audience :: Developers
|
||
|
Classifier: Intended Audience :: Science/Research
|
||
|
Classifier: Intended Audience :: System Administrators
|
||
|
Classifier: License :: OSI Approved :: BSD License
|
||
|
Classifier: Programming Language :: Python
|
||
|
Classifier: Programming Language :: Python :: 3
|
||
|
Requires-Python: >=3.7
|
||
|
Requires-Dist: beautifulsoup4
|
||
|
Requires-Dist: bleach
|
||
|
Requires-Dist: defusedxml
|
||
|
Requires-Dist: importlib-metadata>=3.6; python_version < '3.10'
|
||
|
Requires-Dist: jinja2>=3.0
|
||
|
Requires-Dist: jupyter-core>=4.7
|
||
|
Requires-Dist: jupyterlab-pygments
|
||
|
Requires-Dist: markupsafe>=2.0
|
||
|
Requires-Dist: mistune<3,>=2.0.3
|
||
|
Requires-Dist: nbclient>=0.5.0
|
||
|
Requires-Dist: nbformat>=5.1
|
||
|
Requires-Dist: packaging
|
||
|
Requires-Dist: pandocfilters>=1.4.1
|
||
|
Requires-Dist: pygments>=2.4.1
|
||
|
Requires-Dist: tinycss2
|
||
|
Requires-Dist: traitlets>=5.0
|
||
|
Provides-Extra: all
|
||
|
Requires-Dist: nbconvert[docs,qtpdf,serve,test,webpdf]; extra == 'all'
|
||
|
Provides-Extra: docs
|
||
|
Requires-Dist: ipykernel; extra == 'docs'
|
||
|
Requires-Dist: ipython; extra == 'docs'
|
||
|
Requires-Dist: myst-parser; extra == 'docs'
|
||
|
Requires-Dist: nbsphinx>=0.2.12; extra == 'docs'
|
||
|
Requires-Dist: pydata-sphinx-theme; extra == 'docs'
|
||
|
Requires-Dist: sphinx==5.0.2; extra == 'docs'
|
||
|
Provides-Extra: qtpdf
|
||
|
Requires-Dist: nbconvert[qtpng]; extra == 'qtpdf'
|
||
|
Provides-Extra: qtpng
|
||
|
Requires-Dist: pyqtwebengine>=5.15; extra == 'qtpng'
|
||
|
Provides-Extra: serve
|
||
|
Requires-Dist: tornado>=6.1; extra == 'serve'
|
||
|
Provides-Extra: test
|
||
|
Requires-Dist: ipykernel; extra == 'test'
|
||
|
Requires-Dist: ipywidgets>=7; extra == 'test'
|
||
|
Requires-Dist: pre-commit; extra == 'test'
|
||
|
Requires-Dist: pyppeteer<1.1,>=1; extra == 'test'
|
||
|
Requires-Dist: pytest; extra == 'test'
|
||
|
Requires-Dist: pytest-dependency; extra == 'test'
|
||
|
Provides-Extra: webpdf
|
||
|
Requires-Dist: pyppeteer<1.1,>=1; extra == 'webpdf'
|
||
|
Description-Content-Type: text/markdown
|
||
|
|
||
|
# nbconvert
|
||
|
|
||
|
### Jupyter Notebook Conversion
|
||
|
|
||
|
[![Build Status](https://travis-ci.org/jupyter/nbconvert.svg?branch=main)](https://travis-ci.org/jupyter/nbconvert)
|
||
|
[![Documentation Status](https://readthedocs.org/projects/nbconvert/badge/?version=latest)](https://nbconvert.readthedocs.io/en/latest/?badge=latest)
|
||
|
[![codecov.io](https://codecov.io/github/jupyter/nbconvert/coverage.svg?branch=main)](https://codecov.io/github/jupyter/nbconvert?branch=main)
|
||
|
|
||
|
The **nbconvert** tool, `jupyter nbconvert`, converts notebooks to various other
|
||
|
formats via [Jinja] templates. The nbconvert tool allows you to convert an
|
||
|
`.ipynb` notebook file into various static formats including:
|
||
|
|
||
|
- HTML
|
||
|
- LaTeX
|
||
|
- PDF
|
||
|
- Reveal JS
|
||
|
- Markdown (md)
|
||
|
- ReStructured Text (rst)
|
||
|
- executable script
|
||
|
|
||
|
## Usage
|
||
|
|
||
|
From the command line, use nbconvert to convert a Jupyter notebook (_input_) to a
|
||
|
a different format (_output_). The basic command structure is:
|
||
|
|
||
|
```
|
||
|
$ jupyter nbconvert --to <output format> <input notebook>
|
||
|
```
|
||
|
|
||
|
where `<output format>` is the desired output format and `<input notebook>` is the
|
||
|
filename of the Jupyter notebook.
|
||
|
|
||
|
### Example: Convert a notebook to HTML
|
||
|
|
||
|
Convert Jupyter notebook file, `mynotebook.ipynb`, to HTML using:
|
||
|
|
||
|
```
|
||
|
$ jupyter nbconvert --to html mynotebook.ipynb
|
||
|
```
|
||
|
|
||
|
This command creates an HTML output file named `mynotebook.html`.
|
||
|
|
||
|
## Dev Install
|
||
|
|
||
|
Check if pandoc is installed (`pandoc --version`); if needed, install:
|
||
|
|
||
|
```
|
||
|
sudo apt-get install pandoc
|
||
|
```
|
||
|
|
||
|
Or
|
||
|
|
||
|
```
|
||
|
brew install pandoc
|
||
|
```
|
||
|
|
||
|
Install nbconvert for development using:
|
||
|
|
||
|
```
|
||
|
git clone https://github.com/jupyter/nbconvert.git
|
||
|
cd nbconvert
|
||
|
pip install -e .
|
||
|
```
|
||
|
|
||
|
Running the tests after a dev install above:
|
||
|
|
||
|
```
|
||
|
pip install nbconvert[test]
|
||
|
py.test --pyargs nbconvert
|
||
|
```
|
||
|
|
||
|
## Documentation
|
||
|
|
||
|
- [Documentation for Jupyter nbconvert](https://nbconvert.readthedocs.io/en/latest/)
|
||
|
\[[PDF](https://media.readthedocs.org/pdf/nbconvert/latest/nbconvert.pdf)\]
|
||
|
- [nbconvert examples on GitHub](https://github.com/jupyter/nbconvert-examples)
|
||
|
- [Documentation for Project Jupyter](https://jupyter.readthedocs.io/en/latest/index.html)
|
||
|
\[[PDF](https://media.readthedocs.org/pdf/jupyter/latest/jupyter.pdf)\]
|
||
|
|
||
|
## Technical Support
|
||
|
|
||
|
- [Issues and Bug Reports](https://github.com/jupyter/nbconvert/issues): A place to report
|
||
|
bugs or regressions found for nbconvert
|
||
|
- [Community Technical Support and Discussion - Discourse](https://discourse.jupyter.org/): A place for
|
||
|
installation, configuration, and troubleshooting assistannce by the Jupyter community.
|
||
|
As a non-profit project and maintainers who are primarily volunteers, we encourage you
|
||
|
to ask questions and share your knowledge on Discourse.
|
||
|
|
||
|
## Jupyter Resources
|
||
|
|
||
|
- [Jupyter mailing list](https://groups.google.com/forum/#!forum/jupyter)
|
||
|
- [Project Jupyter website](https://jupyter.org)
|
||
|
|
||
|
[jinja]: http://jinja.pocoo.org/
|