1
1
mirror of https://github.com/wez/wezterm.git synced 2024-11-27 02:25:28 +03:00
wezterm/mkdocs_macros.py
Wez Furlong 0fd76a77c5
docs: fixup absolute link warning for {{since(nightly)}}
We can now compute a relative link instead
2024-07-15 06:23:31 -07:00

44 lines
1.2 KiB
Python

import json
# https://mkdocs-macros-plugin.readthedocs.io/en/latest/macros/
def define_env(env):
with open("docs/releases.json") as f:
for (k, v) in json.load(f).items():
env.variables[k] = v
@env.macro
def since(vers, outline=False, inline=False):
if vers == "nightly":
# Determine the relative path traversal to the root,
# so that we can emit the link to the install page
rel_root = "../" * (len(env.page.url.split('/')) - 1)
first_line = "*Since: Nightly Builds Only*"
expanded = "+"
blurb = f"""
The functionality described in this section requires a nightly build of wezterm.
You can obtain a nightly build by following the instructions from the
[Download]({rel_root}installation.md) section.
"""
else:
first_line = f"*Since: Version {vers}*"
expanded = ""
blurb = f"""
*The functionality described in this section requires version {vers} of wezterm,
or a more recent version.*
"""
if outline:
return f"""
!!! info "{first_line}"
{blurb}
"""
if inline:
return f"({first_line})"
return f"""
???{expanded} info "{first_line}"
{blurb}
"""