Multiple `WARNING: Could not lex literal_block` on new fork

[bjshively]

I forked with the intention of making a few contributions and encountered a number of warnings when running make html on a clean master. I was able to resolve one of the issues by installing graphviz. However, the following warnings persist:

/Users/bjs/code/curriculum/databases_101.rst:429: WARNING: Could not lex literal_block as "sql". Highlighting skipped.
/Users/bjs/code/curriculum/logs_101.rst:20: WARNING: Could not lex literal_block as "bash". Highlighting skipped.
/Users/bjs/code/curriculum/logs_101.rst:32: WARNING: Could not lex literal_block as "bash". Highlighting skipped.
/Users/bjs/code/curriculum/sysadmin_tools.rst:442: WARNING: Could not lex literal_block as "ini". Highlighting skipped.

Some googling suggests this is related to improper characters in blocks, but I haven't made any changes. Just want to ensure any subsequent PRs aren't impeded by this, or perhaps something is wrong with my local setup.

Thanks!

[miketheman]

Thanks for reporting - I'm curious to know what versions are installed that produce this error. Can you provide a pip list output from your working directory? Did you install the dependencies with pip install -r requirements.txt or another method?

[bjshively]

I followed the easy_install Sphinx sphinx_rtd_theme method in the readme. It's entirely possible my local setup is the issue, as I've never worked with Sphinx before and to be honest I'm not a pip/python package expert.

pip list output:

anaconda-client (1.6.0)
anaconda-navigator (1.5)
anaconda-project (0.4.1)
appnope (0.1.0)
appscript (1.0.1)
argcomplete (1.0.0)
astroid (1.4.9)
astropy (1.3)
Babel (2.3.4)
backports-abc (0.5)
backports.shutil-get-terminal-size (1.0.0)
backports.ssl-match-hostname (3.4.0.2)
beautifulsoup4 (4.5.3)
bitarray (0.8.1)
blaze (0.10.1)
bokeh (0.12.4)
boto (2.45.0)
Bottleneck (1.2.0)
cdecimal (2.3)
cffi (1.9.1)
chardet (2.3.0)
chest (0.2.3)
click (6.7)
cloudpickle (0.2.2)
clyent (1.2.2)
colorama (0.3.7)
conda (4.3.14)
configobj (5.0.6)
configparser (3.5.0)
contextlib2 (0.5.4)
cryptography (1.7.1)
cycler (0.10.0)
Cython (0.25.2)
cytoolz (0.8.2)
dask (0.13.0)
datashape (0.5.4)
decorator (4.0.11)
dill (0.2.5)
docutils (0.13.1)
enum34 (1.1.6)
et-xmlfile (1.0.1)
fastcache (1.0.2)
Flask (0.12)
Flask-Cors (3.0.2)
funcsigs (1.0.2)
functools32 (3.2.3.post2)
futures (3.0.5)
gevent (1.2.1)
graphviz (0.10.1)
greenlet (0.4.11)
grin (1.2.1)
h5py (2.6.0)
HeapDict (1.0.0)
idna (2.2)
imagesize (0.7.1)
ipaddress (1.0.18)
ipykernel (4.5.2)
ipython (5.1.0)
ipython-genutils (0.1.0)
ipywidgets (5.2.2)
isort (4.2.5)
itsdangerous (0.24)
jdcal (1.3)
jedi (0.9.0)
Jinja2 (2.9.4)
jsonschema (2.5.1)
jupyter (1.0.0)
jupyter-client (4.4.0)
jupyter-console (5.0.0)
jupyter-core (4.2.1)
kazoo (2.3.1)
lazy-object-proxy (1.2.2)
llvmlite (0.15.0)
locket (0.2.0)
lxml (3.7.2)
MarkupSafe (0.23)
matplotlib (2.0.0)
mistune (0.7.3)
mpmath (0.19)
multipledispatch (0.4.9)
nbconvert (4.2.0)
nbformat (4.2.0)
networkx (1.11)
nltk (3.2.2)
nose (1.3.7)
notebook (4.3.1)
numba (0.30.1+0.g8c1033f.dirty)
numexpr (2.6.1)
numpy (1.11.3)
numpydoc (0.6.0)
odo (0.5.0)
opencv (0.2.0)
openpyxl (2.4.1)
pandas (0.19.2)
partd (0.3.7)
pathlib2 (2.2.0)
patsy (0.4.1)
pep8 (1.7.0)
pexpect (4.2.1)
pickleshare (0.7.4)
Pillow (4.0.0)
pip (9.0.1)
ply (3.9)
prompt-toolkit (1.0.9)
psutil (5.0.1)
ptyprocess (0.5.1)
py (1.4.32)
pyasn1 (0.1.9)
PyAudio (0.2.7)
pycosat (0.6.1)
pycparser (2.17)
pycrypto (2.6.1)
pycurl (7.43.0)
pyflakes (1.5.0)
Pygments (2.1.3)
pylint (1.6.4)
pyOpenSSL (16.2.0)
pyparsing (2.1.4)
pytest (3.0.5)
python-dateutil (2.6.0)
pytz (2016.10)
PyYAML (3.12)
pyzmq (16.0.2)
QtAwesome (0.4.3)
qtconsole (4.2.1)
QtPy (1.2.1)
redis (2.10.5)
requests (2.12.4)
rope (0.9.4)
scandir (1.4)
scikit-image (0.12.3)
scikit-learn (0.18.1)
scipy (0.18.1)
seaborn (0.7.1)
setuptools (27.2.0)
simplegeneric (0.8.1)
singledispatch (3.4.0.3)
six (1.10.0)
snowballstemmer (1.2.1)
sockjs-tornado (1.0.3)
Sphinx (1.5.1)
sphinx-rtd-theme (0.4.2)
spyder (3.1.2)
SQLAlchemy (1.1.5)
statsmodels (0.6.1)
subprocess32 (3.2.7)
sympy (1.0)
tables (3.3.0)
terminado (0.6)
toolz (0.8.2)
tornado (4.4.2)
traitlets (4.3.1)
unicodecsv (0.14.1)
wcwidth (0.1.7)
Werkzeug (0.11.15)
wheel (0.29.0)
widgetsnbextension (1.2.6)
wrapt (1.10.8)
xlrd (1.0.0)
XlsxWriter (0.9.6)
xlwings (0.10.2)
xlwt (1.2.0)
You are using pip version 9.0.1, however version 18.1 is available.
You should consider upgrading via the 'pip install --upgrade pip' command.

[miketheman]

Thanks!

I think I see the difference - we're not controlling the versions as "tightly" as we should - an oversight from times gone by - generally speaking the pip install -r requirements.txt method produces more repeatable results, since we specify versions there. I'll make a note to update the README as well.

I'm also working on modernizing the requirements and tooling, and was able to reproduce this error message on the latest Sphinx release (1.8.3) thanks for providing this - hope to have some fixes out soon.