How to add nbsphinx thumbnails to our talktorial gallery?

[dominiquesydow]

Procedure

Procedure for adding nbsphix thumbnails to the gallery.
To fix an image as a thumbnail, there are two options. The image can either be taken from a cell output from your notebook or you can specify an image file as thumbnail.

Use Jupyter cell output as thumbnail

• Open talktorial with JupyterLab
• Open "Property inspector" menu on the right site of the browser
  
• Go to the cell with the output that shall be used as thumbnail and tag the cell as shown in the image above; you may need to type "nbshpinx-thumbnail" to the "Add tag" window by hand.
• Note: If you inspect the plain text of a tagged notebook, the metadata tag you will find is:

   "metadata": {
    "tags": [
     "nbsphinx-thumbnail"
    ]
   },
  

Use image file as thumbnail

• Copy thumbnail image to docs/_static/images/thumbnails/
• Rename file into T0xx.png (with the talktorial number)
• Open docs/conf.py file
• The path for the thumbnail is defined in nbsphinx_thumbnails, add a new talktorial thumbnail like this: 'talktorials/T0xx_name_of_talktorial': '_static/images/thumbnails/T0xx.png',
• Note: If you want to check how your thumbnail looks on the website, you can build the website locally (see How to add a new talktorial based on our template? #186 for instructions)

Resources

• Sphinx Gallery: https://sphinx-gallery.github.io/stable/index.html
• NBSphinx: https://nbsphinx.readthedocs.io/en/0.8.7/
• Both together: https://nbsphinx.readthedocs.io/en/0.8.7/subdir/gallery.html