#static-site-generator #static #site #generator #tera-templates

已删除 fa维亚

无配置、以内容为中心的静态网站生成器

0.1.6 2023年11月11日
0.1.5 2023年11月11日
0.1.4 2023年3月28日
0.1.1 2023年2月3日

#44 in #tera-templates

MIT 协议

30KB
538

fa维亚 🪸

注意:我不再开发此项目。如果您正在寻找一个用Rust编写的具有所有以下描述的功能以及更多功能的静态网站生成器,我建议您检查zola

有时我有一些内容,我想将其放入网站中。我宁愿不深入研究某些JavaScript框架,只是为了将内容和HTML粘合在一起。因此,我制作了fa维亚

fa维亚是用Rust编写的轻量级静态网站生成器。它是无配置的。只需描述您的Tera模板,以及您的Markdown内容,然后fa维亚将它们拼接在一起。

快速入门

首先,确保您已安装Rust工具链,可以使用rustup完成此操作。有关更多详细信息,请参阅此处

$ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

然后,使用cargo安装fa维亚

$ cargo install favia

最后,使用fa维亚 new 项目名称命令创建一个新项目。以下命令创建了一个名为my_favia_project的项目

$ favia new my_favia_project

然后,您可以运行开发服务器并开始开发。

$ cd my_favia_project && favia develop

API

有三个命令

fa维亚 build构建一个包含HTML、CSS和静态文件的包,以便提供。构建输出存储在.fa维亚目录中。

fa维亚 develop运行开发服务器,侦听更改并重新构建。

fa维亚 new 项目名称使用指定的名称创建一个新项目,并包含所有必要的文件夹和文件以开始。

您可以选择是否希望输出详细,这会更改日志级别。fa维亚 -v build包括调试日志,而fa维亚 -vv build包括跟踪日志。默认为info级别日志。

项目结构

一个fa维亚项目有三个目录

├── content
├── templates
└── static

content包含一个子目录树和/或Markdown文件,可选带有TOML前置内容,周围环绕着+++

templates包含一个子目录树和/或Tera模板。

static包含所有静态文件,包括CSS文件、图像和字体。

favia 从这两个文件夹中确定网站结构。

待办事项

查看开放问题

贡献

如果您发现了一个错误,请随时提交问题;如果您想参与开发,请创建一个描述您要解决的问题的工单,并在拉取请求中引用该工单。

依赖项

~24–56MB
~1M SLoC