La Estantería Digital se divide en dos ramas de desarrollo: Plataforma y Archivo.
Plataforma es la construcción en sí del sito web (front-end) y los procesos para que la misma pueda ser desplegada y visualizada (Backend y DevOps).
Archivo se refiere a la recolección, curado, documentación, digitalización, mantenimiento y conservación de los archivos. Esta rama también se encarga de la carga y el mantenimiento de los servidores de los archivos exclusivamente.
Ambas ramas se comunican y hacen llegar los archivos a los usuarios.
Plataforma
La Plataforma de la Estantería Digital de Papalotla es construida en Docusaurus, un proyecto open source de Facebook. El control de versiones se realiza mediante GitHub. El despliegue final se realiza en Netlify.
Las siguientes tecnologías son utlizadas en el front-end en el proyecto.
- React
- Node.js
- Yarn
Markdown y MDX
En la Estantería Digital de Papalotla (y en Impossible Box de México en general) desayunamos, comemos y cenamos Markdown. Todos las páginas estan hechas en este lenguaje de tipado. También es el caso de los documentos corporativos internos y nuestros manuales. MDX nos da una oportunidad de llevar Markdown al siguiente nivel.
Repositorio de Plataforma.
Todo nuestro desarrollo se concentra en un repositorio de GitHub llamado Repositorio de Plataforma. Hacemos nuestros commit colocando una descripción sencilla y nos gusta colocar también la canción que estamos escuchando en ese momento.
Archivo
Archivo se construye día a día mediante una comunidad que, decide, busca, cura, digitaliza y reseña los artículos presentes en la Estantería.
Nuestros archivos provienen de muchas fuentes, son el producto de muchas horas dedicadas y de las siguientes técnicas.
- Búsqueda y archivos existentes: Mediante muchas técnicas de búsqueda tanto en la Web como en plataformas de transparencia.
- Digitalización: Hacemos un importante trabajo en la conversión de archivos físicos a digitales. Utlizamos tecnología OCR para convertir imágenes en texto útil y facilmente consultable.
- Creación: La Estantería publica documentación original basada en datos de acceso público. Hacemos estadísticas y material gráfico. Así mismo también publicamos contenido de autores independientes, siempre y cuando cumplan con estándares de calidad requeridos y sean aprobados por el Consejo de Contenido.
Nuestros estándares de contenido se resumen en el siguiente artículo.
Archivo también se encarga de mantener actualizado nuestro repositorio público en GitLab con todos nuestros archivos. ¡Puedes hacer una descarga masiva de todos los archivos de la Estantería de un solo golpe!
Mira un pequeño turorial de como hacerlo aquí.
Por cuestiones de seguridad, metricas y facilidad, nuestros archivos (blob) se despliegan mediante AWS Simple Cloud Storage. Tenemos cuatro copias de seguridad.
Fallos, errores y bugs
En caso de que encuentres un bug, fallo o inconsistencia te agradeceremos hacerlo llegar a correo: estanteria@impossiblebox.me
Código de conducta
Todo el proyecto de la Estantería se rige bajo el siguiente código de conducta
Atribución
Los gráficos de esta página fueron hechos con Cocomaterial, una librería para Penpot.