Build updates!

[benjaoming]

This update also contains #169

• Update to latest Sphinx w/ docutils 0.17.1
• Update to latest ablog, lxml
• Remove transient dependencies from requirements.txt
• fail on warnings.
• Fix some broken intersphinx refs.
• Apply styles for several elements in docutils 0.17
• Shuffle around some margins, TBC in #191

Before:

After:

[benjaoming]

What this PR mainly changes is margins, but it also re-aligns "Recent posts" with contents below it, which I think is nicer for the eye.

I've opened https://github.com/readthedocs/blog/issues/191 to re-address margins.

[benjaoming]

I went back to very old blog posts and they still look good:

https://readthedocs-blog--188.org.readthedocs.build/new-theme-read-the-docs/ https://readthedocs-blog--188.org.readthedocs.build/read-the-docs-2013-stats/

...however, I found an issue with unorderd lists that are missing bullets. Probably a DOM change.

Adding more styles...

[benjaoming]

These are some good exercises for understanding what effort went into maintaining sphinx-theme-rtd :smiling_face_with_tear:

[benjaoming]

I've been clicking around on a lot of blog posts now and stopped noticing things that look wrong.

So I think we're good to ship this.

It's supporting docutils 0.17 btw.

[agjohnson]

Just noting that we don't plan to continue using our blog here. Our blog will be contained in our website repository, so spending much time here fixing things up is not a priority.

We don't have a timeframe, and need to consider if/how we port content:

https://github.com/readthedocs/site-community/issues/33

[benjaoming]

Ah yes, that's much better than the current blog. I wasn't aware. I'll wrap up the footnotes issue :+1:

Love the issue description over in https://github.com/readthedocs/site-community/issues/33 :heart:

[benjaoming]

Replaced the floating CSS in footnotes with display: table, looks fine in Chrome and Firefox.