hikiutils 0.2.3.6 → 0.2.3.7

data/hikiutils_yamane/latex_dir/hikiutils_yamane.tex

@@ -43,20 +43,26 @@
 \date{\vspace{3cm} 2017年  3月\\
 \vspace{3cm} 指導教員　　西谷　滋人　教授}
 \maketitle
+\setcounter{tocdepth}{6}
 \tableofcontents
 
-\title{コマンドラインツール作成ライブラリThorによるhikiutilsの書き換え}
-\author{関西学院大学理工学部情報科学科 27013554 山根亮太}
-\date{}
-\maketitle
 \tableofcontents
 \include{abstract}
+\section{序論}
 \include{introduction}
+\include{purpose}
+\section{方法}
+\section{結果}
 \include{results}
-[1] 「hiki」,hikiwiki.org/ja/about.html ,2017/1/30 アクセス.\verb|{{br}}|
-[2] 「hikiutils」,\verb|https://rubygems.org/gems/hikiutils| ,2017/1/30 アクセス.\verb|{{br}}|
-[3] 「The Ruby Toolbox」, CLI Option Parsers,\verb|https://www.ruby-toolbox.com/categories/CLI_Option_Parsers| ,2017/1/30 アクセス.\verb|{{br}}|
-[4] 「Thorの使い方まとめ」, \verb|http://qiita.com/succi0303/items/32560103190436c9435b| ,2017/1/30 アクセス.\verb|{{br}}|
-[5] 「15.5. optparse - コマンドラインオプション解析器」, \verb|http://docs.python.jp/2/library/optparse.html| ,2017/1/30 アクセス.\verb|{{br}}|
-[6] 「library optparse」, \verb|https://docs.ruby-lang.org/ja/latest/library/optparse.html| ,2017/1/30 アクセス.\verb|{{br}}|
+\include{compare}
+\include{clidescription}
+\include{code}
+\section{参考文献}
+[1-1] hikidoc, \verb|https://rubygems.org/gems/hikidoc/versions/0.1.0,| \verb|https://github.com/hiki/hikidoc,2017/1/30| アクセス.
+
+[1-2] 「Thorの使い方まとめ」, \verb|http://qiita.com/succi0303/items/32560103190436c9435b| ,2017/1/30 アクセス.
+
+[1-3] 「15.5. optparse - コマンドラインオプション解析器」, \verb|http://docs.python.jp/2/library/optparse.html| ,2017/1/30 アクセス.
+
+[1-4] 「library optparse」, \verb|https://docs.ruby-lang.org/ja/latest/library/optparse.html| ,2017/1/30 アクセス.
 \end{document}

data/hikiutils_yamane/latex_dir/hikiutils_yamane.toc

@@ -1,20 +1,48 @@
-\contentsline {section}{\numberline {1}概要}{3}
-\contentsline {section}{\numberline {2}序論}{4}
-\contentsline {subsection}{\numberline {2.1}目的}{4}
-\contentsline {subsection}{\numberline {2.2}既存システムの背景}{4}
-\contentsline {subsubsection}{\numberline {2.2.1}hiki}{4}
-\contentsline {subsubsection}{\numberline {2.2.2}hikiutils}{4}
-\contentsline {section}{\numberline {3}結果}{6}
-\contentsline {subsection}{\numberline {3.1}開発の結果}{6}
-\contentsline {subsection}{\numberline {3.2}thorとoptparseのコードの比較}{7}
-\contentsline {subsubsection}{\numberline {3.2.1}Thorとは}{7}
-\contentsline {paragraph}{Thorの基本的な流れ}{7}
-\contentsline {subsubsection}{\numberline {3.2.2}optparseとは}{7}
-\contentsline {paragraph}{optparseの基本的な流れ}{7}
-\contentsline {subsubsection}{\numberline {3.2.3}コードの解説}{7}
-\contentsline {paragraph}{Thorの定義}{7}
-\contentsline {paragraph}{実際のコード}{8}
-\contentsline {paragraph}{hikiutilsの実行}{9}
-\contentsline {paragraph}{実際のコード}{10}
-\contentsline {paragraph}{コマンドの表示と実行}{13}
-\contentsline {paragraph}{実際のコード}{14}
+\contentsline {section}{\numberline {1}概要}{4}
+\contentsline {section}{\numberline {2}序論}{5}
+\contentsline {section}{\numberline {3}序論}{6}
+\contentsline {subsection}{\numberline {3.1}目的}{6}
+\contentsline {subsection}{\numberline {3.2}既存システムの背景}{6}
+\contentsline {subsubsection}{\numberline {3.2.1}hiki}{6}
+\contentsline {subsubsection}{\numberline {3.2.2}hikiutils}{6}
+\contentsline {subsubsection}{\numberline {3.2.3}目的}{8}
+\contentsline {subsubsection}{\numberline {3.2.4}既存システムの説明}{8}
+\contentsline {section}{\numberline {4}方法}{10}
+\contentsline {section}{\numberline {5}結果}{10}
+\contentsline {subsection}{\numberline {5.1}結果}{11}
+\contentsline {subsubsection}{\numberline {5.1.1}コマンド名の検討}{11}
+\contentsline {paragraph}{コマンドの命名原則}{11}
+\contentsline {paragraph}{hikiutilsがあらかじめ想定している利用形態}{11}
+\contentsline {paragraph}{コメンド名と振る舞いの詳細}{13}
+\contentsline {paragraph}{open FILE}{14}
+\contentsline {paragraph}{ls [FILE]}{14}
+\contentsline {paragraph}{rsync}{14}
+\contentsline {paragraph}{touch FILE}{14}
+\contentsline {paragraph}{pwd}{14}
+\contentsline {paragraph}{cd VAL}{14}
+\contentsline {subsubsection}{\numberline {5.1.2}thor と optparse のコードの比較}{15}
+\contentsline {paragraph}{Thorとoptparseとは}{15}
+\contentsline {paragraph}{Thorとは}{15}
+\contentsline {paragraph}{optparseとは}{15}
+\contentsline {paragraph}{コードの解説}{16}
+\contentsline {paragraph}{Thorの定義}{16}
+\contentsline {paragraph}{実際のコード}{16}
+\contentsline {paragraph}{hikiutilsの実行}{17}
+\contentsline {paragraph}{実際のコード}{18}
+\contentsline {paragraph}{コマンドの表示と処理}{21}
+\contentsline {paragraph}{実際のコード}{22}
+\contentsline {subsubsection}{\numberline {5.1.3}CLIのコード}{26}
+\contentsline {paragraph}{CLIの解説}{26}
+\contentsline {paragraph}{Thor}{26}
+\contentsline {paragraph}{optparse}{26}
+\contentsline {subsubsection}{\numberline {5.1.4}Thorの初期化}{28}
+\contentsline {paragraph}{コード}{28}
+\contentsline {subsubsection}{\numberline {5.1.5}コマンド表示と処理}{29}
+\contentsline {paragraph}{Thor}{29}
+\contentsline {paragraph}{optparse}{30}
+\contentsline {paragraph}{コード}{31}
+\contentsline {subsubsection}{\numberline {5.1.6}CLIの実行}{34}
+\contentsline {paragraph}{Thor}{34}
+\contentsline {paragraph}{optparse}{35}
+\contentsline {paragraph}{コード}{35}
+\contentsline {section}{\numberline {6}参考文献}{39}

data/hikiutils_yamane/latex_dir/introduction.aux

@@ -1,11 +1,11 @@
 \relax 
-\@writefile{toc}{\contentsline {section}{\numberline {2}序論}{4}}
-\@writefile{toc}{\contentsline {subsection}{\numberline {2.1}目的}{4}}
-\@writefile{toc}{\contentsline {subsection}{\numberline {2.2}既存システムの背景}{4}}
-\@writefile{toc}{\contentsline {subsubsection}{\numberline {2.2.1}hiki}{4}}
-\@writefile{toc}{\contentsline {subsubsection}{\numberline {2.2.2}hikiutils}{4}}
+\@writefile{toc}{\contentsline {section}{\numberline {3}序論}{6}}
+\@writefile{toc}{\contentsline {subsection}{\numberline {3.1}目的}{6}}
+\@writefile{toc}{\contentsline {subsection}{\numberline {3.2}既存システムの背景}{6}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.2.1}hiki}{6}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.2.2}hikiutils}{6}}
 \@setckpt{introduction}{
-\setcounter{page}{6}
+\setcounter{page}{8}
 \setcounter{equation}{0}
 \setcounter{enumi}{0}
 \setcounter{enumii}{0}
@@ -14,7 +14,7 @@
 \setcounter{footnote}{0}
 \setcounter{mpfootnote}{0}
 \setcounter{part}{0}
-\setcounter{section}{2}
+\setcounter{section}{3}
 \setcounter{subsection}{2}
 \setcounter{subsubsection}{2}
 \setcounter{paragraph}{0}

data/hikiutils_yamane/latex_dir/purpose.aux

@@ -0,0 +1,25 @@
+\relax 
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.2.3}目的}{8}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.2.4}既存システムの説明}{8}}
+\@writefile{lof}{\contentsline {figure}{\numberline {1}{\ignorespaces hiki web systemとhiki systemの対応関係．}}{8}}
+\newlabel{default}{{1}{8}}
+\@setckpt{purpose}{
+\setcounter{page}{10}
+\setcounter{equation}{0}
+\setcounter{enumi}{0}
+\setcounter{enumii}{0}
+\setcounter{enumiii}{0}
+\setcounter{enumiv}{0}
+\setcounter{footnote}{0}
+\setcounter{mpfootnote}{0}
+\setcounter{part}{0}
+\setcounter{section}{3}
+\setcounter{subsection}{2}
+\setcounter{subsubsection}{4}
+\setcounter{paragraph}{0}
+\setcounter{subparagraph}{0}
+\setcounter{figure}{1}
+\setcounter{table}{0}
+\setcounter{lstnumber}{1}
+\setcounter{lstlisting}{0}
+}

data/hikiutils_yamane/latex_dir/purpose.tex

@@ -0,0 +1,21 @@
+\subsubsection{目的}
+本研究ではhikiの編集作業をより容易にするためのツールの開発を行った． 
+hikiは通常web上で編集を行っているが,GUIとCUIが混在しており,操作に不便な点がある. 
+そこで,編集操作が CUI で完結するために開発をされたのが hikiutils である. 
+しかし,そのユーザインタフェースにはコマンドが直感的でないという問題点がある. 
+そこで，Thorというコマンドラインツール作成ライブラリを用いる．
+optparseというコマンドライン解析ライブラリを使用しているhikiutilsを新たなコマンドライン解析ライブラリを使用することコマンドを書き換え，より直感的なコマンドにして使いやすくする．
+
+\subsubsection{既存システムの説明}
+図に従ってhiki systemの動作概要を説明する．
+
+\begin{figure}[htbp]\begin{center}
+\includegraphics[width=6cm,bb=0 0 442 500]{../figs/./hikiutils_yamane_09_copy.001.jpg}
+\caption{hiki web systemとhiki systemの対応関係．}
+\label{default}\end{center}\end{figure}
+hikiは，hiki記法を用いたwiki cloneです．wikiはウォード・カニンガムが作ったwikiwikiwebを源流とするhome page制作を容易にするシステムで，hikiもwikiの基本要求仕様を満足するシステムを提供しています．wikiの特徴であるweb上で編集する機能を提供しています．これを便宜上hiki web systemと呼びます．図にある通り，一般的な表示画面の他に，編集画面が提供されており，ユーザーはこの編集画面からコンテンツを編集することが可能です．リンクやヘッダー，リスト，引用，表，図の表示などの基本テキストフォーマットが用意されています．
+
+hiki web systemの実際の基本動作は，hiki.cgiプログラムを介して行われています．こちらを便宜上hiki systemと呼びます．hiki systemは，data/textに置かれた書かれたプレーンテキストをhtmlへ変換します．この変換はhikidoc[1-1]というhikiフォーマットconverterを使っています．また，添付書類はcache/attachに，一度フォーマットしたhtmlはparserに置かれており，それらを参照してhtmlを表示する画面をhiki.cgiは作っています．さらにhiki systemでは検索機能，自動リンク作成などが提供されています
+
+研究室内の内部文書，あるいは外部への宣伝資料，さらにwikipediaのように重要な研究成果の発信などに西谷研ではこのhiki systemを利用しています．初心者にも覚えやすい直感的な操作です．しかし，慣れてくるとテキスト編集や画面更新にいちいちweb画面へ移行せねばならず，編集の思考が停止します．そこで，テキスト編集に優れたeditorとの連携や，terminal上のshell commandと連携しやすいようにhikiutilsというcli(command line interface)を作成して運用しています．このhikiutilsのコマンドオプションの実装をしなおして，より使いやすくすることが本研究の目的です．
+

data/hikiutils_yamane/latex_dir/results.aux

@@ -1,45 +1,36 @@
 \relax 
-\@writefile{toc}{\contentsline {section}{\numberline {3}結果}{6}}
-\@writefile{toc}{\contentsline {subsection}{\numberline {3.1}開発の結果}{6}}
-\@writefile{lot}{\contentsline {table}{\numberline {1}{\ignorespaces }}{6}}
-\newlabel{default}{{1}{6}}
-\@writefile{toc}{\contentsline {subsection}{\numberline {3.2}thorとoptparseのコードの比較}{7}}
-\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.2.1}Thorとは}{7}}
-\@writefile{toc}{\contentsline {paragraph}{Thorの基本的な流れ}{7}}
-\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.2.2}optparseとは}{7}}
-\@writefile{toc}{\contentsline {paragraph}{optparseの基本的な流れ}{7}}
-\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.2.3}コードの解説}{7}}
-\@writefile{toc}{\contentsline {paragraph}{Thorの定義}{7}}
-\@writefile{lof}{\contentsline {figure}{\numberline {1}{\ignorespaces }}{8}}
-\newlabel{default}{{1}{8}}
-\@writefile{toc}{\contentsline {paragraph}{実際のコード}{8}}
-\@writefile{toc}{\contentsline {paragraph}{hikiutilsの実行}{9}}
-\@writefile{lof}{\contentsline {figure}{\numberline {2}{\ignorespaces }}{9}}
-\newlabel{default}{{2}{9}}
-\@writefile{lof}{\contentsline {figure}{\numberline {3}{\ignorespaces }}{10}}
-\newlabel{default}{{3}{10}}
-\@writefile{toc}{\contentsline {paragraph}{実際のコード}{10}}
-\@writefile{toc}{\contentsline {paragraph}{コマンドの表示と実行}{13}}
-\@writefile{lof}{\contentsline {figure}{\numberline {4}{\ignorespaces }}{13}}
-\newlabel{default}{{4}{13}}
-\@writefile{toc}{\contentsline {paragraph}{実際のコード}{14}}
+\@writefile{toc}{\contentsline {subsection}{\numberline {5.1}結果}{11}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {5.1.1}コマンド名の検討}{11}}
+\@writefile{toc}{\contentsline {paragraph}{コマンドの命名原則}{11}}
+\@writefile{toc}{\contentsline {paragraph}{hikiutilsがあらかじめ想定している利用形態}{11}}
+\@writefile{lof}{\contentsline {figure}{\numberline {2}{\ignorespaces hikiutilsがあらかじめ想定している利用形態}}{11}}
+\newlabel{default}{{2}{11}}
+\@writefile{toc}{\contentsline {paragraph}{コメンド名と振る舞いの詳細}{13}}
+\@writefile{lot}{\contentsline {table}{\numberline {1}{\ignorespaces }}{13}}
+\newlabel{default}{{1}{13}}
+\@writefile{toc}{\contentsline {paragraph}{open FILE}{14}}
+\@writefile{toc}{\contentsline {paragraph}{ls [FILE]}{14}}
+\@writefile{toc}{\contentsline {paragraph}{rsync}{14}}
+\@writefile{toc}{\contentsline {paragraph}{touch FILE}{14}}
+\@writefile{toc}{\contentsline {paragraph}{pwd}{14}}
+\@writefile{toc}{\contentsline {paragraph}{cd VAL}{14}}
 \@setckpt{results}{
-\setcounter{page}{17}
+\setcounter{page}{15}
 \setcounter{equation}{0}
-\setcounter{enumi}{3}
+\setcounter{enumi}{0}
 \setcounter{enumii}{0}
 \setcounter{enumiii}{0}
 \setcounter{enumiv}{0}
 \setcounter{footnote}{0}
 \setcounter{mpfootnote}{0}
 \setcounter{part}{0}
-\setcounter{section}{3}
-\setcounter{subsection}{2}
-\setcounter{subsubsection}{3}
+\setcounter{section}{5}
+\setcounter{subsection}{1}
+\setcounter{subsubsection}{1}
 \setcounter{paragraph}{0}
 \setcounter{subparagraph}{0}
-\setcounter{figure}{4}
+\setcounter{figure}{2}
 \setcounter{table}{1}
-\setcounter{lstnumber}{61}
+\setcounter{lstnumber}{12}
 \setcounter{lstlisting}{0}
 }

data/hikiutils_yamane/latex_dir/results.tex

@@ -1,26 +1,89 @@
-\section{結果}
-\subsection{開発の結果}
-開発の結果コマンドを以下のように書き換えることができた
+
+\subsection{結果}
+\subsubsection{コマンド名の検討}
+\paragraph{コマンドの命名原則}
+機能ごとの動作はコマンドのオプションによって指定されます．
+このオプションにどのような名前をつけるかは，どれだけコマンドを覚えやすいかという
+意味で重要です．コマンドの振る舞いを的確に表す名称をつける必要があります．
+
+この振る舞いとしてもっとも受け入れやすいのがshellで用意されているコマンドです．
+pwd, ls, rm, touch, openなどはもっとも直感的に動作がわかるコマンドです．
+hikiutilsの振る舞いを予測できるシェルコマンドと同じ名前でオプションを提供する
+ようにします．
+
+\paragraph{hikiutilsがあらかじめ想定している利用形態}
+ここでhikiutilsがあらかじめ想定している利用形態を解説しておきます．
+
+\begin{figure}[htbp]\begin{center}
+\includegraphics[width=6cm,bb=0 0 442 500]{../figs/./hikiutils_yamane_09_copy.002.jpg}
+\caption{hikiutilsがあらかじめ想定している利用形態}
+\label{default}\end{center}\end{figure}
+hikiutilsは，
+
+\begin{itemize}
+\item local PCとglobal serverとが用意されており，
+\item それらのデータをrsyncで同期する
+\end{itemize}
+ことで動作することを想定しています．これは，ネットに繋がっていないオフラインの状況でも
+テキストなどの編集が可能で，さらに不用意な書き換えを防ぐための機構です．さらに，
+どちらもが何かあった時のバックアップともなって，ミスによる手戻りを防いでいます．
+
+これらの設定は，~/.hikircにyaml形式で記述・保存されています．
+\begin{lstlisting}[style=]
+bob% cat ~/.hikirc
+:srcs:
+- :nick_name: new_ist
+  :local_dir: "/Users/bob/Sites/new_ist_data/ist_data"
+  :local_uri: http://localhost/ist
+  :global_dir: nishitani@ist.ksc.kwansei.ac.jp:/home/nishitani/new_ist_data/ist_data
+  :global_uri: http://ist.ksc.kwansei.ac.jp/~nishitani/
+- :nick_name: dmz0
+  :local_dir: "/Users/bob/Sites/nishitani0/Internal/data"
+  :local_uri: http://localhost/~bob/nishitani0/Internal
+  :global_dir: bob@dmz0:/Users/bob/Sites/nishitani0/Internal/data
+  :global_uri: http://nishitani0.kwansei.ac.jp/~bob/nishitani0/Internal
+\end{lstlisting}
+また，一般的に一人のユーザがいくつものまとまりとしてのlocal-globalペアを
+保持して管理することが普通です．それぞれにnicke\_nameをつけて管理しています．
+\begin{lstlisting}[style=]
+bob% hiki -s
+hikiutils: provide utilities for helping hiki editing.
+"open -a mi"
+target_no:1
+editor_command:open -a mi
+ id | name      | local directory                               | global uri     
+---------------------------------------------------------------------------------
+  0 | new_ist   | /Users/bob/Sites/new_ist_data/ist_data        | http://ist.ksc.k
+ *1 | dmz0      | /Users/bob/Sites/nishitani0/Internal/data     | http://nishitani
+  2 | ist       | /Users/bob/Sites/hiki-data/data               | http://ist.ksc.k
+  3 | new_maple | /Users/bob/Sites/new_ist_data/maple_hiki_data | http://ist.ksc.k
+\end{lstlisting}
+とすると，それらの一覧と，いまtargetにしているnick\_nameディレクリが表示されます．
+
+\paragraph{コメンド名と振る舞いの詳細}
+開発の結果コマンドを以下のように書き換えました．
+上部に記した，特によく使うコマンドに関しては，shellでよく使われるコマンド名と一致するにようにしました．
 
 \begin{table}[htbp]\begin{center}
 \caption{}
 \begin{tabular}{llll}
 \hline
-変更前  &変更後  &コマンド一覧  \\ \hline
+変更前  &変更後  &動作の解説  \\ \hline
+edit FILE         &open  &open file  \\
+list [FILE]       &ls  &list files  \\
+rsync             &rsync  &rsync files  \\
+update FILE       &touch  &update file  \\
+show              &pwd  &show nick\_names  \\
+target VAL        &cd  &targetを変える，change directoryとのメタファ  \\
+  &  \\
+move [FILE]       &mv  &move file  \\
+remove [FILE]     &rm  &remove files  \\
 add               &  &add sources info  \\
 checkdb           &  &check database file  \\
 datebase FILE     &  &read datebase file  \\
-display FILE      &　  &display converted hikifile  \\
-edit FILE         &open  &open file  \\
+display FILE      &  &display converted hikifile  \\
 euc FILE          &  &translate file to euc  \\
 help [COMMAND]    &  &Describe available commands or one specific command  \\
-list [FILE]       &ls  &list files  \\
-move [FILE]       &mv|  move file  \\
-remove [FILE]     &rm  &remove files  \\
-rsync             &  &rsync files  \\
-show              &  &lsとかぶる．  \\
-target VAL        &cd  &set target id  \\
-update FILE       &touch  &update file  \\
 version           &  &show program version  \\
 \hline
 \end{tabular}
@@ -28,315 +91,34 @@ version           &  &show program version  \\
 \end{center}\end{table}
 %for inserting separate lines, use \hline, \cline{2-3} etc.
 
-hikiutilsのコマンドライン解析ツールをoptparseからthorに換えることでコマンドの書き換えを行うことができた．
-また，プログラムのコードもoptparseよりthorのほうが短く書け，簡単にコマンドを作成することができた．
+それぞれの意図を動作の解説として記述しています．
 
-\subsection{thorとoptparseのコードの比較}
-\subsubsection{Thorとは}
-Thorとは，コマンドラインツールの作成を支援するライブラリのことである．
-gitやbundlerのようにサブコマンドを含むコマンドラインツールを簡単に作成することができる[4]．
+\paragraph{open FILE}
+ファイルを編集のためにeditorでopen．Editorは~/.hikircに
+\begin{quote}\begin{verbatim}
+:editor_command: open -a mi
+\end{verbatim}\end{quote}
+として保存されている．open -a miをemacsなどに適宜変更して使用．
 
-\paragraph{Thorの基本的な流れ}
-\begin{enumerate}
-\item Thorを継承したクラスのパブリックメソッドがコマンドになる
-\item クラス.start(ARGV)でコマンドラインの処理をスタートする
-\end{enumerate}
-という流れである[4].
+\paragraph{ls [FILE]}
+local\_dirにあるファイル名を[FILE*]として表示．例えば，hikiutils\_yamane以下の拡張子が
+ついたファイルを表示．hikiシステムではtextディレクトリーは階層構造を取ることができない．
+西谷研ではdirectoryの代わりにスネーク表記で階層構造を表している．
 
-\subsubsection{optparseとは}
-optparseモジュールとは，getoptよりも簡便で，柔軟性に富み，かつ強力なコマンドライン解析ライブラリである．
-optparseでは，より宣言的なスタイルのコマンドライン解析手法，すなわちOptionParserのインスタンスでコマンドラインを解析するという手法をとっている．
-これを使うと，GNU/POSIX構文でオプションを指定できるだけでなく，使用法やヘルプメッセージの生成も行える[5]．
+\paragraph{rsync}
+local\_dirの内容をglobal\_dirにrsyncする．逆方向は同期に誤差が生じたり，permissionが
+おかしくなるので，現在のところ一方向の同期のみとしている．したがって，作業手順としては
+テキストの変更はlocal\_dirで読み行うようにしている．
 
-\paragraph{optparseの基本的な流れ}
-\begin{enumerate}
-\item OptionParserオブジェクトoptを生成する
-\item オプションを取り扱うブロックをoptに登録する
-\item opt.parse(ARGV)でコマンドラインを実際にparseする
-\end{enumerate}
-という流れである[6].
+\paragraph{touch FILE}
+loccal\_dirで書き換えたFILEの内容をlocal\_uriに反映させ，ブラウザで表示．シェルコマンドの
+touchによって，変更時間を現在に変え，最新状態とするのに似せてコマンド名をtouchとしている．
 
-\subsubsection{コードの解説}
-\paragraph{Thorの定義}
-\begin{figure}[htbp]\begin{center}
-\includegraphics[width=6cm,bb=0 0 442 500]{../figs/./hikiutils_yamane.003.jpg}
-\caption{}
-\label{default}\end{center}\end{figure}
-\begin{enumerate}
-\item Hikithor::CLI.start(ARGV)が呼ばれる
-\item initializeメソッドが呼ばれる
-\item これではThorのinitializeメソッドが呼ばれない
-\item superを書くことでThorのinitializeメソッドが呼ばれる
-\end{enumerate}
-optparseではrequireでoptparseを呼ぶだけでいいが，ThorではrequireでThorを呼びCLIクラスで継承しinitializeメソッドにsuperを書くことでThorのinitializeを呼ぶ必要がある．
+\paragraph{pwd}
+nick\_nameの一覧とtargetを表示，current targetをcurrent dirとみなして，
+コマンド名をpwdとした．
 
-\paragraph{実際のコード}\begin{lstlisting}[style=customRuby]
-# -*- coding: utf-8 -*-                                                         
-require 'thor'
-require 'kconv'
-require 'hikidoc'
-require 'erb'
-require "hikiutils/version"
-require "hikiutils/tmarshal"
-require "hikiutils/infodb"
-require 'systemu'
-require 'fileutils'
-require 'yaml'
-require 'pp'
+\paragraph{cd VAL}
+targetを変える，change directoryとのメタファ．ただし，いまのところnick\_nameでは
+対応しておらず，nick\_nameの番号をVAL入力することで変更する．
 
-module Hikithor
-
-  DATA_FILE=File.join(ENV['HOME'],'.hikirc')
-  attr_accessor :src, :target, :editor_command, :browser, :data_name, :l_dir
-
-  class CLI < Thor
-   def initialize(*args)
-      super
-      @data_name=['nick_name','local_dir','local_uri','global_dir','global_uri']
-      data_path = File.join(ENV['HOME'], '.hikirc')
-      DataFiles.prepare(data_path)
-
-      file = File.open(DATA_FILE,'r')
-      @src = YAML.load(file.read)
-      file.close
-      @target = @src[:target]
-      @l_dir=@src[:srcs][@target][:local_dir]
-      browser = @src[:browser]
-      @browser = (browser==nil) ? 'firefox' : browser
-      p editor_command = @src[:editor_command]
-      @editor_command = (editor_command==nil) ? 'open -a mi' : editor_command
-   end
-\end{lstlisting}
-\paragraph{hikiutilsの実行}
-\begin{itemize}
-\item Thor
-\end{itemize}
-\begin{figure}[htbp]\begin{center}
-\includegraphics[width=6cm,bb=0 0 442 500]{../figs/./hikiutils_yamane.004.jpg}
-\caption{}
-\label{default}\end{center}\end{figure}
-\begin{enumerate}
-\item hiki\_thorのHikithor::CLI.start(ARGV)でhikiutils\_thor.rbのCLIクラスを呼ぶ\verb|{{br}}|
-\item hikiutils\_thor.rbのCLIクラスのメソッドを順に実行していく\verb|{{br}}|
-\end{enumerate}
-\begin{itemize}
-\item optparse
-\end{itemize}
-\begin{figure}[htbp]\begin{center}
-\includegraphics[width=6cm,bb=0 0 442 500]{../figs/./hikiutils_yamane.001.jpg}
-\caption{}
-\label{default}\end{center}\end{figure}
-\begin{enumerate}
-\item HikiのHikiUtils::Command.run(ARGV)でhikiutils.rbのrunメソッドを呼ぶ
-\item new(argv).executeでexecuteメソッドが実行される
-\end{enumerate}
-このようにoptparseでは実行を行うためのメソッドが必要であるが，Thorではクラスのメソッドを順に実行していくため
-runメソッドとexecuteメソッドは必要ない．
-
-\paragraph{実際のコード}
-\begin{itemize}
-\item Thor
-\end{itemize}\begin{lstlisting}[style=customRuby]
-#!/usr/bin/env ruby                                                             
-
-require "hikiutils_thor"
-
-Hikithor::CLI.start(ARGV)
-\end{lstlisting}\begin{lstlisting}[style=customRuby]
-# -*- coding: utf-8 -*-                                                         
-require 'thor'
-require 'kconv'
-require 'hikidoc'
-require 'erb'
-require "hikiutils/version"
-require "hikiutils/tmarshal"
-require "hikiutils/infodb"
-require 'systemu'
-require 'fileutils'
-require 'yaml'
-require 'pp'
-
-module Hikithor
-
-  DATA_FILE=File.join(ENV['HOME'],'.hikirc')
-  attr_accessor :src, :target, :editor_command, :browser, :data_name, :l_dir
-
-  class CLI < Thor
-   def initialize(*args)
-      super
-      @data_name=['nick_name','local_dir','local_uri','global_dir','global_uri']
-      data_path = File.join(ENV['HOME'], '.hikirc')
-      DataFiles.prepare(data_path)
-
-      file = File.open(DATA_FILE,'r')
-      @src = YAML.load(file.read)
-      file.close
-      @target = @src[:target]
-      @l_dir=@src[:srcs][@target][:local_dir]
-      browser = @src[:browser]
-      @browser = (browser==nil) ? 'firefox' : browser
-
-\end{lstlisting}
-\begin{itemize}
-\item optparse
-\end{itemize}\begin{lstlisting}[style=customRuby]
-#!/usr/bin/env ruby                                                             
-
-require "hikiutils"
-
-HikiUtils::Command.run(ARGV)
-\end{lstlisting}\begin{lstlisting}[style=customRuby]
-    def self.run(argv=[])
-      print "hikiutils: provide utilities for helping hiki editing.\n"
-      new(argv).execute
-    end
-
-    def execute
-      @argv << '--help' if @argv.size==0
-      command_parser = OptionParser.new do |opt|
-        opt.on('-v', '--version','show program Version.') { |v|
-          opt.version = HikiUtils::VERSION
-          puts opt.ver
-        }
-        opt.on('-s', '--show','show sources') {show_sources}
-        opt.on('-a', '--add','add sources info') {add_sources }
-        opt.on('-t', '--target VAL','set target id') {|val| set_target(val) }
-        opt.on('-e', '--edit FILE','open file') {|file| edit_file(file) }
-        opt.on('-l', '--list [FILE]','list files') {|file| list_files(file) }
-        opt.on('-u', '--update FILE','update file') {|file| update_file(file) }
-        opt.on('-r', '--rsync','rsync files') {rsync_files}
-        opt.on('--database FILE','read database file') {|file| db_file(file)}
-        opt.on('--display FILE','display converted hikifile') {|file| display(f\
-ile)}
-        opt.on('-c', '--checkdb','check database file') {check_db}
-        opt.on('--remove FILE','remove file') {|file| remove_file(file)}
-        opt.on('--move FILES','move file1,file2',Array) {|files| move_file(file\
-s)}
-        opt.on('--euc FILE','translate file to euc') {|file| euc_file(file) }
-        opt.on('--initialize','initialize source directory') {dir_init() }
-      end
-      begin
-        command_parser.parse!(@argv)
-      rescue=> eval
-        p eval
-      end
-      dump_sources
-      exit
-    end  
-\end{lstlisting}
-\paragraph{コマンドの表示と実行}
-\begin{itemize}
-\item Thor
-\end{itemize}
-\begin{figure}[htbp]\begin{center}
-\includegraphics[width=6cm,bb=0 0 442 500]{../figs/./hikiutils_yamane.002.jpg}
-\caption{}
-\label{default}\end{center}\end{figure}
-\begin{enumerate}
-\item コマンド名，コマンドの説明を一覧に表示させる
-\item パブリックメソッドのコマンドを別のコマンド名でも実行できるようにする
-\item コマンドの命令の実行コード
-\end{enumerate}
-\begin{itemize}
-\item optparse
-\end{itemize}
-\verb|{{attach_view(hikiutils_yamane.005.jpg)}}|
-よって，optparseではOptionParserオブジェクトoptを生成を行い，コマンドをoptに登録して一覧に表示するメソッドとそれぞれコマンドの実行処理が書かれたメソッドがあるが，
-thorではそれぞれのdescで一覧を表示しmapとパブリックメソッドでコマンドの実行処理を行うためコードが短くなる．
-
-\paragraph{実際のコード}
-\begin{itemize}
-\item Thor
-\end{itemize}\begin{lstlisting}[style=customRuby]
-    desc 'show,--show', 'show sources'
-    map "--show" => "show"
-    def show
-      printf("target_no:%i\n",@src[:target])
-      printf("editor_command:%s\n",@src[:editor_command])
-      @i_size,@n_size,@l_size,@g_size=3,5,30,15 #i,g_size are fixed             
-      n_l,l_l=0,0
-      @src[:srcs].each_with_index{|src,i|
-        n_l =(n_l= src[:nick_name].length)>@n_size? n_l:@n_size
-        l_l =(l_l= src[:local_dir].length)>@l_size? l_l:@l_size
-      }
-      @n_size,@l_size=n_l,l_l
-      command = Command.new
-      header = command.display_format('id','name','local directory','global uri',@i_size,@n_size,@l_size,@g_size)
-
-      puts header
-      puts '-' * header.size
-
-      @src[:srcs].each_with_index{|src,i|
-        target = i==@src[:target] ? '*':' '
-        id = target+i.to_s
-        name=src[:nick_name]
-        local=src[:local_dir]
-        global=src[:global_uri]
-        puts command.display_format(id,name,local,global,@i_size,@n_size,@l_size,@g_size)
-      }
-    end
-\end{lstlisting}
-\begin{itemize}
-\item optparse
-\end{itemize}\begin{lstlisting}[style=customRuby]
-    def execute
-      @argv << '--help' if @argv.size==0
-      command_parser = OptionParser.new do |opt|
-        opt.on('-v', '--version','show program Version.') { |v|
-          opt.version = HikiUtils::VERSION
-          puts opt.ver
-        }
-        opt.on('-s', '--show','show sources') {show_sources}
-        opt.on('-a', '--add','add sources info') {add_sources }
-        opt.on('-t', '--target VAL','set target id') {|val| set_target(val)}
-        opt.on('-e', '--edit FILE','open file') {|file| edit_file(file) }
-        opt.on('-l', '--list [FILE]','list files') {|file| list_files(file)}
-        opt.on('-u', '--update FILE','update file') {|file| update_file(file) }
-        opt.on('-r', '--rsync','rsync files') {rsync_files}
-        opt.on('--database FILE','read database file') {|file| db_file(file)}
-        opt.on('--display FILE','display converted hikifile') {|file| display(file)}
-        opt.on('-c', '--checkdb','check database file') {check_db}
-        opt.on('--remove FILE','remove file') {|file| remove_file(file)}
-        opt.on('--move FILES','move file1,file2',Array) {|files| move_file(files)}
-        opt.on('--euc FILE','translate file to euc') {|file| euc_file(file)}
-        opt.on('--initialize','initialize source directory') {dir_init() }
-      end
-      begin
-        command_parser.parse!(@argv)
-      rescue=> eval
-        p eval
-      end
-      dump_sources
-      exit
-    end    
-    
-    def show_sources()
-      printf("target_no:%i\n",@src[:target])
-      printf("editor_command:%s\n",@src[:editor_command])
-      check_display_size()
-      header = display_format('id','name','local directory','global uri')
-
-      puts header
-      puts '-' * header.size
-
-      @src[:srcs].each_with_index{|src,i|
-        target = i==@src[:target] ? '*':' '
-        id = target+i.to_s
-        name=src[:nick_name]
-        local=src[:local_dir]
-        global=src[:global_uri]
-        puts display_format(id,name,local,global)
-      }
-    end
-
-    def add_sources
-      cont = {}
-      @data_name.each{|name|
-        printf("%s ? ", name)
-        tmp = gets.chomp
-        cont[name.to_sym] = tmp
-      }
-      @src[:srcs] << cont
-      show_sources
-    end
-\end{lstlisting}