# ```
#
# For this to work reliably, you should obey the following guidelines:
#
# * The `class` attribute has to be either `"alert alert-info"` or `"alert alert-warning"`, other values will not be converted correctly.
# * No further attributes are allowed.
# * For compatibility with CommonMark, you should add an empty line between the `
` start tag and the beginning of the content.
#
#
#
# Warning
#
# While this works nicely with `nbsphinx`, JupyterLab and the Classic Jupyter Notebook,
# This doesn't work correctly in `nbconvert`
# and by extension on https://nbviewer.jupyter.org/ and Github's notebook preview.
#
# See https://github.com/jupyter/nbconvert/issues/1125.
#
#
#
#
#
# Note
#
# The text can contain further Markdown formatting.
# It is even possible to have nested boxes:
#
#
#
# ... but please don't *overuse* this!
#
#
#
# ## Links to Other Notebooks
#
# Relative links to local notebooks can be used:
# [a link to a notebook in a subdirectory](subdir/a-notebook-in-a-subdir.ipynb),
# [a link to an orphan notebook](orphan.ipynb)
# (latter won't work in LaTeX output, because orphan pages are not included there).
#
# This is how a link is created in Markdown:
#
# ```
# [a link to a notebook in a subdirectory](subdir/a-notebook-in-a-subdir.ipynb)
# ```
#
# Markdown also supports *reference-style* links:
# [a reference-style link][mylink],
# [another version of the same link][mylink].
#
# [mylink]: subdir/a-notebook-in-a-subdir.ipynb
#
# These can be created with this syntax:
#
# ```
# [a reference-style link][mylink]
#
# [mylink]: subdir/a-notebook-in-a-subdir.ipynb
# ```
#
# Links to sub-sections are also possible, e.g.
# [this subsection](subdir/a-notebook-in-a-subdir.ipynb#A-Sub-Section).
#
# This link was created with:
#
# ```
# [this subsection](subdir/a-notebook-in-a-subdir.ipynb#A-Sub-Section)
# ```
#
# You just have to remember to replace spaces with hyphens!
#
# And if there are double quotes in the section title,
# you'll have to replace them with `%22`,
# like e.g. `#That's-a-%22Strange%22-Section` in this link:
# [a section with "strange" characters](subdir/a-notebook-in-a-subdir.ipynb#That's-a-%22Strange%22-Section).
#
# BTW, links to sections of the current notebook work, too, e.g.
# [beginning of this section](#Links-to-Other-Notebooks).
#
# This can be done, as expected, like this:
#
# ```
# [beginning of this section](#Links-to-Other-Notebooks)
# ```
#
# It's also possible to create a
# [link to the beginning of the current page](#),
# by simply using a `#` character:
#
# ```
# [link to the beginning of the current page](#)
# ```
# ## Links to `*.rst` Files (and Other Sphinx Source Files)
#
# Links to files whose extension is in the configuration value [source_suffix](https://www.sphinx-doc.org/en/master/config.html#confval-source_suffix), will be converted to links to the generated HTML/LaTeX pages. Example: [A reStructuredText file](a-normal-rst-file.rst).
#
# This was created with:
#
# ```
# [A reStructuredText file](a-normal-rst-file.rst)
# ```
#
# Links to sub-sections are also possible. Example: [Sphinx Directives](a-normal-rst-file.rst#sphinx-directives-for-info-warning-boxes).
#
# This was created with:
#
# ```
# [Sphinx Directives](a-normal-rst-file.rst#sphinx-directives-for-info-warning-boxes)
# ```
#
#
#
# Note
#
# Sphinx section anchors are different from Jupyter section anchors!
# To create a link to a subsection in an `.rst` file (or another non-notebook source file), you not only have to replace spaces with hyphens, but also slashes and some other characters.
# In case of doubt, just check the target HTML page generated by Sphinx.
#
#
# ## Links to Local Files
#
# Links to local files (other than Jupyter notebooks and other Sphinx source files) are also possible, e.g. [requirements.txt](requirements.txt).
#
# This was simply created with:
#
# ```
# [requirements.txt](requirements.txt)
# ```
#
# The linked files are automatically copied to the HTML output directory.
# For LaTeX output, links are created,
# but the files are not copied to the target directory.
# ## Links to Domain Objects
#
# Links to [Sphinx domain objects](https://www.sphinx-doc.org/en/master/usage/restructuredtext/domains.html) (such as a Python class or JavaScript function) are also possible. For example:
# [example_python_function()](a-normal-rst-file.rst#example_python_function).
#
# This was created with:
#
# ```
# [example_python_function()](a-normal-rst-file.rst#example_python_function)
# ```
#
# This is especially useful for use with the Sphinx [autodoc](https://www.sphinx-doc.org/en/master/ext/autodoc.html) extension!
#
# In some situations, you might prefer to have the default Sphinx formatting and checking in place when linking to domain objects.
# In such a case,
# [raw cells in "reST" format](raw-cells.ipynb#reST)
# could be an alternative worthwhile considering.
# They allow one to use any kind of Sphinx roles and directives inside a Jupyter Notebook.