new: moving-pictures redux (usage api) (#524)

.github/workflows/ci.yml

@@ -13,10 +13,10 @@ jobs:
     - name: checkout source
       uses: actions/checkout@v2
 
-    - name: set up python 3.6
+    - name: set up python 3.8
       uses: actions/setup-python@v1
       with:
-        python-version: 3.6
+        python-version: 3.8
 
     - name: install dependencies
       run: python -m pip install --upgrade pip
@@ -34,7 +34,7 @@ jobs:
 
     - name: install QIIME 2 core distro
       run: |
-        envFile=qiime2-latest-py36-linux-conda.yml
+        envFile=qiime2-latest-py38-linux-conda.yml
         wget https://raw.githubusercontent.com/qiime2/environment-files/master/latest/staging/$envFile
         conda env create -q -p ./test-env --file $envFile
 

source/_static/clipboard-driver.js

@@ -1,5 +1,5 @@
 // Grab all elements with highlight-shell class - these will contain all shell commands
-var highlightShellElements = document.getElementsByClassName("highlight-shell");
+var highlightShellElements = document.querySelectorAll(".highlight-shell, .cli-usage, .artifact-usage");
 
 // Loop through elements with highlight-shell class and add clipboard button to each block
 for (x = 0; x < highlightShellElements.length; x++)

source/conf.py

@@ -24,6 +24,7 @@
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
 #
+import os
 import sys
 import pathlib
 
@@ -68,6 +69,7 @@ def setup(app):
     'q2doc.checkpoint',
     'q2doc.command_block',
     'q2doc.external_links',
+    'q2doc.usage',
 ]
 
 
@@ -403,3 +405,5 @@ def setup(app):
 # -- Options for mathjax --------------------------------------------------
 mathjax_path = ('https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/'
                 'MathJax.js?config=TeX-AMS-MML_HTMLorMML')
+
+html_baseurl = os.environ.get('BASE_URL', 'https://docs.qiime2.org/2021.11/')

source/theme/static/style.css

@@ -169,6 +169,14 @@ table.citation td.label {
   position: relative;
 }
 
+.cli-usage {
+  position: relative;
+}
+
+.artifact-usage {
+  position: relative;
+}
+
 .clipboard-btn {
   position: absolute;
   top: 0px;

source/tutorials/index.rst

@@ -9,6 +9,7 @@ Tutorials
    overview
    qiime2-for-experienced-microbiome-researchers
    moving-pictures
+   moving-pictures-usage
    fmt
    atacama-soils
    pd-mice