asciidoctor-pdfで社内ドキュメントを書こう - Qiita
この投稿は Fujitsu Advent Calender 2016 の 12日目の記事です。 この記事に書かれた見識は個人のものであり、所属する会社・組織を代表するものではありません🐸。 12/12修正: asciidoctor-pdfインストールコマンドに誤りがありました。 サンプルのスタイルファイル名を confidential_style.yaml から public_style.ymlに変更し、機密区分表記をPublicにしました（不適当だったため）。 合わせてサンプルPDFドキュメントの画像を差し替えています。 その他タイポを修正しました。 背景・動機🐸 技術職にかぎらず、仕事をする上でドキュメントを書く機会はたくさんありますが、大なり小なり組織に所属している以上、好き勝手にオレオレフォーマットを作って、「これがオフィシャルです」・というのはなかなか難しく、組織の内で用意さ
Sphinx Themes
Sphinx Themes Gallery Curated and maintained by @pradyunsg and @shirou. Browse themes → GitHub Alabaster default click image to see more Read the Docs click image to see more Furo click image to see more Book click image to see more PyData click image to see more Press click image to see more Piccolo click image to see more Insegel click image to see more Insipid click image to see more Material c
Let's master docutils!
Takeshi KOMIYA (@tk0miya) 2018.11.28 @ SphinxCon JP 2018 Let’s master docutils! ↓ URL for this presentation
Linux カーネルでの Sphinx 利用法を見てみよう - Hack like a rolling stone
年末カウントダウン Sphinx 連載、第3弾です。 一切下準備をせずに連載を始めたので、早くも息切れをしています。 だれかと約束をしたわけでもないのに急にアドベントカレンダー的なものを始めるのは、なんだか死に急いでいる気がしてきました。 今回は、今年から Sphinx の利用者に加わったある大型プロジェクトについて紹介しましょう。 そのプロジェクトとは、世界最大級の OSS のひとつである Linux カーネルです。 現在の Linux カーネルドキュメント 今年開催された LinuxCon Japan 2016 で Linux カーネルのドキュメントに Sphinx を使うという発表がありました。 Linus Torvalds氏が登壇、「約10週間のリリースサイクルは続く」 - クラウド Watch それから約 5ヶ月。現在はどうなっているのか見てみましょう。 Linux カーネルのド
The Linux Kernel documentation — The Linux Kernel documentation
The Linux Kernel documentation¶ This is the top level of the kernel's documentation tree. Kernel documentation, like the kernel itself, is very much a work in progress; that is especially true as we work to integrate our many scattered documents into a coherent whole. Please note that improvements to the documentation are welcome; join the linux-doc list at vger.kernel.org if you want to help out.
Welcome to our community!
Welcome to our community!¶ Write the Docs is a global community of people who care about documentation. We consider everyone who cares about communication, documentation, and their users to be a member of our community. This can be programmers, tech writers, developer advocates, customer support, marketers, and anyone else who wants people to have great experiences with software. Attend one of our
Sphinx 社内勉強会 - forest book
Sphinx について何か話せというお題をもらって紹介してきました。 私自身、Sphinx をちょっと使った程度のレベルなのであんまり突っ込んだ内容ではありません。大体こんな感じの全体像で、こんな拡張ツールがあるよといった紹介をしました。プレゼン資料では分かりませんが、実際にデモで Sphinx のプロジェクトを作って、reST を書きながらビルドするとか、tex ファイルを作ってから pdf をビルドするとか、 $ python setup.py build_sphinx で簡単にパッケージングと連携することもできるとか、私が使ってきた中で知ってることを紹介しました。 興味をもってくれる人がいたら嬉しいなぁ。 Sphinx 社内勉強会 おまけで ikazuchi のデモもしてみた (^ ^;;
Sphinxの国際化機能を使って複数言語用ドキュメントを用意する方法（概要） - 2011-05-31 - ククログ
YARDのことの続きを書きたいと思いつつもなかなか辿りつきません。今回はPython製のドキュメントツールSphinxの話です。groongaのケースを例にしてSphinxで複数言語用のドキュメントを生成する方法の概要を紹介します。書いていたら長くなったので、具体的にどうするかというのは次の機会にします。 5/29にgroonga 1.2.2がリリースされました。今後は日本だけではなく世界でも使ってもらえるように、英語でも情報を発信していく方向になりました。そこで、今回のリリースに合わせてサイトデザインをリニューアルし、英語のページも用意しました。ただし、すでにあった日本語のコンテンツを今回のリリースで全部英語にした、というものではありません。今回のリリースでやったのは「日本語と英語という複数の言語で情報を発信する仕組み」を作るところまでです。せっかくなので、今回のリリースで導入した、Sp
Shibu's Diary: 日本語でSphinxを使う時のストレスを減らす拡張機能
渋日記@shibu.jp 渋川よしきの日記です。ソフトウェア開発とか、ライフハックを中心に記事を書いていきます。 Taken by mismisimos under CC BY-NC-SA Sphinxで日本語を書くときに、日本語の途中で改行を入れると、そこに空欄の文字が入ってしまい、ブラウザで見るときにちょっと見た目が悪くなったりします。まぁ、これはSphinxのせいというよりも、ブラウザのせいですが。 あと、Sphinxというか、docutilsは欧米の言語を対象としている仕様のため、太字にしたり、インラインマークアップを使うときには前後にスペースが必要となります。レンダリング後もこのスペースが残ってしまうため、ブラウザで見るとやはり改行と同じ悪さをします。バックスラッシュというか円記号でエスケープしたスペースを挟めばなんとかなりますが、面倒ですよね？ ということで、軽く作ってみたSp
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
GitHub - sphinx-contrib/redoc: ReDoc powered OpenAPI (fka Swagger) spec renderer for Sphinx.
マスタリング docutils - マークアップ言語愛好会 - BOOTH
Sphinx でドキュメントを作成して GitHub Pages で公開するまで - Qiita