From 6a981d0de9a9ce8383ef6eaede6c1b8a83dc5cdd Mon Sep 17 00:00:00 2001 From: Timotheus Kampik Date: Sat, 30 Jul 2016 23:29:36 +0200 Subject: [PATCH] Add README content --- README.rst | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/README.rst b/README.rst index e69de29..2709611 100644 --- a/README.rst +++ b/README.rst @@ -0,0 +1,28 @@ +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 +------------- +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.