- Apuntes de Markdown y GitBook En Gitbook
- Apuntes de Markdown y GitBook En GitHub
- Repo etsiiull/gitbook-skeleton para comenzar un libro siguiendo la metodología expuesta
Notas
Cuando se despliega un libro gitbook en las GitHub Pages yo suelo hacerlo así:
- Crear un fichero
.nojekyll
para inhibir el uso dejekyll
~/GitBook/Library/Import/curso-gihub(master)]$ ls -l .nojekyll -rw-r--r-- 1 casiano staff 0 17 nov 15:02 .nojekyll
- Añadir el directorio/carpeta con los HTML generados
_book/
al repo[~/GitBook/Library/Import/curso-gihub(master)]$ git add _book
- Configurar el repo remoto en GitHub para que las páginas se sirvan desde la rama
master
(settings del repo, seccion gh-pages) - Poner en la raíz del repo un fichero
index.html
que redirige a_book/index.html
como este:<!DOCTYPE HTML> <html lang="en-US"> <head> <meta charset="UTF-8"> <meta http-equiv="refresh" content="1; url=_book/"> <script type="text/javascript"> window.location.href = "_book/" </script> <title>Page Redirection</title> </head> <body> <!-- Note: don't tell people to `click` the link, just tell them that it is a link. --> If you are not redirected automatically, follow this <a href='_book/'>link to the book</a>. </body> </html>
- Asegúrese que el directorio
_book
no es ignorado en.gitignore