diff options
Diffstat (limited to 'WORKFLOW.md')
| -rw-r--r-- | WORKFLOW.md | 35 |
1 files changed, 35 insertions, 0 deletions
diff --git a/WORKFLOW.md b/WORKFLOW.md index 6743d9d..e7cafd5 100644 --- a/WORKFLOW.md +++ b/WORKFLOW.md @@ -76,6 +76,41 @@ git commit -m "config: ..." git push origin master ``` +### Mark an article as obsolete + +Add `obsolete = true` to the article's front matter. Optionally link to a successor article with `successor = "/path/to/article"`: + +```toml ++++ +title = "My Old Article" +# ... other fields ... +obsolete = true +successor = "/articles/my-new-article" ++++ +``` + +The banner appears automatically below the article header. If `successor` is set, it resolves the article title and links to it. Both EN and IT i18n strings are customizable in `i18n/en.yaml` and `i18n/it.yaml`. + +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 |