The RTD CSS uses both the `html` and `p` selectors to define font size.
MkDocs used to use `body` to reduce size, which only applied to anything
else than `p`. This patch restores compatibility with RTD by using html,
not body. Fixes#801.
As of 40dc17e17e, any mention of the `--help` flag had been removed from
the documentation. A breif summary has been added here. However, the output
of `--help` has not been included as that can change in the future and
updating the docs every time a option is updated become unnesecarily
duplicative (as the command line is self-documenting). This fixes#767.
WHen Flake8 is run in Python3, it will fail on "undefined" objects which
are onlu used in if statements that run on Python2. As a workaround,
force tox to use Python2 when running Flake8. This can just be removed
in the future if/when Python2 support is dropped.
The `search.ContentParser` (a HTMLParser subclass) should always be closed
to force parsing of all buffered data. The three low-level tests now close
the parser manually. However, a call to close was also added to the higher
level SearchIndex class.
readthedocs.org needs the file name in order to identify the correct source
file to link to the same file in other versions of the same documentation or
to the source on GitHub.
Related rtfd/readthedocs.org#1480
Also added README.md and CONTRIBUTING.md to the linter.
Note, that I am still getting one failer (in two locations). However
I consider that failer a bug in the linter and have reported it
upstream. We could disable that Rule (MD031), but as we are not
requiring the lint rules to pass presently, I just left it alone.
Also, while the code linter is set to allow lines 119 chars long,
I am using the Markdown linter's default of 80. Prose is easier to
read with shorter line lenghts, so I think it makes more sense to
use the default. Also, changing the default would have required
adding a config file. Adding a Ruby file for only one minor setting
seems silly, so I left it alone.
