Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
【Marp】ドコでもMarkdownを使って資料を作れる環境を用意してみる。【GitPod】
Search
T4D4
August 07, 2024
Technology
0
36
【Marp】ドコでもMarkdownを使って資料を作れる環境を用意してみる。【GitPod】
Markdownでスライドを作成する為のツールであるMarpとブラウザでお手軽に用意出来る仮想開発環境を提供するGitpodを使いドコでも資料作成を可能にする環境を用意します
T4D4
August 07, 2024
Tweet
Share
Other Decks in Technology
See All in Technology
From LibreOffice to « La Suite » : providing civil servants with Free Software sovereign tools
bluehats
0
120
エンジニアのドメイン知識獲得コストを低減するアプリケーションデザイン
ryo_nagata_
3
140
Deep dive into Nuxt Server Components
wattanx
1
460
AIとともに歩んだライブラリアップデートの道のり/ vue-fes-japan-2024-link-and-motivation
lmi
2
730
暴カワでビデオシンセサイザーを導入する技術
yuchi
2
120
寒冷地稲作の歴史にみるコミュニティ
miu_crescent
2
130
ReSTIRの数理と実装 (rtcamp10)
yumcyawiz
1
450
なぜ Rack を理解すべきかプレトーク / Why should you understand Rack - Pre-talk
hogelog
0
220
いまいまMySQL2024 @ OSC Nagaoka
sakaik
3
280
Vue.js、Nuxtの機能を使い、 大量のコピペコードをリファクタリングする
igayamaguchi
3
840
From naive to advanced RAG: the complete guide
glaforge
0
620
【完全版】Dify - LINE Bot連携 考え方と実用テクニック
uezo
3
860
Featured
See All Featured
"I'm Feeling Lucky" - Building Great Search Experiences for Today's Users (#IAC19)
danielanewman
225
22k
Navigating Team Friction
lara
183
14k
A Tale of Four Properties
chriscoyier
156
22k
How to Create Impact in a Changing Tech Landscape [PerfNow 2023]
tammyeverts
46
2.1k
CSS Pre-Processors: Stylus, Less & Sass
bermonpainter
355
29k
Why Our Code Smells
bkeepers
PRO
334
57k
RailsConf & Balkan Ruby 2019: The Past, Present, and Future of Rails at GitHub
eileencodes
131
33k
[Rails World 2023 - Day 1 Closing Keynote] - The Magic of Rails
eileencodes
31
1.7k
Imperfection Machines: The Place of Print at Facebook
scottboms
264
13k
Helping Users Find Their Own Way: Creating Modern Search Experiences
danielanewman
29
2.2k
The Success of Rails: Ensuring Growth for the Next 100 Years
eileencodes
43
6.5k
4 Signs Your Business is Dying
shpigford
180
21k
Transcript
【Marp】ドコでもMarkdownを使って資料を作れる環 境を用意してみる。 【GitPod】 T4D4
Agenda 自己紹介 前提知識 実際の作業手順
自己紹介 名前: T4D4 X a.k.a Twitter: @T4D4
前提知識 Marpとは? Marpとは、Markdown記法でスライドを作成するためのツールです。 詳細は公式サイトを参照してください。 Gitpodとは? Gitpodとは、GitHub、Gitlab、BitbucketのためのワンクリックオンラインIDE です。 詳細は公式サイトを参照してください。
実際の作業手順 1. 事前準備としてGitHub上で空のリポジトリとGitpodのアカウントを用意します。 Gitpodのアカウントを作成する時、GitHubのアカウントを選択してくださ い。
2. GitpodのworkspaceからNew Workspaceボタンをクリックして新しいワークスペ ースの作成を行います。 新しいワークスペースを作成するページでは、連携させるレポジトリ、使用 するエディター、VMの性能を選択します。 2.1. まず、1番上の項目で連携させるレポジトリを選択します。ここで1番最初の事前 準備の段階で作成したリポジトリを選択します。
2.2. その後、エディターとVMの性能を選択してCreate a Workspaceボタンをクリック します。 VMの性能はお財布などと相談して好きに選択してください。 エディターはドコでも資料を作れる環境という本スライドの趣旨を重視する場合 はVScode・Browserを選択してください。しかし、ブラウザ版では一部の拡張機 能(GitHubCopilot等)が使えない場合があるみたいなので、パソコン上でしか使 わないならお好きなエディターを選択すると良いと思います
3項目の設定の完了後、continueボタンのクリックでワークスペースが作成されま す。
3. 少し待つとブラウザでVScodeライクなUIのエディターがブラウザ上で開かれると 思います。 (デスクトップアプリ版で開きたい場合は左下に下のようなポップアッ プが出てきたらOpenをクリック) エディターが開かれたら、ドコでも開発をできるようにする環境自体は整いま す。あとは、スライドを作成するために必要な環境を整えます。
4. 拡張機能を導入します。 左のサイドバーの下から2番目のアイコンをクリックして拡張機能の検索を行 います。 検索バーに「Marp」と入力して、 「Marp for VS Code」という名前の拡張機 能をインストールします。
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
6. 日本語フォントのインストール ローカルな環境でMarpを使う場合は、日本語フォントが入っていると思います が、gitpodのVMには入っていません。このままでは出力したファイルの日本語が □になってしまい読めないので、日本語フォントをインストールします。 インストールの方法とフリーダウンロード可能な日本語フォントについてこちら の記事が詳しいので参考にしてみてください。 フォントのインストールが完了すればコレでスライドを作成するために必要な環 境のセットアップは完了です。
おまけ 最低限必要な拡張機能として「Marp for VS code」だけをインストールしました。しかし、 VScodeには他にも便利な拡張機能はたくさんあるので、僕が実際にMarpでスライドを作成する 際に使っている拡張機能の一部を紹介します。 GitHub Copilot GitHubの提供するAIです。文章書いてる時にもアシストが働いてくれて便利
です。 Code Spell Checker コード内のスペルミスを検出してくれる拡張機能です。 vscode-textlint、テキスト校正くん テキスト校正くんは、日本語の文章をチェックしてくれる拡張機能です。 vscode-textlintは、文章をルールにしたがってチェックするtextlintというツー ルをvscode上で使う為の拡張機能です。
参考リンク Marp公式サイト Gitpod公式サイト Linux で標準的に使われるフリー日本語フォント GitHub Copilot - Visual Studio
Marketplace Code Spell Checker - Visual Studio Marketplace vscode-textlint - Visual Studio Marketplace テキスト校正くん - Visual Studio Marketplace