hiki2latex 0.9.11 → 0.9.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: bb8c1fa1c37fd149c824756bd2dc02122c4b60f8
-  data.tar.gz: 6da596d8344c2e70a979ca4a2ceb00c2615b3fff
+  metadata.gz: 12076d5d0ba9927aa5c90cf3ca76272ecc0540c9
+  data.tar.gz: e6e148da375fdc48d3a083554b07d809fd026d72
 SHA512:
-  metadata.gz: f27211c548971a71452b268cbe379011ba1192acdf2faff1ce19eea5771c08535697e836906eb9b9de10b46ea82caf5cc050a1970904381c251bde46f2183649
-  data.tar.gz: 0057a9233740483c5edf0291c2462795f197b902f3d3def42d426501b08587eb2449575a1e578fca5b75eca493eb54522e1894385f8c939127dabe8831cdc180
+  metadata.gz: 27e6493c92a853626cc67858f3b7e70035272de05c82c3758a2c832725f82fd7a6f863376f8690e6a3b3932852afb173dd261659cfb61f0ab52d9d1349092e0a
+  data.tar.gz: ed43a50306c7a9af6fed161e5e53cd973feb8c352ebae7290b6ca40ea0bc5aae13edeb767bfe449043761395cc444b79ea1609fd8ed26d3b9d7ad3cb04d38f11

data/#Rakefile#

@@ -0,0 +1,42 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+require "rake/testtask"
+require 'yard'
+require 'systemu'
+
+#task :default => :test
+task :default do
+  system 'rake -T'
+end
+
+
+desc "make documents by yard"
+task :yard do
+  system "hiki2md docs/readme.hiki > docs/README.en.md"
+  system "hiki2md docs/readme.ja.hiki > docs/README.ja.md"
+  YARD::Rake::YardocTask.new
+end
+
+RSpec::Core::RakeTask.new(:spec)
+
+desc "all procedure for release."
+task :update =>[:setenv] do
+  system 'emacs ./lib/hiki2latex/version.rb'
+  system 'git add -A'
+  system 'git commit'
+  system 'git push -u origin master'
+  system 'bundle exec rake release'
+end
+
+desc "setenv for release from Kwansei gakuin."
+task :setenv do
+#  status, stdout, stderr  = systemu "scselect \| grep \'\*\' |grep KG"
+#  puts stdout
+#  p stdout != nil
+#  if stdout != nil then
+    p command='setenv HTTP_PROXY http://proxy.ksc.kwansei.ac.jp:8080'
+    system command
+    p command='setenv HTTPS_PROXY http://proxy.ksc.kwansei.ac.jp:8080'
+    system command
+#  end
+end

data/#hiki2latex.gemspec#

@@ -0,0 +1,42 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'hiki2latex/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "hiki2latex"
+  spec.version       = Hiki2latex::VERSION
+  spec.authors       = ["Shigeto R. Nishitani"]
+  spec.email         = ["shigeto_nishitani@me.com"]
+
+  spec.summary       = %q{convert hikidoc text to latex format.}
+  spec.description   = <<-EOF
+   hiki2latex is a format converter from hikidoc to latex, using hikidoc.
+EOF
+  spec.homepage      = 'https://github.com/daddygongon/hiki2latex'
+  spec.license       = "MIT"
+
+  # Prevent pushing this gem to RubyGems.org by setting 'allowed_push_host', or
+  # delete this section to allow pushing this gem to any host.
+#  if spec.respond_to?(:metadata)
+#    spec.metadata['allowed_push_host'] = "TODO: Set to 'http://mygemserver.com'"
+#  else
+#    raise "RubyGems 2.0 or newer is required to protect against public gem pushes."
+#  end
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.required_ruby_version = '>= 1.8.6'
+
+  spec.add_development_dependency "bundler", "~> 1.10"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "yard", "~> 0.8"
+  spec.add_development_dependency "test-unit"
+  spec.add_development_dependency "systemu"
+  spec.add_development_dependency "hiki2md"
+  spec.add_runtime_dependency "hikidoc","~>0.1.0"
+end

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.yardopts

@@ -0,0 +1,4 @@
+-
+docs/README.en.md
+docs/README.ja.md
+

data/{README.md → README.en.md}

@@ -1,26 +1,21 @@
 # Hiki2latex
-
 convert hikidoc text to latex format.
 
 ## Installation
-
 Add this line to your application's Gemfile:
-
 ```ruby
 gem 'hiki2latex'
-
 ```
-
 And then execute:
-
-    $ bundle 
-
+```
+$ bundle
+```
 Or install it yourself as:
-
-    $ gem install hiki2latex
+```
+$ gem install hiki2latex
+```
 
 ## Usage
-
 Use as a gem library:
 ```ruby
     require 'hiki2latex'
@@ -30,33 +25,34 @@ Use as a gem library:
 
 or as a command line tool:
 
-```csh
-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.
+<dl>
+<dt>Usage</dt><dd> hiki2latex [options] FILE</dd>
+</dl>
+
 
+| option | operation|
+|:----|:----|
+|    -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.|
+
+```
 > hiki2latex --pre PRICM_preamble.tex --post biblio.tex -p test.hiki > test.tex
 > hiki2latex --listings --post post.tex -p ./test.hiki > test.tex
 ```
 
 ## Development
-
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment. Run `bundle exec hiki2latex` to use the gem in this directory, ignoring other installed copies of this gem.
 
 To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
 ## Contributing
-
 Bug reports and pull requests are welcome on GitHub at https://github.com/daddygongon/hiki2latex. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](contributor-covenant.org) code of conduct.
 
-
 ## License
-
 The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
-

data/README.ja.md

@@ -0,0 +1,131 @@
+# 【概要】
+hiki formatで書かれた文章を，latex formatに変換する
+# 【documents】
+- ![](http://rubygems.org/gems/hiki2latex)
+
+# 【使用法】
+```bash
+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.
+```
+- より詳細な使用法は，![](hiki2latex_gemizing)にある．
+- 西谷研の内部で利用するときに特化したマニュアルは[こちら](hiki2latex_manual)．
+
+## sample
+幾つかのサンプルを以下に示す．
+### caption:hiki2latexにより作成されたpdfファイトとその元ネタ．
+
+|ソース(hiki表示)|pdf(latex変換後)|
+|:----|:----|
+|[[Shunkuntype]]|[[Shunkuntype]]のレポート|
+|[[LPSO15研究会の例|LPSO15_fall_meeting_abst]]|{{attach_anchor(LPSO_abst.pdf)}}|
+|[[中間発表hand out例|AbstSample]]|{{attach_anchor(AbstSample.pdf)}}|
+|[[使っているformat集|DocumentFormatter_format_examples]]|
+
+
+# 【仕様】
+1. hikdoc.rbにwrap
+1. header部を独立して提供
+1. author, titleはheadに手を加えて提供
+1. 図はattach_viewを変換
+1. 表はそのまま表示
+  1. tableのmulti対応
+1. captionはheaderで提供
+1. citeは対応しない．
+1. graph, tableは[h]で提供．
+
+# 【具体的な使用例rakefile】
+具体的な使用例として![](Shunkuntype_report)を作成した時のRakefile.rbを示す．何度も書き直す時は，このようにして自動化すべき．
+```ruby
+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
+```
+本文(Shunkuntype_report.tex)と付録(targets.texs)がある．付録は'-l 2 -b'によってsubsectionからのtitle levelにしてbare modeで作っている．post.texにpostで付け加えるtex部を指定して，appendixをつけている．
+
+# 【code documents】
+[rdoc](http://nishitani0.kwansei.ac.jp/~bob/nishitani0/rdocs/hiki2latex/index.html)に置いといたけど，ruby gemsやgithubに置けば不要となる．
+# 【変更履歴，内容】
+変更履歴，内容を表に示す．15/8月期で基本開発．16/2月期にgem化．
+## caption:変更履歴，内容
+
+|memo |date|hiki|
+|:----|:----|:----|
+|hikidoc.rbからhiki2latex.rb|15/8/4|[[hiki2latex_init]]|
+|hiki2latex.rbひな形作成|15/8/5|
+|@fをStringIOからStringへ|15/8/5|
+|graph+caption|15/8/6|[[LPSO15_fall_meeting_abst]]|
+|math|15/8/7| [[hiki2latex_math]]|
+|table| 15/8/8| [[hiki2latex_table]]|
+|under_score| 15/8/11 | [[hiki2latex_math]]|
+|gem化| 16/2/13 | [[hiki2latex_gemizing]]|
+|listings| 16/2/16 | [[hiki2latex_listings]]|
+
+
+# 【開発メモ】
+## 制限事項
+- title中へuriの埋め込みが未対応．
+  - uriのverbがlatexのtitle内で使えないため．
+## 【 保留項目】
+1. includegraphicsの自動提供
+  1. hikiに置かれているgraphは劣化版なんでそれをいじるのはあまり筋がよろしくない．
+  1. epsならできるかも．hikeのattach_viewでサイズをどういじっているか．．．
+1. underbar(_)がlatexでは全て引っかかる．escapeする？-> 対応済み ![](hiki2latex_math)
+  1. snake表記はrubyではfile名や変数名に頻繁に使われるので対処が必要かも．
+
+## 【math】
+＄＄での変換がうまくいかない．
+```
+hikiconf.rb
+```
+での設定を
+```
+#@style           = 'default'
+@style           = 'math'
+```
+としたらhikiからエラーは出なくなったが．まだまだ．．．．
+
+## 【user def】
+```
+\def\Vec#1{\mbox{\boldmath $#1$}}
+```
+はpreambleに置くことが推奨されているが，実際は，使用するまでに定義すればいい．preambleをいじるようになるころには，latexについての十分な経験があると思われるので，hiki2latexではいじらない．ちょこっと必要ならhiki本文中に埋め込むべし．今の仕様では，
+```ruby
+  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
+```
+とするのが正しそうなので，無理に入れていない．将来はpreambleを保持するような拡張機能(option)が必要かもしれない．それは，「原典一つ主義」で，hikiを原典とするか，latexを原典とするかの選択が迫られたとき．
+  - 追記(2015/02/17) いい考察だ．解はでてないが今はhiki2latexに埋め込んで，それらの仕様をできるだけ吸収しようとしている．

data/Rakefile

@@ -10,18 +10,15 @@ task :default do
 end
 
 
-YARD::Rake::YardocTask.new
+desc "make documents by yard"
+task :yard do
+  system "hiki2md docs/readme.hiki > docs/README.en.md"
+  system "hiki2md docs/readme.ja.hiki > docs/README.ja.md"
+  YARD::Rake::YardocTask.new
+end
 
 RSpec::Core::RakeTask.new(:spec)
 
-desc "test using unit/test"
-Rake::TestTask.new(:test) do |test|
-  test.libs << "test"
-  test.libs << "lib"
-  test.test_files = FileList['test/**/*_test.rb']
-  test.verbose = true
-end
-
 desc "all procedure for release."
 task :update =>[:setenv] do
   system 'emacs ./lib/hiki2latex/version.rb'

data/docs/README.en.md

@@ -0,0 +1,58 @@
+# Hiki2latex
+convert hikidoc text to latex format.
+
+## Installation
+Add this line to your application's Gemfile:
+```ruby
+gem 'hiki2latex'
+```
+And then execute:
+```
+$ bundle
+```
+Or install it yourself as:
+```
+$ gem install hiki2latex
+```
+
+## Usage
+Use as a gem library:
+```ruby
+    require 'hiki2latex'
+    
+    puts HikiDoc.to_latex(File.read(ARGV[0]),{:level=>@level,:listings=>@listings})
+```
+
+or as a command line tool:
+
+<dl>
+<dt>Usage</dt><dd> hiki2latex [options] FILE</dd>
+</dl>
+
+
+| option | operation|
+|:----|:----|
+|    -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.|
+
+```
+> hiki2latex --pre PRICM_preamble.tex --post biblio.tex -p test.hiki > test.tex
+> hiki2latex --listings --post post.tex -p ./test.hiki > test.tex
+```
+
+## Development
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment. Run `bundle exec hiki2latex` to use the gem in this directory, ignoring other installed copies of this gem.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+Bug reports and pull requests are welcome on GitHub at https://github.com/daddygongon/hiki2latex. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](contributor-covenant.org) code of conduct.
+
+## License
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/docs/README.ja.md

@@ -0,0 +1,131 @@
+# 【概要】
+hiki formatで書かれた文章を，latex formatに変換する
+# 【documents】
+- ![](http://rubygems.org/gems/hiki2latex)
+
+# 【使用法】
+```bash
+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.
+```
+- より詳細な使用法は，![](hiki2latex_gemizing)にある．
+- 西谷研の内部で利用するときに特化したマニュアルは[こちら](hiki2latex_manual)．
+
+## sample
+幾つかのサンプルを以下に示す．
+### caption:hiki2latexにより作成されたpdfファイトとその元ネタ．
+
+|ソース(hiki表示)|pdf(latex変換後)|
+|:----|:----|
+|[[Shunkuntype]]|[[Shunkuntype]]のレポート|
+|[[LPSO15研究会の例|LPSO15_fall_meeting_abst]]|{{attach_anchor(LPSO_abst.pdf)}}|
+|[[中間発表hand out例|AbstSample]]|{{attach_anchor(AbstSample.pdf)}}|
+|[[使っているformat集|DocumentFormatter_format_examples]]|
+
+
+# 【仕様】
+1. hikdoc.rbにwrap
+1. header部を独立して提供
+1. author, titleはheadに手を加えて提供
+1. 図はattach_viewを変換
+1. 表はそのまま表示
+  1. tableのmulti対応
+1. captionはheaderで提供
+1. citeは対応しない．
+1. graph, tableは[h]で提供．
+
+# 【具体的な使用例rakefile】
+具体的な使用例として![](Shunkuntype_report)を作成した時のRakefile.rbを示す．何度も書き直す時は，このようにして自動化すべき．
+```ruby
+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
+```
+本文(Shunkuntype_report.tex)と付録(targets.texs)がある．付録は'-l 2 -b'によってsubsectionからのtitle levelにしてbare modeで作っている．post.texにpostで付け加えるtex部を指定して，appendixをつけている．
+
+# 【code documents】
+[rdoc](http://nishitani0.kwansei.ac.jp/~bob/nishitani0/rdocs/hiki2latex/index.html)に置いといたけど，ruby gemsやgithubに置けば不要となる．
+# 【変更履歴，内容】
+変更履歴，内容を表に示す．15/8月期で基本開発．16/2月期にgem化．
+## caption:変更履歴，内容
+
+|memo |date|hiki|
+|:----|:----|:----|
+|hikidoc.rbからhiki2latex.rb|15/8/4|[[hiki2latex_init]]|
+|hiki2latex.rbひな形作成|15/8/5|
+|@fをStringIOからStringへ|15/8/5|
+|graph+caption|15/8/6|[[LPSO15_fall_meeting_abst]]|
+|math|15/8/7| [[hiki2latex_math]]|
+|table| 15/8/8| [[hiki2latex_table]]|
+|under_score| 15/8/11 | [[hiki2latex_math]]|
+|gem化| 16/2/13 | [[hiki2latex_gemizing]]|
+|listings| 16/2/16 | [[hiki2latex_listings]]|
+
+
+# 【開発メモ】
+## 制限事項
+- title中へuriの埋め込みが未対応．
+  - uriのverbがlatexのtitle内で使えないため．
+## 【 保留項目】
+1. includegraphicsの自動提供
+  1. hikiに置かれているgraphは劣化版なんでそれをいじるのはあまり筋がよろしくない．
+  1. epsならできるかも．hikeのattach_viewでサイズをどういじっているか．．．
+1. underbar(_)がlatexでは全て引っかかる．escapeする？-> 対応済み ![](hiki2latex_math)
+  1. snake表記はrubyではfile名や変数名に頻繁に使われるので対処が必要かも．
+
+## 【math】
+＄＄での変換がうまくいかない．
+```
+hikiconf.rb
+```
+での設定を
+```
+#@style           = 'default'
+@style           = 'math'
+```
+としたらhikiからエラーは出なくなったが．まだまだ．．．．
+
+## 【user def】
+```
+\def\Vec#1{\mbox{\boldmath $#1$}}
+```
+はpreambleに置くことが推奨されているが，実際は，使用するまでに定義すればいい．preambleをいじるようになるころには，latexについての十分な経験があると思われるので，hiki2latexではいじらない．ちょこっと必要ならhiki本文中に埋め込むべし．今の仕様では，
+```ruby
+  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
+```
+とするのが正しそうなので，無理に入れていない．将来はpreambleを保持するような拡張機能(option)が必要かもしれない．それは，「原典一つ主義」で，hikiを原典とするか，latexを原典とするかの選択が迫られたとき．
+  - 追記(2015/02/17) いい考察だ．解はでてないが今はhiki2latexに埋め込んで，それらの仕様をできるだけ吸収しようとしている．

data/docs/readme.hiki

@@ -0,0 +1,48 @@
+! Hiki2latex
+convert hikidoc text to latex format.
+
+!! Installation
+Add this line to your application's Gemfile:
+<<< ruby
+gem 'hiki2latex'
+>>>
+And then execute:
+    $ bundle 
+Or install it yourself as:
+    $ gem install hiki2latex
+
+!! Usage
+Use as a gem library:
+<<<ruby
+    require 'hiki2latex'
+    
+    puts HikiDoc.to_latex(File.read(ARGV[0]),{:level=>@level,:listings=>@listings})
+>>>
+
+or as a command line tool:
+
+:Usage: hiki2latex [options] FILE
+
+|| option || operation
+||    -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.
+ > hiki2latex --pre PRICM_preamble.tex --post biblio.tex -p test.hiki > test.tex
+ > hiki2latex --listings --post post.tex -p ./test.hiki > test.tex
+
+!! Development
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment. Run `bundle exec hiki2latex` to use the gem in this directory, ignoring other installed copies of this gem.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+!! Contributing
+Bug reports and pull requests are welcome on GitHub at https://github.com/daddygongon/hiki2latex. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](contributor-covenant.org) code of conduct.
+
+!! License
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+

data/docs/readme.ja.hiki

@@ -0,0 +1,120 @@
+{{toc}}
+!【概要】
+hiki formatで書かれた文章を，latex formatに変換する
+!【documents】
+* [[http://rubygems.org/gems/hiki2latex]]
+
+!【使用法】
+<<< bash
+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.
+>>>
+*より詳細な使用法は，[[hiki2latex_gemizing]]にある．
+*西谷研の内部で利用するときに特化したマニュアルは[[こちら|hiki2latex_manual]]．
+
+!!sample
+幾つかのサンプルを以下に示す．
+!!!caption:hiki2latexにより作成されたpdfファイトとその元ネタ．
+||ソース(hiki表示)||pdf(latex変換後)
+||[[Shunkuntype]]||[[Shunkuntype]]のレポート
+||[[LPSO15研究会の例|LPSO15_fall_meeting_abst]]||{{attach_anchor(LPSO_abst.pdf)}}
+||[[中間発表hand out例|AbstSample]]||{{attach_anchor(AbstSample.pdf)}}
+||[[使っているformat集|DocumentFormatter_format_examples]]||
+
+!【仕様】
+# hikdoc.rbにwrap
+# header部を独立して提供
+# author, titleはheadに手を加えて提供
+# 図はattach_viewを変換
+# 表はそのまま表示
+## tableのmulti対応
+# captionはheaderで提供
+# citeは対応しない．
+# graph, tableは[h]で提供．
+
+!【具体的な使用例rakefile】
+具体的な使用例として[[Shunkuntype_report]]を作成した時のRakefile.rbを示す．何度も書き直す時は，このようにして自動化すべき．
+<<< ruby
+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
+>>>
+本文(Shunkuntype_report.tex)と付録(targets.texs)がある．付録は'-l 2 -b'によってsubsectionからのtitle levelにしてbare modeで作っている．post.texにpostで付け加えるtex部を指定して，appendixをつけている．
+
+!【code documents】
+[[rdoc|http://nishitani0.kwansei.ac.jp/~bob/nishitani0/rdocs/hiki2latex/index.html]]に置いといたけど，ruby gemsやgithubに置けば不要となる．
+!【変更履歴，内容】
+変更履歴，内容を表に示す．15/8月期で基本開発．16/2月期にgem化．
+!!caption:変更履歴，内容
+||memo ||date||hiki
+||hikidoc.rbからhiki2latex.rb||15/8/4||[[hiki2latex_init]]
+||hiki2latex.rbひな形作成||15/8/5
+||@fをStringIOからStringへ||15/8/5
+||graph+caption||15/8/6||[[LPSO15_fall_meeting_abst]]
+||math||15/8/7|| [[hiki2latex_math]]
+||table|| 15/8/8|| [[hiki2latex_table]]
+||under_score|| 15/8/11 || [[hiki2latex_math]]
+||gem化|| 16/2/13 || [[hiki2latex_gemizing]]
+||listings|| 16/2/16 || [[hiki2latex_listings]]
+
+!【開発メモ】
+!!制限事項
+* title中へuriの埋め込みが未対応．
+** uriのverbがlatexのtitle内で使えないため．
+!!【 保留項目】
+# includegraphicsの自動提供
+## hikiに置かれているgraphは劣化版なんでそれをいじるのはあまり筋がよろしくない．
+## epsならできるかも．hikeのattach_viewでサイズをどういじっているか．．．
+# underbar(_)がlatexでは全て引っかかる．escapeする？-> 対応済み [[hiki2latex_math]]
+## snake表記はrubyではfile名や変数名に頻繁に使われるので対処が必要かも．
+
+!! 【math】
+＄＄での変換がうまくいかない．
+ hikiconf.rb
+での設定を
+ #@style           = 'default'
+ @style           = 'math'
+としたらhikiからエラーは出なくなったが．まだまだ．．．．
+
+!!【user def】
+ \def\Vec#1{\mbox{\boldmath $#1$}}  
+はpreambleに置くことが推奨されているが，実際は，使用するまでに定義すればいい．preambleをいじるようになるころには，latexについての十分な経験があると思われるので，hiki2latexではいじらない．ちょこっと必要ならhiki本文中に埋め込むべし．今の仕様では，
+<<< ruby
+  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
+>>>
+とするのが正しそうなので，無理に入れていない．将来はpreambleを保持するような拡張機能(option)が必要かもしれない．それは，「原典一つ主義」で，hikiを原典とするか，latexを原典とするかの選択が迫られたとき．
+**追記(2015/02/17) いい考察だ．解はでてないが今はhiki2latexに埋め込んで，それらの仕様をできるだけ吸収しようとしている．

data/hiki2latex.gemspec

@@ -37,5 +37,6 @@ EOF
   spec.add_development_dependency "yard", "~> 0.8"
   spec.add_development_dependency "test-unit"
   spec.add_development_dependency "systemu"
+  spec.add_development_dependency "hiki2md"
   spec.add_runtime_dependency "hikidoc","~>0.1.0"
 end

data/lib/hiki2latex/hiki2latex.rb

@@ -170,8 +170,10 @@ class LatexOutput
     @f << "#{lines.join("\n")}\n\n"
   end
   def blockquote_open()
+    @f << "\\begin{quotation}\n"
   end
   def blockquote_close()
+    @f << "\\end{quotation}\n"
   end
 
   def del(item)
@@ -179,11 +181,12 @@ class LatexOutput
   end
 
   def em(item)
-    @f << "\\textbf\{#{item}\}"
+#    @f << "\\textbf\{#{item}\}"
+    @f << "#{item}"
   end
 
   def strong(item)
-    @f << "\\textbf\{#{item}\}"
+#    @f << "\\textbf\{#{item}\}"
   end
 
   def block_preformatted(str, info)

data/lib/hiki2latex/version.rb

@@ -1,3 +1,3 @@
 module Hiki2latex
-  VERSION = "0.9.11"
+  VERSION = "0.9.12"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hiki2latex
 version: !ruby/object:Gem::Version
-  version: 0.9.11
+  version: 0.9.12
 platform: ruby
 authors:
 - Shigeto R. Nishitani
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-03-08 00:00:00.000000000 Z
+date: 2016-05-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -94,6 +94,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: hiki2md
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: hikidoc
   requirement: !ruby/object:Gem::Requirement
@@ -117,18 +131,26 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- "#Rakefile#"
+- "#hiki2latex.gemspec#"
 - ".gitignore"
+- ".rspec"
 - ".travis.yml"
+- ".yardopts"
 - CODE_OF_CONDUCT.md
 - Gemfile
 - LICENSE.txt
-- README.md
+- README.en.md
+- README.ja.md
 - Rakefile
 - bin/console
 - bin/setup
+- docs/README.en.md
+- docs/README.ja.md
+- docs/readme.hiki
+- docs/readme.ja.hiki
 - exe/hiki2latex
 - hiki2latex.gemspec
-- lib/#hiki2latex.rb#
 - lib/hiki2latex.rb
 - lib/hiki2latex/hiki2latex.rb
 - lib/hiki2latex/version.rb

data/lib/#hiki2latex.rb#

@@ -1,145 +0,0 @@
-# -*- coding: utf-8 -*-
-require 'optparse'
-require "hiki2latex/version"
-#require "hiki2latex/hikidoc"
-require "hiki2latex/hiki2latex"
-require 'pp'
-
-module Hiki2latex
-  class Command
-
-    def self.run(argv=[])
-      new(argv).execute
-    end
-
-    def initialize(argv=[])
-      @argv = argv
-      @pre=@head=@post=nil
-      @listings=false
-    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
-
-    def kill_head_tableofcontents(text)
-      text.gsub!(/^\\tableofcontents/,'')
-      return text
-    end
-
-    # convert section to abstract in the plain text
-    def mod_abstract(text)
-#      return text
-      abstract,section = [],[]
-      content = ""
-      text.split("\n").each do |line|
-        case line
-        when /^\\section(.+)/
-          section.push $1
-        end
-#        p section[-1]
-        case section[-1]
-        when /\{abstract\}/, /\{���abstract���\}/
-          abstract << line+"\n"
-        when /\{������\}/, /\{��ڒ����ג��\}/
-          abstract << line+"\n"
-        else
-          content << line+"\n"
-        end
-      end
-#      p abstract
-      if abstract.size>1 then
-        abstract.delete_at(0)
-        content.gsub!(/\\tableofcontents/){|text|
-          tt="\n\\abstract\{\n#{abstract.join}\}\n\\tableofcontents"
-        }
-      end
-      return content
-    end
-
-    def listings_preamble
-      str = <<"EOS"
-\\documentclass[12pt,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,
-}
-EOS
-    end
-
-  end
-end
-