Slide 1

Slide 1 text

【Marp】ドコでもMarkdownを使って資料を作れる環 境を用意してみる。 【GitPod】 T4D4

Slide 2

Slide 2 text

Agenda 自己紹介 前提知識 実際の作業手順

Slide 3

Slide 3 text

自己紹介 名前: T4D4 X a.k.a Twitter: @T4D4

Slide 4

Slide 4 text

前提知識 Marpとは? Marpとは、Markdown記法でスライドを作成するためのツールです。 詳細は公式サイトを参照してください。 Gitpodとは? Gitpodとは、GitHub、Gitlab、BitbucketのためのワンクリックオンラインIDE です。 詳細は公式サイトを参照してください。

Slide 5

Slide 5 text

実際の作業手順 1. 事前準備としてGitHub上で空のリポジトリとGitpodのアカウントを用意します。 Gitpodのアカウントを作成する時、GitHubのアカウントを選択してくださ い。

Slide 6

Slide 6 text

2. GitpodのworkspaceからNew Workspaceボタンをクリックして新しいワークスペ ースの作成を行います。 新しいワークスペースを作成するページでは、連携させるレポジトリ、使用 するエディター、VMの性能を選択します。 2.1. まず、1番上の項目で連携させるレポジトリを選択します。ここで1番最初の事前 準備の段階で作成したリポジトリを選択します。

Slide 7

Slide 7 text

2.2. その後、エディターとVMの性能を選択してCreate a Workspaceボタンをクリック します。 VMの性能はお財布などと相談して好きに選択してください。 エディターはドコでも資料を作れる環境という本スライドの趣旨を重視する場合 はVScode・Browserを選択してください。しかし、ブラウザ版では一部の拡張機 能(GitHubCopilot等)が使えない場合があるみたいなので、パソコン上でしか使 わないならお好きなエディターを選択すると良いと思います 3項目の設定の完了後、continueボタンのクリックでワークスペースが作成されま す。

Slide 8

Slide 8 text

3. 少し待つとブラウザでVScodeライクなUIのエディターがブラウザ上で開かれると 思います。 (デスクトップアプリ版で開きたい場合は左下に下のようなポップアッ プが出てきたらOpenをクリック) エディターが開かれたら、ドコでも開発をできるようにする環境自体は整いま す。あとは、スライドを作成するために必要な環境を整えます。

Slide 9

Slide 9 text

4. 拡張機能を導入します。 左のサイドバーの下から2番目のアイコンをクリックして拡張機能の検索を行 います。 検索バーに「Marp」と入力して、 「Marp for VS Code」という名前の拡張機 能をインストールします。

Slide 10

Slide 10 text

5. GitpodのVMにChromeをインストールします。 Marpでは、Markdownで書いたスライドをpptxやpdf形式で出力する際にブラウザ を必要とします。どうやらGitpodの方にブラウザが入っていないとダメなような ので、CLIからChromeをインストールします。 インストールコマンド例↓ wget -q -O - https://dl.google.com/linux/linux_signing_key.pub | sudo apt-key add - sudo sh -c 'echo "deb [arch=amd64] http://dl.google.com/linux/chrome/deb/ stable main" >> /etc/apt/sources.list.d/google-chrome.list' sudo apt update sudo apt install google-chrome-stable

Slide 11

Slide 11 text

6. 日本語フォントのインストール ローカルな環境でMarpを使う場合は、日本語フォントが入っていると思います が、gitpodのVMには入っていません。このままでは出力したファイルの日本語が □になってしまい読めないので、日本語フォントをインストールします。 インストールの方法とフリーダウンロード可能な日本語フォントについてこちら の記事が詳しいので参考にしてみてください。 フォントのインストールが完了すればコレでスライドを作成するために必要な環 境のセットアップは完了です。

Slide 12

Slide 12 text

おまけ 最低限必要な拡張機能として「Marp for VS code」だけをインストールしました。しかし、 VScodeには他にも便利な拡張機能はたくさんあるので、僕が実際にMarpでスライドを作成する 際に使っている拡張機能の一部を紹介します。 GitHub Copilot GitHubの提供するAIです。文章書いてる時にもアシストが働いてくれて便利 です。 Code Spell Checker コード内のスペルミスを検出してくれる拡張機能です。 vscode-textlint、テキスト校正くん テキスト校正くんは、日本語の文章をチェックしてくれる拡張機能です。 vscode-textlintは、文章をルールにしたがってチェックするtextlintというツー ルをvscode上で使う為の拡張機能です。

Slide 13

Slide 13 text

参考リンク Marp公式サイト Gitpod公式サイト Linux で標準的に使われるフリー日本語フォント GitHub Copilot - Visual Studio Marketplace Code Spell Checker - Visual Studio Marketplace vscode-textlint - Visual Studio Marketplace テキスト校正くん - Visual Studio Marketplace