Skip to main content

A Sphinx extension for replacing the built-in search with Algolia DocSearch

Project description

Algolia DocSearch Sphinx extension

This extension for the Sphinx documentation generator replaces Sphinx's built-in search with Algolia DocSearch.

Before you begin

Apply for DocSearch. You'll get an email with your Algolia credentials.

This extension supports Python versions 3.8, 3.9, 3.10, and 3.11 and Sphinx versions 5 and later.

Install

Install the sphinx-docsearch extension from PyPI:

pip install sphinx-docsearch

Configure

  1. Add sphinx-docsearch to your Sphinx configuration file conf.py:

    extensions += ["sphinx_docsearch"]
    
  2. Add your Algolia credentials to your Sphinx configuration:

    docsearch_app_id = "<DOCSEARCH_APP_ID>"
    docsearch_api_key = "<DOCSEARCH_SEARCH_API_KEY>"
    docsearch_index_name = "<DOCSEARCH_INDEX_NAME>"
    
  3. Optional: change configuration settings

Customize

  • Customize crawling (link to DocSearch or Crawler doc)
  • Add custom templates
  • Add custom CSS

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sphinx_docsearch-0.0.2.tar.gz (39.0 kB view hashes)

Uploaded Source

Built Distribution

sphinx_docsearch-0.0.2-py3-none-any.whl (40.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page