|
|
1.
|
|
|
Text Editor Integration
|
|
|
|
|
集成文本编辑器
|
|
Translated and reviewed by
Huang Junjie
|
|
|
|
Located in
../../source/editor.rst:8
|
|
|
2.
|
|
|
Ren'Py uses a text editor to allow the user to edit game scripts from the launcher, and to report errors to the user. By default, Ren'Py uses jEdit as the text editor when launched from the launcher and the system default editor otherwise. This can be customized by the user as necessary.
|
|
|
|
|
Ren'py使用一个文本编辑器让用户能够在启动器中编辑游戏脚本，并返回错误给用户。默认情况下，Ren'py使用jEdit作为启动器中调用的默认文本编辑器，若不存在，则为系统默认文本编辑器。有必要的时候，用户可以自定义需要使用的文本编辑器。
|
|
Translated and reviewed by
Huang Junjie
|
|
|
|
Located in
../../source/editor.rst:10
|
|
|
3.
|
|
|
The editor is customized by creating an Editor class in a .edit.py file. This class contains methods that are called to manage text editing.
|
|
|
|
|
编辑器在一个.edit.py文件中创建了编辑器类来自定义它。这个类包含了管理文本编辑的规则。
|
|
Translated and reviewed by
Huang Junjie
|
|
|
|
Located in
../../source/editor.rst:15
|
|
|
4.
|
|
|
When run directly, Ren'Py first looks at the RENPY_EDIT_PY environment variable to find an .edit.py file to use. If it can find one, it uses the Editor class defined in that file. If not, it uses a built-in editor class that launches the editor in a system-specific manner.
|
|
|
|
|
当直接运行的时候，Ren'py会首先在RENPY_EDIT_PY环境变量中寻找.edit.py文件来使用。如果找到，则它会使用该文件中定义的编辑器类。如果找不到，它就回使用内置编辑器类来启动系统默认文本编辑器。
|
|
Translated and reviewed by
Huang Junjie
|
|
|
|
Located in
../../source/editor.rst:18
|
|
|
5.
|
|
|
When the Ren'Py Launcher is run, it scans subdirectories of the projects directory and Ren'Py directory to find files of the form `name`.edit.py. (For example, it would find launcher/jEdit.edit.py and myeditor/MyEditor.edit.py.) The latest editor with a given `name` is presented to the creator as part of the launcher options. The launcher also sets RENPY_EDIT_PY to the selected file, so that games launched from the launcher will use the selected editor.
|
|
|
|
|
当Ren'py启动器运行时，它会扫描工程的子目录和Ren'py目录来寻找`name`.edit.py。（例如，它会寻找launcher/jEdit.edit.py和myeditor/MyEditor.edit.py。）带有提供`name`的最新文本编辑器会作为启动器的选项的一个提供给创作者选择。启动器也会给选定的文件设定RENPY_EDIT_PY，使得从启动器中启动的游戏会使用选定的文本编辑器。
|
|
Translated and reviewed by
Huang Junjie
|
|
|
|
Located in
../../source/editor.rst:23
|
|
|
6.
|
|
|
Writing an .edit.py File
|
|
|
|
|
编写一个.edit.py文件
|
|
Translated and reviewed by
Huang Junjie
|
|
|
|
Located in
../../source/editor.rst:32
|
|
|
7.
|
|
|
An edit.py file is a Python (not Ren'Py) file that must define a single class, named Editor. Ren'Py will call methods on this class to cause editing to occur.
|
|
|
|
|
edit.py文件是一个必须定义简单类的Python（不是Ren'py）文件，以编辑器为准命名。Ren'py可以调用这个类的方法（methods）来出发编辑操作。
|
|
Translated and reviewed by
Huang Junjie
|
|
|
|
Located in
../../source/editor.rst:34
|
|
|
8.
|
|
|
Use of the editor is done as part of an editor transaction, which groups related operations together. For example, if an editor transaction asks for a new window, all of the files in that transaction should be opened in the same new window. An editor transaction starts with a call to the begin method, may contain one or more calls to operation methods, and ends with a call to the end method.
|
|
|
|
|
编辑器的使用是作为编辑器事务（transaction）的一部分完成的，它将相关操作组合在一起。比如，若一个编辑器事务需要一个新窗口，那么该事务中所有的文件都应在同一个新窗口中打开。一个编辑器的事务开始于启动方法的调度，可能包含一个或多个操作方法调用，并结束于结束方法的调度。
|
|
Translated and reviewed by
Huang Junjie
|
|
|
|
Located in
../../source/editor.rst:38
|
|
|
9.
|
|
|
The edit.py file should import renpy.editor, and the Editor class should inherit from renpy.editor.Editor. As additional keyword arguments may be added to methods, each method you define should ignore unknown keyword arguments. Since you're expected to define your own Editor subclass, we present the methods with the `self` parameter.
|
|
|
|
|
edit.py文件应导入renpy.editor中，同时编辑器类应从renpy.editor.Editor中继承。作为可能添加到方法中的关键参数，每个您定义的方法应忽略掉未知的关键参数。为了给您定义自己的编辑器子类，我们使用`self`参数（引数，parameter）来提供方法。
|
|
Translated and reviewed by
Huang Junjie
|
|
|
|
Located in
../../source/editor.rst:45
|
|
|
10.
|
|
|
Starts an editor transaction.
|
|
|
|
|
启动编辑器事务
|
|
Translated and reviewed by
Huang Junjie
|
|
|
|
Located in
../../source/editor.rst:55
|
