SphinxかわいいよSphinx - marsのメモ
ビルド職人本も出てノンビリしてたんだけど、脳みその中が揮発する前に、ちょっと書いてた間のことも残しておこうと思ってみたり。 原稿なんですが、[twitter:@dentomo]さんからは「テキストファイルかWordでお願い」って言われました。へー、Wordアリなんだー、ってのとテキストって正真正銘プレーンテキストなのね、とそのギャップが面白いなと思った。で、結局どうしたかっていうと Sphinxで書いた。 うん、全然、人の話聞いてない。:-) 言い訳言うと、Word持ってない＆プレーンテキストで脚注やら連番やら書くのは骨が折れるなって思ったから。後、Sphinxでテキストに変換すりゃいいだろうって思ったから。で、結論から言うと、Sphinxイイヨ。。reSTのマークアップも意外と表現力あって、あまり不満に思うこと無かった。なにより、脚注とかのクロスリファレンス、レイアウトのプレビューができ
Sphinx-Users.jp
Sphinx-Users.jp¶ Sphinx-Users.jp(略称#sphinxjp)は、美しいドキュメントを簡単に生成することができるドキュメンテーションツール、 Sphinx （スフィンクス）の普及を主眼としたコミュニティです。SphinxはPythonの公式ドキュメントだけでなく、このSphinx-Users.jpのサイトも含め多くのマニュアルやサイトで使用されており、詳細を Sphinxの歴史で紹介しています。 Sphinx-Users.jp は日本の Sphinx コミュニティです。 Sphinx-Users.jp では、日本で散らばっているSphinx関連情報を集めて、Webサイト、イベントを通じてSphinx情報を発信します。 slack のコミュニケーションや勉強会の開催などを通じて、ドキュメントをパワーアップしたい人、ドキュメントや翻訳で苦労している人、Sphinxの
bitbucket + Sphinx + Google App Engineで自動更新サイトを作成する - YAMAGUCHI::weblog
動機 Sphinxを使って翻訳作業をしたりしているんですが、いちいち自分でビルドして、サイトに公開するのが面倒。そこで WebSocketのRFCの日本語訳を公開した時と同様にGoogle App Engineへ定期的にSphinxでビルどしたhtmlディレクトリをupするという方法を試してみた。 出来たもの とりあえずいまはこんな感じで動いています。 404 Not Found プロジェクト作成 まずはGoogle App Engine（以下GAE）のプロジェクト作成をする準備。今回はUbuntu 9.04上で環境を作ってみる。自分は一回作ったアプリケーションがあるのでいいけど、0から始める場合はまずアプリケーションの登録から。 Welcome to Google App Engine まずダッシュボードで適当にアプリケーション作成。アプリケーション作ったらSDKをダウンロード $ wg
bitbucketを使ってSphinxのソースを管理 - YAMAGUCHI::weblog
動機 この間翻訳で使ってみたらかなり使いやすかったんで始めてみた。これからドキュメント書きに使いそうなのでメモ。 手順 レポジトリの準備 Free source code hosting — Bitbucket bitbucketでMercurialのプロジェクトを作成する。 これでプロジェクトができた。今度はローカルにcloneする。 $ hg clone hg clone http://bitbucket.org/<username>/<repository name>ここでbitbucketで幸せになるために設定ファイルを修正する。 $ cd <repository name> $ vim .hg/hgrc + [ui] + username = hogehoge <foo AT example.com>usernameを変更しておかないとbitbucketにpushしたときに登録し
Quick reStructuredText
Quick reStructuredText https://docutils.sourceforge.io/docs/user/rst/quickref.html Being a cheat-sheet for reStructuredText Updated $Date: 2022-01-29 23:26:10 +0100 (Sa, 29. Jän 2022) $ Copyright: This document has been placed in the public domain. The full details of the markup may be found on the reStructuredText page. This document is just intended as a reminder. Links that look like "(details)
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
