hikiutils 0.2.3.15 → 0.2.3.16

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 194f3cdc8e097266bfb45ce254caa7c80122f81b
-  data.tar.gz: a84cd96a79493510e8008d37294cb48039310a57
+  metadata.gz: d1a5c575e0620e966b2df629ea55328d3e96c712
+  data.tar.gz: 35159b030aa4d490796706c24043f8388d266587
 SHA512:
-  metadata.gz: c28d5d95b1da7561729cb0c3220ce94c8cfb5891ed70cb1d912f8f89ed45f7edb7d5459922ed129c712350dfd1b578ae0f56e389ccd71291ca92938ccc79d984
-  data.tar.gz: 8c65f56c7749c5900497edf09132222a521bcf1fa291783599e073ad3c3913fba77a4ee5df95480baf01031eb1d580650920cca53543cef64406d635dcbaed59
+  metadata.gz: ba083977c2fec6016885cfa5e06c4d28104cfddfeb065614fca4b3f744ab5f76d6670b3843fda0195847ada542203c5c9e8aeba5e534a655dd160f1f917b13e8
+  data.tar.gz: c40c231fc2715f409c2a7ca781093940e0a1151f0885fd7f80b9532ed8b292bbb0f414e0c2d46d74ff5344f2e128aa6a7900e752103082bd686ef74d8bf66523

data/hikiutils_yamane/Rakefile

@@ -1,3 +1,5 @@
+# -*- coding: utf-8 -*-
+
 # -*- coding: utf-8 -*-
 require 'systemu'
 require 'tempfile'
@@ -186,7 +188,10 @@ end
 
 def check_bounding_box
 #  $bounding_box="0 0 442 432"
-  $bounding_box=" 0 0 737 553"
+#  $bounding_box=" 0 0 737 553"
+#  $fig_width="10"
+  $bounding_box=" 0 0 937 753"
+  $fig_width="12"
 end
 
 desc "すべてのhikiファイルをlatex変換"
@@ -206,7 +211,7 @@ task :latex_all do
         line = ''
       end
     end
-    line ="\\usepackage{listings,jlisting}" if line.match(/\\usepackage{listings}/)
+    line ="\\usepackage{url}\n\\usepackage{listings,jlisting}\n" if line.match(/\\usepackage{listings}/)
     if line.match(/section{(.+)}/)
       if m=line.match(/\\verb\|(.+)\((.+)\)\|/)
         p m
@@ -273,10 +278,12 @@ def convert_to_latex(file_name, options={})
       line = "\\end{thebibliography}\n"
     end
     if m=line.match(/\\item\[(.+)\](.+)/) and in_bib==true
-      line ="\\bibitem{#{m[1]}} #{m[2]}"
+      tmp=m[2].gsub!(/\\verb\|(.*?)\|/){ "\\url{#{$1}}" }
+      line ="\\bibitem{#{m[1]}} #{tmp}"
+      puts line.blue
     end
     if m=line.match(/\\includegraphics\[width=6cm\]\{(.+)\}/)
-      p line="\\includegraphics\[width=10cm,bb=#{$bounding_box}\]\{../figs/#{m[1]}\}\n"
+      p line="\\includegraphics\[width=#{$fig_width}cm,bb=#{$bounding_box}\]\{../figs/#{m[1]}\}\n"
       cont << line
     else
       cont << line

data/hikiutils_yamane/hikiutils_yamane.hiki

@@ -14,10 +14,10 @@
 //!![[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 アクセス.
+: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 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 アクセス.
+: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/latex_dir/discussion.aux

@@ -1,7 +1,7 @@
 \relax 
-\@writefile{toc}{\contentsline {section}{\numberline {5}optparseからThorへの移行}{23}}
+\@writefile{toc}{\contentsline {section}{\numberline {5}optparseからThorへの移行}{24}}
 \@setckpt{discussion}{
-\setcounter{page}{24}
+\setcounter{page}{25}
 \setcounter{equation}{0}
 \setcounter{enumi}{2}
 \setcounter{enumii}{0}

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)  12 FEB 2017 12:03
+This is e-pTeX, Version 3.14159265-p3.7-160201-2.6 (utf8.euc) (TeX Live 2016) (preloaded format=platex 2017.1.26)  14 FEB 2017 14:31
 entering extended mode
  restricted \write18 enabled.
  file:line:error style messages enabled.
@@ -87,6 +87,10 @@ Package color Info: Driver file: dvipdfmx.def on input line 147.
 (/usr/local/texlive/2016/texmf-dist/tex/latex/graphics/dvipsnam.def
 File: dvipsnam.def 2016/06/17 v3.0m Driver-dependent file (DPC,SPQR)
 ))
+(/usr/local/texlive/2016/texmf-dist/tex/latex/url/url.sty
+\Urlmuskip=\muskip10
+Package: url 2013/09/16  ver 3.4  Verb mode for urls, etc.
+)
 (/usr/local/texlive/2016/texmf-dist/tex/latex/listings/listings.sty
 \lst@mode=\count91
 \lst@gtempboxa=\box42
@@ -143,51 +147,51 @@ LaTeX Warning: Label `default' multiply defined.
 ) (./discussion.aux))
 \openout1 = `hikiutils_yamane.aux'.
 
-LaTeX Font Info:    Checking defaults for OML/cmm/m/it on input line 38.
-LaTeX Font Info:    ... okay on input line 38.
-LaTeX Font Info:    Checking defaults for T1/cmr/m/n on input line 38.
-LaTeX Font Info:    ... okay on input line 38.
-LaTeX Font Info:    Checking defaults for OT1/cmr/m/n on input line 38.
-LaTeX Font Info:    ... okay on input line 38.
-LaTeX Font Info:    Checking defaults for OMS/cmsy/m/n on input line 38.
-LaTeX Font Info:    ... okay on input line 38.
-LaTeX Font Info:    Checking defaults for OMX/cmex/m/n on input line 38.
-LaTeX Font Info:    ... okay on input line 38.
-LaTeX Font Info:    Checking defaults for U/cmr/m/n on input line 38.
-LaTeX Font Info:    ... okay on input line 38.
-LaTeX Font Info:    Checking defaults for JY1/mc/m/n on input line 38.
-LaTeX Font Info:    ... okay on input line 38.
-LaTeX Font Info:    Checking defaults for JT1/mc/m/n on input line 38.
-LaTeX Font Info:    ... okay on input line 38.
+LaTeX Font Info:    Checking defaults for OML/cmm/m/it on input line 40.
+LaTeX Font Info:    ... okay on input line 40.
+LaTeX Font Info:    Checking defaults for T1/cmr/m/n on input line 40.
+LaTeX Font Info:    ... okay on input line 40.
+LaTeX Font Info:    Checking defaults for OT1/cmr/m/n on input line 40.
+LaTeX Font Info:    ... okay on input line 40.
+LaTeX Font Info:    Checking defaults for OMS/cmsy/m/n on input line 40.
+LaTeX Font Info:    ... okay on input line 40.
+LaTeX Font Info:    Checking defaults for OMX/cmex/m/n on input line 40.
+LaTeX Font Info:    ... okay on input line 40.
+LaTeX Font Info:    Checking defaults for U/cmr/m/n on input line 40.
+LaTeX Font Info:    ... okay on input line 40.
+LaTeX Font Info:    Checking defaults for JY1/mc/m/n on input line 40.
+LaTeX Font Info:    ... okay on input line 40.
+LaTeX Font Info:    Checking defaults for JT1/mc/m/n on input line 40.
+LaTeX Font Info:    ... okay on input line 40.
 \c@lstlisting=\count100
 LaTeX Font Info:    Font shape `JT1/mc/m/n' will be
-(Font)              scaled to size 16.60605pt on input line 44.
+(Font)              scaled to size 16.60605pt on input line 46.
 LaTeX Font Info:    Font shape `JY1/mc/m/n' will be
-(Font)              scaled to size 16.60605pt on input line 44.
+(Font)              scaled to size 16.60605pt on input line 46.
 LaTeX Font Info:    Font shape `JT1/mc/m/n' will be
-(Font)              scaled to size 11.53198pt on input line 44.
+(Font)              scaled to size 11.53198pt on input line 46.
 LaTeX Font Info:    Font shape `JY1/mc/m/n' will be
-(Font)              scaled to size 11.53198pt on input line 44.
+(Font)              scaled to size 11.53198pt on input line 46.
 LaTeX Font Info:    External font `cmex10' loaded for size
-(Font)              <12> on input line 44.
+(Font)              <12> on input line 46.
 LaTeX Font Info:    External font `cmex10' loaded for size
-(Font)              <8> on input line 44.
+(Font)              <8> on input line 46.
 LaTeX Font Info:    External font `cmex10' loaded for size
-(Font)              <6> on input line 44.
+(Font)              <6> on input line 46.
 LaTeX Font Info:    Font shape `JY1/mc/m/n' will be
-(Font)              scaled to size 5.76599pt on input line 44.
+(Font)              scaled to size 5.76599pt on input line 46.
 LaTeX Font Info:    Font shape `JT1/gt/m/n' will be
-(Font)              scaled to size 9.60999pt on input line 47.
+(Font)              scaled to size 9.60999pt on input line 49.
 LaTeX Font Info:    Font shape `JY1/gt/m/n' will be
-(Font)              scaled to size 9.60999pt on input line 47.
+(Font)              scaled to size 9.60999pt on input line 49.
 LaTeX Font Info:    Font shape `JT1/mc/m/n' will be
-(Font)              scaled to size 13.83836pt on input line 47.
+(Font)              scaled to size 13.83836pt on input line 49.
 LaTeX Font Info:    Font shape `JY1/mc/m/n' will be
-(Font)              scaled to size 13.83836pt on input line 47.
+(Font)              scaled to size 13.83836pt on input line 49.
 LaTeX Font Info:    Font shape `JT1/gt/m/n' will be
-(Font)              scaled to size 13.83836pt on input line 47.
+(Font)              scaled to size 13.83836pt on input line 49.
 LaTeX Font Info:    Font shape `JY1/gt/m/n' will be
-(Font)              scaled to size 13.83836pt on input line 47.
+(Font)              scaled to size 13.83836pt on input line 49.
  (./hikiutils_yamane.toc [1
 
 ]
@@ -260,75 +264,67 @@ LaTeX Font Info:    Font shape `OT1/cmtt/bx/n' in size <7> not available
 ]
 [8] [9]
 File: ../figs/./hikiutils_yamane.005.jpg Graphic file (type eps)
- <../figs/./hikiutils_yamane.005.jpg> [10]
+ <../figs/./hikiutils_yamane.005.jpg> [10] [11]
 File: ../figs/./hikiutils_yamane.007.jpg Graphic file (type eps)
 
-<../figs/./hikiutils_yamane.007.jpg> [11] [12] [13]) [14]
+<../figs/./hikiutils_yamane.007.jpg> [12] [13]) [14]
 \openout2 = `results.aux'.
 
  (./results.tex
 File: ../figs/./hikiutils_yamane.002.jpg Graphic file (type eps)
 
 <../figs/./hikiutils_yamane.002.jpg>
-LaTeX Font Info:    Try loading font information for OMS+cmr on input line 24.
+LaTeX Font Info:    Try loading font information for OMS+cmr on input line 23.
 
 (/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 24.
+(Font)              Font shape `OMS/cmsy/m/n' tried instead on input line 23.
  [15
 
 
 ] [16]
 [17]
 File: ../figs/./hikiutils_yamane.003.jpg Graphic file (type eps)
- <../figs/./hikiutils_yamane.003.jpg> [18]
+ <../figs/./hikiutils_yamane.003.jpg> [18] [19]
 File: ../figs/./hikiutils_yamane.004.jpg Graphic file (type eps)
 
-<../figs/./hikiutils_yamane.004.jpg> [19] [20]
+<../figs/./hikiutils_yamane.004.jpg> [20]
 File: ../figs/./hikiutils_yamane.006.jpg Graphic file (type eps)
-
-<../figs/./hikiutils_yamane.006.jpg>
-Overfull \hbox (3.95764pt too wide) in paragraph at lines 215--216
+ <../figs/./hikiutils_yamane.006.jpg>
+Overfull \hbox (3.95764pt too wide) in paragraph at lines 223--224
 \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)
  []
 
-[21]) [22]
+[21] [22]) [23]
 \openout2 = `discussion.aux'.
 
- (./discussion.tex) [23
+ (./discussion.tex) [24
 
 
 ]
-Underfull \hbox (badness 10000) in paragraph at lines 55--56
-[]\OT1/cmr/m/n/10 hikidoc, \OT1/cmtt/m/n/10 https://rubygems.org/gems/hikidoc/v
-ersions/0.1.0,
+Underfull \hbox (badness 1303) in paragraph at lines 57--58
+[]\OT1/cmr/m/n/10 hikidoc, $\OT1/cmtt/m/n/10 https : / / rubygems . org / gems 
+/ hikidoc / versions / 0 . 1 . 0,[]$ $https : / /
  []
 
 
-Overfull \hbox (28.25214pt too wide) in paragraph at lines 56--57
+Underfull \hbox (badness 10000) in paragraph at lines 58--59
 []\JY1/mc/m/n/10 「\OT1/cmr/m/n/10 Thor \JY1/mc/m/n/10 の使い方まとめ 」 \OT1/c
-mr/m/n/10 ,\OT1/cmtt/m/n/10 http://qiita.com/succi0303/items/32560103190436c943
-5b
- []
-
-
-Underfull \hbox (badness 10000) in paragraph at lines 57--58
-[]\JY1/mc/m/n/10 「\OT1/cmr/m/n/10 15.5. opt-parse - \JY1/mc/m/n/10 コマンドラ
-インオプシ ョン解析器 」 \OT1/cmr/m/n/10 ,
+mr/m/n/10 , $\OT1/cmtt/m/n/10 http : / / qiita . com / succi0303 / items /
  []
 
 
-Overfull \hbox (38.02074pt too wide) in paragraph at lines 58--59
+Underfull \hbox (badness 10000) in paragraph at lines 60--61
 []\JY1/mc/m/n/10 「\OT1/cmr/m/n/10 library opt-parse\JY1/mc/m/n/10 」 \OT1/cmr/
-m/n/10 , \OT1/cmtt/m/n/10 https://docs.ruby-lang.org/ja/latest/library/optparse
-.html
+m/n/10 , $\OT1/cmtt/m/n/10 https : / / docs . ruby-[]lang . org / ja / latest /
+ library /
  []
 
-[24
+[25
 
 ] (./hikiutils_yamane.aux (./abstract.aux) (./introduction.aux)
 (./method.aux) (./results.aux) (./discussion.aux))
@@ -337,12 +333,12 @@ LaTeX Warning: There were multiply-defined labels.
 
  ) 
 Here is how much of TeX's memory you used:
- 2619 strings out of 493683
- 36077 string characters out of 6149653
- 259998 words of memory out of 5000000
- 6153 multiletter control sequences out of 15000+600000
+ 2693 strings out of 493683
+ 36983 string characters out of 6149653
+ 262086 words of memory out of 5000000
+ 6223 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
- 35i,9n,51p,777b,1684s stack positions out of 5000i,500n,10000p,200000b,80000s
+ 35i,9n,51p,777b,1682s stack positions out of 5000i,500n,10000p,200000b,80000s
 
-Output written on hikiutils_yamane.dvi (24 pages, 95744 bytes).
+Output written on hikiutils_yamane.dvi (25 pages, 96256 bytes).

data/hikiutils_yamane/latex_dir/hikiutils_yamane.tex

@@ -1,7 +1,9 @@
 \documentclass[12pt,a4paper]{jsarticle}
 \usepackage[dvipdfmx]{graphicx}
 \usepackage[dvipdfmx]{color}
-\usepackage{listings,jlisting}% to use japanese correctly, install jlistings.
+\usepackage{url}
+\usepackage{listings,jlisting}
+% to use japanese correctly, install jlistings.
 \lstset{
   basicstyle={\ttfamily},
   identifierstyle={},
@@ -52,9 +54,9 @@
 \include{results}
 \include{discussion}
 \begin{thebibliography}{99}
-\bibitem{1-1}   hikidoc, \verb|https://rubygems.org/gems/hikidoc/versions/0.1.0,| \verb|https://github.com/hiki/hikidoc,2017/1/30| アクセス.
-\bibitem{1-2}   「Thorの使い方まとめ」,\verb|http://qiita.com/succi0303/items/32560103190436c9435b| 2015/01/14更新,2017/1/30 アクセス.
-\bibitem{1-3}   「15.5. optparse - コマンドラインオプション解析器」, \verb|http://docs.python.jp/2/library/optparse.html| ,2017/1/30 アクセス.
-\bibitem{1-4}   「library optparse」, \verb|https://docs.ruby-lang.org/ja/latest/library/optparse.html| ,2017/1/30 アクセス.
+\bibitem{1-1}   hikidoc, \url{https://rubygems.org/gems/hikidoc/versions/0.1.0,} \url{https://github.com/hiki/hikidoc,} 2017/1/30 アクセス.
+\bibitem{1-2}   「Thorの使い方まとめ」, \url{http://qiita.com/succi0303/items/32560103190436c9435b} 2015/01/14更新, 2017/1/30 アクセス.
+\bibitem{1-3}   「15.5. optparse - コマンドラインオプション解析器」, \url{http://docs.python.jp/2/library/optparse.html,} 2017/1/30 アクセス.
+\bibitem{1-4}   「library optparse」, \url{https://docs.ruby-lang.org/ja/latest/library/optparse.html,} 2017/1/30 アクセス.
 \end{thebibliography}
 \end{document}

data/hikiutils_yamane/latex_dir/hikiutils_yamane.toc

@@ -1,7 +1,7 @@
 \contentsline {section}{\numberline {1}概要}{4}
 \contentsline {section}{\numberline {2}序論}{5}
 \contentsline {section}{\numberline {3}方法}{7}
-\contentsline {subsection}{\numberline {3.1}optparseとthorの比較}{7}
+\contentsline {subsection}{\numberline {3.1}optparseとThorの比較}{7}
 \contentsline {subsubsection}{\numberline {3.1.1}Thor}{7}
 \contentsline {paragraph}{fizzbuzzメソッド，versionメソッド}{8}
 \contentsline {subsubsection}{\numberline {3.1.2}optparse}{8}
@@ -12,8 +12,8 @@
 \contentsline {paragraph}{versionメソッド}{10}
 \contentsline {subsection}{\numberline {3.2}既存のhikiutilsのコマンド解説}{10}
 \contentsline {subsubsection}{\numberline {3.2.1}コマンドの登録と実行メソッド}{10}
-\contentsline {subsubsection}{\numberline {3.2.2}CLIの実行プロセス}{11}
-\contentsline {subsubsection}{\numberline {3.2.3}コード}{12}
+\contentsline {subsubsection}{\numberline {3.2.2}CLIの実行プロセス}{12}
+\contentsline {subsubsection}{\numberline {3.2.3}コード}{13}
 \contentsline {section}{\numberline {4}結果}{15}
 \contentsline {subsection}{\numberline {4.1}コマンドの命名原則}{15}
 \contentsline {subsubsection}{\numberline {4.1.1}hikiutilsの想定利用形態}{15}
@@ -26,6 +26,6 @@
 \contentsline {paragraph}{cd VAL}{18}
 \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.2}コマンド定義}{20}
 \contentsline {subsubsection}{\numberline {4.2.3}CLIの実行プロセス}{21}
-\contentsline {section}{\numberline {5}optparseからThorへの移行}{23}
+\contentsline {section}{\numberline {5}optparseからThorへの移行}{24}

data/hikiutils_yamane/latex_dir/introduction.tex

@@ -4,7 +4,7 @@ hikiは，hiki記法を用いたwiki cloneである．wikiはウォード・カ
 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では検索機能，自動リンク作成などが提供されている
 
 \begin{figure}[htbp]\begin{center}
-\includegraphics[width=10cm,bb= 0 0 737 553]{../figs/./hikiutils_yamane.001.jpg}
+\includegraphics[width=12cm,bb= 0 0 937 753]{../figs/./hikiutils_yamane.001.jpg}
 \caption{hiki web systemとhiki systemの対応関係．}
 \label{fig:one}
 \label{default}\end{center}\end{figure}

data/hikiutils_yamane/latex_dir/method.aux

@@ -3,7 +3,7 @@
 \citation{1-2}
 \citation{1-2}
 \@writefile{toc}{\contentsline {section}{\numberline {3}方法}{7}}
-\@writefile{toc}{\contentsline {subsection}{\numberline {3.1}optparseとthorの比較}{7}}
+\@writefile{toc}{\contentsline {subsection}{\numberline {3.1}optparseとThorの比較}{7}}
 \@writefile{toc}{\contentsline {subsubsection}{\numberline {3.1.1}Thor}{7}}
 \citation{1-3}
 \citation{1-4}
@@ -19,11 +19,11 @@
 \@writefile{lof}{\contentsline {figure}{\numberline {2}{\ignorespaces コマンドの登録と実行メソッドの対応．}}{10}}
 \newlabel{fig:005}{{2}{10}}
 \newlabel{default}{{2}{10}}
-\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.2.2}CLIの実行プロセス}{11}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.2.2}CLIの実行プロセス}{12}}
 \@writefile{lof}{\contentsline {figure}{\numberline {3}{\ignorespaces CLIの実行プロセス．}}{12}}
 \newlabel{fig:007}{{3}{12}}
 \newlabel{default}{{3}{12}}
-\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.2.3}コード}{12}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.2.3}コード}{13}}
 \@setckpt{method}{
 \setcounter{page}{15}
 \setcounter{equation}{0}

data/hikiutils_yamane/latex_dir/method.tex

@@ -1,6 +1,6 @@
 
 \section{方法}
-\subsection{optparseとthorの比較}
+\subsection{optparseとThorの比較}
 今回の研究対象のhikiutilsは，optparseというコマンドライン解析ライブラリで実装されている．
 本研究ではこの代替ライブラリとしてThorの採用を検討した．
 本章の最初では，FizzBuzzという簡単なコードを例にoptparseとThorにより作成するコマンドライン解析コードの比較を行う．FizzBuzzはThorの使い方を解説した記事\cite{1-2}で紹介されている．比較しやすくするためoptparseでFizzBuzzを新たに実装した．
@@ -126,8 +126,10 @@ optparseの特徴は，「コマンドの登録，実行method」に分けて記
 また，CLIの起動の仕方が特徴的である．この二つを取り出して，動作とコードを説明する．
 
 \subsubsection{コマンドの登録と実行メソッド}
+optparseのコマンド登録と実行メソッドの呼び出し関係は図\ref{fig:005}の通りである．
+
 \begin{figure}[htbp]\begin{center}
-\includegraphics[width=10cm,bb= 0 0 737 553]{../figs/./hikiutils_yamane.005.jpg}
+\includegraphics[width=12cm,bb= 0 0 937 753]{../figs/./hikiutils_yamane.005.jpg}
 \caption{コマンドの登録と実行メソッドの対応．}
 \label{fig:005}
 \label{default}\end{center}\end{figure}
@@ -138,7 +140,7 @@ optparseでは以下の通り，コマンドの登録と実行が行われる．
 \item optにコマンドを登録
 \item 入力されたコマンドの処理のメソッドへ移動
 \end{enumerate}
-optparseではOptionParserオブジェクトoptの生成を行い，コマンドをoptに登録することでコマンドを作成することができる．しかし，これはコマンドを登録しているだけでコマンドの一覧ではこれを表示することができるが，コマンドの実行を行うためには実行を行うためのメソッドを作成する必要がある．optparseでのコマンドの実行はoptで登録されたコマンドが入力されることでそれぞれのコマンドの処理を行うメソッドに移動し処理を行う．しかし，このコマンド登録はハイフンを付けたコマンドしか登録ができず，ハイフンなしのコマンド登録はまた別の手段でやらなくてはいけない．
+この実装コードは次の通りである．
 \begin{lstlisting}[style=customRuby,basicstyle={\scriptsize\ttfamily}]
     def execute
       @argv << '--help' if @argv.size==0
@@ -175,13 +177,17 @@ optparseではOptionParserオブジェクトoptの生成を行い，コマンド
     以下略
 
 \end{lstlisting}
+optparseではOptionParserオブジェクトoptの生成を行い，コマンドをoptに登録することでコマンドを作成することができる．しかし，これはコマンドを登録しているだけでコマンドの一覧ではこれを表示することができるが，コマンドの実行を行うためには実行を行うためのメソッドを作成する必要がある．optparseでのコマンドの実行はoptで登録されたコマンドが入力されることでそれぞれのコマンドの処理を行うメソッドに移動し処理を行う．しかし，このコマンド登録はハイフンを付けたコマンドしか登録ができず，ハイフンなしのコマンド登録はまた別の手段でやらなくてはいけない．
+
 \subsubsection{CLIの実行プロセス}
+optparseを用いた場合のCLIの実行プロセスは図\ref{fig:007}の通りとなる．
+
 \begin{figure}[htbp]\begin{center}
-\includegraphics[width=10cm,bb= 0 0 737 553]{../figs/./hikiutils_yamane.007.jpg}
+\includegraphics[width=12cm,bb= 0 0 937 753]{../figs/./hikiutils_yamane.007.jpg}
 \caption{CLIの実行プロセス．}
 \label{fig:007}
 \label{default}\end{center}\end{figure}
-optparseを用いた場合のCLIの実行プロセスは次の通りとなる．
+CLIの実行プロセスは次の通りとなる．
 
 \begin{enumerate}
 \item HikiのHikiUtils::Command.run(ARGV)でhikiutils.rbのrunメソッドを呼ぶ
@@ -243,5 +249,5 @@ s)}
     end  
 \end{lstlisting}
 runメソッドでは「hikiutils: provide utilities for helping hiki editing.」を表示させ，executeメソッドを実行させる．
-executeメソッドでは最初に「@argv \<\< '--help' if @argv.size==0」と記述する．これはもしargv配列の中身が空であればargv配列に'--help'を代入する．「command\_parser = OptionParser.new do |opt|」ではOptionParserオブジェクトがoptを生成しコマンドを登録していき，command\_parserに代入する．そして，「command\_parser.parse!(@argv)」では@argvにある文字列をcommand\_parserでparseする．つまり，ここでは入力されたコマンドを解析し，登録されたコマンドと一致すればその処理が行われる．もし，一致しなければevalメソッドで表示する．
+executeメソッドでは最初に「@argv << '--help' if @argv.size==0」と記述する．これはもしargv配列の中身が空であればargv配列に'--help'を代入する．「command\_parser = OptionParser.new do |opt|」ではOptionParserオブジェクトがoptを生成しコマンドを登録していき，command\_parserに代入する．そして，「command\_parser.parse!(@argv)」では@argvにある文字列をcommand\_parserでparseする．つまり，ここでは入力されたコマンドを解析し，登録されたコマンドと一致すればその処理が行われる．もし，一致しなければevalメソッドで表示する．
 

data/hikiutils_yamane/latex_dir/results.aux

@@ -2,9 +2,9 @@
 \@writefile{toc}{\contentsline {section}{\numberline {4}結果}{15}}
 \@writefile{toc}{\contentsline {subsection}{\numberline {4.1}コマンドの命名原則}{15}}
 \@writefile{toc}{\contentsline {subsubsection}{\numberline {4.1.1}hikiutilsの想定利用形態}{15}}
-\@writefile{lof}{\contentsline {figure}{\numberline {4}{\ignorespaces hikiutilsがあらかじめ想定している利用形態．}}{15}}
-\newlabel{fig:002}{{4}{15}}
-\newlabel{default}{{4}{15}}
+\@writefile{lof}{\contentsline {figure}{\numberline {4}{\ignorespaces hikiutilsがあらかじめ想定している利用形態．}}{16}}
+\newlabel{fig:002}{{4}{16}}
+\newlabel{default}{{4}{16}}
 \@writefile{toc}{\contentsline {subsubsection}{\numberline {4.1.2}コメンド名と振る舞いの詳細}{16}}
 \@writefile{lot}{\contentsline {table}{\numberline {1}{\ignorespaces コマンドオプションとshellコマンドの対応．}}{17}}
 \newlabel{table:ShellOption}{{1}{17}}
@@ -17,18 +17,19 @@
 \@writefile{toc}{\contentsline {paragraph}{cd VAL}{18}}
 \@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でのコード}}{19}}
+\@writefile{lof}{\contentsline {figure}{\numberline {5}{\ignorespaces Thorのinitializeでのコード．}}{19}}
+\newlabel{fig:003}{{5}{19}}
 \newlabel{default}{{5}{19}}
-\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.2.2}コマンド定義}{19}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.2.2}コマンド定義}{20}}
 \@writefile{lof}{\contentsline {figure}{\numberline {6}{\ignorespaces Thorにおけるコマンド記述のひな形．}}{20}}
 \newlabel{fig:004}{{6}{20}}
 \newlabel{default}{{6}{20}}
 \@writefile{toc}{\contentsline {subsubsection}{\numberline {4.2.3}CLIの実行プロセス}{21}}
-\@writefile{lof}{\contentsline {figure}{\numberline {7}{\ignorespaces CLIの実行プロセス．}}{21}}
-\newlabel{fig:006}{{7}{21}}
-\newlabel{default}{{7}{21}}
+\@writefile{lof}{\contentsline {figure}{\numberline {7}{\ignorespaces CLIの実行プロセス．}}{22}}
+\newlabel{fig:006}{{7}{22}}
+\newlabel{default}{{7}{22}}
 \@setckpt{results}{
-\setcounter{page}{23}
+\setcounter{page}{24}
 \setcounter{equation}{0}
 \setcounter{enumi}{2}
 \setcounter{enumii}{0}

data/hikiutils_yamane/latex_dir/results.tex

@@ -1,20 +1,19 @@
 
 \section{結果}
 \subsection{コマンドの命名原則}
-機能ごとの動作はコマンドのオプションによって指定されます．
+機能ごとの動作はコマンドのオプションによって指定される．
 このオプションにどのような名前をつけるかは，どれだけコマンドを覚えやすいかという
-意味で重要です．コマンドの振る舞いを的確に表す名称をつける必要があります．
+意味で重要である．コマンドの振る舞いを的確に表す名称をつける必要がある．
 
-この振る舞いとしてもっとも受け入れやすいのがshellで用意されているコマンドです．
-pwd, ls, rm, touch, openなどはもっとも直感的に動作がわかるコマンドです．
-hikiutilsの振る舞いを予測できるシェルコマンドと同じ名前でオプションを提供する
-ようにします．
+この振る舞いとしてもっとも受け入れやすいのがshellで用意されているコマンドである．
+pwd, ls, rm, touch, openなどはもっとも直感的に動作がわかるコマンドである．
+hikiutilsの振る舞いを予測できるシェルコマンドと同じ名前でオプションを提供する．
 
 \subsubsection{hikiutilsの想定利用形態}
-ここでhikiutilsがあらかじめ想定している利用形態を解説しておきます．
+ここでhikiutilsがあらかじめ想定している利用形態を解説する．
 
 \begin{figure}[htbp]\begin{center}
-\includegraphics[width=10cm,bb= 0 0 737 553]{../figs/./hikiutils_yamane.002.jpg}
+\includegraphics[width=12cm,bb= 0 0 937 753]{../figs/./hikiutils_yamane.002.jpg}
 \caption{hikiutilsがあらかじめ想定している利用形態．}
 \label{fig:002}
 \label{default}\end{center}\end{figure}
@@ -24,11 +23,11 @@ hikiutilsは，
 \item local PCとglobal serverとが用意されており，
 \item それらのデータをrsyncで同期する
 \end{itemize}
-ことで動作することを想定しています．これは，ネットに繋がっていないオフラインの状況でも
-テキストなどの編集が可能で，さらに不用意な書き換えを防ぐための機構です．さらに，
-どちらもが何かあった時のバックアップともなって，ミスによる手戻りを防いでいます．
+ことで動作することを想定される．これは，ネットに繋がっていないオフラインの状況でも
+テキストなどの編集が可能で，さらに不用意な書き換えを防ぐための機構である．さらに，
+どちらもが何かあった時のバックアップともなって，ミスによる手戻りを防いでいる．
 
-これらの設定は，~/.hikircにyaml形式で記述・保存されています．
+これらの設定は，~/.hikircにyaml形式で記述・保存されている．
 \begin{lstlisting}[style=,basicstyle={\scriptsize\ttfamily}]
 bob% cat ~/.hikirc
 :srcs:
@@ -44,7 +43,7 @@ bob% cat ~/.hikirc
   :global_uri: http://nishitani0.kwansei.ac.jp/~bob/nishitani0/Internal
 \end{lstlisting}
 また，一般的に一人のユーザがいくつものまとまりとしてのlocal-globalペアを
-保持して管理することが普通です．それぞれにnicke\_nameをつけて管理しています．
+保持して管理することが普通である．それぞれにnicke\_nameをつけて管理している．
 \begin{lstlisting}[style=,basicstyle={\scriptsize\ttfamily}]
 bob% hiki -s
 hikiutils: provide utilities for helping hiki editing.
@@ -58,11 +57,11 @@ editor_command:open -a mi
   2 | ist       | /Users/bob/Sites/hiki-data/data           | http://ist.ksc.k
   3 | new_maple | /Users/bob/Sites/new_ist_data/maple_hiki_d| http://ist.ksc.k
 \end{lstlisting}
-とすると，それらの一覧と，いまtargetにしているnick\_nameディレクリが表示されます．
+とすると，それらの一覧と，いまtargetにしているnick\_nameディレクリが表示される．
 
 \subsubsection{コメンド名と振る舞いの詳細}
-検討の結果コマンドを以下の表\ref{table:ShellOption}のとおり書き換えることとします．
-上部に記した，特によく使うコマンドに関しては，shellでよく使われるコマンド名と一致するにようにしました．
+検討の結果コマンドを以下の表\ref{table:ShellOption}のとおり書き換えることとする．
+上部に記した，特によく使うコマンドに関しては，shellでよく使われるコマンド名と一致するにようにした．
 
 \begin{table}[htbp]\begin{center}
 \caption{コマンドオプションとshellコマンドの対応．}
@@ -92,7 +91,7 @@ version           &-v  &show program version  \\
 \end{center}\end{table}
 %for inserting separate lines, use \hline, \cline{2-3} etc.
 
-それぞれの意図を動作の解説として記述しています．
+それぞれの意図を動作の解説として記述する．
 
 \paragraph{open FILE}
 ファイルを編集のためにeditorでopen．Editorは~/.hikircに
@@ -134,11 +133,14 @@ targetを変える，change directoryとのメタファ．ただし，いまの
 について詳しく検討を行う．
 
 \subsubsection{クラス初期化}
+Thorのinitializeでのコードの呼び出し関係は図\ref{fig:003}の通りである．
+
 \begin{figure}[htbp]\begin{center}
-\includegraphics[width=10cm,bb= 0 0 737 553]{../figs/./hikiutils_yamane.003.jpg}
-\caption{Thorのinitializeでのコード}
+\includegraphics[width=12cm,bb= 0 0 937 753]{../figs/./hikiutils_yamane.003.jpg}
+\caption{Thorのinitializeでのコード．}
+\label{fig:003}
 \label{default}\end{center}\end{figure}
-Thorのinitializeでのコードはつぎの通りである．
+この動きを順を追って説明すると
 
 \begin{enumerate}
 \item Hikithor::CLI.start(ARGV)が呼ばれる
@@ -146,7 +148,9 @@ Thorのinitializeでのコードはつぎの通りである．
 \item これではThorのinitializeメソッドが呼ばれない
 \item superを書くことでThorのinitializeメソッドが呼ばれる
 \end{enumerate}
-optparseではrequireでoptparseを呼びoptparseのinitializeを定義する必要はないが，Thorはinitializeを定義する必要がある．Thorの定義方法はrequireでThorを呼びCLIクラスで継承し，initializeメソッドにsuperを書くことでThorのinitializeが呼ばれる．initializeメソッド内ではThorの初期設定がされていないため，スーパークラスのメソッドを読み出してくれるsuperを書き加えることで図のようにinitializeメソッド内でThorのinitilalizeメソッドが呼ばれ定義される．
+となる．
+
+この実装コードは次の通りである．
 \begin{lstlisting}[style=customRuby,basicstyle={\scriptsize\ttfamily}]
 
 module Hikithor
@@ -164,29 +168,24 @@ module Hikithor
       ...以下略...
    end
 \end{lstlisting}
+optparseではrequireでoptparseを呼びoptparseのinitializeを定義する必要はないが，Thorはinitializeを定義する必要がある．Thorの定義方法はrequireでThorを呼びCLIクラスで継承し，initializeメソッドにsuperを書くことでThorのinitializeが呼ばれる．initializeメソッド内ではThorの初期設定がされていないため，スーパークラスのメソッドを読み出してくれるsuperを書き加えることで図のようにinitializeメソッド内でThorのinitilalizeメソッドが呼ばれ定義される．
+
 \subsubsection{コマンド定義}
-Thorではoptparseのような登録処理はない．図\ref{fig:004}にある通りにコマンドが記述される．
+Thorではoptparseのような登録処理はない．コマンド記述のひな形は図\ref{fig:004}の通りである．
 
 \begin{figure}[htbp]\begin{center}
-\includegraphics[width=10cm,bb= 0 0 737 553]{../figs/./hikiutils_yamane.004.jpg}
+\includegraphics[width=12cm,bb= 0 0 937 753]{../figs/./hikiutils_yamane.004.jpg}
 \caption{Thorにおけるコマンド記述のひな形．}
 \label{fig:004}
 \label{default}\end{center}\end{figure}
-それらは以下のように構成される．
+このひな形を順を追って説明する．
 
 \begin{enumerate}
 \item desc以降にコマンド名と，その説明が記述される．これらはコマンドhelpで一覧として表示させる
 \item mapによって別のコマンド名でも実行できるように定義される．
 \item defで定義されたメソッドの実行コード
 \end{enumerate}
-Thorではdescで一覧を表示されるコマンド名，コマンドの説明を登録する．しかし，ここで記述したコマンドは単に一覧で表示させるためのものであり，実際に実行される時に呼び出すコマンド名は，defで定義された名前である．Thorでは処理実行を行うメソッド名がコマンド名となり，コマンド名１つが対応する．
-
-これに別名を与えるために利用されるキーワードがmapである．
-\begin{quote}\begin{verbatim}
-map A => B
-\end{verbatim}\end{quote}
-mapとはBと呼ばれるメソッドをAでも呼べるようにしてくれるものである．
-よって，これを使うことでコマンドの別名を指定することができる．
+この実装コードは次の通りである．
 \begin{lstlisting}[style=customRuby,basicstyle={\scriptsize\ttfamily}]
     desc 'show,--show', 'show sources'
     map "--show" => "show"
@@ -196,17 +195,26 @@ mapとはBと呼ばれるメソッドをAでも呼べるようにしてくれる
       ,,,以下略...
     end
 \end{lstlisting}
+Thorではdescで一覧を表示されるコマンド名，コマンドの説明を登録する．しかし，ここで記述したコマンドは単に一覧で表示させるためのものであり，実際に実行される時に呼び出すコマンド名は，defで定義された名前である．Thorでは処理実行を行うメソッド名がコマンド名となり，コマンド名１つが対応する．
+
+これに別名を与えるために利用されるキーワードがmapである．
+\begin{quote}\begin{verbatim}
+map A => B
+\end{verbatim}\end{quote}
+mapとはBと呼ばれるメソッドをAでも呼べるようにしてくれるものである．
+よって，これを使うことでコマンドの別名を指定することができる．
+
 以上より，Thorではコマンドの指定と処理にはdesc,map,処理メソッドだけで済む．optparseではコマンドを登録するためのメソッドと処理メソッドの両方が必要になっていた．一方Thorでは，処理メソッドが直接コマンド名となるため記述が簡潔になる．
 
 \subsubsection{CLIの実行プロセス}
 CLIの実行プロセスは図\ref{fig:006}の通りである．
 
 \begin{figure}[htbp]\begin{center}
-\includegraphics[width=10cm,bb= 0 0 737 553]{../figs/./hikiutils_yamane.006.jpg}
+\includegraphics[width=12cm,bb= 0 0 937 753]{../figs/./hikiutils_yamane.006.jpg}
 \caption{CLIの実行プロセス．}
 \label{fig:006}
 \label{default}\end{center}\end{figure}
-Thorにおけるcliの実行プロセスは次の通りである．
+ThorにおけるCLIの実行プロセスは次の通りである．
 
 \begin{enumerate}
 \item hiki\_thorのHikithor::CLI.start(ARGV)でhikiutils\_thor.rbのCLIクラスを呼ぶ

data/hikiutils_yamane/method.hiki

@@ -1,6 +1,6 @@
 {{toc}}
 !方法
-!!optparseとthorの比較
+!!optparseとThorの比較
 今回の研究対象のhikiutilsは，optparseというコマンドライン解析ライブラリで実装されている．
 本研究ではこの代替ライブラリとしてThorの採用を検討した．
 本章の最初では，FizzBuzzという簡単なコードを例にoptparseとThorにより作成するコマンドライン解析コードの比較を行う．FizzBuzzはThorの使い方を解説した記事{{cite(1-2)}}で紹介されている．比較しやすくするためoptparseでFizzBuzzを新たに実装した．
@@ -119,6 +119,7 @@ optparseの特徴は，「コマンドの登録，実行method」に分けて記
 また，CLIの起動の仕方が特徴的である．この二つを取り出して，動作とコードを説明する．
 
 !!!コマンドの登録と実行メソッド
+optparseのコマンド登録と実行メソッドの呼び出し関係は図{{ref(fig:005)}}の通りである．
 
 !!!!caption:(fig:005)コマンドの登録と実行メソッドの対応．
 {{attach_view(hikiutils_yamane.005.jpg,hikiutils_yamane)}}
@@ -127,8 +128,8 @@ optparseでは以下の通り，コマンドの登録と実行が行われる．
 #OptionParserオブジェクトoptを生成
 #optにコマンドを登録
 #入力されたコマンドの処理のメソッドへ移動
-optparseではOptionParserオブジェクトoptの生成を行い，コマンドをoptに登録することでコマンドを作成することができる．しかし，これはコマンドを登録しているだけでコマンドの一覧ではこれを表示することができるが，コマンドの実行を行うためには実行を行うためのメソッドを作成する必要がある．optparseでのコマンドの実行はoptで登録されたコマンドが入力されることでそれぞれのコマンドの処理を行うメソッドに移動し処理を行う．しかし，このコマンド登録はハイフンを付けたコマンドしか登録ができず，ハイフンなしのコマンド登録はまた別の手段でやらなくてはいけない．
 
+この実装コードは次の通りである．
 <<< ruby 
     def execute
       @argv << '--help' if @argv.size==0
@@ -165,12 +166,15 @@ optparseではOptionParserオブジェクトoptの生成を行い，コマンド
     以下略
 
 >>>
+optparseではOptionParserオブジェクトoptの生成を行い，コマンドをoptに登録することでコマンドを作成することができる．しかし，これはコマンドを登録しているだけでコマンドの一覧ではこれを表示することができるが，コマンドの実行を行うためには実行を行うためのメソッドを作成する必要がある．optparseでのコマンドの実行はoptで登録されたコマンドが入力されることでそれぞれのコマンドの処理を行うメソッドに移動し処理を行う．しかし，このコマンド登録はハイフンを付けたコマンドしか登録ができず，ハイフンなしのコマンド登録はまた別の手段でやらなくてはいけない．
 
 !!!CLIの実行プロセス
+optparseを用いた場合のCLIの実行プロセスは図{{ref(fig:007)}}の通りとなる．
+
 !!!!caption:(fig:007)CLIの実行プロセス．
 {{attach_view(hikiutils_yamane.007.jpg,hikiutils_yamane)}}
 
-optparseを用いた場合のCLIの実行プロセスは次の通りとなる．
+CLIの実行プロセスは次の通りとなる．
 #HikiのHikiUtils::Command.run(ARGV)でhikiutils.rbのrunメソッドを呼ぶ
 #new(argv).executeでexecuteメソッドが実行される
 

data/hikiutils_yamane/results.hiki

@@ -2,18 +2,17 @@
 !結果
 !!コマンドの命名原則
 
-機能ごとの動作はコマンドのオプションによって指定されます．
+機能ごとの動作はコマンドのオプションによって指定される．
 このオプションにどのような名前をつけるかは，どれだけコマンドを覚えやすいかという
-意味で重要です．コマンドの振る舞いを的確に表す名称をつける必要があります．
+意味で重要である．コマンドの振る舞いを的確に表す名称をつける必要がある．
 
-この振る舞いとしてもっとも受け入れやすいのがshellで用意されているコマンドです．
-pwd, ls, rm, touch, openなどはもっとも直感的に動作がわかるコマンドです．
-hikiutilsの振る舞いを予測できるシェルコマンドと同じ名前でオプションを提供する
-ようにします．
+この振る舞いとしてもっとも受け入れやすいのがshellで用意されているコマンドである．
+pwd, ls, rm, touch, openなどはもっとも直感的に動作がわかるコマンドである．
+hikiutilsの振る舞いを予測できるシェルコマンドと同じ名前でオプションを提供する．
 
 
 !!!hikiutilsの想定利用形態
-ここでhikiutilsがあらかじめ想定している利用形態を解説しておきます．
+ここでhikiutilsがあらかじめ想定している利用形態を解説する．
 
 !!!caption:(fig:002)hikiutilsがあらかじめ想定している利用形態．
 {{attach_view(hikiutils_yamane.002.jpg,hikiutils_yamane)}}
@@ -21,11 +20,11 @@ hikiutilsの振る舞いを予測できるシェルコマンドと同じ名前
 hikiutilsは，
 *local PCとglobal serverとが用意されており，
 *それらのデータをrsyncで同期する
-ことで動作することを想定しています．これは，ネットに繋がっていないオフラインの状況でも
-テキストなどの編集が可能で，さらに不用意な書き換えを防ぐための機構です．さらに，
-どちらもが何かあった時のバックアップともなって，ミスによる手戻りを防いでいます．
+ことで動作することを想定される．これは，ネットに繋がっていないオフラインの状況でも
+テキストなどの編集が可能で，さらに不用意な書き換えを防ぐための機構である．さらに，
+どちらもが何かあった時のバックアップともなって，ミスによる手戻りを防いでいる．
 
-これらの設定は，~/.hikircにyaml形式で記述・保存されています．
+これらの設定は，~/.hikircにyaml形式で記述・保存されている．
 <<< yaml
 bob% cat ~/.hikirc
 :srcs:
@@ -41,7 +40,7 @@ bob% cat ~/.hikirc
   :global_uri: http://nishitani0.kwansei.ac.jp/~bob/nishitani0/Internal
 >>>
 また，一般的に一人のユーザがいくつものまとまりとしてのlocal-globalペアを
-保持して管理することが普通です．それぞれにnicke_nameをつけて管理しています．
+保持して管理することが普通である．それぞれにnicke_nameをつけて管理している．
 <<< bash
 bob% hiki -s
 hikiutils: provide utilities for helping hiki editing.
@@ -55,12 +54,12 @@ editor_command:open -a mi
   2 | ist       | /Users/bob/Sites/hiki-data/data           | http://ist.ksc.k
   3 | new_maple | /Users/bob/Sites/new_ist_data/maple_hiki_d| http://ist.ksc.k
 >>>
-とすると，それらの一覧と，いまtargetにしているnick_nameディレクリが表示されます．
+とすると，それらの一覧と，いまtargetにしているnick_nameディレクリが表示される．
 
 !!!コメンド名と振る舞いの詳細
 
-検討の結果コマンドを以下の表{{ref(table:ShellOption)}}のとおり書き換えることとします．
-上部に記した，特によく使うコマンドに関しては，shellでよく使われるコマンド名と一致するにようにしました．
+検討の結果コマンドを以下の表{{ref(table:ShellOption)}}のとおり書き換えることとする．
+上部に記した，特によく使うコマンドに関しては，shellでよく使われるコマンド名と一致するにようにした．
 
 !!!caption:(table:ShellOption)コマンドオプションとshellコマンドの対応．
 ||変更前||変更後||動作の解説
@@ -81,7 +80,7 @@ editor_command:open -a mi
 ||help [COMMAND]  ||-h||  Describe available commands
 ||version         ||-v||  show program version
 
-それぞれの意図を動作の解説として記述しています．
+それぞれの意図を動作の解説として記述する．
 
 !!!! open FILE
 ファイルを編集のためにeditorでopen．Editorは~/.hikircに
@@ -117,16 +116,19 @@ targetを変える，change directoryとのメタファ．ただし，いまの
 について詳しく検討を行う．
 
 !!!クラス初期化
-!!!!caption:Thorのinitializeでのコード
+Thorのinitializeでのコードの呼び出し関係は図{{ref(fig:003)}}の通りである．
+
+!!!!caption:(fig:003)Thorのinitializeでのコード．
 {{attach_view(hikiutils_yamane.003.jpg,hikiutils_yamane)}}
 
-Thorのinitializeでのコードはつぎの通りである．
+この動きを順を追って説明すると
 #Hikithor::CLI.start(ARGV)が呼ばれる
 #initializeメソッドが呼ばれる
 #これではThorのinitializeメソッドが呼ばれない
 #superを書くことでThorのinitializeメソッドが呼ばれる
-optparseではrequireでoptparseを呼びoptparseのinitializeを定義する必要はないが，Thorはinitializeを定義する必要がある．Thorの定義方法はrequireでThorを呼びCLIクラスで継承し，initializeメソッドにsuperを書くことでThorのinitializeが呼ばれる．initializeメソッド内ではThorの初期設定がされていないため，スーパークラスのメソッドを読み出してくれるsuperを書き加えることで図のようにinitializeメソッド内でThorのinitilalizeメソッドが呼ばれ定義される．
+となる．
 
+この実装コードは次の通りである．
 <<< ruby
 
 module Hikithor
@@ -144,27 +146,20 @@ module Hikithor
       ...以下略...
    end
 >>>
+optparseではrequireでoptparseを呼びoptparseのinitializeを定義する必要はないが，Thorはinitializeを定義する必要がある．Thorの定義方法はrequireでThorを呼びCLIクラスで継承し，initializeメソッドにsuperを書くことでThorのinitializeが呼ばれる．initializeメソッド内ではThorの初期設定がされていないため，スーパークラスのメソッドを読み出してくれるsuperを書き加えることで図のようにinitializeメソッド内でThorのinitilalizeメソッドが呼ばれ定義される．
 
 !!!コマンド定義
-Thorではoptparseのような登録処理はない．図{{ref(fig:004)}}にある通りにコマンドが記述される．
+Thorではoptparseのような登録処理はない．コマンド記述のひな形は図{{ref(fig:004)}}の通りである．
 
 !!!!caption:(fig:004)Thorにおけるコマンド記述のひな形．
 {{attach_view(hikiutils_yamane.004.jpg,hikiutils_yamane)}}
 
-それらは以下のように構成される．
+このひな形を順を追って説明する．
 #desc以降にコマンド名と，その説明が記述される．これらはコマンドhelpで一覧として表示させる
 #mapによって別のコマンド名でも実行できるように定義される．
 #defで定義されたメソッドの実行コード
 
-Thorではdescで一覧を表示されるコマンド名，コマンドの説明を登録する．しかし，ここで記述したコマンドは単に一覧で表示させるためのものであり，実際に実行される時に呼び出すコマンド名は，defで定義された名前である．Thorでは処理実行を行うメソッド名がコマンド名となり，コマンド名１つが対応する．
-
-これに別名を与えるために利用されるキーワードがmapである．
-<<<
-map A => B
->>>
-mapとはBと呼ばれるメソッドをAでも呼べるようにしてくれるものである．
-よって，これを使うことでコマンドの別名を指定することができる．
-
+この実装コードは次の通りである．
 <<< ruby
     desc 'show,--show', 'show sources'
     map "--show" => "show"
@@ -174,6 +169,14 @@ mapとはBと呼ばれるメソッドをAでも呼べるようにしてくれる
       ,,,以下略...
     end
 >>>
+Thorではdescで一覧を表示されるコマンド名，コマンドの説明を登録する．しかし，ここで記述したコマンドは単に一覧で表示させるためのものであり，実際に実行される時に呼び出すコマンド名は，defで定義された名前である．Thorでは処理実行を行うメソッド名がコマンド名となり，コマンド名１つが対応する．
+
+これに別名を与えるために利用されるキーワードがmapである．
+<<<
+map A => B
+>>>
+mapとはBと呼ばれるメソッドをAでも呼べるようにしてくれるものである．
+よって，これを使うことでコマンドの別名を指定することができる．
 
 以上より，Thorではコマンドの指定と処理にはdesc,map,処理メソッドだけで済む．optparseではコマンドを登録するためのメソッドと処理メソッドの両方が必要になっていた．一方Thorでは，処理メソッドが直接コマンド名となるため記述が簡潔になる．
 
@@ -183,7 +186,7 @@ CLIの実行プロセスは図{{ref(fig:006)}}の通りである．
 !!!!caption:(fig:006)CLIの実行プロセス．
 {{attach_view(hikiutils_yamane.006.jpg,hikiutils_yamane)}}
 
-Thorにおけるcliの実行プロセスは次の通りである．
+ThorにおけるCLIの実行プロセスは次の通りである．
 #hiki_thorのHikithor::CLI.start(ARGV)でhikiutils_thor.rbのCLIクラスを呼ぶ
 #hikiutils_thor.rbのCLIクラスのメソッドを順に実行していく
 

data/lib/hikiutils/version.rb

@@ -1,3 +1,3 @@
 module HikiUtils
-  VERSION = "0.2.3.15"
+  VERSION = "0.2.3.16"
 end

data/lib/templates/Rakefile_hiki_sync

@@ -1,3 +1,4 @@
+# -*- coding: utf-8 -*-
 
 # -*- coding: utf-8 -*-
 require 'systemu'
@@ -210,7 +211,7 @@ task :latex_all do
         line = ''
       end
     end
-    line ="\\usepackage{listings,jlisting}" if line.match(/\\usepackage{listings}/)
+    line ="\\usepackage{url}\n\\usepackage{listings,jlisting}\n" if line.match(/\\usepackage{listings}/)
     if line.match(/section{(.+)}/)
       if m=line.match(/\\verb\|(.+)\((.+)\)\|/)
         p m
@@ -277,7 +278,9 @@ def convert_to_latex(file_name, options={})
       line = "\\end{thebibliography}\n"
     end
     if m=line.match(/\\item\[(.+)\](.+)/) and in_bib==true
-      line ="\\bibitem{#{m[1]}} #{m[2]}"
+      tmp=m[2].gsub!(/\\verb\|(.*?)\|/){ "\\url{#{$1}}" }
+      line ="\\bibitem{#{m[1]}} #{tmp}"
+      puts line.blue
     end
     if m=line.match(/\\includegraphics\[width=6cm\]\{(.+)\}/)
       p line="\\includegraphics\[width=#{$fig_width}cm,bb=#{$bounding_box}\]\{../figs/#{m[1]}\}\n"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hikiutils
 version: !ruby/object:Gem::Version
-  version: 0.2.3.15
+  version: 0.2.3.16
 platform: ruby
 authors:
 - Shigeto R. Nishitani