Update to Sphinx 7.2.x

[wrobell]

1. Adapt Hylang domain and documenter code to Sphinx 7.2.x.
2. Update dependencies to use Sphinx 7.2.x, and RTD theme for 1.2.x (please note that the latter is used for development only).
3. Use Sphinx logger instead of default Python logger.

The only remaining issues are warning related to parsing of literal blocks, i.e.

hy/docs/api.rst:110: WARNING: Lexing literal_block '(defn name [params] bodyform1 bodyform2…)' as "clojure" resulted in an error at token: '…'. Retrying in relaxed mode.

We use Clojure highlighting for code blocks. I believe we need a new lexer for `clojure-console' (i.e. there is one for Python and Python console). This is out of scope for this pull request, IMHO.

[wrobell]

@scauligi @Kodiologist Can you please give it a try? I believe this is ready. Unfortunately, this does not solve #24.

[Kodiologist]

I still don't have the bandwidth to maintain this repository, sorry.

[Kodiologist]

@wrobell Do you intend to merge this soon? I may be doing some beautification of the Hy manual soon, but I'd probably hold off if you're about to change the expected major Sphinx version, so as not to chase a moving target.

[wrobell]

I can merge but I am not 100% convinced I am not breaking anything. Any chance 2nd pair of eyes could take a look at documentation output generated by this brach?

[Kodiologist]

I could look at what Hy's manual looks like with this, if you think that'll help, but there's already a bunch of stuff that's broken with master of sphinxcontrib-hydomain, so it'll be hard to tell newly broken bits from unchanged bits.

[wrobell]

@Kodiologist I have just fixed this pull request merge conflict due to some changes in master.

Please take a cursory look at the documentation output, and then I will merge.

[Kodiologist]

I built Hy master's manual with Sphinx 7.2.2 and this PR and it looks pretty much the same. Good job. The only difference I notice is that index.rst shows deeper headings than it used to.

[wrobell]

It seems directive like autoclass is treated as a section. I will try to fix it.

[wrobell]

@Kodiologist I hope to look at it this weekend.

[wrobell]

Also broken:

[wrobell]

I am on the verge of giving up here. Too much copy&paste of not well structured code. I will give it a shot tomorrow again though.

[Kodiologist]

I'm sorry, yeah. It's a mess. You might have an easier time starting from scratch.

[wrobell]

@Kodiologist Unfortunately, I am stuck, and I do not have enough energy to dig into this more.

If anyone sees a fix here, please shout.

[Kodiologist]

That's okay. Maybe someone else will pick up maintenance of this project in the future.