Staticgen 静态网站生成器入门指南：如何将动态网站转换为静态版本

【免费下载链接】staticgenStatic website generator that lets you use HTTP servers and frameworks you already know项目地址: https://gitcode.com/gh_mirrors/sta/staticgen

Staticgen 是一款让你能够使用已熟悉的 HTTP 服务器和框架的静态网站生成器。只需告诉 Staticgen 如何启动服务器，它就会爬取你的网站并生成包含所有所需页面和资源的静态版本，是将动态网站转换为静态版本的高效工具。

🚀 为什么选择 Staticgen？

传统的静态网站生成方式可能需要学习新的框架或工具，而 Staticgen 打破了这一限制。它允许开发团队使用任何熟悉的 HTTP 服务器和框架，无论使用何种编程语言。如果你对使用 wget 命令从动态网站输出静态网站的方法有所了解，Staticgen 正是为相同理念而专门构建的现代工具。

与依赖无头浏览器进行预渲染的工具不同，Staticgen 不需要此类技术，这使得它的速度更快。不过需要注意的是，这意味着你不能依赖客户端 JavaScript 来操作页面内容。

⚙️ 核心功能与工作原理

Staticgen 的工作流程简洁高效：

1. 执行你提供的服务器启动命令
2. 等待服务器在配置的 URL 上可用
3. 爬取网站并将页面和资源复制到指定目录
4. 完成后自动关闭服务器

在启动命令时，Staticgen 会设置STATICGEN环境变量为1，使你能够根据需要调整行为。默认情况下，生成过程的超时时间为 15 分钟，你可以根据实际情况使用-t, --timeout标志来增加或减少这个时间。

📋 快速开始：安装与基本配置

安装 Staticgen

目前项目中提供了 Node.js 示例的安装方法，在 Node.js 环境下可以通过以下命令安装依赖：

npm install

创建配置文件

首先创建./static.json配置文件，其中唯一必填的属性是command。以下是不同语言服务器的配置示例：

Go 服务器配置示例：

{ "command": "go run main.go", "url": "http://localhost:3000", "dir": "dist" }

Node.js 服务器配置示例：

{ "command": "NODE_ENV=production node server.js", "url": "http://localhost:3000", "dir": "dist" }

Node.js 示例中特别将NODE_ENV设置为 production，以便使用 Express 模板缓存等优化来提高服务性能。

💻 使用方法：生成静态网站

执行生成命令

配置完成后，运行staticgen命令即可开始预渲染过程：

staticgen

查看预渲染网站

生成完成后，你可以通过以下命令启动静态文件服务器并在浏览器中查看预渲染的网站：

npx serve dist

示例项目使用

项目提供了完整的示例，你可以进入相应目录体验：

Go 示例：

cd _examples/go staticgen

Node.js 示例：

cd _examples/node staticgen

⚡ 高级用法：自定义超时时间

根据网站大小和复杂度，你可能需要调整生成过程的超时时间。以下是一些示例：

# 设置超时时间为 30 分钟 staticgen --timeout 1800 # 设置超时时间为 5 分钟 staticgen -t 300

📁 项目结构与示例

项目中提供了丰富的示例目录，你可以在 _examples 目录中找到完整的使用示例，包括 Go 和 Node.js 两种版本，帮助你快速理解和使用 Staticgen。

📌 注意事项

• Staticgen 不使用无头浏览器进行预渲染，因此无法依赖客户端 JavaScript 操作页面
• 生成过程中会自动设置STATICGEN环境变量，可用于在服务器代码中区分静态生成环境
• 默认超时时间为 15 分钟，可根据实际需求调整

通过 Staticgen，你可以轻松地将现有的动态网站转换为静态版本，享受静态网站带来的速度和安全优势，同时无需放弃你熟悉的开发工具和框架。无论是个人博客还是企业网站，Staticgen 都是一个值得尝试的高效解决方案。

【免费下载链接】staticgenStatic website generator that lets you use HTTP servers and frameworks you already know项目地址: https://gitcode.com/gh_mirrors/sta/staticgen