tldr pages のインストール:キャッシュ更新、簡易例の読み方、man との使い分け
tldr を入れ、キャッシュを更新し、例と man の使い分けを把握する。
man は網羅的ですが、コピペ用の例だけ欲しいときは重いです。tldr pages はコミュニティの短い例を集め、クライアントの tldr で表示します。本稿は macOS/Linux/Windows のインストール、tldr --update でキャッシュ更新、例の読み方、man/--help との使い分け を hereink 向けにまとめます。
検索語はtldr pages のインストールとキャッシュ更新・コマンド例。tldr を入れ、tldr --update 後に tldr git などが使え、man が必要な場面が分かれば OK です。
導入brew · npm · cargo
キャッシュtldr --update
対照tldr vs man
install--updateexamples
tldr が解くこと
例優先
tldr tar はよく使うアーカイブ例。man tar は全文。
rg と同じターミナル
例をコピーして脚本や API デバッグへ。深い flag 説明は man へ。
ページ:
github.com/tldr-pages/tldr、tldr.sh。Rust クライアントtealdeer(tldrコマンド)。
インストール
- 1macOS
brew install tealdeer、tldr --version。 - 2Linux
pacman -S tealdeerやcargo install tealdeer、またはnpm i -g tldr。 - 3Windows
scoop/choco の tealdeer または npm。
- 4初回
初回クエリまたは
tldr --update。
キャッシュ更新
tldr --update
tldr --list
tldr --info例を読む
tldr tar
tldr git commit
tldr --platform linux curl
tldr -s archivetldr と man
| 目的 | tldr | man |
|---|---|---|
| 定番例 | tldr ffmpeg | 長文 |
| 全オプション | 省略されがち | man 1 tar |
| オフライン | キャッシュ後 | man-db 依存 |
- 向く
- flag 忘却、README、未知サーバー。
- 向かない
- セキュリティ上重要な chmod/iptables 等は man 必読。
tldr と cheat?
cheat は個人/チーム sheet、tldr は共有コーパス。
ページが無い?
tldr --update、それでも無ければ man または tldr-pages へ PR。
tealdeer vs npm?
tealdeer は高速で mac/Linux 定番。PATH は 1 つに。