zine_brewer 1.0.0 → 1.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6e2d08e05252737a218c8293c1b3f0961e6e5ccc686b7618c7d1f003a5ee344b
-  data.tar.gz: 74c096aa7daaea76924e5f5ca526d14903b2b4b452e7a4de145dbcd5048caf42
+  metadata.gz: c5325e88eec3079faf767c3d15346d512a5a61f4762f4863c6a8e8482dcac7ab
+  data.tar.gz: 861d5bd82b5376c94ca123dee566ababae06defc839e04b13b56aa83339765b3
 SHA512:
-  metadata.gz: cf2f41012a5fbdbbeffe777fa8b46031536469cb10dab13c50c52491bfe76bdd1e042f7fac7ad4418c53320e1c35bfa30c40cf49b61854298b31a973453243ec
-  data.tar.gz: 74c92ca207131f8b1742d06effa4597b98d3fc9fd1bcaa38f549bb85f1ec9d7c4b2b4c7ce75d8ac13f125c45a6bd1e6d10ddcae8355d05c638100e0b43da8a1e
+  metadata.gz: 796a04f191052fd9ac8293866f5d1f8a146deeb82b40dab4704f0bdf507de6ea19cdc5ef3dce27a75fa180a2b445639102b622369c41f3cd936358554e22afea
+  data.tar.gz: 2712df9fe7b7b08bd838a2690f2c5136d123fc9996474ef394a5225d8133f07edb65055fa9ee94412a047e7e898b0345c46ed8a300f28b5fe8348c22f79fef89

data/README.md

@@ -20,7 +20,404 @@ Or install it yourself as:
 
 ## Usage
 
-    $ zine_brewer *kramdown document*
+    $ 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".
+
+## Enhanced Notation in ZineBrewer
+
+ここでは、Kramdown（拡張Markdown）に加えて記述可能にした、ZineBrewer向けの記法を説明します。Kramdownの記法は、こちら（[クイックリファレンス](https://kramdown.gettalong.org/quickref.html)／[詳細文法](https://kramdown.gettalong.org/syntax.html)）をご覧ください。
+
+ZineBrewerで扱う原稿は「ヘッダー」と「本文」に分かれます。以下ではそれぞれ説明します。
+
+なお、ZineBrewerは変換したヘッダー、本文をそれぞれheader.txt、body.txtとして、proofフォルダに格納します。
+
+### ヘッダー
+
+ヘッダーは6つの項目からなります。各項目は空行を挟んで記述してください。以下の方法で記述を省略することもできます。
+
+* `---`と書く
+* 以下省略。例えば、コーナー名とタイトルだけ書いておき、以下は何も書かない（`---`も書かない）ということができます。ただし、以下省略でも、**最後の`■記事ID■：0000`だけは書くようにします。**
+
+ヘッダーの記述項目:
+```
+[コーナー名]
+
+[タイトル]
+
+[リード]
+
+[リード横に表示する画像のファイル名]
+
+[著者名]
+
+[追加CSS]
+
+[■記事ID■：0000]
+```
+
+ヘッダー記述例。コーナー名を`---`で省略、追加CSSは以下省略しています。
+```
+---
+
+原稿はZineBrewerで書こう！ スタイルも適用できるよ
+
+　もともと、Markdown原稿にCSSスタイルを書き込んでおく方法はないかと思い、  
+見つけたのがKramdownです。文字単位・段落単位でidやclass、各種属性を記述  
+しておくことができました。ただし、Kramdownが出力するHTMLは、翔泳社の  
+記事配信システムが受け付けるHTMLフォーマットとは少し異なる部分があります。  
+そこで、Kramdownを拡張し、翔泳社の記事配信システムが受け付けるHTMLを出力  
+するようにしたツールが、ZineBrewerです。
+
+1234_title.png
+
+市古 明典
+
+■記事ID■：1234
+
+<%-- page -->
+
+（以下、本文）
+```
+
+ヘッダーと本文の境界には、本文ページの起こしを指示する`<%-- page -->`を記述します。
+
+**なお、ヘッダーの最後に記述する`■記事ID■：0000`は、原則として記述必須です。** 例外として、原稿を入れているフォルダの名前を記事ID（「1234」など）にしている場合には省略できます。
+
+上記例をZineBrewerで変換した場合、ヘッダーは次のように出力されます（proof/header.txt）。
+
+```
+［タイトル］
+原稿はZineBrewerで書こう！ スタイルも適用できるよ
+
+［リード］
+<p>　もともと、Markdown原稿にCSSスタイルを書き込んでおく方法はないかと思い、  
+見つけたのがKramdownです。文字単位・段落単位でidやclass、各種属性を記述  
+しておくことができました。ただし、Kramdownが出力するHTMLは、翔泳社の  
+記事配信システムが受け付けるHTMLフォーマットとは少し異なる部分があります。  
+そこで、Kramdownを拡張し、翔泳社の記事配信システムが受け付けるHTMLを出力  
+するようにしたツールが、ZineBrewerです。</p>
+
+［タイトル画像］
+1234_title.png
+
+［著者クレジット］
+市古 明典
+```
+
+### 本文
+
+本文をHTMLに変換したファイルは、proof/body.txtとして出力されます。
+
+#### ■ページの起こし
+
+**本文の各ページの先頭には、ページの起こしとして必ず`<%-- page -->`を記述してください。** 1ページ目の起こしは、ヘッダーとの境界にもなります。
+
+```
+（ヘッダー）
+……
+
+■記事ID■：1234
+
+<%-- page -->
+
+本文1ページ目
+
+<%-- page -->
+
+本文2ページ目
+
+<%-- page -->
+
+本文3ページ目
+```
+
+#### ■図の書き方
+
+図は「拡大なし」「拡大あり」「拡大あり（lightbox）」「ハイパーリンク」「プロフィール」の5種類を記述できます。いずれも`<<Fig-●>>`（●にはアルファベット**大文字**1字が入る）から書き出します。
+
+また、**記述の後には必ず空行を入れてください**（空行が指示の終わりを表します）。
+
+(1) 拡大なし――src以外は省略可能。**widthとheightはどちらかを指定**しておけば、それに合わせて拡大／縮小表示します（他の種類も同様）:
+```
+<<Fig_N>>
+src: [画像ファイル名] ※例 1234_fig.png
+width: [画像を表示するときの幅を指定] ※例 400px
+height: [画像を表示するときの高さを指定] ※例 300px
+cap: [キャプション] ※例 2020年調査のグラフ
+```
+
+(2) 拡大あり――src以外は省略可能。大きな画像をアップしておき、widthやheightを使って小さく表示させます。なお、キャプションに自動的に［画像クリックで拡大表示］と表示されます。:
+```
+<<Fig_A>>
+src: [画像ファイル名] ※例 1234_fig.png
+width: [画像を表示するときの幅を指定] ※例 400px
+height: [画像を表示するときの高さを指定] ※例 300px
+cap: [キャプション] ※例 2020年調査のグラフ
+```
+
+(3) 拡大あり（lightbox）――src以外は省略可能。ズーム表示を使いたいときに使用します。やはり、大きな画像をアップしておき、widthやheightを使って小さく表示させます:
+```
+<<Fig_Z>>
+src: [画像ファイル名] ※例 1234_fig.png
+width: [画像を表示するときの幅を指定] ※例 400px
+height: [画像を表示するときの高さを指定] ※例 300px
+cap: [キャプション] ※例 2020年調査のグラフ
+```
+
+(4) ハイパーリンク――srcとhref以外は省略可能。画像をクリックしたときに、hrefで指定したWebページへジャンプさせます:
+```
+<<Fig_H>>
+src: [画像ファイル名] ※例 1234_book01.png
+href: [リンク先のURL] ※例 https://www.amazon.co.jp/dp/4798142417
+width: [画像を表示するときの幅を指定] ※例 200px
+height: [画像を表示するときの高さを指定] ※例 150px
+cap: [キャプション] ※例 書籍『スターティングGo言語』
+```
+
+(5) プロフィール――人物の写真にプロフィールを付けたいときに使う記述方法です。名前とふりがなは、変換後「名前（ふりがな）氏」という表示になります。また、画像の幅を600pxにすると、プロフィールと幅がそろいます。プロフィールの肩書きやプロフィールの行頭に、半角空白でインデントを入れることが必須です。
+```
+<<Fig_P>>
+src: [画像ファイル名] ※例 1234_ichigo.jpg
+width: [画像を表示するときの幅を指定] ※例 600px
+height: [画像を表示するときの高さを指定] ※例 400px
+name: [名前] ※例 市古 明典
+huri: [ふりがな] ※例 いちご あきのり
+cap: |
+  肩書き
+  プロフィール
+```
+
+#### テクニック
+
+(1) `cap:`（キャプション）は、次のように書くと途中改行を入れられます。各行の先頭には半角空白によるインデントを必ず行います。
+
+```
+cap: |
+  1行目
+  2行目
+```
+
+(2) 次のように`imgs:`を使うと、複数の画像を並べて表示できます。特に、`width:`（と画像間のすきま）の合計が670px以内の場合、PC画面では横に並べて表示されます。
+
+```
+<<Fig_H>>
+imgs:
+  - src: 1234_book01.png
+    href: https://www.amazon.co.jp/dp/4798154350
+    width: 200px
+  - src: 1234_book02.png
+    href: https://www.amazon.co.jp/dp/4798154369
+    width: 200px
+  - src: 1234_book03.png
+    href: https://www.amazon.co.jp/dp/4798161888
+    width: 200px
+cap: 『紛争事例に学ぶ、ITユーザの心得』3部作
+```
+
+(3) `src:`に記述するファイル名の先頭にある「1234_」という記事IDを表す部分は省略できます。代わりに、ヘッダに記述した`■記事ID■：`で記述した番号が入ります。`■記事ID■：`がない場合にも、原稿のフォルダ名が記事IDになっていればその番号が入ります。
+
+```
+（ヘッダ）
+……
+
+■記事ID■：1234
+
+<%-- page -->
+
+（本文）
+……
+
+<<Fig_N>>
+src: fig.png    <--- 1234_fig.png と書いたのと同じになる
+```
+
+#### ■コラムの書き方
+
+コラム（囲み）は、`===column`と`==/column`で挟むことで記述できます。
+
+```
+（本文）
+
+===column
+#### 見出しも入れられます
+
+　コラム本文……
+==/column
+```
+
+`===column`に対してスタイルを指示できます。例えば、次のように書くと囲み罫線なしで角丸、地色をベージュにした囲みにできます（スタイルの記述方法は後述）。
+
+```
+（本文）
+
+{:%border:none; %border-radius:8px; %background-color:#ffffe6;}
+===column
+#### コラム見出し
+
+コラム本文……。
+==/column
+```
+
+#### ■divブロックの書き方
+
+ある範囲に対してスタイルを当てたいときなどには、divブロックをつくって、それに対してスタイルを指示します。divブロックは`===div`と`==/div`で挟むことでつくれます。
+
+例えば、本文のある範囲の地にグレーを敷きたい場合、次のように書きます。
+
+```
+（本文）
+……
+
+{%background-color:#e6e6e6; %padding:1em;}
+===div
+　本文テキスト。もちろん図なども入れられます。
+
+<<Fig_N>>
+src: 1234_fig.png
+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
 

data/lib/zine_brewer/kramdown/parser/sekd.rb

@@ -28,7 +28,7 @@ module Kramdown
           end
         end
 
-        @block_parsers.insert(5, :column, :definition_table, :page)
+        @block_parsers.insert(5, :column, :definition_table, :wraparound,:div, :page)
         @span_parsers.insert(5, :span)
 
         @page = 0
@@ -67,6 +67,40 @@ module Kramdown
         sql tcl tex vb vhdl wiki xhtml xml xq xsl yaml yml
       !.map{|i| [i, i]}.flatten])
     
+      def parse_div
+        if @src.check(self.class::DIV_MATCH)
+          start_line_number = @src.current_line_number
+          @src.pos += @src.matched_size
+          el = Element.new(:div, nil, nil, :location => start_line_number)
+          parse_blocks(el, @src[1])
+          update_attr_with_ial(el.attr, @block_ial) unless @block_ial.nil?
+          @tree.children << el
+          true
+        else
+          false
+        end
+      end
+
+      DIV_MATCH = /^={3,}\s*?div\s*?\n(.*?)^={2,}\/div\s*?\n/mi
+      define_parser(:div, /^={3,}div/i, nil, 'parse_div')
+
+      def parse_wraparound
+        if @src.check(self.class::WRAPAROUND_MATCH)
+          start_line_number = @src.current_line_number
+          @src.pos += @src.matched_size
+          el = Element.new(:div, nil, {'class' => 'imgLRBlock cf'}, :location => start_line_number)
+          parse_blocks(el, @src[1])
+          update_attr_with_ial(el.attr, @block_ial) unless @block_ial.nil?
+          @tree.children << el
+          true
+        else
+          false
+        end
+      end
+
+      WRAPAROUND_MATCH = /^={3,}\s*?wraparound\s*?\n(.*?)^={2,}\/wraparound\s*?\n/mi
+      define_parser(:wraparound, /^={3,}wrap/i, nil, 'parse_wraparound')
+
       def parse_column
         if @src.check(self.class::COLUMN_MATCH)
           start_line_number = @src.current_line_number

data/lib/zine_brewer/main.rb

@@ -106,8 +106,6 @@ module ZineBrewer
 
       ### Sets pre process
       dkmn.pre_process = lambda do |t|
-        t.gsub!(/\n\K={2,}div/, "<div markdown=\"1\">")
-        t.gsub!(/\n\K={2,}\/div/, "</div>")
       end
 
       ### Sets post process

data/lib/zine_brewer/templates/fig_p.rb

@@ -20,7 +20,7 @@ class Fig_P < Mustache
   {{#imgs_list}}
   <img src="{{fig_src}}" alt="{{name}}氏" {{& img_style}} />
   {{/imgs_list}}
-  <div style="text-align:left; padding:0em 2em;">
+  <div style="text-align:left; padding:0px 35px;">
     <figcaption><strong>{{name}}（{{huri}}）氏</strong></figcaption>
     <figcaption markdown="span">{{caption}}</figcaption>
   </div>

data/lib/zine_brewer/version.rb

@@ -1,3 +1,3 @@
 module ZineBrewer
-  VERSION = "1.0.0"
+  VERSION = "1.3.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: zine_brewer
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.3.1
 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: darkmouun