Prechádzať zdrojové kódy

Restructure sectioning in the formats docs

Jason Grout 7 rokov pred
rodič
commit
efae3527f7
1 zmenil súbory, kde vykonal 26 pridanie a 26 odobranie
  1. 26 26
      docs/source/user/file_formats.md

+ 26 - 26
docs/source/user/file_formats.md

@@ -1,7 +1,5 @@
 # File and output formats
 
-## Overview
-
 JupyterLab provides a unified architecture for viewing and editing data in a
 wide variety of formats. This model applies whether the data is in a file or is
 provided by a kernel as rich cell output in a notebook or code console.
@@ -38,9 +36,10 @@ display({'text/html': '<h1>Hello World</h1>', 'text/plain': 'Hello World'}, raw=
 
 Other Jupyter kernels offer similar APIs.
 
-## Formats
+The rest of this section highlights some of the common data formats that
+JupyterLab supports.
 
-### Markdown
+## Markdown
 
 * File extension: `.md`
 * MIME type: `text/markdown`
@@ -56,7 +55,7 @@ The Markdown syntax supported in this mode is the same syntax used in the
 Jupyter Notebook (for example, LaTeX equations work). As seen in the animation,
 edits to the Markdown source are immediately reflected in the rendered version.
 
-### Images
+## Images
 
 * File extensions: `.bmp`, `.gif`, `.jpeg`, `.jpg`, `.png`, `.svg`
 * MIME types: `image/bmp`, `image/gif`, `image/jpeg`, `image/png`, `image/svg+xml`
@@ -65,21 +64,22 @@ JupyterLab supports image data in cell output and as files in the above formats.
 
 [animation]
 
-### HTML
+## CSV
 
-* File extension: `.html`
-* MIME type: `text/html`
+* File extension: `.csv`
+* MIME type: None
 
-JupyterLab supports rendering HTML in cell output and editing HTML files as text in the file editor.
+Files with rows of comma-separated values (CSV files) are a common
+format for tabular data. The default viewer for CSV files in JupyterLab is a high-performance data grid viewer:
 
-### LaTeX
+[animation]
 
-* File extension: `.tex`
-* MIME type: `text/latex`
+To edit a CSV file as a text file, right-click on the file in the file browser
+and select the “Editor” item in the “Open With…” submenu:
 
-JupyterLab supports rendering LaTeX in cell output and editing LaTeX files as text in the file editor.
+[animation]
 
-### JSON
+## JSON
 
 * File extension: `.json`
 * MIME type: `application/json`
@@ -93,22 +93,22 @@ and select the “Editor” item in the “Open With…” submenu:
 
 [animation]
 
-### CSV
+## HTML
 
-* File extension: `.csv`
-* MIME type: None
+* File extension: `.html`
+* MIME type: `text/html`
 
-Files with rows of comma-separated values (CSV files) are a common
-format for tabular data. The default viewer for CSV files in JupyterLab is a high-performance data grid viewer:
+JupyterLab supports rendering HTML in cell output and editing HTML files as text in the file editor.
 
-[animation]
+## LaTeX
 
-To edit a CSV file as a text file, right-click on the file in the file browser
-and select the “Editor” item in the “Open With…” submenu:
+* File extension: `.tex`
+* MIME type: `text/latex`
+
+JupyterLab supports rendering LaTeX in cell output and editing LaTeX files as text in the file editor.
 
-[animation]
 
-### PDF
+## PDF
 
 * File extension: `.pdf`
 * MIME type: `application/pdf`
@@ -118,7 +118,7 @@ JupyterLab, double-click on the file in the file browser:
 
 [animation]
 
-### Vega/Vega-Lite
+## Vega/Vega-Lite
 
 Vega:
 
@@ -163,7 +163,7 @@ or Vegas (Scala/Spark).
 A JupyterLab extension that supports Vega 3.x and Vega-Lite 2.x can be found
 [here](https://github.com/jupyterlab/jupyter-renderers).
 
-### Virtual DOM
+## Virtual DOM
 
 * File extension: `.vdom`, `.json`
 * MIME type: `application/vdom.v1+json`