Make $ unselectable in docs

[dojutsu-user]

Fixes #4698

[dojutsu-user]

This did fix the issue
but there's another problem
It now doesn't looks good

[dojutsu-user]

Also, this PR fixes this problem
(Link)

(Note that both bullets are same numbered)

Also, there's one line between those two points which is not visible in the current docs (fixed in the PR).

[dojutsu-user]

I don't know if this is a problem with my internet connection or something.
But these images never load (Link)

Can anybody confirm this?

[humitos]

I think that none of the issue that you are mentioning here are from your PR. I see all of them already happen in the current production online docs.

[humitos]

I don't know if this is a problem with my internet connection or something.
But these images never load (Link)

I do see the problem in the current docs. @davidfischer do you know what this can be happening?

[dojutsu-user]

I think that none of the issue that you are mentioning here are from your PR. I see all of them already happen in the current production online docs.

@humitos
I didn't get it.
This problem (comment) gets fixed.
This problem (comment) gets introduced.
And this (comment) is I am asking for the confirmation (not introduced in this PR).

[stsewd]

You need to add prompt to https://github.com/rtfd/readthedocs.org/blob/master/docs/.rstcheck.cfg so tests pass

[codecov]

Codecov Report

Merging #4990 into master will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##           master    #4990   +/-   ##
=======================================
  Coverage   76.76%   76.76%           
=======================================
  Files         158      158           
  Lines        9953     9953           
  Branches     1245     1245           
=======================================
  Hits         7640     7640           
  Misses       1980     1980           
  Partials      333      333

[codecov]

Codecov Report

Merging #4990 into master will increase coverage by 0.1%.
The diff coverage is n/a.

@@            Coverage Diff            @@
##           master    #4990     +/-   ##
=========================================
+ Coverage   76.76%   76.86%   +0.1%     
=========================================
  Files         158      158             
  Lines        9953     9987     +34     
  Branches     1245     1253      +8     
=========================================
+ Hits         7640     7677     +37     
+ Misses       1980     1977      -3     
  Partials      333      333

Impacted Files	Coverage Δ
readthedocs/builds/views.py	90.74% <0%> (-5.26%)	⬇️
readthedocs/doc_builder/constants.py	86.36% <0%> (-1.14%)	⬇️
readthedocs/projects/tasks.py	70.48% <0%> (-0.72%)	⬇️
readthedocs/core/views/__init__.py	70.58% <0%> (-0.43%)	⬇️
readthedocs/projects/views/private.py	79.63% <0%> (-0.42%)	⬇️
readthedocs/doc_builder/environments.py	86.24% <0%> (-0.04%)	⬇️
readthedocs/core/models.py	74.19% <0%> (ø)	⬆️
readthedocs/builds/models.py	78.83% <0%> (ø)	⬆️
readthedocs/projects/constants.py	100% <0%> (ø)	⬆️
readthedocs/doc_builder/backends/sphinx.py	69.8% <0%> (ø)	⬆️
... and 7 more

[dojutsu-user]

@stsewd
Thanks, I was wondering why the tests are failing.

[humitos]

Thanks for continue working on this PR. It looks great!

I noticed just minor changes to be made, and we are ready to merge.

[humitos]

This is perfect but I just realize that CSS does not look great 😞

The first one is how it looks by using :: (Sphinx default) and the second one is how it looks with .. prompt::

I'd like to find a way to make .. prompt:: to look with the same style as the other command (or verbatim text) we have.

[dojutsu-user]

@humitos
I didn't find any useful information about changing the css in the docs for sphinx-prompt.
My suggestion:

1. We can add some extra css to sphinx_rtd_theme, which might not be a good idea if it clashes with some other css class.
2. Don't use sphinx-prompt and find another way to do so.

[humitos]

I didn't find any useful information about changing the css in the docs for sphinx-prompt.

I also took a quick look and didn't find a way to configure it. It may worth to open an issue at sphinx-prompt issue tracker and ask for this. Maybe there is a way to tell it which classes to use.

1. We can add some extra css to sphinx_rtd_theme, which might not be a good idea if it clashes with some other css class.

This is not something that we need at the theme level, but at project level. So, I wouldn't put it in the sphinx_rtd_theme

We may want to add an extra CSS file for our own docs project with the proper CSS classes (probably alias of what we already have).

2. Don't use sphinx-prompt and find another way to do so.

I don't know another thing that works here.

I'm sorry that this PR is taking too long and when I was happy with the code the style of sphinx-prompt disappointed me. I'm not sure what path to follow yet, but I would start opening an issue on them and continue with the idea of adding a custom CSS.

[dojutsu-user]

@humitos

We may want to add an extra CSS file for our own docs project with the proper CSS classes (probably alias of what we already have).

I agree on this. And I have pushed some changes following this idea. It is working as it should be and the code-blocks also looks good.

[humitos]

Nice work @dojutsu-user! This looks great to me!

This is the result that I'm getting locally:

I'd say that we are ready to merge this PR.

[humitos]

Thanks a lot for all of this work! I'm merging.

[ericholscher]

💯 🎉 @dojutsu-user