Bob’s notes

How to add Jupyter notebooks to Sphinx

  1. Add ipykernal and nbsphinx and remove m2r under requirements.docs.txt .

  2. Add nbsphinx_allow_errors = True in conf.py.

  3. Cross check with bobleesj.utils (http://github.com/bobleesj/bobleesj.utils).

How to setup SSH for GitHub

  1. In your terminal, run the following commands to generate a new SSH key pair. Replace <email@example.com> with your email address.

    cd ~/.ssh
ssh-keygen -o -t rsa -C "<email@example.com>"
cat id_rsa.pub

  2. Visit https://github.com/settings/keys.

  3. Click New SSH key.

  4. Set the Title as <your-computer-name>-key.

  5. Under Key, copy and paste content of the id_rsa.pub file and paste it into the “Key” field. It should start with ssh-rsa and end with your email address.

  6. Click Add SSH key.

  7. Done!

Ref: https://www.theserverside.com/blog/Coffee-Talk-Java-News-Stories-and-Opinions/GitHub-SSH-Key-Setup-Config-Ubuntu-Linux

How to install mamba

This tutorial is for macOS. For other platforms, please refer to the official documentation at https://github.com/conda-forge/miniforge.

  1. Remove existing miniconda3 and miniforge3 directories if they exist:

    rm -rf /Users/<macbook-username>/miniconda3
rm -rf /Users/<macbook-username>/miniforge3

    Replace <macbook-username> with your actual username. You can see it after typing pwd in your terminal.

  2. Install mamba using the following commands:

    $ curl -L -O "[https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-$(uname)-$](https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-$(uname)-$)(uname -m).sh"

  3. Make the script executable:

    $ bash Miniforge3-$(uname)-$(uname -m).sh
$ mamba shell init

  4. Restart your terminal and type the following command to verify the installation:

    $ mamba --version