お知らせ 総額50万円分の懇親会費支援キャンペーンを開催中 by Forkwell

このエントリーをはてなブックマークに追加

10月

31

Sphinx ワークショップ@関西(2015/10)

主催 : 日本UNIXユーザ会

ハッシュタグ :#sphinxjp
募集内容

イベントの説明

主催: 日本UNIXユーザ会

申し込み

イベント概要

  • 日時: 2015/10/31(土) 13時〜17時半
  • 場所: ECCコンピュータ専門学校 2号館3F 2303教室
  • 講師: 清水川(@shimizukawa), 安宅(@kk_Ataka)
  • 会費: jus会員 1,000円, 協力団体会員(Sphinx-Users.jp) 1,000円, 一般 2,000円, 学生 1,000円

オープンソースのドキュメンテーションツール、Sphinxを用いたドキュメント作成について紹介します。Sphinxは文章を構造化しやすいため、分かりやすく、美しいドキュメントを簡単に作ることが出来ます。SphinxはHTML, ePub, PDFなどの複数のドキュメント形式を出力し、ドキュメントはreStructuredText(reST)記法で記載します。 「触ってみようと逡巡している人」や「使おうと思ったけどよく分からない」といった方を対象に、基本的な文法、ビルド、についてハンズオン形式で学んでいきます。

用意するもの

  • Sphinxをインストールする環境

  • OSはWindows, Mac, Ubuntu いずれか

  • Pythonをインストールしておいてください(Python2でも3でもOK)
  • Sphinx-1.3以降のインストール

当日の進め方

  • 講師が研修資料を用意し、プロジェクターに研修資料を映しながら説明していきます。
  • 各自手元のPCで入力し実行結果を確認します。 質問は随時回答致します。

タイムテーブル

  • Sphinx概要紹介 30分 ( @shimizukawa)
  • Sphinxデモ30分 (@shimizukawa)
  • Sphinx事例紹介 30分 ( @kk_ataka )
  • 休憩+LT 30分 (LTは募集)
  • ワークショップ 2時間

ワークショップ内容

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

対象者

  • Sphinxでドキュメントを作成したい方。
  • ドキュメントを楽しく作りたい方。
  • 既にSphinxを使っているけれど、わからないことがある方
  • ロジカルなドキュメントを書きたい方

参加者へのお願い

  • 事前に Sphinx のインストールをお願いします。インストール方法は http://sphinx-users.jp/gettingstarted/index.html に掲載されています。
  • インストールをしていない方向けの説明も行いますが、インストールが済んでいるとハンズオンで実践できる内容が多くなります。
  • 既にSphinxを使っている方は、わからないことや困っていることなどをまとめておくと、当日質問しやすいかと思います。

参考資料

発表者

資料 資料をもっと見る/編集する

フィード

shimizukawa

shimizukawaさんが資料をアップしました。

2015/11/25 23:06

shimizukawa

shimizukawaさんが資料をアップしました。

2015/11/25 23:06

shimizukawa

shimizukawa さんが書き込みました。

2015/10/31 18:01

ワークショップ終わりました。参加された皆さん、お疲れ様でした!

shimizukawa

shimizukawa さんが書き込みました。

2015/10/31 12:50

Sphinxハンズオン、13時からですー

shimizukawa

shimizukawa さんが書き込みました。

2015/10/31 10:50

名古屋駅まできた。今日はSphinx ワークショップ@関西!

shimizukawa

shimizukawa さんが Sphinx ワークショップ@関西(2015/10) を公開しました。

2015/10/26 17:38

Sphinx ワークショップ@関西(2015/10) has been published!

グループ

Sphinx-users.jp

ドキュメントを書きたくなる魔法のツールSphinx

イベント数 116回

メンバー数 433人

終了

2015/10/31(土)

13:00
17:30

募集期間
2015/10/26(月) 17:38 〜
2015/10/31(土) 17:30

会場

ECCコンピュータ専門学校 2号館3F 2303教室

大阪市北区中崎西2丁目3番35号

ECCコンピュータ専門学校 2号館3F 2303教室

管理者