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

ASF subversion and git services commented on SOLR-11573:
--------------------------------------------------------

Commit affeec726917dd4b8a93fc0ee57186a6b91cfd3e in lucene-solr's branch 
refs/heads/master from [~ctargett]
[ https://git-wip-us.apache.org/repos/asf?p=lucene-solr.git;h=affeec7 ]

SOLR-11573: Add solr-root-paths param to allow pulling in code blocks from 
outside solr-ref-guide tree


> Add live-preview support for ref-guide files using asciidoc-includes
> --------------------------------------------------------------------
>
>                 Key: SOLR-11573
>                 URL: https://issues.apache.org/jira/browse/SOLR-11573
>             Project: Solr
>          Issue Type: Improvement
>      Security Level: Public(Default Security Level. Issues are Public) 
>          Components: documentation
>    Affects Versions: master (8.0)
>            Reporter: Jason Gerlowski
>            Priority: Trivial
>         Attachments: SOLR-11573.patch
>
>
> With the completion of SOLR-11032, the "Using SolrJ" page in the ref-guide 
> now imports some Java code snippets from an external file.  This is done to 
> allow the snippets appearing in the documentation to be compiled/run as part 
> of the build...so they will always stay up to date.
> During the ref-guide build, this external file is copied into the ref-guide 
> build directory so that the references to it can be resolved.  However, 
> anyone using the "live preview" feature of modern asciidoc editors (Atom, 
> etc.), will find that the snippets don't appear in their live-preview.  
> Depending on your editor, a discrete error message may be displayed.
> It would be nice to fix this "papercut" in usability, or at least provide a 
> workaround.  The easier we can make it to improve the docs, the better.



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

---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to