add macros plugin

Author: olegantonyan

docs/getting_started.md

@@ -4,8 +4,8 @@
 
 Agent is responsible for building packages. You'll need it to build packages locally. There are multiple ways to install it:
 
-1. OmniPackage repositories [web.omnipackage.org/oleg/omnipackage-agent](https://web.omnipackage.org/oleg/omnipackage-agent)
-2. [Source code](https://github.com/omnipackage/omnipackage-agent-ruby). Reasonably recent version of Ruby required. Executables located in `exe/` directory
+1. OmniPackage repositories [{{agent_public_install_url | replace("http://", "")|replace("https://", "") }}]({{ agent_public_install_url }})
+2. [Source code]({{ agent_github_url }}). Reasonably recent version of Ruby required. Executables located in `exe/` directory
 
 Test your installation
 ```shell
@@ -16,7 +16,7 @@ Agent requires `podman` or `docker` as well as few other common Linux programs.
 
 ## Building example project
 
-1. Clone [examples](https://github.com/omnipackage/examples) repository
+1. Clone [examples]({{ examples_url }}) repository
 2. `cd examples`
 3. `omnipackage build c_makefile`
 

docs/index.md

@@ -4,6 +4,5 @@
 
 There are 2 main components:
 
-1. [Agent](https://github.com/omnipackage/omnipackage-agent-ruby) - responsible for building packages. Can be used as stand-alone or as a build agent connected to the server-side
-2. [Server-side aka web](https://github.com/omnipackage/omnipackage-web) - responsible for web UI, package signing and repositories management. Managed version [web.omnipackage.org](https://web.omnipackage.org). Can be [self-hosted](self_hosting.md)
-
+1. [Agent]({{ agent_github_url }}) - responsible for building packages. Can be used as stand-alone or as a build agent connected to the server-side
+2. [Server-side aka web]({{ web_github_url }}) - responsible for web UI, package signing and repositories management. Managed version [{{ web_hosted_url | replace("http://", "")|replace("https://", "") }}]({{ web_hosted_url }}). Can be [self-hosted](self_hosting.md)

mkdocs.yml

@@ -11,7 +11,12 @@ nav:
   - 'Self-hosting': self_hosting.md
   - About: about.md
 
-
+extra:
+  web_github_url: https://github.com/omnipackage/omnipackage-web
+  agent_github_url: https://github.com/omnipackage/omnipackage-agent-ruby
+  web_hosted_url: https://web.omnipackage.org
+  examples_github_url: https://github.com/omnipackage/examples
+  agent_public_install_url: https://web.omnipackage.org/oleg/omnipackage-agent
 
 
 
@@ -60,6 +65,7 @@ plugins:
 - search
 - privacy
 - git-revision-date-localized
+- macros
 
 
 extra_css:

requirements.txt

@@ -3,3 +3,4 @@ mkdocs-material
 mkdocs-material[imaging]
 mkdocs-git-revision-date-localized-plugin
 Pygments
+mkdocs-macros-plugin