summaryrefslogtreecommitdiffstats
path: root/WORKFLOW.md
diff options
context:
space:
mode:
Diffstat (limited to 'WORKFLOW.md')
-rw-r--r--WORKFLOW.md18
1 files changed, 18 insertions, 0 deletions
diff --git a/WORKFLOW.md b/WORKFLOW.md
index c95141f..13a6da3 100644
--- a/WORKFLOW.md
+++ b/WORKFLOW.md
@@ -83,6 +83,24 @@ The banner appears automatically below the article header. If `successor` is set
Paths are Hugo permalinks — for English articles, use `/articles/slug`, not `/en/articles/slug`.
+### Add an external link to the main menu
+
+Add a menu entry in `hugo.toml` with `params.external = true`:
+
+```toml
+[[menus.main]]
+ name = "GitHub"
+ url = "https://github.com/youruser"
+ weight = 10
+ [menus.main.params]
+ external = true
+```
+
+- `name` is used as-is (not looked up in i18n)
+- `url` must be a full URL including scheme
+- `weight` controls order relative to other menu items
+- External links open in a new tab with `rel="noopener noreferrer"` and include a screen-reader-only "(opens in new tab)" label for WCAG 2.1 AA compliance
+
---
## Working on the Theme