[ 
https://issues.apache.org/jira/browse/SOLR-10883?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16047923#comment-16047923
 ] 

Steve Rowe edited comment on SOLR-10883 at 6/13/17 1:50 PM:
------------------------------------------------------------

Patch, backslash escapes {{=>}}, {{<=}}, {{\->}} and {{<\-}}.  (Even though 
{{\->}} renders properly in the PDF, I think it's better to be consistent.)

I found that some of the other substitutions (for {{...}}, {{--}}, {{'}}) 
looked fine in the PDF, and the others weren't present outside of code blocks: 
{{(C)}}, {{(R)}}, {{(TM)}}.

I went the individual escaping route after determining that there is no way to 
globally turn off this kind of substitution - there is an open feature request 
for this: [https://github.com/asciidoctor/asciidoctor/issues/1061].


was (Author: steve_rowe):
Patch, backslash escapes {{=>}}, {{<=}}, {{->}} and {{<-}}.  (Even though 
{{->}} renders properly in the PDF, I think it's better to be consistent.)

I found that some of the other substitutions (for {{...}}, {{--}}, {{'}}) 
looked fine in the PDF, and the others weren't present outside of code blocks: 
{{(C)}}, {{(R)}}, {{(TM)}}.

I went the individual escaping route after determining that there is no way to 
globally turn off this kind of substitution - there is an open feature request 
for this: [https://github.com/asciidoctor/asciidoctor/issues/1061].

> Ref guide: some replacement substitutions, e.g. => to right arrow, are 
> rendered invisibly in the PDF 
> -----------------------------------------------------------------------------------------------------
>
>                 Key: SOLR-10883
>                 URL: https://issues.apache.org/jira/browse/SOLR-10883
>             Project: Solr
>          Issue Type: Bug
>      Security Level: Public(Default Security Level. Issues are Public) 
>          Components: documentation
>            Reporter: Steve Rowe
>            Assignee: Steve Rowe
>         Attachments: Screen Shot 2017-06-12 at 7.23.07 PM.png, 
> SOLR-10883.patch
>
>
> {{=>}}, {{<=}}, and {{<-}} are rendered as invisible in the PDF.  These 
> “replacement substitutions” aka “textual symbol replacements” ( 
> http://asciidoctor.org/docs/asciidoc-writers-guide/#replacements ) render as 
> invisible characters in the PDF, though they are visible in the HTML format, 
> when substitution is in effect.
> This is only a problem outside of code blocks (e.g. {{-->}} close comment 
> syntax in XML is never improperly substituted).
> In the screenshot below, a table from the 
> CharFilterFactories|solr.MappingCharFilterFactory section is shown in the 
> HTML format on the left, and in PDF format to the right; in the PDF format 
> the {{=>}} is invisible.
> !Screen Shot 2017-06-12 at 7.23.07 PM.png|width=800!



--
This message was sent by Atlassian JIRA
(v6.4.14#64029)

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@lucene.apache.org
For additional commands, e-mail: dev-h...@lucene.apache.org

Reply via email to