Here's an approach I used to avoid the RST displaying in the help text, though it is not entirely perfect.
In my Makefile, under html, I have the following: html: $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html * $(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text* *cp -R $(BUILDDIR)/text/* $(BUILDDIR)/html/_sources/* @echo @echo "Build finished. The HTML pages are in $(BUILDDIR)/html." Essentially it does a second build creating only "text" output, as highlighted in bold text above. Then in the next line, it replaces whatever was in in html/_sources with those text files. Thus, the search on the HTML only shows the text generated, and not the RST. I did this mainly because I have a whole lot of comments in my RST that I don't want inadvertently revealed in html/_sources, but it has the nice side-effect of slightly better search results formatting. You can see it in action on my website http://learnche.org/pid Hope that helps, Kevin 2016-09-26 10:23 GMT-04:00 'EMK' via sphinx-users < [email protected]>: > I researched this a few months ago and I believe it is an unsolved > problem. Nobody online had any solutions. I have it too and I am using > Basic. > > https://groups.google.com/forum/#!topic/sphinx-users/LTXwbmX0CeE > > The weird thing is that when I do the search on files in my build > directory, I only see the article title and no markup. When I search on > published files I see the first few lines but as markup. > > ERIN > > > On Thursday, September 22, 2016 at 11:42:40 AM UTC-4, NickJ wrote: > >> Hello, >> >> I am currently using read the doc theme and when I search a topic. The >> contents queried displays the start of the restructure text file instead of >> the start of the html page. Is there anyway to change that? >> >> -- > You received this message because you are subscribed to the Google Groups > "sphinx-users" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to [email protected]. > To post to this group, send email to [email protected]. > Visit this group at https://groups.google.com/group/sphinx-users. > For more options, visit https://groups.google.com/d/optout. > -- You received this message because you are subscribed to the Google Groups "sphinx-users" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at https://groups.google.com/group/sphinx-users. For more options, visit https://groups.google.com/d/optout.
