[#1380] Encourage installing latest release in source install docs

Needed an automated way to get the latest version number, so I added
functions to doc/conf.py for this, and then used them in the source and
package install docs.
[#1380] Remove hardcoded filename
[#1380] Fix some broken hyperlinks in the docs

Stop Sphinx from hyperlinking part of the URL in pip install commands.