安装Rust
安装Rust编译器和相关工具:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
运行此命令后,Rust和cargo工具会被安装到你的系统中。
安装Surfboard
使用cargo安装Surfboard:
cargo add https://crates.io/dependencies/surfboard-builder
这将在你的项目中添加Surfboard的依赖。
创建新项目
创建一个新的Surfboard项目目录:
mkdir my-surfsboard-project cd my-surfsboard-project cargo new
这将创建一个新的Rust项目结构,包含必要的配置文件。
配置Surfboard
在项目根目录中,创建或编辑surfslice.json文件:
{
"name": "My Surfboard Project",
"author": "Your Name",
"description": "A static site built with Surfboard",
"version": "1..",
"build": {
"out-dir": "public",
"public-dir": "public",
"cache": true,
"debug": false,
"release": true
},
"surfslice": {
"default": "surfslice",
"components": {
"surfslice": {
"path": "src/surfslice.rs",
"components": {
"h1": {
"path": "src/components/h1.rs",
"content": true
}
}
}
}
}
}
保存并关闭文件。
创建HTML内容
在public目录中,创建index.html文件:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.">Surfboard Site</title>
<script src="{{ sb-vendors }}/js/surfboardRuntime.js"></script>
<script src="{{ sb-vendors }}/js/surfsliceRuntime.js"></script>
</head>
<body>
<h1>{{ sb-slice h1 }}</h1>
</body>
</html>
确保文件路径正确。
生成静态网站
在项目根目录中运行以下命令,生成静态网站:
cargo run --out-dir public ```转换为静态文件并生成到`public`目录中。 ### 7. 测试生成的网站 打开`public/index.html`在浏览器中查看,确保内容正确显示。 ### 8. 进一步配置(可选) 如果需要集成前端框架(如Vue或React),可以修改`surfslice.json`中的`components`配置,添加相应的组件配置。 ### 常见问题 - **错误信息**:检查Cargo.toml是否正确,确保依赖项被正确添加。 - **路径问题**:确保`surfslice.json`和HTML文件的路径正确。 - **生成错误**:检查生成的静态文件是否有错误,可能需要重新运行命令。 通过以上步骤,你应该能够成功配置并生成一个基于Surfboard的静态网站。









