hikiutils 0.2.3.7 → 0.2.3.8

data/hikiutils_bob/latex_dir/sync.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)  31 JAN 2017 12:47
+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 09:51
 entering extended mode
  restricted \write18 enabled.
  file:line:error style messages enabled.
@@ -7,192 +7,22 @@ entering extended mode
 (./sync.tex
 pLaTeX2e <2016/11/29> (based on LaTeX2e <2017/01/01>)
 Babel <3.9r> and hyphenation patterns for 83 language(s) loaded.
-(/usr/local/texlive/2016/texmf-dist/tex/latex/base/article.cls
-Document Class: article 2014/09/29 v1.4h Standard LaTeX document class
-(/usr/local/texlive/2016/texmf-dist/tex/latex/base/size10.clo
-File: size10.clo 2014/09/29 v1.4h Standard LaTeX file (size option)
-)
-\c@part=\count82
-\c@section=\count83
-\c@subsection=\count84
-\c@subsubsection=\count85
-\c@paragraph=\count86
-\c@subparagraph=\count87
-\c@figure=\count88
-\c@table=\count89
-\abovecaptionskip=\skip41
-\belowcaptionskip=\skip42
-\bibindent=\dimen118
-)
-(/usr/local/texlive/2016/texmf-dist/tex/latex/graphics/graphicx.sty
-Package: graphicx 2014/10/28 v1.0g Enhanced LaTeX Graphics (DPC,SPQR)
-
-(/usr/local/texlive/2016/texmf-dist/tex/latex/graphics/keyval.sty
-Package: keyval 2014/10/28 v1.15 key=value parser (DPC)
-\KV@toks@=\toks15
-)
-(/usr/local/texlive/2016/texmf-dist/tex/latex/graphics/graphics.sty
-Package: graphics 2016/10/09 v1.0u Standard LaTeX Graphics (DPC,SPQR)
-
-(/usr/local/texlive/2016/texmf-dist/tex/latex/graphics/trig.sty
-Package: trig 2016/01/03 v1.10 sin cos tan (DPC)
-)
-(/usr/local/texlive/2016/texmf-dist/tex/latex/graphics-cfg/graphics.cfg
-File: graphics.cfg 2016/06/04 v1.11 sample graphics configuration
-)
-Package graphics Info: Driver file: dvipdfmx.def on input line 99.
-
-(/usr/local/texlive/2016/texmf-dist/tex/latex/graphics-def/dvipdfmx.def
-File: dvipdfmx.def 2016/07/11 v4.12 LaTeX color/graphics driver for dvipdfmx (L
-3/ChoF)
-))
-\Gin@req@height=\dimen119
-\Gin@req@width=\dimen120
-)
-(/usr/local/texlive/2016/texmf-dist/tex/latex/amsfonts/amssymb.sty
-Package: amssymb 2013/01/14 v3.01 AMS font symbols
-
-(/usr/local/texlive/2016/texmf-dist/tex/latex/amsfonts/amsfonts.sty
-Package: amsfonts 2013/01/14 v3.01 Basic AMSFonts support
-\@emptytoks=\toks16
-\symAMSa=\mathgroup4
-\symAMSb=\mathgroup5
-LaTeX Font Info:    Overwriting math alphabet `\mathfrak' in version `bold'
-(Font)                  U/euf/m/n --> U/euf/b/n on input line 106.
-))
-(/usr/local/texlive/2016/texmf-dist/tex/latex/wrapfig/wrapfig.sty
-\wrapoverhang=\dimen121
-\WF@size=\dimen122
-\c@WF@wrappedlines=\count90
-\WF@box=\box41
-\WF@everypar=\toks17
-Package: wrapfig 2003/01/31  v 3.6
-)
-(/usr/local/texlive/2016/texmf-dist/tex/latex/subfigure/subfigure.sty
-Package: subfigure 2002/03/15 v2.1.5 subfigure package
-\subfigtopskip=\skip43
-\subfigcapskip=\skip44
-\subfigcaptopadj=\dimen123
-\subfigbottomskip=\skip45
-\subfigcapmargin=\dimen124
-\subfiglabelskip=\skip46
-\c@subfigure=\count91
-\c@lofdepth=\count92
-\c@subtable=\count93
-\c@lotdepth=\count94
-
-****************************************
-* Local config file subfigure.cfg used *
-****************************************
-(/usr/local/texlive/2016/texmf-dist/tex/latex/subfigure/subfigure.cfg)
-\subfig@top=\skip47
-\subfig@bottom=\skip48
-)
-(/usr/local/texlive/2016/texmf-dist/tex/latex/here/here.sty)
-(/usr/local/texlive/2016/texmf-dist/tex/latex/float/float.sty
-Package: float 2001/11/08 v1.3d Float enhancements (AL)
-\c@float@type=\count95
-\float@exts=\toks18
-\float@box=\box42
-\@float@everytoks=\toks19
-\@floatcapt=\box43
-)
-
-LaTeX Warning: Unused global option(s):
-    [a4j].
-
-(./sync.aux
-
-LaTeX Warning: Label `default' multiply defined.
-
-
-LaTeX Warning: Label `default' multiply defined.
-
-
-LaTeX Warning: Label `default' multiply defined.
-
-)
-\openout1 = `sync.aux'.
-
-LaTeX Font Info:    Checking defaults for OML/cmm/m/it on input line 37.
-LaTeX Font Info:    ... okay on input line 37.
-LaTeX Font Info:    Checking defaults for T1/cmr/m/n on input line 37.
-LaTeX Font Info:    ... okay on input line 37.
-LaTeX Font Info:    Checking defaults for OT1/cmr/m/n on input line 37.
-LaTeX Font Info:    ... okay on input line 37.
-LaTeX Font Info:    Checking defaults for OMS/cmsy/m/n on input line 37.
-LaTeX Font Info:    ... okay on input line 37.
-LaTeX Font Info:    Checking defaults for OMX/cmex/m/n on input line 37.
-LaTeX Font Info:    ... okay on input line 37.
-LaTeX Font Info:    Checking defaults for U/cmr/m/n on input line 37.
-LaTeX Font Info:    ... okay on input line 37.
-LaTeX Font Info:    Checking defaults for JY1/mc/m/n on input line 37.
-LaTeX Font Info:    ... okay on input line 37.
-LaTeX Font Info:    Checking defaults for JT1/mc/m/n on input line 37.
-LaTeX Font Info:    ... okay on input line 37.
-LaTeX Font Info:    Font shape `JT1/mc/bx/n' in size <12> not available
-(Font)              Font shape `JT1/gt/m/n' tried instead on input line 41.
-LaTeX Font Info:    Font shape `JY1/mc/bx/n' in size <12> not available
-(Font)              Font shape `JY1/gt/m/n' tried instead on input line 41.
-LaTeX Font Info:    Font shape `JT1/mc/bx/n' in size <14.4> not available
-(Font)              Font shape `JT1/gt/m/n' tried instead on input line 42.
-LaTeX Font Info:    Font shape `JY1/mc/bx/n' in size <14.4> not available
-(Font)              Font shape `JY1/gt/m/n' tried instead on input line 42.
- (./sync.toc
-LaTeX Font Info:    Font shape `JT1/mc/bx/n' in size <10> not available
-(Font)              Font shape `JT1/gt/m/n' tried instead on input line 1.
-LaTeX Font Info:    Font shape `JY1/mc/bx/n' in size <10> not available
-(Font)              Font shape `JY1/gt/m/n' tried instead on input line 1.
-LaTeX Font Info:    Try loading font information for U+msa on input line 3.
- (/usr/local/texlive/2016/texmf-dist/tex/latex/amsfonts/umsa.fd
-File: umsa.fd 2013/01/14 v3.01 AMS symbols A
-)
-LaTeX Font Info:    Try loading font information for U+msb on input line 3.
-
-(/usr/local/texlive/2016/texmf-dist/tex/latex/amsfonts/umsb.fd
-File: umsb.fd 2013/01/14 v3.01 AMS symbols B
-))
-\tf@toc=\write3
-\openout3 = `sync.toc'.
-
-File: ../figs/./hikiutils_bob.002.jpeg Graphic file (type eps)
-
-<../figs/./hikiutils_bob.002.jpeg> [1
-
-]
-File: ../figs/./hikiutils_bob.003.jpeg Graphic file (type eps)
- <../figs/./hikiutils_bob.003.jpeg>
-[2]
-Overfull \hbox (32.44054pt too wide) in paragraph at lines 154--155
-\JY1/mc/m/n/10 る ． ない場合は ， 自分で \OT1/cmr/m/n/10 brew \JY1/mc/m/n/10 
-から \OT1/cmr/m/n/10 in-stall \JY1/mc/m/n/10 するか ， \OT1/cmtt/m/n/10 https:/
-/www.imagemagick.org/script/binary-releases.php
- []
-
-[3] [4]
-File: ../figs/./hikiutils_bob.004.jpeg Graphic file (type eps)
- <../figs/./hikiutils_bob.004.jpeg>
-LaTeX Font Info:    Try loading font information for OMS+cmr on input line 222.
-
-
-(/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 222.
- [5] [6]
-(./sync.aux)
-
-LaTeX Warning: There were multiply-defined labels.
-
- ) 
+./sync.tex:2: Undefined control sequence.
+l.2 \section
+            {イントロダクション}
+? 
+./sync.tex:2: Emergency stop.
+l.2 \section
+            {イントロダクション}
+End of file on the terminal!
+
+ 
 Here is how much of TeX's memory you used:
- 1216 strings out of 493683
- 15278 string characters out of 6149653
- 77754 words of memory out of 5000000
- 4793 multiletter control sequences out of 15000+600000
- 12584 words of font info for 52 fonts, out of 8000000 for 9000
+ 4 strings out of 493683
+ 30 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
- 25i,8n,26p,725b,352s stack positions out of 5000i,500n,10000p,200000b,80000s
-
-Output written on sync.dvi (6 pages, 22480 bytes).
+ 5i,0n,3p,39b,8s stack positions out of 5000i,500n,10000p,200000b,80000s
+No pages of output.

data/hikiutils_bob/latex_dir/sync.tex

@@ -1,16 +1,16 @@
 
 \section{イントロダクション}
-卒業論文は，大学で課される普通の授業のレポートに比べて多くの情報内容が要求されます．また，研究という側面から体裁や版権など多くの出版における掟を遵守しながら，高い品質を保つ必要です．そのため，指導教官との編集作業が重要となるます．編集作業の効率を高めるためには，共同作業を促進するプラットフォームが必要です．
+卒業論文は，大学で課される普通の授業のレポートに比べて深い内容が要求されます．また，研究という側面から体裁や版権など出版における多くの掟を遵守しながら，高い品質を保つ必要です．そのため，指導教官との編集作業が重要となります．編集作業の効率を高めるためには，共同作業を促進するプラットフォームが必要です．
 
 体裁などを考えるとLatexの使用が標準ですが，執筆段階での煩わしさを低減するため，Mark Up記法による文章作成が一般的です(「ドキュメント作成システム構築ガイド，GitHub, RedPen, Asciidoctor, CIによるモダンライティング」, 伊藤敬彦，吉村孝広，技術評論社)．西谷研ではMark Up記法の一種であるhiki記法を用いて執筆します．hiki記法からhtmlへ変換するソフトhikidocによる容易な変換が可能なため，日記web appliのhiki diaryでも利用されている有名なソフトです．hiki記法をベースにして，wiki wiki webと同等の機能を提供するhikiシステムがgithubに公開されており，個人の手持ちのパソコンにインストールしてwikiを利用することができます．西谷研ではさらにhiki記法を拡張して，コードのカラー表示，数式のlatex記述が可能となるシステムを利用しています．
 
 本資料では，卒論の編集作業を効率化する図に示すようなシステムの使い方を紹介します．
 
 \begin{figure}[htbp]\begin{center}
-\includegraphics[width=6cm,bb=0 0 442 500]{../figs/./hikiutils_bob.002.jpeg}
-\caption{卒論編集システムの概要．}
+\includegraphics[width=6cm,bb=0 0 442 432]{../figs/./hikiutils_bob.002.jpeg}
+\caption{卒論編集システムの基本概念．}
 \label{default}\end{center}\end{figure}
-例えば，卒業生をyamaneとしましょう．yamaneの個人のMacの自分のdirectory(hikiutils\_yamane)に幾つかのファイルを作成して卒論を書いているとします．これを指導教官(bob)が編集するとします．この同期には，Githubにより提供される共同作業環境を使います．これだけでは編集中の文書の体裁がわかりにくいでしょう．そこで，hikiシステムにより容易にwebブラウザ上に完成形を表示しつつ執筆することが求められます．このような操作環境を提供するのが，hikiutils -iです．
+例えば，卒業生をyamaneとしましょう．yamaneの個人のMacの自分のdirectory(hikiutils\_yamane)に幾つかのファイルを作成して卒論を書いているとします．これを指導教官(bob)が編集するとします．この同期には，Githubにより提供される共同作業環境を使います．これだけでは編集中の文書の体裁がわかりにくいでしょう．そこで，hikiシステムにより容易にwebブラウザ上に完成形を表示しつつ執筆することが求められます．このような環境を提供するのが，本システムです．
 
 \section{hikiとの同期}
 \subsection{hikiutilsのinstall}
@@ -28,7 +28,7 @@ hiki -v
 図にhikiutils\_bobのディレクトリー構成を示す．
 
 \begin{figure}[htbp]\begin{center}
-\includegraphics[width=6cm,bb=0 0 442 500]{../figs/./hikiutils_bob.003.jpeg}
+\includegraphics[width=6cm,bb=0 0 442 432]{../figs/./hikiutils_bob.003.jpeg}
 \caption{hikiutils\_bobのディレクトリー構成．}
 \label{default}\end{center}\end{figure}
 コマンド
@@ -52,6 +52,13 @@ drwxr-xr-x  26 bob  501     884  1 20 11:00 ../
 
 keynoteで図を作成して，hikiutils\_bob.hikiに文章を記述していく．
 
+\subsection{システムの概要}
+図に論文作成システムの概要を示している．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=6cm,bb=0 0 442 432]{../figs/./hikiutils_bob.004.jpeg}
+\caption{システムの概要．}
+\label{default}\end{center}\end{figure}
 \subsection{一般的な執筆手順}
 \begin{enumerate}
 \item 書類の作成
@@ -65,7 +72,7 @@ keynoteで図を作成して，hikiutils\_bob.hikiに文章を記述していく
 \item keynoteのイメージをfigsに
 \begin{enumerate}
 \item keynoteでイメージへ書き出し(hikiutils\_bobを仮定)
-\item rake convert 80 hikiutils\_bob
+\item rake convert 60 hikiutils\_bob
 \end{enumerate}
 \item hikiシステムとの同期
 \begin{enumerate}
@@ -73,21 +80,24 @@ keynoteで図を作成して，hikiutils\_bob.hikiに文章を記述していく
 \end{enumerate}
 \item hikiシステムで表示
 \begin{enumerate}
-\item hiki -u hikiutils\_bob
+\item hiki -u hikiutils\_bob (個別のhiki fileを表示)
+\item rake touch (全てを表示)
 \end{enumerate}
 \end{enumerate}
 \subsection{rakeが用意しているタスク}
 rakeの用意しているコマンドは次のとおり．
 \begin{lstlisting}[style=]
-rake check_previous  # check previou and current sync
-rake chenv           # For hiki Errno::ENOENT, Errno::EACCES
-rake convert         # convert fig size SCALE TARGET_DIR
-rake force_sync      # force_sync hikis and figs to hiki directory
-rake increment       # increment fig NUBERS in FILE
-rake number          # numbering figs from the NUBER in FILE
-rake self_copy       # self copy to hikiutils template directory
-rake sync            # normal sync hikis and figs to hiki directory
-rake sync0           # sync0 hikis and figs to hiki directory
+rake sync             # hikiの同期
+rake force_sync       # hikiの強制同期
+rake chenv            # For hiki Errno::ENOENT, Errno::EACCES
+
+rake convert          # convert fig size SCALE TARGET_DIR
+rake increment        # increment fig NUBERS in FILE
+rake number           # numbering figs from the NUBER in FILE
+
+rake touch            # hikiシステムを最新状態に更新
+rake github           # Githubのdirをsafariでopen
+rake reset_hiki       # hikiシステムにあるゴミファイルを掃除する
 \end{lstlisting}
 \subsubsection{rake sync}
 hikiutils\_bobにある必要な書類をhikiシステムにコピーする．その際，名前の書き換えを行う．
@@ -109,6 +119,12 @@ figsディレクトリー内のファイルはhiki/cache/attache/hikiutils\_bob
 \verb|{{attach_view(hogehoge.png)}}|
 という記述が必要となる．
 
+\subsubsection{rake force\_sync}
+hikiシステム側で直接変更を加えると，hikiutilsがsyncした時と差ができる．これを検知して，ユーザに注意を喚起する仕組みがある（rake check\_previous)．これはsyncした時に自動的に呼び出される．違いの出たfilesを修正した後に強制的に同期をとるためのコマンドとして，force\_syncが用意されている．
+
+\subsubsection{rake chenv}
+hikiシステム上でerrorが出た場合(Errno::ENOENT, Errno::EACCES)に試してほしい．errorの状況は個人の設定によってちがうため，対処法の実装は網羅されていない．うまくいかない場合は西谷にIssuesとして投げるように．
+
 \subsubsection{rake convert VAL DIR}
 keynoteが吐き出したイメージを変換するためのコマンド．ImageMagickがインストールされている必要がある．ない場合は，自分でbrewからinstallするか，\verb|https://www.imagemagick.org/script/binary-releases.php|からダウンロード．うまくいかない場合はdonkeyに聞いてみてください．
 \begin{quote}\begin{verbatim}
@@ -116,12 +132,6 @@ rake convert 80 hikiutils_bob
 \end{verbatim}\end{quote}
 によって，DIR=hikiutils\_bobにあるpngファイルをVAL=80%に縮小してfigsにためる．
 
-\subsubsection{rake force\_sync}
-hikiシステム側で直接変更を加えると，hikiutilsがsyncした時と差ができる．これを検知して，ユーザに注意を喚起する仕組みがある（rake check\_previous)．これはsyncした時に自動的に呼び出される．違いの出たfilesを修正した後に強制的に同期をとるためのコマンドとして，force\_syncが用意されている．
-
-\subsubsection{rake chenv}
-hikiシステム上でerrorが出た場合に試してほしい．errorの状況は個人の設定によってちがうため，対処法の実装は網羅されていない．うまくいかない場合は西谷にIssuesとして投げるように．
-
 \subsubsection{rake increment}
 keynoteでページを追加するとhikiでの参照(attach\_view)にずれが生じる．いまのところこれを解消する方法はなく手で修正を加える必要がある．ずれが単純な場合には，
 \begin{lstlisting}[style=]
@@ -149,6 +159,27 @@ cp tmp.hiki hikiutils_bob.hiki
 \end{verbatim}\end{quote}
 などと番号を3から順に振り替えてくれる．
 
+\subsubsection{rake touch}
+hiki touchをおこなって最新版に更新します．
+
+\subsubsection{rake github}
+git remoteにあるoriginのgithubをsafariでopenします．
+
+\subsubsection{rake reset\_hiki}
+hikiシステムにあるゴミファイルを掃除します．
+\begin{quote}\begin{verbatim}
+bob% rake reset_hiki
+hikiutils: provide utilities for helping hiki editing.
+"open -a mi"
+target_dir : /Users/bob/Sites/nishitani0/Internal/data/text
+-rw-rw-rw-  1 bob  staff    182  2  5 12:03 hikiutils_bob
+-rw-rw-rw-  1 bob  staff   7220  2  5 12:03 hikiutils_bob_latex_all
+-rw-rw-rw-  1 bob  staff  10104  2  5 12:03 hikiutils_bob_sync
+-rw-r--r--  1 bob  staff    944  2  5 12:03 hikiutils_bob_toc
+remove hikiutils_bob_toc[ynql]?
+\end{verbatim}\end{quote}
+となります．yes, no, quit, listのなかから選んでください．
+
 \subsection{githubによる同期}
 \begin{enumerate}
 \item git init, forkが済んでいると仮定
@@ -172,7 +203,7 @@ cp tmp.hiki hikiutils_bob.hiki
 これがうまくいかん時は聞いてください．
 
 \begin{figure}[htbp]\begin{center}
-\includegraphics[width=6cm,bb=0 0 442 500]{../figs/./hikiutils_bob.004.jpeg}
+\includegraphics[width=6cm,bb=0 0 442 432]{../figs/./hikiutils_bob.005.jpeg}
 \caption{卒論編集時のgithubによる同期のシーケンス図．}
 \label{default}\end{center}\end{figure}
 \subsection{hikiutil関連のヘルプ}

data/hikiutils_bob/sync.hiki

@@ -2,15 +2,15 @@
 !title:卒論編集システムにおけるhikiとの同期
 !author:関西学院大学理工学部情報科学科　西谷滋人
 !イントロダクション
-卒業論文は，大学で課される普通の授業のレポートに比べて多くの情報内容が要求されます．また，研究という側面から体裁や版権など多くの出版における掟を遵守しながら，高い品質を保つ必要です．そのため，指導教官との編集作業が重要となるます．編集作業の効率を高めるためには，共同作業を促進するプラットフォームが必要です．
+卒業論文は，大学で課される普通の授業のレポートに比べて深い内容が要求されます．また，研究という側面から体裁や版権など出版における多くの掟を遵守しながら，高い品質を保つ必要です．そのため，指導教官との編集作業が重要となります．編集作業の効率を高めるためには，共同作業を促進するプラットフォームが必要です．
 
 体裁などを考えるとLatexの使用が標準ですが，執筆段階での煩わしさを低減するため，Mark Up記法による文章作成が一般的です(「ドキュメント作成システム構築ガイド，GitHub, RedPen, Asciidoctor, CIによるモダンライティング」, 伊藤敬彦，吉村孝広，技術評論社)．西谷研ではMark Up記法の一種であるhiki記法を用いて執筆します．hiki記法からhtmlへ変換するソフトhikidocによる容易な変換が可能なため，日記web appliのhiki diaryでも利用されている有名なソフトです．hiki記法をベースにして，wiki wiki webと同等の機能を提供するhikiシステムがgithubに公開されており，個人の手持ちのパソコンにインストールしてwikiを利用することができます．西谷研ではさらにhiki記法を拡張して，コードのカラー表示，数式のlatex記述が可能となるシステムを利用しています．
 
 本資料では，卒論の編集作業を効率化する図に示すようなシステムの使い方を紹介します．
-!!!caption:卒論編集システムの概要．
+!!!caption:卒論編集システムの基本概念．
 {{attach_view(hikiutils_bob.002.jpeg,hikiutils_bob)}}
 
-例えば，卒業生をyamaneとしましょう．yamaneの個人のMacの自分のdirectory(hikiutils_yamane)に幾つかのファイルを作成して卒論を書いているとします．これを指導教官(bob)が編集するとします．この同期には，Githubにより提供される共同作業環境を使います．これだけでは編集中の文書の体裁がわかりにくいでしょう．そこで，hikiシステムにより容易にwebブラウザ上に完成形を表示しつつ執筆することが求められます．このような操作環境を提供するのが，hikiutils -iです．
+例えば，卒業生をyamaneとしましょう．yamaneの個人のMacの自分のdirectory(hikiutils_yamane)に幾つかのファイルを作成して卒論を書いているとします．これを指導教官(bob)が編集するとします．この同期には，Githubにより提供される共同作業環境を使います．これだけでは編集中の文書の体裁がわかりにくいでしょう．そこで，hikiシステムにより容易にwebブラウザ上に完成形を表示しつつ執筆することが求められます．このような環境を提供するのが，本システムです．
 
 !hikiとの同期
 !! hikiutilsのinstall
@@ -46,6 +46,10 @@ drwxr-xr-x  26 bob  501     884  1 20 11:00 ../
 この.hikircにデータが設定データが自動的に入る．さらにhikiutils_bob.hikiおよびhikiutils_bob.keyを作成する．これで執筆ファイルの基本構成が出来上がる．
 
 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を生成する．これは次章で解説する．
+!!!caption:システムの概要．
+{{attach_view(hikiutils_bob.004.jpeg,hikiutils_bob)}}
 
 !!一般的な執筆手順
 #書類の作成
@@ -54,25 +58,28 @@ keynoteで図を作成して，hikiutils_bob.hikiに文章を記述していく
 ##open hikiutils_bob.key
 #keynoteのイメージをfigsに
 ##keynoteでイメージへ書き出し(hikiutils_bobを仮定)
-##rake convert 80 hikiutils_bob
+##rake convert 60 hikiutils_bob
 #hikiシステムとの同期
 ## rake sync
 # hikiシステムで表示
-## hiki -u hikiutils_bob
+## hiki -u hikiutils_bob (個別のhiki fileを表示)
+## rake touch (全てを表示)
 
 !!rakeが用意しているタスク
 rakeの用意しているコマンドは次のとおり．
 
 <<< bash
-rake check_previous  # check previou and current sync
-rake chenv           # For hiki Errno::ENOENT, Errno::EACCES
-rake convert         # convert fig size SCALE TARGET_DIR
-rake force_sync      # force_sync hikis and figs to hiki directory
-rake increment       # increment fig NUBERS in FILE
-rake number          # numbering figs from the NUBER in FILE
-rake self_copy       # self copy to hikiutils template directory
-rake sync            # normal sync hikis and figs to hiki directory
-rake sync0           # sync0 hikis and figs to hiki directory
+rake sync             # hikiの同期
+rake force_sync       # hikiの強制同期
+rake chenv            # For hiki Errno::ENOENT, Errno::EACCES
+
+rake convert          # convert fig size SCALE TARGET_DIR
+rake increment        # increment fig NUBERS in FILE
+rake number           # numbering figs from the NUBER in FILE
+
+rake touch            # hikiシステムを最新状態に更新
+rake github           # Githubのdirをsafariでopen
+rake reset_hiki       # hikiシステムにあるゴミファイルを掃除する
 >>>
 
 !!!rake sync
@@ -85,18 +92,18 @@ figsディレクトリー内のファイルはhiki/cache/attache/hikiutils_bob
  {{attach_view(hogehoge.png, hikiutils_bob)}}
 という記述が必要となる．
 
+!!!rake force_sync
+hikiシステム側で直接変更を加えると，hikiutilsがsyncした時と差ができる．これを検知して，ユーザに注意を喚起する仕組みがある（rake check_previous)．これはsyncした時に自動的に呼び出される．違いの出たfilesを修正した後に強制的に同期をとるためのコマンドとして，force_syncが用意されている．
+
+!!!rake chenv
+hikiシステム上でerrorが出た場合(Errno::ENOENT, Errno::EACCES)に試してほしい．errorの状況は個人の設定によってちがうため，対処法の実装は網羅されていない．うまくいかない場合は西谷にIssuesとして投げるように．
+
 !!!rake convert VAL DIR
 keynoteが吐き出したイメージを変換するためのコマンド．ImageMagickがインストールされている必要がある．ない場合は，自分でbrewからinstallするか，[[https://www.imagemagick.org/script/binary-releases.php]]からダウンロード．うまくいかない場合はdonkeyに聞いてみてください．
 
  rake convert 80 hikiutils_bob
 によって，DIR=hikiutils_bobにあるpngファイルをVAL=80%に縮小してfigsにためる．
 
-!!!rake force_sync
-hikiシステム側で直接変更を加えると，hikiutilsがsyncした時と差ができる．これを検知して，ユーザに注意を喚起する仕組みがある（rake check_previous)．これはsyncした時に自動的に呼び出される．違いの出たfilesを修正した後に強制的に同期をとるためのコマンドとして，force_syncが用意されている．
-
-!!!rake chenv
-hikiシステム上でerrorが出た場合に試してほしい．errorの状況は個人の設定によってちがうため，対処法の実装は網羅されていない．うまくいかない場合は西谷にIssuesとして投げるように．
-
 !!!rake increment
 keynoteでページを追加するとhikiでの参照(attach_view)にずれが生じる．いまのところこれを解消する方法はなく手で修正を加える必要がある．ずれが単純な場合には，
 <<< bash
@@ -124,6 +131,27 @@ cp tmp.hiki hikiutils_bob.hiki
 >>>
 などと番号を3から順に振り替えてくれる．
 
+!!!rake touch
+hiki touchをおこなって最新版に更新します．
+
+!!!rake github
+git remoteにあるoriginのgithubをsafariでopenします．
+
+!!!rake reset_hiki
+hikiシステムにあるゴミファイルを掃除します．
+<<<
+bob% rake reset_hiki
+hikiutils: provide utilities for helping hiki editing.
+"open -a mi"
+target_dir : /Users/bob/Sites/nishitani0/Internal/data/text
+-rw-rw-rw-  1 bob  staff    182  2  5 12:03 hikiutils_bob
+-rw-rw-rw-  1 bob  staff   7220  2  5 12:03 hikiutils_bob_latex_all
+-rw-rw-rw-  1 bob  staff  10104  2  5 12:03 hikiutils_bob_sync
+-rw-r--r--  1 bob  staff    944  2  5 12:03 hikiutils_bob_toc
+remove hikiutils_bob_toc[ynql]?
+>>>
+となります．yes, no, quit, listのなかから選んでください．
+
 !!githubによる同期
 # git init, forkが済んでいると仮定
 # upstream, originの確認
@@ -139,7 +167,7 @@ cp tmp.hiki hikiutils_bob.hiki
 これがうまくいかん時は聞いてください．
 
 !!!caption:卒論編集時のgithubによる同期のシーケンス図．
-{{attach_view(hikiutils_bob.004.jpeg,hikiutils_bob)}}
+{{attach_view(hikiutils_bob.005.jpeg,hikiutils_bob)}}
 
 !!hikiutil関連のヘルプ
 !!!hikiで卒論を書くときの初期化と掟

data/hikiutils_bob/toc.hiki

@@ -0,0 +1,28 @@
+!1:イントロダクション
+!2:hikiとの同期
+!!2.1:hikiutilsのinstall
+!!2.2:個別ディレクトリーの構成
+!!2.3:一般的な執筆手順
+!!2.4:rakeが用意しているタスク
+!!!2.4.1:rake sync
+!!!2.4.2:rake force_sync
+!!!2.4.3:rake chenv
+!!!2.4.4:rake convert VAL DIR
+!!!2.4.5:rake increment
+!!!2.4.6:rake number
+!!!2.4.7:rake touch
+!!!2.4.8:rake github
+!!2.5:githubによる同期
+!!2.6:hikiutil関連のヘルプ
+!!!2.6.1:hikiで卒論を書くときの初期化と掟
+!!!2.6.2:error対応
+!!!2.6.3:図表：すべての図表をkeynoteにまとめる，タイトルを分かりやすく書く
+!3:実際の最終形態(卒論=pdf)への変換
+!!3.1:install
+!!3.2:rake latex（個別ファイルの変換）
+!!!3.2.1:注意
+!!3.3:rake latex_all手順（ディレクトリー内の一括変換）
+!!!3.3.1:下準備
+!!3.4:補助コマンドの解説
+!!!3.4.1:rake reset_latex_dir(latex_dirのゴミ掃除)
+!!!3.4.2:wrap関係