Security News
The Dark Side of Open Source
At Node Congress, Socket CEO Feross Aboukhadijeh uncovers the darker aspects of open source, where applications that rely heavily on third-party dependencies can be exploited in supply chain attacks.
antora-site-generator-lunr
Advanced tools
Readme
This site generator is a copy of the default site generator that in addition produces a Lunr index that can be used in your documentation UI. Lunr provides a great search experience in your documentation site without the need for external, server-side, search services.
Antora is a modular static site generator designed for creating documentation sites from AsciiDoc documents. Its site generator pipeline aggregates documents from versioned content repositories and processes them using Asciidoctor.
Install the site generator. Open a terminal and type:
$ npm i -g antora-site-generator-lunr
When generating your documentation site, use the --generator
option:
$ DOCSEARCH_ENABLED=true DOCSEARCH_ENGINE=lunr NODE_PATH="$(npm -g root)" antora --generator antora-site-generator-lunr site.yml
NOTE: The NODE_PATH
assignment is necessary to ensure Antora can locate node modules install globally.
Depending on your environment, you may find that this assignment is unnecessary.
If you've installed Antora globally using Yarn, you may need to add "$(yarn global dir)/node_modules"
to the NODE_PATH
environment variable instead.
Please read the documentation to enable the search component in your documentation UI.
The Docker image is built upon the Antora's official Docker image and should be used as a replacement. For example, instead of running:
$ docker run -u $(id -u) -v $PWD:/antora:Z --rm -t antora/antora:2.3.4 antora-playbook.yml
You will run:
$ docker run -u $(id -u) -v $PWD:/antora:Z --rm -t ggrossetie/antora-lunr antora-playbook.yml
The image sets DOCSEARCH_ENABLED=true
and DOCSEARCH_ENGINE=lunr
environment variables.
When executing docker run
, you can overwrite any variable defined in the image.
For example:
$ docker run --env DOCSEARCH_ENABLED=false # ...
Moreover, the site generator is automatically configured on the antora
command (i.e. --generator antora-site-generator-lunr
).
When installing this generator globally (i.e., npm i -g
), it also installs a private copy of Antora (minus the CLI).
Thus, to upgrade the copy of Antora this site generator uses, you need to reinstall this package.
Upgrading Antora alone isn't sufficient.
To upgrade this site generator and Antora, open a terminal and type the following commands:
$ npm uninstall -g antora-site-generator-lunr @antora/cli @antora/site-generator-default
$ npm i -g antora-site-generator-lunr @antora/cli @antora/site-generator-default
These commands ensure you have the latest version of both the site generator and Antora regardless of whether you're using this site generator.
FAQs
An Antora's site generator that produces a Lunr index.
The npm package antora-site-generator-lunr receives a total of 1,331 weekly downloads. As such, antora-site-generator-lunr popularity was classified as popular.
We found that antora-site-generator-lunr demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
At Node Congress, Socket CEO Feross Aboukhadijeh uncovers the darker aspects of open source, where applications that rely heavily on third-party dependencies can be exploited in supply chain attacks.
Research
Security News
The Socket Research team found this npm package includes code for collecting sensitive developer information, including your operating system username, Git username, and Git email.
Security News
OpenJS is warning of social engineering takeovers targeting open source projects after receiving a credible attempt on the foundation.