《TPH 官网搭建指南》

1. 项目基础介绍

《TPH 官网》是 The Programmer's Hangout 社区的官方网站，该社区是一个在 Discord 上的编程交流社区。官网使用了静态站点生成器 Gatsby，它基于 React，能够生成性能优越的静态网站，并且对搜索引擎友好。

主要编程语言：

• TypeScript
• JavaScript

2. 关键技术和框架

该项目使用以下技术和框架：

• Gatsby: 一个基于 React 的静态站点生成器，能够帮助开发者快速构建高效的静态网站。
• React: 用于构建用户界面的 JavaScript 库。
• Yarn: 一个快速、可靠、安全的依赖管理工具。

3. 安装和配置指南

准备工作

在开始之前，请确保您的系统中已安装以下软件：

• Node.js（推荐版本在 package.json 中指定）
• Git
• Yarn 或 npm

安装步骤

1. 克隆项目

   打开终端或命令提示符，运行以下命令克隆项目：

   git clone https://github.com/the-programmers-hangout/website.git
   cd website
   

2. 安装依赖

   在项目目录中，运行以下命令安装项目依赖：

   yarn install
   

   或者，如果您使用 npm：

   npm install
   

3. 启动开发服务器

   安装完依赖后，运行以下命令启动开发服务器：

   yarn run develop
   

   或者，如果您使用 npm：

   npm run develop
   

   运行此命令后，Gatsby 开发服务器将启动，并且您可以在浏览器中通过 http://localhost:8000 访问网站。

4. 编写和贡献内容

   如果您想要添加新的内容或资源，请按照以下步骤操作：

   • 在 /src/content/docs/ 目录下创建新的 markdown 文件。
   • 添加必要的 frontmatter 数据（例如，作者、标题、创建日期等）。
   • 编写您的内容，并添加外部资源链接。
   • 运行 yarn run develop 并检查您的更改。
   • 确认更改无误后，创建一个 pull request。

5. 构建生产版本

   当您准备将网站部署到生产环境时，运行以下命令构建生产版本：

   yarn run build
   

   构建完成后，将生成的 public 目录中的文件部署到您的服务器或静态网站托管服务上。

遵循以上步骤，您应该能够顺利地搭建和运行 TPH 官网。如果遇到任何问题，请查看项目的 README 文件或直接在项目仓库中提出 issue。