Merge pull request #2470 from h-east/update-ft_context

Update ft_context.{txt,jax}

Author: h-east

doc/ft_context.jax

@@ -1,8 +1,8 @@
-*ft_context.txt*	For Vim バージョン 9.1.  Last change: 2024 Jan 01
+*ft_context.txt*	For Vim バージョン 9.2.  Last change: 2026 Jan 10
 
 これは ConTeXt ファイルタイププラグインのドキュメントである。
 
-NOTE: このプラグインは +vim9script が必要である。
+NOTE: このプラグインは |+vim9script| が必要である。
 
 ==============================================================================
 ☆内容						*context.vim* *ft-context*
@@ -19,11 +19,11 @@ NOTE: このプラグインは +vim9script が必要である。
 ConTeXt は、LaTeX と同じで、TeX 上に構築されたマクロベースの組版システムである:
 >
 	https://wiki.contextgarden.net
-	https://wiki.contextgarden.net/Vim
+	https://wiki.contextgarden.net/Input_and_compilation/Text_editors/Vim
 <
 ConTeXt プラグインは構文ハイライト、組版した ConTeXt 文章の補完とサポートを提
-供する。文章を組版するのに推奨する方法は |:ConTeXt| を使うことである。これは
-`$PATH` 上で見付けた `mtxrun` スクリプトを動作させる。
+供する。文章を組版するための推奨される方法は、$PATH にある `mtxrun` スクリプト
+を呼び出す |:ConTeXt| を使用することである。
 
 コマンドとその環境でよりきめ細かな制御をするには、`context.Typeset()` を直接使
 うことができる (または旧来の Vim script からは `context#Typeset()`)。例えば、
@@ -32,26 +32,31 @@ ConTeXt プラグインは構文ハイライト、組版した ConTeXt 文章の
 >
 	import autoload 'context.vim'
 
+	var os = "linux"    # システムに合わせて更新
+	var arch = "arm64"  # システムに合わせて更新
+
 	def MyConTeXt()
-	    const env = {'PATH':
-	      printf("%s/context/tex/texmf-<os>-<arch>/bin:%s", $HOME, $PATH)}
-	    context.Typeset("%", env)
+	  var env = {
+	    'PATH': $'{$HOME}/context/tex/texmf-{os}-{arch}/bin:{$PATH}'
+	  }
+	  context.Typeset("%", env)
 	enddef
 
-このコードは `~/.vim/after/ftplugin/context.vim` に置かれるかもしれない。そし
-て、カスタムコマンドを呼び出すためのマッピングを定義することができる:
->
 	nnoremap <silent><buffer><leader>t <scriptcmd>MyConTeXt()<cr>
 <
+このコードは `~/.vim/after/ftplugin/context.vim` に配置する必要がある。
+
 `context.Typeset()` は、カスタムの組版コマンドを指定するための 3 番目のオプショ
-ナルな引数を受け入れる。これは、パスを受け取り、コマンドをリストとして返す関数
+ナルな引数を受け入れる。これは、パスを受け取り、コマンドを |list| として返す関数
 でなければならない。例えば:
 >
 	def ConTeXtCustomCommand(path: string): list<string>
 	  return ['mtxrun', '--script', 'context', '--nonstopmode', path]
 	enddef
 
-	context.ConTeXtTypeset("%", v:none, ConTeXtCustomCommand)
+	def MyContext()
+	    context.Typeset("%", v:none, ConTeXtCustomCommand)
+	enddef
 <
 大規模なプロジェクトでは、ルートドキュメントと様々な章ファイルで構成されること
 がよくある。章ファイルを編集する場合、ルートファイルに切り替えることなく、章
@@ -79,7 +84,8 @@ Vim は、カレントバッファの最初の 10 行内にマジック行を検
 - `context-data-metafun.vim`;
 - `context-data-tex.vim`.
 
-同じコマンドを使用して、これらの構文ファイルを更新できる。
+存在する場合、そのようなファイルは構文のハイライトを強化するために自動的に読み
+込まれる。同じコマンドを使用して、これらの構文ファイルを更新できる。
 
 							*ft-context-commands*
 コマンド ~
@@ -106,8 +112,9 @@ Makefile が存在していても、代わりに `mtxrun` が呼び出される
 >
 	g:context_ignore_makefile = 0
 <
-NOTE: |:make| を使用する前に、バッファの作業ディレクトリを組版するファイルの
-ディレクトリに設定する。
+NOTE: |:make| を使用する前に、バッファの作業ディレクトリがタイプセットしたい
+ファイルのディレクトリに設定されていることを確認すること。また、|:make| は
+$PATH 内で `mtxrun` を検索することに注意。
 
 					*'g:context_extra_options'*
 `mtxrun` に渡す追加のオプションのリスト。
@@ -132,13 +139,14 @@ NOTE: Lua と MetaPost は個別のブロック内では常にハイライトさ
 							*ft-context-mappings*
 マッピング ~
 
-tp			"reflow TeX paragraph"、TeX での段落を整形する。
+tp			"reflow TeX paragraph"、TeX での段落を整形する。(モー
+			ション)
 
 i$			"inside inline math block"、インラインの数式ブロック内
-			部を選択する。
+			部を選択する。(テキストオブジェクトの選択)
 
 a$			"around inline math block"、インラインの数式ブロックを
-			選択する。
+			選択する。(テキストオブジェクトの選択)
 
 ]]			[count] セクションの開始に進む。
 

en/ft_context.txt

@@ -1,8 +1,8 @@
-*ft_context.txt*	For Vim version 9.1.  Last change: 2024 Jan 01
+*ft_context.txt*	For Vim version 9.2.  Last change: 2026 Jan 10
 
 This is the documentation for the ConTeXt filetype plugin.
 
-NOTE: the plugin requires +vim9script.
+NOTE: the plugin requires |+vim9script|.
 
 ==============================================================================
 CONTENTS						*context.vim* *ft-context*
@@ -19,11 +19,11 @@ Introduction ~
 ConTeXt, similarly to LaTeX, is a macro-based typesetting system built on TeX:
 >
 	https://wiki.contextgarden.net
-	https://wiki.contextgarden.net/Vim
+	https://wiki.contextgarden.net/Input_and_compilation/Text_editors/Vim
 <
 The ConTeXt plugin provides syntax highlighting, completion and support for
 typesetting ConTeXt documents. The recommended way to typeset a document is to
-use |:ConTeXt|. This will invoke the `mtxrun` script that is found in `$PATH`.
+use |:ConTeXt|, which invokes the `mtxrun` script that is found in $PATH.
 
 For more fine grained control over the command and its environment,
 `context.Typeset()` can be used directly (or `context#Typeset()` from legacy
@@ -32,26 +32,31 @@ Vim script). For instance, if a version of ConTeXt is installed in
 >
 	import autoload 'context.vim'
 
+	var os = "linux"    # Update to match your system
+	var arch = "arm64"  # Update to match your system
+
 	def MyConTeXt()
-	    const env = {'PATH':
-	      printf("%s/context/tex/texmf-<os>-<arch>/bin:%s", $HOME, $PATH)}
-	    context.Typeset("%", env)
+	  var env = {
+	    'PATH': $'{$HOME}/context/tex/texmf-{os}-{arch}/bin:{$PATH}'
+	  }
+	  context.Typeset("%", env)
 	enddef
 
-This code may go in `~/.vim/after/ftplugin/context.vim`. A mapping can then be
-defined to invoke the custom command:
->
 	nnoremap <silent><buffer><leader>t <scriptcmd>MyConTeXt()<cr>
 <
+This code should go in `~/.vim/after/ftplugin/context.vim`.
+
 `context.Typeset()` accepts a third optional argument to specify a custom
 typesetting command. That must be a function that takes a path and returns the
-command as a List. For example:
+command as a |list|. For example:
 >
 	def ConTeXtCustomCommand(path: string): list<string>
 	  return ['mtxrun', '--script', 'context', '--nonstopmode', path]
 	enddef
 
-	context.ConTeXtTypeset("%", v:none, ConTeXtCustomCommand)
+	def MyContext()
+	    context.Typeset("%", v:none, ConTeXtCustomCommand)
+	enddef
 <
 Large projects are often organized as a root document and various chapter
 files. When editing a chapter file, it is convenient to invoke |:ConTeXt|
@@ -67,7 +72,7 @@ one in the current buffer. The root document does not have to be opened in
 Vim.
 
 To extend completion and syntax highlighting, you may generate supporting
-files using ConTeXt and add them to your configuration. If you configuration
+files using ConTeXt and add them to your configuration. If your configuration
 resides in `~/.vim`, you may use these commands:
 >
 	mkdir -p ~/.vim/syntax/shared
@@ -81,7 +86,8 @@ The last command will create the following syntax files:
 - `context-data-metafun.vim`;
 - `context-data-tex.vim`.
 
-The same command can be used to update those syntax files.
+If present, such files will be automatically loaded to enhance syntax
+highlighting. The same command can be used to update those syntax files.
 
 							*ft-context-commands*
 Commands ~
@@ -109,8 +115,9 @@ and this option is not set, standard `make` is used. If this option is set,
 >
 	g:context_ignore_makefile = 0
 <
-NOTE: before using |:make|, set the working directory of the buffer to the
-directory of the file to be typeset.
+NOTE: before using |:make|, ensure that the working directory of the buffer is
+set to the directory of the file you want to typeset. Additionally, be aware
+that |:make| searches for `mtxrun in $PATH.
 
 					*'g:context_extra_options'*
 A list of additional options to pass to `mtxrun`.
@@ -135,11 +142,11 @@ When set, do not define any mappings.
 							*ft-context-mappings*
 Mappings ~
 
-tp			"reflow TeX paragraph".
+tp			"reflow TeX paragraph" (motion).
 
-i$			"inside inline math block".
+i$			"inside inline math block" (text object selection).
 
-a$			"around inline math block".
+a$			"around inline math block" (text object selection).
 
 ]]			[count] start of sections forward.