hikiutils 0.2.3.4 → 0.2.3.6

data/hikiutils_bob/latex_dir/hikiutils_bob.toc

@@ -1,6 +1,6 @@
 \contentsline {section}{\numberline {1}イントロダクション}{3}
-\contentsline {section}{\numberline {2}hikiとの同期}{4}
-\contentsline {subsection}{\numberline {2.1}hikiutilsのinstall}{4}
+\contentsline {section}{\numberline {2}hikiとの同期}{3}
+\contentsline {subsection}{\numberline {2.1}hikiutilsのinstall}{3}
 \contentsline {subsection}{\numberline {2.2}個別ディレクトリーの構成}{4}
 \contentsline {subsection}{\numberline {2.3}一般的な執筆手順}{5}
 \contentsline {subsection}{\numberline {2.4}rakeが用意しているタスク}{6}
@@ -11,11 +11,15 @@
 \contentsline {subsubsection}{\numberline {2.4.5}rake increment}{7}
 \contentsline {subsubsection}{\numberline {2.4.6}rake number}{7}
 \contentsline {subsection}{\numberline {2.5}githubによる同期}{8}
-\contentsline {section}{\numberline {3}実際の最終形態(卒論=pdf)への変換}{9}
-\contentsline {subsection}{\numberline {3.1}install}{9}
-\contentsline {subsection}{\numberline {3.2}rake latex手順（個別ファイルの変換）}{10}
-\contentsline {subsubsection}{\numberline {3.2.1}注意}{10}
-\contentsline {subsection}{\numberline {3.3}rake latex\_all手順（ディレクトリー内の一括変換）}{11}
-\contentsline {subsubsection}{\numberline {3.3.1}下準備}{11}
-\contentsline {paragraph}{head.tex}{12}
-\contentsline {paragraph}{pre.tex}{12}
+\contentsline {subsection}{\numberline {2.6}hikiutil関連のヘルプ}{9}
+\contentsline {subsubsection}{\numberline {2.6.1}hikiで卒論を書くときの初期化と掟}{9}
+\contentsline {subsubsection}{\numberline {2.6.2}error対応}{10}
+\contentsline {subsubsection}{\numberline {2.6.3}図表：すべての図表をkeynoteにまとめる，タイトルを分かりやすく書く}{10}
+\contentsline {section}{\numberline {3}実際の最終形態(卒論=pdf)への変換}{11}
+\contentsline {subsection}{\numberline {3.1}install}{11}
+\contentsline {subsection}{\numberline {3.2}rake latex手順（個別ファイルの変換）}{12}
+\contentsline {subsubsection}{\numberline {3.2.1}注意}{12}
+\contentsline {subsection}{\numberline {3.3}rake latex\_all手順（ディレクトリー内の一括変換）}{13}
+\contentsline {subsubsection}{\numberline {3.3.1}下準備}{13}
+\contentsline {paragraph}{head.tex}{14}
+\contentsline {paragraph}{pre.tex}{14}

data/hikiutils_bob/latex_dir/latex_all.aux

@@ -1,14 +1,14 @@
 \relax 
-\@writefile{toc}{\contentsline {section}{\numberline {3}実際の最終形態(卒論=pdf)への変換}{9}}
-\@writefile{toc}{\contentsline {subsection}{\numberline {3.1}install}{9}}
-\@writefile{toc}{\contentsline {subsection}{\numberline {3.2}rake latex手順（個別ファイルの変換）}{10}}
-\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.2.1}注意}{10}}
-\@writefile{toc}{\contentsline {subsection}{\numberline {3.3}rake latex\_all手順（ディレクトリー内の一括変換）}{11}}
-\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.3.1}下準備}{11}}
-\@writefile{toc}{\contentsline {paragraph}{head.tex}{12}}
-\@writefile{toc}{\contentsline {paragraph}{pre.tex}{12}}
+\@writefile{toc}{\contentsline {section}{\numberline {3}実際の最終形態(卒論=pdf)への変換}{11}}
+\@writefile{toc}{\contentsline {subsection}{\numberline {3.1}install}{11}}
+\@writefile{toc}{\contentsline {subsection}{\numberline {3.2}rake latex手順（個別ファイルの変換）}{12}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.2.1}注意}{12}}
+\@writefile{toc}{\contentsline {subsection}{\numberline {3.3}rake latex\_all手順（ディレクトリー内の一括変換）}{13}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.3.1}下準備}{13}}
+\@writefile{toc}{\contentsline {paragraph}{head.tex}{14}}
+\@writefile{toc}{\contentsline {paragraph}{pre.tex}{14}}
 \@setckpt{latex_all}{
-\setcounter{page}{14}
+\setcounter{page}{16}
 \setcounter{equation}{0}
 \setcounter{enumi}{4}
 \setcounter{enumii}{1}
@@ -22,7 +22,7 @@
 \setcounter{subsubsection}{1}
 \setcounter{paragraph}{0}
 \setcounter{subparagraph}{0}
-\setcounter{figure}{2}
+\setcounter{figure}{3}
 \setcounter{table}{1}
 \setcounter{lstnumber}{38}
 \setcounter{lstlisting}{0}

data/hikiutils_bob/latex_dir/latex_all.tex

@@ -7,6 +7,7 @@ hiki+keynoteで卒論の内容ができたら，それを卒論の最終形態
 文書として完成度を高めるには，latexで細かい設定を調整する必要がどうしても出てきます．
 
 具体的には，
+
 \begin{enumerate}
 \item 図の配置を調整するwrapの数値調整
 \item 参照文献の記述
@@ -52,6 +53,7 @@ rake latex sync.hiki
 latex_dir/sync.tex
 \end{verbatim}\end{quote}
 にlatex変換後のファイルが生成します．これを，TeXShopでcommand\_t変換します．
+
 \begin{itemize}
 \item \verb|{{attach_anchor(sync.pdf,hikiutils_bob)}}|
 \end{itemize}
@@ -79,10 +81,11 @@ hikiの初めの部分は，
 \end{lstlisting}
 と変換してくれます．
 
-必要な図は，figsから自動で取るようになっていますが，サイズは解像度が問題のときは手動で調整してください．
+必要な図は，figsから自動で取るようになっていますが，
+サイズや解像度が問題のときは手動で調整してください．
 
 \subsection{rake latex\_all手順（ディレクトリー内の一括変換）}
-pwdのdirectoryの同名のbasenameに.hikiの拡張子がついたファイルが用意されていて，
+pwdのdirectoryと同名のbasenameに.hikiの拡張子がついたファイルが用意されていて，
 \begin{quote}\begin{verbatim}
 rake latex_all
 \end{verbatim}\end{quote}
@@ -99,7 +102,8 @@ bob% cat hikiutils_bob.hiki
 とすると，sync.tex, latex\_all.texがlatex\_dir内に変換されます．
 さらに，開いているhikiutils\_bob.texをTeXShopで変換してみてください．
 
-うまくできないときは\verb|ここ(http://qiita.com/hideaki_polisci/items/3afd204449c6cdd995c9#51-texshopの設定)|を参照して自力で入れてみてください．だめならdonkey.
+うまくできないときは\verb|ここ(http://qiita.com/hideaki_polisci/items/3afd204449c6cdd995c9)|を参照して自力で入れてみてください．だめならdonkey.
+
 \begin{itemize}
 \item \verb|{{attach_anchor(hikiutils_bob.pdf,hikiutils_bob)}}|
 \end{itemize}
@@ -113,7 +117,9 @@ hiki -i
 とhikiutils環境を再度初期化すると，自動でインストールする設定です．
 なかったら手動で作ってください．
 
-\paragraph{head.tex}\begin{lstlisting}[style=]
+\paragraph{head.tex}
+題目，学生番号，氏名を変更する．年月をチェック．
+\begin{lstlisting}[style=]
 bob% cat head.tex
 \title{卒業論文\\
 \vspace{4cm} hikiutilsを用いた\\卒業論文作成}
@@ -123,7 +129,10 @@ bob% cat head.tex
 \maketitle
 
 \end{lstlisting}
-\paragraph{pre.tex}\begin{lstlisting}[style=]
+\paragraph{pre.tex}
+あまり変更しないほうがいいが，いずれいじる．例えば，フォントポイント数を10から12ptに変える，
+\pagestyle{empty}を外すなど．
+\begin{lstlisting}[style=]
 bob% cat pre.tex
 \documentclass[10pt,a4j]{article}
 

data/hikiutils_bob/latex_dir/sync.aux

@@ -1,9 +1,9 @@
 \relax 
 \@writefile{toc}{\contentsline {section}{\numberline {1}イントロダクション}{3}}
-\@writefile{lof}{\contentsline {figure}{\numberline {1}{\ignorespaces 卒論編集システムの概要．}}{3}}
-\newlabel{default}{{1}{3}}
-\@writefile{toc}{\contentsline {section}{\numberline {2}hikiとの同期}{4}}
-\@writefile{toc}{\contentsline {subsection}{\numberline {2.1}hikiutilsのinstall}{4}}
+\@writefile{toc}{\contentsline {section}{\numberline {2}hikiとの同期}{3}}
+\@writefile{toc}{\contentsline {subsection}{\numberline {2.1}hikiutilsのinstall}{3}}
+\@writefile{lof}{\contentsline {figure}{\numberline {1}{\ignorespaces 卒論編集システムの概要．}}{4}}
+\newlabel{default}{{1}{4}}
 \@writefile{toc}{\contentsline {subsection}{\numberline {2.2}個別ディレクトリーの構成}{4}}
 \@writefile{lof}{\contentsline {figure}{\numberline {2}{\ignorespaces hikiutils\_bobのディレクトリー構成．}}{5}}
 \newlabel{default}{{2}{5}}
@@ -18,8 +18,14 @@
 \@writefile{toc}{\contentsline {subsubsection}{\numberline {2.4.5}rake increment}{7}}
 \@writefile{toc}{\contentsline {subsubsection}{\numberline {2.4.6}rake number}{7}}
 \@writefile{toc}{\contentsline {subsection}{\numberline {2.5}githubによる同期}{8}}
+\@writefile{lof}{\contentsline {figure}{\numberline {3}{\ignorespaces 卒論編集時のgithubによる同期のシーケンス図．}}{9}}
+\newlabel{default}{{3}{9}}
+\@writefile{toc}{\contentsline {subsection}{\numberline {2.6}hikiutil関連のヘルプ}{9}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {2.6.1}hikiで卒論を書くときの初期化と掟}{9}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {2.6.2}error対応}{10}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {2.6.3}図表：すべての図表をkeynoteにまとめる，タイトルを分かりやすく書く}{10}}
 \@setckpt{sync}{
-\setcounter{page}{9}
+\setcounter{page}{11}
 \setcounter{equation}{0}
 \setcounter{enumi}{6}
 \setcounter{enumii}{1}
@@ -29,11 +35,11 @@
 \setcounter{mpfootnote}{0}
 \setcounter{part}{0}
 \setcounter{section}{2}
-\setcounter{subsection}{5}
-\setcounter{subsubsection}{0}
+\setcounter{subsection}{6}
+\setcounter{subsubsection}{3}
 \setcounter{paragraph}{0}
 \setcounter{subparagraph}{0}
-\setcounter{figure}{2}
+\setcounter{figure}{3}
 \setcounter{table}{1}
 \setcounter{lstnumber}{3}
 \setcounter{lstlisting}{0}

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記述が可能となるシステムを利用している．
+体裁などを考えると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{卒論編集システムの概要．}
 \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ブラウザ上に完成形を表示しつつ執筆することが求められます．このような操作環境を提供するのが，hikiutils -iです．
 
 \section{hikiとの同期}
 \subsection{hikiutilsのinstall}
@@ -52,21 +52,27 @@ drwxr-xr-x  26 bob  501     884  1 20 11:00 ../
 
 keynoteで図を作成して，hikiutils\_bob.hikiに文章を記述していく．
 
-\subsection{一般的な執筆手順}\begin{enumerate}
-\item 書類の作成\begin{enumerate}
+\subsection{一般的な執筆手順}
+\begin{enumerate}
+\item 書類の作成
+\begin{enumerate}
 \item open -a mi hikiutils\_bob.hiki
 \end{enumerate}
-\item keynoteを開ける\begin{enumerate}
+\item keynoteを開ける
+\begin{enumerate}
 \item open hikiutils\_bob.key
 \end{enumerate}
-\item keynoteのイメージをfigsに\begin{enumerate}
+\item keynoteのイメージをfigsに
+\begin{enumerate}
 \item keynoteでイメージへ書き出し(hikiutils\_bobを仮定)
 \item rake convert 80 hikiutils\_bob
 \end{enumerate}
-\item hikiシステムとの同期\begin{enumerate}
+\item hikiシステムとの同期
+\begin{enumerate}
 \item rake sync
 \end{enumerate}
-\item hikiシステムで表示\begin{enumerate}
+\item hikiシステムで表示
+\begin{enumerate}
 \item hiki -u hikiutils\_bob
 \end{enumerate}
 \end{enumerate}
@@ -143,21 +149,68 @@ cp tmp.hiki hikiutils_bob.hiki
 \end{verbatim}\end{quote}
 などと番号を3から順に振り替えてくれる．
 
-\subsection{githubによる同期}\begin{enumerate}
-\item git initが済んでいると仮定
-\item upstream, originの確認\begin{enumerate}
+\subsection{githubによる同期}
+\begin{enumerate}
+\item git init, forkが済んでいると仮定
+\item upstream, originの確認
+\begin{enumerate}
 \item bob% git remote -v
 \end{enumerate}
-\item git push作業\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 編集後
-\item git pull作業\begin{enumerate}
-\item git pull upstream origin
+\item bobの編集後，通知がくる．まつことなく作業してもok．
+\item git pull作業
+\begin{enumerate}
+\item git pull upstream master
 \end{enumerate}
 \end{enumerate}
 これがうまくいかん時は聞いてください．
 
+\begin{figure}[htbp]\begin{center}
+\includegraphics[width=6cm,bb=0 0 442 500]{../figs/./hikiutils_bob.004.jpeg}
+\caption{卒論編集時のgithubによる同期のシーケンス図．}
+\label{default}\end{center}\end{figure}
+\subsection{hikiutil関連のヘルプ}
+\subsubsection{hikiで卒論を書くときの初期化と掟}
+\begin{itemize}
+\item 開発メモ:figs,dataも作成
+\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{error対応}
+\begin{itemize}
+\item Permission denied - ./data/text/boundary\_narita (Errno::EACCES)->テキストにhikiが書き込めない，chmod a+w FILE
+\end{itemize}
+\subsubsection{図表：すべての図表をkeynoteにまとめる，タイトルを分かりやすく書く}
+\begin{itemize}
+\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では
+\end{itemize}
+'\verb|{{attach_anchor(test.png, hiki2latex_saki)}}|'
+と，directory指定しなければならない.
+
+\begin{itemize}
+\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}

data/hikiutils_bob/sync.hiki

@@ -1,14 +1,15 @@
 {{toc}}
 !イントロダクション
-卒業論文は，大学で課される一般的なレポートに比べて多くの情報内容が要求される．また，研究という側面から体裁や版権など多くの出版における掟を遵守しながら，高い品質を保つ必要がある．そのため，指導教官との編集作業が重要となる．編集作業の効率を高めるためには，共同作業を促進するプラットフォームが必要である．
+卒業論文は，大学で課される普通の授業のレポートに比べて多くの情報内容が要求されます．また，研究という側面から体裁や版権など多くの出版における掟を遵守しながら，高い品質を保つ必要です．そのため，指導教官との編集作業が重要となるます．編集作業の効率を高めるためには，共同作業を促進するプラットフォームが必要です．
 
-体裁などを考えると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記述が可能となるシステムを利用している．
+体裁などを考えると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ブラウザ上に完成形を表示しつつ執筆することが求められる．このような操作環境を提供するのが，hikiutils -iである．
+例えば，卒業生をyamaneとしましょう．yamaneの個人のMacの自分のdirectory(hikiutils_yamane)に幾つかのファイルを作成して卒論を書いているとします．これを指導教官(bob)が編集するとします．この同期には，Githubにより提供される共同作業環境を使います．これだけでは編集中の文書の体裁がわかりにくいでしょう．そこで，hikiシステムにより容易にwebブラウザ上に完成形を表示しつつ執筆することが求められます．このような操作環境を提供するのが，hikiutils -iです．
+
 !hikiとの同期
 !! hikiutilsのinstall
 hikiuitlsをgemからinstallしておく必要がある．コマンドは以下の通り．
@@ -122,7 +123,7 @@ cp tmp.hiki hikiutils_bob.hiki
 などと番号を3から順に振り替えてくれる．
 
 !!githubによる同期
-# git initが済んでいると仮定
+# git init, forkが済んでいると仮定
 # upstream, originの確認
 ## bob% git remote -v
 # git push作業
@@ -130,7 +131,43 @@ cp tmp.hiki hikiutils_bob.hiki
 ## git commit -m 'first commit'
 ## git push origin master
 # githubでbobへpull requestをかける
-# 編集後
+# bobの編集後，通知がくる．まつことなく作業してもok．
 # git pull作業
-## git pull upstream origin
+## git pull upstream master
 これがうまくいかん時は聞いてください．
+
+!!!caption:卒論編集時のgithubによる同期のシーケンス図．
+{{attach_view(hikiutils_bob.004.jpeg,hikiutils_bob)}}
+
+!!hikiutil関連のヘルプ
+!!!hikiで卒論を書くときの初期化と掟
+*開発メモ:figs,dataも作成
+*目的：西谷が後で迷わないように決まったファイル構造を堅持すべし
+*文書：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と変換される
+
+!!!error対応
+*Permission denied - ./data/text/boundary_narita (Errno::EACCES)->テキストにhikiが書き込めない，chmod a+w FILE
+
+!!!図表：すべての図表を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

data/hikiutils_yamane/Rakefile

@@ -38,14 +38,14 @@ task :latex_all do
       option="--listings --head latex_dir/head.tex -p "
       main_file=f_name
     else
-      option="-l 2 --listings -b "
+      option="-l 1 --listings -b "
     end
     convert_to_latex(file, option)
   }
   cont=""
   File.readlines(File.join($latex_dir,"#{main_file}.tex")).each{|line|
-    if line.match(/\\section{(.+)}/) 
-      if m=line.match(/\\section{\\verb\|(.+)\|}/) 
+    if line.match(/section{(.+)}/) 
+      if m=line.match(/section{\\verb\|(.+)\|}/) 
         p m
         p reg_exp = Regexp.new("#{basename}_(.+)")
         p m_t=m[1].match(reg_exp)[1]
@@ -61,33 +61,6 @@ task :latex_all do
   exit
 end
 
-desc "change latex figures to wrap format"
-task :change_wrap do
-  lines = File.readlines($save_name)
-
-  cont = ""
-  lines.each{|line|
-    if line.include?('\begin{figure}[htbp]\begin{center}')
-      p line
-      cont << '\begin{wrapfigure}{r}{8cm}'+"\n"
-      cont << '\vspace{-2\baselineskip}'+"\n"
-      cont << '\begin{center}'+"\n"
-    elsif line.include?('\label{default}\end{center}\end{figure}')
-      p line
-      cont << '\end{center}'+"\n"
-      cont << '\vspace{2\baselineskip}'+"\n"
-      cont << '\end{wrapfigure}'+"\n"
-    else
-      cont << line
-    end
-  }
-  File.open($save_name,'w'){|file| file.print cont }
-
-  system("open #{$save_name}")
-  exit
-end
-
-
 desc "latex conversion FILE1(hiki) to FILE2(latex)"
 task :latex_base do
   Dir.mkdir($latex_dir) unless Dir.exist?($latex_dir)
@@ -127,6 +100,33 @@ def convert_to_latex(file_name, option=nil)
   File.open($save_name,'w'){|file| file.print cont }
 end
 
+desc "change latex figures to wrap format"
+task :change_wrap do
+  lines = File.readlines($save_name)
+
+  cont = ""
+  lines.each{|line|
+    if line.include?('\begin{figure}[htbp]\begin{center}')
+      p line
+      cont << '\begin{wrapfigure}{r}{8cm}'+"\n"
+      cont << '\vspace{-2\baselineskip}'+"\n"
+      cont << '\begin{center}'+"\n"
+    elsif line.include?('\label{default}\end{center}\end{figure}')
+      p line
+      cont << '\end{center}'+"\n"
+      cont << '\vspace{2\baselineskip}'+"\n"
+      cont << '\end{wrapfigure}'+"\n"
+    else
+      cont << line
+    end
+  }
+  File.open($save_name,'w'){|file| file.print cont }
+
+  system("open #{$save_name}")
+  exit
+end
+
+
 desc "increment fig NUBERS in FILE"
 task :increment do
   number=ARGV[1]
@@ -202,7 +202,7 @@ task :sync0 do
   }
   p entries=Dir.entries('./figs') #cp files in figs
   p target = File.join(target_dir,'cache','attach',basename)
-  FileUtils.mkdir(target,:verbose=>true) unless File.exists?(target)
+  FileUtils.mkdir_p(target,:verbose=>true) unless File.exists?(target)
   entries[2..-1].each{|file|
     p source = File.join('./figs',file)
     FileUtils.cp(source,target,:verbose=>true)
@@ -262,6 +262,7 @@ task :check_previous do
   if changed.size != 0
     print("hiki dirで変更が発生しています．\n")
     changed.each{|line| print line+"\n"} 
+    print("問題がなければrake force_syncで強制同期してください．\n")
     exit
   end
 end