search

roboticslab-uc3m / questions-and-answers

A place for general debate and question&answer
https://robots.uc3m.es/developer-manual/appendix/repository-index.html
2 stars 0 forks source link

Update links to GitBook project instances on legacy servers #93

Closed PeterBowman closed 2 years ago

PeterBowman commented 3 years ago

As a follow-up to https://github.com/roboticslab-uc3m/questions-and-answers/issues/91#issuecomment-805120205, we need to update URLs that point to GitBook-generated documentation hosted at robots.uc3m.es and wiki.asrob.uc3m.es:

For instance, http://robots.uc3m.es/gitbook-installation-guides/ would translate to https://roboticslab-uc3m.github.io/installation-guides/. However, we will probably want to set robots.uc3m.es as the custom domain for GH Pages, similarly as it had been done at http://wiki.asrob.uc3m.es/gitbook-tutoriales/ -> https://asrob-uc3m.github.io/tutoriales/ -> https://asrob.uc3m.es/tutoriales/ (i.e. using asrob.uc3m.es instead of asrob-uc3m.github.io). In order to make this work, the migration of our legacy http://robots.uc3m.es wiki (and backups, and SVN repos) must be completed. Remark: we get free SSL!

As a side note: perhaps such links as http://robots.uc3m.es/gitbook-teo-developer-manual/network-information.html can be made server-relative, i.e. simply teo-developer-manual/network-information.html.

PeterBowman commented 3 years ago

By the way, there are lots of links that work on GitHub markdown, but fail to target their destination via Doxygen, e.g. see relative links here (../libraries/xxx). This didn't work earlier (pre-GHA migration).

PeterBowman commented 2 years ago

Not sure what happened, but I have noticed today that our Doxygen/Gitbook CI jobs also spawn a "pages build and deployment" action (ref), which publishes stuff directly to http://robots.uc3m.es/. I have enforced HTTPS everywhere in Settings > Pages, just in case. Now, this and other links work nicely: https://robots.uc3m.es/installation-guides/.

Should/can we verify this domain in the org settings?

PeterBowman commented 2 years ago

These replacements have been done, among others:

Should/can we verify this domain in the org settings?

@jgvictores perhaps we need to reach out to CASO? I can enter robots.uc3m.es in that field, but then GH asks me for proper DNS configuration. See reference.