zine_brewer 1.1.0 → 1.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2142217e4515907dcab2b950fc41cb21ba8a886ec04daa5d4ac4cdc6acc6bfbb
-  data.tar.gz: 1333a38a15cc0b2189ff63b891c8a28a40282705a212283f4e5fa6990d6ac5e6
+  metadata.gz: a4a2d9b8d3b0420e7f00e67d9cd814b9d47dee6ee7597468357143e677d2be63
+  data.tar.gz: dfada5d6c981ac3686f670c83e52fe86f2351859e2217bef2f49d929888b64a8
 SHA512:
-  metadata.gz: b4d750d74c7b68d461c9ca1c42fa74d35abe4c51ff9101cd78d1a2efd8a79a188a25542253ddbef1f2fb2e2c46bcad736d81ce36a0f22347f16e24fb44427fa2
-  data.tar.gz: 7882f6378598a4714d51f26d7cd3ec0710b79ecf06eb63c7b7793df275693fafc25956ec5e7014e9cfaa8924a329e3a53755fc132abcc76996a7f9a05b9c19f3
+  metadata.gz: a5cbb3db19f9d1626cb9439fe4b2ff26910e76c04f512f915e7c1599798a727a663a34bdf9cb0d0eaa3cec3c5571867ba0833e823b35ba46653f5eacf7b44d5a
+  data.tar.gz: e0dd6c0e92d1fe3204f7e904b5edb133479d597772d08c6024b2773802768b3e37335d9aadbebffced13375ba97c2341225c3f8ef12a88384cbb2e50cb3f8912

data/README.md

@@ -20,7 +20,7 @@ Or install it yourself as:
 
 ## Usage
 
-    $ zine_brewer [kramdown_document_filename]
+    $ zine_brewer [kramdown_document_filepath]
 
 * The header part is converted and written out as "proof/header.txt".
 * The body part is converted and written out as "proof/body.txt".
@@ -83,7 +83,7 @@ ZineBrewerで扱う原稿は「ヘッダー」と「本文」に分かれます
 
 ヘッダーと本文の境界には、本文ページの起こしを指示する`<%-- page -->`を記述します。
 
-**【注意】ヘッダーの最後に記述する`■記事ID■：0000`は、原則として記述必須です。**例外として、原稿を入れているフォルダの名前を記事ID（「1234」など）にしている場合には省略できます。
+**なお、ヘッダーの最後に記述する`■記事ID■：0000`は、原則として記述必須です。** 例外として、原稿を入れているフォルダの名前を記事ID（「1234」など）にしている場合には省略できます。
 
 上記例をZineBrewerで変換した場合、ヘッダーは次のように出力されます（proof/header.txt）。
 
@@ -108,6 +108,31 @@ ZineBrewerで扱う原稿は「ヘッダー」と「本文」に分かれます
 
 ### 本文
 
+本文をHTMLに変換したファイルは、proof/body.txtとして出力されます。
+
+#### ■ページの起こし
+
+**本文の各ページの先頭には、ページの起こしとして必ず`<%-- page -->`を記述してください。** 1ページ目の起こしは、ヘッダーとの境界にもなります。
+
+```
+（ヘッダー）
+……
+
+■記事ID■：1234
+
+<%-- page -->
+
+本文1ページ目
+
+<%-- page -->
+
+本文2ページ目
+
+<%-- page -->
+
+本文3ページ目
+```
+
 #### ■図の書き方
 
 図は「拡大なし」「拡大あり」「拡大あり（lightbox）」「ハイパーリンク」「プロフィール」の5種類を記述できます。いずれも`<<Fig-●>>`（●にはアルファベット**大文字**1字が入る）から書き出します。
@@ -118,7 +143,7 @@ ZineBrewerで扱う原稿は「ヘッダー」と「本文」に分かれます
 ```
 <<Fig_N>>
 src: [画像ファイル名] ※例 1234_fig.png
-widrh: [画像を表示するときの幅を指定] ※例 400px
+width: [画像を表示するときの幅を指定] ※例 400px
 height: [画像を表示するときの高さを指定] ※例 300px
 cap: [キャプション] ※例 2020年調査のグラフ
 ```
@@ -127,7 +152,7 @@ cap: [キャプション] ※例 2020年調査のグラフ
 ```
 <<Fig_A>>
 src: [画像ファイル名] ※例 1234_fig.png
-widrh: [画像を表示するときの幅を指定] ※例 400px
+width: [画像を表示するときの幅を指定] ※例 400px
 height: [画像を表示するときの高さを指定] ※例 300px
 cap: [キャプション] ※例 2020年調査のグラフ
 ```
@@ -136,7 +161,7 @@ cap: [キャプション] ※例 2020年調査のグラフ
 ```
 <<Fig_Z>>
 src: [画像ファイル名] ※例 1234_fig.png
-widrh: [画像を表示するときの幅を指定] ※例 400px
+width: [画像を表示するときの幅を指定] ※例 400px
 height: [画像を表示するときの高さを指定] ※例 300px
 cap: [キャプション] ※例 2020年調査のグラフ
 ```
@@ -146,7 +171,7 @@ cap: [キャプション] ※例 2020年調査のグラフ
 <<Fig_H>>
 src: [画像ファイル名] ※例 1234_book01.png
 href: [リンク先のURL] ※例 https://www.amazon.co.jp/dp/4798142417
-widrh: [画像を表示するときの幅を指定] ※例 200px
+width: [画像を表示するときの幅を指定] ※例 200px
 height: [画像を表示するときの高さを指定] ※例 150px
 cap: [キャプション] ※例 書籍『スターティングGo言語』
 ```
@@ -155,7 +180,7 @@ cap: [キャプション] ※例 書籍『スターティングGo言語』
 ```
 <<Fig_P>>
 src: [画像ファイル名] ※例 1234_ichigo.jpg
-widrh: [画像を表示するときの幅を指定] ※例 600px
+width: [画像を表示するときの幅を指定] ※例 600px
 height: [画像を表示するときの高さを指定] ※例 400px
 name: [名前] ※例 市古 明典
 huri: [ふりがな] ※例 いちご あきのり
@@ -243,6 +268,7 @@ src: fig.png    <--- 1234_fig.png と書いたのと同じになる
 
 ```
 （本文）
+……
 
 {%background-color:#e6e6e6; %padding:1em;}
 ===div
@@ -257,13 +283,142 @@ width: 450px
 
 #### ■画像回り込みの書き方
 
-divブロックの応用として、本文テキストの画像回り込み指定があります。スタイル指定と合わせて、次に用に記述します。
+本文テキストの画像回り込み指定は、画像と回り込ませる本文テキストとを、`===wraparound`と`==/wraparound`で挟んでやることで行えます。
+
+ただし、画像を右に置くか左に置くかの指定も必要です。画像の記述`<<Fig_●>>`の上に、画像を右に置く場合には`{:.imgR}`、左に置く場合には`{:.imgL}`と記述します。
+
+次の例では、画像を右に置き、その周りに本文テキストを回り込ませます。
 
 ```
+（本文）
+……
+
+===wraparound
+
+{:.imgR}
+<<Fig_N>>
+src: 1234_fig.png
+width: 200px
+
+　回り込ませる本文テキスト〜
+==/wraparound
+```
+
+また、画像の周りに本文テキストを回り込ませないようにする場合には、本文テキストの各段落の上に`{:.ovh}`という記述を加えます。
+
+```
+（本文）
+……
+
+===wraparound
+
+{:.imgR}
+<<Fig_N>>
+src: 1234_fig.png
+width: 200px
+
+{:.ovh}
+　回り込ませない本文テキスト（段落1）〜
+
+{:.ovh}
+　回り込ませない本文テキスト（段落2）〜
+==/wraparound
 ```
 
+#### ■脚注の書き方
+
+次のように、本文テキスト中の脚注を付けたい言葉などに`[^1]`などとアンカーを付け、脚注を置きたい場所に`[^1]: 〜`という形で脚注本体を書きます。脚注本体のコロンを忘れなく。脚注番号で使えるのは半角数字のみです。
+
+```
+　ほら、ここに難しい専門用語[^1]が1つ。ここにも意味の分からない専門用語[^2]がもう1つ。
+
+　それからいろんな話がありつつ、この下に脚注を置きたいのなら、次のように記述します。
+
+[^1]: 難しい専門用語の意味。もちろん[リンク](https://www.example.com)も置けますよ。
+
+[^2]: 意味の分からない専門用語の意味。
+```
+
+なお、ZineBrewerでは、コラムに`footnotes`クラスを適用したスタイルで脚注本体を表示するようになっています。通常のコラムの形ではスカスカした見た目になってしまうので、追加CSSでスタイルを当てることをお勧めします。
+
+#### ■定義表の書き方
+
+定義リストの記述を`===dtable`〜`==/dtable`で挟むと、左に項目、右に内容のテーブル（表）ができます。
+
+例えば、次のように記述すると、
+
+```
+{:caption="イベント概要"}
+===dtable
+イベント名
+:  HRzine Day 2020 Autumn
+
+テーマ
+:  ニューノーマルが来た！〜人事・労務がいま整えるべきこと〜
+
+日時
+:  2020年10月21日(水) 13:00～18:35
+
+会場
+:  オンライン
+==/dtable
+```
+
+次のように表示されます。
+
+![dtable](https://user-images.githubusercontent.com/24837059/94995269-32e6e680-05d8-11eb-86ed-074e650ff2eb.png)
+
 #### ■スタイルの書き方
 
+最後に、スタイルの記述方法を説明します。
+
+Kramdown（拡張Markdown）では、文字や段落にHTMLの属性を付けることができます。例えば、次のように記述すると、太字部分が赤色になり下線も引かれます。
+
+```
+ここは次の試験で**必ず出題する**{:style="color:red; text-decoration:underline;"}ところだから、しっかり勉強してきなさい。
+```
+
+これは、`**必ず出題する**{:style="color:red; text-decoration:underline;"}`という部分は、`<strong style="color:red; text-decoration:underline;">必ず出題する</strong>`と変換されるためです。
+
+ZineBrewerでは、styleのところをもう少し簡潔に書けるようにしてあります。style属性中の指定**一つひとつ**を、パーセント記号とセミコロンで括ります。
+
+```
+ここは次の試験で**必ず出題する**{:%color:red; %text-decoration:underline;}ところだから、しっかり勉強してきなさい。
+```
+
+また、太字にしないで、ただ赤字・下線引きにしたい場合には、次のように記述します。
+
+```
+ここは次の試験で[[必ず出題する]]{:%color:red; %text-decoration:underline;}ところだから、しっかり勉強してきなさい。
+```
+
+段落に対してスタイルを当てる場合には、段落の直前あるいは直後にスタイルを記述します。例えば、次のように記述すると、段落の背景に薄い赤色に敷くことができます（余白も少しとっています）。
+
+```
+{:%background-color:#ffe6e6; %padding:15px;}
+ここは次の試験で必ず出題するところだから、しっかり勉強してきなさい。
+```
+
+行頭の丸数字などを頭出し（ぶら下げ）したいことがあると思いますが、それは次のように記述します。
+
+```
+{:%padding-left:1em; %text-indent:-1em;}
+①このように書いてやると、「①」の部分だけ左につきだし、以降の文章が引っ込んだ形で表示できます。
+```
+
+![Hanging Indent](https://user-images.githubusercontent.com/24837059/94996073-59f3e700-05dd-11eb-87f7-8a16be840f6f.png)
+
+#### id属性、class属性、その他の属性
+
+Kramdown（拡張Markdown）の`{: }`の中には、次のようにしてid属性とclass属性を記述できます。
+
+```
+{:#id_1234 .footnotes}
+id属性は#、class属性は.を使って記述できます。
+```
+
+その他の属性はstyle以外、略記方法はありませんが、HTMLと同様に`{:rel="lightbox}"`とイコールを使った書き方にすれば、何でも指定できます。
+
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/zine_brewer/templates/bookranking.rb

@@ -1,5 +1,7 @@
 # coding: utf-8
 
+require 'mustache'
+
 class BookRanking < Mustache
 
   # <<BookRanking>>

data/lib/zine_brewer/templates/casts.rb

@@ -1,5 +1,7 @@
 # coding: utf-8
 
+require 'mustache'
+
 class Casts < Mustache
 
   # <<Casts>>

data/lib/zine_brewer/templates/fig_a.rb

@@ -1,5 +1,7 @@
 # coding: utf-8
 
+require 'mustache'
+
 require_relative 'fig/module_fig_base'
 require_relative 'fig/module_fig_plus'
 

data/lib/zine_brewer/templates/fig_h.rb

@@ -1,5 +1,7 @@
 # coding: utf-8
 
+require 'mustache'
+
 require_relative 'fig/module_fig_base'
 require_relative 'fig/module_fig_plus'
 

data/lib/zine_brewer/templates/fig_n.rb

@@ -1,5 +1,7 @@
 # coding: utf-8
 
+require 'mustache'
+
 require_relative 'fig/module_fig_base'
 require_relative 'fig/module_fig_plus'
 

data/lib/zine_brewer/templates/fig_p.rb

@@ -1,5 +1,7 @@
 # coding: utf-8
 
+require 'mustache'
+
 require_relative 'fig/module_fig_base'
 
 class Fig_P < Mustache

data/lib/zine_brewer/templates/fig_z.rb

@@ -1,5 +1,7 @@
 # coding: utf-8
 
+require 'mustache'
+
 require_relative 'fig/module_fig_base'
 require_relative 'fig/module_fig_plus'
 

data/lib/zine_brewer/version.rb

@@ -1,3 +1,3 @@
 module ZineBrewer
-  VERSION = "1.1.0"
+  VERSION = "1.3.2"
 end

data/zine_brewer.gemspec

@@ -24,5 +24,6 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
+  spec.add_runtime_dependency "mustache"
   spec.add_runtime_dependency "darkmouun"
 end

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: zine_brewer
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.3.2
 platform: ruby
 authors:
 - Akinori Ichigo
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-10-03 00:00:00.000000000 Z
+date: 2020-10-04 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: mustache
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: darkmouun
   requirement: !ruby/object:Gem::Requirement