hikiutils 0.2.3.13 → 0.2.3.14

data/hikiutils_bob/latex_dir/latex_all.aux

@@ -1,19 +1,22 @@
 \relax 
-\@writefile{toc}{\contentsline {section}{\numberline {3}実際の最終形態(卒論=pdf)への変換}{13}}
-\@writefile{toc}{\contentsline {subsection}{\numberline {3.1}install}{13}}
-\@writefile{toc}{\contentsline {subsection}{\numberline {3.2}rake latex（個別ファイルの変換）}{14}}
-\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.2.1}注意}{14}}
-\@writefile{toc}{\contentsline {subsection}{\numberline {3.3}rake latex\_all手順（ディレクトリー内の一括変換）}{15}}
-\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.3.1}下準備}{15}}
-\@writefile{toc}{\contentsline {paragraph}{head.tex}{16}}
-\@writefile{toc}{\contentsline {paragraph}{pre.tex}{16}}
-\@writefile{toc}{\contentsline {paragraph}{mainのpreamble部}{16}}
-\@writefile{toc}{\contentsline {subsection}{\numberline {3.4}補助コマンドの解説}{17}}
-\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.4.1}rake reset\_latex\_dir(latex\_dirのゴミ掃除)}{17}}
-\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.4.2}wrap関係}{17}}
-\@writefile{toc}{\contentsline {subsection}{\numberline {3.5}開発メモ（2017/2/8)}{18}}
+\@writefile{toc}{\contentsline {section}{\numberline {3}実際の最終形態(卒論=pdf)への変換}{14}}
+\@writefile{toc}{\contentsline {subsection}{\numberline {3.1}install}{14}}
+\@writefile{toc}{\contentsline {subsection}{\numberline {3.2}rake latex（個別ファイルの変換）}{15}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.2.1}注意}{15}}
+\@writefile{toc}{\contentsline {subsection}{\numberline {3.3}rake latex\_all手順（ディレクトリー内の一括変換）}{16}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.3.1}下準備}{16}}
+\@writefile{toc}{\contentsline {paragraph}{head.tex}{17}}
+\@writefile{toc}{\contentsline {paragraph}{pre.tex}{17}}
+\@writefile{toc}{\contentsline {paragraph}{mainのpreamble部}{17}}
+\@writefile{toc}{\contentsline {subsection}{\numberline {3.4}補助コマンドの解説}{18}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.4.1}rake reset\_latex\_dir(latex\_dirのゴミ掃除)}{18}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.4.2}wrap関係}{18}}
+\@writefile{toc}{\contentsline {subsection}{\numberline {3.5}参照のシステム}{19}}
+\@writefile{lof}{\contentsline {figure}{\numberline {5}{\ignorespaces 参照機能を利用した場合の変換後の表示．}}{20}}
+\newlabel{fig:CiteRefSystems}{{5}{20}}
+\newlabel{default}{{5}{20}}
 \@setckpt{latex_all}{
-\setcounter{page}{19}
+\setcounter{page}{21}
 \setcounter{equation}{0}
 \setcounter{enumi}{4}
 \setcounter{enumii}{1}
@@ -27,8 +30,8 @@
 \setcounter{subsubsection}{0}
 \setcounter{paragraph}{0}
 \setcounter{subparagraph}{0}
-\setcounter{figure}{4}
+\setcounter{figure}{5}
 \setcounter{table}{1}
-\setcounter{lstnumber}{10}
+\setcounter{lstnumber}{11}
 \setcounter{lstlisting}{0}
 }

data/hikiutils_bob/latex_dir/latex_all.log

@@ -0,0 +1,28 @@
+This is e-pTeX, Version 3.14159265-p3.7-160201-2.6 (utf8.euc) (TeX Live 2016) (preloaded format=platex 2017.1.26)  10 FEB 2017 16:46
+entering extended mode
+ restricted \write18 enabled.
+ file:line:error style messages enabled.
+ %&-line parsing enabled.
+**latex_all.tex
+(./latex_all.tex
+pLaTeX2e <2016/11/29> (based on LaTeX2e <2017/01/01>)
+Babel <3.9r> and hyphenation patterns for 83 language(s) loaded.
+./latex_all.tex:2: Undefined control sequence.
+l.2 \section
+            {実際の最終形態(卒論=pdf)への変換}
+? 
+./latex_all.tex:2: Emergency stop.
+l.2 \section
+            {実際の最終形態(卒論=pdf)への変換}
+End of file on the terminal!
+
+ 
+Here is how much of TeX's memory you used:
+ 4 strings out of 493683
+ 50 string characters out of 6149653
+ 53892 words of memory out of 5000000
+ 3671 multiletter control sequences out of 15000+600000
+ 7511 words of font info for 31 fonts, out of 8000000 for 9000
+ 929 hyphenation exceptions out of 8191
+ 5i,0n,3p,58b,8s stack positions out of 5000i,500n,10000p,200000b,80000s
+No pages of output.

data/hikiutils_bob/latex_dir/latex_all.tex

@@ -122,7 +122,7 @@ hiki -i
 
 \paragraph{head.tex}
 題目，学生番号，氏名を変更する．年月をチェック．
-\\setcounter{tocdepth}はtocをどこまで表示するかのレベルに対応します．
+\\setcounter\{tocdepth\}はtocをどこまで表示するかのレベルに対応します．
 原稿作成時は階層がわかりやすいように深めにしていますが，本番では2程度で十分です．
 \begin{lstlisting}[style=customTeX,basicstyle={\scriptsize\ttfamily}]
 bob% cat head.tex
@@ -197,7 +197,9 @@ wrapfigureでtextの回りこみや位置調整を行う必要があります．
 \item rake change\_wrap(wrapで変換)
 \item rake latex\_base(latexに変換するだけの下請け)
 \item rake latex\_wrap(figure環境だけをwrapfig環境に変える)
-\end{itemize}\begin{lstlisting}[style=customRuby,basicstyle={\scriptsize\ttfamily}]
+\end{itemize}
+Rakefile内の記述は
+\begin{lstlisting}[style=customRuby,basicstyle={\scriptsize\ttfamily}]
 desc "latex conversion FILE1"
 task :latex => [:latex_base] do
   exit
@@ -208,17 +210,40 @@ task :latex_wrap => [:latex_base, :change_wrap] do
   exit
 end
 \end{lstlisting}
+となっています．つまり，:latex\_baseをした後に，:change\_wrapを呼び出しています．
+
 完成例はこちらです．
 
 \begin{itemize}
 \item \verb|{{attach_anchor(calphad_bob.pdf,hikiutils_bob)}}|
 \end{itemize}
-\subsection{開発メモ（2017/2/8)}
+発表会の予稿ハンドアウトなどではこれが不可欠です．
+
+\subsection{参照のシステム}
+latexへ文献参照を渡すために，下記のようなフォーマットでの記述を行ってください．
+\begin{lstlisting}[style=customCsh,basicstyle={\scriptsize\ttfamily}]
+図{{ref(fig:SystemOverview)}}に卒論編集システムの概観を示しています．
+
+!!!caption: (fig:SystemOverview)卒論編集システムの概観．
+{{attach_view(hikiutils_bob.006.jpeg)}}
+
+*基本的な使い方{{cite(listings1)}}
+*独自のカラー化{{cite(listings2)}}
+!reference:
+:listings1:[[http://d.hatena.ne.jp/mallowlabs/20061226/1167137637]]
+:listings2:[[http://www.ipc.akita-nct.ac.jp/~yamamoto/comp/latex/make_doc/source/source.html]]
+\end{lstlisting}
 \begin{itemize}
-\item hikiutilsにlatex2hiki, hiki2latexも統合すべきか？
-\item \verb|{{ref}}| \verb|{{cite}}|を組み込む
-\item hikiにではなく，rake syncで変換
-\item listingsの調整
-\item jlistingは，\\lstsetや\\lstdefinestyleで引っかかってダメ
-\item basicstyle={\small\ttfamily}これ効いてんにゃろか？？
+\item caption以下の丸括弧内にタグを書きます．
+\item fig:以下のタグにsnake nameは使えません．Camelで書くようにしてください．
+\item refでそれを参照します．
+\item citeの方も同じです．
+\item reference:以下の:...:記述がlatexではbibliographyに変わります．
 \end{itemize}
+これをsync, all\_latexをかけると図\ref{fig:CiteRefSystems}のようになります．latexの文献参照(cite, bibliography)，図表番号の参照(ref, label)が正常に処理されていることが確認できます．また，web表示した場合でもそれほど違和感なく読めるでしょう．
+
+\begin{figure}[htbp]\begin{center}
+\includegraphics[width=10cm,bb= 0 0 737 553]{../figs/./hikiutils_bob.007.jpeg}
+\caption{参照機能を利用した場合の変換後の表示．}
+\label{fig:CiteRefSystems}
+\label{default}\end{center}\end{figure}

data/hikiutils_bob/latex_dir/sync.aux

@@ -1,39 +1,39 @@
 \relax 
 \@writefile{toc}{\contentsline {section}{\numberline {1}イントロダクション}{4}}
-\@writefile{lof}{\contentsline {figure}{\numberline {1}{\ignorespaces 卒論編集システムの基本概念．}}{4}}
-\newlabel{default}{{1}{4}}
-\@writefile{toc}{\contentsline {section}{\numberline {2}hikiとの同期}{5}}
-\@writefile{toc}{\contentsline {subsection}{\numberline {2.1}hikiutilsのinstall}{5}}
+\@writefile{toc}{\contentsline {section}{\numberline {2}hikiとの同期}{4}}
+\@writefile{toc}{\contentsline {subsection}{\numberline {2.1}hikiutilsのinstall}{4}}
+\@writefile{lof}{\contentsline {figure}{\numberline {1}{\ignorespaces 卒論編集システムの基本概念．}}{5}}
+\newlabel{default}{{1}{5}}
 \@writefile{toc}{\contentsline {subsection}{\numberline {2.2}個別ディレクトリーの構成}{5}}
 \@writefile{lof}{\contentsline {figure}{\numberline {2}{\ignorespaces hikiutils\_bobのディレクトリー構成．}}{6}}
 \newlabel{default}{{2}{6}}
 \@writefile{toc}{\contentsline {subsection}{\numberline {2.3}システムの概要}{6}}
-\@writefile{toc}{\contentsline {subsection}{\numberline {2.4}一般的な執筆手順}{6}}
 \@writefile{lof}{\contentsline {figure}{\numberline {3}{\ignorespaces システムの概要．}}{7}}
 \newlabel{default}{{3}{7}}
-\@writefile{toc}{\contentsline {subsection}{\numberline {2.5}rakeが用意しているタスク}{7}}
+\@writefile{toc}{\contentsline {subsection}{\numberline {2.4}一般的な執筆手順}{7}}
+\@writefile{toc}{\contentsline {subsection}{\numberline {2.5}rakeが用意しているタスク}{8}}
 \@writefile{toc}{\contentsline {subsubsection}{\numberline {2.5.1}rake sync}{8}}
 \@writefile{lot}{\contentsline {table}{\numberline {1}{\ignorespaces }}{8}}
 \newlabel{default}{{1}{8}}
 \@writefile{toc}{\contentsline {subsubsection}{\numberline {2.5.2}rake force\_sync}{8}}
-\@writefile{toc}{\contentsline {subsubsection}{\numberline {2.5.3}rake chenv}{8}}
-\@writefile{toc}{\contentsline {subsubsection}{\numberline {2.5.4}rake convert VAL DIR}{8}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {2.5.3}rake chenv}{9}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {2.5.4}rake convert VAL DIR}{9}}
 \@writefile{toc}{\contentsline {subsubsection}{\numberline {2.5.5}rake increment}{9}}
 \@writefile{toc}{\contentsline {subsubsection}{\numberline {2.5.6}rake number}{9}}
-\@writefile{toc}{\contentsline {subsubsection}{\numberline {2.5.7}rake open [FILE] (new)}{9}}
-\@writefile{toc}{\contentsline {subsubsection}{\numberline {2.5.8}rake touch [FILE](new)}{9}}
-\@writefile{toc}{\contentsline {subsubsection}{\numberline {2.5.9}rake github(new)}{9}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {2.5.7}rake open [FILE] (new)}{10}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {2.5.8}rake touch [FILE](new)}{10}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {2.5.9}rake github(new)}{10}}
 \@writefile{toc}{\contentsline {subsubsection}{\numberline {2.5.10}rake reset\_hiki(new)}{10}}
 \@writefile{toc}{\contentsline {subsection}{\numberline {2.6}githubによる同期}{10}}
-\@writefile{lof}{\contentsline {figure}{\numberline {4}{\ignorespaces 卒論編集時のgithubによる同期のシーケンス図．}}{10}}
-\newlabel{default}{{4}{10}}
+\@writefile{lof}{\contentsline {figure}{\numberline {4}{\ignorespaces 卒論編集時のgithubによる同期のシーケンス図．}}{11}}
+\newlabel{default}{{4}{11}}
 \@writefile{toc}{\contentsline {subsection}{\numberline {2.7}hikiutil関連のヘルプ}{11}}
 \@writefile{toc}{\contentsline {subsubsection}{\numberline {2.7.1}hikiで卒論を書くときの初期化と掟}{11}}
-\@writefile{toc}{\contentsline {subsubsection}{\numberline {2.7.2}図表に関する制約}{11}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {2.7.2}図表に関する制約}{12}}
 \@writefile{toc}{\contentsline {subsubsection}{\numberline {2.7.3}同期に関する制約}{12}}
-\@writefile{toc}{\contentsline {subsubsection}{\numberline {2.7.4}テキストに関する制約}{12}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {2.7.4}テキストに関する制約}{13}}
 \@setckpt{sync}{
-\setcounter{page}{13}
+\setcounter{page}{14}
 \setcounter{equation}{0}
 \setcounter{enumi}{4}
 \setcounter{enumii}{1}

data/hikiutils_bob/latex_dir/sync.tex

@@ -7,7 +7,7 @@
 本資料では，卒論の編集作業を効率化する図に示すようなシステムの使い方を紹介します．
 
 \begin{figure}[htbp]\begin{center}
-\includegraphics[width=10cm,bb=]{../figs/./hikiutils_bob.002.jpeg}
+\includegraphics[width=10cm,bb= 0 0 737 553]{../figs/./hikiutils_bob.002.jpeg}
 \caption{卒論編集システムの基本概念．}
 \label{default}\end{center}\end{figure}
 例えば，卒業生をyamaneとしましょう．yamaneの個人のMacの自分のdirectory(hikiutils\_yamane)に幾つかのファイルを作成して卒論を書いているとします．これを指導教官(bob)が編集するとします．この同期には，Githubにより提供される共同作業環境を使います．これだけでは編集中の文書の体裁がわかりにくいでしょう．そこで，hikiシステムにより容易にwebブラウザ上に完成形を表示しつつ執筆することが求められます．このような環境を提供するのが，本システムです．
@@ -28,7 +28,7 @@ hiki -v
 図にhikiutils\_bobのディレクトリー構成を示す．
 
 \begin{figure}[htbp]\begin{center}
-\includegraphics[width=10cm,bb=]{../figs/./hikiutils_bob.003.jpeg}
+\includegraphics[width=10cm,bb= 0 0 737 553]{../figs/./hikiutils_bob.003.jpeg}
 \caption{hikiutils\_bobのディレクトリー構成．}
 \label{default}\end{center}\end{figure}
 コマンド
@@ -56,7 +56,7 @@ keynoteで図を作成して，hikiutils\_bob.hikiに文章を記述していく
 図に論文作成システムの概要を示している．gemのなかに作られた例えば，hikiutils\_bobなどのdirectory内にRakefileなどを次節のコマンドを使って入れる．このdirectoryでhikiutils\_bob.hikiなどのhikiフォーマットのdocumentを作っていく．rake syncによってwebを提供するhikiのtext, attach, parserなどと同期する．一方，最終の卒業論文形態であるpdfにするためにlatex\_dir内に*.texを生成する．これは次章で解説する．
 
 \begin{figure}[htbp]\begin{center}
-\includegraphics[width=10cm,bb=]{../figs/./hikiutils_bob.004.jpeg}
+\includegraphics[width=10cm,bb= 0 0 737 553]{../figs/./hikiutils_bob.004.jpeg}
 \caption{システムの概要．}
 \label{default}\end{center}\end{figure}
 \subsection{一般的な執筆手順}
@@ -188,7 +188,7 @@ remove hikiutils_bob_toc[ynqlA]?
 これらの作業の流れを示すシーケンス図は次の通りである．
 
 \begin{figure}[htbp]\begin{center}
-\includegraphics[width=10cm,bb=]{../figs/./hikiutils_bob.005.jpeg}
+\includegraphics[width=10cm,bb= 0 0 737 553]{../figs/./hikiutils_bob.005.jpeg}
 \caption{卒論編集時のgithubによる同期のシーケンス図．}
 \label{default}\end{center}\end{figure}
 git init, forkが済んでいると仮定して同期の手順を以下に示す．

data/hikiutils_yamane/Rakefile

@@ -2,6 +2,8 @@
 require 'systemu'
 require 'tempfile'
 require 'colorize'
+require 'coderay'
+
 # -*- coding: utf-8 -*-
 begin
   $hiki_dir = File.readlines('./.hikirc')[0].chomp
@@ -66,9 +68,11 @@ end
 desc "latex_dirのゴミを掃除"
 task :reset_latex_dir do
   system "mv latex_dir/head.tex ."
+  system "mv latex_dir/jlisting.sty ."
   system "rm -rf latex_dir"
   system "mkdir latex_dir"
   system "mv head.tex latex_dir/"
+  system "mv jlisting.sty latex_dir/"
   system "rake latex_all"
 end
 
@@ -116,7 +120,8 @@ end
 
 desc "FILE.hikiあるいはhikiファイルをedtiorで開く"
 task :open do
-  if file=ARGV[1] 
+  if file=ARGV[1]
+    file += '.hiki' if file.split(".")[1]==nil
     system "open -a mi #{file}"
   else
     Dir.entries('.').each{|file|
@@ -443,7 +448,14 @@ task :self_copy do
   cp_files.each{|files|
     p source = files[0]
     p target = File.join('/Users/bob/Github/hikiutils/lib/templates/',files[1])
-    FileUtils.cp(source,target,:verbose=>true)
+    command = "diff #{source} #{target}"
+    status, stdout, stderr=systemu command
+    if stdout!=''
+      puts command.red
+      puts CodeRay.scan(stdout, :Diff).term  
+      print " Are you sure to save #{source}? [Yn]  ".red
+      FileUtils.cp(source,target,:verbose=>true) if STDIN.gets.chomp=='Y'
+    end
   }
 end
 

data/hikiutils_yamane/abstract.hiki

@@ -1,8 +1,8 @@
 !概要
-研究室内の内部文書，あるいは外部への宣伝資料，さらにwikipediaのように重要な研究成果の発信などに西谷研ではhiki systemを利用しています．
+研究室内の内部文書，あるいは外部への宣伝資料，さらにwikipediaのように重要な研究成果の発信などに西谷研ではhiki systemを利用する．
 これは初心者にも覚えやすい直感的な操作であるが，慣れてくるとテキスト編集や画面更新にいちいちweb画面へ移行せねばならず，編集の思考が停止する．
 そこで，編集操作がCUIで完結させるためにテキスト編集に優れたeditorとの連携や，terminal上のshell commandと連携しやすいhikiutilsが開発された．
 しかし，そのユーザーインターフェースにはコマンドが直感的でないという問題がある．
 そこで，本研究ではコマンドラインツール作成ライブラリを変更することでコマンドを実装し直し直感的なコマンドにすることを目的とした．
-optparseで作成されているhikiutilsをthorで作成し，そして２つのコマンドラインツール作成ライブラリで作成されたhikiutilsを比較する．
-研究結果は，thorのほうがコマンドを簡単に定義することができ，またコードも短くできた．
+optparseで作成されているhikiutilsをThorで作成し，そして２つのコマンドラインツール作成ライブラリで作成されたhikiutilsを比較する．
+研究結果は，Thorのほうがコマンドを簡単に定義することができ，またコードも短くできた．

data/hikiutils_yamane/discussion.hiki

@@ -0,0 +1,9 @@
+!optparseからThorへの移行
+
+Thorとoptparseでのコードの違いは以上のとおりであるが,コードからもThorのほうが短くなっていることが分かる．
+しかし，Thorの問題点はメソッド名がコマンドとなるため，１つしか定義できないことである．
+これを解決するためにmapを用い,複数のコマンドを定義できるようにした．
+一方，optparseでは別のコマンドを定義するにはfizzbuzzのoptparseのコードのようにコマンドの解析を行う必要がある．
+つまり，optparseでのコマンド定義はThorより複雑で記述が長くなるということである．
+それに対してThorのほうが全体的にもコードが短くなり，コマンドの定義も簡単に行うことができる．
+また，実行手順も分かりやすくコードが読みやすいため書き換えもすぐ行うことができるので，より直感的なコマンドを実装することも可能となった．

data/hikiutils_yamane/hikiutils_yamane.hiki

@@ -4,22 +4,20 @@
 
 ![[概要|hikiutils_yamane_abstract]]
 ![[序論|hikiutils_yamane_introduction]]
-!方法
+![[方法|hikiutils_yamane_method]]
 //他人の仕事，あるものを探す
-!![[optparseとthorの比較|hikiutils_yamane_compare]]
-!![[既存のhikiutilsのコマンド解説|hikiutils_yamane_optparse]]
-!結果
+//!![[optparseとthorの比較|hikiutils_yamane_compare]]
+//!![[既存のhikiutilsのコマンド解説|hikiutils_yamane_optparse]]
+![[結果|hikiutils_yamane_results]]
 //自分の仕事，ないものをつくる
-!![[コマンドの命名原則|hikiutils_yamane_command]]
-!![[hikiutilsのthorのコード解説|hikiutils_yamane_thor]]
-
+//!![[コマンドの命名原則|hikiutils_yamane_command]]
+//!![[hikiutilsのthorのコード解説|hikiutils_yamane_thor]]
+![[議論|hikiutils_yamane_discussion]]
 !reference:
 :1-1: hikidoc, https://rubygems.org/gems/hikidoc/versions/0.1.0, https://github.com/hiki/hikidoc,2017/1/30 アクセス.
 // 「hiki」,hikiwiki.org/ja/about.html ,2017/1/30 アクセス.
 // 「hikiutils」,https://rubygems.org/gems/hikiutils ,2017/1/30 アクセス.
 // 「The Ruby Toolbox」, CLI Option Parsers,https://www.ruby-toolbox.com/categories/CLI_Option_Parsers ,2017/1/30 アクセス.
-:1-2: 「Thorの使い方まとめ」, http://qiita.com/succi0303/items/32560103190436c9435b ,2017/1/30 アクセス.
+:1-2: 「Thorの使い方まとめ」,http://qiita.com/succi0303/items/32560103190436c9435b 2015/01/14更新,2017/1/30 アクセス.
 :1-3: 「15.5. optparse - コマンドラインオプション解析器」, http://docs.python.jp/2/library/optparse.html ,2017/1/30 アクセス.
 :1-4: 「library optparse」, https://docs.ruby-lang.org/ja/latest/library/optparse.html ,2017/1/30 アクセス.
-
-

data/hikiutils_yamane/introduction.hiki

@@ -1,5 +1,5 @@
 !序論
-hikiは，hiki記法を用いたwiki cloneである．wikiはウォード・カニンガムが作ったwikiwikiwebを源流とするhome page制作を容易にするシステムで，hikiもwikiの基本要求仕様を満足するシステムを提供する．wikiの特徴であるweb上で編集する機能を提供する．これを便宜上hiki web systemと呼ぶ．図にある通り，一般的な表示画面の他に，編集画面が提供されており，ユーザーはこの編集画面からコンテンツを編集することが可能である．リンクやヘッダー，リスト，引用，表，図の表示などの基本テキストフォーマットが用意されている．
+hikiは，hiki記法を用いたwiki cloneである．wikiはウォード・カニンガムが作ったwikiwikiwebを源流とするhome page制作を容易にするシステムで，hikiもwikiの基本要求仕様を満足するシステムを提供する．wikiの特徴であるweb上で編集する機能を提供する．これを便宜上hiki web systemと呼ぶ．図{{ref(fig:one)}}にある通り，一般的な表示画面の他に，編集画面が提供されており，ユーザーはこの編集画面からコンテンツを編集することが可能である．リンクやヘッダー，リスト，引用，表，図の表示などの基本テキストフォーマットが用意されている．
 
 hiki web systemの実際の基本動作は，hiki.cgiプログラムを介して行われている．こちらを便宜上hiki systemと呼ぶ．図{{ref(fig:one)}}に従ってhiki systemの動作概要を説明する．hiki systemは，data/textに置かれた書かれたプレーンテキストをhtmlへ変換する．この変換はhikidoc{{cite(1-1)}}というhikiフォーマットconverterを使っている．また，添付書類はcache/attachに，一度フォーマットしたhtmlはparserに置かれており，それらを参照してhtmlを表示する画面をhiki.cgiは作っている．さらにhiki systemでは検索機能，自動リンク作成などが提供されている
 

data/hikiutils_yamane/latex_dir/abstract.tex

@@ -1,9 +1,9 @@
 \section{概要}
-研究室内の内部文書，あるいは外部への宣伝資料，さらにwikipediaのように重要な研究成果の発信などに西谷研ではhiki systemを利用しています．
+研究室内の内部文書，あるいは外部への宣伝資料，さらにwikipediaのように重要な研究成果の発信などに西谷研ではhiki systemを利用する．
 これは初心者にも覚えやすい直感的な操作であるが，慣れてくるとテキスト編集や画面更新にいちいちweb画面へ移行せねばならず，編集の思考が停止する．
 そこで，編集操作がCUIで完結させるためにテキスト編集に優れたeditorとの連携や，terminal上のshell commandと連携しやすいhikiutilsが開発された．
 しかし，そのユーザーインターフェースにはコマンドが直感的でないという問題がある．
 そこで，本研究ではコマンドラインツール作成ライブラリを変更することでコマンドを実装し直し直感的なコマンドにすることを目的とした．
-optparseで作成されているhikiutilsをthorで作成し，そして２つのコマンドラインツール作成ライブラリで作成されたhikiutilsを比較する．
-研究結果は，thorのほうがコマンドを簡単に定義することができ，またコードも短くできた．
+optparseで作成されているhikiutilsをThorで作成し，そして２つのコマンドラインツール作成ライブラリで作成されたhikiutilsを比較する．
+研究結果は，Thorのほうがコマンドを簡単に定義することができ，またコードも短くできた．
 

data/hikiutils_yamane/latex_dir/{%CA%FD/313/241.aux → discussion.aux}

@@ -1,21 +1,22 @@
 \relax 
-\@setckpt{方法}{
-\setcounter{page}{6}
+\@writefile{toc}{\contentsline {section}{\numberline {5}optparseからThorへの移行}{23}}
+\@setckpt{discussion}{
+\setcounter{page}{24}
 \setcounter{equation}{0}
-\setcounter{enumi}{0}
+\setcounter{enumi}{2}
 \setcounter{enumii}{0}
 \setcounter{enumiii}{0}
 \setcounter{enumiv}{0}
 \setcounter{footnote}{0}
 \setcounter{mpfootnote}{0}
 \setcounter{part}{0}
-\setcounter{section}{2}
+\setcounter{section}{5}
 \setcounter{subsection}{0}
 \setcounter{subsubsection}{0}
 \setcounter{paragraph}{0}
 \setcounter{subparagraph}{0}
-\setcounter{figure}{1}
-\setcounter{table}{0}
-\setcounter{lstnumber}{1}
+\setcounter{figure}{7}
+\setcounter{table}{1}
+\setcounter{lstnumber}{14}
 \setcounter{lstlisting}{0}
 }

data/hikiutils_yamane/latex_dir/discussion.tex

@@ -0,0 +1,9 @@
+\section{optparseからThorへの移行}
+Thorとoptparseでのコードの違いは以上のとおりであるが,コードからもThorのほうが短くなっていることが分かる．
+しかし，Thorの問題点はメソッド名がコマンドとなるため，１つしか定義できないことである．
+これを解決するためにmapを用い,複数のコマンドを定義できるようにした．
+一方，optparseでは別のコマンドを定義するにはfizzbuzzのoptparseのコードのようにコマンドの解析を行う必要がある．
+つまり，optparseでのコマンド定義はThorより複雑で記述が長くなるということである．
+それに対してThorのほうが全体的にもコードが短くなり，コマンドの定義も簡単に行うことができる．
+また，実行手順も分かりやすくコードが読みやすいため書き換えもすぐ行うことができるので，より直感的なコマンドを実装することも可能となった．
+

data/hikiutils_yamane/latex_dir/hikiutils_yamane.aux

@@ -1,12 +1,9 @@
 \relax 
 \@input{abstract.aux}
 \@input{introduction.aux}
-\@writefile{toc}{\contentsline {section}{\numberline {3}方法}{7}}
-\@input{compare.aux}
-\@input{optparse.aux}
-\@writefile{toc}{\contentsline {section}{\numberline {4}結果}{15}}
-\@input{command.aux}
-\@input{thor.aux}
+\@input{method.aux}
+\@input{results.aux}
+\@input{discussion.aux}
 \bibcite{1-1}{1}
 \bibcite{1-2}{2}
 \bibcite{1-3}{3}