Permitir la creación y edición de tutoriales en la página web utilizando archivos Markdown, asegurando que estos se desplieguen correctamente y sean fáciles de gestionar en GitHub Pages.
Tareas Específicas
1. Configuración Inicial
Selección de plataforma: Utilizar GitHub Pages para alojar la página web.
Configuración del repositorio: Entender la configuracion del repositorio en GitHub para el sitio web.
Instalación de Jekyll: Configurar Jekyll en el repositorio para gestionar el contenido del sitio web¹.
2. Estructura de Archivos y Directorios
Directorio de tutoriales: Crear un directorio específico (_tutorials) en el repositorio para almacenar los archivos Markdown de los tutoriales.
Organización de archivos: Definir una estructura clara para organizar los archivos por categorías o temas.
3. Desarrollo de Plantilla Personalizada
Diseño de la plantilla: Diseñar una plantilla personalizada utilizando HTML, CSS y Liquid (el lenguaje de plantillas de Jekyll).
Integración de Markdown: Asegurarse de que la plantilla pueda renderizar archivos Markdown correctamente.
Estilo y formato: Aplicar estilos CSS para asegurar una presentación coherente y atractiva de los tutoriales.
4. Parser de Markdown y Despliegue
Configuración de Jekyll: Configurar Jekyll para que procese los archivos Markdown en el directorio _tutorials y los convierta en páginas HTML.
Plantilla de tutoriales: Diseñar una plantilla específica para los tutoriales que se utilizará para desplegar el contenido convertido de Markdown a HTML.
Sistema de carga: Desarrollar un flujo de trabajo que permita subir archivos Markdown al repositorio y asignarles categorías o etiquetas.
5. Integración y Pruebas
Integración del parser: Asegurarse de que Jekyll procese y despliegue automáticamente los archivos Markdown subidos al directorio _tutorials.
Pruebas de despliegue: Realizar pruebas para asegurarse de que los tutoriales se desplieguen correctamente en la página web, verificando que el formato y el estilo sean consistentes.
6. Documentación y Capacitación
Guía de usuario: Crear una guía detallada para ti y cualquier otro usuario que explique cómo crear, editar y subir archivos Markdown.
Capacitación: Si es necesario, organizar una sesión de capacitación para la familiarizacion con el proceso de creación y edición de tutoriales usando Markdown.
Herramientas Recomendadas
Markdown Editors: Visual Studio Code, Typora, Dillinger.
Jekyll: Para gestionar el contenido y las plantillas en GitHub Pages.
GitHub Actions: Para automatizar el despliegue del sitio web.
Objetivo
Permitir la creación y edición de tutoriales en la página web utilizando archivos Markdown, asegurando que estos se desplieguen correctamente y sean fáciles de gestionar en GitHub Pages.
Tareas Específicas
1. Configuración Inicial
2. Estructura de Archivos y Directorios
_tutorials
) en el repositorio para almacenar los archivos Markdown de los tutoriales.3. Desarrollo de Plantilla Personalizada
4. Parser de Markdown y Despliegue
_tutorials
y los convierta en páginas HTML.5. Integración y Pruebas
_tutorials
.6. Documentación y Capacitación
Herramientas Recomendadas