hikiutils 0.2.3.8 → 0.2.3.9

data/hikiutils_yamane/latex_dir/hikiutils_yamane.log

@@ -1,4 +1,4 @@
-This is e-pTeX, Version 3.14159265-p3.7-160201-2.6 (utf8.euc) (TeX Live 2016) (preloaded format=platex 2017.1.26)  5 FEB 2017 12:43
+This is e-pTeX, Version 3.14159265-p3.7-160201-2.6 (utf8.euc) (TeX Live 2016) (preloaded format=platex 2017.1.26)  6 FEB 2017 17:32
 entering extended mode
  restricted \write18 enabled.
  file:line:error style messages enabled.
@@ -112,21 +112,22 @@ File: listings.cfg 2015/06/04 1.6 listings configuration
 ))
 Package: listings 2015/06/04 1.6 (Carsten Heinz)
 
-(./hikiutils_yamane.aux (./abstract.aux) (./purpose.aux) (./method.aux)
-(./results.aux
+(./hikiutils_yamane.aux (./abstract.aux) (./introduction.aux) (./compare.aux)
+(./optparse.aux
 
 LaTeX Warning: Label `default' multiply defined.
 
 
 LaTeX Warning: Label `default' multiply defined.
 
-) (./clidescription.aux) (./code.aux
+) (./command.aux
 
 LaTeX Warning: Label `default' multiply defined.
 
 
 LaTeX Warning: Label `default' multiply defined.
 
+) (./thor.aux
 
 LaTeX Warning: Label `default' multiply defined.
 
@@ -205,163 +206,201 @@ LaTeX Font Info:    Font shape `JY1/mc/m/n' will be
  (./abstract.tex) [3
 
 ]
-\openout2 = `purpose.aux'.
+\openout2 = `introduction.aux'.
 
- (./purpose.tex)
-[4
+ (./introduction.tex
 
+LaTeX Warning: File `../figs/./hikiutils_yamane_09_copy.001.jpg' not found on i
+nput line 7.
+
+File: ../figs/./hikiutils_yamane_09_copy.001.jpg Graphic file (type eps)
+<../figs/./hikiutils_yamane_09_copy.001.jpg>
+LaTeX Font Info:    Font shape `JT1/mc/m/n' will be
+(Font)              scaled to size 8.64899pt on input line 8.
+LaTeX Font Info:    Font shape `JY1/mc/m/n' will be
+(Font)              scaled to size 8.64899pt on input line 8.
+ [4
+
+
+]) [5] [6
 
 ]
-\openout2 = `method.aux'.
+\openout2 = `compare.aux'.
 
- (./method.tex
+ (./compare.tex
 LaTeX Font Info:    Font shape `JT1/gt/m/n' will be
 (Font)              scaled to size 11.53198pt on input line 2.
 LaTeX Font Info:    Font shape `JY1/gt/m/n' will be
 (Font)              scaled to size 11.53198pt on input line 2.
-File: ../figs/./hikiutils_yamane_09_copy.001.jpg Graphic file (type eps)
- <../figs/./hikiutils_yamane_09_copy.001.jpg>
-LaTeX Font Info:    Font shape `JT1/mc/m/n' will be
-(Font)              scaled to size 8.64899pt on input line 7.
-LaTeX Font Info:    Font shape `JY1/mc/m/n' will be
-(Font)              scaled to size 8.64899pt on input line 7.
- [5
-
 
-]) [6]
 [7
 
+]) [8]
+\openout2 = `optparse.aux'.
+
+ (./optparse.tex
+
+LaTeX Warning: File `../figs/./hikiutils_yamane_09_copy.005.jpg' not found on i
+nput line 9.
+
+File: ../figs/./hikiutils_yamane_09_copy.005.jpg Graphic file (type eps)
+<../figs/./hikiutils_yamane_09_copy.005.jpg>
+(/usr/local/texlive/2016/texmf-dist/tex/latex/listings/lstlang1.sty
+File: lstlang1.sty 2015/06/04 1.6 listings language file
+)
+(/usr/local/texlive/2016/texmf-dist/tex/latex/listings/lstlang2.sty
+File: lstlang2.sty 2015/06/04 1.6 listings language file
+) [9
+
+
 ]
-\openout2 = `results.aux'.
+LaTeX Font Info:    Font shape `JT1/gt/m/n' will be
+(Font)              scaled to size 8.64899pt on input line 20.
+LaTeX Font Info:    Font shape `JY1/gt/m/n' will be
+(Font)              scaled to size 8.64899pt on input line 20.
+LaTeX Font Info:    Font shape `JT1/mc/m/n' will be
+(Font)              scaled to size 6.72699pt on input line 21.
+LaTeX Font Info:    Font shape `JT1/gt/bx/n' in size <9> not available
+(Font)              Font shape `JT1/gt/m/n' tried instead on input line 21.
+LaTeX Font Info:    Font shape `JT1/gt/m/n' will be
+(Font)              scaled to size 8.64899pt on input line 21.
+LaTeX Font Info:    Font shape `JY1/gt/bx/n' in size <9> not available
+(Font)              Font shape `JY1/gt/m/n' tried instead on input line 21.
+LaTeX Font Info:    Font shape `JY1/gt/m/n' will be
+(Font)              scaled to size 8.64899pt on input line 21.
+LaTeX Font Info:    Font shape `OT1/cmtt/bx/n' in size <9> not available
+(Font)              Font shape `OT1/cmtt/m/n' tried instead on input line 21.
 
- (./results.tex
-File: ../figs/./hikiutils_yamane_09_copy.002.jpg Graphic file (type eps)
- <../figs/./hikiutils_yamane_09_copy.002.jpg>
-LaTeX Font Info:    Try loading font information for OMS+cmr on input line 22.
+
+LaTeX Warning: File `../figs/./hikiutils_yamane_09_copy.007.jpg' not found on i
+nput line 58.
+
+File: ../figs/./hikiutils_yamane_09_copy.007.jpg Graphic file (type eps)
+<../figs/./hikiutils_yamane_09_copy.007.jpg> [10]
+LaTeX Font Info:    Try loading font information for OMS+cmr on input line 71.
 
 (/usr/local/texlive/2016/texmf-dist/tex/latex/base/omscmr.fd
 File: omscmr.fd 2014/09/29 v2.5h Standard LaTeX font definitions
 )
 LaTeX Font Info:    Font shape `OMS/cmr/m/n' in size <10> not available
-(Font)              Font shape `OMS/cmsy/m/n' tried instead on input line 22.
- [8
+(Font)              Font shape `OMS/cmsy/m/n' tried instead on input line 71.
+LaTeX Font Info:    Font shape `JT1/gt/m/it' in size <9> not available
+(Font)              Font shape `JT1/gt/m/n' tried instead on input line 73.
+LaTeX Font Info:    Font shape `JT1/gt/m/n' will be
+(Font)              scaled to size 8.64899pt on input line 73.
+LaTeX Font Info:    Font shape `JY1/gt/m/it' in size <9> not available
+(Font)              Font shape `JY1/gt/m/n' tried instead on input line 73.
+LaTeX Font Info:    Font shape `JY1/gt/m/n' will be
+(Font)              scaled to size 8.64899pt on input line 73.
+ [11]) [12]
+[13
 
 ]
-LaTeX Font Info:    Font shape `JT1/mc/m/n' will be
-(Font)              scaled to size 6.72699pt on input line 31.
+\openout2 = `command.aux'.
+
+ (./command.tex
+
+LaTeX Warning: File `../figs/./hikiutils_yamane_09_copy.002.jpg' not found on i
+nput line 16.
+
+File: ../figs/./hikiutils_yamane_09_copy.002.jpg Graphic file (type eps)
+<../figs/./hikiutils_yamane_09_copy.002.jpg> [14
 
+]
 Overfull \hbox (143.87068pt too wide) in paragraph at lines 53--54
 [][][][] 
  []
 
-[9]
+[15]
 Overfull \hbox (16.03305pt too wide) in paragraph at lines 67--89
  [][][] 
  []
 
-[10]) [11]
-\openout2 = `clidescription.aux'.
-
- (./clidescription.tex [12
+[16]) [17]
+\openout2 = `thor.aux'.
 
+ (./thor.tex
 
-]) [13]
-\openout2 = `code.aux'.
+LaTeX Warning: File `../figs/./hikiutils_yamane_09_copy.003.jpg' not found on i
+nput line 15.
 
- (./code.tex
 File: ../figs/./hikiutils_yamane_09_copy.003.jpg Graphic file (type eps)
-
-<../figs/./hikiutils_yamane_09_copy.003.jpg>
-(/usr/local/texlive/2016/texmf-dist/tex/latex/listings/lstlang1.sty
-File: lstlang1.sty 2015/06/04 1.6 listings language file
-)
-(/usr/local/texlive/2016/texmf-dist/tex/latex/listings/lstlang2.sty
-File: lstlang2.sty 2015/06/04 1.6 listings language file
-)
-LaTeX Font Info:    Font shape `JT1/gt/m/n' will be
-(Font)              scaled to size 8.64899pt on input line 21.
-LaTeX Font Info:    Font shape `JY1/gt/m/n' will be
-(Font)              scaled to size 8.64899pt on input line 21.
-LaTeX Font Info:    Font shape `JT1/gt/m/it' in size <9> not available
-(Font)              Font shape `JT1/gt/m/n' tried instead on input line 22.
-LaTeX Font Info:    Font shape `JT1/gt/m/n' will be
-(Font)              scaled to size 8.64899pt on input line 22.
-LaTeX Font Info:    Font shape `JY1/gt/m/it' in size <9> not available
-(Font)              Font shape `JY1/gt/m/n' tried instead on input line 22.
-LaTeX Font Info:    Font shape `JY1/gt/m/n' will be
-(Font)              scaled to size 8.64899pt on input line 22.
- [14
+<../figs/./hikiutils_yamane_09_copy.003.jpg> [18
 
 
 ]
-LaTeX Font Info:    Font shape `JT1/gt/bx/n' in size <9> not available
-(Font)              Font shape `JT1/gt/m/n' tried instead on input line 35.
-LaTeX Font Info:    Font shape `JT1/gt/m/n' will be
-(Font)              scaled to size 8.64899pt on input line 35.
-LaTeX Font Info:    Font shape `JY1/gt/bx/n' in size <9> not available
-(Font)              Font shape `JY1/gt/m/n' tried instead on input line 35.
-LaTeX Font Info:    Font shape `JY1/gt/m/n' will be
-(Font)              scaled to size 8.64899pt on input line 35.
-LaTeX Font Info:    Font shape `OT1/cmtt/bx/n' in size <9> not available
-(Font)              Font shape `OT1/cmtt/m/n' tried instead on input line 35.
+
+LaTeX Warning: File `../figs/./hikiutils_yamane_09_copy.004.jpg' not found on i
+nput line 46.
+
 File: ../figs/./hikiutils_yamane_09_copy.004.jpg Graphic file (type eps)
+<../figs/./hikiutils_yamane_09_copy.004.jpg> [19]
 
-<../figs/./hikiutils_yamane_09_copy.004.jpg> [15]
-File: ../figs/./hikiutils_yamane_09_copy.005.jpg Graphic file (type eps)
+LaTeX Warning: File `../figs/./hikiutils_yamane_09_copy.006.jpg' not found on i
+nput line 77.
 
-<../figs/./hikiutils_yamane_09_copy.005.jpg> [16] [17] [18] [19]
 File: ../figs/./hikiutils_yamane_09_copy.006.jpg Graphic file (type eps)
-
-<../figs/./hikiutils_yamane_09_copy.006.jpg>
-Overfull \hbox (3.95764pt too wide) in paragraph at lines 204--206
+<../figs/./hikiutils_yamane_09_copy.006.jpg> [20]
+Overfull \hbox (3.95764pt too wide) in paragraph at lines 86--87
 \OT1/cmr/m/n/10 Thor \JY1/mc/m/n/10 では \OT1/cmr/m/n/10 start(ARGV) \JY1/mc/m/
 n/10 を呼び出すことで \OT1/cmr/m/n/10 CLI \JY1/mc/m/n/10 を開始する ． \OT1/cmr
 /m/n/10 Hikithor::CLI.start(ARGV)
  []
 
-File: ../figs/./hikiutils_yamane_09_copy.007.jpg Graphic file (type eps)
-<../figs/./hikiutils_yamane_09_copy.007.jpg> [20] [21] [22] [23]) [24]
-Overfull \hbox (172.09023pt too wide) in paragraph at lines 58--59
+
+Overfull \hbox (56.86226pt too wide) in paragraph at lines 107--107
+ []  \OT1/cmtt/m/n/10 attr_accessor :src, :target, :editor_command, :browser, :
+data_name, :l_dir[] 
+ []
+
+
+Overfull \hbox (77.86208pt too wide) in paragraph at lines 107--107
+ []      \OT1/cmtt/m/n/10 @data_name=['nick_name','local_dir','local_uri','glob
+al_dir','global_uri'][] 
+ []
+
+[21]) [22]
+Overfull \hbox (172.09023pt too wide) in paragraph at lines 59--60
 []\OT1/cmr/m/n/10 [1-1] hiki-doc, \OT1/cmtt/m/n/10 https://rubygems.org/gems/hi
 kidoc/versions/0.1.0, https://github.com/hiki/hikidoc,2017/1/30
  []
 
 
-Overfull \hbox (40.87556pt too wide) in paragraph at lines 60--61
+Overfull \hbox (40.87556pt too wide) in paragraph at lines 61--62
 []\OT1/cmr/m/n/10 [1-2]  \JY1/mc/m/n/10 「\OT1/cmr/m/n/10 Thor \JY1/mc/m/n/10 
 の使い方まとめ 」 \OT1/cmr/m/n/10 , \OT1/cmtt/m/n/10 http://qiita.com/succi0303
 /items/32560103190436c9435b
  []
 
 
-Overfull \hbox (118.23022pt too wide) in paragraph at lines 62--63
+Overfull \hbox (118.23022pt too wide) in paragraph at lines 63--64
 []\OT1/cmr/m/n/10 [1-3]  \JY1/mc/m/n/10 「\OT1/cmr/m/n/10 15.5. opt-parse - \JY
 1/mc/m/n/10 コマンドラインオプシ ョン解析器 」 \OT1/cmr/m/n/10 , \OT1/cmtt/m/n/
 10 http://docs.python.jp/2/library/optparse.html
  []
 
 
-Overfull \hbox (48.19972pt too wide) in paragraph at lines 64--65
+Overfull \hbox (48.19972pt too wide) in paragraph at lines 65--66
 []\OT1/cmr/m/n/10 [1-4]  \JY1/mc/m/n/10 「\OT1/cmr/m/n/10 li-brary opt-parse\JY
 1/mc/m/n/10 」 \OT1/cmr/m/n/10 , \OT1/cmtt/m/n/10 https://docs.ruby-lang.org/ja
 /latest/library/optparse.html
  []
 
-[25
+[23
 
-] (./hikiutils_yamane.aux (./abstract.aux) (./purpose.aux) (./method.aux)
-(./results.aux) (./clidescription.aux) (./code.aux))
+] (./hikiutils_yamane.aux (./abstract.aux) (./introduction.aux)
+(./compare.aux) (./optparse.aux) (./command.aux) (./thor.aux))
 
 LaTeX Warning: There were multiply-defined labels.
 
  ) 
 Here is how much of TeX's memory you used:
- 2579 strings out of 493683
- 35621 string characters out of 6149653
- 256222 words of memory out of 5000000
- 6109 multiletter control sequences out of 15000+600000
+ 2590 strings out of 493683
+ 35742 string characters out of 6149653
+ 246437 words of memory out of 5000000
+ 6120 multiletter control sequences out of 15000+600000
  15673 words of font info for 72 fonts, out of 8000000 for 9000
  934 hyphenation exceptions out of 8191
- 34i,9n,51p,588b,1731s stack positions out of 5000i,500n,10000p,200000b,80000s
+ 34i,9n,51p,781b,1694s stack positions out of 5000i,500n,10000p,200000b,80000s
 
-Output written on hikiutils_yamane.dvi (25 pages, 103944 bytes).
+Output written on hikiutils_yamane.dvi (23 pages, 77320 bytes).

data/hikiutils_yamane/latex_dir/hikiutils_yamane.tex

@@ -48,12 +48,13 @@
 \tableofcontents
 
 \include{abstract}
-\include{purpose}
-\include{method}
+\include{introduction}
+\section{方法}
+\include{compare}
+\include{optparse}
 \section{結果}
-\include{results}
-\include{clidescription}
-\include{code}
+\include{command}
+\include{thor}
 \section{参考文献}
 [1-1] hikidoc, \verb|https://rubygems.org/gems/hikidoc/versions/0.1.0,| \verb|https://github.com/hiki/hikidoc,2017/1/30| アクセス.
 

data/hikiutils_yamane/latex_dir/hikiutils_yamane.toc

@@ -1,22 +1,26 @@
 \contentsline {section}{\numberline {1}概要}{3}
-\contentsline {section}{\numberline {2}目的}{4}
-\contentsline {section}{\numberline {3}方法}{5}
-\contentsline {subsection}{\numberline {3.1}既存システムの説明}{5}
-\contentsline {section}{\numberline {4}結果}{7}
-\contentsline {subsection}{\numberline {4.1}コマンドの命名原則}{8}
-\contentsline {subsection}{\numberline {4.2}hikiutilsがあらかじめ想定している利用形態}{8}
-\contentsline {subsection}{\numberline {4.3}コメンド名と振る舞いの詳細}{10}
-\contentsline {subsection}{\numberline {4.4}CLIの解説}{12}
-\contentsline {subsubsection}{\numberline {4.4.1}Thor}{12}
-\contentsline {subsubsection}{\numberline {4.4.2}optparse}{12}
-\contentsline {subsection}{\numberline {4.5}Thorの初期化}{14}
-\contentsline {subsubsection}{\numberline {4.5.1}コード}{14}
-\contentsline {subsection}{\numberline {4.6}コマンド表示と処理}{15}
-\contentsline {subsubsection}{\numberline {4.6.1}Thor}{15}
-\contentsline {subsubsection}{\numberline {4.6.2}optparse}{16}
-\contentsline {subsubsection}{\numberline {4.6.3}コード}{17}
-\contentsline {subsection}{\numberline {4.7}CLIの実行}{20}
-\contentsline {subsubsection}{\numberline {4.7.1}Thor}{20}
-\contentsline {subsubsection}{\numberline {4.7.2}optparse}{20}
-\contentsline {subsubsection}{\numberline {4.7.3}コード}{21}
-\contentsline {section}{\numberline {5}参考文献}{25}
+\contentsline {section}{\numberline {2}序論}{4}
+\contentsline {section}{\numberline {3}方法}{6}
+\contentsline {subsection}{\numberline {3.1}optparseとthorの比較}{7}
+\contentsline {subsubsection}{\numberline {3.1.1}optparse}{7}
+\contentsline {subsubsection}{\numberline {3.1.2}Thor}{7}
+\contentsline {subsection}{\numberline {3.2}既存のhikiutilsのコマンド解説}{9}
+\contentsline {subsubsection}{\numberline {3.2.1}コマンドの登録と実行メソッド}{9}
+\contentsline {subsubsection}{\numberline {3.2.2}CLIの実行プロセス}{10}
+\contentsline {subsubsection}{\numberline {3.2.3}コード}{11}
+\contentsline {section}{\numberline {4}結果}{13}
+\contentsline {subsection}{\numberline {4.1}コマンドの命名原則}{14}
+\contentsline {subsubsection}{\numberline {4.1.1}hikiutilsの想定利用形態}{14}
+\contentsline {subsubsection}{\numberline {4.1.2}コメンド名と振る舞いの詳細}{16}
+\contentsline {paragraph}{open FILE}{16}
+\contentsline {paragraph}{ls [FILE]}{17}
+\contentsline {paragraph}{rsync}{17}
+\contentsline {paragraph}{touch FILE}{17}
+\contentsline {paragraph}{pwd}{17}
+\contentsline {paragraph}{cd VAL}{17}
+\contentsline {subsection}{\numberline {4.2}Thorによる実装}{18}
+\contentsline {subsubsection}{\numberline {4.2.1}クラス初期化}{18}
+\contentsline {subsubsection}{\numberline {4.2.2}コマンド定義}{19}
+\contentsline {subsubsection}{\numberline {4.2.3}CLIの実行プロセス}{20}
+\contentsline {subsubsection}{\numberline {4.2.4}optparseとの全体的な比較}{22}
+\contentsline {section}{\numberline {5}参考文献}{23}

data/hikiutils_yamane/latex_dir/{purpose.aux → introduction.aux}

@@ -1,7 +1,9 @@
 \relax 
-\@writefile{toc}{\contentsline {section}{\numberline {2}目的}{4}}
-\@setckpt{purpose}{
-\setcounter{page}{5}
+\@writefile{toc}{\contentsline {section}{\numberline {2}序論}{4}}
+\@writefile{lof}{\contentsline {figure}{\numberline {1}{\ignorespaces hiki web systemとhiki systemの対応関係．}}{4}}
+\newlabel{default}{{1}{4}}
+\@setckpt{introduction}{
+\setcounter{page}{6}
 \setcounter{equation}{0}
 \setcounter{enumi}{0}
 \setcounter{enumii}{0}
@@ -15,7 +17,7 @@
 \setcounter{subsubsection}{0}
 \setcounter{paragraph}{0}
 \setcounter{subparagraph}{0}
-\setcounter{figure}{0}
+\setcounter{figure}{1}
 \setcounter{table}{0}
 \setcounter{lstnumber}{1}
 \setcounter{lstlisting}{0}

data/hikiutils_yamane/latex_dir/introduction.tex

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

data/hikiutils_yamane/latex_dir/optparse.aux

@@ -0,0 +1,29 @@
+\relax 
+\@writefile{toc}{\contentsline {subsection}{\numberline {3.2}既存のhikiutilsのコマンド解説}{9}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.2.1}コマンドの登録と実行メソッド}{9}}
+\@writefile{lof}{\contentsline {figure}{\numberline {2}{\ignorespaces コマンドの登録と実行メソッドの対応}}{9}}
+\newlabel{default}{{2}{9}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.2.2}CLIの実行プロセス}{10}}
+\@writefile{lof}{\contentsline {figure}{\numberline {3}{\ignorespaces CLIの実行プロセス．}}{11}}
+\newlabel{default}{{3}{11}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.2.3}コード}{11}}
+\@setckpt{optparse}{
+\setcounter{page}{13}
+\setcounter{equation}{0}
+\setcounter{enumi}{2}
+\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{paragraph}{0}
+\setcounter{subparagraph}{0}
+\setcounter{figure}{3}
+\setcounter{table}{0}
+\setcounter{lstnumber}{38}
+\setcounter{lstlisting}{0}
+}

data/hikiutils_yamane/latex_dir/optparse.tex

@@ -0,0 +1,116 @@
+
+\subsection{既存のhikiutilsのコマンド解説}
+既存のhikiutilsはコマンド解析ライブラリのoptparseを用いて，コマンドの処理を行っている．
+optparseの特徴は，「コマンドの登録，実行method」に分けて記述することが期待されている．
+また，CLIの起動の仕方が特徴的である．この二つを取り出して，動作とコードを説明する．
+
+\subsubsection{コマンドの登録と実行メソッド}
+\begin{figure}[htbp]\begin{center}
+\includegraphics[width=6cm,bb=0 0 442 432]{../figs/./hikiutils_yamane_09_copy.005.jpg}
+\caption{コマンドの登録と実行メソッドの対応}
+\label{default}\end{center}\end{figure}
+optparseでは以下の通り，コマンドの登録と実行が行われる．
+
+\begin{enumerate}
+\item OptionParserオブジェクトoptを生成
+\item optにコマンドを登録
+\item 入力されたコマンドの処理のメソッドへ移動
+\end{enumerate}
+optparseではOptionParserオブジェクトoptの生成を行い，コマンドをoptに登録することでコマンドを作成することができる．しかし，これはコマンドを登録しているだけでコマンドの一覧ではこれを表示することができるが，コマンドの実行を行うためには実行を行うためのメソッドを作成する必要がある．optparseでのコマンドの実行はoptで登録されたコマンドが入力されることでそれぞれのコマンドの処理を行うメソッドに移動し処理を行う．しかし，このコマンド登録はハイフンを付けたコマンドしか登録ができず，ハイフンなしのコマンド登録はまた別の手段でやらなくてはいけない．
+\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) }
+
+        ...省略...
+
+      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])
+
+      ...省略...
+
+    end
+
+    以下略
+
+\end{lstlisting}
+\subsubsection{CLIの実行プロセス}
+\begin{figure}[htbp]\begin{center}
+\includegraphics[width=6cm,bb=0 0 442 432]{../figs/./hikiutils_yamane_09_copy.007.jpg}
+\caption{CLIの実行プロセス．}
+\label{default}\end{center}\end{figure}
+optparseを用いた場合のCLIの実行プロセスは次の通りとなる．
+
+\begin{enumerate}
+\item HikiのHikiUtils::Command.run(ARGV)でhikiutils.rbのrunメソッドを呼ぶ
+\item new(argv).executeでexecuteメソッドが実行される
+\end{enumerate}
+optparseではHikiutils::Command.run(ARGV)を実行される．requireで呼び出されたhikiutils.rbでrunメソッドが実行される．そこでコマンドを登録しているexecuteメソッドへ移動し入力したコマンドと対応させる．そして，対応したコマンドの処理が行われるメソッドに移動することで実行される．このようにoptparseでは実行を行うためのメソッドが必要であるが，
+
+\subsubsection{コード}
+\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}

data/hikiutils_yamane/latex_dir/thor.aux

@@ -0,0 +1,32 @@
+\relax 
+\@writefile{toc}{\contentsline {subsection}{\numberline {4.2}Thorによる実装}{18}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.2.1}クラス初期化}{18}}
+\@writefile{lof}{\contentsline {figure}{\numberline {5}{\ignorespaces Thorのinitializeでのコード}}{18}}
+\newlabel{default}{{5}{18}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.2.2}コマンド定義}{19}}
+\@writefile{lof}{\contentsline {figure}{\numberline {6}{\ignorespaces thorにおけるコマンド記述のひな形．}}{20}}
+\newlabel{default}{{6}{20}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.2.3}CLIの実行プロセス}{20}}
+\@writefile{lof}{\contentsline {figure}{\numberline {7}{\ignorespaces CLIの実行プロセス．}}{21}}
+\newlabel{default}{{7}{21}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.2.4}optparseとの全体的な比較}{22}}
+\@setckpt{thor}{
+\setcounter{page}{23}
+\setcounter{equation}{0}
+\setcounter{enumi}{2}
+\setcounter{enumii}{0}
+\setcounter{enumiii}{0}
+\setcounter{enumiv}{0}
+\setcounter{footnote}{0}
+\setcounter{mpfootnote}{0}
+\setcounter{part}{0}
+\setcounter{section}{4}
+\setcounter{subsection}{2}
+\setcounter{subsubsection}{4}
+\setcounter{paragraph}{0}
+\setcounter{subparagraph}{0}
+\setcounter{figure}{7}
+\setcounter{table}{1}
+\setcounter{lstnumber}{6}
+\setcounter{lstlisting}{0}
+}