Algolia search uploader for Hugo
Algolia is a hosted search platform geared towards business users, but provides a free limited Community tier of their product. It integrates with Hugo quite well if you instruct Hugo to build a JSON site index file.
First, sign up for an Algolia account. Create an index for your website. Take note of your Admin API key and App ID. You will need both of those, as well as the name of the index you created, to use this tool.
The configuration file for this tool lives at
$XDG_CONFIG_HOME/algolia-hugo/algolia-hugo.yaml, which by default points to
$HOME/.config/algolia-hugo/algolia-hugo.yaml. Place the following contents
into that file.
algolia_app_id: <your app id> algolia_api_key: <your api key> algolia_index_name: <your index name>
It can also be configured via environment variables for ease of use in docker containers or on CI/CD platforms like CircleCI. Just set variables named as above, only all-caps.
ALGOLIA_APP_ID=<appid> ALGOLIA_API_KEY=<api_key> ALGOLIA_INDEX_NAME=<index_name> algolia_hugo config
This tool has very little functionality right now. There are three commands.
This will update your search objects in the Algolia index. It does this by deleting the existing objects and uploading the entire index again. In this way it alleviates the problem of old search objects that may have been edited or deleted remaining in the index. Future versions of this tool may support updating existing objects when I find both time and need.
By default this tool will look for a file named
to the current directory. This can be overridden with the
arguments to the
This command simply clears your search index on Algolia, leaving you with an empty index.
This command is used to show the config file found by this tool, as well as showing the configuration fields read in.
Full help is available by running the
help command, or by executing the tool
without any subcommands.