BLIPは、テンプレートとサイト組織に特定のディレクトリ構造を使用します。デモについては、 example-site/
ディレクトリを参照するか、完全な説明について読んでください。
テンプレートは、サイトのインデックスと投稿ページのレイアウトガイドです。以下はconfig/templates/
:
index_template.html
:サイトのメインインデックスページ。
index_post_template.html
:インデックスページの投稿プレビューのレイアウト。
post_template.html
:個々の投稿ページのレイアウト。
Blipは、一般的なタスクとテキストの置き換えにいくつかのカスタム「トークン」を使用します。 Config.swift
使用して、交換用文字列をカスタマイズします。
マークダウン(投稿):
[[MORE]]
: index*.html
ページのこの時点で投稿を壊し、完全な投稿へのRead More
リンクを挿入します。テンプレート:
$(COPYRIGHT)
:カスタム著作権文字列をインデックステンプレートに挿入します。
$(POSTS)
:ポストスニペットのリストをインデックステンプレートに挿入します。
$(POSTS_OLDER)
:「古い投稿」リンクをインデックステンプレートに挿入します。
$(POSTS_NEWER)
:「新しい投稿」リンクをインデックステンプレートに挿入します。
$(POST_TITLE)
:投稿タイトルを投稿またはインデックステンプレートに挿入します。
$(POST_TIMESTAMP)
:投稿タイムスタンプを投稿またはインデックステンプレートに挿入します。
$(POST_BODY)
:ポスト本体をPOSTまたはインデックステンプレートに挿入します(インデックステンプレートは[[MORE]]
トークンに表示されます)。
$(POST_PERMALINK)
:PORMALINKを投稿またはインデックステンプレートに挿入します。
投稿はマークダウン形式である必要があり、 YYYYMMDD.md
ネーミング条約に従う必要があります( .markdown
ファイル拡張子もサポートされています)。
posts/
ディレクトリには、少なくとも2つのサブディレクトリを含める必要があります。
drafts
:これは、公開用にマークダウン(.MD)ファイルを配置する必要がある場所です。
published
:BLIPは、このディレクトリにHTML index*.html
と投稿ページを生成します。このディレクトリのコンテンツをWebサイトに使用する必要があります。
公開された投稿は、ファイル名の日付に従って編成されています。たとえば、Filename 20171220.md
の投稿は、次のパスで公開されます: posts/published/2017/12/20.md
。現在、Blipは1日に1回の投稿のみをサポートしています。
published/stylesheets/
:デフォルトのテンプレートは、含まれているindex.css
スタイルシートとして使用します。ここに他のCSSファイルをドロップし、必要に応じてテンプレートで参照できます。
published/images/
:ここに画像をドロップすると、次のようにマークダウンで![image](/images/someimage.jpg)
を参照できます。
正しいFilename Convention( YYYYMMDD.md
)を使用して、Markdownに投稿を書き、 drafts/
ディレクトリにドロップします。
次に、次のコマンドを実行します。
./blip /path/to/your/blog/ -r
-r
drafts/
ディレクトリにすべてのマークダウンファイルを公開することにより、サイト全体を再構築します。
-w
新しいマークダウンファイルのdrafts/
ディレクトリを監視し、自動的に公開します。
-i
サイトindex*.html
ページのみを再構築します。
-h
ヘルプを表示します。
Swiftを使用した簡単な使いやすい /拡張ファイルシステムウォッチャー。
CMARKに基づいて構築されたSwiftでの燃えるような高速マークダウンレンダリング。
使用中のBLIPの例については、私の個人サイトにアクセスしてください。