hiki2latex 0.9.12 → 0.9.12.1

data/latexes/hiki2latex.tex

@@ -0,0 +1,213 @@
+\documentclass[10pt,a4jpaper]{jsarticle}
+\usepackage[dvipdfmx]{graphicx}
+\usepackage[dvipdfmx]{color}
+\usepackage{listings}
+% to use japanese correctly, install jlistings.
+\lstset{
+  basicstyle={\small\ttfamily},
+  identifierstyle={\small},
+  commentstyle={\small\itshape\color{red}},
+  keywordstyle={\small\bfseries\color{cyan}},
+  ndkeywordstyle={\small},
+  stringstyle={\small\color{blue}},
+  frame={tb},
+  breaklines=true,
+  numbers=left,
+  numberstyle={\scriptsize},
+  stepnumber=1,
+  numbersep=1zw,
+  xrightmargin=0zw,
+  xleftmargin=3zw,
+  lineskip=-0.5ex
+}
+\lstdefinestyle{customCsh}{
+  language={csh},
+  numbers=none,
+}
+\lstdefinestyle{customRuby}{
+  language={ruby},
+  numbers=left,
+}
+\lstdefinestyle{customTex}{
+  language={tex},
+  numbers=none,
+}
+\lstdefinestyle{customJava}{
+  language={java},
+  numbers=left,
+}
+\begin{document}
+\title{hiki2latex}
+\author{関西学院大学・理工学部・西谷滋人}
+\date{\today}
+\maketitle
+
+\abstract{
+hiki formatで書かれた文章を，latex formatに変換する
+
+}
+\tableofcontents
+\section{【documents】}\begin{itemize}
+\item \verb|http://rubygems.org/gems/hiki2latex|
+\end{itemize}
+\section{【使用法】}\begin{lstlisting}[style=customCsh]
+Usage: hiki2latex [options] FILE
+    -v, --version                    show program Version.
+    -l, --level VALUE                set Level for output section.
+    -p, --plain FILE                 make Plain document.
+    -b, --bare FILE                  make Bare document.
+        --head FILE                  put headers of maketitle file.
+        --pre FILE                   put preamble file.
+        --post FILE                  put post file.
+        --listings                   use listings.sty for preformat with style.
+\end{lstlisting}\begin{itemize}
+\item より詳細な使用法は，\verb|hiki2latex_gemizing|にある．
+\item 西谷研の内部で利用するときに特化したマニュアルは\verb|こちら(hiki2latex_manual)|．
+\end{itemize}
+\subsection{sample}
+幾つかのサンプルを以下に示す．
+
+\begin{table}[htbp]\begin{center}
+\caption{hiki2latexにより作成されたpdfファイトとその元ネタ．}
+\begin{tabular}{lll}
+\hline
+ソース(hiki表示)  &pdf(latex変換後)  \\ \hline
+\verb|Shunkuntype(https://github.com/daddygongon/shunkuntype/wiki/Shunkuntype_report)|  &\verb|Shunkuntypeのレポート(https://github.com/daddygongon/shunkuntype/wiki/shunkun_report.pdf)|  \\
+\verb|LPSO15研究会の例(LPSO15_fall_meeting_abst)|  &\verb|{{attach_anchor(LPSO_abst.pdf)}}|  \\
+\verb|中間発表hand out例(AbstSample)|  &\verb|{{attach_anchor(AbstSample.pdf)}}|  \\
+\verb|使っているformat集(DocumentFormatter_format_examples)|  \\
+\hline
+\end{tabular}
+\label{default}
+\end{center}\end{table}
+%for inserting separate lines, use \hline, \cline{2-3} etc.
+
+\section{【仕様】}\begin{enumerate}
+\item hikdoc.rbにwrap
+\item header部を独立して提供
+\item author, titleはheadに手を加えて提供
+\item 図はattach\_viewを変換
+\item 表はそのまま表示\begin{enumerate}
+\item tableのmulti対応
+\end{enumerate}
+\item captionはheaderで提供
+\item citeは対応しない．
+\item graph, tableは[h]で提供．
+\end{enumerate}
+\section{【具体的な使用例rakefile】}
+具体的な使用例として\verb|Shunkuntype_report|を作成した時のRakefile.rbを示す．何度も書き直す時は，このようにして自動化すべき．
+\begin{lstlisting}[style=customRuby]
+task :shunkuntype do
+  dir = '~/Sites/nishitani0/Internal/data/text/'
+  targets =["Shunkuntype_manual","Shunkuntype_gemizing","TouchTyping_Coding"]
+  targets.each{|file|
+    p command= "rm -f #{file}.tex"
+    system command
+    p command= "hiki2latex -l 2 --listings -b #{dir}#{file} > #{file}.tex"
+    system command
+  }
+  file="Shunkuntype_report"
+  p command= "rm -f #{file}.tex"
+#  p command= "hiki2latex --listings --head head.tex --post post.tex -p #{dir}#{file} > #{file}.tex"
+  p command= "hiki2latex --listings --post post.tex -p #{dir}#{file} > #{file}.tex"
+  system command
+
+  p command = "open #{file}.tex"
+  system command
+  exit
+end
+\end{lstlisting}
+本文(Shunkuntype\_report.tex)と付録(targets.texs)がある．付録は'-l 2 -b'によってsubsectionからのtitle levelにしてbare modeで作っている．post.texにpostで付け加えるtex部を指定して，appendixをつけている．
+
+\section{【変更履歴，内容】}
+変更履歴，内容を表に示す．15/8月期で基本開発．16/2月期にgem化．
+
+\begin{table}[htbp]\begin{center}
+\caption{変更履歴，内容}
+\begin{tabular}{llll}
+\hline
+memo   &date  &hiki  \\ \hline
+hikidoc.rbからhiki2latex.rb  &15/8/4  &\verb|hiki2latex_init|  \\
+hiki2latex.rbひな形作成  &15/8/5  \\
+@fをStringIOからStringへ  &15/8/5  \\
+graph+caption  &15/8/6  &\verb|LPSO15_fall_meeting_abst|  \\
+math  &15/8/7  &\verb|hiki2latex_math|  \\
+table  &15/8/8  &\verb|hiki2latex_table|  \\
+under\_score  &15/8/11   &\verb|hiki2latex_math|  \\
+gem化  &16/2/13   &\verb|hiki2latex_gemizing|  \\
+listings  &16/2/16   &\verb|hiki2latex_listings|  \\
+\hline
+\end{tabular}
+\label{default}
+\end{center}\end{table}
+%for inserting separate lines, use \hline, \cline{2-3} etc.
+
+\section{【開発メモ】}
+\subsection{制限事項}\begin{itemize}
+\item title中へuriの埋め込みが未対応．\begin{itemize}
+\item uriのverbがlatexのtitle内で使えないため．
+\end{itemize}
+\end{itemize}
+\subsection{【 保留項目】}\begin{enumerate}
+\item includegraphicsの自動提供\begin{enumerate}
+\item hikiに置かれているgraphは劣化版なんでそれをいじるのはあまり筋がよろしくない．
+\item epsならできるかも．hikiのattach\_viewでサイズをどういじっているか．．．
+\end{enumerate}
+\item underbar(\_)がlatexでは全て引っかかる．escapeする？-> 対応済み \verb|hiki2latex_math|\begin{enumerate}
+\item snake表記はrubyではfile名や変数名に頻繁に使われるので対処が必要かも．
+\end{enumerate}
+\end{enumerate}
+\subsection{【math】}
+＄＄での変換がうまくいかない．
+\begin{quote}\begin{verbatim}
+hikiconf.rb
+\end{verbatim}\end{quote}
+での設定を
+\begin{quote}\begin{verbatim}
+#@style           = 'default'
+@style           = 'math'
+\end{verbatim}\end{quote}
+としたらhikiからエラーは出なくなったが．まだまだ．．．．
+
+\subsection{【user def】}\begin{quote}\begin{verbatim}
+\def\Vec#1{\mbox{\boldmath $#1$}}
+\end{verbatim}\end{quote}
+はpreambleに置くことが推奨されているが，実際は，使用するまでに定義すればいい．preambleをいじるようになるころには，latexについての十分な経験があると思われるので，hiki2latexではいじらない．ちょこっと必要ならhiki本文中に埋め込むべし．今の仕様では，
+\begin{lstlisting}[style=customRuby]
+  def initialize(file_name)
+    @buf = ""
+    @buf << HEADER+"\n"
+    @buf <<  "\\begin{document}\n"
+    @buf <<  HikiDoc.to_latex(file_name)+"\n"
+    @buf <<  REFERENCE+"\n"
+    @buf << "\\end{document}\n"
+  end
+
+  def display
+    @buf
+  end
+\end{lstlisting}
+とするのが正しそうなので，無理に入れていない．将来はpreambleを保持するような拡張機能(option)が必要かもしれない．それは，「原典一つ主義」で，hikiを原典とするか，latexを原典とするかの選択が迫られたとき．
+\begin{itemize}
+\item\begin{itemize}
+\item 追記(2015/02/17) いい考察だ．解はでてないが今はhiki2latexに埋め込んで，それらの仕様をできるだけ吸収しようとしている．
+\end{itemize}
+\end{itemize}
+\appendix
+\section{詳細な使用法}
+\input{hiki2latex_gemizing}
+\pagebreak
+\section{コード内容}
+\subsection{起動}
+\input{hiki2latex_init}
+\pagebreak
+\subsection{math環境}
+\input{hiki2latex_math}
+\pagebreak
+\subsection{table環境}
+\input{hiki2latex_table}
+\pagebreak
+\subsection{source code環境}
+\input{hiki2latex_listings}
+\pagebreak
+\end{document}

data/latexes/hiki2latex.toc

@@ -0,0 +1,47 @@
+\contentsline {section}{\numberline {1}【documents】}{1}
+\contentsline {section}{\numberline {2}【使用法】}{1}
+\contentsline {subsection}{\numberline {2.1}sample}{2}
+\contentsline {section}{\numberline {3}【仕様】}{2}
+\contentsline {section}{\numberline {4}【具体的な使用例rakefile】}{2}
+\contentsline {section}{\numberline {5}【変更履歴，内容】}{3}
+\contentsline {section}{\numberline {6}【開発メモ】}{3}
+\contentsline {subsection}{\numberline {6.1}制限事項}{3}
+\contentsline {subsection}{\numberline {6.2}【 保留項目】}{4}
+\contentsline {subsection}{\numberline {6.3}【math】}{4}
+\contentsline {subsection}{\numberline {6.4}【user def】}{4}
+\contentsline {section}{\numberline {付録A}詳細な使用法}{4}
+\contentsline {subsubsection}{\numberline {A.0.1}【概要】}{4}
+\contentsline {subsubsection}{\numberline {A.0.2}【使用法】}{5}
+\contentsline {subsubsection}{\numberline {A.0.3}【help】}{5}
+\contentsline {subsubsection}{\numberline {A.0.4}【詳細使用例(-p)】}{5}
+\contentsline {subsubsection}{\numberline {A.0.5}【詳細使用例(-b)】}{6}
+\contentsline {subsubsection}{\numberline {A.0.6}【詳細使用例( --head, --pre, --post】}{6}
+\contentsline {subsubsection}{\numberline {A.0.7}【lib/hiki2latex.rb】}{7}
+\contentsline {paragraph}{kill\_head\_line}{8}
+\contentsline {paragraph}{mod\_abstract}{8}
+\contentsline {section}{\numberline {付録B}コード内容}{9}
+\contentsline {subsection}{\numberline {B.1}起動}{9}
+\contentsline {subsubsection}{\numberline {B.1.1}【変更作業の手順】}{9}
+\contentsline {subsubsection}{\numberline {B.1.2}【設計】}{9}
+\contentsline {paragraph}{【maketitleの挿入】}{9}
+\contentsline {subsubsection}{\numberline {B.1.3}【sample】}{10}
+\contentsline {subsubsection}{\numberline {B.1.4}【pdfの貼り込み】}{10}
+\contentsline {subsection}{\numberline {B.2}math環境}{11}
+\contentsline {subsubsection}{\numberline {B.2.1}【概要】}{11}
+\contentsline {subsubsection}{\numberline {B.2.2}【入力：hiki】}{11}
+\contentsline {subsubsection}{\numberline {B.2.3}【出力：latex】}{11}
+\contentsline {subsubsection}{\numberline {B.2.4}【コード解説】}{11}
+\contentsline {paragraph}{evaluate\_plugin\_block}{11}
+\contentsline {paragraph}{snake\_nameがlatexで引っかかる}{12}
+\contentsline {paragraph}{escape\_snake\_namesを改良(2016/02/14)}{13}
+\contentsline {paragraph}{escape\_snake\_namesを再改良(2016/02/16)}{13}
+\contentsline {subsubsection}{\numberline {B.2.5}【copyright】}{13}
+\contentsline {subsection}{\numberline {B.3}table環境}{14}
+\contentsline {subsubsection}{\numberline {B.3.1}【概要】}{14}
+\contentsline {subsubsection}{\numberline {B.3.2}【仕様】}{14}
+\contentsline {subsubsection}{\numberline {B.3.3}【hiki】}{14}
+\contentsline {subsubsection}{\numberline {B.3.4}【latex】}{14}
+\contentsline {subsubsection}{\numberline {B.3.5}【コード解説】}{14}
+\contentsline {subsection}{\numberline {B.4}source code環境}{17}
+\contentsline {subsubsection}{\numberline {B.4.1}【概要】}{17}
+\contentsline {subsubsection}{\numberline {B.4.2}【hiki2latexの変更】}{17}

data/latexes/hiki2latex_gemizing.tex

@@ -0,0 +1,212 @@
+
+\subsubsection{【概要】}
+hikiフォーマットの記述をlatexフォーマットに変換する
+
+\subsubsection{【使用法】}
+gem化して配布可能とした．したがって，installがちゃんとできていれば，
+\begin{description}
+\item[command lineから] 
+
+\end{description}\begin{lstlisting}[style=customCsh]
+bob% hiki2latex Shunkuntype_manual > tmp.tex
+\end{lstlisting}\begin{description}
+\item[libraryとして] 
+
+\end{description}\begin{lstlisting}[style=customRuby]
+require 'hiki2latex'
+
+puts HikiDoc.to_latex(File.read(ARGV[0]))
+\end{lstlisting}\begin{lstlisting}[style=customCsh]
+bob% ruby trans.rb ./Shunkuntype_manual > tmp.tex
+\end{lstlisting}
+などとして利用できる．
+
+\subsubsection{【help】}\begin{lstlisting}[style=customCsh]
+bob% hiki2latex
+Usage: hiki2latex [options]
+    -v, --version                    show program Version.
+    -l, --level VALUE                set Level for output section.
+    -p, --plain FILE                 make Plain document.
+    -b, --bare FILE                  make Bare document.
+        --head FILE                  put headers of maketitle file.
+        --pre FILE                   put preamble file.
+        --post FILE                  put post file.
+\end{lstlisting}
+\subsubsection{【詳細使用例(-p)】}
+以下のようなSampleDoc
+\begin{lstlisting}[style=]
+bob% cat SampleDoc 
+!title
+contents
+*list1
+*list2
+!!title2
+\end{lstlisting}
+を
+\begin{lstlisting}[style=customTeX]
+bob% hiki2latex -p SampleDoc 
+\documentclass[12pt,a4paper]{jsarticle}
+\usepackage[dvipdfmx]{graphicx}
+\begin{document}
+\section{title}
+contents
+\begin{itemize}
+\item list1
+\item list2
+\end{itemize}
+\subsection{title2}
+\end{document}
+\end{lstlisting}
+となる．
+
+\subsubsection{【詳細使用例(-b)】}
+上記
+\begin{lstlisting}[style=customTeX]
+ \begin{document}
+ ...
+ \end{document}
+\end{lstlisting}
+の中身だけを生成．いくつものtex filesをincludeしている場合の個別ファイル作成に便利．
+
+この際，'-l 2'として付録のsectionとかを調整する．
+
+\subsubsection{【詳細使用例( --head,  --pre,  --post】}
+formatを標準と違うものにするために，pre,head,postがある．詳しくはsampleを見よ．
+していしていく順番はないはずだけど，-p SampleDocだけは順番があるのかな．
+あと，erbみたいにして使ったほうがいいかも．
+\begin{lstlisting}[style=customCsh]
+ bob% hiki2latex --pre preamble.tex --head head.tex --post post.tex -p SampleDoc 
+\end{lstlisting}\begin{lstlisting}[style=customTeX]
+%preamble.tex
+\documentclass[12pt,a4paper]{jsarticle}
+\usepackage[dvipdfmx]{graphicx}
+\pagestyle{empty}
+\end{lstlisting}\begin{lstlisting}[style=customTeX]
+ \begin{document}
+\end{lstlisting}\begin{lstlisting}[style=customTeX]
+%head.tex
+\author{関西学院大学・理工学部・西谷滋人}
+\title{touch typing習得環境shunkuntype}
+\date{\today}
+\maketitle
+\end{lstlisting}\begin{lstlisting}[style=customTeX]
+ \section{title}
+ contents
+ \begin{itemize}
+ \item list1
+ \item list2
+ \end{itemize}
+ \subsection{title2}
+\end{lstlisting}\begin{lstlisting}[style=customTeX]
+%post.tex
+\pagebreak
+\appendix
+\section{マニュアル}
+\input{shunkuntype_manual}
+\pagebreak
+\section{gem化メモ}
+\input{shunkuntype_gemizing}
+\pagebreak
+\section{初期版のコード解説}
+\input{shunkuntype_coding}
+\end{lstlisting}\begin{lstlisting}[style=customTeX]
+ \end{document}
+\end{lstlisting}
+\subsubsection{【lib/hiki2latex.rb】}\begin{lstlisting}[style=customRuby]
+require 'optparse'
+require "hiki2latex/version"
+#require "hiki2latex/hikidoc"
+require "hiki2latex/hiki2latex"
+
+module Hiki2latex
+  class Command
+
+    def self.run(argv=[])
+      new(argv).execute
+    end
+
+    def initialize(argv=[])
+      @argv = argv
+      @pre=@head=@post=nil
+    end
+
+    def execute
+      @argv << '--help' if @argv.size==0
+      command_parser = OptionParser.new do |opt|
+        opt.on('-v', '--version','show program Version.') { |v|
+          opt.version = Hiki2latex::VERSION
+          puts opt.ver
+        }
+        opt.on('-l VALUE','--level','set Level for output section.'){|level| @level=level.to_i}
+        opt.on('-p FILE', '--plain','make Plain document.') { |file| plain_doc(file) }
+        opt.on('-b FILE', '--bare','make Bare document.') { |file| bare_doc(file) }
+        opt.on('--head FILE', 'put headers of maketitle file.') { |file| @head=file }
+        opt.on('--pre FILE', 'put preamble file.') { |file| @pre=file }
+        opt.on('--post FILE', 'put post file.') { |file| @post=file }
+        opt.on('--listings', 'use listings.sty for preformat with style.') {@listings=true }
+      end
+      command_parser.banner = "Usage: hiki2latex [options] FILE"
+      command_parser.parse!(@argv)
+      plain_doc(@argv[0]) if @argv[0]!=nil
+      exit
+    end
+
+    # pre, post, listingsなどの拡張を処理
+    def plain_doc(file)
+      if @listings==true then
+        puts listings_preamble
+      elsif @pre==nil then
+        puts "\\documentclass[12pt,a4paper]{jsarticle}"
+        puts "\\usepackage[dvipdfmx]{graphicx}"
+      else
+        puts File.read(@pre)
+      end
+      puts "\\begin{document}"
+      puts File.read(@head) if @head!=nil
+      plain_tex = HikiDoc.to_latex(File.read(file),{:listings=>@listings})
+      puts mod_abstract(plain_tex)
+      puts File.read(@post) if @post!=nil
+      puts "\\end{document}"
+    end
+
+    def bare_doc(file)
+      bare_doc = HikiDoc.to_latex(File.read(file),{:level=>@level,:listings=>@listings})
+      puts kill_head_tableofcontents(bare_doc)
+    end
+\end{lstlisting}
+\paragraph{kill\_head\_line}
+kill\_head\_lineで付録(bare\_text)にtocが含まれている場合は削除．
+\begin{lstlisting}[style=customRuby]
+    def kill_head_tableofcontents(text)
+      text.gsub!(/^\\tableofcontents/,'')
+    end
+\end{lstlisting}
+\paragraph{mod\_abstract}
+mod\_abstractで\verb|\section{abstract}|で書かれた内容をabstract環境へ移行する．一行づつの処理は有限状態マシン的に処理するのがいいらしい(Ruby Best Practice, p.112)．一旦contentとabstractを分けて，その後，tableofcontentの前にabstractを挿入している．delete\_at(0)は一行目に\verb|\section{【abstract】}|が存在するため．
+\begin{lstlisting}[style=customRuby]
+# convert section to abstract
+    def mod_abstract(text)
+      abstract,section = [],[]
+      content = ""
+      text.split("\n").each do |line|
+        case line
+        when /^\\section(.+)/
+          section.push $1
+        end
+
+        case section[-1]
+        when /.+abstract.+/
+          abstract << line+"\n"
+        when /.+概要.+/
+          abstract << line+"\n"
+        else
+          content << line+"\n"
+        end
+      end
+      abstract.delete_at(0)
+      content.gsub!(/\\tableofcontents/){|text|
+        tt="\n\\abstract\{\n#{abstract.join}\}\n\\tableofcontents"
+      }
+      return content
+    end
+\end{lstlisting}

data/latexes/hiki2latex_init.tex

@@ -0,0 +1,103 @@
+
+\subsubsection{【変更作業の手順】}\begin{itemize}
+\item hikiをhtmlに変換するhikidoc.rbに加えていく形で変更
+\item hikidocについて調べよ(澄田の宿題）
+\end{itemize}\begin{lstlisting}[style=customRuby]
+bob% diff hikidoc.rb master-hikidoc/lib/hikidoc.rb 
+39d38
+< require './hiki2latex.rb'
+58,61d56
+<   def HikiDoc.to_latex(src, options = {})
+<     new(LatexOutput.new(""), options).compile(src)
+<   end
+< 
+916,917c911
+< #  puts HikiDoc.to_html(ARGF.read(nil))
+<   puts HikiDoc.to_latex(ARGF.read(nil))
+---
+>   puts HikiDoc.to_html(ARGF.read(nil))
+\end{lstlisting}\begin{itemize}
+\item hiki2latex.rbに変更を加えていく．
+\end{itemize}
+\subsubsection{【設計】}
+\paragraph{【maketitleの挿入】}
+latex formatに仕込む際にテキストの順序が前後するコマンドが幾つかある．
+\\maketitleの前に置かれた，
+\begin{itemize}
+\item title
+\item author
+\end{itemize}
+である．これらはheadersとしてtext部と別に返すことも可能である．
+具体的には，
+
+\begin{table}[htbp]\begin{center}
+\caption{}
+\begin{tabular}{lll}
+\hline
+to\_html   &*fを返す  \\ \hline
+to\_latex   &*fと*headを返す．  \\
+\hline
+\end{tabular}
+\label{default}
+\end{center}\end{table}
+%for inserting separate lines, use \hline, \cline{2-3} etc.
+
+なおto\_htmlとの互換性を維持するため*headを後に返すようにしている．
+
+しかし，この部分は，to\_htmlとの整合性を考えるとto\_latexで処理してしまった方がよい．
+そこで，
+\begin{lstlisting}[style=customRuby]
+def finish
+  @f.string
+end
+\end{lstlisting}
+となっているのを，
+\begin{lstlisting}[style=customRuby]
+  def finish
+    if @head != "" then
+      @head << "\\maketitle\n"
+      return @head+@f
+    else
+      return @f
+    end
+  end
+\end{lstlisting}
+とした．
+
+\subsubsection{【sample】}\begin{itemize}
+\item \verb|Jihou15|
+\end{itemize}
+\subsubsection{【pdfの貼り込み】}
+pdfpagesを使おうとすると
+\begin{quote}\begin{verbatim}
+/usr/local/texlive/2015/texmf-dist/tex/latex/pdfpages/pdfpages.sty:70: LaTeX Er
+ror: Missing \begin{document}.
+
+See the LaTeX manual or LaTeX Companion for explanation.
+Type  H <return>  for immediate help.
+ ...                                              
+                                                  
+l.70 \input{pp\AM@driver.def}
+\end{verbatim}\end{quote}
+というエラーが出る．この解決法がわからず，incudegraphicsで対応．
+\begin{quote}\begin{verbatim}
+¥documentclass{jsarticle}
+¥usepackage[dvipdfmx,hiresbb]{graphicx}
+¥begin{document}
+¥includegraphics[width=5cm]{sample.pdf}
+¥end{document}
+
+の4行目を
+¥includegraphics[page=3,width=5cm]{sample.pdf}
+とすれば、
+
+普通に３ページ目の画像を使うことができました。
+
+美文書5版のCD-ROMから普通にインストールした TeXShopの環境です。
+
+つまり、何も（といっても、同書 P114 にあるように、
+ --shell--escape--commands=extractbb 
+をTeXShop環境設定の「内部設定」タブ　pdfTex のLatexのオプションとして付け加えています。）特別なことをせずに、ページ指定をするだけで、できてしまいました。
+
+次の、美文書の版には、ページ設定についても解説していただくといいかも知れません。＞奥村先生お願いします。
+\end{verbatim}\end{quote}

data/latexes/hiki2latex_listings.tex

@@ -0,0 +1,106 @@
+\subsubsection{【概要】}
+latexのlistingsスタイルを使って，source codeの色付き表示が可能に．
+
+\subsubsection{【hiki2latexの変更】}
+hikidoc2texで使われているのを参照して，
+\begin{lstlisting}[style=customRuby]
+  def block_preformatted(str, info)
+    if (@listings==true and info!=nil) then
+      style='customRuby' if info=='ruby'
+      style='customCsh' if (info=='tcsh' or info=='csh')
+      style='customTeX' if info=='tex'
+      style='customJava' if info=='java'
+      preformatted_with_style(str,style)
+    else
+      preformatted(text(str))
+    end
+  end
+
+  def preformatted(str)
+    @f.slice!(-1)
+    @f << "\\begin{quote}\\begin{verbatim}\n"
+    @f << str+"\n"
+    @f << "\\end{verbatim}\\end{quote}\n"
+  end
+
+  def preformatted_with_style(str,style)
+    @f.slice!(-1)
+    @f << "\\begin{lstlisting}[style=#{style}]\n"
+    @f << str+"\n"
+    @f << "\\end{lstlisting}\n"
+  end
+\end{lstlisting}
+opt周りは，
+\begin{lstlisting}[style=customRuby]
+        opt.on('--listings', 'use listings.sty for preformat with style.') {@listings=true }
+\end{lstlisting}
+としている．これをHikiDocへ渡す時は，
+\begin{lstlisting}[style=customRuby]
+    def plain_doc(file)
+      if @listings==true then
+        puts listings_preamble
+      elsif @pre==nil then
+        puts "\\documentclass[12pt,a4paper]{jsarticle}"
+        puts "\\usepackage[dvipdfmx]{graphicx}"
+      else
+        puts File.read(@pre)
+      end
+      puts "\\begin{document}"
+      puts File.read(@head) if @head!=nil
+      puts HikiDoc.to_latex(File.read(file),{:listings=>@listings})
+      puts File.read(@post) if @post!=nil
+      puts "\\end{document}"
+    end
+\end{lstlisting}
+後ろのoptions={}の中にhashで登録している．texのstyleはlisting\_preambleで打ち出すようにしている．
+
+listingsの設定は以下の通り．
+\begin{lstlisting}[style=customTeX]
+\documentclass[10pt,a4paper]{jsarticle}
+\usepackage[dvipdfmx]{graphicx}
+\usepackage[dvipdfmx]{color}
+\usepackage{listings}
+% to use japanese correctly, install jlistings.
+\lstset{
+  basicstyle={\small\ttfamily},
+  identifierstyle={\small},
+  commentstyle={\small\itshape\color{red}},
+  keywordstyle={\small\bfseries\color{cyan}},
+  ndkeywordstyle={\small},
+  stringstyle={\small\color{blue}},
+  frame={tb},
+  breaklines=true,
+  numbers=left,
+  numberstyle={\scriptsize},
+  stepnumber=1,
+  numbersep=1zw,
+  xrightmargin=0zw,
+  xleftmargin=3zw,
+  lineskip=-0.5ex
+}
+\lstdefinestyle{customCsh}{
+  language={csh},
+  numbers=none,
+}
+\lstdefinestyle{customRuby}{
+  language={ruby},
+  numbers=left,
+}
+\lstdefinestyle{customTex}{
+  language={tex},
+  numbers=none,
+}
+\lstdefinestyle{customJava}{
+  language={java},
+  numbers=left,
+}
+\end{lstlisting}\begin{quote}\begin{verbatim}
+\begin{lstlisting}[style=customRuby]
+  def block_preformatted(str, info)
+    if (@listings==true and info!=nil) then
+      style='customRuby' if info=='ruby'
+      style='customCsh' if (info=='tcsh' or info=='csh')
+      style='customTeX' if info=='tex'
+...
+\end{lstlisting}
+\end{verbatim}\end{quote}