Move from static to dynamic Link generation for missing rst files

[fgdrf]

Situation:

• Makefile down below doc folder creates symlinks for missing rst files in translation sub-folders
• it scans the root directory and folders in the 2nd order (en/*/*)

Problem:

• (possible) changes in the folder structure requires to change Makefile
• new rst files (e.g. metrics.rst) in the first order down below the language are not considered and causes into http 404 Errors if the document is linked from somewhere

Solution:

the Make target link_to_en_docs should be more flexible and should analyse the current tree of sub-dirs.

START_DIR     = $(shell pwd)
ORIGIN_FILES  = $(shell find ./en -name "*.rst" -print)

[..]

link_to_en_docs:
        # For quickstart, standards and overview docs which have not been
        # translated, link to english doc
        for LANG in $(TRANSLATIONS) ; do \
          for DOC in $(ORIGIN_FILES) ; do \
            TRANSLATED_DOC=`echo $$DOC | sed -e"s/en/$$LANG/"` ; \
            TARGET_EN=`echo $$DOC | sed -e"s#^#../../#"` ; \
            if [ ! -f $$TRANSLATED_DOC ] ; then \
              rm -f $$TRANSLATED_DOC ; \
              ln -s $$TARGET_EN $$TRANSLATED_DOC ; \
            fi ; \
          done ; \
        done

[hamish]

(cc to the mailing list is only needed if the ticket's "owner" has changed)

[kalxas]

Ticket retargeted after milestone closed

[kalxas]

Ticket retargeted after milestone closed

[kalxas]

Ticket retargeted after milestone closed

[kalxas]

Ticket retargeted after milestone closed