Opened 12 years ago

Closed 3 years ago

Last modified 3 years ago

#982 closed enhancement (fixed)

Upgrade sphinx environment to support linkcheck build goal

Reported by: fgdrf Owned by: live-demo@…
Priority: normal Milestone: OSGeoLive14.0
Component: Documentation Keywords: docs, sphinx
Cc:

Description

To continuously check the external links in sphinx docs the build goal linkcheck should run every time the sphinx-build has been started (see root/livedvd/gisvm/trunk/bin/install_main_docs.sh).

linkcheck is available since version 1.1 of sphinx and check references, which can be configured by set up a ignore list, for example localhost URL's (see linkcheck_ignore config option).

This would help to avoid outdated references to external resources.

Change history (12)

comment:1 by hamish, 10 years ago

Milestone: OSGeoLive8.0

comment:2 by hamish, 10 years ago

Keywords: docs added; doc removed
Milestone: OSGeoLive8.0OSGeoLive8.5

comment:3 by kalxas, 9 years ago

Milestone: OSGeoLive8.5OSGeoLive9.0

comment:4 by kalxas, 9 years ago

Milestone: OSGeoLive9.0OSGeoLive9.5

Ticket retargeted after milestone closed

comment:5 by kalxas, 8 years ago

Milestone: OSGeoLive9.5OSGeoLive10.0

Ticket retargeted after milestone closed

comment:6 by kalxas, 8 years ago

Milestone: OSGeoLive10.0OSGeoLive10.5

comment:7 by kalxas, 7 years ago

Milestone: OSGeoLive10.5OSGeoLive11.0

Ticket retargeted after milestone closed

comment:8 by darkblueb, 6 years ago

Component: OSGeoLiveDocumentation

comment:9 by cvvergara, 4 years ago

Adding the link checker Many links are broken some are redirections. https://travis-ci.org/github/cvvergara/OSGeoLive-doc/builds/667128348

Pending tasks before making the PR In English documentation

  • fix redirections
  • fix broken links

In other languages documentation

  • update the locale
  • push to transifex
  • pull the newly untranslated strings (strings with the links will be consider untranslated by transifex but will be 99% similar to a suggestion)

comment:10 by cvvergara, 4 years ago

Most of the work is done, The current problem to fix is:

have travis pass the job that checks links

  • its failing because it is trying to deploy and that build is not for deployment

comment:11 by cvvergara, 3 years ago

Resolution: fixed
Status: newclosed

I prepared actions based on the (last) commit message The commit message must have the language code for example [de] updating translations will trigger the German translation link checks.

English is always checked. Because sometimes the link in English fails, which makes the translation fail also. So it can still be merged, but in another PR the English link should be fixed.

comment:12 by cvvergara, 3 years ago

Milestone: OSGeoLive11.0OSGeoLive14.0
Note: See TracTickets for help on using tickets.