##// END OF EJS Templates
Merge pull request #12769 from meeseeksmachine/auto-backport-of-pr-12765-on-7.x...
Matthias Bussonnier -
r26291:7f7493ef merge
parent child Browse files
Show More
@@ -1,118 +1,118 b''
1 .. _introduction:
1 .. _introduction:
2
2
3 =====================
3 =====================
4 IPython Documentation
4 IPython Documentation
5 =====================
5 =====================
6
6
7 .. only:: html
7 .. only:: html
8
8
9 :Release: |release|
9 :Release: |release|
10 :Date: |today|
10 :Date: |today|
11
11
12 Welcome to the official IPython documentation
12 Welcome to the official IPython documentation
13
13
14 IPython provides a rich toolkit to help you make the most of using Python
14 IPython provides a rich toolkit to help you make the most of using Python
15 interactively. Its main components are:
15 interactively. Its main components are:
16
16
17 * A powerful interactive Python shell
17 * A powerful interactive Python shell
18
18
19
19
20 .. image:: /_images/ipython-6-screenshot.png
20 .. image:: ./_images/ipython-6-screenshot.png
21 :alt: Screenshot of IPython 6.0
21 :alt: Screenshot of IPython 6.0
22 :align: center
22 :align: center
23
23
24
24
25 * A `Jupyter <https://jupyter.org/>`_ kernel to work with Python code in Jupyter
25 * A `Jupyter <https://jupyter.org/>`_ kernel to work with Python code in Jupyter
26 notebooks and other interactive frontends.
26 notebooks and other interactive frontends.
27
27
28 The enhanced interactive Python shells and kernel have the following main
28 The enhanced interactive Python shells and kernel have the following main
29 features:
29 features:
30
30
31 * Comprehensive object introspection.
31 * Comprehensive object introspection.
32
32
33 * Input history, persistent across sessions.
33 * Input history, persistent across sessions.
34
34
35 * Caching of output results during a session with automatically generated
35 * Caching of output results during a session with automatically generated
36 references.
36 references.
37
37
38 * Extensible tab completion, with support by default for completion of python
38 * Extensible tab completion, with support by default for completion of python
39 variables and keywords, filenames and function keywords.
39 variables and keywords, filenames and function keywords.
40
40
41 * Extensible system of 'magic' commands for controlling the environment and
41 * Extensible system of 'magic' commands for controlling the environment and
42 performing many tasks related to IPython or the operating system.
42 performing many tasks related to IPython or the operating system.
43
43
44 * A rich configuration system with easy switching between different setups
44 * A rich configuration system with easy switching between different setups
45 (simpler than changing ``$PYTHONSTARTUP`` environment variables every time).
45 (simpler than changing ``$PYTHONSTARTUP`` environment variables every time).
46
46
47 * Session logging and reloading.
47 * Session logging and reloading.
48
48
49 * Extensible syntax processing for special purpose situations.
49 * Extensible syntax processing for special purpose situations.
50
50
51 * Access to the system shell with user-extensible alias system.
51 * Access to the system shell with user-extensible alias system.
52
52
53 * Easily embeddable in other Python programs and GUIs.
53 * Easily embeddable in other Python programs and GUIs.
54
54
55 * Integrated access to the pdb debugger and the Python profiler.
55 * Integrated access to the pdb debugger and the Python profiler.
56
56
57
57
58 The Command line interface inherits the above functionality and adds
58 The Command line interface inherits the above functionality and adds
59
59
60 * real multi-line editing thanks to `prompt_toolkit <http://python-prompt-toolkit.readthedocs.io/en/stable/>`_.
60 * real multi-line editing thanks to `prompt_toolkit <http://python-prompt-toolkit.readthedocs.io/en/stable/>`_.
61
61
62 * syntax highlighting as you type
62 * syntax highlighting as you type
63
63
64 * integration with command line editor for a better workflow.
64 * integration with command line editor for a better workflow.
65
65
66 The kernel also has its share of features. When used with a compatible frontend,
66 The kernel also has its share of features. When used with a compatible frontend,
67 it allows:
67 it allows:
68
68
69 * the object to create a rich display of Html, Images, Latex, Sound and
69 * the object to create a rich display of Html, Images, Latex, Sound and
70 Video.
70 Video.
71
71
72 * interactive widgets with the use of the `ipywidgets <http://ipywidgets.readthedocs.io/en/stable/>`_ package.
72 * interactive widgets with the use of the `ipywidgets <http://ipywidgets.readthedocs.io/en/stable/>`_ package.
73
73
74
74
75 This documentation will walk you through most of the features of the IPython
75 This documentation will walk you through most of the features of the IPython
76 command line and kernel, as well as describe the internal mechanisms in order
76 command line and kernel, as well as describe the internal mechanisms in order
77 to improve your Python workflow.
77 to improve your Python workflow.
78
78
79 You can find the table of content for this documentation in the left
79 You can find the table of content for this documentation in the left
80 sidebar, allowing you to come back to previous sections or skip ahead, if needed.
80 sidebar, allowing you to come back to previous sections or skip ahead, if needed.
81
81
82
82
83 The latest development version is always available from IPython's `GitHub
83 The latest development version is always available from IPython's `GitHub
84 repository <http://github.com/ipython/ipython>`_.
84 repository <http://github.com/ipython/ipython>`_.
85
85
86
86
87
87
88
88
89 .. toctree::
89 .. toctree::
90 :maxdepth: 1
90 :maxdepth: 1
91 :hidden:
91 :hidden:
92
92
93 self
93 self
94 overview
94 overview
95 whatsnew/index
95 whatsnew/index
96 install/index
96 install/index
97 interactive/index
97 interactive/index
98 config/index
98 config/index
99 development/index
99 development/index
100 coredev/index
100 coredev/index
101 api/index
101 api/index
102 sphinxext
102 sphinxext
103 about/index
103 about/index
104
104
105 .. seealso::
105 .. seealso::
106
106
107 `Jupyter documentation <http://jupyter.readthedocs.io/en/latest/>`__
107 `Jupyter documentation <http://jupyter.readthedocs.io/en/latest/>`__
108 The Jupyter documentation provides information about the Notebook code and other Jupyter sub-projects.
108 The Jupyter documentation provides information about the Notebook code and other Jupyter sub-projects.
109 `ipyparallel documentation <http://ipyparallel.readthedocs.io/en/latest/>`__
109 `ipyparallel documentation <http://ipyparallel.readthedocs.io/en/latest/>`__
110 Formerly ``IPython.parallel``.
110 Formerly ``IPython.parallel``.
111
111
112
112
113 .. only:: html
113 .. only:: html
114
114
115 * :ref:`genindex`
115 * :ref:`genindex`
116 * :ref:`modindex`
116 * :ref:`modindex`
117 * :ref:`search`
117 * :ref:`search`
118
118
General Comments 0
You need to be logged in to leave comments. Login now