[pbs-devel] [PATCH proxmox-backup] docs: load local mathjax instead of from cdn

[pbs-devel] [PATCH proxmox-backup] docs: load local mathjax instead of from cdn

[Dominik Csapak]

By default, sphinx embeds the cdn version of mathjax.
Use a locally installed version instead.

The config is the default sphinx config used.

Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>
---
 debian/control.in                | 1 +
 debian/proxmox-backup-docs.links | 1 +
 docs/conf.py                     | 3 +++
 3 files changed, 5 insertions(+)

diff --git a/debian/control.in b/debian/control.in
index b4b4d22e..c6aee8ca 100644
--- a/debian/control.in
+++ b/debian/control.in
@@ -38,6 +38,7 @@ Package: proxmox-backup-docs
 Build-Profiles: <!nodoc>
 Section: doc
 Depends: libjs-extjs,
+         libjs-mathjax,
          ${misc:Depends},
 Architecture: all
 Description: Proxmox Backup Documentation
diff --git a/debian/proxmox-backup-docs.links b/debian/proxmox-backup-docs.links
index 688dfae0..2782f374 100644
--- a/debian/proxmox-backup-docs.links
+++ b/debian/proxmox-backup-docs.links
@@ -2,3 +2,4 @@
 /usr/share/javascript/extjs /usr/share/doc/proxmox-backup/html/prune-simulator/extjs
 /usr/share/javascript/extjs /usr/share/doc/proxmox-backup/html/lto-barcode/extjs
 /usr/share/javascript/extjs /usr/share/doc/proxmox-backup/html/api-viewer/extjs
+/usr/share/javascript/mathjax /usr/share/doc/proxmox-backup/html/_static/mathjax
diff --git a/docs/conf.py b/docs/conf.py
index f4e8743a..cfa4158d 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -464,3 +464,6 @@ epub_exclude_files = ['search.html']
 # If false, no index is generated.
 #
 # epub_use_index = True
+
+# use local mathjax package, symlink comes from debian/proxmox-backup-docs.links
+mathjax_path = "mathjax/MathJax.js?config=TeX-AMS-MML_HTMLorMML"
-- 
2.20.1

[pbs-devel] applied: [PATCH proxmox-backup] docs: load local mathjax instead of from cdn

[Thomas Lamprecht]

On 26.02.21 15:45, Dominik Csapak wrote:
> By default, sphinx embeds the cdn version of mathjax.
> Use a locally installed version instead.
> 
> The config is the default sphinx config used.
> 
> Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>
> ---
>  debian/control.in                | 1 +
>  debian/proxmox-backup-docs.links | 1 +
>  docs/conf.py                     | 3 +++
>  3 files changed, 5 insertions(+)
> 
>

Just as I hoped, simple change which works on pbs.proxmox.com too!

applied, merged in the d/control change (no biggie, everybody forgets that)
thanks!