[ https://issues.apache.org/jira/browse/SOLR-14829?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17191223#comment-17191223 ]
Johannes Baiter edited comment on SOLR-14829 at 9/6/20, 7:38 AM: ----------------------------------------------------------------- {quote}Is it enough to merely define your search component with the name "highlight" in solrconfig.xml, thus overriding the built-in one? Then you don't even need to make any component changes to your handler definition. {quote} Unfortunately, no. The [custom highlighter|https://dbmdz.github.io/solr-ocrhighlighting/] is supposed to run alongside the regular highlighter, since it only takes care of highlighting a specific subset of fields in the response, all other fields go through the default highlighter. But maybe it would be a good idea to add a warning to the section about defining the {{components}} from scratch that this is a last resort (because of mistakes like mine, and also for future-proofing in case other new default components are added) and the other alternatives should be preferred? was (Author: jbaiter): {quote} Is it enough to merely define your search component with the name "highlight" in solrconfig.xml, thus overriding the built-in one? Then you don't even need to make any component changes to your handler definition. {quote} Unfortunately, no. The [custom highlighter|https://dbmdz.github.io/solr-ocrhighlighting/] is supposed to run alongside the regular highlighter, since it only takes care of highlighting a specific subset of fields in the response, all other fields go through the default highlighter. > Default components are missing facet_module and terms in documentation > ---------------------------------------------------------------------- > > Key: SOLR-14829 > URL: https://issues.apache.org/jira/browse/SOLR-14829 > Project: Solr > Issue Type: Bug > Security Level: Public(Default Security Level. Issues are Public) > Components: documentation, examples > Affects Versions: 8.6.2 > Reporter: Johannes Baiter > Assignee: Ishan Chattopadhyaya > Priority: Minor > Attachments: SOLR-14829.patch > > > In the reference guide, the list of search components that are enabled by > default is missing the {{facet_module}} and {{terms}} components. The terms > component is instead listed under "other useful components", while the > {{FacetModule}} is never listed anywhere in the documentation, despite it > being neccessary for the JSON Facet API to work. > This is also how I stumbled upon this, I spent hours trying to figure out why > JSON-based faceting was not working with my setup, after taking a glance at > the {{SearchHandler}} source code based on a hunch, it became clear that my > custom list of search components (created based on the list in the reference > guide) was to blame. > A patch for the documentation gap is attached, but I think there are some > other issues with the naming/documentation around the two faceting APIs that > may be worth discussing: > * The names {{facet_module}} / {{FacetModule}} are very misleading, since > the documentation is always talking about the "JSON Facet API", but the term > "JSON" does not appear in the name of the component nor does the component > have any documentation attached that mentions this > * Why is the {{FacetModule}} class located in the {{search.facet}} package > while every single other search component included in the core is located in > the {{handler.component}} package? -- This message was sent by Atlassian Jira (v8.3.4#803005) --------------------------------------------------------------------- To unsubscribe, e-mail: issues-unsubscr...@lucene.apache.org For additional commands, e-mail: issues-h...@lucene.apache.org