Comments (11)
節が登場するごとにメタデータを書くのは想定してません。
メタデータはファイルに対して 1 vs 1 です。
正直、メタデータを追加して欲しいというのは gihyo さんからのリクエストだった & gihyo で各見出しレベルを何に使って要るかはぼくはよく知らないので、それをぼくに聞かれても困る話ではありますが・・・
from md2inao.
ここは @inao さんの出番ではありますが、整合性がとれるようにするには
- "Serial" で節番号を宣言する場合、1つのファイルの中では節は1つに限定する
- つまり、1ファイル1節形式
- ※ 見出しレベル1 (
#
一個) がその節タイトル相当なのか、項なのかは曖昧なので決める必要
- 1つのファイルの中で節を2つ以上記述する場合は Serial 宣言をしない
- つまり、1ファイル1章形式
- ※ 見出しレベル1 (
#
一個) がその章タイトル相当なのか、節なのかは曖昧なので決める必要
という仕様になるでしょうかね。
前者後者の形式をごちゃまぜにした場合、節番号から自動で図の採番をするのは難しくなるでしょうね。
そのタイトル全体でどちらか一方の形式しか使わないように限定できれば、いずれの方式になっても自動採番するような仕様に仕上げることはできると思います。
from md2inao.
いまの md2inao は
- 「見出しレベル1, 2, 3 はこういう文字列に変換」するというルール
- つまり Markdown と HTML/InDesign タグの紐付けルール
は持っていますが、そのもう一層上のレイヤである
- 「見出しレベル1 が章に対応し、レベル2が節に対応する」というルール
- つまり Markdown の構造と技術評論社の業務仕様の紐付けルール
に関しては関与していないのが現状です。また、後者の技術評論社の「業務仕様ルール」は明文化されていない。だから、執筆者ごとにレベル1を章に使ったり節に使ったり、と同じ論理構造でも別のセマンティクスを紐づけるようになっています。
いま議論しているのは、その後者の部分ですね。
from md2inao.
現状は、見出しレベル1が節(大見出し、#、h1)に対応するという業務仕様ルールで統一しています(いるつもりです)。
ただ、この仕様自体を見直すというのもありだと思っています。
見出しレベル1を章に使ってお書きはじめる方も多く、アウトラインや草稿段階で「#は章ではなく大見出しに使ってくださいー」というやりとりをすることも多いので。これをどちらにするかは、ご執筆者の方がやりやすいほうでかまいません。
それにもよるのですが、現状の業務仕様ルールのままでいく場合、以下にするのはいかがでしょうか?
- 章ごとにテキストファイルを分割する
- 節番号をふる/ふらないをプログラムで選択できるようにしていただく
節番号をふる場合は、以下のように変換していただきたいです。
--- in md2inao
Chapter: 3
# hello
# world
--- expected
<ParaStyle:章番号・連載回数>章番号:第3章
<ParaStyle:見出し0.0>3.1
<ParaStyle:大見出し>hello
<ParaStyle:見出し0.0>3.2
<ParaStyle:大見出し>world
メタデータのChapter
から章番号を取得していただき、大見出し(#)の順番に沿って上記のように連番をふっていただく機能をご追加いただくというイメージです。
from md2inao.
節番号を振る、振らないはメタデータのあり・なしで判定すれば良さそうですね。
了解です。
で、そうなると本の書き方も今からちょっと変更の必要があります > @d-ikeda
時間がないのでこういう形式になりそうだってことだけ例のスレッドにコメントしておきます。
from md2inao.
ありがとうございます!
節番号を振る、振らないはメタデータのあり・なしで判定すれば良さそうですね。
どういったメタデータでの判定になりそうでしょうか?
なお、書籍の場合に必ず節番号を振るわけではなく、書籍によっても振ったり振らなかったりします。
from md2inao.
僕も @inao さんの方法でいつも行っています。
で、そうなると本の書き方も今からちょっと変更の必要があります > @d-ikeda
時間がないのでこういう形式になりそうだってことだけ例のスレッドにコメントしておきます。
ありがとうございます!
from md2inao.
書籍の場合に必ず節番号を振るわけではなく、書籍によっても振ったり振らなかったりします。
そうなんですね。そうすると別途自動採番のためのメタデータが必要になりそうだなあ。
まあとりあえず現状はそういう要件の本では使ってないっぽいので、仕様そのものはそれが必要になったときに考えましょう。
そもそも、まずは自動採番機能の方を作らないといけない。
from md2inao.
了解いたしました
ありがとうございます!
from md2inao.
いったん close で。
from md2inao.
ありがとうございます!
from md2inao.
Related Issues (20)
- Webアプリケーション版の自動デプロイ HOT 4
- 不要な半角スペースの除去 HOT 4
- 段落字下げ HOT 5
- タブ区切りのテーブル記法 HOT 1
- 注釈内のバッククォートで囲まれた中の閉じカッコは無視する
- 自動段落分け機能を削除する HOT 4
- 節番号の自動化
- InDesignフォームへの配置 HOT 4
- Heroku デプロイに失敗する HOT 16
- 行頭の半角スペースが全角スペースに置き換えられないようにする HOT 2
- Markdownのfootnote記法に対応してほしい
- 旧記法への変換機能を削除する?
- コードブロック中に不要な全角スペースが入る HOT 1
- コードブロック中の`[]:`がなくなる HOT 1
- 数式を使い始めました。UseMath: true HOT 2
- ...
- 表のキャプションに「表1::」などがない場合、キャプションが消える
- コラムのコードブロック中の`<tag>`がなくなる
- ulタグ単体だと変換されない
- リポジトリ招待のお礼
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from md2inao.