Sobre el proyecto
Este repositorio impulsa todo el sitio web de PostHog, tratado como un producto. Incluye todo el contenido escrito (características del producto, manuales, documentación, blogs, casos prácticos, tutoriales y el manual de la empresa), además de funciones interactivas como un sistema de preguntas y respuestas (Squeak!), ofertas de empleo (mediante Ashby), una calculadora de precios, hoja de ruta, documentos de API y más. El código base contiene todos los componentes, plantillas, lógica y estilos.
## Inicio rápido
1. **Preinstalación**: Instala Node (versión 22) y pnpm (mediante `corepack use pnpm@latest-10`).
2. **Comenzar a desarrollar**: Clona el repositorio, instala las dependencias con `pnpm install` y ejecuta `pnpm start`. El sitio se ejecuta en `http://localhost:8001`. Para Macs con Apple Silicon, los pasos adicionales incluyen eliminar `node_modules` e instalar `vips` mediante Homebrew.
3. **Editar y previsualizar**: Usa la herramienta GraphQL de Gatsby en `http://localhost:8001/___graphql` para consultas de datos.
## Configuración avanzada
- **Errores de depuración**: Extrae los últimos cambios, limpia la caché y asegúrate de que no haya entornos flox en conflicto.
- **Documentos de API**: Anula la URL del esquema de API con `POSTHOG_OPEN_API_SPEC_URL` para usar una instancia local de PostHog.
- **Ofertas de empleo de Ashby y colaboradores de GitHub**: Requiere variables de entorno privadas.
- **Sección de publicaciones**: Visita `/posts` directamente para ver la versión local.
- **Vistas previas de PR de Cloudflare**: Se compilan con `GATSBY_MINIMAL=true`; es posible que no se generen las páginas de listado.
- **Tienda de merchandising**: Requiere variables de entorno de Shopify (`SHOPIFY_APP_PASSWORD`, `GATSBY_MYSHOPIFY_URL`, `GATSBY_SHOPIFY_STOREFRONT_TOKEN`).
- **Imágenes de open graph dinámicas**: Compila con `ASHBY_API_KEY` y `GITHUB_API_KEY`, y comenta temporalmente una línea en `gatsby/onPostBuild.ts` para generar imágenes localmente.
## Contribuir
Las contribuciones son bienvenidas. Orden de prioridad: haz preguntas en la comunidad, envía informes de errores o comentarios, vota por funciones, abre PRs o abre issues e ideas de contenido. Hay instrucciones detalladas disponibles en el manual y en el archivo `AGENTS.md`.
Comments
0 people shared their preference · Deer Point appears after 10 participants
Sign in to join the discussion.