読者です 読者をやめる 読者になる 読者になる

しおしお

IntelliJのあれやこれや

sphinxからjavadocへのリンク簡単に貼れる拡張

Sphinxのドキュメントから、Javadocページ編のリンクを貼るのを簡単にするhttps://bronto.github.io/javasphinx/: titleという拡張です。この拡張を使うと、Javadocのトップページへのパスをconf.pyに設定して置けるので、 ここのページではクラスの完全修飾…

vimにrivプラグイン入れたらSphinxの編集楽になった

VimでSphinxなドキュメント書いてて、grid-table の編集しんどくなったから、ぐぐってみたらrivなるよさ気なプラグイン見つけた。grid tableだと枠線綺麗に書かないと行けないんだけど、コマンド一発で綺麗にしてくれたり、行の追加してくれたりかなり幸せな…

IntelliJでSphinxドキュメントを書いてみよう

IntelliJでSphinxを使う手順のまとめ。 前提 IntelliJでSphinxを使うための必要な下記のモジュールのインストールができていること。 Python Sphinx IntelliJのPythonプラグイン IntelliJにPythonプロジェクトの作成 Sphinxを利用するためには、Pythonプロジ…

Sphinxのソースコード表示を消す方法

Sphinxの小ネタ。Sphinxをhtmlでビルドすると、サイドバーに「ソースコードを表示」なるリンクが出力されます。 このリンクをクリックすると今表示されているページのソース(rstの内容)が見れます。ただ、rstの内容は見せたくないって場合があるので、その場…

GradleでSphinxをビルドしてみた。

お仕事でSphinxでドキュメント書いてて、Gradleでビルドしてるときたら、SphinxもGradleからビルドしないとダメだよねってことでやってみた。お試しプロジェクトの構成はこんな感じで、プロジェクト直下のdocディレクトリにドキュメントが格納されていると。…