remember to unpin sphinxcontrib-bibtex

[ianmkenney]

Docs CI have stopped working

  cd docs && sphinx-build -b html source build
  shell: /usr/bin/bash -l {0}
  env:
    INPUT_RUN_POST: true
    CONDA: /usr/share/miniconda3
    CONDA_PKGS_DIR: /home/runner/conda_pkgs_dir
Running Sphinx v6.[2](https://github.com/MDAnalysis/mdaencore/actions/runs/5977998921/job/16219184541#step:5:2).1
making output directory... done
WARNING: The pre-Sphinx 1.0 'intersphinx_mapping' format is deprecated and will be removed in Sphinx 8. Update to the current format as described in the documentation. Hint: "intersphinx_mapping = {'<name>': ('https://docs.python.org/[3](https://github.com/MDAnalysis/mdaencore/actions/runs/5977998921/job/16219184541#step:5:3)/', None)}".https://www.sphinx-doc.org/en/master/usage/extensions/intersphinx.html#confval-intersphinx_mapping
WARNING: The pre-Sphinx 1.0 'intersphinx_mapping' format is deprecated and will be removed in Sphinx 8. Update to the current format as described in the documentation. Hint: "intersphinx_mapping = {'<name>': ('https://docs.mdanalysis.org/stable/', None)}".https://www.sphinx-doc.org/en/master/usage/extensions/intersphinx.html#confval-intersphinx_mapping

Exception occurred:
  File "/usr/share/miniconda3/envs/test/lib/python3.11/site-packages/pkg_resources/__init__.py", line 87[5](https://github.com/MDAnalysis/mdaencore/actions/runs/5977998921/job/16219184541#step:5:5), in _resolve_dist
    raise VersionConflict(dist, req).with_context(dependent_req)
pkg_resources.VersionConflict: (docutils 0.19 (/usr/share/miniconda3/envs/test/lib/python3.11/site-packages), Requirement.parse('docutils!=0.18.*,!=0.19.*,>=0.8'))

[ianmkenney]

It looks like the move from sphinxcontrib-bibtex 2.5.0 to sphinxcontrib-bibtex 2.6.0 broke it. Pinning works locally.

[IAlibay]

Relevant issue here is I think down to: mcmtroffaes/sphinxcontrib-bibtex#322

I'm re-opening this because pinning things is only a temporary solution.

[IAlibay]

This is your problem:

  ├─ mdanalysis-sphinx-theme   is installable and it requires
  │  └─ sphinx >=6.2.1,<7.0 , which requires
  │     └─ docutils >=0.18.1,<0.20  with the potential options

[orbeckst]

I am renaming this issue because docs are building.