|
|
1.
|
|
|
Text Editor Integration
|
|
|
|
|
Integração com Editor de Texto
|
|
Translated and reviewed by
N0YkcHuGce
|
|
|
|
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 usa um editor de texto para permitir ao usuário editar os scripts do jogo a partir do inicializador e relatar erros ao usuário. Por padrão, Ren'Py usa jEdit como editor de texto quando iniciado a partir do inicializador e o editor padrão do sistema caso contrário. Isso pode ser personalizado pelo usuário conforme necessário.
|
|
Translated and reviewed by
N0YkcHuGce
|
|
|
|
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.
|
|
|
|
|
O editor é personalizado criando uma classe Editor em um arquivo .edit.py. Esta classe contém métodos que são chamados para gerenciar a edição de texto.
|
|
Translated and reviewed by
N0YkcHuGce
|
|
|
|
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.
|
|
|
|
|
Quando executado diretamente, Ren'Py primeiro examina a variável de ambiente RENPY_EDIT_PY para encontrar um arquivo .edit.py para usar. Se puder encontrar um, ele usa a classe Editor definida nesse arquivo. Caso contrário, ele usa uma classe de editor integrada que ativa o editor de uma maneira específica do sistema.
|
|
Translated and reviewed by
N0YkcHuGce
|
|
|
|
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.
|
|
|
|
|
Quando o Ren'Py Launcher é executado, ele verifica os subdiretórios do diretório de projetos e do diretório Ren'Py para encontrar arquivos no formato `name`.edit.py. (Por exemplo, ele localizaria launcher/jEdit.edit.py e myeditor/MyEditor.edit.py.) O editor mais recente com um dado `nome` é apresentado ao criador como parte das opções do launcher. O inicializador também define RENPY_EDIT_PY para o arquivo selecionado, de forma que os jogos iniciados a partir do inicializador usarão o editor selecionado.
|
|
Translated and reviewed by
N0YkcHuGce
|
|
|
|
Located in
../../source/editor.rst:23
|
|
|
6.
|
|
|
Writing an .edit.py File
|
|
|
|
|
Gravando um arquivo .edit.py
|
|
Translated and reviewed by
N0YkcHuGce
|
|
|
|
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.
|
|
|
|
|
Um arquivo edit.py é um arquivo Python (não Ren'Py) que deve definir uma única classe, chamada Editor. Ren'Py irá chamar métodos nesta classe para fazer com que a edição ocorra.
|
|
Translated and reviewed by
N0YkcHuGce
|
|
|
|
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.
|
|
|
|
|
O uso do editor é feito como parte de uma transação do editor, que agrupa as operações relacionadas. Por exemplo, se uma transação do editor solicitar uma nova janela, todos os arquivos dessa transação deverão ser abertos na mesma nova janela. Uma transação do editor começa com uma chamada para o método inicial, pode conter uma ou mais chamadas para métodos de operação e termina com uma chamada para o método final.
|
|
Translated and reviewed by
N0YkcHuGce
|
|
|
|
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.
|
|
|
|
|
O arquivo edit.py deve importar renpy.editor e a classe Editor deve ser herdada de renpy.editor.Editor. Como argumentos de palavra-chave adicionais podem ser adicionados aos métodos, cada método que você definir deve ignorar argumentos de palavra-chave desconhecidos. Como você deve definir sua própria subclasse de Editor, apresentamos os métodos com o parâmetro `self`.
|
|
Translated and reviewed by
N0YkcHuGce
|
|
|
|
Located in
../../source/editor.rst:45
|
|
|
10.
|
|
|
Starts an editor transaction.
|
|
|
|
|
Inicia uma transação do editor.
|
|
Translated and reviewed by
N0YkcHuGce
|
|
|
|
Located in
../../source/editor.rst:55
|
