命令一覧(絞り込み/並べ替え可能なオフライン web ページ)

Post Reply
User avatar
tos1
Site Admin
Posts: 5
Joined: Mon May 13, 2024 7:05 am UTC

命令一覧(絞り込み/並べ替え可能なオフライン web ページ)

Post by tos1 »

1. HTML サンプル・ページ
MOD 開発システムに含まれる header_operations.py (と その拡張版)は、経験豊富な MOD 開発者も頻繁に参照する、重要なファイルの 1 つですが、テキスト・エディタやコマンド・ラインでファイル全体の情報を検索しようとすると、煩雑な作業になりがちです。
Image
そこで、MOD 開発者(と将来の MOD 開発者)の助けになるよう、オフラインで Web ページとして参照する、並べ替え/絞り込みが可能な「命令一覧」を作成しました。

Image
(↑これは図です。デモではありません。)

このサンプル・ページでは、Eärendil Ardamírë 氏の gitLab からダウンロードした header_operations expanded version v.1.0.3 (Nov 21 2021) を HTML 化して組み入れてあります。

ダウンロード
このフォーラム内のこの英語の投稿で 1 つ目の「Download」と書かれた箇所からサンプル・ページ(web 文書)をダウンロードできます。

特徴:
  • コメントは命令ごとに 1 行に統合され、検索と翻訳が容易。
  • 複数列の並べ替え。1 番目の列をクリック後、Shift を押しながら 2 番目の列をクリック。
  • 検索欄には、正規表現、AND、OR、>、<=、>=、<、!=、列番号などを指定可。
  • 列幅を操作可能。
  • ページャ(絞り込んだ結果の行数、ページ・ジャンプなど)。
  • ネット接続は不要(絞り込みコマンドのヘルプ・ページへのリンクを除く)。
絞り込みコマンドの詳細については、こちら(tablesorter の Filter ウィジェット)を参照して下さい。検索欄に n: のような列番号を使用することもできます。 例えば 4:is なら、opName(命令名)の列に「is」が含まれる行を検索します。

2. コンバータ
サンプル Web ページには、<table> ~ </table> タグが 1 セットが含まれています。 header_operations.py(や その拡張版)が改訂されたり、コメントを翻訳した時に、特定の相対ディレクトリからファイルが自動的に読み込まれると便利ですが、最近の Web ブラウザーはセキュリティ上の理由から、任意のローカル・ファイルを自動的に読み込まないように設計されています。また、ユーザがページを開くたびにファイル選択ダイアログでファイルを選択しなければならないのは不便に思えますし、ページ全体をサーバ上に置くとオフライン環境で使えなくなり、やはり不便です。

そこで、header_operations.py から HTML の <table> ~ </table> に変換するコンバータ(独立した Python スクリプト)を用意しました。

headr_operations.py - HTML コンバータ(Python スクリプト)のダウンロード
上と同じ英語の投稿 の下のほうにある 2 つ目の「Download」と書かれた箇所からコンバータをダウンロードできます。

そこに含まれる readme.txt にもあるように、例えばコマンド プロンプトや Cygwin の bash (シェル) で実行するなら下記のようにします。「-」は標準入力からの読み込み、「>」は標準出力を後ろに書いたファイルに上書き出力です。必要に応じて各ファイルにパスを付けて下さい。先頭の「LANG=C」は、入力ファイル header_operations.py が Unicode でも対処できるようにします。例えば日本語に翻訳済みのファイルを入力に渡すことができます。

Code: Select all

(Cygwin の bash の場合)
LANG=C cat header_operations.py | python hdrope2tbl_1a.py - > out1.txt

(コマンド プロンプト の場合)
type header_operations.py | python hdrope2tbl_1a.py - > out1.txt
いずれにしても、<table>~</table> だけを出力するので、web ページ全体に直接上書きしないよう注意して下さい。
sortable_ja2a.jpg
sortable_ja2a.jpg (227.01 KiB) Viewed 532 times
3. ライセンスと免責事項
ここで使用している header_operations.pyファイル、tablesorter、Filter Widget、JQueryライブラリのライセンスについては、自己責任でご確認ください。その他の部分(<table>タグ以外のサンプル Web ページやコンバータなど)は、作者に通知することなく自由に改変・再配布することができますが、作者は、ユーザーがこれらを使ったことで被った いかなる損失、損害、不利益についても保証しません。

バグや機能提案には可能な限り積極的かつ迅速に対応するつもりますが、常にそうすると約束は できません。 :|

4. 貢献者への謝辞
このツールは、TW 社のフォーラムなどで公開された多くの開発者や提案者による非公式の成果に基づいています。情報源の入口の 1 つ:
Better MS Scripting Reference: header_operations expanded
Post Reply