This plugin can be installed via:
python -m pip install pelican-algolia
- Create an Algolia account
- On Algolia website, create a new application
- Create a new Index (or Indices) in you Algolia app. This will be
ALGOLIA_INDEX_NAME - Import you records, if asked select Use the API option
- Go to Settings -> API Keys -> Your API Keys and copy your
- Application ID, this will be
ALGOLIA_APP_ID - Admin API Key (DO NOT HARD CODE THIS IN YOUR PROGRAM). This will be
ALGOLIA_ADMIN_API_KEY - Algolia Search-Only API Key. This will be
ALGOLIA_SEARCH_API_KEY
- Application ID, this will be
Step 1: Set the following configuration in pelicanconf.py
# Algolia Publish Data
ALGOLIA_APP_ID = "<Your Algolia App ID>"
ALGOLIA_SEARCH_API_KEY = "<Your Search-only Api Key>"
ALGOLIA_INDEX_NAME = "<You Algolia App Index name>"Step 2: Set the ALGOLIA_ADMIN_API_KEY as an environmatal variable on path
Step 3: Import ALGOLIA_ADMIN_API_KEY in your publishconf.py (or pelicanconf.py if you're not using publishconf.py for publish settings)
import os
ALGOLIA_ADMIN_API_KEY = os.environ.get("ALGOLIA_ADMIN_API_KEY")You can read through Algolia documentation on how to build InstaSearch experience, or use a legacy version of search bar (example below) described in detail here.
Contributions are welcome and much appreciated. Every little bit helps. You can contribute by improving the documentation, adding missing features, and fixing bugs. You can also help out by reviewing and commenting on existing issues.
To start contributing to this plugin, review the Contributing to Pelican documentation, beginning with the Contributing Code section.
This project is licensed under the AGPL-3.0 license.