保存したテキスト変換

変換（transformation）は、一度保存しておいて自分のタイミングで適用する、小さな検索・置換ルールのまとまりです。貼り付けた文章を整える、リストを並べ替える、行末のスペースを取り除く、ひとかたまりをコードフェンスで囲む、といったことができます。フォーマットメニューから選び、何が変わるかを確かめてから決められます。

設定には、それが何であるかがそのまま書かれています。「保存した検索・置換のルールと、いくつかの組み込みのテキスト操作です。スクリプトではありません。Varligがそのためにシェルコマンド、プラグイン、ネットワークリクエストを実行することはなく、読み込み、ペースト、ノートを開いたときなどに自動で適用することもありません。「フォーマット」▸「変換」から選び、適用する前に変更内容を確認できます。」

置き場所

リストがあるのは 設定 › エディター › テキスト変換 で、最初は空です。1つも追加していないうちは、フォーマット › 変換 には 変換なし と表示され、どこでも何も実行されません。

変換を追加 を押すと、変換 という名前で 検索と置き換え のルールを1つ持った変換ができます。変換には次の項目があります。

リストの各行には、複製するボタンと削除するボタンもあります。

名前がない、ルールがない、パターンがコンパイルできない、といった未完成の変換は、設定に理由とともに表示され、直すまで フォーマット › 変換 には並びません。

保存したテキスト変換はMac、iPhone、iPadの間でiCloud同期されます。Macでは iCloudでノートを同期 をオンにしてください。各デバイスの環境設定にコピーを保持するため、オフラインでも使えます。ノートの書き出しやライブラリのバックアップには含まれません。

ルール

ルールは上から順に、前のルールの結果に対して実行されます。条件分岐はありません。

ルールは値の並びであって、コードではありません。正規表現は 編集 › 検索と置き換え（詳細）… と同じエンジンでコンパイルされて検査され、コンパイルできないパターンは適用する前に設定で指摘されます。

変換を適用する

Macでは フォーマット › 変換 › name、iPhoneとiPadではエディターの 変換 メニューから実行します。変換にはキーボードショートカットがなく、ノートを開くとき、読み込み時、貼り付け時、バックグラウンドで自動実行されることもありません。

適用範囲 が 選択範囲 なら、先に文章を選択します。ノート全体 なら、ノート全体が対象です。

Varligはコピーの上でルールを実行し、4行を削除 と 4行を挿入 を並べたプレビューのシートを表示します。一覧は実際に違いのある部分だけに絞られ、それぞれ40行までで、それより多いときはその旨が添えられます。フッターには「適用は1回の操作で取り消せます。「適用」を押すまで何も変更されません。」と書かれています。キャンセル ならノートはそのまま、適用 なら変更が適用され、編集 › 取り消す（⌘Z）で1回の操作として元に戻せる1つの編集になります。

プレビューを作ったあとにノートが変わっていた場合、Applyは新しい文章に上書きせず、実行し直すように求めます。

変換が実行されないとき

失敗したときはどの場合も、ノートは元のままです。変換が途中まで適用されることはありません。それぞれ、何も変えずに何が起きたかを伝えます。

• 「変換は、保護されたノート、読み出し専用のノート、ゴミ箱内のノートでは実行されません。」読み出し専用のライブラリでも同じです。
• 「More than 10,000 matches in one rule. Narrow the transformation.」
• 「変換に時間がかかりすぎました。ルールを単純にするか、範囲を狭めてください。」
• 「この変換では、ここで変わるものはありません。」
• パターンが不正なルール、キャプチャグループが見つからないルール、検索する文字列のないルール、名前やルールのない変換、何も選択せずに実行した 選択範囲 の変換。それぞれメッセージの中で名指しされます。

制限

複数のノートをまとめて試す方法はありません。多くのノートを一度に変えるには 編集 › ノート全体で置き換え… を使ってください。こちらはノートごとに変更をプレビューします。

変換が書き出すのは普通のMarkdownだけなので、Varligにしか通じないものが残ることはなく、ほかのエディターでもVarligが保存したとおりに見えます。