Install mkdocs plugins

[weaverba137]

In order to deploy desidatadocs at NERSC, we need these mkdocs plugins: mkdocs-material and pymdown-extensions. The current desiconda version, 20240425-2.2.0 has mkdocs but not the plugins.

As a workaround I can use desimodules/23.1, desiconda/20230111-2.1.0, but this should be fixed in future desiconda versions.

[weaverba137]

Here's what would have happened if I installed these plugins in 20240425-2.2.0:

desi@login14[1001]$ conda install --dry-run mkdocs-material pymdown-extensions
Retrieving notices: ...working... done
Channels:
 - defaults
 - conda-forge
Platform: linux-64
Collecting package metadata (repodata.json): done
Solving environment: done

## Package Plan ##

  environment location: /global/common/software/desi/perlmutter/desiconda/20240425-2.2.0/conda

  added / updated specs:
    - mkdocs-material
    - pymdown-extensions


The following packages will be downloaded:

    package                    |            build
    ---------------------------|-----------------
    ca-certificates-2024.7.2   |       h06a4308_0         127 KB
    certifi-2024.7.4           |  py310h06a4308_0         158 KB
    conda-24.7.1               |  py310h06a4308_0         965 KB
    cssselect-1.2.0            |  py310h06a4308_0          37 KB
    frozendict-2.4.2           |  py310h5eee18b_0          55 KB
    libxslt-1.1.39             |       h76b75d6_0         248 KB  conda-forge
    lxml-5.2.2                 |  py310h6a33d3d_0         1.3 MB  conda-forge
    markdown2-2.5.0            |     pyhd8ed1ab_0          47 KB  conda-forge
    mkdocs-material-9.3.1      |     pyhd8ed1ab_0         4.5 MB  conda-forge
    mkdocs-material-extensions-1.3.1|     pyhd8ed1ab_0          16 KB  conda-forge
    paginate-0.5.6             |     pyhd8ed1ab_0          18 KB  conda-forge
    pymdown-extensions-9.11    |  py310h06a4308_0         416 KB
    pyquery-1.4.3              |  py310h06a4308_0          41 KB
    readtime-3.0.0             |     pyhd8ed1ab_0          12 KB  conda-forge
    regex-2024.7.24            |  py310h5eee18b_0         372 KB
    ------------------------------------------------------------
                                           Total:         8.2 MB

The following NEW packages will be INSTALLED:

  cssselect          pkgs/main/linux-64::cssselect-1.2.0-py310h06a4308_0 
  frozendict         pkgs/main/linux-64::frozendict-2.4.2-py310h5eee18b_0 
  libxslt            conda-forge/linux-64::libxslt-1.1.39-h76b75d6_0 
  lxml               conda-forge/linux-64::lxml-5.2.2-py310h6a33d3d_0 
  markdown2          conda-forge/noarch::markdown2-2.5.0-pyhd8ed1ab_0 
  mkdocs-material    conda-forge/noarch::mkdocs-material-9.3.1-pyhd8ed1ab_0 
  mkdocs-material-e~ conda-forge/noarch::mkdocs-material-extensions-1.3.1-pyhd8ed1ab_0 
  paginate           conda-forge/noarch::paginate-0.5.6-pyhd8ed1ab_0 
  pymdown-extensions pkgs/main/linux-64::pymdown-extensions-9.11-py310h06a4308_0 
  pyquery            pkgs/main/linux-64::pyquery-1.4.3-py310h06a4308_0 
  readtime           conda-forge/noarch::readtime-3.0.0-pyhd8ed1ab_0 
  regex              pkgs/main/linux-64::regex-2024.7.24-py310h5eee18b_0 

The following packages will be UPDATED:

  ca-certificates                      2024.3.11-h06a4308_0 --> 2024.7.2-h06a4308_0 
  certifi                          2024.2.2-py310h06a4308_0 --> 2024.7.4-py310h06a4308_0 
  conda                              24.4.0-py310h06a4308_0 --> 24.7.1-py310h06a4308_0 

If this looks OK, I can go ahead and do it.

Tagging @sbailey @tskisner @akremin.

[sbailey]

Those updates look fine to apply to 20240425-2.2.0 since they are non-algorithmic updates, and the only changed packages are ca-certificates, certifi, and conda.

I suggest that you wait to apply them to 20240425-2.2.0 until you have a matching PR for desiconda for them to be automatically installed in the future. IIRC we also post-facto installed these to the previous desiconda installation, and then didn't get around to updating desiconda itself to avoid this problem in the future, leading to this issue cropping up again.

[weaverba137]

Agreed, will do.

[weaverba137]

PR #73 now exists, so I'm going to go ahead and apply the changes to desiconda/20240425-2.2.0.