コード中の省略を省略した内容がわかるように修正した、PDFの奥付の体裁を見直した

Author: kuboaki

.gitignore

@@ -0,0 +1,8 @@
+\#*\#
+\.\#*
+*~
+*.tmp
+output
+.DS_Store
+vendor/bundle
+log

.ruby-version

@@ -0,0 +1 @@
+2.7.2

Gemfile.lock

@@ -0,0 +1,101 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    Ascii85 (1.1.0)
+    addressable (2.8.0)
+      public_suffix (>= 2.0.2, < 5.0)
+    afm (0.2.2)
+    asciidoctor (2.0.17)
+    asciidoctor-pdf (1.6.2)
+      asciidoctor (~> 2.0)
+      concurrent-ruby (~> 1.1)
+      prawn (~> 2.4.0)
+      prawn-icon (~> 3.0.0)
+      prawn-svg (~> 0.32.0)
+      prawn-table (~> 0.2.0)
+      prawn-templates (~> 0.1.0)
+      safe_yaml (~> 1.0.0)
+      treetop (~> 1.6.0)
+    ast (2.4.2)
+    awesome_print (1.9.2)
+    coderay (1.1.3)
+    concurrent-ruby (1.1.9)
+    css_parser (1.11.0)
+      addressable
+    hashery (2.1.2)
+    json (2.6.1)
+    parallel (1.21.0)
+    parser (3.1.1.0)
+      ast (~> 2.4.1)
+    pdf-core (0.9.0)
+    pdf-reader (2.9.2)
+      Ascii85 (~> 1.0)
+      afm (~> 0.2.1)
+      hashery (~> 2.0)
+      ruby-rc4
+      ttfunk
+    polyglot (0.3.5)
+    prawn (2.4.0)
+      pdf-core (~> 0.9.0)
+      ttfunk (~> 1.7)
+    prawn-icon (3.0.0)
+      prawn (>= 1.1.0, < 3.0.0)
+    prawn-svg (0.32.0)
+      css_parser (~> 1.6)
+      prawn (>= 0.11.1, < 3)
+      rexml (~> 3.2)
+    prawn-table (0.2.2)
+      prawn (>= 1.3.0, < 3.0.0)
+    prawn-templates (0.1.2)
+      pdf-reader (~> 2.0)
+      prawn (~> 2.2)
+    public_suffix (4.0.6)
+    pygments.rb (2.3.0)
+    rainbow (3.1.1)
+    rake (13.0.6)
+    regexp_parser (2.2.1)
+    rexml (3.2.5)
+    rouge (3.28.0)
+    rubocop (1.25.1)
+      parallel (~> 1.10)
+      parser (>= 3.1.0.0)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml
+      rubocop-ast (>= 1.15.1, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 3.0)
+    rubocop-ast (1.16.0)
+      parser (>= 3.1.1.0)
+    ruby-progressbar (1.11.0)
+    ruby-rc4 (0.1.5)
+    safe_yaml (1.0.5)
+    thor (1.2.1)
+    thread_safe (0.3.6)
+    treetop (1.6.11)
+      polyglot (~> 0.3)
+    ttfunk (1.7.0)
+    unicode (0.4.4.4)
+    unicode-display_width (2.1.0)
+
+PLATFORMS
+  arm64-darwin-20
+  x86_64-darwin-20
+
+DEPENDENCIES
+  asciidoctor
+  asciidoctor-pdf
+  awesome_print
+  coderay
+  json
+  pygments.rb
+  rake
+  rouge
+  rubocop
+  thor
+  thread_safe
+  unicode
+  unicode-display_width
+
+BUNDLED WITH
+   2.3.22

Rakefile

@@ -116,7 +116,7 @@ def make_pdf(source, target)
   tag_lines = find_tag_lines('codes/score.rb',['main', 'test'])
   # `bundle exec asciidoctor-pdf -r asciidoctor-pdf-cjk  -a revdate='#{revdate}'  -r #{CODE_STYLE} -r #{LIB_EXT} -r #{LIB_EXT2} -r  #{LIB_EXT3} -a pdf-stylesdir=#{THEME_DIR} -a pdf-style=#{THEME_FILE} -a pdf-fontsdir=#{FONTS_DIR} #{source} --out=#{target}` #  2>/dev/null`
   # `bundle exec asciidoctor-pdf -a scripts=cjk -a score_main_start=#{tag_lines[0]} -a score_test_start=#{tag_lines[1]} -a revdate='#{revdate}'  -r #{CODE_STYLE} -r #{LIB_EXT} -r #{LIB_EXT2} -r  #{LIB_EXT3} -a pdf-stylesdir=#{THEME_DIR} -a pdf-style=#{THEME_FILE} -a pdf-fontsdir=#{FONTS_DIR} #{source} --out=#{target}` #  2>/dev/null`
-  `bundle exec asciidoctor-pdf -a scripts=cjk -a score_main_start=#{tag_lines[0]} -a score_test_start=#{tag_lines[1]} -a revdate='#{revdate}'  -r #{CODE_STYLE} -r #{LIB_EXT} -r #{LIB_EXT2} -a pdf-stylesdir=#{THEME_DIR} -a pdf-style=#{THEME_FILE} -a pdf-fontsdir=#{FONTS_DIR} #{source} --out=#{target}` #  2>/dev/null`
+  `bundle exec asciidoctor-pdf -a scripts=cjk -a score_main_start=#{tag_lines[0]} -a score_test_start=#{tag_lines[1]} -a revdate='#{revdate}'  -r #{CODE_STYLE} -r #{LIB_EXT} -r #{LIB_EXT2} -r #{LIB_EXT3} -a pdf-stylesdir=#{THEME_DIR} -a pdf-style=#{THEME_FILE} -a pdf-fontsdir=#{FONTS_DIR} #{source} --out=#{target}` #  2>/dev/null`
 end
 
 # コードのtagの（次の）行番号を返す

_appendix-01.html

@@ -20,8 +20,8 @@
 <h1>モデルを使ってソフトウェアを開発しよう: UML初学者向けチュートリアル</h1>
 <div class="details">
 <span id="author" class="author">株式会社チェンジビジョン</span><br>
-<span id="revnumber">バージョン html_0701,</span>
-<span id="revdate">2023-02-13</span>
+<span id="revnumber">バージョン html_0711,</span>
+<span id="revdate">2023-05-31</span>
 </div>
 <div id="toc" class="toc2">
 <div id="toctitle">目次</div>
@@ -61,30 +61,18 @@ <h2 id="_appendix-01"><a class="anchor" href="#_appendix-01"></a>付録 A: モ
 <dl>
 <dt class="hdlist1">ボウリングのゲームスコアのモデル図</dt>
 <dd>
-<p><code>bowling_score_yyyymmdd.asta</code></p>
+<p><code>bowling_score.asta</code></p>
 </dd>
 <dt class="hdlist1">Rubyで実装したプログラム</dt>
 <dd>
-<p><code>score_yyyymmdd.rb</code></p>
+<p><code>score.rb</code></p>
 </dd>
 <dt class="hdlist1">実行結果の動画</dt>
 <dd>
-<p><code>score_rb_demo_win_yyyymmdd.mp4</code> 、 <code>score_rb_demo_mac_yyyymmdd.mov</code></p>
+<p><code>score_rb_demo_win.mp4</code> 、 <code>score_rb_demo_mac.mov</code></p>
 </dd>
 </dl>
 </div>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="注記"></i>
-</td>
-<td class="content">
-上記ファイル名を、提供方法に応じた配布先がわかるリンクに改める。
-</td>
-</tr>
-</table>
-</div>
 </div>
 </div>
 <div class="paragraph nav-footer">
@@ -93,7 +81,7 @@ <h2 id="_appendix-01"><a class="anchor" href="#_appendix-01"></a>付録 A: モ
 </div>
 <div id="footer">
 <div id="footer-text">
-バージョン html_0701<br>
+バージョン html_0711<br>
 最終更新 2023-02-06 13:59:37 +0900
 </div>
 </div>

_behavior_design.html

@@ -21,8 +21,8 @@
 <h1>モデルを使ってソフトウェアを開発しよう: UML初学者向けチュートリアル</h1>
 <div class="details">
 <span id="author" class="author">株式会社チェンジビジョン</span><br>
-<span id="revnumber">バージョン html_0701,</span>
-<span id="revdate">2023-02-13</span>
+<span id="revnumber">バージョン html_0711,</span>
+<span id="revdate">2023-05-31</span>
 </div>
 <div id="toc" class="toc2">
 <div id="toctitle">目次</div>
@@ -491,8 +491,6 @@ <h4 id="_フレームの処理をプログラムに変換する"><a class="ancho
       <span class="nb">puts</span> <span class="s1">'fixed.'</span>
     <span class="k">end</span>
   <span class="k">end</span>
-
-  <span class="c1"># 略</span>
 <span class="k">end</span></code></pre>
 </div>
 </div>
@@ -530,8 +528,13 @@ <h4 id="_フレームの処理をプログラムに変換する"><a class="ancho
 <div id="ruby_frame_code02" class="listingblock">
 <div class="title">リスト 4.2 【Ruby】score.rb(2)</div>
 <div class="content">
-<pre class="rouge highlight"><code data-lang="ruby"><span class="k">class</span> <span class="nc">Frame</span>
-  <span class="c1"># 略</span>
+<pre class="rouge highlight"><code data-lang="ruby"><span class="c1"># frozen_string_literal: true</span>
+
+<span class="nb">require</span> <span class="s1">'securerandom'</span>
+
+<span class="c1"># Frameは1フレーム分のピン数やボーナスを記録する</span>
+<span class="k">class</span> <span class="nc">Frame</span>
+  <span class="c1"># initialize、actionの定義がここにある</span>
 
   <span class="k">def</span> <span class="nf">frame_score</span> <i class="conum" data-value="1"></i><b>(1)</b>
     <span class="vi">@first</span> <span class="o">+</span> <span class="vi">@second</span> <span class="o">+</span> <span class="vi">@spare_bonus</span> <span class="o">+</span> <span class="vi">@strike_bonus</span>
@@ -568,9 +571,9 @@ <h4 id="_フレームの処理をプログラムに変換する"><a class="ancho
            <span class="vi">@spare_bonus</span><span class="p">,</span> <span class="vi">@strike_bonus</span><span class="p">,</span> <span class="vi">@state</span>
   <span class="k">end</span>
 
-  <span class="kp">private</span>
+  <span class="kp">private</span> <i class="conum" data-value="5"></i><b>(5)</b>
 
-  <span class="k">def</span> <span class="nf">before_1st_porc</span><span class="p">(</span><span class="n">evt</span><span class="p">,</span> <span class="n">pins</span><span class="p">)</span> <i class="conum" data-value="5"></i><b>(5)</b>
+  <span class="k">def</span> <span class="nf">before_1st_porc</span><span class="p">(</span><span class="n">evt</span><span class="p">,</span> <span class="n">pins</span><span class="p">)</span> <i class="conum" data-value="6"></i><b>(6)</b>
     <span class="k">case</span> <span class="n">evt</span>
     <span class="k">when</span> <span class="ss">:PINS</span>
       <span class="nb">puts</span> <span class="s2">"invalid pins: </span><span class="si">#{</span><span class="n">pins</span><span class="si">}</span><span class="s2">"</span> <span class="k">if</span> <span class="n">pins</span><span class="p">.</span><span class="nf">negative?</span> <span class="o">||</span> <span class="n">pins</span> <span class="o">&gt;</span> <span class="mi">10</span>
@@ -586,7 +589,7 @@ <h4 id="_フレームの処理をプログラムに変換する"><a class="ancho
     <span class="k">end</span>
   <span class="k">end</span>
 
-  <span class="k">def</span> <span class="nf">before_2nd_proc</span><span class="p">(</span><span class="n">evt</span><span class="p">,</span> <span class="n">pins</span><span class="p">)</span> <i class="conum" data-value="6"></i><b>(6)</b>
+  <span class="k">def</span> <span class="nf">before_2nd_proc</span><span class="p">(</span><span class="n">evt</span><span class="p">,</span> <span class="n">pins</span><span class="p">)</span> <i class="conum" data-value="7"></i><b>(7)</b>
     <span class="k">case</span> <span class="n">evt</span>
     <span class="k">when</span> <span class="ss">:PINS</span>
       <span class="nb">puts</span> <span class="s2">"invalid pins: </span><span class="si">#{</span><span class="n">pins</span><span class="si">}</span><span class="s2">"</span> <span class="k">if</span> <span class="n">pins</span><span class="p">.</span><span class="nf">negative?</span> <span class="o">||</span> <span class="n">pins</span> <span class="o">&gt;</span> <span class="p">(</span><span class="mi">10</span> <span class="o">-</span> <span class="vi">@first</span><span class="p">)</span>
@@ -623,10 +626,14 @@ <h4 id="_フレームの処理をプログラムに変換する"><a class="ancho
 </tr>
 <tr>
 <td><i class="conum" data-value="5"></i><b>5</b></td>
-<td>「1投目の投球を待っている」状態を担当するメソッド。イベント「PINS」を受け取り、1投目のピン数に保存する。その後ストライクかどうか調べ、次の状態へ遷移する。</td>
+<td>これ以降のメソッドはプライベート。</td>
 </tr>
 <tr>
 <td><i class="conum" data-value="6"></i><b>6</b></td>
+<td>「1投目の投球を待っている」状態を担当するメソッド。イベント「PINS」を受け取り、1投目のピン数に保存する。その後ストライクかどうか調べ、次の状態へ遷移する。</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="7"></i><b>7</b></td>
 <td>「2投目の投球を待っている」状態を担当するメソッド。イベント「PINS」を受け取り、2投目のピン数に保存する。その後スペアかどうか調べ、次の状態へ遷移する。</td>
 </tr>
 </table>
@@ -941,9 +948,7 @@ <h4 id="_スコアの処理をプログラムに変換する"><a class="anchor"
 
 <span class="nb">require</span> <span class="s1">'securerandom'</span> <i class="conum" data-value="1"></i><b>(1)</b>
 
-<span class="k">class</span> <span class="nc">Frame</span>
-  <span class="c1"># 略</span>
-<span class="k">end</span>
+<span class="c1"># Frameクラスの定義がここにある</span>
 
 <span class="c1"># スコアは各人の10フレーム分のスコアを記録する</span>
 <span class="k">class</span> <span class="nc">Score</span> <i class="conum" data-value="2"></i><b>(2)</b>
@@ -977,8 +982,6 @@ <h4 id="_スコアの処理をプログラムに変換する"><a class="anchor"
   <span class="k">def</span> <span class="nf">current</span> <i class="conum" data-value="9"></i><b>(9)</b>
     <span class="n">frame</span><span class="p">(</span><span class="vi">@fno</span><span class="p">)</span>
   <span class="k">end</span>
-
-  <span class="c1"># 略</span>
 <span class="k">end</span></code></pre>
 </div>
 </div>
@@ -1028,12 +1031,12 @@ <h4 id="_スコアの処理をプログラムに変換する"><a class="anchor"
 <div id="ruby_score_code02" class="listingblock">
 <div class="title">リスト 4.4 【Ruby】score.rb(4)</div>
 <div class="content">
-<pre class="rouge highlight"><code data-lang="ruby"><span class="c1"># 略</span>
+<pre class="rouge highlight"><code data-lang="ruby"><span class="c1"># Frameクラスの定義やそれ以前のコードがここにある</span>
 
 <span class="c1"># スコアは各人の10フレーム分のスコアを記録する</span>
 <span class="k">class</span> <span class="nc">Score</span>
-
-  <span class="c1"># 略</span>
+  <span class="c1"># アクセサーの定義がここにある</span>
+  <span class="c1"># initialize、fno2idx、frame、go_next_frame、currentメソッドの定義がここにある</span>
 
   <span class="k">def</span> <span class="nf">prev</span> <i class="conum" data-value="1"></i><b>(1)</b>
     <span class="n">frame</span><span class="p">(</span><span class="vi">@fno</span> <span class="o">-</span> <span class="mi">1</span><span class="p">)</span>
@@ -1073,8 +1076,6 @@ <h4 id="_スコアの処理をプログラムに変換する"><a class="anchor"
   <span class="k">def</span> <span class="nf">finished?</span> <i class="conum" data-value="7"></i><b>(7)</b>
     <span class="n">frame</span><span class="p">(</span><span class="mi">10</span><span class="p">).</span><span class="nf">fixed?</span>
   <span class="k">end</span>
-
-  <span class="c1"># 略</span>
 <span class="k">end</span></code></pre>
 </div>
 </div>
@@ -1116,12 +1117,12 @@ <h4 id="_スコアの処理をプログラムに変換する"><a class="anchor"
 <div id="ruby_score_code03" class="listingblock">
 <div class="title">リスト 4.5 【Ruby】score.rb(5)</div>
 <div class="content">
-<pre class="rouge highlight"><code data-lang="ruby"><span class="c1"># 略</span>
+<pre class="rouge highlight"><code data-lang="ruby"><span class="c1"># Frameクラスの定義やそれ以前のコードがここにある</span>
 
 <span class="c1"># スコアは各人の10フレーム分のスコアを記録する</span>
 <span class="k">class</span> <span class="nc">Score</span>
-
-  <span class="c1"># 略</span>
+  <span class="c1"># アクセサーの定義がここにある</span>
+  <span class="c1"># initializeからfinished?までのメソッドの定義がここにある</span>
 
   <span class="k">def</span> <span class="nf">wait_for_1st_proc</span><span class="p">(</span><span class="n">pins</span><span class="p">)</span> <i class="conum" data-value="1"></i><b>(1)</b>
     <span class="n">current</span><span class="p">.</span><span class="nf">action</span><span class="p">(</span><span class="ss">:PINS</span><span class="p">,</span> <span class="n">pins</span><span class="p">)</span> <i class="conum" data-value="2"></i><b>(2)</b>
@@ -1274,7 +1275,8 @@ <h4 id="_gameクラスの処理"><a class="anchor" href="#_gameクラスの処
 <div id="ruby_game_code01" class="listingblock">
 <div class="title">リスト 4.6 【Ruby】score.rb(6)</div>
 <div class="content">
-<pre class="rouge highlight"><code data-lang="ruby"><span class="c1"># 略</span>
+<pre class="rouge highlight"><code data-lang="ruby"><span class="c1"># FrameクラスとScoreクラスの定義やそれ以前のコードがここにある</span>
+
 <span class="c1"># Gameクラスは複数名の1ゲーム分のスコアのセットを構成する</span>
 <span class="k">class</span> <span class="nc">Game</span>
   <span class="nb">attr_reader</span> <span class="ss">:id</span><span class="p">,</span> <span class="ss">:turn</span><span class="p">,</span> <span class="ss">:scores</span>
@@ -1379,7 +1381,8 @@ <h4 id="_scoresheetクラスの処理"><a class="anchor" href="#_scoresheetク
 <div id="ruby_scoresheet_code01" class="listingblock">
 <div class="title">リスト 4.7 【Ruby】score.rb(7)</div>
 <div class="content">
-<pre class="rouge highlight"><code data-lang="ruby"><span class="c1"># 略</span>
+<pre class="rouge highlight"><code data-lang="ruby"><span class="c1"># FrameクラスとScoreクラスとGameクラスの定義やそれ以前のコードがここにある</span>
+
 <span class="c1"># ScoreSheetは、複数名の複数回のGameを記録する</span>
 <span class="k">class</span> <span class="nc">ScoreSheet</span>
   <span class="nb">attr_accessor</span> <span class="ss">:id</span><span class="p">,</span> <span class="ss">:time</span><span class="p">,</span> <span class="ss">:games</span>
@@ -1546,7 +1549,7 @@ <h4 id="_モデルとコードの対応づけは振る舞い設計の前に"><a
 </div>
 <div id="footer">
 <div id="footer-text">
-バージョン html_0701<br>
+バージョン html_0711<br>
 最終更新 2023-02-06 13:59:37 +0900
 </div>
 </div>

_bibliography.html

@@ -20,8 +20,8 @@
 <h1>モデルを使ってソフトウェアを開発しよう: UML初学者向けチュートリアル</h1>
 <div class="details">
 <span id="author" class="author">株式会社チェンジビジョン</span><br>
-<span id="revnumber">バージョン html_0701,</span>
-<span id="revdate">2023-02-13</span>
+<span id="revnumber">バージョン html_0711,</span>
+<span id="revdate">2023-05-31</span>
 </div>
 <div id="toc" class="toc2">
 <div id="toctitle">目次</div>
@@ -110,7 +110,7 @@ <h2 id="_bibliography"><a class="anchor" href="#_bibliography"></a>参考文献<
 </div>
 <div id="footer">
 <div id="footer-text">
-バージョン html_0701<br>
+バージョン html_0711<br>
 最終更新 2023-02-06 13:59:37 +0900
 </div>
 </div>

_colophon.html

@@ -20,8 +20,8 @@
 <h1>モデルを使ってソフトウェアを開発しよう: UML初学者向けチュートリアル</h1>
 <div class="details">
 <span id="author" class="author">株式会社チェンジビジョン</span><br>
-<span id="revnumber">バージョン html_0701,</span>
-<span id="revdate">2023-02-13</span>
+<span id="revnumber">バージョン html_0711,</span>
+<span id="revdate">2023-05-31</span>
 </div>
 <div id="toc" class="toc2">
 <div id="toctitle">目次</div>
@@ -61,8 +61,8 @@ <h2 id="_colophon"><a class="anchor" href="#_colophon"></a>奥付</h2>
 <p>「モデルを使ってソフトウェアを開発しよう: UML初学者向けチュートリアル」</p>
 </div>
 <div class="paragraph">
-<p>発行日 : 2023-02-13<br>
-バージョン : html_0701<br>
+<p>発行日 : 2023-05-31<br>
+バージョン : html_0711<br>
 作成者 : 株式会社チェンジビジョン<br>
 本書の内容に関する質問等がありましたら、作成者までお知らせください。</p>
 </div>
@@ -74,7 +74,7 @@ <h2 id="_colophon"><a class="anchor" href="#_colophon"></a>奥付</h2>
 </div>
 <div id="footer">
 <div id="footer-text">
-バージョン html_0701<br>
+バージョン html_0711<br>
 最終更新 2023-02-06 13:59:37 +0900
 </div>
 </div>