🚸 Open external links in a new window

See: https://github.com/JakubAndrysek/mkdocs-open-in-new-tab

💄 Materialize external links with a right upward arrow

INFO:

This does NOT work if you are accesing the site via Gitub Pages:
    https://USERNAME.github.io/trio-docs/

It works when accessing the site via https://docs.diy-trio.org/
or previewing the site locally with `mkdocs serve`.

Why?
Mkdocs-open-in-new-tab uses an absolute URL '/js/open_in_new_tab.js'
This URL won't work when deployed in a sub-folder.

✅            https://docs.diy-trio.org/js/open_in_new_tab.js
✅                http://127.0.0.1:8000/js/open_in_new_tab.js
❌    https://ericbouchut.com/trio-docs/js/open_in_new_tab.js
❌ https://ebouchut.github.io/trio-docs/js/open_in_new_tab.js

docs/assets/stylesheets/extra.css

@@ -1,3 +1,14 @@
+/*
+ * Materialize links that open in a new window/tab with a right-up arrow icon
+ */
+a[target="_blank"]::after {
+  content: "↗";
+  display: inline-block;
+  margin-left: 0.2em;
+  width: 1em;
+  height: 1em;
+}
+
 /* 
  * Add admonition type: important (red exclamation sign) 
  * See: https://squidfunk.github.io/mkdocs-material/reference/admonitions/#custom-admonitions

mkdocs.yml

@@ -57,6 +57,7 @@ theme:
     - toc.integrate
 
 plugins:
+  - open-in-new-tab
   - macros:
       include_dir: .
   - exporter:

requirements.in

@@ -3,4 +3,5 @@ mkdocs-exporter==6.1.1
 mkdocs-material>=9.5.9
 mkdocs-include-markdown-plugin>=6.0.4
 mkdocs-exclude>=1.0.2
+mkdocs-open-in-new-tab==1.0.6
 mkdocs-macros-plugin>=1.0.4

requirements.txt

@@ -23,6 +23,7 @@ mkdocs-include-markdown-plugin==6.2.2
 mkdocs-macros-plugin==1.3.5
 mkdocs-material==9.5.40
 mkdocs-material-extensions==1.3.1
+mkdocs-open-in-new-tab==1.0.6
 packaging==24.1
 paginate==0.5.7
 pathspec==0.12.1