hikiutils 0.2.3.2 → 0.2.3.3

data/hikiutils_bob/latex_dir/latex_all.tex

@@ -0,0 +1,164 @@
+\subsection{実際の最終形態(卒論=pdf)への変換}
+hiki+keynoteで卒論の内容ができたら，それを卒論の最終形態つまりpdfへ変換する必要が出てきます．
+
+ここで問題が発生します．hikiよりもlatexの方が機能が豊富なこと．
+つまり，簡易に書くにはhikiなどのmark downで書いていくのがいいんですが，
+文書として完成度を高めるには，latexで細かい設定を調整する必要がどうしても出てきます．
+
+具体的には，
+\begin{enumerate}
+\item 図の配置を調整するwrapの数値調整
+\item 参照文献の記述
+\item リスト，引用の体裁
+\item 章立て階層構造
+\end{enumerate}
+などが問題になるところです．
+
+これはhikiではどうしようもありません．一つの手はもう少し高機能なmark up言語
+例えばasciidocなどに変更することですが，これはどこまでいっても終わりのない
+方向のようで，結局はlatexで書いているのと同じになる可能性があります．
+
+我々は違う戦略をとります．それは，
+\begin{quote}\begin{verbatim}
+latexをベースにして，hikiを生成する
+\end{verbatim}\end{quote}
+と言う手です．
+
+DRY(Don't Repeat Yourself)原則さえ守れば，文書管理はいいのですから，
+ある段階まですすめばhikiではなくlatexを原本にするのです．
+そのための変換器latex2hikiとその派生rake環境が用意されています．
+そちらはこちらで卒業後に変換します．参照文献はlatexに移してから
+修正してください．
+
+ここでは，hikiでできることをとことん突き詰めておきます．
+
+\subsubsection{install}\begin{quote}\begin{verbatim}
+hiki -i
+\end{verbatim}\end{quote}
+でinstallされています．新たに使うコマンド群は次の通りです．
+\begin{lstlisting}[style=]
+rake change_wrap     # change latex figures to wrap format
+rake latex           # latex conversion FILE1
+rake latex_all       # latex conversion whole hiki files in the current dir
+rake latex_base      # latex conversion FILE1(hiki) to FILE2(latex)
+rake latex_wrap      # latex conversion FILE1 with wrap format
+\end{lstlisting}\begin{quote}\begin{verbatim}
+rake latex hikiutils_bob.hiki
+\end{verbatim}\end{quote}
+と打ち込むと
+
+\subsubsection{rake latex手順（個別ファイルの変換）}\begin{quote}\begin{verbatim}
+rake latex sync.hiki
+\end{verbatim}\end{quote}
+とすると，
+\begin{quote}\begin{verbatim}
+latex_dir/sync.tex
+\end{verbatim}\end{quote}
+にlatex変換後のファイルが生成します．これを，TeXShopでcommand\_t変換します．
+
+うまくいかないときは，terminalで
+\begin{quote}\begin{verbatim}
+platex sync.tex
+dvipdfmx sync.dvi
+\end{verbatim}\end{quote}
+を試してみてください．
+
+\paragraph{注意}
+hikiの初めの部分は，
+\begin{quote}\begin{verbatim}
+!title:hikiutils -iによる卒論作成システム
+!author:Shigeto R. Nishitani
+!date: Kwansei Gakuen Univ., 2017/1
+\end{verbatim}\end{quote}
+とすると，
+\begin{lstlisting}[style=]
+\begin{document}
+\title{hikiutils -iによる卒論作成システム}
+\author{Shigeto R. Nishitani}
+\date{ Kwansei Gakuen Univ., 2017/1}
+\maketitle
+\end{lstlisting}
+と変換してくれます．
+
+必要な図は，figsから自動で取るようになっていますが，サイズは解像度が問題のときは手動で調整してください．
+
+\subsubsection{rake latex\_all手順（ディレクトリーないの一括変換）}\begin{quote}\begin{verbatim}
+bob% cat hikiutils_bob.hiki 
+!hikiutilsを用いた卒業論文作成
+
+! [[hikiutils_bob_sync]]
+! [[hikiutils_bob_latex_all]]
+
+\end{verbatim}\end{quote}
+とpwdのdirectoryの同名のbasenameに.hikiの拡張子がついたファイルが用意されていて，
+\begin{quote}\begin{verbatim}
+rake latex_all
+\end{verbatim}\end{quote}
+をおこなうと自動で全部を一体にまとめた文書へのlatex変換が出来上がります．
+開いているhikiutils\_bob.texをTeXShopで変換してみてください．
+
+うまくできないときは\verb|ここ(http://qiita.com/hideaki_polisci/items/3afd204449c6cdd995c9#51-texshopの設定)|を参照して自力で入れてみてください．だめならdonkey.
+
+\begin{figure}[htbp]\begin{center}
+\includegraphics[width=6cm,bb=0 0 442 500]{../figs/./hikiutils_bob.pdf}
+\caption{}
+\label{default}\end{center}\end{figure}
+というようになります．
+
+\paragraph{下準備}
+latex\_dir内に幾つかのtex雛形を入れておく必要があります．
+\begin{quote}\begin{verbatim}
+hiki -i
+\end{verbatim}\end{quote}
+とhikiutils環境を再度初期化すると，自動でインストールする設定です．
+なかったら手動で作ってください．
+
+\paragraph{head.tex}\begin{lstlisting}[style=]
+bob% cat head.tex
+\title{卒業論文\\
+\vspace{4cm} hikiutilsを用いた\\卒業論文作成}
+\author{ 関西学院大学　理工学部　情報科学科\\\\1234 西谷滋人}
+\date{\vspace{3cm} 2017年  3月\\
+\vspace{3cm} 指導教員　　西谷　滋人　教授}
+\maketitle
+
+\end{lstlisting}
+\paragraph{pre.tex}\begin{lstlisting}[style=]
+bob% cat pre.tex
+\documentclass[10pt,a4j]{article}
+
+\def\Vec#1{\mbox{\boldmath $#1$}}
+\usepackage[dvipdfmx]{graphicx}
+
+\setlength{\textheight}{275mm}
+\headheight 5mm
+\topmargin -20mm
+\textwidth 160mm
+\textheight 250mm
+\oddsidemargin -0mm
+\evensidemargin -5mm
+
+\pagestyle{empty}
+\makeatletter
+  \def\@maketitle{%
+  \newpage\null
+  \vskip 2em%
+  \begin{center}%
+  \let\footnote\thanks
+    {\large\bf \@title \par}%
+    \vskip 1.5em%
+    {\large\bf \@author \par}%
+    \vskip 1.5em%
+    {\small \@date}%
+  \end{center}%
+}
+\makeatother
+
+%\documentclass[10pt, a4j]{article}
+%%\usepackage{citesort}
+\usepackage{amssymb}
+\usepackage[dvipdfmx]{graphicx}% 図を入れるときに使用
+\usepackage{wrapfig}% 図の周りに本文を流し込みたいときに使用
+\usepackage{subfigure}
+\usepackage{here}
+\end{lstlisting}

data/hikiutils_bob/latex_dir/pre.tex

@@ -0,0 +1,36 @@
+\documentclass[10pt,a4j]{article}
+
+\def\Vec#1{\mbox{\boldmath $#1$}}
+\usepackage[dvipdfmx]{graphicx}
+
+\setlength{\textheight}{275mm}
+\headheight 5mm
+\topmargin -20mm
+\textwidth 160mm
+\textheight 250mm
+\oddsidemargin -0mm
+\evensidemargin -5mm
+
+\pagestyle{empty}
+\makeatletter
+  \def\@maketitle{%
+  \newpage\null
+  \vskip 2em%
+  \begin{center}%
+  \let\footnote\thanks
+    {\large\bf \@title \par}%
+    \vskip 1.5em%
+    {\large\bf \@author \par}%
+    \vskip 1.5em%
+    {\small \@date}%
+  \end{center}%
+}
+\makeatother
+
+%\documentclass[10pt, a4j]{article}
+%%\usepackage{citesort}
+\usepackage{amssymb}
+\usepackage[dvipdfmx]{graphicx}% 図を入れるときに使用
+\usepackage{wrapfig}% 図の周りに本文を流し込みたいときに使用
+\usepackage{subfigure}
+\usepackage{here}

data/hikiutils_bob/latex_dir/sync.aux

@@ -0,0 +1,41 @@
+\relax 
+\@writefile{lof}{\contentsline {figure}{\numberline {1}{\ignorespaces 卒論編集システムの概要．}}{3}}
+\newlabel{default}{{1}{3}}
+\@writefile{toc}{\contentsline {subsection}{\numberline {0.1}hikiutilsのinstall}{4}}
+\@writefile{toc}{\contentsline {subsection}{\numberline {0.2}個別ディレクトリーの構成}{4}}
+\@writefile{lof}{\contentsline {figure}{\numberline {2}{\ignorespaces hikiutils\_bobのディレクトリー構成．}}{4}}
+\newlabel{default}{{2}{4}}
+\@writefile{toc}{\contentsline {subsection}{\numberline {0.3}一般的な執筆手順}{5}}
+\@writefile{toc}{\contentsline {subsection}{\numberline {0.4}rakeが用意しているタスク}{6}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {0.4.1}rake sync}{6}}
+\@writefile{lot}{\contentsline {table}{\numberline {1}{\ignorespaces }}{6}}
+\newlabel{default}{{1}{6}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {0.4.2}rake convert}{7}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {0.4.3}rake force\_sync}{7}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {0.4.4}rake chenv}{7}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {0.4.5}rake increment}{7}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {0.4.6}rake number}{7}}
+\@writefile{toc}{\contentsline {subsection}{\numberline {0.5}githubによる同期}{8}}
+\@writefile{toc}{\contentsline {subsection}{\numberline {0.6}hiki\_helpで表示されるヘルプ内容}{8}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {0.6.1}hikiで卒論を書くときの初期化と掟}{9}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {0.6.2}図表：すべての図表をkeynoteにまとめる，タイトルを分かりやすく書く}{9}}
+\@setckpt{sync}{
+\setcounter{page}{11}
+\setcounter{equation}{0}
+\setcounter{enumi}{6}
+\setcounter{enumii}{1}
+\setcounter{enumiii}{0}
+\setcounter{enumiv}{0}
+\setcounter{footnote}{0}
+\setcounter{mpfootnote}{0}
+\setcounter{part}{0}
+\setcounter{section}{0}
+\setcounter{subsection}{6}
+\setcounter{subsubsection}{2}
+\setcounter{paragraph}{0}
+\setcounter{subparagraph}{0}
+\setcounter{figure}{2}
+\setcounter{table}{1}
+\setcounter{lstnumber}{3}
+\setcounter{lstlisting}{0}
+}

data/hikiutils_bob/latex_dir/sync.log

@@ -0,0 +1,183 @@
+This is e-pTeX, Version 3.14159265-p3.6-141210-2.6 (utf8.euc) (TeX Live 2015) (preloaded format=platex 2015.7.31)  26 JAN 2017 15:22
+entering extended mode
+ restricted \write18 enabled.
+ file:line:error style messages enabled.
+ %&-line parsing enabled.
+**sync
+(./sync.tex
+pLaTeX2e <2006/11/10> (based on LaTeX2e <2015/01/01> patch level 0)
+Babel <3.9l> and hyphenation patterns for 79 languages loaded.
+(/usr/local/texlive/2015/texmf-dist/tex/latex/base/article.cls
+Document Class: article 2014/09/29 v1.4h Standard LaTeX document class
+(/usr/local/texlive/2015/texmf-dist/tex/latex/base/size10.clo
+File: size10.clo 2014/09/29 v1.4h Standard LaTeX file (size option)
+)
+\c@part=\count81
+\c@section=\count82
+\c@subsection=\count83
+\c@subsubsection=\count84
+\c@paragraph=\count85
+\c@subparagraph=\count86
+\c@figure=\count87
+\c@table=\count88
+\abovecaptionskip=\skip41
+\belowcaptionskip=\skip42
+\bibindent=\dimen118
+)
+(/usr/local/texlive/2015/texmf-dist/tex/latex/graphics/graphicx.sty
+Package: graphicx 2014/10/28 v1.0g Enhanced LaTeX Graphics (DPC,SPQR)
+
+(/usr/local/texlive/2015/texmf-dist/tex/latex/graphics/keyval.sty
+Package: keyval 2014/10/28 v1.15 key=value parser (DPC)
+\KV@toks@=\toks15
+)
+(/usr/local/texlive/2015/texmf-dist/tex/latex/graphics/graphics.sty
+Package: graphics 2014/10/28 v1.0p Standard LaTeX Graphics (DPC,SPQR)
+
+(/usr/local/texlive/2015/texmf-dist/tex/latex/graphics/trig.sty
+Package: trig 1999/03/16 v1.09 sin cos tan (DPC)
+)
+(/usr/local/texlive/2015/texmf-dist/tex/latex/latexconfig/graphics.cfg
+File: graphics.cfg 2010/04/23 v1.9 graphics configuration of TeX Live
+)
+Package graphics Info: Driver file: dvipdfmx.def on input line 94.
+
+(/usr/local/texlive/2015/texmf-dist/tex/latex/dvipdfmx-def/dvipdfmx.def
+File: dvipdfmx.def 2015/03/26 v4.04 LaTeX color/graphics driver for dvipdfmx (T
+eX Live/ChoF)
+))
+\Gin@req@height=\dimen119
+\Gin@req@width=\dimen120
+)
+(/usr/local/texlive/2015/texmf-dist/tex/latex/amsfonts/amssymb.sty
+Package: amssymb 2013/01/14 v3.01 AMS font symbols
+
+(/usr/local/texlive/2015/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/2015/texmf-dist/tex/latex/wrapfig/wrapfig.sty
+\wrapoverhang=\dimen121
+\WF@size=\dimen122
+\c@WF@wrappedlines=\count89
+\WF@box=\box41
+\WF@everypar=\toks17
+Package: wrapfig 2003/01/31  v 3.6
+)
+(/usr/local/texlive/2015/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=\count90
+\c@lofdepth=\count91
+\c@subtable=\count92
+\c@lotdepth=\count93
+
+****************************************
+* Local config file subfigure.cfg used *
+****************************************
+(/usr/local/texlive/2015/texmf-dist/tex/latex/subfigure/subfigure.cfg)
+\subfig@top=\skip47
+\subfig@bottom=\skip48
+)
+(/usr/local/texlive/2015/texmf-dist/tex/latex/here/here.sty)
+(/usr/local/texlive/2015/texmf-dist/tex/latex/float/float.sty
+Package: float 2001/11/08 v1.3d Float enhancements (AL)
+\c@float@type=\count94
+\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.
+
+)
+\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.
+File: ../figs/./hikiutils_bob.002.jpeg Graphic file (type eps)
+ <../figs/./hikiutils_bob.002.jpeg>
+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 54.
+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 54.
+File: ../figs/./hikiutils_bob.003.jpeg Graphic file (type eps)
+ <../figs/./hikiutils_bob.003.jpeg>
+[1
+
+] [2]
+LaTeX Font Info:    Try loading font information for U+msa on input line 129.
+ (/usr/local/texlive/2015/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 129.
+
+(/usr/local/texlive/2015/texmf-dist/tex/latex/amsfonts/umsb.fd
+File: umsb.fd 2013/01/14 v3.01 AMS symbols B
+)
+Overfull \hbox (32.44054pt too wide) in paragraph at lines 145--146
+\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]
+LaTeX Font Info:    Try loading font information for OMS+cmr on input line 206.
+
+ (/usr/local/texlive/2015/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 206.
+ [4] [5]
+(./sync.aux)
+
+LaTeX Warning: There were multiply-defined labels.
+
+ ) 
+Here is how much of TeX's memory you used:
+ 1174 strings out of 493777
+ 14708 string characters out of 6151334
+ 74241 words of memory out of 5000000
+ 4678 multiletter control sequences out of 15000+600000
+ 12287 words of font info for 51 fonts, out of 8000000 for 9000
+ 929 hyphenation exceptions out of 8191
+ 25i,8n,26p,707b,269s stack positions out of 5000i,500n,10000p,200000b,80000s
+
+Output written on sync.dvi (5 pages, 15200 bytes).

data/hikiutils_bob/latex_dir/sync.tex

@@ -0,0 +1,200 @@
+\title{hikiutils -iによる卒論作成システム}
+\author{Shigeto R. Nishitani}
+\date{ Kwansei Gakuen Univ., 2017/1}
+\maketitle
+卒業論文は，大学で課される一般的なレポートに比べて多くの情報内容が要求される．また，研究という側面から体裁や版権など多くの出版における掟を遵守しながら，高い品質を保つ必要がある．そのため，指導教官との編集作業が重要となる．編集作業の効率を高めるためには，共同作業を促進するプラットフォームが必要である．
+
+体裁などを考えると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である．
+
+\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=6cm,bb=0 0 442 500]{../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=]
+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{一般的な執筆手順}\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 80 hikiutils\_bob
+\end{enumerate}
+\item hikiシステムとの同期\begin{enumerate}
+\item rake sync
+\end{enumerate}
+\item hikiシステムで表示\begin{enumerate}
+\item hiki -u hikiutils\_bob
+\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
+\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 convert}
+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}
+によって，hikiutils\_bobにkeynoteから吐いたpngファイルを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=]
+cp hikiutils_bob.hiki tmp.hiki
+rake increment 2 tmp.hiki > tmp2.hiki
+\end{lstlisting}
+としてattach\_viewのページ番号を単純に増加させることができる．
+
+\subsubsection{rake number}
+前節同じくfigs内の通し番号が変わった時にattach\_viewの通し番号を調整するコマンド．
+\begin{lstlisting}[style=]
+rake number 3 hikiutils_bob.hiki > tmp.hiki
+cp tmp.hiki hikiutils_bob.hiki
+\end{lstlisting}
+とすると
+\begin{quote}\begin{verbatim}
+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{verbatim}\end{quote}
+などと番号を3から順に振り替えてくれる．
+
+\subsection{githubによる同期}\begin{enumerate}
+\item git initが済んでいると仮定
+\item upstream, originの確認\begin{enumerate}
+\item bob% git remote -v
+\end{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
+\end{enumerate}
+\end{enumerate}
+これがうまくいかん時は聞いてください．
+
+\subsection{hiki\_helpで表示されるヘルプ内容}
+hiki\_help -i -fにより，使い方のメモが表示される．
+
+\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{図表：すべての図表をkeynoteにまとめる，タイトルを分かりやすく書く}\begin{itemize}
+\item keynoteに書いたスライドはイメージに書き出して，rake convert 80 TARGET\_DIRでfigsに変換
+\item rake syncでfigsにあるfilesはhiki/target\_dirにcpされる
+\end{itemize}\begin{quote}\begin{verbatim}
+convert #{source} -resize 20% #{target}によって，target=figs/TAERGET.pngに20%に縮小して保存される
+\end{verbatim}\end{quote}\begin{itemize}
+\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/latex_dir/to_latex.tex

@@ -0,0 +1,44 @@
+\subsection{実際の最終形態(卒論=pdf)への変換}
+hiki+keynoteで卒論の内容が出来てきたら，それを実際の最終形態つまり
+卒論のpdfへ変換する必要が出てきます．
+
+ここで問題が発生します．hikiよりもlatexの方が機能が豊富なこと．
+つまり，簡易に書くにはhikiなどのmark downで書いていくのがいいんですが，
+文書として完成度高めるには，latexで細かい設定を調整する必要がどうしても出てきます．
+
+具体的には，
+\begin{enumerate}
+\item 図の配置を調整するwrapの数値調整
+\item 参照文献の記述
+\item リスト，引用の体裁
+\item 章立て階層構造
+\end{enumerate}
+などが問題になるところです．
+
+これはhikiではどうしようもありません．一つの手はもう少し高機能なmark up言語
+例えばasciidocなどに変更することですが，これはどこまでいっても終わりのない
+方向のようで，結局はlatexで書いているのと同じになる可能性があります．
+
+我々は違う戦略をとります．それは，
+\begin{quote}\begin{verbatim}
+latexをベースにして，hikiを生成する
+\end{verbatim}\end{quote}
+と言う手です．
+
+DRY(Don't Repeat Yourself)原則さへ守ればいいのですから，ある段階まで
+すすめばhikiではなくlatexを原本にするのです．そのための変換器latex2hikiと
+その派生rake環境が用意されています．そちらに進んでください．
+
+ただ，その前にhikiでできることをとことん突き詰めておきます．
+これは，単純な文書，たとえばabstractとか中間発表のhandout程度では十分に役に立つコマンド群です．
+
+\subsubsection{install}\begin{quote}\begin{verbatim}
+hiki -i
+\end{verbatim}\end{quote}
+でinstallされています．新たに使うコマンド群は次の通りです．
+\begin{lstlisting}[style=]
+rake change_wrap     # change latex figures to wrap format
+rake latex           # latex conversion FILE1
+rake latex_base      # latex conversion FILE1(hiki) to FILE2(latex)
+rake latex_wrap      # latex conversion FILE1 with wrap format
+\end{lstlisting}