Tutoriales

Recopilación de tutoriales y materiales útiles sobre los programas y herramientas que usamos en ASROB.

Actualmente alojado en: https://asrob.uc3m.es/tutoriales.

Si tienes alguna duda o comentario con respecto al contenido

1. Por favor revisa si puedes encontrar la respuesta en el archivo correspondiente y/o en la documentación de la carpeta a la cual pertenece, así como en la sección Issues (problemas abiertos y cerrados).
2. Si tu duda o comentario no es un duplicado, comenta de forma pública detalladamente: Nueva Issue.

Cómo hacer

• Cómo servir en localhost
• Cómo subir cambios a GitHub

Cómo servir en localhost

Es útil servir en localhost para modificar el sitio web y ver los cambios localmente.

1. Desde la raíz del proyecto, ejecuta el siguiente comando:

pip install -r requirements.txt
mkdocs serve

2. Ahora puedes navegar por el sitio en la ubicación predeterminada: http://127.0.0.1:8000

Cómo subir cambios a GitHub

Este proyecto se administra como cualquier proyecto en GitHub. Puedes usar Git o incluso la interfaz web de GitHub, sobre las cuales puedes encontrar muchos tutoriales online. Los siguientes puntos son específicos del mecanismo MkDocs:

1. Por favor no subas la carpeta site/. Se genera automáticamente a nivel local, y lo mismo debería ocurrir en los servidores de MkDocs.

2. Se puede git push a cualquier branch upstream, pero recuerda que lo que está en master es lo que realmente se renderizará como el sitio web.