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)
:将帖子正文插入帖子或索引模板(索引模板将显示最多任何[[MORE]]
标记)。
$(POST_PERMALINK)
:将帖子永久链接插入帖子或索引模板中。
帖子应采用 Markdown 格式,并应遵循YYYYMMDD.md
命名约定(也支持.markdown
文件扩展名)。
posts/
目录应至少包含两个子目录:
drafts
:这是您应该放置 Markdown (.md) 文件以进行发布的位置。
published
:Blip 将在此目录中生成 HTML index*.html
并发布页面。您应该将此目录的内容用于您的网站。
已发布的帖子根据文件名中的日期进行组织。例如,文件名为20171220.md
的帖子将发布在以下路径: posts/published/2017/12/20.md
。目前,Blip 每天只支持一篇文章,主要是因为我不经常写博客......
published/stylesheets/
:默认模板使用包含的index.css
作为样式表。如果需要,您可以将其他 CSS 文件放在此处并在模板中引用,
published/images/
:将你的图像放到这里,你可以在 Markdown 中引用它们,如下所示: ![image](/images/someimage.jpg)
使用正确的文件名约定 ( YYYYMMDD.md
) 用 Markdown 编写帖子,然后将其放入drafts/
目录中。
然后运行以下命令:
./blip /path/to/your/blog/ -r
-r
通过发布drafts/
目录中的所有 Markdown 文件来重建整个站点。
-w
监视drafts/
目录中的新 Markdown 文件并自动发布它们。
-i
仅重建站点index*.html
页面。
-h
显示帮助。
使用 Swift 的简单易用/扩展文件系统观察器。
Swift 中的 Markdown 渲染速度极快,基于 cmark。
请访问我的个人网站,获取 Blip 的使用示例。