`documentation_options.js` from the default theme sets the option
`URL_ROOT` to:
```
document.getElementById("documentation_options").getAttribute('data-url_root')
```
This requires that the script element for `documentation_options.js`
includes the tag `id="documentation_options"` and sets the
`data-url_root` tag. Otherwise evaluating `URL_ROOT` will fail and
building the documentation during the Debian package build will fail:
```
dh_sphinxdoc: error: DOCUMENTATION_OPTIONS does not define URL_ROOT
```
The variable `DOCUMENTATION_OPTIONS` is directly set `layout.html` and
therefore `documentation_options.js` does not need to be included. So
just exclude it.
Signed-off-by: Benjamin Drung <benjamin.drung@ionos.com>
Add the sphinx documentation options provided by sphinx 4.2. Otherwise
the search will produce URLs with `undefined` instead of `.html`:
```
ref/states/all/salt.states.fileundefined?highlight=file#module-salt.states.file
```
Signed-off-by: Benjamin Drung <benjamin.drung@ionos.com>
Freenode staff have now rolled out two waves of hostile channel
takeovers on the Freenode network. The ``#salt`` channel that served as
SaltStack'ss/SaltProject's primary IRC channel for many years is one
such channel that was taken over.
We have largely already migrated to the new LiberaChat network.
* Fixing various redirected links
* Change links to https
* Reintroduced macro link reference
* Change man page to original at master; revert added line
dh_sphinxdoc (used for building the documentation in the Debian package)
searches for script lines and expect the type set to text/javascript.
Otherwise dh_sphinxdoc won't find the scripts.
Therefore mark the JavaScript scripts explicitly as text/javascript.
Signed-off-by: Benjamin Drung <benjamin.drung@cloud.ionos.com>
* Updates doc builds to generate build timestamp only when building for docs.saltstack.com. This re-enables incremental builds.
Adds notes to OS X page that Salt master on OS X is not officially supported
Adds note to postgres returners to cross-link modules with usage explanation (ZD #875)
Adds example showing how to enable tcp transport
* Generate copyright date
Footer updates
