Sphinx in 2016 - Hack like a rolling stone
昨日は Markdown の 2016年を振り返りましたが、今日は Sphinx の 2016年を振り返りつつ、 2017年の目標を適当に挙げてみようと思います。 2つのメジャーリリースと 13のマイナーリリース 今年は 1.3.4 から 1.5.1 まで、合計で 15のリリースを行いました。 2014年が 1.2.1 から 1.2.3 までの 3リリース、2015年が 1.3 から 1.3.3 までの 4リリースだったとの比較すると、コンスタントに改善を続けられたと感じています。 もうひとりのメンテナである清水川氏と相談し、Sphinx ではリリースポリシーを刷新しました。 おおよそ 1ヶ月おきに 1回のバグフィックスリリース、6〜8ヶ月おきに 1回のメジャーリリースを行うつもりで進めています。 少し前の記事にある通り、メンテナのリソースも十分にあるというわけではないので、あくまで目標で
続・PHP のドキュメントを Sphinx で書いてみる (phpautodoc を作ってみた) #sphinxjp - Hack like a rolling stone
去年の12月にPHP のドキュメントを Sphinx で書いてみる (phpautodoc を作ってみた) #sphinxjpという記事を書きました。 その時に、PHP からドキュメントを抽出する phpautodoc というのを作ったのですが、 その後他の作業に夢中になっていたので自分でも使わないまま放置されていました。 ですが、最近ドキュメントを書く時間を作ったので、作りかけの phpautodoc に手を入れて使えるようにパッケージングしてみました。 tk.phpautodoc を使う phpautodoc は gist に貼りつけたままで自分でも使いづらかったので、 あらためて tk.phpautodoc という名前で公開することにしました。 本来であれば、sphinxcontrib-phpautodoc とかにすべきなんでしょうが、 実験的要素がまだ残っているのでちゃんとした名前
Sphinxでドキュメントを書こう
MapReduce/Spark/Tezのフェアな性能比較に向けて (Cloudera World Tokyo 2014 LT講演）Hadoop / Spark Conference Japan
https://www.freia.jp/taka/blog/sphinx-i18n-translation-procedure-with-transifex-amazon-s3/index.html
PHP のドキュメントを Sphinx で書いてみる (phpautodoc を作ってみた) #sphinxjp - Hack like a rolling stone
この記事は Sphinx アドベントカレンダーの 26日目(相当)を勝手に書いたものです。 Sphinx の autodoc Sphinx には autodoc という機能があります。 未だにうまく使う方法を理解できていないのですが、ちゃんと使うと Python コードに書かれた docstring を元に Sphinx 文書にリファレンスを埋め込むことができるそうです。 Javadoc や Doxygen のようなことができるということですね。 「Sphinx 文書に埋め込む」というスタイルをとっているため、 コードに記述しづらいシステムの概要やミドルウェアの話、 運用における注意点などは通常どおり Sphinx 文書として記述して、 コードに関する説明などは docstring に書くという書き分けができそうです。 ただ、あまり詳しい説明が書いていないこともあり、 また Python
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
https://www.freia.jp/taka/blog/sphinx-dev-remove-2to3/index.html
同人誌用のsphinxテンプレートをつくった - 検討!目論見委員会Z
Sphinxの全文検索を複合語に強くする
Bitbucket
GitHub - nishio/rst2inao: ReST to inao converter
Bitbucket
Is it possible to override Sphinx autodoc for specific functions?
document isn’t included in any toctreeという警告が出る — Sphinx逆引き辞典 v0.0.1 documentation