Help us understand the problem. What is going on with this article?

Google Codelabs形式のコンテンツを作ってGitHub Pagesで公開するまで

Google Codelabs形式のコンテンツを作るハンズオン資料をCodelabs形式で作り、GitHub Pagesで公開しました。
ハンズオン
Codelabs形式コンテンツを作るツールの存在はDeNA SWETチームの記事で知りました。

Google Codelabsとは

Googleが公開している様々な実装のガイド、チュートリアル、ハンズオンのコンテンツです。
Google Codelabs
GoogleがこのCodelabs形式のコンテンツを作れるツール、claat(Golang製のCLI) を公開しています。

Codelabs & GitHub Pagesのメリット

Codelab形式のコンテンツをGitHub Pagesで公開するメリットは以下のようなものがあると考えています。

  • コンテンツの体裁が統一される。しかも綺麗。見た目大事
  • masterをpushしたら即公開なので楽
  • GitHubで修正のプルリクを受け付けられる
  • GitHub Enterpriseを利用していると、社内向けなど限定的な公開が簡単にできる

Google Codelabs作成・公開ハンズオン

作成・公開の流れ

作成・公開は次のような手順で行います。
1. Google Docsでドキュメント作成
2. CLIツールのclaatでコンテンツを生成
3. 2.のコンテンツをGitHubにpush
4. GithubのSettings > Github Pagesで公開
具体的な手順はCodelabs形式で書いています。
GitHubリポジトリ

スクリーンショット 2019-10-21 12.33.49.png

最後に

簡単な編集作業で体裁の整った資料が作れるので、これから使っていきたいと思えるツールでした。

Why not register and get more from Qiita?
  1. We will deliver articles that match you
    By following users and tags, you can catch up information on technical fields that you are interested in as a whole
  2. you can read useful information later efficiently
    By "stocking" the articles you like, you can search right away
Comments
No comments
Sign up for free and join this conversation.
If you already have a Qiita account
Why do not you register as a user and use Qiita more conveniently?
You need to log in to use this function. Qiita can be used more conveniently after logging in.
You seem to be reading articles frequently this month. Qiita can be used more conveniently after logging in.
  1. We will deliver articles that match you
    By following users and tags, you can catch up information on technical fields that you are interested in as a whole
  2. you can read useful information later efficiently
    By "stocking" the articles you like, you can search right away
ユーザーは見つかりませんでした