Sphinx Con JP 2015での発表 目的からドキュメントシステムを選べるYes/Noチャートは33ページにあります。 (当初アップロードしたものはこのページにミスがあったので差し替えています。高橋さんありがとうございます。)Read less
Available lexers¶ This page lists all available builtin lexers and the options they take. Currently, all lexers support these options: stripnlStrip leading and trailing newlines from the input (default: True) stripallStrip all leading and trailing whitespace from the input (default: False). ensurenlMake sure that the input ends with a newline (default: True). This is required for some lexers that
PDF を納める必要があったのでやった。Sphinx というか reST での日本語出力には若干の難があるらしい。けど、これも先人のとおりにやったら簡単にできた。 rst2pdf 方式 (8日目) Sphinx から PDF を生成してみよう (rst2pdf 編) - Hack like a rolling stone をまず参考にやってみた。pip install rst2pdf, PIL 環境構築, VLゴシックのようなフォントをいれる。 ja.json を作成して読み込ませる。PIL 環境の構築はハマりやすいから http://atasatamatara.hatenablog.jp/entry/20120803/1344001904 を参考にするといい。 結果としてはうまくいかなかった。後述の日本語のなんらかのパッチのはいった Sphinx だったらできたかもしれないけど、一部が文
ここ最近,sphinx で仕様書などを書いて,HTML/epub で出力,内容確認. ブラウザで見たほうが軽く動かせたり,閲覧する環境を変えることで見落としていた考え方が浮かんできたりするので,多様な方法で文章を精査する方法を好んでます.なので最近はスマートフォンやタブレット上でepub 閲覧が多いというスタイルです. その後,内容がだいたいOKなら,latex 出力して,PDF変換して,チーム内回覧という使い方をしてました.が,結局,今いる職場は,非IT技術者の方ばかりなので,追記できるようにword/excel でよこせと言われるわけです. そのため,その度にPDFから文章コピペ,word に貼りつけ・整形としていたわけですがやはり非効率. もう少しいい方法ないかなぁと思いつつ,文章を書くという割りと面倒な作業の敷居を低くしてくれるsphinx を使用していたわけですが,twitter
文書にブロック図を埋め込む¶ いくつかの文書管理システムではプラグインや拡張機能として`blockdiag` で生成したブロック図を文章に埋め込むことができます。 Sphinx に埋め込む¶ Sphinx は reST 形式(テキスト)で記述するドキュメント生成ツールです。 Sphinx で作成する文書にブロック図を埋め込むにはSphinx 拡張である sphinxcontrib-blockdiag パッケージを利用します。 sphinxcontrib-blockdiag については sphinxcontrib-blockdiag で説明します。 Read the Docs に埋め込む¶ Read the Docs は Sphinx ドキュメントのホスティングサービスです。 Read the Docs で公開する文書にブロック図を埋め込むにはSphinx 拡張である sphinxcontr
はじめに¶ こんにちは。 Sphinx Advent Calendar 2012 の4日目のエントリです。 @tk0miyaより受け取りました。 Sphinxを使い始めてまだ日が浅いですが実際に仕事で使ってみてすばらしいツールだと今更ながら気づき、Sphinxに特化したエントリというよりも Sphinx + blogckdiagを使って仕事に使えるダイアグラムの表現方法についてご紹介します。 非プログラマでも簡単に作成ができ修正も簡単、イライラしないでサクサクと図が書けます。 ソフトウェア開発プロジェクトで作成されるドキュメント(特にマニュアルで利用)は顧客に説明するための図解を多用します。これまでの経験で Word/Excel の描画ツールをつかってがんばって作った図調整と編集がとても大変 Visio を使ってわかりやすく綺麗に作成されているが、Word/Excel/PowerPoint
ダウンロード このドキュメントはバージョン1.0 (hg)のためのものです。まだリリースされていません。 Mercurialリポジトリのコードを利用するか、Python Package Indexにあるリリースバージョンを探してください。 疑問? 意見? Googleグループへの参加: もしくは、FreeNodeの#python-docsチャンネルへどうぞ 何か気づいたことがあれば、issue trackerを使用して通知することもできます。 Sphinxは知的で美しいドキュメントを簡単に作れるようにするツールです。Georg Brandlによって開発され、BSDライセンスのもとで公開されています。 このツールはもともと、新しいPythonのドキュメントの変換のために作られました。そして、今までに数々のPythonや、他の言語で開発されているプロジェクトに対して、すばらしいドキュメンテーシ
システム開発や保守、運用の現場においてドキュメントは必須のものです。 しかし、ドキュメントの作成・維持には多くのパワーがかかるため、ドキュ メントが存在しない、資料が古いままになっているなどといった現状を多く 耳にします。 本勉強会ではこれらのドキュメントでよく利用される「図」にフォーカスし、 みるみるうちに図を作成できる「blockdiag」をご紹介します。 「blockdiag」はシンプルなテキスト記述からブロック図、ネットワーク図などの 画像ファイルを出力可能なオープンソースの画像生成ツールです。書き やすさ、メンテナンスしやすさを中心にデザインされており、図を作るのに 配置や並べ替えに苦労する必要はありません。 blockdiagのサンプルはこちら このような特徴を持つ「blockdiag」と、シンプルな記述でドキュメントを作成 するツール「Sphinx」を組み合わせることによって
注釈 Windows Vista以降で管理者権限が必要な場所へのインストールを行う場合は「右クリックして管理者権限で実行」してください。(管理権限は要求しないように作っています) If you need privilege to install on WIndows Vista or after, You need to install with administrator privilege (right click and choose one). これでパス設定を含めたインストールが行われます。 スタートメニューから、コマンドプロンプトを起動するか、「名前を指定して実行」で cmd と入力してみましょう。ウィンドウが表れたら、 python[Enter] とタイプします。インストールしたPythonのバージョンを表す文章に続いて、 >>> という文字が表示されればインストールは成功で
何かの社内用ドキュメントの作成や、マニュアル、翻訳、書籍作成などなど、ドキュメンテーション用のツールとして注目を浴びてきている Sphinx ( スフィンクス ) 。そんな Sphinx をインストールして、みんなで触ってみよう!という ハンズオン 第3回が2月22日(水)に開催されたので、行ってきました。場所はタイムインターメディアさんの会議室。会場は市ヶ谷の防衛省にとても近いんですね。 ◆いざ、ハンズオンへ! どうして、このハンズオンに参加しようかと思ったかと言いますと、 社内用テキストエディタで書かれたドキュメント(という名のメモ書き)をキレイにしたい 某ドキュメントの翻訳用途で、割と手軽にドキュメントを整形したい という、割と身近な問題を解決したかったから。 べっ、別にテキストや Wiki でも良いのですが、あとから見返す時にフォルダにテキストが散乱し、”文章が散らばり過ぎだろ、常
已通过安全加密检测 如果没有自动跳转,请点击下方按钮前往 欢迎爸爸光临8号购彩360安全卫士提供技术支持 Copyright © 1998 -2020. All Rights Reserved.
Sphinx で会社の製品サイトを作って 4 ヶ月以上過ぎました、実際に運用してみた感想などを。 前提 デザイナー @kinofumi に依頼して、Sphinx の専用テーマを作って貰いました。@kinofumi は Jinja2 も使いこなしてしまったりとデザイナー?なのか怪しいですが、とてもステキなサイトが出来ました。 商用製品サイトなので、とにかく見やすいこと、知りたい情報が見つかることが第一に作って貰いました。 リリース環境 S3 にデプロイしてパーミッションを Public にしています。URL は DNS 指定しているだけです。 それ以上は特にやっていません。 費用 アクセスが 1 日 100 人未満です。そもそも 1000 人も見に来るようになったら問題です。 で、実際いくらかかったのよ、という話しです。 今のところ三ヶ月連続で $ 0.03 で、今月も今のところ $ 0.0
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く