vim-jp / vim-jp/vimdoc-ja-working

原文の文章に補足リンク(`|~|`)がある場合のピリオドの位置と翻訳後の「。」の位置について

Open
#1,590 5 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Vim Script
Stars
84
Forks
61
Avg merge
2d 19h
Merged PRs (30d)
35

Description

文章うまくまとまってないですが、書きます。

Vimのhelpの原文には、Any text properties in {lnum} are cleared |text-prop-cleared|. のような文章がそこそこ出てきます。
Any text properties in {lnum} are cleared が文章で、|text-prop-cleared| はその詳細が記述されているhelpタグのリンクです。
そのまま日本語に訳すと、{lnum} 内のすべてのテキストプロパティはクリアされる |text-prop-cleared|。 になりますが、不自然なので、{lnum} 内のすべてのテキストプロパティはクリアされる。 |text-prop-cleared| に訳しています。

今までは、原文のピリオドの位置をリンクの前に移動する よう修正PRを出していました。
面倒くさいので、ChrisBra氏に「このパターンの場合、ピリオドの位置をリンクの前にして欲しいな」とリクエストしたら、「私はピリオドは最後に付けるのが好みです。」と言われました。
https://github.com/vim/vim/commit/946f61c405b54934f58cbb8053957f4a1ecadec8#diff-ef8946d89919ad628b9ac65c49d3067e4e017b0980cac70eb25d832a59ef677dR9489

ですので、今後は日本語訳でのみ対応します。


今考えたら、原文を Any text properties in {lnum} are cleared. See |text-prop-cleared|. にして、
日本語訳を、{lnum} 内のすべてのテキストプロパティはクリアされる。|text-prop-cleared| を参照。 にすれば丸く収まる気がしてきた。。。

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Read the examples in issue #1590 and inspect the linked Vim commit to understand the punctuation disagreement around help-tag links. Identify the relevant Japanese help text and any applicable translation conventions; done means the project has an agreed rule and the affected translations follow it.

Written by the indexing model from the issue text.

Assessment

Tech stack
vim
Domain
documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.