Skip to main content

Decently styled search results for sphinx-doc projects

Project description

https://travis-ci.org/TimKam/sphinx-pretty-searchresults.svg?branch=master

Sphinx: pretty search results

Sphinx: pretty search results is an extension for the Sphinx documentation tool.

To display search results, Sphinx is fetching the source files of search hits and rendering excerpts in raw markup (Example).

This extension removes the markup from these source files (during build time), so the search results look decent.

Installation

Run pip install sphinxprettysearchresults.

Configuration

After installing the extension, all you need to do is to register it.

Add sphinxprettysearchresults to the extensions array in your conf.py file, for example:

extensions = [
   'sphinxprettysearchresults'
]

After your next build, your project will no longer display raw markup in the search result excerpts.

Since version 1.5.0, Sphinx is adding the source file extension to the source files it includes in the output folder. For example, when your source file extension is rst (specified in the config variable source_suffix as [.rst], your index file appears in the output’s source folder as index.rst.txt. If you use a Sphinx version lower than 1.5.0, it appears as index.txt. Sphinx: pretty search results considers this difference and changes its behavior according to your Sphinx version. However, if you use a Sphinx theme that expects the old file names although you are using a later Sphinx version, you can fall back to the old file names by setting the following configuration variable:

use_old_search_snippets = True

Testing

Sphinx: pretty search results uses nose as its test framework.

To run the tests, you first need to install the dev dependencies:

pip install -r dev_requirements.txt

Then, navigate to the tests directory and run:

python run.py

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

sphinxprettysearchresults-0.3.5.tar.gz (4.4 kB view details)

Uploaded Source

File details

Details for the file sphinxprettysearchresults-0.3.5.tar.gz.

File metadata

File hashes

Hashes for sphinxprettysearchresults-0.3.5.tar.gz
Algorithm Hash digest
SHA256 bc1c306b5c2ceadb264d9daa880b2e7aab82322e9d4dd5f876ec62f4e173d369
MD5 305254a8c85df82c69f8c0d9604fc038
BLAKE2b-256 64f34ac2518dc6e1556240351d3d10d59ed315e65f64e8fa6289535af1be0a6f

See more details on using hashes here.

Supported by

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