39 个版本

0.6.5 2024年8月8日
0.6.3 2024年5月3日
0.6.2 2024年2月23日
0.6.1 2023年12月20日
0.0.0 2022年9月23日

#221 in Web编程

Download history 166/week @ 2024-05-03 3/week @ 2024-05-10 13/week @ 2024-05-17 8/week @ 2024-05-24 1/week @ 2024-05-31 1/week @ 2024-06-07 1/week @ 2024-06-14 1/week @ 2024-06-21 8/week @ 2024-07-05 98/week @ 2024-07-26 85/week @ 2024-08-02 54/week @ 2024-08-09

每月237 次下载

MIT/Apache

1.5MB
7.5K SLoC

Rust 5.5K SLoC // 0.1% comments JavaScript 812 SLoC // 0.1% comments Jinja2 581 SLoC // 0.0% comments Handlebars 270 SLoC // 0.1% comments

oranda

🎁 为您的项目生成美丽的着陆页

crates.io CI release web

oranda 是一个有偏见的静态站点生成器,专为那些发布项目并希望拥有网站但不想从头开始构建的开发者设计。

oranda 使用 oranda,因此您可以在这里 查看一个实时示例

安装

要安装 oranda,请访问由 oranda 生成的 oranda 网站

快速入门

# build your site
> oranda build

# build your site and start a server that rebuilds on file changes
> oranda dev

这是一个动画演示

oranda demo gif

配置

首先:oranda 设计为无需配置文件即可工作。对于许多项目,您可能只需运行 oranda build,就可以获得一个包含一些 oranda 自动能够获取的项目信息的网站。尽管如此,它也支持配置文件,允许您调整许多关于 oranda 行为的设置。

如果您想配置 oranda,请将一个 oranda.json 文件放置在您项目的根目录中,并填写您想要的配置。查看 文档 了解更多关于配置选项的信息!

安装程序:与 cargo-dist 集成

orandacargo-dist 集成良好,这是一个为您的Rust应用程序构建可分发工件的工具。如果您的项目正确配置了 cargo-dist,则 oranda 将能够自动检测。与 cargo-dist 集成的优势包括

  • 安装脚本:使用 cargo-dist 可以生成一行安装脚本,该脚本将由 oranda 显示在生成的页面中
  • 保证的平台支持:虽然 oranda 尽可能支持更多平台,但如果你使用 cargo-dist 构建某些内容,我们保证它将正确显示

贡献

如果你发现有什么不妥或想提出新功能请求,请随意打开一个新的问题或拉取请求!我们有时会对我们认为适合新贡献者学习体验的问题标记为 good first issue

关于在 oranda 上进行本地开发,我们还提供了一个特别的文档页面,其中包含一些技巧:特殊文档页面

依赖项

~48–65MB
~1M SLoC