ポテトエディタ 取り扱い説明書
最終更新日：２０２４年３月２４日
この説明書では、一部にGreenPadのReadme.txtを引用しています。
目次
| ポテトエディタとは？ | 0101 | |
| これは何？ | 0102 | |
| 特徴 | 0103 | |
| キーボードショートカット | 0104 | |
| 導入 | 0201 | |
| インストール | 0202 | |
| アンインストール | 0203 | |
| セキュリティソフトの注意 | 0204 | |
| 共通設定 | 0301 | |
| ファイル・フィルタ | 0302 | |
| 日時の書式 | 0303 | |
| フリーカーソル | 0304 | |
| 他で更新された時 | 0305 | |
| 文書タイプ別設定 | 0401 | |
| 文書タイプ | 0402 | |
| レイアウト | 0403 | |
| キーワード | 0404 | |
| 登録 | 0405 | |
| レイアウトファイルの作り方 | 0406 | |
| キーワードファイルの作り方 | 0407 | |
| キーワードファイルの書き方 | 0408 | |
| 先頭強調 | 0409 | |
| 検索・置換 | 0501 | |
| コマンド | 0502 | |
| 正規表現 | 0503 | |
| \n | 0504 | |
| ＧＲＥＰ | 0505 | |
| 入力補完 | 0601 | |
| 入力補完とは | 0602 | |
| 使い方 | 0603 | |
| ファイル作成方法 | 0604 | |
| さらなる機能 | 0701 | |
| コマンドラインオプション | 0702 | |
| 文字コード番号 | 0703 | |
| iniファイル | 0704 | |
| Ｑ＆Ａ | 0801 | |
| Unicode対応 | 0802 |
ポテトエディタとは？
＜これは何？＞Windows上で動作する、テキストエディタです。
なんでもできる高機能エディタではなく、メモ帳の代わりとして
使えるような、最低限の機能は備えつつ高速に動作する簡易テキ
ストエディタを目指して開発されています。
（原作者GreenPadより）
↓
これに機能付加したテキストエディタです。
ライターさん向けかプログラマーさん向けかで言ったら
プログラマーさん向けです。
基本はシンプルなので、初心者さんでもキーボードを
カタカタいじっていただければ使えると思います。
＜特徴＞
・内部処理はUnicode
・プロポーショナルフォントが使える
・キーワード色分けが出来る
・文字コードはいわゆる SJIS, EUC, JIS, UTF8, UTF7, UTF16 などの
他にも、Windowsがサポートしていればそれに合わせて色々対応
・改行コードは CRLF/CR/LF に対応
・出来る限りの無限Undo可能
・ショボめの正規表現検索機能内蔵
・更新された行を３色で色分け
・フリーカーソルモードが使える
・行頭８桁目までに、指定の文字があった場合、強調
＜キーボードショートカット＞
基本的な使い方は、Windowsの標準的なテキスト編集方法と
同じです。適当に勢いで使ってください。
Windowsの一般的なものではないかもしれないキーボード
ショートカットは次の通りです。
| Ctrl+R | 開き直す |
| Shift+Ctrl+S | 別名保存 |
| Ctrl+Y | Redo |
| F5 | 日時の挿入 |
| Ctrl+F | 検索・置換 |
| Ctrl+H | 検索・置換 |
| F3 | 次を検索 |
| Shift+F3 | 前を検索 |
| Ctrl+F3 | 次を置換 |
| Shift+Ctrl+F3 | 前を置換 |
| Ctrl+J | ジャンプ |
| Ctrl+G | Grep |
| Ctrl+1 | 折り返しなし |
| Ctrl+2 | 指定幅折り返し |
| Ctrl+3 | 右端折り返し |
| Ctrl+↑ | ３行単位でカーソル移動 |
| Ctrl+↓ | ３行単位でカーソル移動 |
| Ctrl+→ | トークン単位でカーソル移動 |
| Ctrl+← | トークン単位でカーソル移動 |
| Shift+変換 | 選択範囲を再変換 |
| Ctrl+BS | 確定取消 |
| 選択した状態で | |
| Tab | 行頭タブ挿入 |
| Shift+Tab | 行頭タブ削除 |
導入
＜インストール＞インストーラーはありません。
zip形式にて圧縮されています。
ファイルを選択して、右クリックでを実行してください。
フォルダを訊かれますので、「C:\FreeWare\」 などと
適当にフォルダを選択して解凍してください。
＜アンインストール＞
そのままフォルダを削除すればＯＫです。
ただし拡張子の関連付けを行った場合は、
レジストリを削除する必要があります。（そういうのを気にする方は…）
残っていても支障はありません。
また、レジストリにはWindowsの重要な設定が書いてありますので
間違えるとWindowsそのものが動かなくなることがあります。
なので、ここではその方法を書きません。
ネットを検索して分かる方のみ行ってください。
＜セキュリティソフトの注意＞
セキュリティソフトを使っていると、
インストール時に警告等が出る可能性がありますが、
ポテトエディタはウィルスではありません。安心してお使いください。
ポテトエディタの知名度が低いからですな。m(_ _)m
また、Nortonさんを使っていると、保存時に警告が表示され
保存できないときがあります。（「遮断した脅威」と表示。）
これは、
「誰かもわからぬ者が勝手にファイルを変更しないように」
というNortonさんの慎重な対応だと思われます。
「詳細を表示」―「プロセスの除外」をクリックしてください。
また、Nortonさんは、プログラムにバグがある場合も
発見してくれます。
その場合は、作者にお知らせくださいませ。
共通設定
＜ファイル・フィルタ＞メニューの―で開かれるダイアログに表示する
ファイルの拡張子を記述します。
*.xxx の形式で記述します。
複数ある場合は、セミコロンで区切って記述します。
例）
*.txt;*.cpp;*.h;*.html
＜日時の書式＞
メニューの―で、
出力するタイムスタンプの形式を記述します。
[編集]ボタンを押すと、リストボックスから選べます。
ここでは、「２桁ゼロ」「２桁空白」「１桁」の違いを書いておきます。
２桁ゼロ ２桁空白 １桁 "06年02月" " 6年 2月" "6年2月"
＜フリーカーソル＞
フリーカーソルは、改行を超えてどこでも
カーソル移動可能な機能です。
もし、改行より右に文字を入力すると、半角空白で満たされます。
[フリー時、タブを挿入する]にチェックが入っていると、
タブを含めた空白になります。
メニューの―は一時的な設定です。
ポテトエディタを起ち上げ直すと戻ります。
＜他で更新された時＞
現在、ポテトエディタで編集中のファイルが
別のエディタなどで開かれて、更新された時
通知を受け取るかどうかを設定できます。
文書タイプ別設定
＜文書タイプ＞メニューの―の一覧から
項目を選ぶことで、適切な表示形式を選べます。
また、メニューの―からを選択し
文書タイプの状態を変更することができます。
以下、その設定方法です。
＜レイアウト＞
レイアウトは、フォントサイズなど見た目に関する設定です。
レイアウトには、"default.lay"というレイアウトファイルが用意されています。
これは、何も設定されていないときに、読み込まれる設定ファイルです。
例えば、ポテトエディタには、*.txtという拡張子用に
レイアウトが関連付けられた文書タイプが用意されていません。
よって、拡張子txtのファイルを開くと、
default.layの値が読まれます。
このように、標準の設定を使いたい場合は
関連付けられた文書タイプを作成しない、
レイアウトファイルを作成しない、又は、ファイルに項目を記述しない
ということになります。
以下、[DLG]でファイルに項目を記述しない方法です。
・文字列、数字を記入する箇所では
未入力にすることで、標準になります。
・チェックボックスは、
あいまい状態にすることで、標準になります。
＜キーワード＞
キーワードは、プログラミングの強調表示に関する設定です。
if while 等を青く表示するなどのキーワード表示。
/* */ 等を緑色に表示するなどのコメント表示。
先頭８桁目までの文字で、行全体を強調する先頭強調があります。
もちろん、何色かは別途（レイアウトで）指定できます。
＜登録＞
ここでは、実際に登録しながら、
その使い方を見ていきたいと思います。
[追加]ボタンを押すと、[文書タイプの追加]ダイアログが開きます。
名前に"COBOL"
拡張子に
(cbl|cob) と入力してください。複数ある場合は、カッコで全体を囲い、縦棒で区切ってください。
[OK]ボタンを押します。
キーワードに"cobol.kwd"を選択してください。
レイアウトに"ポテト.lay"又は"program.lay"を選択してください。
登録は以上です。
＜レイアウトファイルの作り方＞
レイアウトファイルを追加したい場合は、
"新しいテキストドキュメント"を作成し、
拡張子に lay をつけて type フォルダに置いてください。
メニューの―の
レイアウト横の [DLG] ボタンを押すとダイアログが開きます。
[OK] ボタンを押せば、適切な形式で保存されます。
項目を省略すると、その項目に関しては default.lay の
内容が読み込まれます。default.lay も無いときは exe 内に
内蔵してあるデフォルトの設定が読み込まれます。
＜キーワードファイルの作り方＞
キーワードファイルを追加したい場合は、
"新しいテキストドキュメント"を作成し、
拡張子に kwd をつけて type フォルダに置いてください。
メニューの――の
キーワード横の [DLG] ボタンを押すとダイアログが開きます。
[OK] ボタンを押せば、適切な形式で保存されます。
[DLG] ボタンを押せば、簡単に入力できますが、
キーワードの文字列入力だけは、むしろテキストエディタで
行ったほうが便利かもしれません。
その場合、[編集]ボタンを押して直にテキスト入力してください。
そのためのキーワード概略を書いておきます。
| １行目： flag |
| ２行目： ブロックコメント開始Ａ |
| ３行目： ブロックコメント終了Ａ |
| ４行目： ラインコメントＤ |
| ５行目： ブロックコメント開始Ｂ |
| ６行目： ブロックコメント終了Ｂ |
| ７行目： ラインコメントＥ |
| ８行目： ブロックコメント開始Ｃ（ブロックＢからのネスト） |
| ９行目： ブロックコメント終了Ｃ（ブロックＢからのネスト） |
| １０行目： ラインコメントＦ |
| １１行目： コメントの最大トークンの数－１ |
| １２行目： 先頭強調の桁数 |
| １３行目： 先頭強調の文字 |
| １４行目以降： キーワードＡ |
| １行空けて： キーワードＢ |
| １行空けて： キーワードＣ |
＜キーワードファイルの書き方＞
キーワード ====================
強調表示したい単語をひたすら書き連ねる
キーワードとして使えるのは、
数字、アルファベット(大小)、下線
からなる単語のみ。border-width とか #include とかはダメ。
__int64 などは可。
コメント ======================
コメント記号としては、
空白文字を除いたASCII文字のみが使える。
ここで、数字、アルファベット(大小)、下線を「文字」と呼ぶことにし
それ以外の - # * 等を「記号」と呼ぶことにします。
「記号」から始まった場合、途中に「文字」と「記号」を
挟むことができますが、
「文字」から始まった場合、途中に「記号」を挟むことはできません。
正しい例
/* rem =begin <comment>
ダメな例（ってこんな言語あるかわかりませんが…）
begin= _*
＜先頭強調＞
先頭強調はCOBOLのコメントのために考えたものです。
他にも引用符の強調に使えると思ったので、
あえてコメントとはしませんでした。
また、コメントではないので、行全体の色を変えるだけです。
その前後にブロックコメントがあった場合、
コメントが有効となりますのでご注意ください。
例えば
１桁目に > という先頭強調をした場合。
> /* 先頭強調の色だがブロックコメント /* が有効 ABC ブロックコメントの範囲内 */ DEF */ でブロックコメント終了指定方法は、[桁位置]を「1桁目」から「8桁目」までで選んで
文字を指定します。
文字は４文字まで入力できます。その際、４文字の内いずれかがあった場合、
強調されます。
検索・置換
＜コマンド＞検索・置換ダイアログを開くのは Ctrl+F または Ctrl+H です。
次のアクセラレーターキーが用意されています。
F3 で次（下）への検索が出来ます。
Shift+F3 で前（上）への検索が出来ます。
Ctrl+F3 で次（下）への置換が出来ます。
Shift+Ctrl+F3 で前（上）への置換が出来ます。
＜正規表現＞
検索には正規表現がちょびっと使えます。
対応している正規表現は以下のとおりです。
正規表現はこれらのメタ文字を使って、文字を表現します
^ $ . | [] () * + ? \
| 文字や文字グループを意味するメタ文字 | ||
| . | どんな文字でも一文字 | |
| a あ | ||
| | | 区切られたいずれかの文字 | |
| abc|def | abc か def | |
| [] | カッコ内のいずれかの文字 | |
| [abcd] | a か b か c か d | |
| [a-d] | a から d までの文字のいずれか | |
| [^a-d] | a から d 以外の文字のいずれか | |
| () | グループ化。カッコ内の文字をまとめる | |
| Windows(8|10|11) | Windows8 か Windows10 か Windows11 | |
| 繰り返しを意味するメタ文字 | ||
| * | 0回以上 | |
| ab* | a や ab や abbbb など | |
| + | 1回以上 | |
| ab+ | ab や abbbb など | |
| ? | 0回か1回 | |
| ab? | a か ab | |
| 場所を意味するメタ文字 | ||
| ^ | 行頭 | |
| ^[0-9] | 行頭にある数字 | |
| $ | 行末 | |
| .$ | 行末の何か1文字 | |
| エスケープ文字 | ||
| \ | メタ文字自体を表現するのに使う | |
| dir\\file\.txt | dir\file.txt | |
| [] 内では必要ない。ただし、^ や ] を表現するのには必要 | ||
| その他 | ||
| \t | タブ | |
| \n | 改行 | |
| 置き換えのメタ文字 | ||
| \w | [a-zA-Z0-9_] | 英数字 |
| \W | [^a-zA-Z0-9_] | 英数字以外 |
| \d | [0-9] | 数字 |
| \D | [^0-9] | 数字以外 |
| \s | [\t ] | 空白・タブ |
| \S | [^\t ] | 空白・タブ以外 |
＜\n＞
改行は\nです。（正規表現指定時）
複数行の検索は出来ませんので、検索文字列に含む場合は、
末尾にのみ指定可能です。
置換文字列には、複数個あっても構いません。
＜ＧＲＥＰ＞
"Grep"とは複数のファイルから、検索するシステムです。
"Grep"用のプログラムをインストールしておく必要があります。
メニューの―の外部Grep欄に
入力しておくことでポテトエディタから起動できます。例として私の環境では
C:\FreeWare\HNXgrep\HNXgrep.exe "%D"
となっています。外部ツールの起動時に、%D は「現在開いているファイルのあるフォルダ」
%F は「現在開いているファイルのフルパス名」
%N は「現在開いているファイルの名前部分」
に置き換わります。ちなみに作者のおすすめGrepプログラムは
HNXgrep (http://hp.vector.co.jp/authors/VA055804/)
です。
入力補完
＜入力補完とは＞文字を入力し始めると、リストが出てきて選べるという
あのシステムです。
ポテトエディタでは、半角英数字、下線のみ認識します。
ひらがな等は、MS-IMEやATOKが標準で使えるようになっていますので
そちらで対応してください。
＜使い方＞
メニューの―で
入力補完を使うにチェックを入れてください。
必要に応じて自動入力にチェックを入れてください。
後は、使う辞書を選択しなければなりません。
の、入力補完の欄で使う辞書を設定してください。
ポテトエディタでは、"C.cmp"しか用意されていません。
私の力不足です。 m(_ _)m
必要に応じて作成してください。
自動入力にチェックが入っている場合、文字の入力を始めると
自動的にリストボックスが表示されて、選択できるようになります。
Enterキーで決定です。
自動入力でない場合は、Ctrl+Spaceで起動です。
メニューの―を実行すると
現在、編集中のテキストから、自動的に単語を拾い上げ
辞書に追加してくれます。
＜ファイル作成方法＞
入力補完で認識できる文字は、半角英数・下線です。
１行１単語で、テキストファイルにひたすら入力していきます。
ただし、テキストには記号も記述できるため
Beep(DWORD Freq, DWORD Duration)といった説明を付属して記述させることも可能です。
これは、ポテトエディタVer.0.14にあったクイックヒントを
兼ねた技術だと思います。
文字列一覧を入力し終えたら、―で、
文字コードを UTF16LE(BOM) 形式にして保存してください。
拡張子は cmp です。
さらなる機能
＜コマンドラインオプション＞-l : 行番号指定
-c : 文字コード指定
の２つがあります。
potato -l543 -c932 aaaa.txtで、強制的にShiftJISで、aaaa.txtを開き、
543行目を一番上にした状態で起動します。
potato aaaa.txt -l543 -c932ではダメです。オプションはファイル名より前に。
potato -l123 aaaa.txt -l456 bbbb.txtとやって２つのファイルを開くことは可能。
-cの後ろの数字は、下にあげる"文字コード番号"を指定します。
＜文字コード番号＞
一部のコードにはポテトエディタ内で特別に負の数を割り振って
います。以下の値を使ってください。
| SJIS | = 932 | // 日本語１ | (Shift_JIS) |
| EucJP | = -932 | // 日本語２ | (日本語EUC) |
| IsoJP | = -933 | // 日本語３ | (ISO-2022-JP) |
| Western | = -1 | // 欧米 | (Windows1252 ＞ ISO-8859-1) |
| IsoKR | = -950 | // 韓国語２ | (ISO-2022-KR) |
| IsoCN | = -936 | // 中国語２ | (簡体字 ISO-2022-CN) |
| HZ | = -937 | // 中国語３ | (簡体字 HZ-GB2312) |
| UTF5 | = -2 | // Unicode | (UTF-5) : BOM無し |
| UTF8 | = -65001 | // Unicode | (UTF-8) : BOM有り |
| UTF16b | = -3 | // Unicode | (UTF-16) : BOM有り BE |
| UTF16l | = -4 | // Unicode | (UTF-16) : BOM有り LE |
| UTF16BE | = -5 | // Unicode | (UTF-16BE) : BOM無し |
| UTF16LE | = -6 | // Unicode | (UTF-16LE) : BOM無し |
| UTF32b | = -7 | // Unicode | (UTF-32) : BOM有り BE |
| UTF32l | = -8 | // Unicode | (UTF-32) : BOM有り LE |
| UTF32BE | = -9 | // Unicode | (UTF-32BE) : BOM無し |
| UTF32LE | = -10 | // Unicode | (UTF-32LE) : BOM無し |
＜iniファイル＞
設定ダイアログで設定するとここに書き込まれます。
Windowsのごく普通のINIファイル。ANSI-CP (日本ならShift_JIS)+CRLF で
書かねばなりません。例として、次のような感じになります。
[ユーザー名] UndoLimit= // アンドゥ回数制限。-1 なら制限無し TxtFilter= // [開く]ダイアログ用のフィルタ。*.xxx の形で、; で区切ること OpenSame= // 同じウインドウで開くなら1、でなければ0。 CountUni= // 俗に言う半角全角を区別せず、横の桁数を数える StatusBar= // ステータスバーを表示するなら1、でなければ0。 GrepExe= // Grep用に使う外部アプリ起動のコマンドを入れる。 MRU= // [最近開いたファイル] に表示する個数。最大２０個 MRU#= // [最近開いたファイル] を保存 SearchIgnoreCase= // 検索の時大文字小文字の違いを無視するかどうか SearchRegExp= // 正規表現検索するかどうか SearchWholeWord= // 単語単位で検索するなら1 NewfileCharset= // 新規作成したファイルの文字コード NewfileLB= // 新規作成したファイルの改行コード NewfileDoctype= // 新規作成したファイルの文書タイプ RememberWindowSize= // ウインドウサイズを再開時に再現するなら1 RememberWindowPos= // ウインドウ位置を再開時に再現するなら1 WndX= WndY= WndW= WndH= WndM= // 記憶されたウインドウサイズや位置 FreeCursor= // フリーカーソルモードにするなら1 InsertTab,inFreeArea= // キャレットがフリー状態の時に文字入力した際、 // 半角空白ではなくタブを挿入するなら1 DateTimeFormat= // 日時の挿入で出力する文字列。 PrintLN= // 行番号を印刷するなら1、でなければ0。 PrintHd= // ヘッダーを印刷するなら1、でなければ0。 PrintFt= // フッターを印刷するなら1、でなければ0。 PrintHeader= // ヘッダーを印刷する際、出力する文字列。 PrintFooter= // フッターを印刷する際、出力する文字列。 PrintMarginLeft= PrintMarginRight= PrintMarginTop= PrintMarginBottom= // 1/100mm単位の印刷余白。例）3mmなら300。 [DocType] 1= 2= // 文書タイプの名前を列挙。連番なら幾つまで並べてもOK [文書タイプ名] Pattern= // この文書タイプを自動適用するファイル名を正規表現で // （ファイル名全体にマッチするように） Keyword= // キーワードファイルの名前 Layout= // レイアウトファイルの名前 //----------------------------------------------------------------ユーザーごとに設定を変えたりしたくない場合は、次のように、
SharedConfigというセクションと、Enable=1 という行を書いておく。
//---------------------------------------------------------------- [SharedConfig] Enable=1 //----------------------------------------------------------------こうすると、設定項目はすべてこのSharedConfigセクションから読み書き
されるようになる。設定済みポテトエディタをiniと合わせて色々な環境へ
持ち運びたいときに便利。
Ｑ＆Ａ
＜Unicode対応なはずなのに日本語以外の字が表示できないよ？＞対応するフォントが必要です。
以前、Microsoft Officeに Arial Unicode MS というフォントが
付属していたようです。これはUnicode文字を網羅するよう
作られていたようですが、現在は開発中止とのこと。
とはいえ、昔から使われてるＭＳ ゴシック、ＭＳ 明朝も割と多くの
言語をカバーしているようです。