tidtools¶ ↑
tidtoolsは、TiddlyWikiをより使いやすくするためのコマンドラインツール群です。Wiki内の検索等、様々なツールが用意されています。RubyGem経由で簡単にインストール可能です。
INSTALL:¶ ↑
通常のgemインストールと同様です。
gem install tidtools
DESCRIPTION:¶ ↑
インストールすると以下のツールが使えるようになります。
- tiddler2texts
-
TiddlyWikiをTiddlerごとのテキストファイルに分割
- tidgrep
-
TiddlyWikiファイルをgrep検索
- twgrep
-
TiddlyWiki内のつぶやき形式のテキストを検索
一緒に、TiddlyWikiを扱うためのライブラリもインストールされます
- Tiddler2texts
-
TiddlyWikiをTiddlerごとのテキストファイルに分割
- Tiddle
-
TiddlyWiki形式のファイルから、Tiddleの配列を取得出来る
- Tweet
-
つぶやき形式のテキストを扱う
SETUP:¶ ↑
よく使うTiddlyWikiファイルが決まっているのであれば、 環境変数 TIDDLYWIKI_PATHS を設定しておくと便利です。
.bashrcで設定するなら以下のようになります
# tidtoolsがデフォルトで検索するパス export TIDDLYWIKI_PATHS="/Users/ongaeshi/memo.html"
‘;’を区切り文字として、複数のTiddlyWikiを検索対象に指定することも出来ます。
# ';'を区切り文字にすると、複数のTiddlyWikiを検索対象に指定出来ます export TIDDLYWIKI_PATHS="/Users/ongaeshi/memo.html;/Users/ongaeshi/work.html"
FIRST_STEP:¶ ↑
環境変数を指定しておけば、ファイルの場所を指定しなくても簡単に検索が出来ます。
% tidgrep tidtools # tidtoolsと書いてあるテキストを探す SiteSubtitle:1:tidtools実験用のダミーメモ Tweet - 4:16:ノートのWindowsマシンだとスムーズにtidtoolsのインストールが出来た。 Tweet - 4:24:tidtools、まだバグがあるよ。 Tweet - 4:50:tidtools0.0.4 - twgrepを追加 . .
環境変数を設定していなくても、-fオプションを指定すれば検索出来ます。
% tidgrep -f /Users/ongaeshi/memo.html tidtools # -fで検索対象を指定(ここでも;区切りが使える) SiteSubtitle:1:tidtools実験用のダミーメモ Tweet - 4:16:ノートのWindowsマシンだとスムーズにtidtoolsのインストールが出来た。 Tweet - 4:24:tidtools、まだバグがあるよ。 Tweet - 4:50:tidtools0.0.4 - twgrepを追加 . .
twgrepはtidgrepの特殊版で、つぶやき形式という特殊な形式で書かれたテキスト専用の検索ツールです。
つぶやき形式とは、私が勝手に作ったTiddlyWikiでつぶやきっぽいテキストを書くための整形ルールです。 ‘—-’で区切りを表現し、区切りの前に日時を入れます。 また“Tweet - New”のように、TiddleのタイトルにTweetという文字列を含みます。
私は月が変わるごとに新しいTiddleを作ることにしていて、“Tweet - New”, “Tweet - 5”, “Tweet - 4”のようにTiddleを作っています。
# つぶやき形式の例 # このつぶやきは "Tweet - 4" というTiddleに保存されている おやすみー、結局こんなに遅くなった ~~@@color(gray):2010/04/06 2:28@@~~ ---- リリース失敗・・・、tidtools0.0.5を再リリース ~~@@color(gray):2010/04/06 1:21@@~~ ---- tidtools0.0.4をリリース ~~@@color(gray):2010/04/06 22:03@@~~ ---- おはよう ~~@@color(gray):2010/04/06 08:30@@~~ ----
twgrepはこんな感じで使います。
% twgrep tidtools # tidtoolsという文字を含むつぶやきを検索 --- Tweet - New -------------------- リリース失敗・・・、tidtools0.0.5を再リリース ~~@@color(gray):2010/04/06 1:21@@~~ ---- tidtools0.0.4をリリース ~~@@color(gray):2010/04/06 22:03@@~~ ----
tiddler2textsはTiddlyWikiをTiddlerごとのテキストファイルに分割します。
# output_dir/に出力 $ tiddler2texts /path/to/tiddlywiki.html output_dir
以下のようなスクリプトを書けば、複数のTiddlyWikiをまとめてテキストに変換することが可能です。
require 'rubygems' require 'tidtools/tiddler2texts' if __FILE__ == $0 Tidtools::Tiddler2texts.output('/path/to/memo1.html', 'memo1') Tidtools::Tiddler2texts.output('/path/to/memo2.html', 'memo2') end
より詳しい使い方は各コマンドのヘルプを見て下さい。
LINKS:¶ ↑
LICENSE:¶ ↑
MIT License