ドキュメント
設定
⌘, の向こうにあるすべて——タブは 4 つです。ふるまいの「一般」、 PullMark の見た目の「外観」、キーマップの「キーボード」、そしてまだ 落ち着ききっていない機能の「実験的機能」。ウィンドウは、最後に使ったタブで 開き直します。
一般
PullMark(0.28.1 以降)が入っている Mac でこれを読んでいますか?「一般」タブを開く。
読む
| 設定 | 選択肢 ・ デフォルト | はたらき |
|---|---|---|
| 前回のセッションのファイルとプルリクエストを復元する | on/off — on | PullMark を最後に終了したとき、サイドバーにあったものを開き直します——ファイル、 フォルダ、PR、ブラウズ中のリポジトリ、そしてプレビューの項目も(プレビューのまま)。 |
| 隠しファイルを表示 | on/off — off | 「場所」の中のドットファイルと隠しフォルダ——.github/ のドキュメントや
その仲間たち。⇧⌘.(Finder と同じ組み合わせ)や 表示 →「隠しファイルを表示」でも
切り替えられ、切り替えるたびに開いているすべての「場所」が再スキャンされます。 |
| GitHub の Markdown リンク | 最初のクリックで確認 ・ PullMark で開く ・ ブラウザで開く — 最初のクリックで確認 | GitHub 上の Markdown ファイルへのリンクをクリックしたときの動作です。⌘ を押しながら クリックすれば、もう一方のふるまいになります。最初のクリックで出るダイアログの 「選択を記憶する」チェックボックスが、この設定を代わりに決めてくれます。 |
| 「場所」内のファイルをクリックしたとき | プレビュー優先 ・ 完全に開く — プレビュー優先 | 「プレビュー優先」は、クリック 1 回でファイルを見せながら、手元には残しません——斜体の 1 行(「開いているファイル」、またはその GitHub リポジトリの下)が、次のプレビューで入れ替わります。 ダブルクリックか、編集を始めれば残ります。「完全に開く」はクリックしたファイルをすべて 残します。ローカルフォルダにも、ブラウズ中の GitHub リポジトリにも同じように働きます。 プレビューを参照。 |
レビューする
| 設定 | 選択肢 ・ デフォルト | はたらき |
|---|---|---|
| 差分の初期レイアウト | インライン ・ 並べて表示 — インライン | PR のレンダリングされた差分をどう開くか。ファイルごとに ⌥⌘L で切り替えられます。 |
| サイドバーにレビューリクエストを表示する | on/off — on | 「レビューリクエスト」のサブグループ——あなたのレビューが求められているオープンな PR です。 サインインしていないときは、どちらにせよ現れません。 |
| Markdown を変更するリクエストのみ | on/off — on | Markdown ファイルを含まないレビューリクエストを隠します——PullMark に見せられるものが 何もないからです。 |
| PR の概要にレビューの議論を表示する | on/off — on | 概要の会話の中に、インラインのレビュースレッドをそのレビューの下へネストして 表示します——PullMark がレンダリングしないファイルのものも含めてすべてのスレッドを、 コメントされた箇所を添えて。オフにすると、判定とコメントだけになります。0.34 で 実験的機能から卒業しました。 |
GitHub
| 設定 | はたらき |
|---|---|
| 接続 | PullMark が GitHub と話せるかどうか、誰として、どの認証情報を通じてか
(「you として接続済み · GitHub CLI」)。「再確認」 は認証情報を
読み直します——gh auth login のあとなら、再起動なしでつながります——
「設定…」 はこの Mac に足りないものを見つけ出すウォークスルーを開きます。
認証情報のいきさつはGitHub への
アクセスにすべて書きました。 |
アップデート
| 設定 | はたらき |
|---|---|
| アップデート後に「新機能」を表示する | オン(デフォルト)なら、アップデートが届いたあとにリリースノートを差し出します。 オフなら「PullMark X にアップデートしました」という控えめなバナーに変わり、ノートはワンクリック 先に——アップデートは、どのみち何らかの形で自分から名乗ります。 |
| アップデート | 思い立ったときの 「アップデートを確認…」。PullMark は起動時と、 ときどき自分でも確認します。すでにアップデートを把握しているときは、その行に 「新機能」、「今すぐアップデート」、そして再確認のボタンが そろって並びます。「新機能」は、あなたのバージョンと新しいバージョンのあいだにある すべてのリリースのノートを見せ、ヘルプ →「リリースノート」 には いつでも全履歴があります。 |
システム
| 設定 | はたらき |
|---|---|
| Markdown のデフォルトアプリ | いま .md ファイルを開いているのがどのアプリかを示します。
「PullMark をデフォルトにする」 なら、ワンクリックで関連付けを引き受けます。
のちのアップグレードで macOS がそれを手放しても、PullMark は気づいて取り返しを
申し出ます。 |
| コマンドライン | DMG でインストールした場合に、pullmark
コマンドを /usr/local/bin に入れます(Homebrew ユーザーはすでに
持っています)。PATH 上にすでに pullmark があるときは、チェックマークが
付きます。 |
| Quick Look のプレビュー | 「レンダリング」(デフォルト)か「生ソース」か——Finder で Markdown ファイルにスペースキーを 押したとき、何が出るかです。 |
外観
PullMark(0.28.1 以降)が入っている Mac でこれを読んでいますか?「外観」タブを開く。
いちばん上に ライト・ダーク・システム の切り替えがあり、アプリ全体が——ウィンドウの装いも、 レンダリングされたページも——それに従います(テーマはそれぞれ、自前のライトとダークの姿を 持っています)。その下に、見た目の選択肢が並びます。
ここでの選択はどれもカードになっていて、本物のパイプラインを通したライブプレビューが 載っています——見えているものが、そのまま文書に届きます。
テーマ ↗
| テーマ | 姿 |
|---|---|
| GitHub (デフォルト) | github.com とまったく同じ、おなじみの姿。 |
| Editorial | 温かみのある紙に、本のようなセリフ体の見出し。 |
| Terminal | 等幅、そして蛍光グリーンのアクセント。 |
カスタムテーマ: Themes フォルダ(このタブのボタンから開けます)に
.css ファイルを入れると、カードとして現れます。GitHub の姿の上に重ねて適用され、
Light/Dark の外観に従い、差分の装いも変えます。Quick Look のプレビューもテーマに従います
(そこではカスタムテーマは、土台の GitHub にフォールバックします)。
本文幅 ↗
| 選択肢 | 意味 |
|---|---|
| Standard (デフォルト) | 本のような、古典的な読みやすい行長。 |
| Wide | 行は長く、画面に載る量も増えます——それでも行長には上限があります。 |
| Full Width | テキストがウィンドウいっぱいに広がります——フルスクリーンで重宝します。 |
どこにでも、その場で効き、テーマ・blame・差分・ズームと素直に組み合わさります。読んでいる 途中でも 表示 →「本文幅」から切り替えられます。
行番号 ↗
| 選択肢 | 意味 |
|---|---|
| 非表示 (デフォルト) | すっきりした余白。番号が要るときは「ソース」ビューで。 |
| 表示中 | レンダリングされた文書と差分の余白に、各ブロックの開始ソース行を 表示します——番号にホバーすれば、そのブロックの範囲がまるごと分かります。番号は表示行 ごとではなく、ブロックごとです(レンダリングされたテキストは自由に折り返すので)。 生ソースのビューは、つねに自前の行番号を表示します。 |
キーボード
PullMark(0.28.1 以降)が入っている Mac でこれを読んでいますか?「キーボード」タブを開く。
メニューにあるアクションのショートカットは、どれも割り当て直せます——全体像と、記録・衝突・ 「デフォルトに戻す」の仕組みはキーボードショートカットに。
実験的機能
PullMark(0.28.1 以降)が入っている Mac でこれを読んでいますか?「実験的機能」タブを開く。
設計が固まる前に出荷される機能たちです。それぞれ beta か alpha のラベルをまとい、それが何を約束するのかは レベルの取り決めで説明しています。アルファの機能は 「アルファ機能を表示」 をオンにするまで隠れており(先にダイアログがアルファの 条件を説明します)、機能にはそれぞれ個別の有効化スイッチがあります。 マージンノートが住んでいるのもここです ——0.35 からベータで、デフォルトで有効。専用の有効化スイッチ、署名の設定、そして エージェント向け指示スニペットの「コピー」ボタンが並び、はじめて使うときには機能の紹介と、 オフにする選択肢が示されます。
どこに保存されるのか
設定はすべて app.pullmark.PullMark の defaults ドメインに置かれます。
セッション、読書位置、下書きはメタデータだけ——PullMark があなたの文書をどこかへコピーする
ことはなく、GitHub から取得した内容はメモリ内にとどまります。