青葉台旭のノートブック

生成されたHTML記事ファイルの保存場所は、相変わらず階層化されていない。

生成された記事HTMLファイルの保存場所は、元のMarkdownファイルの階層がどこであれ、 「notebook/」 という１つのディレクトリに保存される。 最終形態であるHTMLファイルは、整理・分類のしやすさよりも、リンクの永続性の方が 大事だと思ったからだ。

たとえば、何かの間違いで、５月の記事を「notebook_md/month04/entry.txt」として保存したとする。 当然、これを正しいディレクトリである「notebook_md/month05/」に移動したくなる。 このとき、元のMarkdown原稿と同じディレクトリ構造でHTML最終出力を行ってしまうと、 次回ビルドした時にentry.htmlのurlが変わってしまう。これは頂けない。

元のディレクトリ構造がどうであれ、最終的なHTMLファイルの置き場所を「notebook/」ディレクトリ１つに 絞ってしまえば、元記事のディレクトリはどこにでも自由に変更できる（元記事がどこにあろうとHTMLファイルの 永続性が保証される）

HTMLファイルの置き場所を固定したため、元記事サブディレクトリに同じファイル名は使えない

たとえば 「notebook_md/month2017/month04/entry.txt」 「notebook_md/month2017/month05/entry.txt」 という二つの記事があったとする。 この二つは、当然、別のファイルである。 しかし、これをHTML生成時に１つのHTML保存用ディレクトリに保存しようとすると、これも当然の話だが、 ベースネームが同じ「entry.txt」→「entry.html」になってしまって、競合する。 そこで、ベースネームが同じファイルを（別々のサブディレクトリで）見つけた場合、HTML生成時にエラーを出力して 生成が停止するようにした。

とにかく、URLの永続性（パーマネント）こそが大事だ。

リンク切れは、よろしくない。 上のような仕様にしたので元のMarkdown記事の置き場所を自由に変更しても良くなった。 どのように元記事を分類しようともHTMLのリンクには影響しない。

将来何千何万ものHTMLファイルが１つのディレクトリ格納されることになる

このサイトを末永く管理し続ければ、いずれ何千何万ものHTML記事が１つのディレクトリの中に生成されるだろう。 その巨大なディレクトリには、index.htmlや、タグ別のリンク・リストHTMLファイルで管理する。 つまり元記事のMarkdownはディレクトリ構造で分類し、出力先のHTMLディレクトリはインデックスファイルなど HTMLのリンクで分類・管理するという事だ。