我重新用 Sphinx bootstrap theme 改了一下主题

[emptymalei]

现在顶上的导航条是一样的了。

主题放在了 bootstrap 分支了。如果需要换的话，直接把主题文件夹和 conf.py 覆盖过来就行了。

[ProtossProbe]

需不需要把Book和系外行星换成统一的一个主题

[emptymalei]

我做好了。要换就把 bootstrap 分支，主题文件夹里面 bootstrap 和根目录下的 conf.py 复制到sphinx对应的地方就可以了。

[ProtossProbe]

搞定了，现在就只差科技没转格式了。

[emptymalei]

@SpaceXploration 科技这个有非常多的公式，会非常麻烦，我来弄吧。

[emptymalei]

看看有没有问题吧，没有问题就可以把 Sphinx 分支 merge 到 master 了。

我已经备份好了原来的内容，放在了 gitbookbak 分支里面了，如果以后用到可以查看。

---

这个主题现在太难看了，还需要美化一下。最近比较忙，等有时间吧。

[ProtossProbe]

导航栏好像有个bug，点击最左边星际移民中心并不能回到主页

[emptymalei]

修复啦~~

sphinx 不能正常索引中文是个问题：http://interimm.org/InterImmBook/genindex.html

中文全部当作是 symbol 来处理……

[ProtossProbe]

有一个解决办法，把所有中文名词前都加个开头拼音的字母，不知道这样好不好？、 比如：S. 太空拖车 等等以此类推

[emptymalei]

我感觉不好。不如就这样吧。

[emptymalei]

调整了一下主题，现在看起来不像原来那么拥挤了，把灰色的背景去掉了。调整了一下图片的 margin 等等。

我搜了一下，似乎 sphinx 是可能进行中文分词的，但是不是特别有效而且需要另外的插件的帮助。所以搜索功能就去掉了。

---

关于自动索引，还有一种解决办法是使用 glossary 和 term。

glossary 是用来从正文看到，然后链接到 glossary 页面，然后在 glossary 页面读解释的。这个跟 index 的功能似乎不同。

可以在一个单独的文件中例如 glossary.rst 中把重要的词条按照 glossary 的语法列出来，列举的时候可以随意排版，这时候我们可以按照我们的想法分类。

然后在正文中，使用 term 的语法来引用 glossary 中的词条。

这样的缺点是，不够灵活，而且不能自动从 glossary 页面链接回到正文，而这是我们想要的功能。

---

补充：

发现目前的 index 还是按照某个顺序来拍列的，虽然不知道是什么顺序。

[ProtossProbe]

这两天在codecademy自学html和css中，还有三天就又有一门考试，感觉有点作死

[emptymalei]

@SpaceXploration 赶紧先考试…… 【我也得去系统的学习一下 HTML 和 CSS 】

[ProtossProbe]

花了一上午把bootstrap搭网站给入门了，放在了https://github.com/SpaceXploration/ProbeHome ，还是蛮有成就感的......

[emptymalei]

@SpaceXploration 好啊好啊，以后就不用我自己改页面了终于有了偷懒不干活的借口了

话说，这样你可以搭建自己的页面了。就用 gh-pages 吧。你需要建一个叫做 SpaceXploration.github.io 的 repo ，然后 master 分支下面的内容就是你的页面，不需要 gh-pages 分支。地址就是 SpaceXploration.github.io

GitHub 有个很坏的问题就是路径要区分大小写……

[ProtossProbe]

不能改名叫protossprobe.github.io？

[emptymalei]

@SpaceXploration 除非你改你的用户名~~ 前面那个是用户名。

[ProtossProbe]

@emptymalei 改了个用户名，如果以后有什么链接bug的话再说吧

[unionx]

@ProtossProbe 的个人页面貌似访问不了哦

[ProtossProbe]

@unionx 刚才还在生成，现在好了

[ProtossProbe]

这个.gitingnore和gitattributes是干什么的啊，能不能删了

[unionx]

@ProtossProbe 都是 git 的 metadata，用来控制 git 的某些行为的，删了也可以的

[emptymalei]

现在应该删除 sphinx 分支了，因为现在全都进入 master 了。