README.md
以下内容由 AI 翻译,如有问题请点此提交 issue 反馈
Pantheon 文档
该仓库包含 Next.js 源代码以及 Pantheon 文档网站] 的内容。
参与文档修改
该网站的内容存储在 src/source] 文件夹中的 markdown 文件里。
如果您希望为文档做出贡献或进行编辑],可以像操作 GitHub 上的其他仓库一样,向该仓库提交 pull request。
网站架构
该网站基于 Next.js 构建,主要依赖路由的动态渲染(SSR)功能。虽然采用静态渲染的页面也能实现类似功能,但选择动态渲染是出于以下原因:
- 缩短初始构建时间
- 顺应 Next.js 网站向“默认动态](https://pantheon.io/blog/next-js-beta)”架构发展的趋势
- 为将来的一些变更做好准备,届时部分内容将除了来自本地的 markdown 文件外,还会来自 Pantheon 的内容发布器]
本地开发
要在该 Next.js 网站上进行本地开发,需先将其克隆到您的本地机器上。
安装依赖项:
npm install
启动本地开发服务器:
npm run dev
对于某些开发任务,您可能希望执行完整的构建,使其与该站点在 Pantheon 自有的 Next.js 基础设施上部署到网页的方式保持一致。
请使用以下命令执行完整的生产环境构建:
npm run build
然后使用该命令启动该站点
npm run start
在开发服务器上,某些页面和 React 组件的行为可能与完整构建后的表现有所不同。