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
技術ブログをCLI管理する
Search
m-narin
May 29, 2024
Programming
0
84
技術ブログをCLI管理する
技術ブログ2大巨頭であるQiitaとZennに関して、CLI管理する方法とメリットについて述べます。
m-narin
May 29, 2024
Tweet
Share
More Decks by m-narin
See All by m-narin
プロになるためのWeb技術入門
narin0520
0
23
転職後のキャッチアップで工夫したこと
narin0520
0
480
技術ブログのすゝめ
narin0520
0
22
新卒研修振り返り
narin0520
1
100
Other Decks in Programming
See All in Programming
Enterprise Web App. Development (2): Version Control Tool Training Ver. 5.1
knakagawa
1
120
Create a website using Spatial Web
akkeylab
0
310
地方に住むエンジニアの残酷な現実とキャリア論
ichimichi
5
1.4k
「Cursor/Devin全社導入の理想と現実」のその後
saitoryc
0
270
VS Code Update for GitHub Copilot
74th
1
420
プロダクト志向ってなんなんだろうね
righttouch
PRO
0
160
なんとなくわかった気になるブロックテーマ入門/contents.nagoya 2025 6.28
chiilog
1
230
AIエージェントはこう育てる - GitHub Copilot Agentとチームの共進化サイクル
koboriakira
0
450
今ならAmazon ECSのサービス間通信をどう選ぶか / Selection of ECS Interservice Communication 2025
tkikuc
20
3.7k
Go1.25からのGOMAXPROCS
kuro_kurorrr
1
810
なぜ適用するか、移行して理解するClean Architecture 〜構造を超えて設計を継承する〜 / Why Apply, Migrate and Understand Clean Architecture - Inherit Design Beyond Structure
seike460
PRO
1
700
なぜ「共通化」を考え、失敗を繰り返すのか
rinchoku
1
570
Featured
See All Featured
Agile that works and the tools we love
rasmusluckow
329
21k
RailsConf 2023
tenderlove
30
1.1k
Product Roadmaps are Hard
iamctodd
PRO
54
11k
RailsConf & Balkan Ruby 2019: The Past, Present, and Future of Rails at GitHub
eileencodes
138
34k
Dealing with People You Can't Stand - Big Design 2015
cassininazir
367
26k
Making the Leap to Tech Lead
cromwellryan
134
9.3k
The Web Performance Landscape in 2024 [PerfNow 2024]
tammyeverts
8
670
Measuring & Analyzing Core Web Vitals
bluesmoon
7
490
Faster Mobile Websites
deanohume
307
31k
[Rails World 2023 - Day 1 Closing Keynote] - The Magic of Rails
eileencodes
35
2.4k
Building an army of robots
kneath
306
45k
Why You Should Never Use an ORM
jnunemaker
PRO
57
9.4k
Transcript
技術ブログをCLI管理する 開発3部 那仁満徳 2024.01.25 - Tech Talk 1
年末年始暇だなぁ〜何しようかな そうだ!技術ブログをCLI管理してみよう!💡
アジェンダ きっかけ 01 始め方・使い方 02 やってみて 03 最後に 04
4 そもそも技術ブログをCLI管理するってどういうこと? • 2023年までは、Web GUI上で執筆していた。一般的な方法?
5 そもそも技術ブログをCLI管理するってどういうこと? • 記事を手元のmdファイルで管理する • CLIで記事を投稿、更新する
6 そもそも技術ブログをCLI管理するってどういうこと? • 記事をCLIで管理することによってたくさんのメリットが生まれる✨ ◦ GUIで編集するのは面倒 ▪ 編集画面に辿り着くまでは億劫 ▪ 一括編集ができない
▪ 誤って編集データが消えるリスクがある ◦ オフラインでもローカルサーバーでプレビューを見ながら記事を書ける ◦ GitHubと連携して、CIから記事の自動デプロイができる ◦ 特定の媒体に依存せずに言語化資産を持てる ◦ 記事の移行や文章の使い回しが楽
7 年末の自分の状況は、、、 • 元々Qiitaで30本くらい記事を書いていた • X(Twitter)でブログはCLI管理すると良いよとの投稿を見る • たくさんのメリットがあることを知り、CLI化を決意 ◦ ついでにQiita記事の何本かをZennに移行してみよう
8 この発表では • QiitaとZennにはそれぞれCLIで管理できる仕組みがあることを知る • 触ってみてどうだったかの紹介 ◦ すでに記事を書いている人やこれからブログを始めたい人向け🙌 ◦ (すでにCLI管理しているよ〜という方は退屈かも🥺)
• Qiita CLIは2023年8月にリリース • Zenn CLIは、Zennがリリースされた2020年9月リリース当初からあるっぽい
Qiita CLIの使い方 1. 基本的には公式の説明に添えば良い a. TokenでQiitaアカウントと紐付け b. npx qiita pullでQiitaアカウントとローカルを同期
c. ローカルサーバーでPreview機能がある d. 差分を自動検知する仕組みがある(後述) e. 新記事や編集分の反映はpush時にGitHub Actions が自動でやってくれる ▪ 記事の変更が無かったら何もしない f. 安全のため削除機能は無い https://github.com/increments/qiita-cli
Qiita CLIの差分の取り方 • 差分はファイル中に書かれるメタ情報のidで見ている ◦ idが無かったら新記事をpush ◦ 既存IDの中身が変わっていたら編集をpush ◦ ファイル名は関係ないので自由に編集OK
※GitHub Actions実行後に、メタ情報のidが書き込まれるのでgit pullする必要がある。
Zenn CLIの使い方 1. 基本的には公式の説明に添えば良い a. GitHubアカウントとZennのアカウントを紐付け b. ローカルサーバーでPreview機能がある c. 差分を自動検知する仕組みがある(後述)
d. 新記事や編集分の反映はpush時にGitHub Actions が自動でやってくれる ▪ 記事の変更が無かったら何もしない e. 安全のため削除機能は無い https://zenn.dev/zenn/articles/zenn-cli-guide
Zenn CLIの差分の取り方 • 差分はslug(ファイル名にも紐づいている)で見ている ◦ 新しいファイル名の記事がある場合は新記事をpush ◦ 既存のファイル名の記事の中身が変わっていたら編集分をpush ※ファイル名を変更すると別記事として投稿されてしまうので注意
Qiita CLI vs Zenn CLI • Preview画面
Qiita CLI vs Zenn CLI • 差分の取り方 ◦ Qiitaはメタ情報中のIDで管理 ▪
記事投稿後、同期のためgit pullする必要がある ◦ Zennはファイル名で管理 ▪ ファイル名を書き換えられない(並べ替えなどができない)
Qiita CLI vs Zenn CLI • その他の特徴 ◦ 共通点 ▪
画像はURLベタ貼り。どちらも画像アップロード機能がある ◦ Zenn特有 ▪ updated_atを過去の日付で投稿できる • 記事移行を想定している ▪ 本形式の投稿もできる ▪ 収益化がある
Qiita CLI vs Zenn CLI • 運営元 ◦ Qiita ▪
2011年に大学生だった海野弘成さんが開発 ▪ 2017年にエイチームが買収 • 名古屋にあるスマホやインターネットコンテンツを作っている会社 ◦ Zenn ▪ 2020年にcatnoseさんが開発 ▪ 2021年にクラスメソッドが買収 • クラスメソッドは言わずもがな、techブログが有名
CLI化(記事のコード管理化)してみて • 記事管理がめちゃめちゃ楽になった ◦ 下書きとかを書き溜めておいて、好きなタイミングで公開できる ◦ 複数の記事を一括編集できる ◦ エディターのgptプラグインと併せると至高の執筆体験 •
記事の移行などもすぐ終わる • 同じ記事を両方に公開できる ◦ 例えば比較してみたり
CLI化してみて • 同じ内容の新記事を(ほぼ)同時公開してみた
CLI化してみて • 同じ内容の新記事を(ほぼ)同時公開してみて1ヶ月経った結果 項目 Qiita Zenn PV数 840 124 いいね数
4 5 いいね/PV 0.5% 4% • PV数はQiitaの方が8倍多いが、いいね数は同じくらい • 一般的に言われているのは ◦ QiitaはSEOが強いのでライト層も多いということ
20 • 技術的に新規性、有用性に拘らなくても書くこと自体にメリットがある。プライドを 捨てて今日から書く。小さな成功体験を✨ ◦ 日々考えたことなどの思考がまとまる ◦ ドキュメント力が上がる ◦ 話せるネタが溜まっていく
▪ 思考跡を言語化した資産を増やす ▪ 技術記事はエンジニアとしての資産になる • 巡り巡った機会、振り返って見て新たな発見 • 技術だけでなくアイデアやポエム的な記事も専用のタグがある 技術ブログ仲間増やしたい
CLIで極上の執筆体験を今日から味わってみませんか?