hikiutils 0.2.3.17 → 0.2.4

data/hikiutils_bob/latex_dir/sync.tex

@@ -1,262 +0,0 @@
-
-\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=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ブラウザ上に完成形を表示しつつ執筆することが求められます．このような環境を提供するのが，本システムです．
-
-\section{hikiとの同期}
-\subsection{hikiutilsのinstall}
-hikiuitlsをgemからinstallしておく必要がある．コマンドは以下の通り．
-\begin{quote}\begin{verbatim}
-gem install hikiutils
-\end{verbatim}\end{quote}
-さらに
-\begin{quote}\begin{verbatim}
-hiki -v
-\end{verbatim}\end{quote}
-で0.2.3.2以上であることを確認．
-
-\subsection{個別ディレクトリーの構成}
-図にhikiutils\_bobのディレクトリー構成を示す．
-
-\begin{figure}[htbp]\begin{center}
-\includegraphics[width=10cm,bb= 0 0 737 553]{../figs/./hikiutils_bob.003.jpeg}
-\caption{hikiutils\_bobのディレクトリー構成．}
-\label{default}\end{center}\end{figure}
-コマンド
-\begin{quote}\begin{verbatim}
-hiki -i
-\end{verbatim}\end{quote}
-によって以下のようなファイルが作成される．
-\begin{lstlisting}[style=customCsh,basicstyle={\scriptsize\ttfamily}]
-bob% ls -lat
-total 1072
--rw-r--r--   1 bob  501      99  1 20 12:44 .hikirc
-drwxr-xr-x   5 bob  501     170  1 20 12:44 figs/
-drwxr-xr-x  12 bob  501     408  1 20 12:34 ./
--rw-r--r--   1 bob  501       8  1 20 11:01 .gitignore
--rw-r--r--   1 bob  501    3507  1 20 11:01 Rakefile
-drwxr-xr-x   2 bob  501      68  1 20 11:01 data/
--rw-r--r--   1 bob  501    2595  1 20 11:01 hiki_help.yml
-drwxr-xr-x  26 bob  501     884  1 20 11:00 ../
-\end{lstlisting}
-この.hikircにデータが設定データが自動的に入る．さらにhikiutils\_bob.hikiおよびhikiutils\_bob.keyを作成する．これで執筆ファイルの基本構成が出来上がる．
-
-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=10cm,bb= 0 0 737 553]{../figs/./hikiutils_bob.004.jpeg}
-\caption{システムの概要．}
-\label{default}\end{center}\end{figure}
-\subsection{一般的な執筆手順}
-\begin{enumerate}
-\item 書類の作成
-\begin{enumerate}
-\item open -a mi hikiutils\_bob.hiki
-\end{enumerate}
-\item keynoteを開ける
-\begin{enumerate}
-\item open hikiutils\_bob.key
-\end{enumerate}
-\item keynoteのイメージをfigsに
-\begin{enumerate}
-\item keynoteでイメージへ書き出し(hikiutils\_bobを仮定)
-\item rake convert 60 hikiutils\_bob
-\end{enumerate}
-\item hikiシステムとの同期
-\begin{enumerate}
-\item rake sync
-\end{enumerate}
-\item hikiシステムで表示
-\begin{enumerate}
-\item hiki -u hikiutils\_bob (個別のhiki fileを表示)
-\item rake touch (全てを表示)
-\end{enumerate}
-\end{enumerate}
-\subsection{rakeが用意しているタスク}
-rakeの用意しているコマンドは次のとおり．
-\begin{lstlisting}[style=customCsh,basicstyle={\scriptsize\ttfamily}]
-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            # FILE.hikiあるいはhikiファイルすべてを最新状態に更新(new)
-rake open             # FILE.hikiあるいはhikiファイルをedtiorで開く(new)
-rake github           # Githubのdirをsafariでopen(new)
-rake reset_hiki       # hikiシステムにあるゴミファイルを掃除する(new)
-\end{lstlisting}
-\subsubsection{rake sync}
-hikiutils\_bobにある必要な書類をhikiシステムにコピーする．その際，名前の書き換えを行う．
-
-\begin{table}[htbp]\begin{center}
-\caption{}
-\begin{tabular}{lll}
-\hline
-hikiutils\_bobでの名前   &hikiシステムでの名前  \\ \hline
-hikiutils\_bob.hiki   &hikiutils\_bob  \\
-introduction.hiki   &hikiutils\_bob\_introduction  \\
-\hline
-\end{tabular}
-\label{default}
-\end{center}\end{table}
-%for inserting separate lines, use \hline, \cline{2-3} etc.
-
-figsディレクトリー内のファイルはhiki/cache/attache/hikiutils\_bobにcpされる．従って，hiki文書中で参照するには，
-\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}
-rake convert 80 hikiutils_bob
-\end{verbatim}\end{quote}
-によって，DIR=hikiutils\_bobにあるpngファイルをVAL=80%に縮小してfigsにためる．
-
-\subsubsection{rake increment}
-keynoteでページを追加するとhikiでの参照(attach\_view)にずれが生じる．いまのところこれを解消する方法はなく手で修正を加える必要がある．ずれが単純な場合には，
-\begin{lstlisting}[style=,basicstyle={\scriptsize\ttfamily}]
-cp hikiutils_bob.hiki tmp.hiki
-rake increment 2 tmp.hiki > tmp2.hiki
-\end{lstlisting}
-としてattach\_viewのページ番号を単純に増加させることができる．
-
-\subsubsection{rake number}
-rake incrementと同じくfigs内の通し番号が変わった時にattach\_viewの通し番号を調整するコマンド．
-\begin{lstlisting}[style=customCsh,basicstyle={\scriptsize\ttfamily}]
-rake number 3 hikiutils_bob.hiki > tmp.hiki
-cp tmp.hiki hikiutils_bob.hiki
-\end{lstlisting}
-とすると
-\begin{lstlisting}[style=customCsh,basicstyle={\scriptsize\ttfamily}]
-8c8
-{{attach_view(hikiutils_bob.002.jpeg)}}
----
-{{attach_view(hikiutils_bob.003.jpeg)}}
-21c21
-{{attach_view(hikiutils_bob.003.jpeg)}}
----
-{{attach_view(hikiutils_bob.004.jpeg)}}
-\end{lstlisting}
-などと番号を3から順に振り替えてくれる．
-
-\subsubsection{rake open [FILE] (new)}
-FILE.hikiあるいはhikiファイルをedtiorで開く.
-
-\subsubsection{rake touch [FILE](new)}
-FILE.hikiあるいはhikiファイルすべてを最新状態に更新．
-
-\subsubsection{rake github(new)}
-git remote -vにあるoriginをsafariでopenします．
-
-\subsubsection{rake reset\_hiki(new)}
-hikiシステムにあるゴミファイルを掃除します．
-\begin{lstlisting}[style=customCsh,basicstyle={\scriptsize\ttfamily}]
-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[ynqlA]?
-\end{lstlisting}
-となります．yes, no, quit, list, Allのなかから選んでください．
-
-\subsection{githubによる同期}
-これらの作業の流れを示すシーケンス図は次の通りである．
-
-\begin{figure}[htbp]\begin{center}
-\includegraphics[width=10cm,bb= 0 0 737 553]{../figs/./hikiutils_bob.005.jpeg}
-\caption{卒論編集時のgithubによる同期のシーケンス図．}
-\label{default}\end{center}\end{figure}
-git init, forkが済んでいると仮定して同期の手順を以下に示す．
-
-\begin{enumerate}
-\item git push作業
-\begin{enumerate}
-\item git add -A
-\item git commit -m 'first commit'
-\item git push origin master
-\end{enumerate}
-\item githubでbobへpull requestをかける
-\item bobの編集後，通知がくる．まつことなく作業してもok．
-\item git pull作業
-\begin{enumerate}
-\item git pull upstream master
-\end{enumerate}
-\end{enumerate}
-以下には関連するコマンドと動作を記した．
-\begin{description}
-\item[git remote -v]  githubのremoteアドレスを表示
-
-\item[git remote add upstream git@...] githubのアドレスをupstreamとして登録．
-
-\end{description}
-\subsection{hikiutil関連のヘルプ}
-\subsubsection{hikiで卒論を書くときの初期化と掟}
-\begin{itemize}
-\item 目的：西谷が後で迷わないように決まったファイル構造を堅持すべし
-\item 文書：hikiで書く.のちには，latexに変換するプログラムを提供します
-\item 図表：すべての図表をkeynoteにまとめる，タイトルを分かりやすく書く
-\item データ：dataディレクトリにまとめる．ファイル名をkeynoteの対応する図表中に記す
-\item hiki --initializeで初期ファイル(Rakefile, ./.hikirc, hiki\_help.yml)がcopyされる
-\item hiki\_help.ymlを適宜~/.my\_helpにcopyしてhiki\_helpとして利用，(my\_help参照)
-\item Errno::EACCESやpermission errorがでたときはrake chenvを試してみる（報告して）
-\item rake syncによってhikiディレクトリーと同期が取られる
-\item hiki -u TARGETによってブラウザー表示される
-\item テキストの拡張子は'.hiki'
-\item hikiでのurlはテキスト前とディレクトリーから自動生成される
-\item 例えば，hiki2latex\_saki/introduciton.hikiとするとhiki2latex\_saki\_introducitonと変換される
-\end{itemize}
-\subsubsection{図表に関する制約}
-\begin{itemize}
-\item すべての図表をkeynoteにまとめる
-\item keynoteに書いたスライドはイメージに書き出して，rake convert 80 TARGET\_DIRでfigsに変換
-\item rake syncでfigsにあるfilesはhiki/target\_dirにcpされる
-\item \verb|convert #{source} -resize 20% #{target}によって，target=figs/TAERGET.pngに20%に縮小して保存される|
-\item convert -density 300 view.svg view.pngで300dpiで変換
-\item attach\_anchorでは'\verb|{{attach_anchor(test.png, hiki2latex_saki)}}|'と，directory指定しなければならない.
-\item keynoteであとで図を挿入して番号が変わった時の原稿の一括変換
-\item rake increment 2 boundary\_bob.hiki boundary\_bob > tmp.hiki
-\item rake convert 60 boundary\_bob
-\item rake sync
-\item hiki -u boundary\_bob\_tmp
-\end{itemize}
-\subsubsection{同期に関する制約}
-\begin{itemize}
-\item hikiはフラットなdirectory構造を取っている
-\item hikiの文書はスネーク表記(例えば，latex2hiki\_saki)で階層構造に似せている
-\item hikiのurlの接頭語となる名前をbasenameのdirectory名とする．
-\item directory名が'hikis'である場合はその親directory名となる．
-\item ~/.hikircのtarget directoryを同期先のdirectoryとする．
-\item ~/.hikircがない場合は同期先のdirectoryを聞く．
-\item それらは./.hikircに保存される
-\end{itemize}
-\subsubsection{テキストに関する制約}
-\begin{itemize}
-\item テキストの拡張子は'.hiki'としている
-\item hikiでのurlはテキスト前とディレクトリーから自動生成される
-\item 例えば，hiki2latex\_saki/introduciton.hikiとするとhiki2latex\_saki\_introducitonと変換される
-\end{itemize}

data/hikiutils_bob/references.hiki

@@ -1,3 +0,0 @@
-!reference:
-:listings1:[[基本的な使い方|http://d.hatena.ne.jp/mallowlabs/20061226/1167137637]]
-:listings2:[[listingsの定義の仕方|http://www.ipc.akita-nct.ac.jp/~yamamoto/comp/latex/make_doc/source/source.html]]

data/hikiutils_bob/sync.hiki

@@ -1,220 +0,0 @@
-{{toc}}
-!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:卒論編集システムの基本概念．
-{{attach_view(hikiutils_bob.002.jpeg,hikiutils_bob)}}
-
-例えば，卒業生をyamaneとしましょう．yamaneの個人のMacの自分のdirectory(hikiutils_yamane)に幾つかのファイルを作成して卒論を書いているとします．これを指導教官(bob)が編集するとします．この同期には，Githubにより提供される共同作業環境を使います．これだけでは編集中の文書の体裁がわかりにくいでしょう．そこで，hikiシステムにより容易にwebブラウザ上に完成形を表示しつつ執筆することが求められます．このような環境を提供するのが，本システムです．
-
-!hikiとの同期
-!! hikiutilsのinstall
-hikiuitlsをgemからinstallしておく必要がある．コマンドは以下の通り．
-
- gem install hikiutils
-さらに
- hiki -v
-で0.2.3.2以上であることを確認．
-
-!! 個別ディレクトリーの構成
-図にhikiutils_bobのディレクトリー構成を示す．
-!!!caption:hikiutils_bobのディレクトリー構成．
-{{attach_view(hikiutils_bob.003.jpeg,hikiutils_bob)}}
-
-コマンド
- hiki -i
-によって以下のようなファイルが作成される．
-
-<<< tcsh
-bob% ls -lat
-total 1072
--rw-r--r--   1 bob  501      99  1 20 12:44 .hikirc
-drwxr-xr-x   5 bob  501     170  1 20 12:44 figs/
-drwxr-xr-x  12 bob  501     408  1 20 12:34 ./
--rw-r--r--   1 bob  501       8  1 20 11:01 .gitignore
--rw-r--r--   1 bob  501    3507  1 20 11:01 Rakefile
-drwxr-xr-x   2 bob  501      68  1 20 11:01 data/
--rw-r--r--   1 bob  501    2595  1 20 11:01 hiki_help.yml
-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)}}
-
-!!一般的な執筆手順
-#書類の作成
-##open -a mi hikiutils_bob.hiki
-#keynoteを開ける
-##open hikiutils_bob.key
-#keynoteのイメージをfigsに
-##keynoteでイメージへ書き出し(hikiutils_bobを仮定)
-##rake convert 60 hikiutils_bob
-#hikiシステムとの同期
-## rake sync
-# hikiシステムで表示
-## hiki -u hikiutils_bob (個別のhiki fileを表示)
-## rake touch (全てを表示)
-
-!!rakeが用意しているタスク
-rakeの用意しているコマンドは次のとおり．
-
-<<< tcsh
-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            # FILE.hikiあるいはhikiファイルすべてを最新状態に更新(new)
-rake open             # FILE.hikiあるいはhikiファイルをedtiorで開く(new)
-rake github           # Githubのdirをsafariでopen(new)
-rake reset_hiki       # hikiシステムにあるゴミファイルを掃除する(new)
->>>
-
-!!!rake sync
-hikiutils_bobにある必要な書類をhikiシステムにコピーする．その際，名前の書き換えを行う．
-|| hikiutils_bobでの名前 || hikiシステムでの名前
-|| hikiutils_bob.hiki || hikiutils_bob
-|| introduction.hiki || hikiutils_bob_introduction
-
-figsディレクトリー内のファイルはhiki/cache/attache/hikiutils_bobにcpされる．従って，hiki文書中で参照するには，
- {{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 increment
-keynoteでページを追加するとhikiでの参照(attach_view)にずれが生じる．いまのところこれを解消する方法はなく手で修正を加える必要がある．ずれが単純な場合には，
-<<< bash
-cp hikiutils_bob.hiki tmp.hiki
-rake increment 2 tmp.hiki > tmp2.hiki
->>>
-としてattach_viewのページ番号を単純に増加させることができる．
-
-!!!rake number
-rake incrementと同じくfigs内の通し番号が変わった時にattach_viewの通し番号を調整するコマンド．
-<<< tcsh
-rake number 3 hikiutils_bob.hiki > tmp.hiki
-cp tmp.hiki hikiutils_bob.hiki
->>>
-とすると
-<<< tcsh
-8c8
-< {{attach_view(hikiutils_bob.002.jpeg,hikiutils_bob)}}
----
-> {{attach_view(hikiutils_bob.003.jpeg,hikiutils_bob)}}
-21c21
-< {{attach_view(hikiutils_bob.003.jpeg,hikiutils_bob)}}
----
-> {{attach_view(hikiutils_bob.004.jpeg,hikiutils_bob)}}
->>>
-などと番号を3から順に振り替えてくれる．
-
-!!!rake open [FILE] (new)
-FILE.hikiあるいはhikiファイルをedtiorで開く.
-
-!!!rake touch [FILE](new)
-FILE.hikiあるいはhikiファイルすべてを最新状態に更新．
-
-!!!rake github(new)
-git remote -vにあるoriginをsafariでopenします．
-
-!!!rake reset_hiki(new)
-hikiシステムにあるゴミファイルを掃除します．
-
-<<< tcsh
-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[ynqlA]?
->>>
-となります．yes, no, quit, list, Allのなかから選んでください．
-
-!!githubによる同期
-
-これらの作業の流れを示すシーケンス図は次の通りである．
-!!!caption:卒論編集時のgithubによる同期のシーケンス図．
-{{attach_view(hikiutils_bob.005.jpeg,hikiutils_bob)}}
-
-git init, forkが済んでいると仮定して同期の手順を以下に示す．
-# git push作業
-## git add -A
-## git commit -m 'first commit'
-## git push origin master
-# githubでbobへpull requestをかける
-# bobの編集後，通知がくる．まつことなく作業してもok．
-# git pull作業
-## git pull upstream master
-
-以下には関連するコマンドと動作を記した．
-:git remote -v: githubのremoteアドレスを表示
-:git remote add upstream git@...:githubのアドレスをupstreamとして登録．
-
-!!hikiutil関連のヘルプ
-!!!hikiで卒論を書くときの初期化と掟
-*目的：西谷が後で迷わないように決まったファイル構造を堅持すべし
-*文書：hikiで書く.のちには，latexに変換するプログラムを提供します
-*図表：すべての図表をkeynoteにまとめる，タイトルを分かりやすく書く
-*データ：dataディレクトリにまとめる．ファイル名をkeynoteの対応する図表中に記す
-*hiki --initializeで初期ファイル(Rakefile, ./.hikirc, hiki_help.yml)がcopyされる
-*hiki_help.ymlを適宜~/.my_helpにcopyしてhiki_helpとして利用，(my_help参照)
-*Errno::EACCESやpermission errorがでたときはrake chenvを試してみる（報告して）
-*rake syncによってhikiディレクトリーと同期が取られる
-*hiki -u TARGETによってブラウザー表示される
-*テキストの拡張子は'.hiki'
-*hikiでのurlはテキスト前とディレクトリーから自動生成される
-*例えば，hiki2latex_saki/introduciton.hikiとするとhiki2latex_saki_introducitonと変換される
-
-!!!図表に関する制約
-*すべての図表をkeynoteにまとめる
-*keynoteに書いたスライドはイメージに書き出して，rake convert 80 TARGET_DIRでfigsに変換
-*rake syncでfigsにあるfilesはhiki/target_dirにcpされる
-*\verb|convert #{source} -resize 20% #{target}によって，target=figs/TAERGET.pngに20%に縮小して保存される|
-*convert -density 300 view.svg view.pngで300dpiで変換
-*attach_anchorでは'{{attach_anchor(test.png, hiki2latex_saki)}}'と，directory指定しなければならない.
-*keynoteであとで図を挿入して番号が変わった時の原稿の一括変換
-*rake increment 2 boundary_bob.hiki boundary_bob > tmp.hiki
-*rake convert 60 boundary_bob
-*rake sync
-*hiki -u boundary_bob_tmp
-
-!!!同期に関する制約
-*hikiはフラットなdirectory構造を取っている
-*hikiの文書はスネーク表記(例えば，latex2hiki_saki)で階層構造に似せている
-*hikiのurlの接頭語となる名前をbasenameのdirectory名とする．
-*directory名が'hikis'である場合はその親directory名となる．
-* ~/.hikircのtarget directoryを同期先のdirectoryとする．
-* ~/.hikircがない場合は同期先のdirectoryを聞く．
-* それらは./.hikircに保存される
-
-!!!テキストに関する制約
-* テキストの拡張子は'.hiki'としている
-* hikiでのurlはテキスト前とディレクトリーから自動生成される
-* 例えば，hiki2latex_saki/introduciton.hikiとするとhiki2latex_saki_introducitonと変換される