Tutorial: GitHub y GitBook

En este tutorial, aprenderás a crear un repositorio que sea navegable en la web utilizando GitHub y GitBook. Este proceso es parte de una tarea del FabLab de CiDi y te permitirá mantener tu proyecto y su documentación bien organizados y accesibles.

Glosario de términos

Git

Git es un sistema de control de versiones distribuido, lo que significa que un clon local del proyecto es un repositorio de control de versiones completo. Estos repositorios locales plenamente funcionales permiten trabajar sin conexión o de forma remota con facilidad.

Repositorio

Un repositorio, o repo, es un tipo de almacenamiento digital centralizado que los desarrolladores utilizan para realizar y administrar cambios en el código fuente de una aplicación. Un repositorio cuenta con características que permiten a los desarrolladores rastrear con facilidad cambios en el código, editar archivos de manera simultánea y colaborar de forma eficiente en el mismo proyecto desde cualquier ubicación.

Gitbook

Gitbook es una plataforma basada en la web para crear, publicar documentación y libros de manera colaborativa, con integración de control de versiones y funciones personalizables.

GITHUB

Crear una cuenta en GitHub:

1. Visita Github

2. Registro a través del correo clectrónico

Escribe tu correo electrónico y haz clic en "Regístrate en GitHub”

3. Completar la información básica

Crea una contraseña segura y luego introduce un nombre de usuario, y das clic en continuar.

4. Verificar el Captcha

Para asegurarse de que eres una persona real, GitHub puede pedirte que completes un captcha. Simplemente sigue las instrucciones en pantalla para resolverlo y continuar con el registro.

5. Verificar el correo electrónico

Github enviará un correo electrónico a la dirección que proporcionaste. Abre ese correo y haz clic en el enlace de verificación para confirmar tu cuenta.

6. Configuración inicial

GitHub puede pedirte que selecciones algunas preferencias para personalizar tu experiencia. Puedes elegir temas que te interesen o saltarte este paso.

7. Seleccionar plan

GitHub te ofrecerá diferentes planes de suscripción. Para empezar, selecciona la opción Free (Gratis), que te da acceso a las funciones básicas y suficientes para la mayoría de los proyectos personales.

8. Acceder a la creación de un nuevo repositorio

Se ingresa el nombre del repositorio y se selecciona la opción "Público".

Listo, el repositorio ya ha sido creado.

https://github.com/micaelapavon/micaelapavon

Error

Si la página está traducida al español, no podrás crear el repositorio.

Solución

Deja la página web en inglés e intenta crear el repositorio nuevamente.

GITBOOK

1. Acceder a Gitbook

Abre tu navegador y ve a GitBook

2. Iniciar sesión con Github

Selecciona la opción Continue with GitHub (Continuar con GitHub

3. Autorizar la conexión con Github

Haz clic en Autorizar GitBook para conceder los permisos necesarios.

4. Completar la configuración en Gitbook

Elige un nombre y complétalo. Luego, selecciona la segunda opción, "Sitio de documentos publicados", y haz clic en "Continuar".

Selecciona la opción "Contenido de muestra" y luego haz clic en "Próximo paso".

5. Listo para ser publicado

Selecciona la opción "Publicar ahora" y luego haz clic en "Crear sitio".

Una vez creada tu cuenta, serás redirigido al panel principal de GitBook, donde podrás comenzar a crear y gestionar espacios de trabajo para tus proyectos. Listo, la cuenta de GitBook está creada.

Enlace: https://micaelapavon.gitbook.io/micaela-pavon/

Editar el contenido

Puedes escribir texto o títulos y darle formato (negrita, cursiva, encabezados) usando las herramientas en la parte superior del editor.

Usa los botones en la barra de herramientas para insertar tablas, imágenes o enlaces en el contenido.

Para guardar el contenido presiona Merge