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

["Chris M. Hostetter (Jira)" <ji...@apache.org>]

     [ https://issues.apache.org/jira/browse/SOLR-15092?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Chris M. Hostetter resolved SOLR-15092.
---------------------------------------
    Fix Version/s: 8.9
                   master (9.0)
       Resolution: Fixed

> 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
>            Assignee: Chris M. Hostetter
>            Priority: Major
>             Fix For: master (9.0), 8.9
>
>         Attachments: SOLR-15092.patch
>
>
> 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