Skip to content

Commit

Permalink
changing the palcement
Browse files Browse the repository at this point in the history
  • Loading branch information
jedi-force committed Oct 31, 2024
1 parent efdc002 commit 9d9366e
Show file tree
Hide file tree
Showing 377 changed files with 216 additions and 25,390 deletions.
Binary file added _build/.doctrees/CONDUCT.doctree
Binary file not shown.
Binary file added _build/.doctrees/CONTRIBUTING.doctree
Binary file not shown.
Binary file added _build/.doctrees/README.doctree
Binary file not shown.
Binary file modified _build/.doctrees/environment.pickle
Binary file not shown.
Binary file not shown.
Binary file not shown.
2 changes: 1 addition & 1 deletion _build/html/.buildinfo
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 snap_manual/_build/html/markdown.html → _build/html/CONDUCT.html

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
Expand Up @@ -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 &#8212; Snap! Manual</title>
<title>Contributing &#8212; My sample book</title>



Expand All @@ -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" />

Expand All @@ -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="" />
Expand Down Expand Up @@ -115,6 +115,8 @@





<dialog id="pst-primary-sidebar-modal"></dialog>
<div id="pst-primary-sidebar" class="bd-sidebar-primary bd-sidebar">

Expand Down Expand Up @@ -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>
Expand All @@ -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>
Expand Down Expand Up @@ -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"
Expand Down Expand Up @@ -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"
Expand Down Expand Up @@ -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">
Expand All @@ -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>
Expand All @@ -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>

Expand Down Expand Up @@ -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>

Expand All @@ -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>

Expand All @@ -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>
Expand All @@ -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>
Expand Down
Loading

0 comments on commit 9d9366e

Please sign in to comment.