marmite

Marmite

Marmite [Markdown makes sites] 是一个非常简单的静态网站生成器。

我是其他 SSG 的忠实用户,但经常感到沮丧的是,要开始使用需要进行大量设置。 仅仅有一个 markdown 文件目录并运行一个命令就显得非常有用。 — Michael, marmite 用户。

它是如何工作的

它只做 "一个" 简单的事情:

• 读取 input 目录下的所有 .md 文件。
• 使用 CommonMark 解析为 HTML 内容。
• 从 frontmatter 或 filename 中提取可选元数据。
• 为每个页面生成 html 文件。
• 将渲染的静态网站输出到 output 文件夹。

在开始之前,您应该了解以下内容: 1. Marmite 旨在简化操作,请不要期望具有复杂的功能。 2. Marmite 适用于 博客 使用者,因此按时间顺序编写和发布文章是主要的使用场景。 3. 生成的静态网站默认使用扁平 HTML(./{name}.html|rss|json)。 工作空间可以生成基于子目录的多站点布局。 4. 目录: tags:, stream:, series:, authors:, 和 languages: (i18n) 5. Marmite 使用 date: 属性来区分 posts 和 pages

• 所有内容都嵌入到单个二进制文件中。 - 可零配置即可开始使用。 - 可通过 marmite.yaml 进行全面配置 - 可配置 Markdown 解析器（CommonMark 扩展、渲染选项） - Common-mark + GitHub 标记 Markdown + 扩展 - 支持原始 HTML - 支持表情符 :smile:, 曝光 ||secret|| - 支持 Wikilink [[name|url]] 和 Obsidian 链接 [[page]] - 支持 Markdown 提示 (GitHub 样式提示) - 支持后向链接和相关内容 - 支持标签 - 支持多作者和个人主页 - 支持多流 (不同列表中的独立内容) - 支持系列 (有导航的有序、按时间顺序排列的内容组) - 支持语言流/多语言 (自动发现、翻译链接、hreflang SEO 标签) - 支持草稿内容管理 (过滤来自 RSS 订阅和搜索) - 支持分页 - 支持内联匹配预览的静态搜索索引 - RSS 订阅 (索引、标签、作者、流、语言) - 上一页/下一页