这个项目能做什么

该仓库为整个 PostHog 网站提供支持,并将其视为一款产品。它包含所有书面内容(产品功能、手册、文档、博客、案例研究、教程以及公司手册),以及交互功能,例如问答系统(Squeak!)、职位列表(通过 Ashby)、定价计算器、路线图、API 文档等。代码库包含所有组件、模板、逻辑和样式。 ## 快速开始 1. **安装前准备**:安装 Node(版本 22)和 pnpm(通过 `corepack use pnpm@latest-10`)。 2. **开始开发**:克隆仓库,使用 `pnpm install` 安装依赖,然后运行 `pnpm start`。网站运行在 `http://localhost:8001`。对于 Apple Silicon Mac,额外步骤包括删除 `node_modules` 并通过 Homebrew 安装 `vips`。 3. **编辑和预览**:使用位于 `http://localhost:8001/___graphql` 的 Gatsby GraphQL 工具进行数据查询。 ## 高级设置 - **调试错误**:拉取最新更改,清理缓存,并确保没有冲突的 flox 环境。 - **API 文档**:使用 `POSTHOG_OPEN_API_SPEC_URL` 覆盖 API schema URL,以使用本地 PostHog 实例。 - **Ashby 职位列表和 GitHub 贡献者**:需要私有环境变量。 - **Posts 部分**:直接访问 `/posts` 查看本地版本。 - **Cloudflare PR 预览**:使用 `GATSBY_MINIMAL=true` 构建;列表页面可能不会生成。 - **周边商店**:需要 Shopify 环境变量(`SHOPIFY_APP_PASSWORD`、`GATSBY_MYSHOPIFY_URL`、`GATSBY_SHOPIFY_STOREFRONT_TOKEN`)。 - **动态 open graph 图片**:使用 `ASHBY_API_KEY` 和 `GITHUB_API_KEY` 构建,并临时注释掉 `gatsby/onPostBuild.ts` 中的一行,以便在本地生成图片。 ## 贡献 欢迎贡献。优先级顺序:在社区中提问、提交 bug 报告/反馈、为功能投票、提交 PR,或提交 issue/内容想法。详细说明可在手册和 `AGENTS.md` 文件中找到。