静的サイトジェネレーター勉強会
イベント内容
静的サイトジェネレーターハンズオン
静的サイトジェネレーターとは、完全に静的なHTML Webサイトを生成するツールのことです。
世の中には数限りなく静的サイトジェネレーターが存在しますが、今回はその中からチューターが選んだ4つジェネレーターのハンズオンを行います。
どれかに興味がある方、もしくは初めて静的サイトジェネレーターを使って見る方向けのイベントです。
各ジェネレーターにそれぞれ事前準備があります。ご用意の上ご参加ください。
質問などございましたら遠慮なく、このページの下にあるフィードもしくはイベントへのお問い合わせへご連絡ください。
対象とする参加者
ハンズオンという、実際に手を動かして作業する都合上、次の要項について参加者が理解しているという前提で進めます。これらの要項について不案内ですとハンズオンの内容を難しく感じるかもしれません。
- git または github を使える
- ターミナル上で簡単なコマンドライン操作ができる
- ターミナル上でコマンドラインからディレクトリ移動やファイルの操作ができる
- markdown 記法で文章を書ける
ラインナップ
Quarto
(kozo2)
紹介
Quartoは科学的および技術的コミュニケーションのためのドキュメント形式 (Jupyter Notebook, Quarto Markdown)を、静的サイトを含む様々なフォーマットにコンバートするツールキットです。 コード、数式、図表、参考文献などを含むクロスリファレンスが必要となる文書を容易に作成することができ、 学術出版やデータ分析レポートなどに適しています。
事前準備
- 以下2つをご用意ください
- Github account
- Quarto install : https://quarto.org/docs/get-started/
Hugo
(もりもと)
紹介
Hugo は Go 言語で実装された高速な静的サイトジェネレーターです。2013年に最初のリリースが行われ、いまも活発に開発されています。とても人気のあるツールで多くの利用者がいて、十分に成熟したツールと言えます。Hugo のテーマは Hugo Themes で公開されており、これらのテーマを選択することで外観を簡単にカスタマイズできます。Hugo は、ブログ、企業サイト、ポートフォリオサイト、ドキュメンテーション、単一のランディングページなどでもよく使われています。
事前準備
次のドキュメントを参考に Hugo を自分のマシンにインストールしておいてください。
GitHub アカウントがある方は、ハンズオン資料を Hugo で作成した次のリポジトリをクローンしておくと参考になると思います。
Sphinx
(どりらん)
紹介
SphinxはテキストからHTMLやLaTeX(PDF)、ePubなどのドキュメントに出力するツールです。豊富な拡張機能が提供されており、APIドキュメントの自動作成など、技術者向けのマニュアル作成などに適しています。
事前準備
- 以下2つをご用意ください
- Github account
- Read the Docs account (GitHub accountと連携可)
- Python環境または、Google account + ngrok account
Slate
(しんせいたろう)
紹介
Slateは、APIドキュメントを作成する静的サイトジェネレーターです。画面が二分割され、左側にはドキュメント、右側にはコードや返り値などが表示される、直感的に読みやすいデザインが特徴のジェネレーターです。
事前準備
- 以下2つをご用意ください
- Github account
- Docker install : https://docs.docker.com/engine/install/
ホスティング
- Github pages (しんせいたろう)
- Netlify (どりらん)
タイムテーブル
項目 | 時間 |
---|---|
12:45 - | 開場 |
13:00 - | オープニング |
13:10 - 13:40 | Quarto |
13:40 - 14:10 | Hugo |
14:10 - 14:30 | 休憩、時間調整 |
14:30 - 15:00 | Sphinx |
15:00 - 15:30 | Slate、時間調整 |
16:00 - | クロージング、懇親会(会場にて希望者のみ、会費制) |
※スケジュールは前後する可能性があります
【懇親会】
会の終了後、会場で懇親会を行います。
食べ物だけ会費制で、飲み物は会場のCo-Creation Lab.さんから各自購入してもらう形になります。
- 食べ物(会費)は、Paypayか現金
- 飲み物は、現金のみ (お釣りが出ないようにご協力お願いします)
です。飲み物メニューは以下の通りです。
- ビール 250円
- 酎ハイ発泡酒 150円
- ソフトドリンク 60円〜150円
会場
Co-Creation Lab.
東京都千代田区平河町1-4-3 (平河町伏見ビル 2F)
今回はeLVさんに会場提供などのご協力を頂いております。ありがとうございます!!
免責事項
- ハンズオンの内容は予告なく変更することがあります
- すべてのご質問には対応できない場合があります
注意事項
※ 掲載タイミングや更新頻度によっては、情報提供元ページの内容と差異が発生しますので予めご了承ください。
※ 最新情報の確認や参加申込手続き、イベントに関するお問い合わせ等は情報提供元ページにてお願いします。
新規会員登録
このイベントに申し込むには会員登録が必要です。
アカウント登録済みの方はログインしてください。
※ ソーシャルアカウントで登録するとログインが簡単に行えます。
※ 連携したソーシャルアカウントは、会員登録完了後にいつでも変更できます。