Inconsistencies between readthedocs and circleci docs

[choldgraf]

There are some inconsistencies between RTD and Circle builds. For example:

• RTD: https://myst-parser.readthedocs.io/en/latest/using/syntax.html#nesting-directives
• CircleCI: https://125-240151150-gh.circle-artifacts.com/0/html/using/syntax.html#nesting-directives

In particular, note blocks are classed differently. The RTD docs class things as admonition while the CircleCI docs class things as alert

I think this is related to the pydata bootstrap theme re-classing (https://github.com/pandas-dev/pydata-bootstrap-sphinx-theme/blob/master/pandas_sphinx_theme/bootstrap_html_translator.py#L44). This is code that replaces common Sphinx classes with the respective bootstrap classes so that the CSS shows up.

For some reason, this replacement happens in CircleCI, but not in readthedocs...

[choldgraf]

also opened up pydata/pydata-sphinx-theme#94 to track this

[choldgraf]

ah this might be our problem: pydata/pydata-sphinx-theme#94 (comment)

opened up readthedocs/readthedocs.org#6690 to discuss

[choldgraf]

I believe that pydata/pydata-sphinx-theme#95 will fix our problem, let's find out once it's merged

[chrisjsewell]

I believe that pandas-dev/pydata-bootstrap-sphinx-theme#95 will fix our problem, let's find out once it's merged

Yep that did it 😄