Skip to main content

Decently styled search results for sphinx-doc projects

Project description

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

There are no custom configuration variables for the Sphinx: pretty search results extension.

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.

Testing

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

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

pip install -r 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.1.6.tar.gz (3.2 kB view hashes)

Uploaded Source

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