Update usr_{41,50,51,52,toc}.{txt,jax} #1118

tsuyoshicho · 2022-07-10T07:28:07Z

翻訳しました。よろしくおねがいします。

これ以降のバージョンでの変更もあるのですが、レビューが遅延してしまう(usr_52が絡むため)ので、ここまでで一度レビューをおねがいします。

今回の変更の中で、コード例の中などに空白行に空白がある箇所が2つほどあり
これらは最新では対応ずみ(改行済み)であるため、こちらも対処 & 報告はなし

tsuyoshicho · 2022-07-24T00:01:46Z

doc/usr_50.jax

+引数を1つで呼び出したときは "items" リストは空になります。`range(len(items))`
+はインデックス付きのリストを返します。`for`がループするものについては、さらに
+詳しく説明します。


ここなんですが、原文が

If you call it with one argument the "items" list will be empty. `range(len(items))` returns a list with the indexes, what `for` loops over, we'll explain that further down.

returns a list with the indexes と言っているのでこうなってます。

rangeならリストの添字文の数列を返すと思うので、原文からミスな気がしますが... ( return indexes for a list ?)

tsuyoshicho · 2022-07-24T00:21:12Z

doc/usr_51.jax

+2回目のスクリプトのソース時に関数が削除されるのを防ぐため `vim9script` コマン
+ドに "noclear" を使用することを忘れないでください。
+


ここもですが

Don't forget to use "noclear" with the `vim9script` command to avoid that the function is deleted when the script is sourced a second time.

to avoid that the function is deleted ですが、2回目のsourceは vim9-reload 的には再定義される気がするんですけど、なんか場所によって説明が若干ブレますね...(内容が変化した可能性が高いですが)

2回目のsourceは vim9-reload 的には再定義される気がする

されないですね。以下のvim9 scriptを2回:sourceすると...

vim9script noclear echom "source test.vim" if !exists("*Func") echom "decl Func" def Func(arg: string) echom "exec Func" enddef endif

以下の結果になります。

source test.vim decl Func source test.vim

noclearなしの場合は以下の結果です。

source test.vim decl Func source test.vim decl Func

お手間かけてすみません、いやまあそうですよね...

doc/usr_51.jax

doc/usr_52.jax

h-east

usr_41.jax の L186 (*41.2*の手前)までレビューしました。

h-east · 2022-08-19T22:23:00Z

doc/usr_41.jax

+
+
+例を試す
+--------


これは原文にはないですが、原文だと全部大文字の場合ハイライトされるけれども、日本語訳の場合ハイライトされないので、苦肉の策として追加したのですよね？
まぁたしかに他のファイルでも訳がハイライトされていなくて、見出し感がないものもありますね。。どうしましょうか。

です、そうかちょっと意味がちがいました。

でもどうしたもんでしょうね...

やっぱり原文にはないので、削除しましょう。

@h-east
指摘の対応作業しようと見直して、より詳細に思い出しました。

最初自分でそのように考えた(原文だと全部大文字の場合ハイライトされるけれども、日本語訳の場合ハイライトされないので、苦肉の策として追加)のですが、翻訳を進めるうちに同じようにしている部分が多数あり、問題ない認識になったのでした。
時間が経ったのでそのことについて、抜けてしいました。

現在のmaster(既訳部分)でもたとえば以下のようになっています。

vimdoc-ja-working/doc/usr_41.jax

Lines 357 to 358 in 64a8fdf

数値計算

--------

vimdoc-ja-working/en/usr_41.txt

Lines 366 to 367 in 64a8fdf

MATHEMATICS

全部まとめて対処してしまうか、この流れにあわせるか...

うーん、そういう特別な事をしていたのなら、Wikiに書いておいて欲しかったです。。
日本語訳専用のHeadline(見出し)のハイライトを定義したほうが良さそうな気がします。

例えば、help_ja.vimに以下を追加して

syn match helpHeadline "^●.\{-}\ze$\s\+\*\|$$"

上のusr_41.jaxの場合は

●数値計算

と書くと、原文と同じハイライトがされるようになります。

自分がやらかしたか、git blame見てみましたが、11年前の構造変更の頃からそうだったみたいですね...

なにかしら、日本語のheadlineのキー文字を定めるほうがよさそうなのは同意するところです。

Wikiには限定的に「こう対応しています、ただし論議あり」と書き足しました。
https://github.com/vim-jp/vimdoc-ja-working/wiki/Guide#%E6%96%87%E4%BD%93

完全に @tsuyoshicho さんを疑ってしまっていました。すいません:bow:

日本語専用Headlineハイライトについては「●」がConcealで消せれば完璧かな？と思ってます。
(誰かサクッと提案してくれないかなぁ。。)

@h-east さん
いえ、自分も自分を疑いましたので、気にせずw。

そして syntax の改良PRを作ってみました。

vim-jp/vimdoc-ja#275
どうでしょうか?

新しいハイライト記法に修正しました(英語版でキャピタルになって小見出しになっていることも確認)
(このPR内ファイルは全部確認しました。)

doc/usr_41.jax

Co-authored-by: h_east <[email protected]>

doc/usr_41.jax

Co-authored-by: h_east <[email protected]>

h-east

L1442(defcompile)までレビューしました。

doc/usr_41.jax

Co-authored-by: h_east <[email protected]>

doc/usr_41.jax

h-east

L1654 までレビューしました。
(前回のレビュー調整のnvcheck対応ありがとうございました)

h-east · 2022-09-17T19:07:27Z

doc/usr_41.jax

+詳細: range() の内部
+実際にはリストは作られないため、巨大な範囲のループが効果的に動作します。それ以
+外の時は、範囲は実際のリストになり、長いリストのためにより時間がかかります。


原文同様、改行なしでお願いします。
それとInternally range()が主語で does not actually create the list と続いていると思うのでそこも改行なしでお願いします。

たしかにそうですね。
修正しました。

Co-authored-by: h_east <[email protected]>

Co-authored-by: K.Takata <[email protected]>

k-takata · 2022-10-18T10:53:02Z

doc/usr_50.jax

+指定しています。`echohl None` で再度停止します。`echon` コマンドは  `echo` と
+同様に動作しますが、改行を出力しません。


Suggested change

指定しています。`echohl None` で再度停止します。`echon` コマンドは `echo` と

同様に動作しますが、改行を出力しません。

指定しています。`echohl None` で再度停止します。`echon` コマンドは `echo` と同

様に動作しますが、改行を出力しません。

あれ、reformatしたんですが、逆にダメになってましたか...、すんません。

空白が2つ連続していました。

ですね、そこもあって変だったんだな...

This reverts commit dae2ee6. Co-authored-by: K.Takata <[email protected]>

Co-authored-by: K.Takata <[email protected]>

doc/usr_41.jax

Co-authored-by: K.Takata <[email protected]>

h-east

usr_52.jax L236 (*52.4*の手前)までレビューしました。

doc/usr_52.jax

h-east · 2022-10-21T02:19:22Z

doc/usr_52.jax

+で追加することもできます。
+
+
+☆オートロード ディレクトリ


空白なしで良い気がします。(以下同様)

後程まとめて対応します。

doc/usr_52.jax

h-east

ひと通りレビューしました。
最後、「こんな感じでどうでしょう。」「微調整」が多めですが、時間的に(精神的に)余裕があまりなかったのでご容赦ください:bow:

doc/usr_52.jax

Co-authored-by: h_east <[email protected]>

h-east · 2022-10-22T13:49:44Z

@k-takata takataさんから特にコメントなければ、24時間後くらいにmergeしようと思っています。「まだ、レビューするからちょっと待て」等あればコメントください。

k-takata · 2022-10-23T02:14:17Z

doc/usr_51.jax


-次章: |usr_52.txt|  Vim9 script でプラグインを作る
+次章: |usr_52.txt|  巨大なプラグインを作る


largeを巨大と訳すのは違和感があります。（この議論どこかで見たような？）

#837
ですかね?
難しいのですが、なにかこう訳したほうがよさそう、みたいなのがあると嬉しいです(自分としては、大規模とかはなくはないんですが、選べなくて)

つい最近見たような？
一般的には、
large -> 大きい
huge -> 巨大
だと思います。

上で h-east さんが指摘していました。
#1118 (comment)

あ、あれ?

あわせて直すことにします。

対応しました。

k-takata · 2022-10-23T02:16:53Z

doc/usr_51.jax

+ 13	iabbrev otehr other
+ 14	iabbrev wnat want
+ 15	iabbrev synchronisation
+ 16		\ synchronization

 もちろん、実際のスクリプトはもっと巨大です。


今回の修正ではないですが、
「もちろん、実際のリストはもっと長いです。」

対応します。

対応しました。

doc/usr_52.jax

k-takata · 2022-10-23T03:07:51Z

doc/usr_52.jax

+参考文献: |autoload|。
+
+==============================================================================
+*52.4*	使用する他のメカニズム


Suggested change

*52.4* 使用する他のメカニズム

*52.4* 他に使えるメカニズム

修正するなら目次も。

了解です。

量があるので、対応が徐々になりますが、やっていきます。

対応しました。

Co-authored-by: K.Takata <[email protected]>

h-east · 2022-10-31T05:54:37Z

Thanks a lot!!!

tsuyoshicho self-assigned this Jul 10, 2022

tsuyoshicho commented Jul 24, 2022

View reviewed changes

tsuyoshicho force-pushed the update/20220623/usrx branch from 9fece23 to 67f9f99 Compare July 31, 2022 05:41

tsuyoshicho commented Jul 31, 2022

View reviewed changes

doc/usr_51.jax Outdated Show resolved Hide resolved

tsuyoshicho commented Jul 31, 2022

View reviewed changes

doc/usr_52.jax Outdated Show resolved Hide resolved

tsuyoshicho added 2 commits July 31, 2022 14:50

usr_{41,50,51,52,toc}.txt: Update Vim 8.2.5152

2c6e534

usr_{41,50,51,52,toc}.jax: Update Vim 8.2.5152 translate

12c90b0

tsuyoshicho force-pushed the update/20220623/usrx branch from f5a47c0 to 12c90b0 Compare July 31, 2022 05:56

tsuyoshicho marked this pull request as ready for review July 31, 2022 06:01

tsuyoshicho requested review from h-east and k-takata July 31, 2022 06:02

h-east reviewed Aug 19, 2022

View reviewed changes

tsuyoshicho and others added 2 commits August 20, 2022 14:50

usr_41.jax: Apply some suggest fix

59a8238

Co-authored-by: h_east <[email protected]>

usr_41.jax: style fix

42bff2c

tsuyoshicho mentioned this pull request Aug 28, 2022

feat: Add ja special helpHeadline region vim-jp/vimdoc-ja#275

Closed

usr_41.jax: Using new small caption(ja) rule

7b7407e

tsuyoshicho requested a review from h-east September 5, 2022 12:13

tsuyoshicho added 2 commits September 5, 2022 21:25

usr_51.jax: Using new small caption(ja) rule

55efa9e

usr_52.jax: Using new small caption(ja) rule

6f098e1

h-east reviewed Sep 7, 2022

View reviewed changes

doc/usr_41.jax Outdated Show resolved Hide resolved

doc/usr_41.jax Outdated Show resolved Hide resolved

usr_41.jax: fix suggestion

cd2fea1

Co-authored-by: h_east <[email protected]>

tsuyoshicho requested a review from h-east September 11, 2022 03:50

h-east reviewed Sep 14, 2022

View reviewed changes

doc/usr_41.jax Outdated Show resolved Hide resolved

doc/usr_41.jax Outdated Show resolved Hide resolved

tsuyoshicho and others added 2 commits September 15, 2022 08:32

usr_41.jax: apply suggestion

df66919

Co-authored-by: h_east <[email protected]>

usr_41.jax: typo fix

c88e67c

tsuyoshicho requested a review from h-east September 14, 2022 23:39

h-east reviewed Sep 17, 2022

View reviewed changes

doc/usr_41.jax Outdated Show resolved Hide resolved

h-east reviewed Sep 17, 2022

View reviewed changes

usr_41.jax: treat translation

3f0867b

Co-authored-by: h_east <[email protected]>

tsuyoshicho and others added 3 commits October 18, 2022 18:16

usr_50.jax: treat translation

177831a

Co-authored-by: K.Takata <[email protected]>

usr_41.jax: Update translate and reformat

a27f347

usr_50.jax: Update translate and reformat

dae2ee6

tsuyoshicho requested review from h-east and k-takata October 18, 2022 09:36

usr_41.jax: Update translate and reformat part2

f973495

k-takata reviewed Oct 18, 2022

View reviewed changes

tsuyoshicho and others added 2 commits October 18, 2022 19:58

usr_50.jax: Revert Update translate and reformat

d8f9211

This reverts commit dae2ee6. Co-authored-by: K.Takata <[email protected]>

usr_50.jax: small treat

fc10718

Co-authored-by: K.Takata <[email protected]>

k-takata reviewed Oct 18, 2022

View reviewed changes

doc/usr_41.jax Outdated Show resolved Hide resolved

usr_41.jax: treat translation

7c166f0

Co-authored-by: K.Takata <[email protected]>

h-east reviewed Oct 21, 2022

View reviewed changes

tsuyoshicho and others added 2 commits October 22, 2022 14:39

usr_52.jax: Apply many suggestions

1cb83f6

Co-authored-by: h_east <[email protected]>

usr_52.jax: fix 'autoload directory'

676c270

Co-authored-by: h_east <[email protected]>

tsuyoshicho requested review from h-east and k-takata October 22, 2022 05:59

h-east approved these changes Oct 22, 2022

View reviewed changes

k-takata reviewed Oct 23, 2022

View reviewed changes

tsuyoshicho and others added 4 commits October 24, 2022 21:36

usr_{51,52,tox}.jax: Update translte for usr_52 title

676b6d9

usr_52.jax: Apply all suggestions

ac42abb

Co-authored-by: K.Takata <[email protected]>

usr_51.jax: fix source size

b4ddf30

usr_{52,tox}.jax: fix 52.4 title

4ad73d7

tsuyoshicho requested a review from k-takata October 29, 2022 10:36

k-takata approved these changes Oct 31, 2022

View reviewed changes

h-east approved these changes Oct 31, 2022

View reviewed changes

h-east merged commit b157d4b into vim-jp:master Oct 31, 2022

tsuyoshicho deleted the update/20220623/usrx branch October 31, 2022 10:16

		2回目のスクリプトのソース時に関数が削除されるのを防ぐため `vim9script` コマン
		ドに "noclear" を使用することを忘れないでください。

		指定しています。`echohl None` で再度停止します。`echon` コマンドは `echo` と
		同様に動作しますが、改行を出力しません。

		で追加することもできます。


		☆オートロードディレクトリ


		次章: \|usr_52.txt\| Vim9 script でプラグインを作る
		次章: \|usr_52.txt\| 巨大なプラグインを作る

	52.4 使用する他のメカニズム
	52.4 他に使えるメカニズム



		例を試す
		--------

Update usr_{41,50,51,52,toc}.{txt,jax} #1118

Update usr_{41,50,51,52,toc}.{txt,jax} #1118

Uh oh!

Conversation

tsuyoshicho commented Jul 10, 2022 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

tsuyoshicho Jul 24, 2022 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

tsuyoshicho Jul 24, 2022 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

h-east left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

tsuyoshicho Aug 27, 2022 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

tsuyoshicho Aug 28, 2022 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

tsuyoshicho Sep 5, 2022 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

h-east left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

h-east left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

tsuyoshicho Sep 18, 2022 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

h-east left a comment

Choose a reason for hiding this comment

tsuyoshicho commented Jul 10, 2022 •

edited

Loading

tsuyoshicho Jul 24, 2022 •

edited

Loading

tsuyoshicho Jul 24, 2022 •

edited

Loading

tsuyoshicho Aug 27, 2022 •

edited

Loading

tsuyoshicho Aug 28, 2022 •

edited

Loading

tsuyoshicho Sep 5, 2022 •

edited

Loading

tsuyoshicho Sep 18, 2022 •

edited

Loading

tsuyoshicho Oct 24, 2022 •

edited

Loading