mirror of
https://github.com/jupyter/notebook.git
synced 2025-02-05 12:19:58 +08:00
Iterate on the README
This commit is contained in:
parent
18bb945dd4
commit
b1706303e7
48
README.md
48
README.md
@ -1,8 +1,8 @@
|
||||
# Jupyter Notebook
|
||||
|
||||
[![Google Group](https://img.shields.io/badge/-Google%20Group-lightgrey.svg)](https://groups.google.com/forum/#!forum/jupyter)
|
||||
[![Build Status](https://travis-ci.org/jupyter/notebook.svg?branch=master)](https://travis-ci.org/jupyter/notebook)
|
||||
![Github Actions Status](https://github.com/jupyter/notebook/workflows/Build/badge.svg)
|
||||
[![Documentation Status](https://readthedocs.org/projects/jupyter-notebook/badge/?version=latest)](https://jupyter-notebook.readthedocs.io/en/latest/?badge=latest)
|
||||
[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/jupyter/notebook/main?urlpath=tree)
|
||||
[![codecov](https://codecov.io/gh/jupyter/notebook/branch/master/graph/badge.svg)](https://codecov.io/gh/jupyter/notebook)
|
||||
|
||||
The Jupyter notebook is a web-based notebook environment for interactive
|
||||
@ -12,19 +12,23 @@ computing.
|
||||
|
||||
### Notice
|
||||
|
||||
Please note that this repository is currently maintained by a skeleton crew of maintainers from the Jupyter community. We encourage users to transition to JupyterLab, where more immediate support can occur. Our approach moving forward will be:
|
||||
The Jupyter Notebook project is currently undertaking a transition to a more modern code base built from the ground-up using JupyterLab components and extensions.
|
||||
|
||||
1. To maintain the security of the Jupyter Notebook. That means security-related issues and pull requests are our highest priority.
|
||||
2. To address JupyterLab [feature parity issues](https://github.com/jupyterlab/jupyterlab/issues?q=is%3Aopen+is%3Aissue+label%3A%22tag%3AFeature+Parity%22). As part of this effort, we are also working on a better [notebook-only experience](https://github.com/jupyterlab/jupyterlab/issues/8450) in JupyterLab for users who prefer the UI of the classic Jupyter Notebook.
|
||||
3. To be responsive to the hard work of community members who have opened pull requests. We are triaging these PRs. We cannot support or maintain new features at this time, but we welcome security and other sustainability fixes.
|
||||
There is new stream of work which was submitted and then accepted as a Jupyter Enhancement Proposal (JEP): https://jupyter.org/enhancement-proposals/79-notebook-v7/notebook-v7.html
|
||||
|
||||
If you have an open pull request with a new feature or if you were planning to open one, please consider shipping it as a [notebook extension](https://jupyter-notebook.readthedocs.io/en/stable/extending/) instead.
|
||||
#### Notebook v7
|
||||
|
||||
##### Alternatives to contributing to `notebook`
|
||||
TODO
|
||||
|
||||
Additionally, please consider whether your contribution would be appropriate for either the underlying server for Jupyter front-ends, [jupyter_server](https://github.com/jupyter/jupyter_server) or in the [JupyterLab front-end](https://github.com/jupyterlab/jupyterlab).
|
||||
#### Classic Notebook v6
|
||||
|
||||
### Jupyter notebook, the language-agnostic evolution of IPython notebook
|
||||
Maintainance and security-related issues are now being addressed in the [`6.4.x`](https://github.com/jupyter/notebook/tree/6.4.x) branch.
|
||||
|
||||
New features and continuous improvement is now focused on Notebook v7 (see section above).
|
||||
|
||||
If you have an open pull request with a new feature or if you were planning to open one, we encourage switching over to the Jupyter Server and JupyterLab architecture, and distribute it as a server extension and / or JupyterLab prebuilt extension. That way your new feature will also be compatible with the new Notebook v7.
|
||||
|
||||
### Jupyter notebook, the language-agnostic evolution of IPython notebo
|
||||
|
||||
Jupyter notebook is a language-agnostic HTML notebook application for
|
||||
Project Jupyter. In 2015, Jupyter notebook was released as a part of
|
||||
@ -35,8 +39,9 @@ computing spans across many languages, Project Jupyter will continue to develop
|
||||
language-agnostic **Jupyter notebook** in this repo and with the help of the
|
||||
community develop language specific kernels which are found in their own
|
||||
discrete repos.
|
||||
[[The Big Split™ announcement](https://blog.jupyter.org/the-big-split-9d7b88a031a7)]
|
||||
[[Jupyter Ascending blog post](https://blog.jupyter.org/jupyter-ascending-1bf5b362d97e)]
|
||||
|
||||
- [The Big Split™ announcement](https://blog.jupyter.org/the-big-split-9d7b88a031a7)
|
||||
- [Jupyter Ascending blog post](https://blog.jupyter.org/jupyter-ascending-1bf5b362d97e)
|
||||
|
||||
## Installation
|
||||
|
||||
@ -48,7 +53,9 @@ The documentation for advanced usage of Jupyter notebook can be found
|
||||
For a local installation, make sure you have
|
||||
[pip installed](https://pip.readthedocs.io/en/stable/installing/) and run:
|
||||
|
||||
$ pip install notebook
|
||||
```bash
|
||||
pip install notebook
|
||||
```
|
||||
|
||||
## Usage - Running Jupyter notebook
|
||||
|
||||
@ -56,7 +63,9 @@ For a local installation, make sure you have
|
||||
|
||||
Launch with:
|
||||
|
||||
$ jupyter notebook
|
||||
```bash
|
||||
jupyter notebook
|
||||
```
|
||||
|
||||
### Running in a remote installation
|
||||
|
||||
@ -64,11 +73,16 @@ You need some configuration before starting Jupyter notebook remotely. See [Runn
|
||||
|
||||
## Development Installation
|
||||
|
||||
See [`CONTRIBUTING.rst`](CONTRIBUTING.rst) for how to set up a local development installation.
|
||||
See [`CONTRIBUTING.md`](CONTRIBUTING.md) for how to set up a local development installation.
|
||||
|
||||
## Contributing
|
||||
|
||||
If you are interested in contributing to the project, see [`CONTRIBUTING.rst`](CONTRIBUTING.rst).
|
||||
If you are interested in contributing to the project, see [`CONTRIBUTING.md`](CONTRIBUTING.md).
|
||||
|
||||
## Community Guidelines and Code of Conduct
|
||||
|
||||
This repository is a Jupyter project and follows the Jupyter
|
||||
[Community Guides and Code of Conduct](https://jupyter.readthedocs.io/en/latest/community/content-community.html).
|
||||
|
||||
## Resources
|
||||
|
||||
@ -78,4 +92,4 @@ If you are interested in contributing to the project, see [`CONTRIBUTING.rst`](C
|
||||
- [Korean Version of Installation](https://github.com/ChungJooHo/Jupyter_Kor_doc/)
|
||||
- [Documentation for Project Jupyter](https://jupyter.readthedocs.io/en/latest/index.html) [[PDF](https://media.readthedocs.org/pdf/jupyter/latest/jupyter.pdf)]
|
||||
- [Issues](https://github.com/jupyter/notebook/issues)
|
||||
- [Technical support - Jupyter Google Group](https://groups.google.com/forum/#!forum/jupyter)
|
||||
- [Technical support - Jupyter Google Group](https://discourse.jupyter.org/)
|
||||
|
Binary file not shown.
Before Width: | Height: | Size: 566 KiB |
Binary file not shown.
Before Width: | Height: | Size: 614 KiB |
Binary file not shown.
Before Width: | Height: | Size: 331 KiB After Width: | Height: | Size: 940 KiB |
@ -30,9 +30,12 @@
|
||||
},
|
||||
{
|
||||
"cell_type": "code",
|
||||
"execution_count": 2,
|
||||
"execution_count": 1,
|
||||
"metadata": {
|
||||
"collapsed": false
|
||||
"collapsed": false,
|
||||
"jupyter": {
|
||||
"outputs_hidden": false
|
||||
}
|
||||
},
|
||||
"outputs": [],
|
||||
"source": [
|
||||
@ -41,9 +44,12 @@
|
||||
},
|
||||
{
|
||||
"cell_type": "code",
|
||||
"execution_count": 3,
|
||||
"execution_count": 2,
|
||||
"metadata": {
|
||||
"collapsed": false
|
||||
"collapsed": false,
|
||||
"jupyter": {
|
||||
"outputs_hidden": false
|
||||
}
|
||||
},
|
||||
"outputs": [
|
||||
{
|
||||
@ -84,9 +90,12 @@
|
||||
},
|
||||
{
|
||||
"cell_type": "code",
|
||||
"execution_count": 4,
|
||||
"execution_count": 3,
|
||||
"metadata": {
|
||||
"collapsed": false
|
||||
"collapsed": false,
|
||||
"jupyter": {
|
||||
"outputs_hidden": false
|
||||
}
|
||||
},
|
||||
"outputs": [],
|
||||
"source": [
|
||||
@ -106,7 +115,10 @@
|
||||
"cell_type": "code",
|
||||
"execution_count": 5,
|
||||
"metadata": {
|
||||
"collapsed": false
|
||||
"collapsed": false,
|
||||
"jupyter": {
|
||||
"outputs_hidden": false
|
||||
}
|
||||
},
|
||||
"outputs": [],
|
||||
"source": [
|
||||
@ -174,7 +186,10 @@
|
||||
"cell_type": "code",
|
||||
"execution_count": 6,
|
||||
"metadata": {
|
||||
"collapsed": false
|
||||
"collapsed": false,
|
||||
"jupyter": {
|
||||
"outputs_hidden": false
|
||||
}
|
||||
},
|
||||
"outputs": [
|
||||
{
|
||||
@ -193,7 +208,10 @@
|
||||
"cell_type": "code",
|
||||
"execution_count": 7,
|
||||
"metadata": {
|
||||
"collapsed": false
|
||||
"collapsed": false,
|
||||
"jupyter": {
|
||||
"outputs_hidden": false
|
||||
}
|
||||
},
|
||||
"outputs": [
|
||||
{
|
||||
@ -227,7 +245,10 @@
|
||||
"cell_type": "code",
|
||||
"execution_count": 8,
|
||||
"metadata": {
|
||||
"collapsed": false
|
||||
"collapsed": false,
|
||||
"jupyter": {
|
||||
"outputs_hidden": false
|
||||
}
|
||||
},
|
||||
"outputs": [
|
||||
{
|
||||
@ -270,7 +291,10 @@
|
||||
"cell_type": "code",
|
||||
"execution_count": 9,
|
||||
"metadata": {
|
||||
"collapsed": false
|
||||
"collapsed": false,
|
||||
"jupyter": {
|
||||
"outputs_hidden": false
|
||||
}
|
||||
},
|
||||
"outputs": [
|
||||
{
|
||||
@ -346,7 +370,10 @@
|
||||
"cell_type": "code",
|
||||
"execution_count": 10,
|
||||
"metadata": {
|
||||
"collapsed": false
|
||||
"collapsed": false,
|
||||
"jupyter": {
|
||||
"outputs_hidden": false
|
||||
}
|
||||
},
|
||||
"outputs": [
|
||||
{
|
||||
@ -864,7 +891,7 @@
|
||||
],
|
||||
"metadata": {
|
||||
"kernelspec": {
|
||||
"display_name": "Python 3",
|
||||
"display_name": "Python 3 (ipykernel)",
|
||||
"language": "python",
|
||||
"name": "python3"
|
||||
},
|
||||
@ -878,9 +905,9 @@
|
||||
"name": "python",
|
||||
"nbconvert_exporter": "python",
|
||||
"pygments_lexer": "ipython3",
|
||||
"version": "3.5.1"
|
||||
"version": "3.10.2"
|
||||
}
|
||||
},
|
||||
"nbformat": 4,
|
||||
"nbformat_minor": 0
|
||||
"nbformat_minor": 4
|
||||
}
|
||||
|
Loading…
Reference in New Issue
Block a user