Docs: Updated sphinx & links clean up

[denisSurkov]

Description

Solves #231

I've updated sphinx & sphinx theme. I could not see much difference, but keeping deps up-to-date is always good.

Added 'sphinx.ext.autosectionlabel'. This extension allows to make links like <document-name:title inside document>. I think it's easer to maintain links with this notation. If you don't think so, I could revert custom anchors back.

How to build docs:

cd docs/
pip install -r requirements.txt
make html

[denisSurkov]

@Andrew-Chen-Wang , hi!

Can you help with review, please?

[Andrew-Chen-Wang]

reverting the anchors would be great. I think it's a neat add on but not for me. thanks!

[coveralls]

Pull Request Test Coverage Report for Build 5600566202

• 0 of 0 changed or added relevant lines in 0 files are covered.
• No unchanged relevant lines lost coverage.
• Overall coverage increased (+0.05%) to 98.197%

---

Totals
Change from base Build 5515505785:	0.05%
Covered Lines:	708
Relevant Lines:	721

---

💛 - Coveralls

[denisSurkov]

reverting the anchors would be great.

I've reverted manual anchors back.

[denisSurkov]

@Andrew-Chen-Wang , can you help with review?

[denisSurkov]

@Andrew-Chen-Wang, sorry for being annoying, but I think this is very small fix, but helpful one.

[Andrew-Chen-Wang]

sorry @denisSurkov but thanks for the reminder it lgtm!

[denisSurkov]

@Andrew-Chen-Wang , nothing has changed at https://django-cachalot.readthedocs.io/en/latest/introduction.html.

Do you need to call some commands to refresh render?

[Andrew-Chen-Wang]

rtd hook might be failing will take a look

[denisSurkov]

@Andrew-Chen-Wang , kindly reminder to check read-the-docs webhook.

I don't know, but this might be helpful: https://docs.readthedocs.io/en/stable/guides/setup/git-repo-manual.html

[Andrew-Chen-Wang]

Thank you for the reminder.

It turns out a configuration file is now required. I have now added it to master.