🧱 Add tutorials from its own repo

Author: shnizzedy

.circleci/config.yml

@@ -1,5 +1,13 @@
 version: 2.1
 commands:
+  get-tutorials:
+    steps:
+      - run:
+          name: 👽️ Getting user tutorials
+          command: |
+            sudo apt-get update
+            sudo apt-get -y install git
+            git clone --depth 1 https://github.com/FCP-INDI/C-PAC_tutorials.git docs/_sources/user/tutorials
   get-version:
     steps:
       - run:
@@ -111,6 +119,7 @@ jobs:
       - install-build-dependencies:
           version: develop
       - run-cpac-commands
+      - get-tutorials
       - run:
           name: 🏗️ Building nightly branch docs
           command: ./bin/build nightly

CONTRIBUTING.md

@@ -9,6 +9,7 @@
     - [Let CircleCI build your drafts / works-in-progress](#let-circleci-build-your-drafts--works-in-progress)
     - [Build locally (C-PAC ≥ v1.8.0)](#build-locally-c-pac-≥-v180)
 - [Flowcharts](#flowcharts)
+- [Tutorials](#tutorials)
 - [References and citations](#references-and-citations)
 - [Environment notes](#environment-notes)
 
@@ -119,6 +120,11 @@ where `{width}` and `{height}` are the values already present in the existing `w
     <object data="../_static/path/to/chart.svg" type="image/svg+xml"></object>
 ```
 
+<a id="markdown-tutorials" name="tutorials"></a>
+## Tutorials
+
+See [FCP-INDI/C-PAC_tutorials/CONTRIBUTING.md](https://github.com/FCP-INDI/C-PAC_tutorials/blob/main/CONTRIBUTING.md) for how to contribute tutorials. Add them to the TOC tree in that repository or in any TOC tree in this repository with a relative path beginning `/user/tutorials/` (e.g., `/user/tutorials/observed_usage` for [`observed_usage.ipynb`](https://github.com/FCP-INDI/C-PAC_tutorials/blob/main/observed_usage.ipynb)).
+
 <a id="markdown-references-and-citations" name="references-and-citations"></a>
 ## References and citations
 

docs/_sources/conf.py

@@ -148,6 +148,7 @@ def yaml_to_rst(path):
     'sphinx.ext.viewcode',
     'sphinxcontrib.programoutput',
     'exec',
+    'nbsphinx',
     'numpydoc']
 
 # Add any paths that contain templates here, relative to this directory.

docs/_sources/user/index.rst

@@ -113,6 +113,7 @@ User Guide Index
    6. All Run Options <running>
    7. Run Group Analysis <group_analysis>
    8. Check Your Outputs <output_dir>
-   9. Troubleshoot <help>
-   10. Release Notes <rnotes>
-   11. Appendix <appendix>
+   9. Tutorials <tutorials/index>
+   10. Troubleshoot <help>
+   11. Release Notes <rnotes>
+   12. Appendix <appendix>

requirements.txt

@@ -1,6 +1,8 @@
+bash_kernel
 docutils<0.18
 m2r
 mistune==0.8.4
+nbsphinx
 numpydoc
 PyGithub
 sphinx