SciTE 解説書

SciTE 解説 SciTE Documentation

よくある質問 Frequently Asked Questions

一般的な編集 Standard Editing

SciTE での文書編集は大部分の Macintosh や Windows のエディタに似ています。これらに加えて、文書構造に基づく自動的な文字装飾を行うことができます。SciTE は複数のファイルを一度に記憶することができますが、見ることができるのはそのうちの一つだけです。初期設定では記憶可能なファイルも一つだけになっていますが、これは特性 buffers の値を編集することで変更できます。
SciTE はテキストの矩形選択が可能です。Windows では Alt キー、GTK+ では Ctrl キーを押しながらマウスをドラッグしてください。

Text editing in SciTE works similarly to most Macintosh or Windows editors with the added feature of automatic syntax styling. SciTE can hold multiple files in memory at one time but only one file will be visible. SciTE's initial configuration only allows one file to be in memory at once but this can be modified by changing the value of the buffers property. Rectangular regions of text can be selected in SciTE by holding down the Alt key on Windows or the Ctrl key on GTK+ while dragging the mouse over the text.

SciTE には二つのペイン(区画)があります。編集部と出力部です。編集部の右または下に出力部があります。出力部は最初の時点で区切り線しか見えませんが、その区切り線をドラッグすることで見えるように大きさを変えることができます。「オプション」メニューの「左右に分割」にチェックが入っていると編集部と出力部の位置関係を変えることができます。

There are two panes in SciTE, the editing pane and the output pane. The output pane is located either to the right of the editing pane or below it. Initially it is of zero size, but it can be made larger by dragging the divider between it and the editing pane. The Options | Vertical Split command can be used to move the output pane beneath the editing pane.

SciTE はコンパイルしたりソースファイルを実行したりする指示を出して、それらの出力を SciTE の出力部に表示することができます。

SciTE can perform commands to compile or run source files with the output from these commands directed into the output pane.

コンピュータに Python がインストールされていたとしましょう。その状態で SciTE から「ファイル」を「新規作成」し、次のように入力してみます。

For example, if Python is installed on the machine, open a new document, type:

print "Hi"

as that document's text.

この文書を printhi.py というファイル名で保存してください。
すると、その文書は色づけなどが行われます。これは SciTE がファイルの拡張子(ここでは.py)からどの文法スタイルを使えばよいかを判断したことによります。

Save the document as printhi.py.
The document should now appear coloured as SciTE is using the file's extension to decide upon the syntax styling to use:

print "hi"

次にツールメニューから「実行」してください。
先ほど説明した「出力部」が見えていなければ自動的に大きさを持ち、見えるようになります。

Perform the Tools | Go command.
The output window will be made visible if it is not already visible and will show:

>python -u printhi.py
hi
>Exit code: 0

一行目の青い行は SciTE がどのようなコマンドを「実行」の際に発行したかを示しています。次の黒い行は Python プログラム(今作ったばかりの printhi.py)の出力です。最後の青い行はそのプログラムから SciTE が受け取った終了コードです。これが零であれば正常に実行されたことを意味します。

The first blue line is from SciTE showing the command it will use to run the program. The black line is the output from running the Python program. The last blue line is from SciTE showing that the program has finished and displaying its exit code. An exit code of zero indicates a successful run.

SciTE は Python, GCC, Visual C++, Borland C++, PHP やこれらと同じ形式の出力を行うツールについて、エラーメッセージの一部を理解します。試しに先ほどのファイルにわざとまちがった行を追加してみましょう。

SciTE partially understands the error messages produced by Python, GCC, Visual C++, Borland C++, PHP and other tools which use the same format as one of these. To see this, add a mistake to the Python file by adding a second line to make the file:

print "hi"
mistake

では、再び「ツール」メニューから「実行」します。結果は次のようになるでしょう。

Perform the Tools | Go command. The results should look like:

>python -u printhi.py
hi
Traceback (innermost last):
  File "printhi.py", line 2, in ?
    mistake
NameError: mistake
>Exit code: 1

今回の場合はどこに問題があるのかすぐにわかりますが、もっとソースファイルが大きい時はツールメニューの「次のメッセージ」で報告されたエラーをたどることができます。「次のメッセージ」を使うと、最初のエラーメッセージが黄色の背景色で強調されて編集部の該当行にエラーの印がつけられます。キャレットはその行に移動し必要であればスクロールも行われます。結果 SciTE は次のようになっているはずです。

While it is easy to see where the problem is in this simple case, when a file is larger the Tools | Next Message command can be used to view each of the reported errors. Upon performing Tools | Next Message, the first error message in the output pane is highlighted with a yellow background, and an error indicator is displayed for the appropriate line in the editing pane. The caret is moved to this line and the pane is scrolled if needed to show the line. SciTE now looks like this:

SciTE はエラーメッセージのファイル名部分と行番号部分をほぼ常に解釈でき、そのためにエラーの原因となった他のファイル（例えばヘッダファイル）を開くこともあります。ただしファイル名が空白や ".." を含んでいるような複雑な場合にはこの動作をしないことがあります。

SciTE understands both the file name and line number parts of error messages in most cases so can open another file (such as a header file) if errors were caused by that file. This feature may not work where the file name is complicated by containing spaces or ".."

コマンド実行に失敗してその完了までに時間がかかりすぎる場合には、ツールメニューの「実行の中断」が利用できます。

If command execution has failed and is taking too long to complete then the Tools | Stop Executing command can be used.

Windows においては、初期設定の SciTE はこのようなツールをコマンドラインプログラムとして実行します。この状態で GUI プログラムを実行するとそのウィンドウが表示されないまま実行されることになります。command.subsystem オプションにより GUI モードで実行させるよう定義することができます。subsystem オプションの省略値は 0 でこれはコマンドラインプログラム、1 であれば対象プログラムが自分でウィンドウを作るようになり、2 を指定すると ShellExecute 呼び出しを使うようになります。 ShellExecute は HTML ファイルなどを開くよい方法です。これはユーザがシェルからファイルを開く時と同じ動作をすることになっているからです。3 は内部の拡張子や director の拡張子を呼び出すことに用います（あとで訳し直した方がいいと思う。ということで未訳）。4は Windows 仕様のHTMLヘルプを読むプログラムを呼び出すときに使います。5 は Windows 仕様の WinHelp 関数を呼び出すときに使います。GTK+ では省略値である subsystem = 0 でツールを実行した後それが終了するまで待ち、またその出力を SciTE の出力部に渡します。subsystem = 2 の時はバックグラウンドでツールを実行します。

On Windows, SciTE defaults to executing tools as command line programs. Executing a GUI program in this mode results in that program being run without displaying a window. The command.subsystem option can be used to define tools that run in GUI mode. The default subsystem, 0, is for command line programs, 1 is for programs which create their own windows, and 2 is for using the ShellExecute call. ShellExecute is a good way to open HTML files and similar as it handles this similarly to a user opening the file from property the shell. 3 is for calling an internal extension or director extension, 4 is for calling the Windows specific HtmlHelp program and 5 is for calling the Windows specific WinHelp function. On GTK+, the default subsystem 0 executes the tool and waits for it to finish, redirecting output to the output pane and subsystem 2 executes the tool in the background.

コマンドライン引数 Command line arguments

SciTE に渡すことができるコマンドライン引数は、ファイル名、指示、特性です。指示と特性は "-" が先行し、 '.' やアルファベットではない最初の文字として ':' の指示を使うことで区別します。特性は特性をまとめたファイル内とおなじ文法を使い、特性ファイルの内容を上書きします。値が記されていない特性は 1 を設定されます。二重引用符は空白を含む引数を囲む場合に用いられますが、引数全体を囲まなくてはなりません。ファイル名だけを囲むといった使い方は認められないことになります。従って "-open:x y.txt" は動作しますが -open:"x y.txt" は正しく処理できません。
Linux では標準シェルで利用できる引用符の使い方が認められます。
"-p" 引数はファイルを出力して終了します。

Command line arguments to SciTE include file names, commands and properties. Commands and properties are preceded by "-" and are differentiated by the use in commands of ':' as the first character that is not '.' or alphabetic. Properties use the syntax used in property set files and override any properties set in property files. If there is no value given for a property, it is set to 1. Double quotes may be placed around arguments that contain spaces but they must be placed around the whole argument, not just around a file name, so "-open:x y.txt" works but -open:"x y.txt" doesn't. On Linux, the standard shell quoting is available. The "-p" argument causes SciTE to print the file and then exit.

例えば次のようなコマンドラインの場合。

For example,

SciTE が起動し ScintillaGTK.cxx を開き、最近開いたファイルの一覧を読み込み、11ポイントのＭＳ ゴシックを基本フォントとして使用します。
特性のグループは特性セットファイルとして保存できます(拡張子 ".properties" を持ちます）。コマンドラインで import 指示によりこのファイルを使用できます。

starts SciTE, opens ScintillaGTK.cxx, loads the recent file list, and uses 11 point MS Gothic as the base font.
A group of properties can be saved as a property set file (with the extension ".properties") and the import command used on the command line:

数種の指示が使えますが、将来はさらに多くの事ができるようになるでしょう。現在有効なものは次の通りです。

A few commands are currently available although this will expand in the future. These commands are available:

指示には次のような C 言語形式のエスケープシーケンスを使います。

Commands use C style escape sequences which include:

次のコマンドラインは /big/icon.txt を開きます。

The following opens /big/icon.txt:

Windows における次のコマンドラインは C:\Program Files\SciTE\SciTEDoc.html を開き 123 行目に移動します。

On Windows, the following opens C:\Program Files\SciTE\SciTEDoc.html and goes to the 123th line:

コマンドライン引数は左から右へと二段階に評価されます。ファイルを開くにはユーザインタフェースが必要ですし、インタフェースが表示されるにはそれに関する特性をさらに定めなくてはならないからです。最初の段階では一番目のファイル名を開く指示がある直前までを処理します。次の段階で残りの引数が処理されます。

Command line arguments are evaluated left to right in two phases because opening files requires the user interface to be available and there is also a need to set some user interface properties before the user interface is displayed. The first phase process arguments until just before the first file name would be opened. The second phase processes the remaining arguments.

このため例えば find: や goto: の指示をファイルに対して実行するには、ファイル名のほうを先に置く必要があります。そうすれば指示の実行の前にファイルを読み込むことができます。

So, if you need to perform e.g. a find: or a goto: command on a file, you must put the command after the filename, to allow SciTE to open the file before performing the command.

Windows における注意:
簡単な形式のファイル名がディレクトリ名に一致した場合、ファイルを開くダイアログが出てきます。この動作は "open.dialog.in.file.directory" 特性の設定に影響をうけます。

もし "buffers" 特性が一より大きく、ファイル名が単一の実在ファイルかワイルドカード使用の結果一つ以上のファイルに合致すると、 "buffers" 特性で指定された数を上限として複数ファイルが読み込まれます。この場合、ディレクトリは数に含まれません。

ファイル名が単一の拡張子である場合、その名前のファイルがない限りファイルを開くダイアログが現れ、指定された拡張子はファイルフィルタとして用いられます。この拡張子指定部の前にパス名を先行させることもできます。

ファイル名が拡張子を含まない場合、拡張子の省略値として "source.default.extensions" 特性が用いられます。

For Windows:
If any simple file name on the command line matches a directory name, the file open dialog appears - this is dependant upon the property "open.dialog.in.file.directory"

If the property "buffers" is greater than one and the file name matches either a existing file or by means of a wildcard search, one or more files, the matching files are loaded up to the property "buffers" count. Directories are not considered a match in this case

If the file name is an extension, optionally preceded by a path, and no such simple file name exists, the file open dialog appears, with the given extension as the filter.

If the file name contains no extension, the property "source.default.extensions" is used to provide default extensions to attempt to match the file name to an existing file.

バッファ Buffers

それぞれがファイルの内容を保持しているバッファの最大数を設定できます。一から百までが有効です。省略値は 1 で、これはバッファの特長を利用しないことになります。複数のバッファがあるときはそれらを切り替えるためにバッファメニューが使えるようになります。ファイル名を選択するほか F6 キーで前、Shift+F6 キーで次のバッファに切り替えることができます。十以上のバッファがあると、いくつかのメニューの長さが変わってしまい、ここに含まれなかったファイルには（訳注:一回で）アクセスできなくなる問題が起こります。

SciTE may be configured to use between 1 and 100 buffers each containing a file. The default is 1 and this effectively turns off buffers. With more than one buffer, the Buffers menu can be used to switch between buffers, either by selecting the file name or using the Previous (F6) and Next (Shift+F6) commands. Setting more than 10 buffers may cause problems as some menus are fixed in length and thus files beyond that length may not be accessible.

全てのバッファがファイル内容を保持しているときに新しいファイルを開くと、保存しなくてはならないバッファの再利用する必要性がでてきます。この場合、ユーザがファイルを保存するように促す通知が表示されます。

When all the buffers contain files, then opening a new file causes a buffer to be reused which may require a file to be saved. In this case an alert is displayed to ensure the user wants the file saved.

セッション Sessions

セッションとはファイル名の一覧です。SciTE で開いているバッファの完全なセットをセッションとして保存できます。これにより後から高速な一括読みだしができるようになります。

A session is a list of file names. You can save a complete set of your currently opened buffers as a session for fast batch-loading in the future. Sessions are stored as plain text files with the extension ".ses".

ファイルメニューの「セッションを読み出す」「セッションを保存」で上記セッションの読み出しあるいは保存を行います。"save.session" 特性変数により直前のセッションを自動的に読み込む機能の有効化あるいは無効化を指定できます。

Use File | Load Session and File | Save Session to load/save sessions. You can turn on/off "last session autoloading" using SciTE properties variable "save.session".

もし "buffers" 変数が 0 になっていたら、セッションの管理は行われなくなります。

If "buffers" variable is set to "0" session management is turned off.

直前に保存したセッションの読み出しの際、現在開いているバッファは閉じられます。しかしながら、未保存バッファ内容を保存するかどうか尋ねられるのでそれまでの編集結果が(突然)失われることはありません。

Loading previously saved session will close your currently opened buffers. However you will not loose your edits, because you will be asked to save unsaved buffers first.

特定のファイルをコマンドラインで指定して開くことは "save.session" 変数を上書きすることになります。コマンドラインで特定のファイルを読み出す指示を与えると、"save.session" の値が "1" でも直前のセッションは復帰しません。これにより "save.session" は安全に利用できます。つまり、ファイルを一つだけ開きたいときに複数のファイルを開いてしまうようなことは起こらないわけです。

Opening a specific file from command line overrides "save.session" variable state. When you start SciTE loading a specific file from command line last session will not restore even if "save.session" variable is set to "1". This makes "save.session" safe to use - you will never open a couple of files when you are trying to open just one, specific file.

SciTE が理解する文書の種類 Languages understood by SciTE

SciTE は現在次の文書の文法スタイルに対応しています。

SciTE currently is able to syntax style these languages:

• Ada
• アセンブラ(NASM, MASM)Assembler (NASM, MASM)
• AutoIt
• Avenue
• バッチファイル(MS-DOS)Batch files (MS-DOS)
• Baan
• Bash
• Bullant
• C/C++/C#
• CSS
• diff files
• E-Script
• Eiffel
• Erlang
• Fortran
• Forth
• HTML
• JavaScript, VBScript, PHP, ASP が追加されている HTMLHTML with embedded JavaScript, VBScript, PHP and ASP
• IDL - MSIDL と XPIDL の両方IDL - both MSIDL and XPIDL
• INI, 特性などINI, properties and similar
• Java
• JavaScript
• LISP
• LOT
• Lout
• Lua
• Make
• Matlab
• Metapost
• MMIXAL
• nnCron
• NSIS
• Octave
• Pascal/Delphi
• Perl, 大部分は対応しますがいくつかの曖昧な場合についてうまく動作しません。Perl, most of it except for some ambiguous cases
• PostScript
• POV-Ray
• Python
• Ruby
• Scheme
• scriptol
• Specman E
• SQL とPLSQLSQL and PLSQL
• TeX と LaTeXTeX and LaTeX
• Tcl/Tk - cpp 解析機を用います。Tcl/Tk - using the cpp lexer
• VB と VBScriptVB and VBScript
• Verilog
• XML
• YAML

これらの文書に対するビルド及び実行の指示はすでに用意されていますが、誰が使っても動作するように修正を受け、検査される必要があるでしょう。

Running and building commands for some of these languages have been set up but should be checked as they will have to be modified to work for many people.

文書の種類はファイルの拡張子から決定されますが、文書の種類メニューから別の種類を指定することができます。文書の種類メニューは menu.language 特性により変更できます。

Language settings are determined from the file extension but this can be changed by selecting another language from the Language menu. The language menu can be changed with the menu.language property.

検索と置換 Find and Replace

SciTE はオプションで検索語・正規表現・合致条件・逆方向検索とファイル末端に達したらもう一方の端から検索を続けるという指定ができます。C 言語形式の逆スラッシュエスケープシーケンスを制御文字の検索や置換に利用できます。書式の詳細はコマンドライン引数の解説で紹介した物と同じです。

SciTE has options to allow searching for words, regular expressions, matching case, in the reverse direction, wrapping around the end of the document. C style backslash escapes which are listed in the command line arguments section, may be used to search and replace control characters. Replacements can be made individually, over the current selection or over the whole file. When regular expressions are used tagged subexpressions can be used in the replacement text.

SciTE はタグによる基本的な正規表現を利用できます。

SciTE supports basic regular expressions with tagging.

キーボードショートカット Keyboard commands

SciTE は Scintilla で定義されているキー操作をそのまま使っています。これは一般的な Windows や GTK+ の習慣をほぼ踏襲していることを意味します。移動キー（矢印キー, Page Up/Down, Home, End）はいずれも Shift キーを押しながら操作するとコンピュータのデータとして一続きになっている選択範囲の拡縮ができます。Shift に加えて Alt キーも押したままであれば視覚的に矩形範囲の選択ができます。Scitnilla 定義のいくつかのキーは使えないことがあります。英語ではないキーボードによる別目的の利用や GTK+ のウィンドウマネージャのようなシステムが先に処理してしまうことが原因です。user.shortcuts の設定でキーを機能に割り当てることができます。vc.home.key によって Home キーの挙動が変わることに注意してください。メニューと同じ効果を持つキー操作はメニュー自体に書かれています。メニューになく、やや一般性の低い操作は次の通りです。

SciTE uses the default key bindings defined in Scintilla, so keyboard commands in SciTE mostly follow common Windows and GTK+ conventions. All move keys (arrows, page up/down, home and end) allows to extend or reduce the stream selection when holding the Shift key, and the rectangular selection when holding the Shift and Alt keys. Some keys may not be available with some national keyboards or because they are taken by the system such as by a window manager on GTK+. The user.shortcuts setting may be used to assign a key to a function. Note that Home key behaviour is changed by the vc.home.key option. Keyboard equivalents of menu commands are listed in the menus. Some less common commands with no menu equivalent are:

省略表現 Abbreviations

省略表現を入力して編集メニューの「省略表現を展開」を実行するか Ctrl + B を入力すると、展開後の単語に置き換えられます。この対応は省略表現ファイルで定義されます。省略表現ファイルはオプションメニューから開くことができ、任意に追加することができます。

To use an abbreviation, type it and use the Expand Abbreviation command or the Ctrl+B key. The abbreviation is replaced by an expansion defined in the Abbreviations file. You can open the Abbreviations file with a command in the Options menu and add abbreviations.

省略表現ファイルの各行は "省略形=完全形" という書式になっています。省略形の名前は(厳密な意味での CR と LF のコードを除いて）どのような文字でも構いません。ASCII の上位区画の文字（アクセント付のアルファベット）も使えます。
(訳注: 日本語の場合は ASCII 上位区画の話は意味を持たない。)

特性ファイルに既述する名前には制限があります。シャープ記号(#)や空白、タブ文字を最初の文字にはできません。空白を途中に挟むことはできます。また '=' を中に挟むことはできません。省略形の名前は32文字を上限とします。「省略」形には充分な大きさでしょう。

Each line in the files looks like "abbreviation=expansion".
The abbreviations names can have any character (except perhaps control chars, surely for CR and LF), including high Ascii chars (accented chars).
Names have properties files limits: they cannot start with sharp (#) or space or tab (but can have spaces inside); and they cannot have '=' character inside.
Abbreviations names are limited to 32 characters. It is probably enough for abbreviations...

また、ここでは二つの拡張された記法が用いられます。改行を意味する '\n' と、キャレットの位置を意味する '|' です。文字としての '|' を示す場合は '||' と記述してください。簡単な例のいくつかが SciTE に含めて配布されています。

省略形の展開の際に、元の省略形が前の単語から離れている必要はありません。例えば é を 'é' と定義しておくと単語の中で展開することができます。省略形が他の省略形の末尾と同じである場合、短い方だけが展開されます。'ring' と 'gathering' が定義されていると、後者の一部が 'ring' として展開されてしまいます。

An expansion may contain new line characters indicated by '\n' and a caret position indicated by the '|' character. To include a literal '|' character, use '||'.
Some simple examples are included in the distributed Abbreviations file.
When expanding, the names don't need to be separated from the previous text. Ie. if you define é as 'é', you can expand it inside a word.
If a name is the ending of another one, only the shorter will ever be expanded. Ie. if you define 'ring' and 'gathering', the later will see only the 'ring' part expanded.

折りたたみ Folding

SciTE では Python, HTML/XML, Pascal, C++/C/Java/JavaScript の文法構造による折りたたみを利用できます。Python ではインデントにより、また他の文書では括弧を数えることにより折りたたみ可能な位置が決められます。
折りたたみの目印はクリックすることによってたたんだり再表示したりすることができます。目印表示用の余白を Ctrl+Shift+クリックすると、全ての最上位の折りたたみを切り替えます。目印に対して Ctrl+クリックするとその子要素もクリックした要素に合わせて折りたたみもしくは再表示します。目印に対して Shift+クリックするとその子要素をすべて表示します。

SciTE supports folding for Python, HTML/XML, Pascal, and C++/C/Java/JavaScript. Fold points are based upon indentation for Python and on counting braces for the other languages. The fold point markers can be clicked to expand and contract folds. Ctrl+Shift+Click in the fold margin will expand or contract all the top level folds. Ctrl+Click on a fold point to toggle it and perform the same operation on all children. Shift+Click on a fold point to show all children.

特性ファイル Properties file

特性ファイルの編集によって SciTE の動作の多くを変更することができます。

Much of SciTE's behaviour can be changed by editing the properties files.

三つの特性ファイルがあります。

• 局所特性ファイル "SciTE.properties": 編集中のファイルと同じディレクトリに置くことができます。
• ユーザ特性ファイル: Windows では "SciTEUser.properties"、GTK+ では "SciTEUser.properties" です。
• 共有特性ファイル "SciTEGlobal.properties"

これらのファイルに記された設定は、局所用 > ユーザ特性 > 共有特性設定という優先順位があります。環境変数も特性として利用できます。環境変数による特性は、特性ファイルのいずれかに「明示的な」設定記述があると無視されます。

There are three properties files used:

• Local properties file called "SciTE.properties" which may be present in the same directory as the file being edited.
• User properties file called "SciTEUser.properties" on Windows and "SciTEUser.properties" on GTK+
• Global properties file called "SciTEGlobal.properties"

Settings in the local properties file override those in the user properties file which override those in the global properties files. Environment variables are also available as properties and these are overridden by an explicit setting in one of the properties files.

共有特性設定ファイルは SciTE の各オプションの省略値を持っています。ユーザ特性ファイルは、共有特性設定ファイルをそのままにしながら設定を変更可能とします。局所用の特性ファイルは、主にコンパイル・ビルド・実行指示の内容をディレクトリ毎に変えることを意図しています。例えば私は Java Development Kit の javac コンパイラを多くの仕事に使っていますので SciTEGlobal.properties では .java ファイルのコンパイルには "javac" を使うように指定します。時に私が jvc コンパイラを使いたくなったときは、コンパイル対象があるディレクトリに SciTE.properties を作って "jvc" を使うように指定するのです。

The user properties file is intended for customisation by the user, leaving the global properties file to contain the default options distributed with SciTE. The main use of the local properties files is to change the effects of the Compile, Build and Go commands for the files in a directory. For example, I use the javac compiler from the Java Development Kit for most work, so SciTEGlobal.properties sets the command for compiling .java files to "javac". If I want to use the jvc compiler for the files in one directory, then the SciTE.properties file in that directory contains an entry setting the command to "jvc".

Windows では共有特性設定ファイルは実行ファイルと同じディレクトリにあります。ユーザ特性ファイルは環境変数 USERPROFILE が示すディレクトリか、USERPROFILE が未設定であれば実行ファイルと同じディレクトリに格納されます。
GTK+ ではユーザ特性ファイルはユーザのホームディレクトリにあり、共有特性設定ファイルを格納するディレクトリは SciTE のビルドの際に指定されています。通常は /usr/share/scite です。ただし Windows, GTK+ を問わず環境変数 "SciTE_HOME" がある場合はそれがこの二つの特性ファイルの格納先となります。

On Windows, the global properties file is located in the directory of the executable. The user properties file is looked for in the user profile directory as set in the USERPROFILE environment variable, or in the directory of the executable if USERPROFILE is not set. For GTK+ the user properties file is found in the user's home directory and the global properties in a directory set at build time - normally /usr/share/scite. If the "SciTE_HOME" environment variable is set on either Windows or GTK+ then it is where both the global and user properties files are found.

オプションメニューにはこれらの特性ファイルを開く項目があります。

There are commands in the Options menu for opening each of the properties files.

'#' で始まる行や完全に空白の行は意味のない行とされます。他の行は次のような形になっています。

The files are in approximately the same format as Java properties files which have a simple text format. Lines that start with '#' or that are completely blank are comments. Other lines are of the form

長い値については、行末に '\' を置くことで次の行に続きを書くことができます。空白文字も意味を持つため x =1 は変数 "x " の値を定義することになります。他の変数の値は $(変数名) の形で利用できます。現在編集中のファイルの名前などは次のような定義済み変数で参照できます。

For long values, a '\' character at the end of the line continues that value on the next line. Space characters are significant so x =1 defines a variable called "x ". Values may include the values of other variables by using $(variablename). There are some variables set by the environment to access the name of the current file as well:

どの変数が使われるべきかを決めるため、いくつかの手法を取ります。例えば変数 lexer は特定のファイル名で確定するかワイルドカードによって特定のグループに確定するかします。ですから:
lexer.makefile=makefile は "makefile" という解析器が "makefile" という名のファイルに使われるべきであることを示します。
lexer.*.cxx=cpp は "cpp" という解析器が "cxx" という拡張子を持つファイルに対して使われるべきであることを示します。
変数による代入は次のように左辺のファイルパターン充当にも使うことができます。
file.patterns.html=*.html;*.htm;*.asp;*.shtml
command.go.$(file.patterns.html)=file://$(FilePath)

Some features use file name patterns to see which variable to use. For example, the lexer variable can be specialised for a particular file, or a group of files based upon wildcard matching so:
lexer.makefile=makefile indicates that the lexer called "makefile" should be used on files called "makefile".
lexer.*.cxx=cpp indicates that the lexer called "cpp" should be used on files with a "cxx" extension.
Variable substitution is available on the left hand side of file pattern assignments and look like this:
file.patterns.html=*.html;*.htm;*.asp;*.shtml
command.go.$(file.patterns.html)=file://$(FilePath)

特性ファイルの入力と条件判断 Importing properties files and conditional logic

'import' という記述は、その位置に相手ファイルの内容があるかのように別のファイルの内容を挿入します。挿入される特性ファイルは import を記述しているファイルと同じディレクトリになくてはなりません。また properties という拡張子が仮定されます。"import Lua" という記述が c:\os\scite\bin\SciTEGlobal.properties というファイルにあれば c:\os\scite\bin\Lua.properties の内容が挿入されます。

The 'import' statement includes a properties file as if the text were inline at that point. The imported properties file must be in the same directory as the current file and a properties extension is assumed. Therefore a "import Lua" statement in c:\os\scite\bin\SciTEGlobal.properties will import c:\os\scite\bin\Lua.properties.

'if' は引数を一つとります。引数はその特性ファイルか基礎となる特性ファイルで定義済みの変数です。もし 0 と評価されたら「偽」とみなされます。空文字列やその時点で未定義の変数の場合も 0 と評価されます。最上位の特性と値の組として 'PLAT_GTK' か 'PLAT_WIN' が '1' に定義されています。評価の結果「真」とみなされれば後続の字下げされた記述が実行されます。字下げのない行まで来たら if 節は終了します。if 節の中では単純な記述のみが許されています。if の評価は読み込まれた時に行われます。実際に使われる時ではありません。

The 'if' statement takes one argument which is a symbol that may be defined earlier in this property set file or in a base property set. If the symbol evaluates to '0' then the test fails. An empty string or not present symbol evaluates to 0. Into the very top property set is inserted one of 'PLAT_GTK' with value '1' or 'PLAT_WIN' with value '1'. If the test succeeds then following indented statements are executed. When a non-indented statement is found the if clause is finished. Only simple set statements are allowed in if clauses. The evaluation of if statements occurs at read time, not at evaluation time.

実行時引数とプロンプト Command parameters and prompting

$(1) 〜 $(4) を実行時可変引数として使うことができます。表示メニューから「引数」を実行すると現在の四引数がダイアログに表示され、また変更することができます。このとき、元のウィンドウのキーボードショートカットも有効なままですので手早く引数を変えながら繰り返し実行を行うことができます。これに対して引数ダイアログが表示されているときに元のウィンドウに対する操作を無効にすることも可能です。'*' をコマンドの直前、先頭に与えてください。すでに前者のダイアログが出ている場合は '*' は無視されます。

SciTE has 4 properties $(1) .. $(4) which can be used to run commands with changeable parameters. To set the parameter values, use the View | Parameters command to view the modeless Parameters dialog which shows the current values of these parameters and allows setting new values. The accelerator keys for the main window remain active while this dialog is displayed, so it can be used to rapidly run a command several times with different parameters. Alternatively, a command can be made to display the modal Parameters dialog when executed by starting the command with a '*' which is otherwise ignored. If the modeless Parameters dialog is already visible, then the '*' is ignored.

特性ファイルに定義されている変数 Defined variables in properties files

いくつかの特性は Windows か GTK+ でのみ有効です。

Some properties are only available on Windows or GTK+.

  LF   UNIX 形式
  CR   Macintosh 形式
  CRLF DOS/Windows 形式

  filter - yes, no
  quiet - yes, no
  replaceselection - yes, no, auto
  savebefore - yes, no, prompt
  subsystem - console, windows, shellexec, lua, director, winhelp, htmlhelp
  groupundo - yes, no

  LF   for UNIX format
  CR   for Macintosh format
  CRLF for DOS/Windows format

  filter - accepts keyword arguments yes and no
  quiet - accepts keyword arguments yes and no
  replaceselection - accepts yes, no, and auto
  savebefore - accepts yes, no, and prompt
  subsystem - console, windows, shellexec, lua, director, winhelp, htmlhelp
  groupundo - yes or no

caret.policy.{x|y}<param> の挙動:

caret.policy.{x|y}<param> interaction:

他の文書種を利用可能にする Supporting a new language

キーワードが違うだけであるなど、すでに利用可能なものと非常に似ている文書は既存の解析器を利用できることがよくあります。既存のキーワードを新しい文書種用のキーワードで置き換えてください。Java と JavaScript は C++ 解析器を応用すると合理的に実装できました。Java は doc 注釈を加えるだけで成立していました。

For languages very similar to existing supported languages, which may only differ in a minor feature such as the keywords used, the existing lexers can often be reused. The set of keywords can then be changed to suit the new language. Java and JavaScript could have reasonably reused the C++ lexer. The Java lexer was added only to support doc comments.

既存の解析器では処理できない文書種は C++ で解析器を書き起こすことができます。Scintilla の中に実装するほか、外部モジュールとして SciTE 起動時に読み込ませることができます。lexerpath を参照してください。→SciTE に解析器を実装させる / 外部解析器を作り、実装する

For languages that can not be lexed with the existing lexers, a new lexer can be coded in C++.  These can either be built into Scintilla, or put into an external module and loaded when SciTE runs (See lexerpath).

新しい文書種の使えるようにするためには open.filter を編集して拡張子を選択できるようにしなくてはなりません。同様に、command.compile, command.build, command.go, command.go.needs の項目を追加すべきです。

The open.filter should be modified to include the file extensions used for the new language and entries added for command.compile, command.build, command.go and command.go.needs for the language.

API ファイルの作成Creating API files

The .api files can be generated by hand or by using a program.

C++ のヘッダに対しては、複数行に渡る関数プロトタイプをも完全に把握するするために ctags (訳注:日本語対応版なるものがあるらしい)をまず用い、続いて C/C++ を仮定した tags2api Python スクリプトをタグファイルに適用します。いくつかの共通ヘッダは引数一覧を __P マクロで囲んであり、注釈を含んでいます。cleanapi はこういったファイルに使用できます。

For C/C++ headers, an API file can be generated using ctags and then the tags2api Python script (which assumes C/C++ source) on the tags file to grab complete multiple line function prototypes. Some common headers surround parameter lists with a __P macro and may have comments. The cleanapi utility may be used on these files.

gen_python スクリプトで Python モジュール用 API ファイルを作ることができます。

To generate an API file for Python modules, there is a gen_python script.

ApiBuilder.javaで Java クラス用 API ファイルを作ることができます。

To generate an API file for Java classes, there is a ApiBuilder.java program.

他の言語で SciTE を使うSciTE in other languages

SciTE は他の言語に翻訳したものを利用できます。

SciTE can be and has been translated into other languages.

SciTE をビルドするBuilding SciTE

SciTE のビルドとインストールの方法については SciTE の README ファイルに記述しています。

The procedure for building and installing SciTE is described in the README file in the scite directory.

Scintilla's Internal Design (Scintilla コンポーネントデザイン)

Scintilla's Internal Design

SciTE Versions (SciTE - Scintilla の実装)

SciTE Versions

Description of this Japanese Scite-doc translation

SciTE を拡張するExtending SciTE

SciTE を拡張する通常のインタフェースは二つあります。ひとつは SciTE 拡張インタフェースで、SciTE の実行可能ファイルに一緒にコンパイルされます。他方は SciTE Director インタフェースで、Windows において他のアプリケーションから SciTE を操作するために使います。

There are two formal extension interfaces for SciTE, the SciTE Extension Interface is for extending SciTE with code compiled into the SciTE executable and the SciTE Director Interface is for manipulating SciTE on Windows from another application.