タイトルにあるような正式名称に対する略語(主に頭文字を取るタイプ)を括弧の中に書いているかをチェックするtextlintルールを書きました。

例

例えば、Open Source Softwareの略語はOSSですということを表現したい場合に次のように書くというルールです。

OK:

This is Open Source Software(OSS)
これはOpen Source Software（OSS）なルールです
JavaScript(JS)

NG:

LTS（Long-Term Support）
JS(JavaScript)
This rule is OSS(Open Source Software)
これはOSS（Open Source Software）なルールです

使い方

npmでインストールして

npm install textlint-rule-abbr-within-parentheses

.textlintrc(Recommended)を設定すれば動きます。

{
    "rules": {
        "abbr-within-parentheses": true
    }
}

略語は括弧の中 or 前?

統一という観点から見ると次のような文章は略語の書き方が混ざっていてよくありません。

混ざっていて良くない例
Ths Object Management Group(OMG) maintains specifications for the UML(Unified Modeling Language).

そのため統一する書き方を探していたのですが、括弧の中に略語を書くというルールを採用してるケースが色々ありました。APA StyleやIBM Style Guideなどはそのような書き方を推奨しているようです。

逆(略語を先に書く)を推奨してるルールは見つけることができませんでしたが、括弧ではなく言葉で略語を解説するスタイルも見られました。しかしながら略語は括弧の中に書くという根拠については見つけられませんでした。

一つまだ疑問があって、括弧の中に書くとどうも補足的な印象が出てきてしまいます。 たとえば、URLのような略語自体が言葉として一般的に成立してるパターンは、Uniform Resource Locatorという正式名称はもはやURLの補足情報になっているように思えます。 他にもAP Styleの正式名称はAssociated Press Styleですが、AP(Associated Press) Styleのように紹介してる文章も見受けられます。(ここでの正式名称はわかりにくいしあまり重要ではないから括弧の中に書かれているのかも?)

English

Japanese

ウェブに文書を書くと基本的にはHTMLなので、HTMLではどうなっているかが気になりました。 HTMLの世界ではdfnとabbrがそれぞれ関係します。

We use HTML to structure our web documents.

<p>We use <dfn><abbr title="Hypertext Markup Language">HTML</abbr></dfn> to structure our web documents.</p>

この場合も正式名称が属性値にあるので、正式名称の方が補足情報にも見えます。

これは感覚的なものですが、略語をそもそも使うのは正式名称が毎回書くには長いためです。 なので、最初にこの正式名称の略語はこう定義しますという意味で 正式名称(略語)と書くスタイルがあるのだと思います。またこの時に2回目以降は正式名称は補足的な情報に逆転する感じがします。(abbr要素の例) 一方、そもそも一度しか出てこない単語はどちらでもいいという理由で表記が安定しないような気がします。(このルールで縛りたい部分)

この辺の書き方や読んだときにどのような印象を受けるかについて調査レポートや論文とか知ってる人いたら教えてください。

作ったtextlintルール