Right?? By far makes this whole thing worth it, besides the other wonderful goodies we get (like changing solr versions).
Basically it works by adding this line: (along with gradle build stuff of downloading that extension and putting stuff in the right place) https://github.com/apache/solr/blob/main/solr/solr-ref-guide/playbook.template.yml#L40 Antora handles the rest. You can find the extension here: https://gitlab.com/antora/antora-lunr-extension Sadly it doesn't use Solr, but it is a small price to pay so that we, a search engine, finally have search enabled for our docs... - Houston On Thu, Feb 10, 2022 at 1:42 PM Gus Heck <[email protected]> wrote: > :) nice. highlighting of search terms too! > > On Thu, Feb 10, 2022 at 1:38 PM David Smiley <[email protected]> wrote: > >> OMG I see we have search now -- good search with snippets too! How does >> it work? >> >> ~ David Smiley >> Apache Lucene/Solr Search Developer >> http://www.linkedin.com/in/davidwsmiley >> >> >> On Thu, Feb 10, 2022 at 1:09 PM David Smiley <[email protected]> wrote: >> >>> This is a nice fresh look; thanks Cassandra, Houston, and Mike! >>> >>> ~ David Smiley >>> Apache Lucene/Solr Search Developer >>> http://www.linkedin.com/in/davidwsmiley >>> >>> >>> On Thu, Feb 10, 2022 at 12:47 PM Houston Putman <[email protected]> >>> wrote: >>> >>>> Hey everyone. The new ref guide is officially merged into all relevant >>>> branches (down to branches_9_0). Luckily, there shouldn't be much change to >>>> your workflow! >>>> >>>> *Building* >>>> In order to build a local site, use: "gradlew buildLocalSite", or just >>>> "gradlew assemble". >>>> The output will be in "solr/solr-ref-guide/build/site/index.html", but >>>> this is also output when the task is run. >>>> >>>> *Page source* >>>> The source for the pages is now found under the >>>> "solr/solr-ref-guide/modules" directory. At first it might be hard to find >>>> files, but they are pretty logically separated out. >>>> >>>> The syntax is still asciidoctor, but there is a large change in how you >>>> link between pages in the ref guide. You can find lots of examples >>>> throughout the existing pages, but it is documented here: >>>> https://github.com/apache/solr/blob/main/dev-docs/ref-guide/asciidoc-syntax.adoc#link-to-other-pagessections-of-the-guide >>>> >>>> Please make sure that the merge goes cleanly for the PRs you have >>>> already created, before the new ref-guide was committed. The only real >>>> issue you should see is the new link syntax, mentioned above, but there is >>>> a possibility there will be worse problems. I'm happy to help with any >>>> merge issues you run into so please reach out. >>>> >>>> *Check it out* >>>> You can check out the local build here: >>>> https://nightlies.apache.org/solr/draft-guides/solr-reference-guide-antora/solr/10_0/ >>>> >>>> That link is up-to-date as of yesterday. Soon we will have it up to >>>> date with all current versions (9.0, 9.1 and 10.0), hopefully tomorrow at >>>> some point. (I will also go through and make sure we didn't backport things >>>> from 10 and 9.1 to 9.0 that shouldn't have been included...) >>>> >>>> >>>> Thanks to Cassandra for doing the heavy lifting here (and Mike as >>>> well)! This is a major improvement for our docs, and I'm really excited to >>>> have it out there soon! >>>> >>>> - Houston >>>> >>> > > -- > http://www.needhamsoftware.com (work) > http://www.the111shift.com (play) >
