Perform some search engine optimization for docs

[marscher]

Currently the documentation is hard to find on engines like google, duckgosearch, bing etc.
One has to enforce the inclusion of the term "weldx" by using quotation marks. Eventually we should somehow highlight this more.

[marscher]

cref #307

[marscher]

It seems the version number is currently not avail on RTD although the package gets installed.

[CagtayFabry]

good catch, I wonder why this happens..

It seems the version number is currently not avail on RTD although the package gets installed.

[CagtayFabry]

I think one way would be to just include setuptools_scm in the docs requirement and directly run

from setuptools_scm import get_version
version = get_version(root='..', relative_to=__file__)

in conf.py

[marscher]

This is a good solution. Thanks!

[marscher]

Hold on, do we have setuptools_scm installed on RTD?

[marscher]

I think it arises from having weldx always imported from the sources root (where the version is undefined; it only gets defined during pip install).

[CagtayFabry]

I think it arises from having weldx always imported from the sources root (where the version is undefined; it only gets defined during pip install).

Ah yes that might be it. Probably because RTD doesn't pip install -e ., otherwise the version.py file would be created in the source install
see readthedocs/readthedocs.org#4960

How about

try:
    import weldx
except ModuleNotFoundError: # fallback for local use
    sys.path.insert(0, os.path.abspath("../"))
    import weldx
except Exception as ex:
    raise

[CagtayFabry]

looking good #310