Takeshi KOMIYA
Takeshi KOMIYA
Could you let me know why do you add `:canonical:` options for everything? In my understanding, nobody refers the canonical functions, methods and others. I'd like to know the real...
It comes from the node ID generation rule of docutils; the core library of Sphinx. It was defined to support many kinds of formats. https://repo.or.cz/docutils.git/blob/HEAD:/docutils/docutils/nodes.py#l2220
It's a local ID generator for Sphinx domains. It does not relate to the section IDs.
Sphinx has still supported HTML4 output. The HTML Help builder also depends on HTML4. In addition to this, I can't say the change does not affect other builders. Sphinx is...
I can't promise the option works fine for "all" builders. If I added it to Sphinx, I'll describe it as "it might work. But not promised. Please don't report us...
>I don't know about the details about how Sphinx works internally, but couldn't a custom unicode ID maker be invoked only when the HTML5 builder is in use? It's diffucult....
> But HTML IDs should not be node IDs. Is it possible during initial read to generate IDs in a structure that allows to output a proper HTML5 slug on...
The cross-referencing system of Sphinx has been based on the node IDs. So I can't imagine how we replace it by unicode IDs. I guess we need to rewrite whole...
I don't know how to do that. But all contributions are welcome!
Could you try `napoleon_preprocess_types = True`, please?