Add a configuration overview page to help with topic discoverability

This commit is contained in:
Carol Willing 2016-04-06 13:21:44 -07:00
parent f49197c583
commit a3ac1d8aa1
2 changed files with 49 additions and 0 deletions

View File

@ -0,0 +1,48 @@
.. _configuration-overview:
Configuration Overview
======================
While Jupyter Notebook installs with default configuration settings, Jupyter
Notebook provides a rich array of options that may be configured to suit
your workflow. Let's explore four areas of configuration:
- Jupyter's Common Configuration system
- Notebook server
- Notebook front-end client
- Notebook extensions
:ref:`Security in Jupyter notebooks <notebook_security>` is a topic worthy of
serious consideration. Since security policies will vary from organization to
organization, we encourage you to consult with your security team on settings
that would be best for your use cases. Our documentation offers some
responsible security practices, and we recommend that you become familiar
with the practices.
Jupyter's Common Configuration system
-------------------------------------
- Configuring a Jupyter application
- Configuring a language kernel
- Python configuration files
- Command line arguments
- traitlets low-level architecture for configuration
Notebook server
---------------
- Configure the Notebook server
- Running a Notebook server
- Related: Configuring a language kernel
Notebook front-end client
-------------------------
- How front-end configuration works
* Example: Changing the notebook's default indentation setting
* Example: Restoring the notebook's default indentation setting
- Persisting configuration settings
Notebook extensions
-------------------
- Distributing Jupyter Extensions as Python Packages
- Extending the Notebook

View File

@ -32,6 +32,7 @@ The Jupyter notebook
:maxdepth: 2
:caption: Configuration
config_overview
config
public_server
security