<html><head><meta http-equiv="Content-Type" content="text/html; charset=us-ascii"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class=""><div class=""><br class=""></div><div class="">  To me, one of the best arguments to move to Sphinx was so that manual pages could have links directly into locations in the Users manual. Not possible in practice with a .pdf users manual.</div><div class=""><br class=""></div><div class="">  With the manual in .rst and manual pages generated into .md this still appear to be impossible.</div><div class="">    1) when Sphinx is processing .md pages it appears to not know about labels defined in .rst files so  [matrix layout](sec_mat_something) doesn't work</div><div class="">    2) Raw, cruder things like [matrix layout](../../manual/mat.html#matrix-and-vector-layouts-and-storage-locations) don't work because it doesn't realize what is inside is a raw URL. I am guessing it needs the http:// at the beginning to realize it is a HTPP url and not a markdown thing.</div><div class="">    3) [matrix layout](<a href="https://petsc.org/main/docs/manual/mat/#matrix-and-vector-layouts-and-storage-locations" class="">https://petsc.org/main/docs/manual/mat/#matrix-and-vector-layouts-and-storage-locations</a>) works </div><div class=""><ul class="MailOutline"><li class="">but hardwiring it this way is horrible. Could be release, could be (would be most of the time) a strange URL when running inside the CI. Is there a way to start with https::// but be a relative link?</li><li class="">figuring the anchor that Sphinx creates from a label (#matrix-and-vector-layouts-and-storage-locations) is super cumbersome.  </li></ul></div><div class=""><br class=""></div><div class="">  Is the only good solution to somehow generate .rst files with sowing? How come that wasn't done initially and instead .md files were generated? It seems insanely bad to have this mixture of .md and .rst for a website.</div><div class=""><br class=""></div><div class="">  This is frustrating, to be sold on a technology  (Sphinx) for a particular goal when that technology cannot even satisfy that goal. (Yes the web pages look much nicer, but aside from the search, the functionality of the website is no better than before!).</div><div class=""><br class=""></div><div class=""><br class=""></div><div class="">  Barry</div><div class=""><br class=""></div></body></html>