프로젝트 소개

이 저장소는 PostHog 웹사이트 전체를 구동하며, 하나의 제품으로 취급됩니다. 모든 작성된 콘텐츠(제품 기능, 매뉴얼, 문서, 블로그, 사례 연구, 튜토리얼, 회사 핸드북)와 함께 Q&A 시스템(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 스키마 URL을 재정의하여 로컬 PostHog 인스턴스를 사용합니다. - **Ashby 채용 공고 및 GitHub 기여자**: 비공개 환경 변수가 필요합니다. - **게시물 섹션**: 로컬 버전을 보려면 `/posts`를 직접 방문합니다. - **Cloudflare PR 미리보기**: `GATSBY_MINIMAL=true`로 빌드되며, 목록 페이지가 생성되지 않을 수 있습니다. - **굿즈 스토어**: Shopify 환경 변수(`SHOPIFY_APP_PASSWORD`, `GATSBY_MYSHOPIFY_URL`, `GATSBY_SHOPIFY_STOREFRONT_TOKEN`)가 필요합니다. - **동적 오픈 그래프 이미지**: `ASHBY_API_KEY`와 `GITHUB_API_KEY`로 빌드하고, 로컬에서 이미지를 생성하려면 `gatsby/onPostBuild.ts`의 한 줄을 일시적으로 주석 처리합니다. ## 기여 기여를 환영합니다. 우선순위 순서: 커뮤니티에서 질문하기, 버그 보고/피드백 제출, 기능에 투표하기, PR 열기, 또는 이슈/콘텐츠 아이디어 열기. 자세한 지침은 핸드북과 `AGENTS.md` 파일에서 확인할 수 있습니다.