Guía¶
Esta guía te ayudará a construir y publicar una biblioteca de Python como la de este repositorio. Te guiará por los conceptos básicos del control de versiones, el flujo de trabajo colaborativo, el empaquetado y las pruebas, y el conocimiento lingüístico que va dentro.
Guía, no referencia
Estas páginas enseñan el cómo. La sección
Biblioteca es la otra mitad de este sitio: el manual
de referencia de esperantilo, el API y su funcionalidad.
Las cuatro secciones¶
- 1. Git — control de versiones: cómo funciona, los comandos que necesitas y cómo deshacer cambios.
- 2. GitHub — el flujo colaborativo: pull requests, Actions, protección del repositorio, Pages.
- 3. Biblioteca Python — empaquetado, estructura, diseño de la API, instalación y pruebas.
- 4. Esperanto — historia, gramática, vocabulario y listas de palabras: las reglas que codifica la biblioteca.
Las secciones son en gran medida independientes. Léelas en orden si empiezas de cero; salta directamente a Biblioteca Python o a Esperanto si ya conoces Git y GitHub.
Este repositorio es el ejemplo¶
Cada vez que la guía muestra un archivo, un workflow o un commit, es uno real de este repositorio, no un fragmento inventado. La sección Biblioteca documenta el resultado.
| La guía explica | Puedes verlo funcionando en |
|---|---|
pyproject.toml y la estructura src/ |
pyproject.toml |
| Diseñar una API pública | Biblioteca → Referencia de la API |
| Escribir pruebas | tests/test_tokenizer.py |
| GitHub Actions | .github/workflows/ |
| GitHub Pages | este sitio |