這兩天用sphinx聯繫寫文檔感覺還是很舒服的，就是感覺技巧有點多，版本還不太穩定，比如用default的主題可以定製側邊欄是固定的，但使用sphinxdoc主題就沒有這個功能有點鬱悶。還有就是中文包翻譯的不太全需要自己手動修改，中文檢索需要上網看別人的實現。在右上角現實modindex就費了我很多天時間，結果官方文檔寫着是通過rellinks這個全局變量來定義的，只怪自己英語不好看了很多遍都沒注意還是諮詢別人才瞭解的。因爲modindex這東西只有在你的文檔裏出現了 .. module:: 的時候纔會在右上角顯示的所以我怎麼弄也出不來。仔細查了源碼只要把sphinx/builders/html.py中224行後半句 and self.env.modules：註釋掉就可以了。唉，真是不該跟這東西鑽牛角尖。
