TITLE 付属ツールの使い方

contrib/ 以下に同梱してあるツール群について説明します。

HD 2 hnf2tdf.pl
hnsの日記ソースである hnf を
TDSの日記ソースである tdf にコンバートします。
いわゆる乗り換えツールです。

CODE
% perl hnf2tdf.pl <hnf_diary_dir> <tdf_diary_dir>
/CODE

または、hnf2tdf.pl 内の $hnf_dir, $tdf_dir を直接変えて下さい。

HD 2 mail2tdf/mail2tdf.pl.in
メールから tdf ファイルを生成するためのツールです。
.forward に記述します。

詳しくは
LINK author_management.html#update_by_mail メールによる更新
をご覧ください。

HD 2 mkpasswd.pl
ITALIC diary_dir
/conf/.passwd に入力したパスワードを暗号化して保存します。

crypt() をサポートしていない OS で実行した場合、
そのまま生パスワードを保存します。
また、実行時に入力したパスワードがそのまま表示されてしまいますので、
周囲に人がいないことを十分確認してください。

HD 2 tdf-mode.el
tdf-mode.elは，Emacsen(GNU Emacs,XEmacs,etc.)でのtdfファイルの記述を支
援するメジャーモードです．Emacs 19.28以上が必要です．

使用するには，tdf-mode.elをロードパスの通った所にコピーし，必要ならバ
イトコンパイルしておきます．
$HOME/.emacs などに以下のように記述し，Emacs を再起動します．

CODE
(autoload 'tdf-mode "tdf-mode" "Major mode for editing files of tdf." t)
(autoload 'tdf-open "tdf-mode" "Major mode for editing files of tdf." t)
(setq auto-mode-alist (cons '("\\.tdf" . tdf-mode)
	 auto-mode-alist)) ;; *.tdf を開いたとき自動的にtdfモードにする

(add-hook 'tdf-mode-hook
  (lambda ()
     (setq diary-dir "~/diary")      ;; *.tdf があるディレクトリ
     (setq day-change-offset-hour 3) ;; AM04:00を一日の終わりとみなす
     (define-key tdf-mode-map "\C-c\C-n" 'tdf-new) ;; キーバインドを変える場合
     ))
/CODE

Emacs上で M-x tdf-open とすれば，その日のtdfファイルが開かれます．

CODE
(global-set-key "\C-c\C-q\C-w" 'tdf-open)
/CODE

などとしておくと、C-cC-qC-w で直接呼び出す事が出来ます。


tdf-modeでは，tdfコマンドを入力するためのキーボードショートカットが利
用できます．
詳細は，tdf-mode.elのソースを参照してください．
キーバインドはhtml-helper-modeのそれに準拠しているので，
html-helper-modeに慣れている人はわかりやすいかもしれません．
以下に代表的なものを挙げます．
各tdfコマンドの意味は．doc/tdf.htmlを参照してください．

DL
DT C-c n
DD NEW を挿入します．
DT C-c s
DD SUB を挿入します．
DT C-c C-m
DD ~(改行コマンド)を挿入し，改行します．
DT C-c C-a l
DD LINK を挿入します．参照するURLはミニバッファから入力します．
DT C-c C-a m
DD MAILTO を挿入します．メールアドレスはミニバッファから入力します．

DT C-c C-l u
DD リストコマンド(UL)を挿入します．
DT C-c C-l o
DD 番号つきリストコマンド(OL)を挿入します．
DT C-c C-l d
DD 定義リスト(DL)を挿入します．
DT C-c C-l i
DD リストの要素を挿入します．

DT C-c C-d k
DD STRIKE を挿入します．
DT C-c C-d S
DD STRONG を挿入します．

DT C-c C-p d
DD 辞書(dictionary.dat)を編集します．
DT C-c C-p p
DD TODOリスト(todo.dat)を編集します．
DT C-c C-p s
DD スケジュール(schedule.dat)を編集します．
/DL

HD 2 tdf2html/tdf2html.pl.in
tdf ファイルを HTML ファイルに変換します。

./configure && make すると、
環境に合った tdf2html.pl が生成されます。
もしくは、cp tdf2html.pl.in tdf2html.pl し、
%PerlPath%, %LibDir% を適切に変更してください。

これを適当なディレクトリにコピーし、

CODE
% perl tdf2html.pl foo.tdf > foo.html
/CODE

などとします。

HD 3 template-latex.ph
latexファイル出力用のテンプレートです。

CODE
% perl tdf2html.pl -t template-latex.html foo.tdf > foo.tex
/CODE

HD 2 tdf_join.pl
複数の日記ソースを月毎ファイルにまとめます。


HD 2 anal_tdf.pl
tdf ファイル群を解析するツールです。
平均サイズ、トピック数や使用頻度の高いコマンド、カテゴリなどを表示します。

HD 2 upload.pl
Net::* が必要。
$FTP_Server を設定。
~/.netrc を記述
