You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

159 lines
5.7 KiB

4 years ago
  1. Metadata-Version: 2.1
  2. Name: nbconvert
  3. Version: 5.6.1
  4. Summary: Converting Jupyter Notebooks
  5. Home-page: https://jupyter.org
  6. Author: Jupyter Development Team
  7. Author-email: jupyter@googlegroups.com
  8. License: BSD
  9. Project-URL: Documentation, https://nbconvert.readthedocs.io/en/latest/
  10. Project-URL: Funding, https://numfocus.org/
  11. Project-URL: Source, https://github.com/jupyter/nbconvert
  12. Project-URL: Tracker, https://github.com/jupyter/nbconvert/issues
  13. Keywords: Interactive,Interpreter,Shell,Web
  14. Platform: Linux
  15. Platform: Mac OS X
  16. Platform: Windows
  17. Classifier: Intended Audience :: Developers
  18. Classifier: Intended Audience :: System Administrators
  19. Classifier: Intended Audience :: Science/Research
  20. Classifier: License :: OSI Approved :: BSD License
  21. Classifier: Programming Language :: Python
  22. Classifier: Programming Language :: Python :: 2.7
  23. Classifier: Programming Language :: Python :: 3
  24. Classifier: Programming Language :: Python :: 3.5
  25. Classifier: Programming Language :: Python :: 3.6
  26. Classifier: Programming Language :: Python :: 3.7
  27. Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*
  28. Description-Content-Type: text/markdown
  29. Requires-Dist: mistune (<2,>=0.8.1)
  30. Requires-Dist: jinja2 (>=2.4)
  31. Requires-Dist: pygments
  32. Requires-Dist: traitlets (>=4.2)
  33. Requires-Dist: jupyter-core
  34. Requires-Dist: nbformat (>=4.4)
  35. Requires-Dist: entrypoints (>=0.2.2)
  36. Requires-Dist: bleach
  37. Requires-Dist: pandocfilters (>=1.4.1)
  38. Requires-Dist: testpath
  39. Requires-Dist: defusedxml
  40. Provides-Extra: all
  41. Requires-Dist: pytest ; extra == 'all'
  42. Requires-Dist: pytest-cov ; extra == 'all'
  43. Requires-Dist: ipykernel ; extra == 'all'
  44. Requires-Dist: jupyter-client (>=5.3.1) ; extra == 'all'
  45. Requires-Dist: ipywidgets (>=7) ; extra == 'all'
  46. Requires-Dist: pebble ; extra == 'all'
  47. Requires-Dist: tornado (>=4.0) ; extra == 'all'
  48. Requires-Dist: sphinx (>=1.5.1) ; extra == 'all'
  49. Requires-Dist: sphinx-rtd-theme ; extra == 'all'
  50. Requires-Dist: nbsphinx (>=0.2.12) ; extra == 'all'
  51. Requires-Dist: sphinxcontrib-github-alt ; extra == 'all'
  52. Requires-Dist: ipython ; extra == 'all'
  53. Requires-Dist: mock ; (python_version < "3.4") and extra == 'all'
  54. Provides-Extra: docs
  55. Requires-Dist: sphinx (>=1.5.1) ; extra == 'docs'
  56. Requires-Dist: sphinx-rtd-theme ; extra == 'docs'
  57. Requires-Dist: nbsphinx (>=0.2.12) ; extra == 'docs'
  58. Requires-Dist: sphinxcontrib-github-alt ; extra == 'docs'
  59. Requires-Dist: ipython ; extra == 'docs'
  60. Requires-Dist: jupyter-client (>=5.3.1) ; extra == 'docs'
  61. Provides-Extra: execute
  62. Requires-Dist: jupyter-client (>=5.3.1) ; extra == 'execute'
  63. Provides-Extra: serve
  64. Requires-Dist: tornado (>=4.0) ; extra == 'serve'
  65. Provides-Extra: test
  66. Requires-Dist: pytest ; extra == 'test'
  67. Requires-Dist: pytest-cov ; extra == 'test'
  68. Requires-Dist: ipykernel ; extra == 'test'
  69. Requires-Dist: jupyter-client (>=5.3.1) ; extra == 'test'
  70. Requires-Dist: ipywidgets (>=7) ; extra == 'test'
  71. Requires-Dist: pebble ; extra == 'test'
  72. Requires-Dist: mock ; (python_version < "3.4") and extra == 'test'
  73. # nbconvert
  74. ### Jupyter Notebook Conversion
  75. [![Google Group](https://img.shields.io/badge/-Google%20Group-lightgrey.svg)](https://groups.google.com/forum/#!forum/jupyter)
  76. [![Build Status](https://travis-ci.org/jupyter/nbconvert.svg?branch=master)](https://travis-ci.org/jupyter/nbconvert)
  77. [![Documentation Status](https://readthedocs.org/projects/nbconvert/badge/?version=latest)](https://nbconvert.readthedocs.io/en/latest/?badge=latest)
  78. [![Documentation Status](https://readthedocs.org/projects/nbconvert/badge/?version=stable)](http://nbconvert.readthedocs.io/en/stable/?badge=stable)
  79. [![codecov.io](https://codecov.io/github/jupyter/nbconvert/coverage.svg?branch=master)](https://codecov.io/github/jupyter/nbconvert?branch=master)
  80. [![CircleCI Docs Status](https://circleci.com/gh/jupyter/nbconvert/tree/master.svg?style=svg)](https://circleci.com/gh/jupyter/nbconvert/tree/master)
  81. The **nbconvert** tool, `jupyter nbconvert`, converts notebooks to various other
  82. formats via [Jinja][] templates. The nbconvert tool allows you to convert an
  83. `.ipynb` notebook file into various static formats including:
  84. * HTML
  85. * LaTeX
  86. * PDF
  87. * Reveal JS
  88. * Markdown (md)
  89. * ReStructured Text (rst)
  90. * executable script
  91. ## Usage
  92. From the command line, use nbconvert to convert a Jupyter notebook (*input*) to a
  93. a different format (*output*). The basic command structure is:
  94. $ jupyter nbconvert --to <output format> <input notebook>
  95. where `<output format>` is the desired output format and `<input notebook>` is the
  96. filename of the Jupyter notebook.
  97. ### Example: Convert a notebook to HTML
  98. Convert Jupyter notebook file, `mynotebook.ipynb`, to HTML using:
  99. $ jupyter nbconvert --to html mynotebook.ipynb
  100. This command creates an HTML output file named `mynotebook.html`.
  101. ## Dev Install
  102. Check if pandoc is installed (``pandoc --version``); if needed, install:
  103. ```
  104. sudo apt-get install pandoc
  105. ```
  106. Or
  107. ```
  108. brew install pandoc
  109. ```
  110. Install nbconvert for development using:
  111. ```
  112. git clone https://github.com/jupyter/nbconvert.git
  113. cd nbconvert
  114. pip install -e .
  115. ```
  116. Running the tests after a dev install above:
  117. ```
  118. pip install nbconvert[test]
  119. py.test --pyargs nbconvert
  120. ```
  121. ## Resources
  122. - [Documentation for Jupyter nbconvert](https://nbconvert.readthedocs.io/en/latest/)
  123. [[PDF](https://media.readthedocs.org/pdf/nbconvert/latest/nbconvert.pdf)]
  124. - [nbconvert examples on GitHub](https://github.com/jupyter/nbconvert-examples)
  125. - [Issues](https://github.com/jupyter/nbconvert/issues)
  126. - [Technical support - Jupyter Google Group](https://groups.google.com/forum/#!forum/jupyter)
  127. - [Project Jupyter website](https://jupyter.org)
  128. - [Documentation for Project Jupyter](https://jupyter.readthedocs.io/en/latest/index.html)
  129. [[PDF](https://media.readthedocs.org/pdf/jupyter/latest/jupyter.pdf)]
  130. [Jinja]: http://jinja.pocoo.org/