>Alternatively... how would you feel about teaching xref's in general to omit the link and only do text resolution if the ref starts with '!'?
Basically, I'd not like to add new notation for Sphinx. I believe it brings complexity to Sphinx. We already have extension points like roles and directives. So we should consider to use them first. BTW, sphinx-core becomes very large not to able to be maintained at present. TBH there are many bugs, not implemented features and experimental implementations. For example, we does not support officially even HTML5. autodoc also does not support new py3 syntax well (like async). So, to add a new feature, I'd like to know how the feature is important and why it is needed for sphinx-core (not extensions). 2018-01-19 1:22 GMT+09:00 Matthew Woehlke <[email protected]>: > On 2018-01-17 21:22, Komiya Takeshi wrote: >> My large concern is the feature is commonly used or not. >> I doubt non hyperlinked reference is common. >> >> So I'd not like to implement it to sphinx-core even if it is very small code. >> We'd like to keep sphinx-core simple and small. > > ...then I guess I will have to use a fork indefinitely :'(, because > AFAICT the cost to implement this as an extension is exorbitant. > > Alternatively... how would you feel about teaching xref's in general to > omit the link and only do text resolution if the ref starts with '!'? > (It also occurs to me that the solution to > https://github.com/sphinx-doc/sphinx/issues/4448 might be conducive to > this... You say that "hyperlinked reference is [not] common", but > actually this is exactly what #4448 needs. Though in that case, of > course, this is not under the user's control.) > > -- > Matthew > > -- > You received this message because you are subscribed to the Google Groups > "sphinx-users" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to [email protected]. > To post to this group, send email to [email protected]. > Visit this group at https://groups.google.com/group/sphinx-users. > For more options, visit https://groups.google.com/d/optout. -- You received this message because you are subscribed to the Google Groups "sphinx-users" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at https://groups.google.com/group/sphinx-users. For more options, visit https://groups.google.com/d/optout.
