Modificaciones en GitBook

[jgvictores]

Your organization is being upgraded to the new GitBook" (https://www.gitbook.com/@asrob-uc3m/migration/status). Al parecer han cambiado URLs. Iré actualizando y comentando en esta issue.

[jgvictores]

• Versión antigua (legacy): https://legacy.gitbook.com/book/asrob-uc3m/robotdevastation-user-manual
• Versión nueva: https://asrob-uc3m.gitbook.io/robotdevastation-user-manual

No parece que la versión nueva funcione bien con idiomas. También parece que ha dejado de funcionar el cambiar de página con las flechas de teclado.

De momento recomiendo apuntar a legacy.

[jgvictores]

Seguimos apuntando a la versión antigua (legacy).

Por si alguna vez se actualiza (queriendo o sin querer), he ido a https://asrob-uc3m.gitbook.io/robotdevastation-user-manual/~/settings/customization y en Styles ecogido de Primary Color el #3884FF que es el azul del lateral.

[jgvictores]

PD: Afecta tb a https://github.com/asrob-uc3m/estatutos https://github.com/asrob-uc3m/tutoriales etc

[jgvictores]

Estado: en https://github.com/asrob-uc3m mantenemos la versión legacy de momento.

En https://github.com/roboticslab-uc3m se actualizó a la versión nueva de gitbook. A mí me gusta menos, pero iré probando configuraciones y documentando en https://github.com/roboticslab-uc3m/questions-and-answers/issues/63

[jgvictores]

Marcando como bloqueado por https://github.com/roboticslab-uc3m/questions-and-answers/issues/63

[jgvictores]

De momento quitando prioridad alta, puesto que en esta org se mantiene legacy y los enlaces apuntan al mismo.

[jgvictores]

Se puede dar por desbloqueado. Ya que seguimos en gitbook procederé a incluir .gitignore en todos los repos que sean static web generators de tipo gitbook: (evitar que se suba /_book/).

[jgvictores]

Añadido a https://github.com/asrob-uc3m/tutoriales: https://github.com/asrob-uc3m/tutoriales/commit/86f91ff8d5f03da0a8c4693b777add8eb108fe8f y https://github.com/asrob-uc3m/tutoriales/commit/7abe1a974e875f8aac0ee4677f5e275b730e7498

[jgvictores]

Añadido en https://github.com/asrob-uc3m/robotDevastation-developer-manual/commit/7ee9406428687e9688adec41d75ec08ccc8187b9

[jgvictores]

Edit: Como se comenta debajo, esto se deja para nuevas issues.

Info para que portada no sea README.md en Gitbook:

• https://github.com/GitbookIO/gitbook/issues/392
• https://toolchain.gitbook.com/structure.html

[jgvictores]

Añadido en https://github.com/asrob-uc3m/robotDevastation-user-manual/commit/5ff8e27693e4b0ff1d6b592a89ad79bce6f4b5de

[jgvictores]

Info para que portada no sea README.md en Gitbook:

• GitbookIO/gitbook#392
• https://toolchain.gitbook.com/structure.html

Dejando esta info para issues futuras.

[jgvictores]

Para github+gitbook: https://docs.gitbook.com/integrations/github/content-configuration Véase https://github.com/asrob-uc3m/tutoriales/commit/c77c4816c7449a7862f07214fe6693cbaf176d5b

[jgvictores]

https://legacy.gitbook.com/book/asrob-uc3m/tutoriales/build/5c20f6451274170030f1dfe6

Downloading source
Pulling from S3
Extracting source
GitBook version is 3.2.3
Tweaking book.json
Installing plugins
info: installing 1 plugins using npm@3.9.2 
info:  
info: installing plugin "comment" 
info: install plugin "comment" (*) from NPM with version 1.0.5 
/tmp/book
└── gitbook-plugin-comment@1.0.5 

[jgvictores]

Voy a migrar al server de momento. Motivos:

1. Gitbook legacy está dando resultados muy extraños al jugar con modificar la portada alternativa a README.md. Por más que he jugado con borrar cachés, en la raiz no muestra lo generado por el útlimo commit, pese a generarse correctamente, véase:

   • https://asrob-uc3m.gitbooks.io/tutoriales/content/
   • https://asrob-uc3m.gitbooks.io/tutoriales/content/v/770bba0d266d8f95515faa2cfa696426aa648c6e_1/

2. Más importante todavía: la integración Gitbook legacy con GitHub era a través de GitHub Services (@PeterBowman esto ocurría con Travis CI, que entiendo que tracked at https://github.com/roboticslab-uc3m/questions-and-answers/issues/60). GitHub Services finaliza Enero 31 2019:

   GitHub Services are being deprecated. Please contact your integrator for more information on how to migrate or replace a service with webhooks or GitHub Apps.

Ventajas:

1. Misma plataforma para https://github.com/asrob-uc3m que para https://github.com/roboticslab-uc3m/questions-and-answers/issues/63
2. Creo que evitamos duplicar info: book.json (gitbook) vs .gitbook.yaml (gitbook+github)

[jgvictores]

PD: Por justificar un poco. Sigue sin gustarme el depender 100% del server. Esto ocurría con la wiki, donde todo estaba centralizado, y esto lo sufrimos en muchas ocasiones que incluso se nos corrompió la base de datos. Esto es algo más parecido al caso del doxygen. Todo está distribuido a través de git, y el gitbook se puede generar en local a través de gitbook build && gitbook serve, que incluiré en los README.md.

[jgvictores]

(continúa monólogo) Parece que ha refrescado finalmente.

[jgvictores]

Aquí un commit para que se vea lo que hay que hacer en github+gitbook: https://github.com/asrob-uc3m/tutoriales/commit/b7fe3d6860a393e41c3494fbcf7bc2fb4bdbb24b

[jgvictores]

Y para el caso de https://github.com/asrob-uc3m/robotDevastation-user-manual y https://github.com/asrob-uc3m/robotDevastation-developer-manual será algo diferente, al tener versiones English vs Español

[jgvictores]

Por concluir, a modo resumen:

Seguimos con Gitbook (legacy) en los servers de Gitbook. 3 repos han sido mejorados para distinguir portada github (README.md) vs introducción Gitbook (legacy) (README-gitbook.md, salvo bilingüe: en/README.md y es/README.md). Recuerdo que para no bilingües esto involucra tocar book.json, y además sobre los servers gitbook integrados con github hace falta .gitbook.yaml y la introducción tarda en regenerarse 24h aprox (aunque el resto de la página refresque al poco).

Aquí unas plantillas para futuros proyectos:

• Español: https://github.com/asrob-uc3m/tutoriales/tree/04d37125c53b1ba9f859ce64928cc1988a11e69e
• Bilingüe inglés+español: https://github.com/asrob-uc3m/robotDevastation-user-manual/tree/5161919d746c73a83e98c750611e026aa2766c31
• Inglés: https://github.com/asrob-uc3m/robotDevastation-developer-manual/tree/0ff89eb0977fd0429f13eaec878c00eaa8045a6a

Para issues futuras (o futuros reopen):

• De memoria, diría que quedaría por hacerlo en:
  • https://github.com/asrob-uc3m/actas
  • https://github.com/asrob-uc3m/estatutos
  • EDIT: Manuales de impresoras
• Crónica de una muerte anunciada:
  • GitHub Services finaliza Enero 31 2019

[jgvictores]

Ejemplos de automatización:

• https://github.com/roboticslab-uc3m/developer-manual/commit/c5d6a439858f376f43282c1ba84f99d0e081335d
• https://github.com/roboticslab-uc3m/teo-developer-manual/commit/c91ea9ed1a45a62b880d4b94ec13a89f623dbd6a

[jgvictores]

https://www.gitbook.com/@asrob-uc3m/spaces

1. https://github.com/asrob-uc3m/actas
2. https://github.com/asrob-uc3m/estatutos
3. https://github.com/asrob-uc3m/impresoras-maintenance-manual-i3
4. https://github.com/asrob-uc3m/impresoras-user-manual-i3
5. https://github.com/asrob-uc3m/rd-ambassador
6. https://github.com/asrob-uc3m/robotDevastation-developer-manual
7. https://github.com/asrob-uc3m/robotDevastation-user-manual
8. https://github.com/asrob-uc3m/tutoriales

[jgvictores]

• https://github.com/asrob-uc3m/rd-ambassador se había actualizado a la versión cerrada de Gitbook en https://asrob-uc3m.gitbook.io/rd-ambassador/, con https://github.com/asrob-uc3m/rd-ambassador/commit/b8657fb79fb0f616aea78a05d6a51cefc8445d58 ahora generado vía Gitbook legacy (abierto), ahora alojado en http://wiki.asrob.uc3m.es/gitbook-rd-ambassador/

[jgvictores]

Ha llegado el día. Por poner un ejemplo, https://github.com/asrob-uc3m/tutoriales/commit/a474a5c6f03e33cd84920c92b2ad480e98f0bf31 se ha actualizado en el gitbook nuevo=cerrado https://app.gitbook.com/@asrob-uc3m/s/tutoriales/software/version-control/subversion pero ya no en el legacy=open https://asrob-uc3m.gitbooks.io/tutoriales/content/software/version-control/subversion.html.

En consecuencia, reabro issue hasta migrar los repos anteriormente citados al server. En principio tardaré lo que tarde, posiblemente dando prioridad al de tutoriales.

• [x] https://github.com/asrob-uc3m/rd-ambassador
• [x] https://github.com/asrob-uc3m/tutoriales
• [ ] https://github.com/asrob-uc3m/actas
• [ ] https://github.com/asrob-uc3m/estatutos
• [ ] https://github.com/asrob-uc3m/impresoras-maintenance-manual-i3
• [ ] https://github.com/asrob-uc3m/impresoras-user-manual-i3
• [ ] https://github.com/asrob-uc3m/robotDevastation-user-manual
• [ ] https://github.com/asrob-uc3m/robotDevastation-developer-manual

[jgvictores]

• https://github.com/asrob-uc3m/tutoriales

Now hosted at http://wiki.asrob.uc3m.es/gitbook-tutoriales/

[PeterBowman]

Estamos migrando a GitHub pages con motivo de https://github.com/roboticslab-uc3m/questions-and-answers/issues/91, con generación automática de HTML mediante un workflow de GitHub Actions específico para GitBook.

Esto es, la nueva dirección al manual de tutoriales es https://asrob.uc3m.es/tutoriales/. Aquí redirigen tanto https://asrob-uc3m.github.io/tutoriales/ (URL por defecto de GH Pages) como http://wiki.asrob.uc3m.es/gitbook-tutoriales/ (servidor de la asociación, deprecated). Cito https://asrob-uc3m.gitbooks.io/tutoriales/content/ solo para indicar que murió hace algún tiempo (lleva mucho sin actualizarse).

[jgvictores]

https://asrob.uc3m.es/tutoriales generado desde https://github.com/asrob-uc3m/tutoriales ha sido maravillosamente migrado por @PeterBowman [thanks!] via https://github.com/asrob-uc3m/tutoriales/commit/587f31b04a8e3ec9524d102125197d28f1ba292c y related.

Cerrando, porque ese es el repo que mantenemos en la actualidad.

[jgvictores]

Related: https://github.com/roboticslab-uc3m/questions-and-answers/issues/99#issuecomment-1811499351