Make anchor links to each video in the docs (#4205)

* Add anchor links for videos in interface.rst

* Add anchor links for videos in files.rst

* Add anchor links for videos in file_editor.rst

* Add anchor links for videos in notebook.rst

* Add anchor links for videos in code_console.rst

* Add anchor links for videos in terminal.rst

* Add anchor links for videos in running.rst

* Add anchor links for videos in commands.rst

* Add anchor links for videos in documents_kernels.rst

* Add anchor links for videos in file_formats.rst

* Add anchor links for videos in developer notebook.rst

* Fix typo pallette -> palette in commands.rst

* Change underscore to dashes in anchor links
in interface.rst, file_editor.rst, files.rst, notebook.rst

* Change underscore to dashes in anchorlinks in code_console.rst

* Change underscore to dashes in anchor links for developer notebook.rst

* Change underscores to dashes in anchor links in user guide

* Fix existing anchor links from underscore to dashes

docs/source/developer/notebook.rst

@@ -4,6 +4,8 @@ Notebook
 Background
 ~~~~~~~~~~
 
+.. _architecture-walkthrough:
+
 A JupyterLab architecture walkthrough from June 16, 2016, provides an overview of the notebook architecture.
 
 .. raw:: html

docs/source/getting_started/overview.rst

@@ -17,7 +17,7 @@ components in a flexible, integrated, and extensible manner. You can
 work area using tabs and splitters. Documents and activities integrate with each
 other, enabling new workflows for interactive computing, for example:
 
--  :ref:`code_console` provide transient scratchpads for running code
+-  :ref:`code-console` provide transient scratchpads for running code
    interactively, with full support for rich output. A code console can be
    linked to a notebook kernel as a computation log from the notebook, for
    example.
@@ -37,7 +37,7 @@ Vega, Vega-Lite, etc.) and can also display rich kernel output in these formats.
 See :ref:`file-and-output-formats` for more information.
 
 To navigate the user interface, JupyterLab offers :ref:`customizable keyboard
-shortcuts <shortcuts>` and the ability to use :ref:`key maps <editor_keymaps>`
+shortcuts <shortcuts>` and the ability to use :ref:`key maps <editor-keymaps>`
 from vim, emacs, and Sublime Text in the text editor.
 
 JupyterLab :ref:`extensions <user_extensions>` can customize or enhance any part

docs/source/user/code_console.rst

@@ -1,4 +1,4 @@
-.. _code_console:
+.. _code-console:
 
 Code Consoles
 -------------
@@ -9,8 +9,10 @@ kernel, as opposed to the explicit ordering of cells in a notebook
 document. Code consoles also display rich output, just like notebook
 cells.
 
+.. _create-console:
+
 Create a new code console by clicking the ``+`` button in the :ref:`file
-browser <left_sidebar>` and selecting the kernel:
+browser <left-sidebar>` and selecting the kernel:
 
 .. raw:: html
 
@@ -18,6 +20,8 @@ browser <left_sidebar>` and selecting the kernel:
      <iframe src="https://www.youtube-nocookie.com/embed/7Sb_a6veU1s?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
   </div>
 
+.. _run-code:
+
 Run code using ``Shift Enter``. Use the up and down arrows to browse the
 history of previously-run code:
 
@@ -27,6 +31,8 @@ history of previously-run code:
      <iframe src="https://www.youtube-nocookie.com/embed/L52yh9FPAtY?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
   </div>
 
+.. _tab-completion:
+
 Tab completion (``Tab``) and tooltips (``Shift Tab``) work as in the
 notebook:
 
@@ -36,6 +42,8 @@ notebook:
      <iframe src="https://www.youtube-nocookie.com/embed/WoqFgmSuigE?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
   </div>
 
+.. _clear-cell:
+
 Clear the cells of the code console without restarting the kernel by
 right-clicking on the code console and selecting “Clear Console Cells”:
 
@@ -45,7 +53,9 @@ right-clicking on the code console and selecting “Clear Console Cells”:
      <iframe src="https://www.youtube-nocookie.com/embed/Aj7sQgP39z8?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
   </div>
 
-Creating a code console from the :ref:`file menu <menu_bar>` lets you select an existing
+.. _log-inspect:
+
+Creating a code console from the :ref:`file menu <menu-bar>` lets you select an existing
 kernel for the code console. The code console then acts as a log of
 computations in that kernel, and a place you can interactively inspect
 and run code in the kernel:

docs/source/user/commands.rst

@@ -13,6 +13,8 @@ JupyterLab commands:
    :align: center
    :class: jp-screenshot
 
+.. _access-palette:
+
 The command palette can be accessed using the keyboard shortcut
 ``Command/Ctrl Shift C``:
 

docs/source/user/documents_kernels.rst

@@ -6,9 +6,11 @@ Documents and kernels
 In the Jupyter architecture, kernels are separate processes started by
 the server that run your code in different programming languages and
 environments. JupyterLab enables you to connect any open text file to a
-:ref:`code console and kernel <code_console>`. This means you can easily run code from the
+:ref:`code console and kernel <code-console>`. This means you can easily run code from the
 text file in the kernel interactively.
 
+.. _create-console:
+
 Right-click on a document and select “Create Console for Editor”:
 
 .. raw:: html
@@ -17,6 +19,8 @@ Right-click on a document and select “Create Console for Editor”:
      <iframe src="https://www.youtube-nocookie.com/embed/JS2mhCD3rwE?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
   </div>
 
+.. _send-code:
+
 Once the code console is open, send a single line of code or select a
 block of code and send it to the code console by hitting
 ``Shift Enter``:
@@ -27,6 +31,8 @@ block of code and send it to the code console by hitting
      <iframe src="https://www.youtube-nocookie.com/embed/ODevllc9PXw?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
   </div>
 
+.. _run-markdown:
+
 In a Markdown document, ``Shift Enter`` will automatically detect if the
 cursor is within a code block, and run the entire block if there is no
 selection:

docs/source/user/file_editor.rst

@@ -1,4 +1,4 @@
-.. _file_editor:
+.. _file-editor:
 
 Text Editor
 -----------
@@ -11,13 +11,15 @@ JupyterLab:
    :class: jp-screenshot
 
 The text editor includes syntax highlighting, configurable indentation
-(tabs or spaces), :ref:`key maps <editor_keymaps>` and
+(tabs or spaces), :ref:`key maps <editor-keymaps>` and
 basic theming. These settings can be found in the Settings menu:
 
 .. image:: images/file_editor_settings.png
    :align: center
    :class: jp-screenshot
 
+.. _edit-existing-file:
+
 To edit an existing text file, double-click on its name in the file
 browser or drag it into the main work area:
 
@@ -27,6 +29,8 @@ browser or drag it into the main work area:
     <iframe src="https://www.youtube-nocookie.com/embed/IuqmxkHsS7o?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
   </div>
 
+.. _create-file-button:
+
 To create a new text file in the current directory of the file browser,
 click the ``+`` button at the top of the file browser to create a new
 Launcher tab, and click the “Text Editor” card in the Launcher:
@@ -37,6 +41,8 @@ Launcher tab, and click the “Text Editor” card in the Launcher:
     <iframe src="https://www.youtube-nocookie.com/embed/T1XVz-rjW8I?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
   </div>
 
+.. _create-file-menu:
+
 You can also create a new text file with the File menu:
 
 .. raw:: html
@@ -45,6 +51,8 @@ You can also create a new text file with the File menu:
     <iframe src="https://www.youtube-nocookie.com/embed/ssFCduQAF48?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
   </div>
 
+.. _rename-file:
+
 A new file is created with a default name. Rename a file by
 right-clicking on its name in the file browser and selecting “Rename”
 from the context menu:

docs/source/user/file_formats.rst

@@ -62,6 +62,8 @@ Markdown
 Markdown is a simple and popular markup language used for text cells in
 the Jupyter Notebook.
 
+.. _edit-markdown:
+
 Markdown documents can be edited as text files or rendered inline:
 
 .. raw:: html
@@ -89,6 +91,8 @@ as ``+`` and ``-`` to zoom the image, ``[`` and ``]`` to rotate the image,
 and ``H`` and ``V`` to flip the image horizontally and vertically. Use
 ``I`` to invert the colors, and use ``0`` to reset the image.
 
+.. _edit-svg:
+
 To edit an SVG image as a text file, right-click on the SVG filename in
 the file browser and select the “Editor” item in the “Open With”
 submenu:
@@ -107,6 +111,8 @@ Delimiter-separated Values
 -  File extension: ``.csv``
 -  MIME type: None
 
+.. _view-csv:
+
 Files with rows of delimiter-separated values, such as CSV files, are a common format for
 tabular data. The default viewer for these files in JupyterLab is a
 high-performance data grid viewer which can handles comma-separated, tab-separated, and
@@ -121,6 +127,8 @@ semicolon-separated values:
 While tab-separated value files can be read by the grid viewer, it currently does not automatically recognize ``.tsv`` files.
 To view, you must change the extension to ``.csv`` and set the delimiter to tabs.
 
+.. _edit-csv:
+
 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:
 
@@ -151,6 +159,8 @@ JSON
 -  File extension: ``.json``
 -  MIME type: ``application/json``
 
+.. _view-json:
+
 JavaScript Object Notation (JSON) files are common in data science.
 JupyterLab supports displaying JSON data in cell output or viewing a
 JSON file using a searchable tree view:
@@ -161,6 +171,8 @@ JSON file using a searchable tree view:
     <iframe src="https://www.youtube-nocookie.com/embed/FRj1r7-7kiQ?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
   </div>
 
+.. _edit-json:
+
 To edit the JSON as a text file, right-click on the filename in the file
 browser and select the “Editor” item in the “Open With” submenu:
 
@@ -194,6 +206,8 @@ PDF
 -  File extension: ``.pdf``
 -  MIME type: ``application/pdf``
 
+.. _view-pdf:
+
 PDF is a common standard file format for documents. To view a PDF file
 in JupyterLab, double-click on the file in the file browser:
 
@@ -223,6 +237,8 @@ visualizations to be encoded as JSON data. For more information, see the
 documentation of Vega or Vega-Lite. JupyterLab supports rendering Vega
 2.x and Vega-Lite 1.x data in files and cell output.
 
+.. _open-vega:
+
 Vega-Lite 1.x files, with a ``.vl`` or ``.vl.json`` file extension, can
 be opened by double-clicking the file in the file browser:
 
@@ -232,6 +248,8 @@ be opened by double-clicking the file in the file browser:
     <iframe src="https://www.youtube-nocookie.com/embed/Dddtyz5fWkU?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
   </div>
 
+.. _open-vega-with:
+
 The files can also be opened in the JSON viewer or file editor through
 the “Open With…” submenu in the file browser content menu:
 
@@ -241,6 +259,8 @@ the “Open With…” submenu in the file browser content menu:
     <iframe src="https://www.youtube-nocookie.com/embed/qaiGRXh4jxc?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
   </div>
 
+.. _vega-multiple-views:
+
 As with other files in JupyterLab, multiple views of a single file
 remain synchronized, enabling you to interactively edit and render
 Vega/Vega-Lite visualizations:
@@ -280,6 +300,8 @@ format <https://github.com/nteract/vdom>`__ for virtual DOM data.
 JupyterLab can render this data using react.js. This works for both VDOM
 files with the ``.vdom`` extension, or within notebook output.
 
+.. _edit-vdom:
+
 Here is an example of a ``.vdom`` file being edited and rendered
 interactively:
 

docs/source/user/files.rst

@@ -1,4 +1,4 @@
-.. _working_with_files:
+.. _working-with-files:
 
 Working with Files
 ------------------
@@ -22,6 +22,8 @@ Many actions on files can also be carried out in the File menu:
    :align: center
    :class: jp-screenshot
 
+.. _open-file:
+
 To open any file, double-click on its name in the file browser:
 
 .. raw:: html
@@ -30,6 +32,8 @@ To open any file, double-click on its name in the file browser:
      <iframe src="https://www.youtube-nocookie.com/embed/Rh-vwjTwBTI?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
   </div>
 
+.. _newtab:
+
 You can also drag a file into the main work area to create a new tab:
 
 .. raw:: html
@@ -38,8 +42,10 @@ You can also drag a file into the main work area to create a new tab:
      <iframe src="https://www.youtube-nocookie.com/embed/uwMmHeDmRxk?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
   </div>
 
+.. _multiple-viewers:
+
 Many files types have :ref:`multiple viewers/editors <file-and-output-formats>`.
-For example, you can open a Markdown file in a :ref:`text editor <file_editor>` or as rendered HTML.
+For example, you can open a Markdown file in a :ref:`text editor <file-editor>` or as rendered HTML.
 A JupyterLab extension can also add new viewers/editors for files.
 To open a file in a non-default viewer/editor, right-click on its name in the
 file browser and use the "Open With..." submenu to select the viewer/editor:
@@ -50,6 +56,8 @@ file browser and use the "Open With..." submenu to select the viewer/editor:
      <iframe src="https://www.youtube-nocookie.com/embed/1kEgUqAeYo0?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
   </div>
 
+.. _single-doc-sync:
+
 A single file can be open simultaneously in multiple viewer/editors and
 they will remain in sync:
 
@@ -59,6 +67,8 @@ they will remain in sync:
      <iframe src="https://www.youtube-nocookie.com/embed/87ALbxm1Y3I?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
   </div>
 
+.. _file-navigation:
+
 The file system can be navigated by double-clicking on folders in the
 listing or clicking on the folders at the top of the directory listing:
 
@@ -68,6 +78,8 @@ listing or clicking on the folders at the top of the directory listing:
      <iframe src="https://www.youtube-nocookie.com/embed/2OHwJzjG-l4?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
   </div>
 
+.. _file-share:
+
 Right-click on a file or directory and select "Copy Shareable Link" to
 copy a URL that can be used to open JupyterLab with that file or
 directory open.
@@ -79,6 +91,8 @@ directory open.
 Creating Files and Activities
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+.. _file-create-plus:
+
 Create new files or activities by clicking the ``+`` button at the top
 of the file browser. This will open a new Launcher tab in the main work area,
 which enables you to pick an activity and kernel:
@@ -89,12 +103,16 @@ which enables you to pick an activity and kernel:
      <iframe src="https://www.youtube-nocookie.com/embed/QL0IxDAOEc0?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
   </div>
 
+.. _file-create-menu:
+
 You can also create new documents or activities using the File menu:
 
 .. image:: images/file_create_text_file.png
    :align: center
    :class: jp-screenshot
 
+.. _current-directory:
+
 The current working directory of a new activity or document will be the
 directory listed in the file browser (except for a terminal, which
 always starts in the root directory of the file browser):
@@ -105,6 +123,8 @@ always starts in the root directory of the file browser):
      <iframe src="https://www.youtube-nocookie.com/embed/OfISSOTiGTY?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
   </div>
 
+.. _file-rename:
+
 A new file is created with a default name. Rename a file by
 right-clicking on its name in the file browser and selecting “Rename”
 from the context menu:
@@ -118,6 +138,8 @@ from the context menu:
 Uploading and Downloading
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
+.. _file-upload:
+
 Files can be uploaded to the current directory of the file browser by
 dragging and dropping files onto the file browser, or by clicking the
 "Upload Files" button at the top of the file browser:
@@ -128,6 +150,8 @@ dragging and dropping files onto the file browser, or by clicking the
      <iframe src="https://www.youtube-nocookie.com/embed/1bd2QHqQSH4?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
   </div>
 
+.. _file-download:
+
 Any file in JupyterLab can be downloaded by right-clicking its name in
 the file browser and selecting “Download” from the context menu:
 

docs/source/user/interface.rst

@@ -8,10 +8,10 @@ exploratory computing. While JupyterLab has many features found in
 traditional integrated development environments (IDEs), it remains
 focused on interactive, exploratory computing.
 
-The JupyterLab interface consists of a :ref:`main work area <main_area>`
+The JupyterLab interface consists of a :ref:`main work area <main-area>`
 containing tabs of documents and activities, a collapsible :ref:`left sidebar
-<left_sidebar>`, and a :ref:`menu bar <menu_bar>`. The left sidebar contains a
-:ref:`file browser <working_with_files>`, the :ref:`list of running kernels and
+<left-sidebar>`, and a :ref:`menu bar <menu-bar>`. The left sidebar contains a
+:ref:`file browser <working-with-files>`, the :ref:`list of running kernels and
 terminals <running>`, the :ref:`command palette <commands>`, the :ref:`notebook
 cell tools inspector <notebook>`, and the :ref:`tabs list <tabs>`.
 
@@ -19,7 +19,7 @@ cell tools inspector <notebook>`, and the :ref:`tabs list <tabs>`.
    :align: center
    :class: jp-screenshot
 
-.. _menu_bar:
+.. _menu-bar:
 
 Menu Bar
 ~~~~~~~~
@@ -42,7 +42,7 @@ default menus are:
 :ref:`JupyterLab extensions <user_extensions>` can also create new top-level menus in the menu
 bar.
 
-.. _left_sidebar:
+.. _left-sidebar:
 
 Left Sidebar
 ~~~~~~~~~~~~
@@ -55,10 +55,13 @@ and a list of tabs in the main work area:
    :align: center
    :class: jp-screenshot
 
+.. _left-sidebar-toggle:
+
 The left sidebar can be collapsed or expanded by selecting "Show Left Area"
 in the View menu or by clicking on the active sidebar tab:
 
-.. raw:: html
+
+.. raw:: html 
 
   <div class="jp-youtube-video">
      <iframe src="https://www.youtube-nocookie.com/embed/PlJGecfetek?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
@@ -66,11 +69,13 @@ in the View menu or by clicking on the active sidebar tab:
 
 JupyterLab extensions can add additional panels to the left sidebar.
 
-.. _main_area:
+.. _main-area:
 
 Main Work Area
 ~~~~~~~~~~~~~~
 
+.. _main-area-vid:
+
 The main work area in JupyterLab enables you to arrange documents (notebooks,
 text files, etc.) and other activities (terminals, code consoles, etc.) into
 panels of tabs that can be resized or subdivided. Drag a tab to the center of a
@@ -104,6 +109,8 @@ The same information is also available in the Tabs menu:
    :align: center
    :class: jp-screenshot
 
+.. _tabs-singledocument:
+
 It is often useful to focus on a single document or activity without closing
 other tabs in the main work area. Single-document mode enable this, while making
 it simple to return to your multi-activity layout in the main work area.
@@ -121,6 +128,8 @@ area is restored.
 Context Menus
 ~~~~~~~~~~~~~
 
+.. _context-menus-rightclick:
+
 Many parts of JupyterLab, such as notebooks, text files, code consoles,
 and tabs, have context menus that can be accessed by right-clicking on
 the element:
@@ -131,6 +140,8 @@ the element:
     <iframe src="https://www.youtube-nocookie.com/embed/y30fs6kg6fc?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
   </div>
 
+.. _context-menus-shiftrightclick:
+
 The browser’s native context menu can be accessed by holding down
 ``Shift`` and right-clicking:
 
@@ -145,6 +156,8 @@ The browser’s native context menu can be accessed by holding down
 Keyboard Shortcuts
 ~~~~~~~~~~~~~~~~~~
 
+.. _shortcuts-settings:
+
 As in the classic Notebook, you can navigate the user interface through keyboard
 shortcuts. You can find and customize the current list of keyboard shortcuts by
 selecting the Advanced Settings Editor item in the Settings menu, then selecting
@@ -156,9 +169,9 @@ Keyboard Shortcuts in the Settings tab.
        <iframe src="https://www.youtube-nocookie.com/embed/rhW3kAExCik?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
     </div>
 
-.. _editor_keymaps:
+.. _editor-keymaps:
 
-You can also customize the :ref:`text editor <file_editor>` to use vim, emacs, or Sublime Text
+You can also customize the :ref:`text editor <file-editor>` to use vim, emacs, or Sublime Text
 keyboard maps by using the Text Editor Key Map submenu in the Settings
 menu:
 

docs/source/user/notebook.rst

@@ -17,6 +17,8 @@ JupyterLab is the same as in the classic Jupyter Notebook. Your existing noteboo
 should open correctly in JupyterLab. If they don’t, please open an issue on our
 `GitHub issues <https://github.com/jupyterlab/jupyterlab/issues>`__ page.
 
+.. _create-notebook:
+
 Create a notebook by clicking the ``+`` button in the file browser and
 then selecting a kernel in the new Launcher tab:
 
@@ -26,6 +28,8 @@ then selecting a kernel in the new Launcher tab:
      <iframe src="https://www.youtube-nocookie.com/embed/QL0IxDAOEc0?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
   </div>
 
+.. _rename-file:
+
 A new file is created with a default name. Rename a file by
 right-clicking on its name in the file browser and selecting “Rename”
 from the context menu:
@@ -41,6 +45,8 @@ the classic Jupyter Notebook. The keyboard shortcuts of the classic
 Notebook continue to work (with command and edit mode). However, a
 number of new things are possible with notebooks in JupyterLab.
 
+.. _drag-drop:
+
 Drag and drop cells to rearrange your notebook:
 
 .. raw:: html
@@ -49,6 +55,8 @@ Drag and drop cells to rearrange your notebook:
      <iframe src="https://www.youtube-nocookie.com/embed/J9xoTGdqWIo?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
   </div>
 
+.. _drag-copy:
+
 Drag cells between notebooks to quickly copy content:
 
 .. raw:: html
@@ -57,6 +65,8 @@ Drag cells between notebooks to quickly copy content:
      <iframe src="https://www.youtube-nocookie.com/embed/YTNZ5TS2LfU?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
   </div>
 
+.. _multiple-views:
+
 Create multiple synchronized views of a single notebook:
 
 .. raw:: html
@@ -65,6 +75,8 @@ Create multiple synchronized views of a single notebook:
      <iframe src="https://www.youtube-nocookie.com/embed/SQn9aRc050w?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
   </div>
 
+.. _collapse-code:
+
 Collapse and expand code and output using the View menu or the blue
 collapser button on left of each cell:
 
@@ -74,6 +86,8 @@ collapser button on left of each cell:
      <iframe src="https://www.youtube-nocookie.com/embed/WgiX3ZRaTiY?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
   </div>
 
+.. _enable-scrolling:
+
 Enable scrolling for long outputs by right-clicking on a cell and
 selecting “Enable Scrolling for Outputs”:
 
@@ -93,6 +107,8 @@ Create a new synchronized view of a cell’s output:
      <iframe src="https://www.youtube-nocookie.com/embed/Asa_ML45HP8?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
   </div>
 
+.. _tab-completion:
+
 Tab completion (activated with the ``Tab`` key) now includes additional
 information about the types of the matched items:
 
@@ -102,6 +118,7 @@ information about the types of the matched items:
      <iframe src="https://www.youtube-nocookie.com/embed/MuNr0i8LgpM?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
   </div>
 
+.. _tooltip:
 
 The tooltip (activated with ``Shift Tab``) contains additional
 information about objects:
@@ -112,7 +129,9 @@ information about objects:
      <iframe src="https://www.youtube-nocookie.com/embed/TgqMK1SG7XI?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
   </div>
 
-You can connect a :ref:`code console <code_console>` to a notebook kernel to have a log of
+.. _create-console:
+
+You can connect a :ref:`code console <code-console>` to a notebook kernel to have a log of
 computations done in the kernel, in the order in which they were done.
 The attached code console also provides a place to interactively inspect
 kernel state without changing the notebook. Right-click on a notebook

docs/source/user/running.rst

@@ -11,6 +11,8 @@ directories:
    :align: center
    :class: jp-screenshot
 
+.. _reopen-document:
+
 As with the classic Jupyter Notebook, when you close a notebook
 document, code console, or terminal, the underlying kernel or terminal
 running on the server continues to run. This enables you to perform
@@ -23,6 +25,8 @@ re-open or focus the document linked to a given kernel or terminal:
      <iframe src="https://www.youtube-nocookie.com/embed/gDM5lwU6Dmo?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
   </div>
 
+.. _shutdown-kernel:
+
 Kernels or terminals can be shut down from the Running panel:
 
 .. raw:: html
@@ -31,6 +35,8 @@ Kernels or terminals can be shut down from the Running panel:
      <iframe src="https://www.youtube-nocookie.com/embed/PBDN9AJWBlw?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
   </div>
 
+.. _shutdown-all-kernels:
+
 You can shut down all kernels and terminals by clicking the ``X``
 button:
 

docs/source/user/terminal.rst

@@ -15,6 +15,8 @@ there.
    :align: center
    :class: jp-screenshot
 
+.. _open-terminal:
+
 To open a new terminal, click the ``+`` button in the file browser and
 select the terminal in the new Launcher tab:
 
@@ -24,6 +26,8 @@ select the terminal in the new Launcher tab:
      <iframe src="https://www.youtube-nocookie.com/embed/ynMjz1tiq9o?rel=0&amp;showinfo=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
   </div>
 
+.. _close-terminal:
+
 Closing a terminal tab will leave it running on the server, but you can
 re-open it using the Running tab in the left sidebar: