1

我发现我在 readthedocs.org 上托管的最新版本的网站 eswp3.org的搜索功能不再起作用。我使用 python-sphinx html 主题sphinx_rtd_theme的默认搜索功能。我使用默认的 makefile 来构建 html 文件。

一些可能的错误原因调查：

  • 网站版本 v1.1 和网站版本 v1.0 的搜索字段已损坏。
  • 在网站版本 V0.1 中，搜索字段正在工作。（版本可以通过网站左下角的字段进行切换。）
  • 重建网站源 v1.0后，在本地文件系统上，v1.0 的搜索字段不起作用，v0.1 的搜索字段起作用。
  • 比较网站源 v1.0 和 v0.1 会导致以下差异：

到差异屏幕截图

  • 我检查了 conf.py 中的差异，但没有发现关键差异。
  • 我删除了 _build/html 中的文件，并make html在我的本地文件系统的根目录 eswp3/ 中使用 python-sphinx 默认 make 目标重建了这些文件。没有打印关于索引的问题。
  • 不幸的是，生成版本中的搜索字段也不起作用。

我错过了什么？我是否必须考虑不同构建中使用的 python-sphinx 版本的可能差异？

提前非常感谢。

4

2 回答 2

0

修改以下代码C:\Python27\Lib\site-packages\sphinx_rtd_theme\layout.html

未固定：

164 <script type="text/javascript">
165 var DOCUMENTATION_OPTIONS = {
166    URL_ROOT:'{{ url_root }}',
167    VERSION:'{{ release|e }}',
168    COLLAPSE_INDEX:false,
169    FILE_SUFFIX:'{{ '' if no_search_suffix else file_suffix }}',
170    HAS_SOURCE:  {{ has_source|lower }}
171 };

固定的：

164 <script type="text/javascript">
165 var DOCUMENTATION_OPTIONS = {
166    URL_ROOT:'{{ url_root }}',
167    VERSION:'{{ release|e }}',
168    COLLAPSE_INDEX:false,
169    FILE_SUFFIX:'{{ '' if no_search_suffix else file_suffix }}',
170    HAS_SOURCE:  {{ has_source|lower }},
171    SOURCELINK_SUFFIX: '{{ sourcelink_suffix }}'
172 };
于 2017-02-17T19:25:49.733 回答
0

在windows机器上编辑的一些文件在最初或文件编辑后没有作为UTF-8格式文件提交到github，而是WINDOWS-1252格式文件。将所有 *.rst 文件转换为 UTF-8 完成了这项工作（例如，通过将 UNIX 上当前目录的所有 *.srt 文件转换为子文件夹 /utf-8 使用find . -name "*.rst" -exec iconv -f WINDOWS-1252 -t UTF-8 {} -o utf-8/{} \;）。

于 2016-10-15T16:17:40.070 回答