ドキュメンテーションツール Sphinx を扱った「Sphinx をはじめよう 第２版」の出版記念のハンズオンです。

対象

「触ってみようと逡巡している人」や「使おうと思ったけどよく分からない」といった方を対象に、インストール、基本的な文法、ビルドについて学ぶことができます。 当該書籍を買ったけどまだ読んでいない方、これから買おうか迷っている方、購入予定がない方でも大歓迎です。

みんなで会場に集まってワイワイと Sphinx を使ってみましょう。

勉強会の進め方/範囲

オライリー・ジャパンから出版された「Sphinx をはじめよう 第２版」を題材に解説を致します。 ハンズオン形式(実際に手を動かしてみる)で進める予定です。 モニタでこれらのページを映しながら話をします。

• Sphinx のインストール
• Sphinx-quickstart を実行する
• HTML を出力してみる
• 基礎的なマークアップを書いて変換してみる
  • セクション
  • 箇条書き
  • 太字、斜体、リンク
  • code-block
  • テーブル
  • 画像
• ドキュメントを構造化する Toctree
• Sphinx リファレンスの読み方
• わからなくなったときの助けの呼び方

講師

@usaturn @jbking

準備して欲しい物

• 各自、Sphinx をインストールしたノートPC(Windows, Mac, UNIX/Linux 等)をお持ちください。(自宅サーバやレンタルサーバへのリモートアクセスも可)

その他

• 無線LANあります