静的サイトジェネレーターハンズオン

静的サイトジェネレーターとは、完全に静的なHTML Webサイトを生成するツールのことです。

世の中には数限りなく静的サイトジェネレーターが存在しますが、今回はその中からチューターが選んだ４つジェネレーターのハンズオンを行います。

どれかに興味がある方、もしくは初めて静的サイトジェネレーターを使って見る方向けのイベントです。

各ジェネレーターにそれぞれ事前準備があります。ご用意の上ご参加ください。

質問などございましたら遠慮なく、このページの下にあるフィードもしくはイベントへのお問い合わせへご連絡ください。

対象とする参加者

ハンズオンという、実際に手を動かして作業する都合上、次の要項について参加者が理解しているという前提で進めます。これらの要項について不案内ですとハンズオンの内容を難しく感じるかもしれません。

• git または github を使える
• ターミナル上で簡単なコマンドライン操作ができる
• ターミナル上でコマンドラインからディレクトリ移動やファイルの操作ができる
• markdown 記法で文章を書ける
  • 【超入門】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 を自分のマシンにインストールしておいてください。

• 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ドキュメントを作成する静的サイトジェネレーターです。画面が二分割され、左側にはドキュメント、右側にはコードや返り値などが表示される、直感的に読みやすいデザインが特徴のジェネレーターです。

事前準備

• 以下２つをご用意ください
  • Github account
  • Docker install : https://docs.docker.com/engine/install/

ホスティング

• Github pages (しんせいたろう)
• Netlify (どりらん)

タイムテーブル

※スケジュールは前後する可能性があります

【懇親会】

会の終了後、会場で懇親会を行います。

食べ物だけ会費制で、飲み物は会場のCo-Creation Lab.さんから各自購入してもらう形になります。

• 食べ物（会費）は、Paypayか現金
• 飲み物は、現金のみ （お釣りが出ないようにご協力お願いします）

です。飲み物メニューは以下の通りです。

• ビール　250円
• 酎ハイ発泡酒 150円
• ソフトドリンク　60円〜150円

会場

Co-Creation Lab.

東京都千代田区平河町1-4-3 (平河町伏見ビル 2F)

https://maps.google.com/maps?ll=35.682793,139.73904&z=16&t=m&hl=ja&gl=US&mapclient=embed&cid=12485723182210944057

今回はeLVさんに会場提供などのご協力を頂いております。ありがとうございます！！

免責事項

• ハンズオンの内容は予告なく変更することがあります
• すべてのご質問には対応できない場合があります