Una guía completa de iniciación a Linux, construida con Astro y Starlight
🌐 Sitio web: linux-starlight.netlify.app
Linux Starlight es una guía de iniciación a Linux diseñada para ayudar a usuarios principiantes y intermedios a dominar el sistema operativo. El proyecto está enfocado en proporcionar documentación clara, práctica y accesible en múltiples idiomas.
- Proporcionar una guía completa y accesible para aprender Linux
- Ofrecer contenido en español, inglés y catalán
- Facilitar el aprendizaje con ejemplos prácticos y documentación clara
- Crear una comunidad de contribuidores alrededor del aprendizaje de Linux
Este proyecto está construido con tecnologías modernas y potentes:
- Astro - Framework web ultrarrápido para crear sitios estáticos
- Starlight - Tema de documentación para Astro
- Starlight Theme Nova - Tema personalizado con diseño moderno
linux-starlight/
├── src/
│ ├── assets/ # Imágenes y recursos estáticos
│ ├── components/ # Componentes reutilizables de Astro
│ ├── content/
│ │ ├── docs/ # Documentación principal
│ │ │ ├── ca/ # Contenido en catalán
│ │ │ ├── en/ # Contenido en inglés
│ │ │ ├── es/ # Contenido en español
│ │ │ └── index.mdx
│ │ └── i18n/ # Traducciones de la interfaz
│ ├── overrides/ # Sobreescrituras de componentes de Starlight
│ │ ├── Head.astro # Personalización del <head>
│ │ └── Footer.astro # Personalización del footer
│ └── styles/ # Estilos globales personalizados
├── public/ # Archivos públicos estáticos
├── astro.config.mjs # Configuración de Astro y Starlight
├── package.json
└── README.md
src/content/docs/: Contiene toda la documentación en formato Markdown/MDX, organizada por idiomassrc/overrides/: Componentes personalizados que sobrescriben los componentes por defecto de Starlightsrc/styles/: Estilos CSS personalizados para dar un toque único al sitiosrc/content/i18n/: Archivos de traducción para la interfaz del sitio
El sitio está disponible en tres idiomas:
- 🇪🇸 Español
- 🇬🇧 English
- Català
- Node.js (versión 18 o superior)
- npm, pnpm o bun
-
Clona este repositorio:
git clone https://github.com/jramma/linux-starlight.git cd linux-starlight -
Instala las dependencias:
npm install # o bun install -
Inicia el servidor de desarrollo:
npm run dev # o bun dev -
Abre tu navegador en
http://localhost:4321
| Comando | Acción |
|---|---|
npm run dev |
Inicia el servidor de desarrollo |
npm run build |
Construye el sitio para producción |
npm run preview |
Previsualiza la build de producción |
¡Las contribuciones son bienvenidas! Este proyecto está abierto a la comunidad y cualquiera puede contribuir para mejorar la documentación de Linux.
- Fork el repositorio
- Crea una rama para tu feature (
git checkout -b feature/nueva-funcionalidad) - Añade o modifica contenido en
src/content/docs/ - Asegúrate de que el contenido esté en los tres idiomas (o al menos en español)
- Commit tus cambios (
git commit -m 'Añadir nueva sección sobre comandos básicos') - Push a la rama (
git push origin feature/nueva-funcionalidad) - Abre un Pull Request
- Escribe en un lenguaje claro y accesible
- Añade ejemplos prácticos cuando sea posible
- Mantén la consistencia con el formato existente
- Si añades contenido nuevo, intenta traducirlo a los tres idiomas
- Revisa que no haya errores ortográficos
- 📝 Añadir nuevas secciones o temas
- 🌐 Mejorar las traducciones existentes
- 🐛 Corregir errores o imprecisiones
- 💡 Sugerir mejoras en la documentación
- 🎨 Mejorar el diseño o la experiencia de usuario
Este proyecto es open source y está disponible para que cualquiera lo use, modifique y mejore.
- GitHub: @jramma