[
https://issues.apache.org/jira/browse/SOLR-15092?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17278202#comment-17278202
]
ASF subversion and git services commented on SOLR-15092:
--------------------------------------------------------
Commit 8a0c1f5a0ebb9f1e0bd1bed77a9ca72e0af50645 in lucene-solr's branch
refs/heads/master from Chris M. Hostetter
[ https://gitbox.apache.org/repos/asf?p=lucene-solr.git;h=8a0c1f5 ]
SOLR-15092: eliminate overly strict rules against empty link anchors in
ref-guide
legacy enforcement from the days of building a PDF
> 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
> 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: [email protected]
For additional commands, e-mail: [email protected]