generated from just-the-docs/just-the-docs-template
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
efdc002
commit 9d9366e
Showing
377 changed files
with
216 additions
and
25,390 deletions.
There are no files selected for viewing
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file renamed
BIN
+9.68 KB
...uild/.doctrees/markdown-notebooks.doctree → ...upyter_execute/markdown-notebooks.doctree
Binary file not shown.
Binary file renamed
BIN
+10.8 KB
...manual/_build/.doctrees/notebooks.doctree → .../_build/jupyter_execute/notebooks.doctree
Binary file not shown.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,4 +1,4 @@ | ||
# Sphinx build info version 1 | ||
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. | ||
config: b7a9d9e3f34e589cf72d7b96a35ea2df | ||
config: d7ec073edd3d64b3e28f57e3c1798479 | ||
tags: 645f666f9bcd5a90fca523b33c5a78b7 |
156 changes: 66 additions & 90 deletions
156
snap_manual/_build/html/markdown.html → _build/html/CONDUCT.html
Large diffs are not rendered by default.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -8,7 +8,7 @@ | |
<meta charset="utf-8" /> | ||
<meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" /> | ||
|
||
<title>Notebooks with MyST Markdown — Snap! Manual</title> | ||
<title>Contributing — My sample book</title> | ||
|
||
|
||
|
||
|
@@ -34,7 +34,7 @@ | |
<link rel="stylesheet" type="text/css" href="_static/styles/sphinx-book-theme.css?v=a3416100" /> | ||
<link rel="stylesheet" type="text/css" href="_static/togglebutton.css?v=13237357" /> | ||
<link rel="stylesheet" type="text/css" href="_static/copybutton.css?v=76b2166b" /> | ||
<link rel="stylesheet" type="text/css" href="_static/mystnb.4510f1fc1dee50b3e5859aac5469c37c29e427902b24a333a5f9fcb2f0b3ac41.css" /> | ||
<link rel="stylesheet" type="text/css" href="_static/mystnb.4510f1fc1dee50b3e5859aac5469c37c29e427902b24a333a5f9fcb2f0b3ac41.css?v=be8a1c11" /> | ||
<link rel="stylesheet" type="text/css" href="_static/sphinx-thebe.css?v=4fa983c6" /> | ||
<link rel="stylesheet" type="text/css" href="_static/sphinx-design.min.css?v=95c83b7e" /> | ||
|
||
|
@@ -60,10 +60,10 @@ | |
<script async="async" src="_static/sphinx-thebe.js?v=c100c467"></script> | ||
<script>var togglebuttonSelector = '.toggle, .admonition.dropdown';</script> | ||
<script>const THEBE_JS_URL = "https://unpkg.com/[email protected]/lib/index.js"; const thebe_selector = ".thebe,.cell"; const thebe_selector_input = "pre"; const thebe_selector_output = ".output, .cell_output"</script> | ||
<script>DOCUMENTATION_OPTIONS.pagename = 'markdown-notebooks';</script> | ||
<script>DOCUMENTATION_OPTIONS.pagename = 'CONTRIBUTING';</script> | ||
<link rel="canonical" href="/snap-manual/CONTRIBUTING.html" /> | ||
<link rel="index" title="Index" href="genindex.html" /> | ||
<link rel="search" title="Search" href="search.html" /> | ||
<link rel="prev" title="Content with notebooks" href="notebooks.html" /> | ||
<meta name="viewport" content="width=device-width, initial-scale=1"/> | ||
<meta name="docsearch:language" content="en"/> | ||
<meta name="docsearch:version" content="" /> | ||
|
@@ -115,6 +115,8 @@ | |
|
||
|
||
|
||
|
||
|
||
<dialog id="pst-primary-sidebar-modal"></dialog> | ||
<div id="pst-primary-sidebar" class="bd-sidebar-primary bd-sidebar"> | ||
|
||
|
@@ -145,8 +147,8 @@ | |
|
||
|
||
|
||
<img src="_static/logo.png" class="logo__image only-light" alt="Snap! Manual - Home"/> | ||
<img src="_static/logo.png" class="logo__image only-dark pst-js-only" alt="Snap! Manual - Home"/> | ||
<img src="_static/logo.png" class="logo__image only-light" alt="My sample book - Home"/> | ||
<img src="_static/logo.png" class="logo__image only-dark pst-js-only" alt="My sample book - Home"/> | ||
|
||
|
||
</a></div> | ||
|
@@ -167,10 +169,10 @@ | |
</a> | ||
</li> | ||
</ul> | ||
<ul class="current nav bd-sidenav"> | ||
<ul class="nav bd-sidenav"> | ||
<li class="toctree-l1"><a class="reference internal" href="markdown.html">Markdown Files</a></li> | ||
<li class="toctree-l1"><a class="reference internal" href="notebooks.html">Content with notebooks</a></li> | ||
<li class="toctree-l1 current active"><a class="current reference internal" href="#">Notebooks with MyST Markdown</a></li> | ||
<li class="toctree-l1"><a class="reference internal" href="markdown-notebooks.html">Notebooks with MyST Markdown</a></li> | ||
</ul> | ||
|
||
</div> | ||
|
@@ -242,7 +244,7 @@ | |
|
||
|
||
|
||
<li><a href="https://github.com/jedi-force/snap-manual/issues/new?title=Issue%20on%20page%20%2Fmarkdown-notebooks.html&body=Your%20issue%20content%20here." target="_blank" | ||
<li><a href="https://github.com/jedi-force/snap-manual/issues/new?title=Issue%20on%20page%20%2FCONTRIBUTING.html&body=Your%20issue%20content%20here." target="_blank" | ||
class="btn btn-sm btn-source-issues-button dropdown-item" | ||
title="Open an issue" | ||
data-bs-placement="left" data-bs-toggle="tooltip" | ||
|
@@ -272,7 +274,7 @@ | |
|
||
|
||
|
||
<li><a href="_sources/markdown-notebooks.md" target="_blank" | ||
<li><a href="_sources/CONTRIBUTING.md" target="_blank" | ||
class="btn btn-sm btn-download-source-button dropdown-item" | ||
title="Download source file" | ||
data-bs-placement="left" data-bs-toggle="tooltip" | ||
|
@@ -348,7 +350,7 @@ | |
|
||
|
||
<div id="jb-print-docs-body" class="onlyprint"> | ||
<h1>Notebooks with MyST Markdown</h1> | ||
<h1>Contributing</h1> | ||
<!-- Table of contents --> | ||
<div id="print-main-content"> | ||
<div id="jb-print-toc"> | ||
|
@@ -358,9 +360,13 @@ <h2> Contents </h2> | |
</div> | ||
<nav aria-label="Page"> | ||
<ul class="visible nav section-nav flex-column"> | ||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#an-example-cell">An example cell</a></li> | ||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#create-a-notebook-with-myst-markdown">Create a notebook with MyST Markdown</a></li> | ||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#quickly-add-yaml-metadata-for-myst-notebooks">Quickly add YAML metadata for MyST Notebooks</a></li> | ||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#report-bugs">Report Bugs</a></li> | ||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#fix-bugs">Fix Bugs</a></li> | ||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#implement-features">Implement Features</a></li> | ||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#write-documentation">Write Documentation</a></li> | ||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#submit-feedback">Submit Feedback</a></li> | ||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#get-started">Get Started</a></li> | ||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#code-of-conduct">Code of Conduct</a></li> | ||
</ul> | ||
</nav> | ||
</div> | ||
|
@@ -372,50 +378,62 @@ <h2> Contents </h2> | |
<div id="searchbox"></div> | ||
<article class="bd-article"> | ||
|
||
<section class="tex2jax_ignore mathjax_ignore" id="notebooks-with-myst-markdown"> | ||
<h1>Notebooks with MyST Markdown<a class="headerlink" href="#notebooks-with-myst-markdown" title="Link to this heading">#</a></h1> | ||
<p>Jupyter Book also lets you write text-based notebooks using MyST Markdown. | ||
See <a class="reference external" href="https://jupyterbook.org/file-types/myst-notebooks.html">the Notebooks with MyST Markdown documentation</a> for more detailed instructions. | ||
This page shows off a notebook written in MyST Markdown.</p> | ||
<section id="an-example-cell"> | ||
<h2>An example cell<a class="headerlink" href="#an-example-cell" title="Link to this heading">#</a></h2> | ||
<p>With MyST Markdown, you can define code cells with a directive like so:</p> | ||
<div class="cell docutils container"> | ||
<div class="cell_input docutils container"> | ||
<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nb">print</span><span class="p">(</span><span class="mi">2</span> <span class="o">+</span> <span class="mi">2</span><span class="p">)</span> | ||
</pre></div> | ||
</div> | ||
</div> | ||
<div class="cell_output docutils container"> | ||
<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>4 | ||
</pre></div> | ||
</div> | ||
</div> | ||
</div> | ||
<p>When your book is built, the contents of any <code class="docutils literal notranslate"><span class="pre">{code-cell}</span></code> blocks will be | ||
executed with your default Jupyter kernel, and their outputs will be displayed | ||
in-line with the rest of your content.</p> | ||
<div class="admonition seealso"> | ||
<p class="admonition-title">See also</p> | ||
<p>Jupyter Book uses <a class="reference external" href="https://jupytext.readthedocs.io/en/latest/">Jupytext</a> to convert text-based files to notebooks, and can support <a class="reference external" href="https://jupyterbook.org/file-types/jupytext.html">many other text-based notebook files</a>.</p> | ||
</div> | ||
<section class="tex2jax_ignore mathjax_ignore" id="contributing"> | ||
<h1>Contributing<a class="headerlink" href="#contributing" title="Link to this heading">#</a></h1> | ||
<p>Contributions are welcome, and they are greatly appreciated! Every little bit | ||
helps, and credit will always be given. You can contribute in the ways listed below.</p> | ||
<section id="report-bugs"> | ||
<h2>Report Bugs<a class="headerlink" href="#report-bugs" title="Link to this heading">#</a></h2> | ||
<p>Report bugs using GitHub issues.</p> | ||
<p>If you are reporting a bug, please include:</p> | ||
<ul class="simple"> | ||
<li><p>Your operating system name and version.</p></li> | ||
<li><p>Any details about your local setup that might be helpful in troubleshooting.</p></li> | ||
<li><p>Detailed steps to reproduce the bug.</p></li> | ||
</ul> | ||
</section> | ||
<section id="fix-bugs"> | ||
<h2>Fix Bugs<a class="headerlink" href="#fix-bugs" title="Link to this heading">#</a></h2> | ||
<p>Look through the GitHub issues for bugs. Anything tagged with “bug” and “help | ||
wanted” is open to whoever wants to implement it.</p> | ||
</section> | ||
<section id="implement-features"> | ||
<h2>Implement Features<a class="headerlink" href="#implement-features" title="Link to this heading">#</a></h2> | ||
<p>Look through the GitHub issues for features. Anything tagged with “enhancement” | ||
and “help wanted” is open to whoever wants to implement it.</p> | ||
</section> | ||
<section id="write-documentation"> | ||
<h2>Write Documentation<a class="headerlink" href="#write-documentation" title="Link to this heading">#</a></h2> | ||
<p>Snap! Manual could always use more documentation, whether as part of the | ||
official Snap! Manual docs, in docstrings, or even on the web in blog posts, | ||
articles, and such.</p> | ||
</section> | ||
<section id="create-a-notebook-with-myst-markdown"> | ||
<h2>Create a notebook with MyST Markdown<a class="headerlink" href="#create-a-notebook-with-myst-markdown" title="Link to this heading">#</a></h2> | ||
<p>MyST Markdown notebooks are defined by two things:</p> | ||
<section id="submit-feedback"> | ||
<h2>Submit Feedback<a class="headerlink" href="#submit-feedback" title="Link to this heading">#</a></h2> | ||
<p>The best way to send feedback is to file an issue on GitHub.</p> | ||
<p>If you are proposing a feature:</p> | ||
<ul class="simple"> | ||
<li><p>Explain in detail how it would work.</p></li> | ||
<li><p>Keep the scope as narrow as possible, to make it easier to implement.</p></li> | ||
<li><p>Remember that this is a volunteer-driven project, and that contributions | ||
are welcome :)</p></li> | ||
</ul> | ||
</section> | ||
<section id="get-started"> | ||
<h2>Get Started<a class="headerlink" href="#get-started" title="Link to this heading">#</a></h2> | ||
<p>Ready to contribute? Here’s how to set up <code class="docutils literal notranslate"><span class="pre">Snap!</span> <span class="pre">Manual</span></code> for local development.</p> | ||
<ol class="arabic simple"> | ||
<li><p>YAML metadata that is needed to understand if / how it should convert text files to notebooks (including information about the kernel needed). | ||
See the YAML at the top of this page for example.</p></li> | ||
<li><p>The presence of <code class="docutils literal notranslate"><span class="pre">{code-cell}</span></code> directives, which will be executed with your book.</p></li> | ||
<li><p>Fork the repo on GitHub.</p></li> | ||
<li><p>Clone your fork locally.</p></li> | ||
<li><p>Install your local copy into a virtualenv, e.g., using <code class="docutils literal notranslate"><span class="pre">conda</span></code>.</p></li> | ||
<li><p>Create a branch for local development and make changes locally.</p></li> | ||
<li><p>Commit your changes and push your branch to GitHub.</p></li> | ||
<li><p>Submit a pull request through the GitHub website.</p></li> | ||
</ol> | ||
<p>That’s all that is needed to get started!</p> | ||
</section> | ||
<section id="quickly-add-yaml-metadata-for-myst-notebooks"> | ||
<h2>Quickly add YAML metadata for MyST Notebooks<a class="headerlink" href="#quickly-add-yaml-metadata-for-myst-notebooks" title="Link to this heading">#</a></h2> | ||
<p>If you have a markdown file and you’d like to quickly add YAML metadata to it, so that Jupyter Book will treat it as a MyST Markdown Notebook, run the following command:</p> | ||
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">jupyter</span><span class="o">-</span><span class="n">book</span> <span class="n">myst</span> <span class="n">init</span> <span class="n">path</span><span class="o">/</span><span class="n">to</span><span class="o">/</span><span class="n">markdownfile</span><span class="o">.</span><span class="n">md</span> | ||
</pre></div> | ||
</div> | ||
<section id="code-of-conduct"> | ||
<h2>Code of Conduct<a class="headerlink" href="#code-of-conduct" title="Link to this heading">#</a></h2> | ||
<p>Please note that the Snap! Manual project is released with a <a class="reference internal" href="CONDUCT.html"><span class="std std-doc">Contributor Code of Conduct</span></a>. By contributing to this project you agree to abide by its terms.</p> | ||
</section> | ||
</section> | ||
|
||
|
@@ -449,15 +467,6 @@ <h2>Quickly add YAML metadata for MyST Notebooks<a class="headerlink" href="#qui | |
<footer class="prev-next-footer d-print-none"> | ||
|
||
<div class="prev-next-area"> | ||
<a class="left-prev" | ||
href="notebooks.html" | ||
title="previous page"> | ||
<i class="fa-solid fa-angle-left"></i> | ||
<div class="prev-next-info"> | ||
<p class="prev-next-subtitle">previous</p> | ||
<p class="prev-next-title">Content with notebooks</p> | ||
</div> | ||
</a> | ||
</div> | ||
</footer> | ||
|
||
|
@@ -475,9 +484,13 @@ <h2>Quickly add YAML metadata for MyST Notebooks<a class="headerlink" href="#qui | |
</div> | ||
<nav class="bd-toc-nav page-toc"> | ||
<ul class="visible nav section-nav flex-column"> | ||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#an-example-cell">An example cell</a></li> | ||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#create-a-notebook-with-myst-markdown">Create a notebook with MyST Markdown</a></li> | ||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#quickly-add-yaml-metadata-for-myst-notebooks">Quickly add YAML metadata for MyST Notebooks</a></li> | ||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#report-bugs">Report Bugs</a></li> | ||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#fix-bugs">Fix Bugs</a></li> | ||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#implement-features">Implement Features</a></li> | ||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#write-documentation">Write Documentation</a></li> | ||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#submit-feedback">Submit Feedback</a></li> | ||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#get-started">Get Started</a></li> | ||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#code-of-conduct">Code of Conduct</a></li> | ||
</ul> | ||
</nav></div> | ||
|
||
|
@@ -492,7 +505,7 @@ <h2>Quickly add YAML metadata for MyST Notebooks<a class="headerlink" href="#qui | |
<div class="footer-item"> | ||
|
||
<p class="component-author"> | ||
By Vic | ||
By The Jupyter Book Community | ||
</p> | ||
|
||
</div> | ||
|
@@ -502,7 +515,7 @@ <h2>Quickly add YAML metadata for MyST Notebooks<a class="headerlink" href="#qui | |
|
||
<p class="copyright"> | ||
|
||
© Copyright 2024. | ||
© Copyright 2023. | ||
<br/> | ||
|
||
</p> | ||
|
Oops, something went wrong.