1
1
# Qiita CLI、Qiita Preview へようこそ!
2
2
3
- Qiita CLI とは、手元の環境で記事の執筆・プレビュー・投稿ができるツールです。
3
+ Qiita CLI とは、手元の環境で記事の執筆・プレビュー・投稿ができるツールです。
4
4
Qiita CLI を使うことで、普段お使いのエディタなどを使って記事の執筆・投稿がしやすくなります。
5
5
6
6
- よくあるお問い合わせ等を記載しております→[ FAQ] ( #FAQ )
@@ -10,7 +10,7 @@ Qiita CLI を使うことで、普段お使いのエディタなどを使って
10
10
11
11
Qiita CLI、Qiita Preview を利用されたら、[ 利用規約] ( https://qiita.com/terms ) 、[ プライバシーポリシー] ( https://qiita.com/privacy ) に同意したものとみなします。
12
12
13
- [ コミュニティガイドライン] ( https://help.qiita.com/ja/articles/qiita-community-guideline ) をご確認ください。
13
+ [ コミュニティガイドライン] ( https://help.qiita.com/ja/articles/qiita-community-guideline ) をご確認ください。
14
14
みんながより良い体験をするためのマナーについて書かれています。
15
15
16
16
また、記事を書く上で意識すると望ましいもの、気をつけるべき点を[ 良い記事を書くためのガイドライン] ( https://help.qiita.com/ja/articles/qiita-article-guideline ) にまとめています。
@@ -89,19 +89,19 @@ Hi ユーザー名!
89
89
90
90
## Qiita Preview の起動(プレビュー画面の表示)
91
91
92
- 本文の執筆は、ブラウザでプレビューしながら確認できます。ブラウザでプレビューするためには以下のコマンドを実行します。
92
+ 本文の執筆は、ブラウザでプレビューしながら確認できます。ブラウザでプレビューするためには以下のコマンドを実行します。
93
93
コマンド実行時に、Qiita に投稿している記事がダウンロードされます。
94
94
95
95
``` console
96
96
npx qiita preview
97
97
```
98
98
99
- コマンド実行すると、Qiita Preview(プレビュー画面)にアクセスすることが可能になります。
99
+ コマンド実行すると、Qiita Preview(プレビュー画面)にアクセスすることが可能になります。
100
100
プレビュー画面のデフォルトの URL は http://localhost:8888 です。
101
101
102
102
### 記事ファイルの配置について
103
103
104
- 1 つの記事の内容は、1 つの markdown ファイル(◯◯.md)で管理します。
104
+ 1 つの記事の内容は、1 つの markdown ファイル(◯◯.md)で管理します。
105
105
記事ファイルは` public ` ディレクトリ内に含める必要があります。
106
106
107
107
``` console
@@ -144,7 +144,7 @@ ignorePublish: false # true: `publish`コマンドにおいて無視されます
144
144
# new article body
145
145
```
146
146
147
- ファイルの上部には` --- ` に挟まれる形で記事の設定(Front Matter)が含まれています。
147
+ ファイルの上部には` --- ` に挟まれる形で記事の設定(Front Matter)が含まれています。
148
148
ここに記事のタイトル(title)やタグ(tags)などを yaml 形式で指定します。
149
149
150
150
### 記事の投稿・更新
@@ -171,7 +171,7 @@ npx qiita publish 記事ファイルのベース名 -f
171
171
172
172
### 記事の削除
173
173
174
- Qiita CLI、Qiita Preview から記事の削除はできません。
174
+ Qiita CLI、Qiita Preview から記事の削除はできません。
175
175
` public ` ディレクトリから markdown ファイルを削除しても Qiita 上では削除はされません。
176
176
177
177
[ Qiita] ( https://qiita.com ) 上で記事の削除を行なえます。
@@ -186,7 +186,7 @@ Qiita CLI、Qiita Preview から記事の削除はできません。
186
186
1 . https://github.com/[ユーザー名 ] /[ リポジトリ名] /settings/secrets/actions から、シークレットに` QIITA_TOKEN ` という名前で発行した Qiita のトークンを保存します。
187
187
1 . qiita init を実行したディレクトリ全体を作成したリポジトリにプッシュします。
188
188
189
- デフォルトは` main ` または` master ` ブランチにコミットがあった場合、自動で Qiita へ記事の投稿・更新がされます。
189
+ デフォルトは` main ` または` master ` ブランチにコミットがあった場合、自動で Qiita へ記事の投稿・更新がされます。
190
190
処理の実行の条件は` .github/workflows/publish.yml ` から変更することが可能です。
191
191
192
192
## Qiita CLI のコマンド、オプションについて
@@ -201,7 +201,7 @@ npx qiita help
201
201
202
202
### pull
203
203
204
- 記事ファイルを Qiita と同期します。
204
+ 記事ファイルを Qiita と同期します。
205
205
Qiita 上で更新を行い、手元で変更を行っていない記事ファイルのみ同期されます。
206
206
207
207
``` console
@@ -226,8 +226,8 @@ npx qiita version
226
226
227
227
## ユーザー設定ファイルについて
228
228
229
- ` npx qiita init ` コマンドで生成される` qiita.config.json ` について説明します。
230
- このファイルを用いて、Qiita CLI の設定を行うことができます。
229
+ ` npx qiita init ` コマンドで生成される` qiita.config.json ` について説明します。
230
+ このファイルを用いて、Qiita CLI の設定を行うことができます。
231
231
設定できるオプションは以下の通りです。
232
232
233
233
- includePrivate: 限定共有記事を含めるかどうかを選べます。デフォルトは` false ` です。
@@ -261,7 +261,7 @@ npx qiita preview --config ./my_conf/
261
261
262
262
### --root \< root_dir>
263
263
264
- 記事ファイルがダウンロードされるディレクトリを指定できます。
264
+ 記事ファイルがダウンロードされるディレクトリを指定できます。
265
265
デフォルトでは、カレントディレクトリになります。
266
266
267
267
例)
0 commit comments