review 3.2.0 → 5.1.0

data/samples/sample-book/README.md

@@ -2,6 +2,11 @@
 
 Re:VIEW ( http://github.com/kmuto/review )で書籍データを作るためのサンプルファイルです。
 
-必要なファイルはsrc/ディレクトリ内にあります。srcディレクトリで「review-epubmaker config.yml」と実行すればEPUBが、「review-pdfmaker config.yml」とすればPDFが生成されます(PDFの生成にはupLaTeXとdvipdfmxが必要です)。
+必要なファイルはsrcディレクトリ内にあります。srcディレクトリで以下のようにして各形式のファイルを生成できます。
 
-Ruby製のビルドツールであるrakeがインストールされている環境の場合、「rake pdf」を実行すればPDFが、「rake epub」を実行すればEPUBが生成されます。また、「rake html_all」を実行すればHTMLが生成されます。
+- rake pdf: PDF (upLaTeXとdvipdfmxが必要です)
+- rake epub: EPUB
+- rake web: HTML Webページ
+- rake text: テキストファイル
+- rake plaintext: テキストファイル (装飾なし)
+- rake idgxml: InDesign用XMLファイル

data/samples/sample-book/src/.gitignore

@@ -0,0 +1,154 @@
+/*.pdf
+/*.epub
+/*.html
+/webroot
+/*-pdf
+/*-epub
+/*-text
+/*-idgxml
+
+/vendor
+/.bundle
+
+# Created by https://www.gitignore.io/api/vim,linux,macos,emacs,windows
+# Edit at https://www.gitignore.io/?templates=vim,linux,macos,emacs,windows
+
+### Emacs ###
+# -*- mode: gitignore; -*-
+*~
+\#*\#
+/.emacs.desktop
+/.emacs.desktop.lock
+*.elc
+auto-save-list
+tramp
+.\#*
+
+# Org-mode
+.org-id-locations
+*_archive
+
+# flymake-mode
+*_flymake.*
+
+# eshell files
+/eshell/history
+/eshell/lastdir
+
+# elpa packages
+/elpa/
+
+# reftex files
+*.rel
+
+# AUCTeX auto folder
+/auto/
+
+# cask packages
+.cask/
+dist/
+
+# Flycheck
+flycheck_*.el
+
+# server auth directory
+/server/
+
+# projectiles files
+.projectile
+
+# directory configuration
+.dir-locals.el
+
+# network security
+/network-security.data
+
+
+### Linux ###
+
+# temporary files which can be created if a process still has a handle open of a deleted file
+.fuse_hidden*
+
+# KDE directory preferences
+.directory
+
+# Linux trash folder which might appear on any partition or disk
+.Trash-*
+
+# .nfs files are created when an open file is removed but is still being accessed
+.nfs*
+
+### macOS ###
+# General
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# Icon must end with two \r
+Icon
+
+# Thumbnails
+._*
+
+# Files that might appear in the root of a volume
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+
+# Directories potentially created on remote AFP share
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+
+### Vim ###
+# Swap
+[._]*.s[a-v][a-z]
+[._]*.sw[a-p]
+[._]s[a-rt-v][a-z]
+[._]ss[a-gi-z]
+[._]sw[a-p]
+
+# Session
+Session.vim
+Sessionx.vim
+
+# Temporary
+.netrwhist
+# Auto-generated tag files
+tags
+# Persistent undo
+[._]*.un~
+
+### Windows ###
+# Windows thumbnail cache files
+Thumbs.db
+Thumbs.db:encryptable
+ehthumbs.db
+ehthumbs_vista.db
+
+# Dump file
+*.stackdump
+
+# Folder config file
+[Dd]esktop.ini
+
+# Recycle Bin used on file shares
+$RECYCLE.BIN/
+
+# Windows Installer files
+*.cab
+*.msi
+*.msix
+*.msm
+*.msp
+
+# Windows shortcuts
+*.lnk
+
+# End of https://www.gitignore.io/api/vim,linux,macos,emacs,windows

data/samples/sample-book/src/config-ebook.yml

@@ -0,0 +1,4 @@
+# call me by 'REVIEW_CONFIG_FILE=config-ebook.yml rake pdf'
+inherit: ["config.yml"]
+pdfmaker:
+  texdocumentclass: ["review-jsbook", "media=ebook,paper=a5"]

data/samples/sample-book/src/config-epub2.yml

@@ -11,7 +11,7 @@ language: ja
 # 書名
 booktitle: Re:VIEWサンプル書籍
 # 固有IDに使用するドメイン。省略した場合は時刻に基づくランダムUUIDが入る
-urnid: urn:uid:http://tatsu-zine.com/books/review-sample-book/1.0.0/
+urnid: urn:uuid:http://tatsu-zine.com/books/review-sample-book/1.0.0/
 # ISBN。省略した場合はurnidが入る
 # isbn: null
 # 著者名。["高橋征義", "John Doe"] のように配列を使うことで複数指定可

data/samples/sample-book/src/config-jlreq-ebook.yml

@@ -0,0 +1,4 @@
+# call me by 'REVIEW_TEMPLATE=review-jlreq REVIEW_CONFIG_FILE=config-jlreq-ebook.yml rake pdf'
+inherit: ["config.yml"]
+pdfmaker:
+  texdocumentclass: ["review-jlreq", "media=ebook,paper=a5"]

data/samples/sample-book/src/config-jlreq.yml

@@ -0,0 +1,6 @@
+# call me by 'REVIEW_TEMPLATE=review-jlreq REVIEW_CONFIG_FILE=config-jlreq.yml rake pdf'
+inherit: ["config.yml"]
+pdfmaker:
+  texdocumentclass: ["review-jlreq", "media=print,paper=a5"]
+  # texdocumentclass: ["review-jlreq", "media=ebook,paper=a5"]
+  # texdocumentclass: ["review-jlreq", "media=print,paper=a5,tombopaper=a4,bleed_margin=3mm,cover=true,Q=14,startpage=3,serial_pagination=true,hiddenfolio=nikko-pc"]

data/samples/sample-book/src/config.yml

@@ -1,9 +1,9 @@
 ## config.yml for sample book
-review_version: 3.0
+review_version: 5.0
 bookname: book
 language: ja
 booktitle: Re:VIEWサンプル書籍
-urnid: urn:uid:http://reviewml.com/books/review-sample-book/
+urnid: urn:uuid:http://reviewml.com/books/review-sample-book/
 # isbn: null
 aut: Re:VIEW Writers
 pbl: Re:VIEW Publishers
@@ -35,7 +35,7 @@ colophon: true
 # font_ext: ["ttf", "woff", "otf"]
 # catalogfile: catalog.yml
 # page_metric: A5
-# page_metric: [40,80,40,80,2]
+# page_metric: [40,34,29,34]
 # direction: "ltr"
 
 epubmaker:

data/samples/sample-book/src/lib/tasks/review.rake

@@ -1,4 +1,4 @@
-# Copyright (c) 2006-2018 Minero Aoki, Kenshi Muto, Masayoshi Takahashi, Masanori Kado.
+# Copyright (c) 2006-2021 Minero Aoki, Kenshi Muto, Masayoshi Takahashi, Masanori Kado.
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
@@ -29,15 +29,26 @@ CATALOG_FILE = ENV['REVIEW_CATALOG_FILE'] || 'catalog.yml'
 WEBROOT = ENV['REVIEW_WEBROOT'] || 'webroot'
 TEXTROOT = BOOK + '-text'
 TOPROOT = BOOK + '-text'
+IDGXMLROOT = BOOK + '-idgxml'
+PDF_OPTIONS = ENV['REVIEW_PDF_OPTIONS'] || ''
+EPUB_OPTIONS = ENV['REVIEW_EPUB_OPTIONS'] || ''
+WEB_OPTIONS = ENV['REVIEW_WEB_OPTIONS'] || ''
+IDGXML_OPTIONS = ENV['REVIEW_IDGXML_OPTIONS'] || ''
+TEXT_OPTIONS = ENV['REVIEW_TEXT_OPTIONS'] || ''
+
+REVIEW_VSCLI = ENV['REVIEW_VSCLI'] || 'vivliostyle'
+REVIEW_VSCLI_USESANDBOX = ENV['REVIEW_VSCLI_USESANDBOX'] ? '' : '--no-sandbox'
+REVIEW_VSCLI_PDF = ENV['REVIEW_VSCLI_PDF'] || BOOK_PDF
+REVIEW_VSCLI_OPTIONS = ENV['REVIEW_VSCLI_OPTIONS'] || ''
 
 def build(mode, chapter)
-  sh "review-compile --target=#{mode} --footnotetext --stylesheet=style.css #{chapter} > tmp"
+  sh("review-compile --target=#{mode} --footnotetext --stylesheet=style.css #{chapter} > tmp")
   mode_ext = { 'html' => 'html', 'latex' => 'tex', 'idgxml' => 'xml', 'top' => 'txt', 'plaintext' => 'txt' }
-  FileUtils.mv 'tmp', chapter.gsub(/re\z/, mode_ext[mode])
+  FileUtils.mv('tmp', chapter.gsub(/re\z/, mode_ext[mode]))
 end
 
 def build_all(mode)
-  sh "review-compile --target=#{mode} --footnotetext --stylesheet=style.css"
+  sh("review-compile --target=#{mode} --footnotetext --stylesheet=style.css")
 end
 
 task default: :html_all
@@ -74,12 +85,17 @@ task web: WEBROOT
 
 desc 'generate text file (without decoration)'
 task plaintext: TEXTROOT do
-  sh "review-textmaker -n #{CONFIG_FILE}"
+  sh "review-textmaker #{TEXT_OPTIONS} -n #{CONFIG_FILE}"
 end
 
 desc 'generate (decorated) text file'
 task text: TOPROOT do
-  sh "review-textmaker #{CONFIG_FILE}"
+  sh "review-textmaker #{TEXT_OPTIONS} #{CONFIG_FILE}"
+end
+
+desc 'generate IDGXML file'
+task idgxml: IDGXMLROOT do
+  sh "review-idgxmlmaker #{IDGXML_OPTIONS} #{CONFIG_FILE}"
 end
 
 desc 'generate EPUB file'
@@ -92,22 +108,37 @@ SRC_EPUB = FileList['*.css']
 SRC_PDF = FileList['layouts/*.erb', 'sty/**/*.sty']
 
 file BOOK_PDF => SRC + SRC_PDF do
-  FileUtils.rm_rf [BOOK_PDF, BOOK, BOOK + '-pdf']
-  sh "review-pdfmaker #{CONFIG_FILE}"
+  FileUtils.rm_rf([BOOK_PDF, BOOK, BOOK + '-pdf'])
+  sh "review-pdfmaker #{PDF_OPTIONS} #{CONFIG_FILE}"
 end
 
 file BOOK_EPUB => SRC + SRC_EPUB do
-  FileUtils.rm_rf [BOOK_EPUB, BOOK, BOOK + '-epub']
-  sh "review-epubmaker #{CONFIG_FILE}"
+  FileUtils.rm_rf([BOOK_EPUB, BOOK, BOOK + '-epub'])
+  sh "review-epubmaker #{EPUB_OPTIONS} #{CONFIG_FILE}"
 end
 
 file WEBROOT => SRC do
-  FileUtils.rm_rf [WEBROOT]
-  sh "review-webmaker #{CONFIG_FILE}"
+  FileUtils.rm_rf([WEBROOT])
+  sh "review-webmaker #{WEB_OPTIONS} #{CONFIG_FILE}"
 end
 
 file TEXTROOT => SRC do
-  FileUtils.rm_rf [TEXTROOT]
+  FileUtils.rm_rf([TEXTROOT])
 end
 
-CLEAN.include([BOOK, BOOK_PDF, BOOK_EPUB, BOOK + '-pdf', BOOK + '-epub', WEBROOT, 'images/_review_math', TEXTROOT])
+file IDGXMLROOT => SRC do
+  FileUtils.rm_rf([IDGXMLROOT])
+end
+
+desc 'run vivliostyle'
+task 'vivliostyle:preview': BOOK_EPUB do
+  sh "#{REVIEW_VSCLI} preview #{REVIEW_VSCLI_USESANDBOX} #{REVIEW_VSCLI_OPTIONS} #{BOOK_EPUB}"
+end
+
+task 'vivliostyle:build': BOOK_EPUB do
+  sh "#{REVIEW_VSCLI} build #{REVIEW_VSCLI_USESANDBOX} #{REVIEW_VSCLI_OPTIONS} -o #{REVIEW_VSCLI_PDF} #{BOOK_EPUB}"
+end
+
+task vivliostyle: 'vivliostyle:build'
+
+CLEAN.include([BOOK, BOOK_PDF, BOOK_EPUB, BOOK + '-pdf', BOOK + '-epub', WEBROOT, 'images/_review_math', 'images/_review_math_text', TEXTROOT, IDGXMLROOT])

data/samples/sample-book/src/lib/tasks/z01_copy_sty.rake

@@ -1,17 +1,23 @@
 desc 'copy sty/* files from current Re:VIEW source code (in git repos)'
+REVIEW_TEMPLATE = ENV['REVIEW_TEMPLATE'] || 'review-jsbook'
 task :copy_sty do
   review_rootdir = '../../..'
-  jsbook_dir = File.join(review_rootdir, 'templates/latex/review-jsbook')
-  gentombow_dir = File.join(review_rootdir, 'vendor/gentombow')
-  Dir.glob(File.join(jsbook_dir, '*.cls')) do |file|
-    FileUtils.cp file, 'sty'
+  template_dir = File.join(review_rootdir, "templates/latex/#{REVIEW_TEMPLATE}")
+  Dir.glob(File.join(template_dir, '*.cls')) do |file|
+    FileUtils.cp(file, 'sty')
   end
-  Dir.glob(File.join(jsbook_dir, 'review-*.sty')) do |file|
-    FileUtils.cp file, 'sty'
+  Dir.glob(File.join(template_dir, 'review-*.sty')) do |file|
+    FileUtils.cp(file, 'sty')
+  end
+
+  if REVIEW_TEMPLATE == 'review-jsbook'
+    jsbook_dir = File.join(review_rootdir, 'vendor/jsclasses')
+    FileUtils.cp(File.join(jsbook_dir, 'jsbook.cls'), 'sty/jsbook.cls')
+    gentombow_dir = File.join(review_rootdir, 'vendor/gentombow')
+    FileUtils.cp(File.join(gentombow_dir, 'gentombow.sty'), 'sty/gentombow.sty')
   end
-  FileUtils.cp File.join(gentombow_dir, 'gentombow.sty'), 'sty/gentombow.sty'
 end
 
-CLEAN.include([Dir.glob('sty/review-*.sty'), 'sty/review-jsbook.cls', 'sty/gentombow.sty'])
+CLEAN.include([Dir.glob('sty/review-*.sty'), 'sty/*.cls', 'sty/gentombow.sty'])
 
 Rake::Task[BOOK_PDF].enhance([:copy_sty])

data/samples/syntax-book/Gemfile

@@ -1,4 +1,4 @@
 source 'https://rubygems.org'
 
 gem 'rake'
-gem 'review', '2.3.0'
+gem 'review', '4.2.0'

data/samples/syntax-book/ch01.re

@@ -104,7 +104,7 @@ olnumで一応番号が変更可能なことを期待していますが、Webブ
 === 用語リスト
 用語リスト（HTMLの@<i>{dl}、TeXの@<i>{description}）は@<i>{スペース}+@<tt>{:}+@<i>{スペース}で見出しを、説明は行頭にタブかスペースを入れて表現します。
 
- : Alpha@<b>{bold太字}@<i>{italicイタ}@<tt>{等幅code}
+ : Alpha@<b>{bold太字}@<i>{italicイタ}@<tt>{等幅code}@<fn>{foot1}
 	@<i>{DEC}の作っていた@<b>{RISC CPU}。@<i>{italicイタ}@<tt>{等幅code}
 	浮動小数点数演算が速い。
  : POWER
@@ -114,6 +114,8 @@ olnumで一応番号が変更可能なことを期待していますが、Webブ
 	Sunが作っているRISC CPU。
 	CPU数を増やすのが得意。
 
+//footnote[foot1][箇条書き見出しへの脚注。]
+
 //emlist{
 @<b>{bold太字}@<i>{italicイタ}
 

data/samples/syntax-book/ch02.re

@@ -49,9 +49,9 @@ print('hello');
 puts 'Hello'
 //}
 
-#@# //source{
-#@# //}
-#@# FIXME:キャプションなしはLaTeXだとエラーになることがわかった。Re:VIEW側修正予定
+//source{
+puts 'Hello'
+//}
 
 実行例を示すとき用にはcmdを用意しています。いずれにせよ、商業書籍レベルでは必要なので用意しているものの、原稿レベルで書き手が使うコードブロックはほどほどの数に留めておいたほうがいいのではないかと思います。TeX版の紙面ではデフォルトは黒アミ。印刷によってはベタ黒塗りはちょっと怖いかもなので、あまり長々したものには使わないほうがいいですね。
 
@@ -62,12 +62,7 @@ $ @<b>{ls /}
 === 図
 採番・キャプション付きの図の貼り付けはimageを使用します（@<img>{ball}）。図版ファイルは識別子とビルダが対応しているフォーマットから先着順に探索されます。詳細については@<href>{https://github.com/kmuto/review/wiki/ImagePath, ImagePath}のドキュメントを参照してください。
 
-@<fn>{madebygimp}
-本当はimageのキャプションにfootnoteを付けたいのですが、TeXではエラーになりますね。厳しい……。
-#@# FIXME:TeXのキャプションfootnote問題
-
-#@# //image[ball][ボール@<fn>{madebygimp}]{
-//image[ball][ボール]{
+//image[ball][ボール@<fn>{madebygimp}]{
 //}
 
 //footnote[madebygimp][GIMPのフィルタで作成。@<br>{}footnote内改行]
@@ -86,11 +81,8 @@ $ @<b>{ls /}
 === 表
 表はtableを使います。@<table>{tab2-1}
 
-tableもキャプション・セル内含めてTeXでは脚注できないですね…
-本当は→@<fn>{tabalign}はキャプション内。TeXだとセル内の脚注は脚注文書が消えています。
-
-#@# //table[tab2-1][表の@<b>{例}@<fn>{tabalign}]{
-//table[tab2-1][表の@<b>{例}]{
+//table[tab2-1][表の@<b>{例}@<fn>{tabalign}]{
+#@#//table[tab2-1][表の@<b>{例}]{
 A	B	C
 ----------------------------------
 D	E@<b>{太字bold}@<i>{italicイタ}@<tt>{等幅code}	F@<br>{}G
@@ -111,7 +103,7 @@ D	E@<b>{太字bold}@<i>{italicイタ}@<tt>{等幅code}	F@<br>{}G
 H	I	長いセルの折り返し■□■□■□■□■□■□■□■□■□■□■□■□■□■□■□■□■□■□■□■□■□
 //}
 
-TeXの普通のクラスファイルだと、列指定はl,c,r,p（幅指定+左均等）しかないので、幅指定+左寄せ（均等なし）、幅指定+中寄せ、幅指定+右寄せの指定ができると嬉しそうです。
+TeXの普通のクラスファイルだと、列指定はl,c,r,p（幅指定+左均等）しかないのですが、Re:VIEWのスタイルファイルでL（幅指定+左寄せ，均等なし）、C（幅指定+中寄せ）、R（幅指定+右寄せ）を指定可能です。
 
 あとは縦に長い表がTeXだとそのままはみ出してしまうのでlongtableがあるけれどもそれはまた問題がいろいろあり……。
 
@@ -263,7 +255,7 @@ Tips。@<b>{太字bold}@<i>{italicイタ}@<tt>{等幅code}
 #@# doorquote、bpo、talk、graph、address、box、linebreak、pagebreak、hr、comment、abbr、acronym、dfn、kbd、q、samp、var、big、small、del、ins、recipe、dtp、raw、embed、include
 
 == LaTeX式
-LaTeX式はTeX紙面以外は保証されません。EPUBではMathML（@<tt>{mathml: true}）を使えますが、表現や互換性が不足しており、LaTeXをバックエンドとして画像化する@<tt>{imgmath: true}のほうがよさそうです。
+LaTeX式はTeX紙面以外は保証されません。EPUBではMathML（@<tt>{math_format: mathml}）を使えますが、表現や互換性が不足しており、LaTeXをバックエンドとして画像化する@<tt>{math_format: imgmath}のほうがよさそうです。
 
 //texequation{
 \sum_{i=1}^nf_n(x)
@@ -293,7 +285,7 @@ a_{m1} & \cdots & a_{mn}
 #@# 場所ラベル定義
 
 === 書体
-本文での……キーワード@<kw>{キーワード, keyword}@<fn>{kw}、太字@<b>{b太字}、イタリック@<i>{iイタリック}、等幅@<tt>{tt等幅}、強調@<strong>{strong強調}、強調@<em>{em強調}、下線@<u>{u下線}、等幅@<code>{code等幅}、等幅太字@<ttb>{ttb等幅太字}、等幅イタリック@<tti>{tti等幅イタリック}、網カケ@<ami>{amiアミ}、16進UTF文字指定@<uchar>{3042}、インラインアイコン@<icon>{inlineicon}
+本文での……キーワード@<kw>{キーワード, keyword}@<fn>{kw}、太字@<b>{b太字}、イタリック@<i>{iイタリック}、等幅@<tt>{tt等幅}、強調@<strong>{strong強調}、強調@<em>{em強調}、下線@<u>{u下線}、等幅@<code>{code等幅}、等幅太字@<ttb>{ttb等幅太字}、等幅イタリック@<tti>{tti等幅イタリック}、網カケ@<ami>{amiアミ}、挿入@<ins>{ins挿入}、削除@<del>{del削除}、16進UTF文字指定@<uchar>{3042}、インラインアイコン@<icon>{inlineicon}
 
 傍点@<embed>{@}<bou>{bou傍点}、ルビ@<embed>{@}<ruby>{愕然, がくぜん}、縦中横@<embed>{@}<tcy>{90}、はTeXでは現状、別パッケージが必要です。
 #@# FIXME:TEXでの文字スタイル。外部パッケージが必要
@@ -307,23 +299,25 @@ a_{m1} & \cdots & a_{mn}
 
 //footnote[kw][キーワードのカッコは太字にしないほうがいいのかなと思いつつあります（手元の案件では太字にしないよう挙動を変えてしまっているほうが多い）。]
 
- * 箇条書き内での……キーワード@<kw>{キーワード, keyword}、太字@<b>{b太字}、イタリック@<i>{iイタリック}、等幅@<tt>{tt等幅}、強調@<strong>{strong強調}、強調@<em>{em強調}、下線@<u>{u下線}、等幅@<code>{code等幅}、等幅太字@<ttb>{ttb等幅太字}、等幅イタリック@<tti>{tti等幅イタリック}、網カケ@<ami>{amiアミ}、16進UTF文字指定@<uchar>{3042}、インラインアイコン@<icon>{inlineicon}
+ * 箇条書き内での……キーワード@<kw>{キーワード, keyword}、太字@<b>{b太字}、イタリック@<i>{iイタリック}、等幅@<tt>{tt等幅}、強調@<strong>{strong強調}、強調@<em>{em強調}、下線@<u>{u下線}、等幅@<code>{code等幅}、等幅太字@<ttb>{ttb等幅太字}、等幅イタリック@<tti>{tti等幅イタリック}、網カケ@<ami>{amiアミ}、挿入@<ins>{ins挿入}、削除@<del>{del削除}、16進UTF文字指定@<uchar>{3042}、インラインアイコン@<icon>{inlineicon}
 
 //tsize[|latex|p{120mm}]
 //table{
-表内での……キーワード@<kw>{キーワード, keyword}、太字@<b>{b太字}、イタリック@<i>{iイタリック}、等幅@<tt>{tt等幅}、強調@<strong>{strong強調}、強調@<em>{em強調}、下線@<u>{u下線}、等幅@<code>{code等幅}、等幅太字@<ttb>{ttb等幅太字}、等幅イタリック@<tti>{tti等幅イタリック}、網カケ@<ami>{amiアミ}、16進UTF文字指定@<uchar>{3042}、インラインアイコン@<icon>{inlineicon}
+表内での……キーワード@<kw>{キーワード, keyword}、太字@<b>{b太字}、イタリック@<i>{iイタリック}、等幅@<tt>{tt等幅}、強調@<strong>{strong強調}、強調@<em>{em強調}、下線@<u>{u下線}、等幅@<code>{code等幅}、等幅太字@<ttb>{ttb等幅太字}、等幅イタリック@<tti>{tti等幅イタリック}、網カケ@<ami>{amiアミ}、挿入@<ins>{ins挿入}、削除@<del>{del削除}、16進UTF文字指定@<uchar>{3042}、インラインアイコン@<icon>{inlineicon}
 //}
 
 コードブロック内では対応装飾は減らしてよいと考えます。代わりにballoonが追加されます。
 
-//emlist[キャプション内での……キーワード@<kw>{キーワード, keyword}、太字@<b>{b太字}、イタリック@<i>{iイタリック}、等幅@<tt>{tt等幅}、強調@<strong>{strong強調}、強調@<em>{em強調}、下線@<u>{u下線}、等幅@<code>{code等幅}、等幅太字@<ttb>{ttb等幅太字}、等幅イタリック@<tti>{tti等幅イタリック}、網カケ@<ami>{amiアミ}、16進UTF文字指定@<uchar>{3042}、インラインアイコン@<icon>{inlineicon}]{
+//emlist[キャプション内での……キーワード@<kw>{キーワード, keyword}、太字@<b>{b太字}、イタリック@<i>{iイタリック}、等幅@<tt>{tt等幅}、強調@<strong>{strong強調}、強調@<em>{em強調}、下線@<u>{u下線}、等幅@<code>{code等幅}、等幅太字@<ttb>{ttb等幅太字}、等幅イタリック@<tti>{tti等幅イタリック}、網カケ@<ami>{amiアミ}、挿入@<ins>{ins挿入}、削除@<del>{del削除}、16進UTF文字指定@<uchar>{3042}、インラインアイコン@<icon>{inlineicon}]{
 コードブロック内での……
 太字@<b>{b太字}
 イタリック@<i>{iイタリック}
 下線@<u>{u下線}
 網カケ@<ami>{amiアミ}    @<balloon>{ふきだし説明}
+挿入@<ins>{ins挿入}、削除@<del>{del削除}
 //}
 
+=== 見出し内 @<b>{BOLD},@<i>{ITALIC},@<tt>{TT},@<strong>{STRONG},@<em>{EM},@<code>{CODE},@<ttb>{TTB},@<tti>{TTI},@<ami>{AMI},@<bou>{BOU},@<kw>{KW},@<u>{UNDERLINE},@<ins>{INS}、@<del>{DEL}
 
 ==={crossref} 参照
 #@# FIXME:任意ラベルを使うと、EPUBチェックエラーになることがある？
@@ -331,7 +325,6 @@ a_{m1} & \cdots & a_{mn}
  * 章番号：@<chap>{ch01}、@<chap>{appA}、@<chap>{part2}、@<chap>{bib}
  * 章題：@<title>{ch01}、@<title>{part2}、@<title>{appA}、@<title>{bib}
  * 章番号+題：@<chapref>{ch02}、@<chapref>{part2}、@<chapref>{appA}、@<chapref>{bib}
-#@# FIXME:TeXで、部が実際のページではIIなのに参照では2になっているのはおかしい→i18n.ymlがおかしいせいか
 
 節や項への参照はhdを使います。
 
@@ -347,10 +340,24 @@ labelで定義したラベルへの参照の例です。EPUBだと@<href>{#inlin
 #@# FIXME:EPUB側にTeXのほうを寄せるようにRe:VIEWコードを直す
 #@# FIXME:TeXではpagerefがほしい、ということがありそう。EPUBとの整合性を検討
 
+説明箇条書きはTeXで特殊な扱いをしているため、参照の確認を以下でしておきます。
+
+ : @<chap>{ch01}
+	章番号
+ : @<title>{ch01}
+	章題
+ : @<chapref>{ch01}
+	章番号+題
+ : @<hd>{ch02|crossref}
+	節
+ : @<column>{ch03|column2}
+	コラム参照
+
 === 参考文献
 参考文献@<tt>{bib.re}ファイルへの文献参照は、@<bib>{lins}とします。
 
 === 索引
 @<hidx>{索引}@<hidx>{index}索引はTeXとIDGXML以外では妥当な動作を定義していません。idx@<hidx>{索引<<>>idx}は文中にも表示し、hidx@<hidx>{索引<<>>hidx}は文中からは隠した形の索引にします。読みは@<idx>{Mecab}があればそちらを使いますが、@<idx>{辞書ファイル}を直接定義することもできます。@<hidx>{!<>"$&()~=|,./\{\}?_[]*:;+%#()'`^}
+@<hidx>{|}@<hidx>{{}@<hidx>$}$
 
 idx, hidxいずれも=見出しの中には入れないようにし、後続の段落先頭にhidxで入れるように注意します（入れてしまうと目次などがおかしくなります）。