prh

proofread-helper

あなたの校正を手伝ってくれるライブラリ。

今まで、校正作業は主に編集のフェーズの作業でした。 これからは校正情報を編集者が作り、著者が執筆しながら自分で校正を行うようになります。

インストール

自分のライブラリに組み込んで使う場合。

$ npm install --save prh

コマンドラインツールとして使う場合。

$ npm install -g prh

利用方法

テキストファイルであれば、どのようなファイルであっても処理対象にすることができます。

$ prh --help
  Usage: prh [options] [command] [--] [files...]

  Options:

    --rules-json    emit rule set in json format
    --rules-yaml    emit rule set in yaml format
    --rules <path>  path to rule yaml file
    --verify        checking file validity
    --stdout        print replaced content to stdout
    --diff          show unified diff
    -r, --replace   replace input files


  Commands:

    init  generate prh.yml

実際に利用した場合の出力例。 校正ルールは無指定の場合、pwdのprh.ymlを参照しようとします。

# 校正前のファイル例
$ cat sample.md
# サンプルですよ

cookieとjqueryという表記は正しいだろうか？

# チェックにひっかかる箇所の表示
$ prh sample.md
sample.md(3,1): cookie → Cookie
sample.md(3,8): jquery → jQuery

設定ファイルについて

基本的な書き方についてはmisc/prh.ymlを参照してください。

実用するための設定ファイルはprh/rulesのmedia/techbooster.ymlがおすすめです。

その他、prh/rulesに各種設定を取り揃えてあるので、好きに組み合わせてご利用ください。

init サブコマンドでbasicな設定ファイルを作成できます（実用には不向き）。

$ prh init
create prh.yml
see prh/rules collection https://github.com/prh/rules

実用上は git submodule add https://github.com/prh/rules.git prh-rules して好きなルールを使います。 これを参照するprh.ymlは次のように書きます。

version: 1

imports:
  - ./prh-rules/media/techbooster.yml

--diff オプション

unified diff形式で変更点を出力します。 colordiffと組み合わせると標準のレポートより見やすくなるかもしれません。

$ prh --diff sample.md
Index: sample.md
===================================================================
--- sample.md	before
+++ sample.md	replaced
@@ -1,4 +1,4 @@
 # サンプルですよ

-cookieとjqueryという表記は正しいだろうか？
+CookieとjQueryという表記は正しいだろうか？

--stdout オプション

校正を適用した結果をstdoutに出力します。

$ prh --stdout sample.md
# サンプルですよ

CookieとjQueryという表記は正しいだろうか？

v3.x系まではこのオプションがデフォルトの振る舞いでした。

--verify オプション

チェック結果をexit codeとして出力します。 文章のテストやCIなどに組み込む際に便利です。

$ prh --verify sample.md
Error: sample.md failed proofreading
    ....
$ echo $?
1

-r, --replace オプション

指定したファイルの校正結果を直接ファイルに上書きします。

$ prh --replace sample.md
replaced sample.md

$ cat sample.md
# サンプルですよ

CookieとjQueryという表記は正しいだろうか？

修正点を意図的に無視させる

prh単体の利用ではMarkdownやRe:VIEWなどのファイルの構造は考慮できません。 そのため、URLの一部が変換されてしまったりします。 他にも意図的に指摘内容を無視したい場合があります。

そんな時、 prh:disable プラグマを使うことができます。 prhは文章を段落毎に処理し、段落にプラグマが含まれる場合大本のルールよりそちらの支持を優先します。 具体例を見ていきましょう。

#@# prh:disable
ここの段落は全く校正されない。

#@# prh:disable:web
web→Webの校正ルールがある場合。
ここの段落はwebというワードが含まれていても無視するよう指定されているので警告されない。

#@# prh:disable:web|jquery|[abc]
無視ルールは正規表現として解釈されるため複雑な条件も記述できる。

ルールは後置することもできる。
#@# prh:disable

こんな塩梅です。 この例はRe:VIEWのコメント記法を使っていますが、お使いのフォーマットでコメントと解釈される任意の構造を使うことができます。 Markdownであれば <!-- prh:disable --> とすることができます。 このため、無視するルールの記述に半角スペースを利用することができなくなっています。 代わりに \s などを使ってください。

関連ツール

Atomのプラグインであるlanguage-reviewに組み込まれています。 エディタ上で執筆を行うと自動的に校正候補が表示され、その結果を原稿に反映していくことができます。

VSCodeの拡張もあります。 これもエディタ上で執筆を行うと自動的に校正候補が表示され、QuickFixか全修正をさせることもできます。

azuさんが作成しているtextlintのプラグインとしてtextlint-rule-prhが作成されています。

Changelog

4.0.0 (2017-08-15)

コマンドラインからの利用がしやすいように色々と手を加えました。 v3系から破壊的変更もあるので気をつけてください。 API上の破壊的変更はありません。

• --json オプションを --rules-json オプションに変更
• --yaml オプションを --rules-yaml オプションに変更
• デフォルトの挙動は校正後のファイルをstdoutに出力していたのを止めた
  • --stdout オプションを導入（v3でのデフォルトの挙動だったもの）
• --diff オプションを導入
• --verify オプションを導入

詳しくはREADME.mdを参照してください。

Bug Fixes

• prh: CIのNode.jsバージョンを6系に変更 (e2c33dc)
• prh: prh:disable プラグマの挙動が意図と完全に逆になってたのを修正… (24f734e)
• prh: 差分作成処理で変化がない置き換えパターンが生成されていたのを修正 (a95f7c4)

Features

• prh: --diff オプションの実装 unified diff形式で差分出力できるようにした (9ffa09e)
• prh: --replace で置き換えたファイルがある場合、stderrに置き換えたファイル名を出力するようにした (f8a07a8)
• prh: --report オプションの実装 (bef8ab0)
  • --report をデフォルトの挙動に変更 既存の挙動は --stdout に移動 (83a09cc)
• prh: BREAKING CHANGE --json と --yaml オプションを --rules-json と --rules-yaml オプションに変更 (69da647)
• prh: indexから行&列に変換するユーティリティを追加 (1621b5f)
• prh: 変更差分の有無をexit codeで返す --verify オプションの追加 (2e38924)

<a name="3.1.1"></a>