利用を想定して書かれています。インストールして同梱されている設定ファイルで文書を検査すると、相当な量のエラーが出現してしまい少々ゲンナリしてしまいます。大量のエラーが出現してしまうのは、個人や執筆グループによって異なることが多い検査も、デフォルトの設定ファイルに追加されているためです。利用方法や設定方法について記事を書いたのですが、具体的な設定をどうするのかについてあまり触れてませんでした。おすすめ設定に関するまとめとなっています。発見する」があります。本稿を読む前に一読しておくとよいでしょう。利用するユーザにおすすめしたいのは文長関係の検査だけを追加する設定です。文書執筆でなぜ文長が重要かといえば、文が長いと読者が理解するのが難しくなるためです。長い文は単純に読みにくいという以外の問題も引き起こします。文書を読んでいて理解できない箇所があったとします。このとき文が長いと、読者が内容を理解できないのは”解説がたりないのか”、それとも”文が複雑すぎるのか”切り分けできないという状態がおこります。技術文書執筆の目的は読者に記述した内容をはやく精確に読者に伝えるという点に集約されます。文書執筆の目的を考えれば内容が理解しづらくなる長い文はできるかぎり早く取り除きたい問題です。私がマニュアルやメールのレビューを頼まれた時には、まずはじめのリファクタリングとして文を短くそろえます。一度文を短くしておくと、著者は文やパラグラフのつながりなどもう少し大きな粒度の問題に集中できるのです。使って日本語文書を検査したい人には以下の設定がおすすめです。</validators></redpen-conf>上の設定では二つの機能が登録されています。文の長さ自体を検査する機能。上記の設定では文の最大長を100文字に設定している。文中のコンマの数を検査。デフォルトでは最大四つ。上の設定はどれも文の長さに関連する検査です。2016/05/11)。先に述べたように一度文を短く揃えてからが、本格的な文書の校正の開始です。文が短く揃っているために文書が頭に入ってくるスピードが増して校正作業がスムーズにすすみます。次に文書内の表現に関する機能を加えてみます。</validators></redpen-conf>残念ながら日本語でつかえる表現に関する検査項目は多くありません。現状ですと以下の機能が利用できます。カタカナ単語末尾の長音検査します。カタカナ単語のゆらぎ検査します。顔文字や感情的な表現など技術文書で利用するべきでない句の使用を検査します。二重否定を検知します。同じ文頭表現が過度に利用されていないか検査。どの文も”私は〜〜”からはじまるなど。格助詞の「の」+名詞連続+格助詞の「の」というパターンを発見するとエラーを出力します。日本語の数値表現を検査する機能です。「ひとつ、ふたつ」、「1つ、2つ」などのゆらぎを検知します。長過ぎる漢字の連続をみつけるとエラーを出力します。同一内容の文が連続して出現するとエラーを出力します。「が」が出現するとエラーを出力します。利用して簡単に機能追加ができます。不正表現は人によって検査したい箇所や表現が異なります。自分用の機能を追加してみましょう。製品のマニュアルなど長い文書を書くために便利な機能もいくつか提供しています。以下の設定に節やパラグラフまわりの機能を追加したサンプル設定となります。節内のパラグラフ数が指定した値よりも多いとエラーを出力します。節の長さが指定した値よりも多いとエラーを出力します。類似した節が存在するかを検査。節の場所を移動させた際に、元の場所の節の削除を忘れた場合にエラーを出力します。中身が無い節に(章)対してエラーを出力します。節の中に文がなく、小節から始まるときにもエラーを出力します。環境によっては小さな小節を利用できないことがあります。SectionLevelは節が細かすぎるとエラーを出力します。文書の文字に関する設定は最も、執筆者によって規約が異なる部分だと感じています。本文書では句点として”。人によっては”.”を利用しますし、半角ピリオド(”.”)を日本語文の句点として利用している人もいます。句点の設定を利用して文を切り出しています。そのため句点の設定が文書の内容と異なるとパラグラフ全体が一文として切りだされてしまいます。”を句点として使用する設定となっています。別の句点を利用するには設定を書きかえる必要があります。句読点の部分だけは手軽に設定を上書きできます。