my_help 0.4.5 → 0.5.0

data/docs/bob/emacs_help.ipynb

@@ -0,0 +1,133 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "toc": "true"
+   },
+   "source": [
+    "# Table of Contents\n",
+    " <p><div class=\"lev1 toc-item\"><a href=\"#emacs_help\" data-toc-modified-id=\"emacs_help-1\"><span class=\"toc-item-num\">1&nbsp;&nbsp;</span>emacs_help</a></div>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# emacs_help\n",
+    "\n",
+    "```\n",
+    "  emacsのキーバインド\n",
+    "  \n",
+    "特殊キー操作\n",
+    "    c-f, controlキーを押しながら    'f'\n",
+    "    M-f, escキーを押した後一度離して'f'\n",
+    "      操作の中断c-g, 操作の取り消し(Undo) c-x u\n",
+    "       cc by Shigeto R. Nishitani, 2016\n",
+    "カーソル移動cursor\n",
+    "  c-f, move Forwrard,    前or右へ\n",
+    "  c-b, move Backwrard,   後or左へ\n",
+    "  c-a, go Ahead of line, 行頭へ\n",
+    "  c-e, go End of line,   行末へ\n",
+    "  c-n, move Next line,   次行へ\n",
+    "  c-p, move Previous line, 前行へ\n",
+    "ページ移動page\n",
+    "  c-v, move Vertical,          次のページへ\n",
+    "  M-v, move reversive Vertical,前のページへ\n",
+    "  c-l, centerise Line,       現在行を中心に\n",
+    "  M-<, move Top of file,    ファイルの先頭へ\n",
+    "  M->, move Bottom of file, ファイルの最後尾へ\n",
+    "ファイル操作file\n",
+    "  c-x c-f, Find file, ファイルを開く\n",
+    "  c-x c-s, Save file, ファイルを保存\n",
+    "  c-x c-w, Write file NAME, ファイルを別名で書き込む\n",
+    "編集操作edit\n",
+    "  c-d, Delete char, 一字削除\n",
+    "  c-k, Kill line,   一行抹消，カット\n",
+    "  c-y, Yank,        ペースト\n",
+    "  c-w, Kill region, 領域抹消，カット\n",
+    "  領域選択は，先頭or最後尾でc-spaceした後，最後尾or先頭へカーソル移動\n",
+    "  c-s, forward incremental Search WORD, 前へWORDを検索\n",
+    "  c-r, Reverse incremental search WORD, 後へWORDを検索\n",
+    "  M-x query-replace WORD1 <ret> WORD2：対話的置換(y or nで可否選択)\n",
+    "ウィンドウ操作window\n",
+    "  c-x 2, 2 windows, 二つに分割\n",
+    "  c-x 1, 1 windows, 一つに戻す\n",
+    "  c-x 3, 3rd window sep,縦線分割\n",
+    "  c-x o, Other windows, 次の画面へ移動\n",
+    "バッファー操作buffer(すでにopenしてemacsにバッファーされたfile)\n",
+    "  c-x b, show Buffer,   バッファのリスト\n",
+    "  c-x c-b, next Buffer, 次のバッファへ移動\n",
+    "終了操作quit\n",
+    "  c-x c-c, Quit emacs, ファイルを保存して終了\n",
+    "  c-z, suspend emacs,  一時停止，fgで復活\n",
+    "```"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {
+    "collapsed": true
+   },
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Ruby 2.2.2",
+   "language": "ruby",
+   "name": "ruby"
+  },
+  "language_info": {
+   "file_extension": ".rb",
+   "mimetype": "application/x-ruby",
+   "name": "ruby",
+   "version": "2.2.2"
+  },
+  "latex_envs": {
+   "LaTeX_envs_menu_present": true,
+   "autocomplete": true,
+   "bibliofile": "biblio.bib",
+   "cite_by": "apalike",
+   "current_citInitial": 1,
+   "eqLabelWithNumbers": true,
+   "eqNumInitial": 1,
+   "hotkeys": {
+    "equation": "Ctrl-E",
+    "itemize": "Ctrl-I"
+   },
+   "labels_anchors": false,
+   "latex_user_defs": false,
+   "report_style_numbering": false,
+   "user_envs_cfg": false
+  },
+  "toc": {
+   "colors": {
+    "hover_highlight": "#DAA520",
+    "navigate_num": "#000000",
+    "navigate_text": "#333333",
+    "running_highlight": "#FF0000",
+    "selected_highlight": "#FFD700",
+    "sidebar_border": "#EEEEEE",
+    "wrapper_background": "#FFFFFF"
+   },
+   "moveMenuLeft": true,
+   "nav_menu": {
+    "height": "31px",
+    "width": "253px"
+   },
+   "navigate_menu": true,
+   "number_sections": true,
+   "sideBar": true,
+   "threshold": 4,
+   "toc_cell": true,
+   "toc_section_display": "block",
+   "toc_window_display": true,
+   "widenNotebook": false
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

data/docs/bob/template_help.ipynb

@@ -0,0 +1,136 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "toc": "true"
+   },
+   "source": [
+    "# Table of Contents\n",
+    " <p><div class=\"lev1 toc-item\"><a href=\"#template_helpの出力結果\" data-toc-modified-id=\"template_helpの出力結果-1\"><span class=\"toc-item-num\">1&nbsp;&nbsp;</span>template_helpの出力結果</a></div><div class=\"lev1 toc-item\"><a href=\"#template_helpの中身\" data-toc-modified-id=\"template_helpの中身-2\"><span class=\"toc-item-num\">2&nbsp;&nbsp;</span>template_helpの中身</a></div>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# template_helpの出力結果\n",
+    "\n",
+    "``` ruby\n",
+    "bob% bundle exec exe/template_help --to_hiki\n",
+    "ヘルプのサンプル雛形.\n",
+    "headに常に表示される内容を記述.\n",
+    "---\n",
+    "<<<\n",
+    "  ヘルプのサンプル雛形.\n",
+    "  headに常に表示される内容を記述.\n",
+    "単元\n",
+    "  c-f, move Forwrard,    前or右へ\n",
+    "  フォーマットは自由です.\n",
+    "単元2\n",
+    "  c-f, move Forwrard,    前or右へ\n",
+    "  フォーマットは自由です.\n",
+    "```\n",
+    "\n",
+    "# template_helpの中身\n",
+    "helpの実態は~/.my_helpに保存されたYAML形式のfileです．書き方はコメントを参照ください．\n",
+    "\n",
+    "```ruby\n",
+    "---\n",
+    "#start header, which appears every time.\n",
+    ":head:         #never change\n",
+    "- ヘルプのサンプル雛形               #describe the contents breafly.\n",
+    "- \"  headに常に表示される内容を記述\" #head '- ' is necessary\n",
+    ":license:         #never change\n",
+    "- \"     cc by Shigeto R. Nishitani, 2016\"  #show licence\n",
+    "# start the first item\n",
+    ":item:         #change snake word\n",
+    "  :opts:          #never change\n",
+    "    :short: -i      #change short option\n",
+    "    :long: --item   #change long option\n",
+    "    :desc: 単元(item) #describe what for in help list\n",
+    "  :title: 単元  #describe what for in each help\n",
+    "  :cont:              #the following lines are appeared.\n",
+    "  - c-f, move Forwrard,    前or右へ  #top '  - ' are necessary for yaml format\n",
+    "  - フォーマットは自由です. \n",
+    "\n",
+    "# start the second item... and so on.\n",
+    ":item2: \n",
+    "  :opts: \n",
+    "    :short: -j\n",
+    "    :long: --item2\n",
+    "    :desc: 単元2(item2)\n",
+    "  :title: 単元2\n",
+    "  :cont:\n",
+    "  - c-f, move Forwrard,    前or右へ\n",
+    "  - フォーマットは自由です. \n",
+    "```\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {
+    "collapsed": true
+   },
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Ruby 2.2.2",
+   "language": "ruby",
+   "name": "ruby"
+  },
+  "language_info": {
+   "file_extension": ".rb",
+   "mimetype": "application/x-ruby",
+   "name": "ruby",
+   "version": "2.2.2"
+  },
+  "latex_envs": {
+   "LaTeX_envs_menu_present": true,
+   "autocomplete": true,
+   "bibliofile": "biblio.bib",
+   "cite_by": "apalike",
+   "current_citInitial": 1,
+   "eqLabelWithNumbers": true,
+   "eqNumInitial": 1,
+   "hotkeys": {
+    "equation": "Ctrl-E",
+    "itemize": "Ctrl-I"
+   },
+   "labels_anchors": false,
+   "latex_user_defs": false,
+   "report_style_numbering": false,
+   "user_envs_cfg": false
+  },
+  "toc": {
+   "colors": {
+    "hover_highlight": "#DAA520",
+    "navigate_num": "#000000",
+    "navigate_text": "#333333",
+    "running_highlight": "#FF0000",
+    "selected_highlight": "#FFD700",
+    "sidebar_border": "#EEEEEE",
+    "wrapper_background": "#FFFFFF"
+   },
+   "moveMenuLeft": true,
+   "nav_menu": {
+    "height": "48px",
+    "width": "253px"
+   },
+   "navigate_menu": true,
+   "number_sections": true,
+   "sideBar": true,
+   "threshold": 4,
+   "toc_cell": true,
+   "toc_section_display": "block",
+   "toc_window_display": true,
+   "widenNotebook": false
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

data/{my_help_nasu → docs/nasu}/Rakefile

@@ -1,7 +1,10 @@
+
 # -*- coding: utf-8 -*-
 require 'systemu'
 require 'tempfile'
 require 'colorize'
+require 'coderay'
+
 # -*- coding: utf-8 -*-
 begin
   $hiki_dir = File.readlines('./.hikirc')[0].chomp
@@ -34,7 +37,7 @@ task :reset_hiki do
   stdout.split("\n").each{|line|
     files << line.split(/\s+/)[-1]
   }
-  p r_files = files.reverse[0..-4]
+  r_files = files.reverse[0..-4]
   r_files.each{|file|
     print "remove #{file}[ynqlA]? ".red
     input=STDIN.gets.chomp
@@ -49,7 +52,7 @@ task :reset_hiki do
     when 'q'
       exit
     when 'A'
-      print "\nAre you sure?[Yn]"
+      print "\nAre you sure[Yn]? ".magenta
       input2 = STDIN.gets.chomp
       case input2
         when 'Y'
@@ -66,9 +69,11 @@ end
 desc "latex_dirのゴミを掃除"
 task :reset_latex_dir do
   system "mv latex_dir/head.tex ."
+  system "mv latex_dir/jlisting.sty ."
   system "rm -rf latex_dir"
   system "mkdir latex_dir"
   system "mv head.tex latex_dir/"
+  system "mv jlisting.sty latex_dir/"
   system "rake latex_all"
 end
 
@@ -80,14 +85,10 @@ task :mk_toc do
     if m=line.match(/\\contentsline \{(.+)\}\{\\numberline \{([\d|\.]+)\}(.+)\}\{\d+\}/)
       layer,sec_no,title=m[1],m[2],m[3]
       d = case m[1]
-          when 'section'
-            1
-          when 'subsection'
-            2
-          when 'subsubsection'
-            3
-          else
-            4
+          when 'section'; 1
+          when 'subsection'; 2
+          when 'subsubsection'; 3
+          else; 4
           end
       layer = "!"*d
       title.gsub!('\_','_')
@@ -101,7 +102,8 @@ end
 desc "FILE.hikiあるいはhikiファイルすべてを最新状態に更新"
 task :touch do
   if file=ARGV[1] 
-    p target = $basename+"_"+file.split('.')[0]
+    file_split=file.split(".")
+    p target = $basename==file_split[0] ? $basename : $basename+"_"+file_split[0]
     system "hiki -u #{target}"
   else
     p target = File.join($hiki_dir,'cache','attach',$basename)
@@ -109,17 +111,18 @@ task :touch do
     Dir.entries('.').each{|file|
       file_split=file.split(".")
       if file_split[1]=='hiki'
-        next if file_split[0]==$basename
-        p target = $basename+"_"+file_split[0]
+        p target = $basename==file_split[0] ? $basename : $basename+"_"+file_split[0]
         system "hiki -u #{target}"
       end
     }
   end
+  exit
 end
 
 desc "FILE.hikiあるいはhikiファイルをedtiorで開く"
 task :open do
-  if file=ARGV[1] 
+  if file=ARGV[1]
+    file += '.hiki' if file.split(".")[1]==nil
     system "open -a mi #{file}"
   else
     Dir.entries('.').each{|file|
@@ -143,6 +146,7 @@ task :latex_wrap => [:latex_base, :change_wrap] do
 end
 
 def latex_loop(entries,opts={})
+  check_bounding_box
   main_file=""
   entries.each{|file|
     options={:latex_all=>true}
@@ -183,20 +187,29 @@ end
 
 def check_bounding_box
 #  $bounding_box="0 0 442 432"
-  $bounding_box=" 0 0 737 453"
+#  $bounding_box=" 0 0 737 553"
+#  $fig_width="10"
+  $bounding_box=" 0 0 937 753"
+  $fig_width="12"
 end
 
 desc "すべてのhikiファイルをlatex変換"
 task :latex_all do
   p entries=Dir.entries('.')
-  check_bounding_box
   main_file = latex_loop(entries,opts={:main=>true})
   latex_loop(entries)
   cont=""
   p reg_exp = Regexp.new("#{$basename}_(.+)")
   toc = false
   File.readlines(File.join($latex_dir,"#{main_file}.tex")).each{|line|
-    line, toc = "", true if line.match(/\\tableofcontents/) and toc == true #only one
+#    line, toc = "", true if line.match(/\\tableofcontents/) and toc == true #only one
+    if line.match(/\\tableofcontents/)
+      if toc == false #only one
+        toc = true 
+      else
+        line = ''
+      end
+    end
     line ="\\usepackage{listings,jlisting}" if line.match(/\\usepackage{listings}/)
     if line.match(/section{(.+)}/)
       if m=line.match(/\\verb\|(.+)\((.+)\)\|/)
@@ -219,6 +232,7 @@ task :latex_all do
 end
 
 task :latex_base do
+  check_bounding_box
   Dir.mkdir($latex_dir) unless Dir.exist?($latex_dir)
   convert_to_latex(ARGV[1])
   system("open #{$save_name}")
@@ -246,10 +260,27 @@ def convert_to_latex(file_name, options={})
   system "hiki2latex #{pre_command} #{options[:latex]} #{tf1} > #{tf2}"
   lines = File.readlines(tf2)
   system "rm #{tf1} #{tf2}"
-  cont = ""
+  in_bib,cont=false,""
   lines.each{|line|
+    line=latex_cite_ref(line)
+    if m=line.match(/\\caption{\s*\((.+?)\)(.+)}/)
+      p m
+      puts line = "\\caption{#{m[2]}}\n\\label{#{m[1]}}\n"
+    end
+    if m=line.match(/\\section{reference:}(.+)/) and in_bib==false
+      in_bib=true
+      line = "\\begin{thebibliography}{99}\n"
+      puts line.blue
+    end
+    if m=line.match(/\\end{description}/) and in_bib==true
+      in_bib=false
+      line = "\\end{thebibliography}\n"
+    end
+    if m=line.match(/\\item\[(.+)\](.+)/) and in_bib==true
+      line ="\\bibitem{#{m[1]}} #{m[2]}"
+    end
     if m=line.match(/\\includegraphics\[width=6cm\]\{(.+)\}/)
-      p line="\\includegraphics\[width=10cm,bb=#{$bounding_box}\]\{../figs/#{m[1]}\}\n"
+      p line="\\includegraphics\[width=#{$fig_width}cm,bb=#{$bounding_box}\]\{../figs/#{m[1]}\}\n"
       cont << line
     else
       cont << line
@@ -258,6 +289,18 @@ def convert_to_latex(file_name, options={})
   File.open($save_name,'w'){|file| file.print cont }
 end
 
+def latex_cite_ref(line)
+  r_pair=[/\\verb\|{{cite\((.+?)\)}}\|/,/\\verb\|{{ref\((.+?)\)}}\|/]
+  while m=line.match(r_pair[0])
+    line.sub!(r_pair[0],"\\cite\{#{m[1]}\}")
+  end
+  while m=line.match(r_pair[1])
+    line.sub!(r_pair[1],"\\ref\{#{m[1]}\}")
+  end
+#  puts line.chomp.blue
+  return line
+end
+
 task :change_wrap do
   lines = File.readlines($save_name)
 
@@ -346,6 +389,26 @@ task :sync => [:check_previous,:sync0]
 desc "hikiの強制同期"
 task :force_sync => [:sync0]
 
+def hiki_cite_ref(file)
+  tf1 = 'tmp1.txt'
+  lines = File.readlines(file)
+  inside_pre_form,cont = false,""
+  lines.each{|line|
+    inside_pre_form=true if line.match(/^<<</) and !inside_pre_form
+    inside_pre_form=false if line.match(/^>>>/) and inside_pre_form
+    tr_pair=[/\{\{cite\((.+?)\)\}\}/,/\{\{ref\((.+)\)\}\}/]
+    while m=line.match(tr_pair[0]) and !inside_pre_form
+      puts line.sub!(tr_pair[0], "\[[[#{m[1]}|#{$basename}_references]]\]").chomp.green
+    end
+    while m=line.match(tr_pair[1]) and !inside_pre_form
+      puts line.sub!(tr_pair[1],"#{m[1]}").chomp.green
+    end
+    cont << line
+  }
+  File.open(tf1,'w'){|file| file.print cont }
+  return tf1
+end
+
 task :sync0 do
   entries=Dir.entries('.')
   entries[2..-1].each{|source| #cp *.hiki
@@ -354,6 +417,7 @@ task :sync0 do
     p base = source.split('.')[0]
     name = (base==$basename)? base : $basename+'_'+base
     p target = File.join($hiki_dir,'text',name)
+    source = hiki_cite_ref(source)
     FileUtils.cp(source,target,:verbose=>true)
   }
   p entries=Dir.entries('./figs') #cp files in figs
@@ -388,7 +452,14 @@ task :self_copy do
   cp_files.each{|files|
     p source = files[0]
     p target = File.join('/Users/bob/Github/hikiutils/lib/templates/',files[1])
-    FileUtils.cp(source,target,:verbose=>true)
+    command = "diff #{source} #{target}"
+    status, stdout, stderr=systemu command
+    if stdout!=''
+      puts command.red
+      puts CodeRay.scan(stdout, :Diff).term  
+      print " Are you sure to save #{source}? [Yn]  ".red
+      FileUtils.cp(source,target,:verbose=>true) if STDIN.gets.chomp=='Y'
+    end
   }
 end
 

data/docs/nasu/abstract.hiki

@@ -0,0 +1,17 @@
+プログラム開発では，統合開発環境がいくつも用意されているが，多くの現場では，terminal上での開発が一般的です．
+ところが，プログラミング初心者はterminal上でのcharacter user interface(CUI)を苦手としています．
+この不可欠なCUIスキルの習得を助けるソフトとして，ユーザメモソフトmy_helpがruby gemsに置かれています．
+このcommand line interface(CLI)で動作するmy_helpは，helpをterminal上で簡単に提示するものです．
+また，初心者が自ら編集することによって，すぐに参照できるメモとしての機能を提供しています．
+これにより，プログラム開発に集中できることが期待でき，初心者のスキル習得が加速することが期待できます．
+しかし，Ruby gemsとして提供されているこのソフトは，動作はするがテストが用意されていません．
+今後ソフトを進化させるために共同開発を進めていくには，仕様や動作の標準となるテスト記述が不可欠となります．
+そこで，本研究では，ユーザメモソフトであるmy_helpのテストを開発することを目的とします．
+本研究では、テスト駆動開発の中でも，ソフトの振る舞いを記述します
+Behavior Driven Development(BDD)に基づいてテストを記述していきます．
+Rubyにおいて、BDD環境を提供する標準的なフレームワークであるCucumberとRSpecを用いて，
+my_helpがどのような振る舞いをするのかを記述します．
+Cucumberは自然言語で振る舞いを記述することができるため，ユーザにとって，わかりやすく振る舞いを確認することができます．
+ここでは，実際にBDDの流れにそって，my_helpのある一例を取り上げてのテスト開発を進めていきます．
+また，my_helpの頻繁に使うコマンドの振る舞いを記述しています．
+このことにより，来年の本研究室の研究生のスキルがより向上することが期待されると考えています．

data/{my_help_nasu → docs/nasu}/code.hiki

@@ -59,21 +59,25 @@ featuresディレクトリにあるmy_todo.featureファイルをcucumberで実
 
 実行すると以下のようになります．
 
-<<< tcsh
-# language: ja
-機能: todoの更新を行う
-todoは更新していくものであり,新しく書いたり終わったものを消したいのでバックアップをとって，過去のtodoを残しておく
 
-  シナリオ: コマンドを入力してtodoを更新していく # features/my_todo.feature:6
-    前提todoを編集したい             # features/my_todo.feature:7
-    もし"my_todo --edit"と入力する  # features/my_todo.feature:8
-    ならばeditが開かれる             # features/my_todo.feature:9
-    かつ自分のtodoを書き込む           # features/my_todo.feature:10
+//# language: ja
+//機能: todoの更新を行う
+//todoは更新していくものであり,新しく書いたり終わったものを消したいのでバックアップをとって，過去のtodoを残しておく
 
-  シナリオ: コマンドを入力してバックアップをとる          # features/my_todo.feature:12
-    前提todoの編集が終わった                  # features/my_todo.feature:13
-    もし"my_todo --store [item]"と入力する # features/my_todo.feature:14
-    ならばitemのバックアップを取る               # features/my_todo.feature:15
+//  シナリオ: コマンドを入力してtodoを更新していく # features/my_todo.feature:6
+//    前提todoを編集したい             # features/my_todo.feature:7
+//    もし"my_todo --edit"と入力する  # features/my_todo.feature:8
+//    ならばeditが開かれる             # features/my_todo.feature:9
+//    かつ自分のtodoを書き込む           # features/my_todo.feature:10
+
+//  シナリオ: コマンドを入力してバックアップをとる          # features/my_todo.feature:12
+//    前提todoの編集が終わった                  # features/my_todo.feature:13
+//    もし"my_todo --store [item]"と入力する # features/my_todo.feature:14
+//    ならばitemのバックアップを取る               # features/my_todo.feature:15
+
+<<< tcsh
+
+＜省略＞
 
 2 scenarios (2 undefined)
 7 steps (7 undefined)
@@ -204,14 +208,14 @@ todoは更新していくものであり,新しく書いたり終わったもの
 >>>
 
 !!RSpec
-次にRSpecを使って実際にtodoを更新する振る舞いをするコード書いていく．
+次にRSpecを使って実際にtodoを更新する振る舞いをするコード書いていきます．
 
-そのための準備として，まずspecというディレクトリを作成し，my_todoというサブディレクトリを追加する．
-次に，このサブディレクトリにtodo_spec.rbというファイルを追加する．
+そのための準備として，まずspecというディレクトリを作成し，my_todoというサブディレクトリを追加します．
+次に，このサブディレクトリにtodo_spec.rbというファイルを追加します．
 作業を進める過程で，lib/my_todo/my_todo.rbソースファイルとspec/my_todo/todo_spec.rbスペックファイルが１対１に対応するといった要領で，
-並列のディレクトリ構造を築いていく．
+並列のディレクトリ構造を築いていきます．
 この機能はmy_help --editと入力されれば，~/.my_help/my_todo.ymlが開かれるのでその振る舞いをするコードを書きます．
-まずtodo_spec.rbは下記の通りになります
+まずtodo_spec.rbは下記の通りになります．
 
 <<< ruby
 require 'spec_helper'
@@ -260,7 +264,7 @@ end
 
 >>>
 
-これでrspecを実行すると以下のような結果が表示される．
+これでrspecを実行すると以下のような結果が表示されます．
 <<< tcsh
 /Users/nasubi/my_help% rspec spec --color
 
@@ -280,6 +284,6 @@ Finished in 3.87 seconds (files took 0.30703 seconds to load)
 5 examples, 0 failures
 
 >>>
-これでtodoを更新するときの振る舞いのテストはうまく成功した．
+これでtodoを更新するときの振る舞いのテストはうまく成功しました．
 
-この方法でBDDでmy_helpのテスト開発を行い，仕様を決定していった．
+この方法でBDDでmy_helpのテスト開発を行い，仕様を決定していきました．

data/docs/nasu/discussion.hiki

@@ -0,0 +1,38 @@
+!考察と今後の課題
+!!考察
+my_helpを対象とした具体的なビヘイビア駆動開発の実践を通して，以下のような問題点が明らかになってきました．
+!!! Cucumberを記述できるようになるまで時間がかかる
+
+//意見を述べるときはできるだけ客観的に記述するようにしてください．それでも，それが意見であることは読み手にはわかります．また，その意見が次からは事実になります．つまり，「那須によると」という研究成果になるわけです．あるいは
+//""那須によるmy_helpのビヘイビア駆動開発の実践で言及されている通り，2017年当初においてはfeaturesを記述するデータベースは存在しなかった．
+//となるわけです．どやかっこええやろ．
+
+//日本語で書くことができるので，記述されているコードを理解するのは容易にできました．
+//しかし，日本語で書くことができるので容易に記述することも可能であると考えていましたが，The RSpec Bookに記載されているテンプレートが少なく，理解が難しく感じました．
+//自力で作成することはできますが，やはり時間がかかってしまうと考えます．
+//ネットで検索しても，The RSpec Bookと類似したシナリオが多いのも問題の一つであり，書き方のテンプレートがもっと必要です．
+//地道にCucumberを使用して，データベースのようなものを作成するのがよいと考えました．
+//また，BDDではCucumberでエラーが出ている状況が正しく，Cucumberを放置してRSpecへと進みます．今までのプログラミングとは少し違う感覚に陥り，不安がよぎります．
+//これは慣れるまでの辛抱ではありますが，この問題も時間との戦いです．
+
+日本語で書くことができるので，記述されているコードを「理解する」のは容易で，「記述する」ことも可能であると考えていました．ところが，The RSpec Book{{cite(RSpecBook)}}に記載されているテンプレートが少なく，理解することにも非常に困難を覚えました．自力で何も前例のない状況から作成することはできますが，やはり時間がかかってしまいます．ネットで検索しても，日本語のサイトではほぼThe RSpec Book{{cite(RSpecBook)}}と類似したシナリオしか記載されていないのも問題の一つであり，違った種類の書き方のテンプレートがもっと必要です．地道に幾度もCucumberを叩いて，featuresやrspecの記述すること，またそのデータベースを蓄えていくことが必要です．
+また，BDDではCucumberでエラーが出ている状況が正しく，Cucumberを放置してRSpecへと進みます．今までのプログラミングとは少し違う感覚に陥り，不安がよぎります．これは慣れるまでの辛抱ではありますが，この問題も時間との戦いです．
+
+!!! BDDを行うときにrubyの知識が必要
+Cucumberのステップ定義やRSpecにおいてrubyを用いることが多々あります．スッテプ定義を記述するときに，あればよいと思うコードを書くのですが，具体的なプログラムを書くよりも難易度が高いと感じました．部分的なプログラムを作成するので，知識がないと正しいかどうかの判断が最後にしかできません．BDDを通してrubyを学べるという考え方もできますが，BDDでrubyを学ぶには物足りなさがあり，不向きです．したがって，BDDを使用する前にrubyの基礎の勉強は不可欠です．
+
+// はい．今後はここから4回生を招き入れることはやめることにします．
+
+!!my_helpの今後
+
+//:Given:my_helpのテスト開発が成功したため，仕様や動作の標準が確定しました．
+//:Should_be: 
+my_helpのテスト記述が完了するに伴って，仕様や動作の標準が確定しました．
+//:Given:私は，my_helpは何度も使用することで，どのように進化させれば便利なのかがわかってくると考えているので，my_helpはまだまだ進化する機会が出てくると思います．
+//:Shoule_be:
+my_helpは今後も開発者，ならびに多くのユーザの使用を通じて，どのように進化させれば便利なのかが徐々にわかってくることで，my_helpはまだまだ進化する機会が出てくると思われます．
+つまり，ビヘイビアの記述を利用することで，今後my_helpを進化させるための共同開発が円滑に進める手助けになると推測します．
+また，my_helpの進化の開発だけに関わらず，my_helpの使用方法が明確になったことで，本研究で作成したmy_helpのfeaturesを読めば初心者でもmy_helpの振る舞いが容易に理解できます．
+my_helpは本研究室で今後使われていくと予想し，本研究はこれからの研究の手助けになります．
+今後の本研究室の研究生が，CUIなどの習得に時間をかけずにプログラミングに集中でき，研究の質が向上すると予想できます．
+

data/docs/nasu/features/add.feature

@@ -0,0 +1,12 @@
+#language: ja
+
+#--add [item]
+機能: 新しいitemをspecific_helpに追加する
+specific_helpとは，ユーザが作成するそれぞれのヘルプである
+新しいhelp画面を追加したい
+
+シナリオ: コマンドを入力してspecific_helpにitemを追加する
+        前提 新たなhelpコマンドを追加したい
+        もし emacs_help --add[item]を入力する
+        ならば ~/.my_help/emacs_help.ymlに新しいitemが自動的に追加される
+

data/docs/nasu/features/all_help.feature

@@ -0,0 +1,10 @@
+#language: ja
+
+#--all
+機能: 全てのhelp画面を見る
+複数のhelp画面を一度に見たい時に便利である
+
+シナリオ: コマンドを入力してすべてのhelpを見る
+        前提 複数のhelp画面を表示したい
+        もし emacs_help --allと入力する
+        ならば すべてのhelp画面が表示される