[jira] [Created] (SOLR-15092) Loosen Ref Guide link checking to allow empty anchors in links

["Cassandra Targett (Jira)" <ji...@apache.org>]

Cassandra Targett created SOLR-15092:
----------------------------------------

             Summary: Loosen Ref Guide link checking to allow empty anchors in links
                 Key: SOLR-15092
                 URL: https://issues.apache.org/jira/browse/SOLR-15092
             Project: Solr
          Issue Type: Improvement
      Security Level: Public (Default Security Level. Issues are Public)
            Reporter: Cassandra Targett


Back when we were publishing the PDF, we needed to be sure to include an explicit section title as an anchor for all inter-document links (such as {{<<page-title.adoc#page-title,Page Title>>}}) because when the entire guide was assembled into a single file the explicit anchor ensured links went to the right spot in the overall Guide.

Without the PDF, if we want to just link to another page in its entirety and not a sub-section of a page, we can use a shorter syntax with an empty anchor: {{<<page-title.adoc#,Page Title>>}}. I can't find this explicitly documented, but it does construct a correct link (i.e., {{<a href="page-title.html#">Page Title</a>}}).

However, our link checking will fail this structure because it still assumes we must have a section name in the anchor and won't allow blank anchors. This issue is to loosen that check a bit and update the Ref Guide how-to docs to show it as a possible option.



--
This message was sent by Atlassian Jira
(v8.3.4#803005)

---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@lucene.apache.org
For additional commands, e-mail: issues-help@lucene.apache.org