Re: Search options for local documentation sets
In that context, JQuery seems to be the search component of choice these days.
On Thu, Jul 14, 2016 at 12:00 PM, Lois Patterson
<loisrpatterson -at- gmail -dot- com> wrote:
Yes - the default offline JavaScript search. The default searchindex.js file
which is created during the document generation includes an index, which is
better than nothing, but not good.
On Thu, Jul 14, 2016 at 11:31 AM, Robert Lauriston <robert -at- lauriston -dot- com>
wrote:
Is what you're generating with Sphinx a set of static files (.html,
.css, .js, index of some sort) where the search runs on the user's
local browser?
On Thu, Jul 14, 2016 at 11:27 AM, Lois Patterson
<loisrpatterson -at- gmail -dot- com> wrote:
Yes, I think in general people are putting their Sphinx-generated
documentation sets online, and also using elasticsearch for internal
search
on online websites, thus avoiding the problems of search in a local
context.
On Thu, Jul 14, 2016 at 11:26 AM, Robert Lauriston
<robert -at- lauriston -dot- com>
wrote:
By "local documentation website" do you mean Sphinx HTML output? Are
you using Sphinx Web Support?
If you Google
https://www.google.com/search?q=optimize+sphinx+search+performance&oq=optimize+sphinx+search+performance
there are a lot of hits, but most of them are three to six years old,
which makes me wonder if people have moved on to something else.
On Thu, Jul 14, 2016 at 11:14 AM, Lois Patterson
<loisrpatterson -at- gmail -dot- com> wrote:
We are authoring with reStructuredText and generating the HTML docs
with
Sphinx. We get a local documentation website as output, with built-in
navigation. That part is great. The sub-optimal part is that the
default
offline JavaScript search is quite bad.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | http://techwhirl.com
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-
To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com
Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.
Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com
Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives
Follow-Ups:
- Re: Search options for local documentation sets, Robert Lauriston
- Re: Search options for local documentation sets, Robert Lauriston
References:
Search options for local documentation sets: From: Lois Patterson
Previous by Author:
Re: Search options for local documentation sets
Next by Author:
Re: Book on Modern Technical Writing
Previous by Thread:
Re: Search options for local documentation sets
Next by Thread:
Re: Search options for local documentation sets
Search our Technical Writing Archives & Magazine
Visit TechWhirl's Other Sites
Sponsored Ads