search

nostr-jp / nips-ja

nostr-protocol/nipsの和訳
40 stars 18 forks source link

About style guide #6

Open erechorse opened 11 months ago

erechorse commented 11 months ago

現在は暫定で https://github.com/nostr-jp/nips-ja/pull/3 にて定義されたlintを設定していますが、もう少し内容を詰めていけたらと思います。

なお、現状は基本的には https://github.com/textlint-ja/textlint-rule-preset-ja-technical-writing に従いつつ

の3つがfalseになっています。

検討中のスタイルガイドの変更点

他にもありましたら提案してください。

jiftechnify commented 11 months ago

「"MUST", "SHOULD", "MAY"のような、RFC2119の規約を借用して要求レベルを指定する語については、その訳の後に括弧書きで元の単語を付記する」という規約があると良さそうです。

これをtextlintで自動チェックするのはおそらく無理なので、レビューで確認してもらうしかありませんが…

erechorse commented 10 months ago

@darashi さんより、NIPsに頻出する、表記ゆれしがちな言葉の対訳リストを作ったほうがよいという提案をいただきました。

e.g.

textlintの設定である程度は対応可能かと思います。

erechorse commented 10 months ago

NIP-02の翻訳中、For exampleを例:と訳すと現状のlintの設定だとエラーが出るので、文末の句点ルールはなくてもよいという話が出ています。句点のチェックが手動になってしまうのはデメリットかもしれません。

erechorse commented 10 months ago

関連: https://github.com/nostr-jp/nips-ja/issues/6#issuecomment-1777578599 、 https://github.com/nostr-jp/nips-ja/issues/19

毎度のことなので、MUST、SHOULD、MAYの訳語は固定してしまったほうが良いかもしれません。個人的には

のように意識しています。

darashi commented 10 months ago

私が訳した部分でいま↑に準拠していない例として、 NIP-01 の 以下があります。

The 4th parameter MUST always be present, but MAY be an empty string when the 3rd is true, otherwise it MUST be a string formed by a machine-readable single-word prefix followed by a : and then a human-readable message.

を

4番目のパラメータも必須で（MUST）、3番目がtrueである場合は空文字列でもかまいません（MAY）が、そうでなければ、機械可読な一語のプレフィクスに続けて:と人間可読なメッセージを含まなければなりません（MUST）。

と訳しました（そもそもこの文が難しい気がする）。

「4番目のパラメータも存在しなければならず（MUST）、」という感じになるでしょうか。訳の自由度は下がりますが基準があるメリットのほうが大きいかもしれないですね。

darashi commented 10 months ago

https://github.com/textlint-ja/textlint-rule-no-mix-dearu-desumasu はデフォルトだと統一されているか、をチェックするようなので、どちらかに揃っていると pass しそうです。まだ中をちゃんと見られていないのですが、以下のように「ですます」を設定した場合でも、助動詞「だ」「である」が一切使われていないと pass するような動作をしていそうです。おしい。

https://github.com/darashi/nips-ja/blob/desumasu-check/.textlintrc.json

erechorse commented 10 months ago

@SnowCait さんより、原文側にkind-x、kind `x`、kind xなどの表記揺れがあるのでとりあえず翻訳側でもどれかに統一した方が良いのでは、という意見をいただきました。

erechorse commented 10 months ago

https://github.com/nostr-jp/nips-ja/issues/29

s3-odara commented 10 months ago

ですます調のルールで文末以外も厳しくチェックするルールが有効になっていますが、

https://github.com/nostr-jp/nips-ja/pull/24#discussion_r1398396996

長文投稿は編集可能であることを意図しているため

のような文中の「であること」が検知されるのは想定通りの動作でしょうか。 修正するなら「編集可能なこと」ですかね。

erechorse commented 10 months ago

個人的にも、文中の「であること」がよく検知されるので気になりつつ放置していた点でした。

ただ、そもそも 「だ・である」調に翻訳を切り替えた方が良いのではないか という意見があるので、差し当たって今はlint ruleを通るように文中の表現を微調整して対処しています。