Added support for displaying version aliases

Author: squidfunk

docs/schema/extra.json

@@ -317,6 +317,12 @@
             }
           ],
           "default": "stable"
+        },
+        "alias": {
+          "title": "Show alias next to version number",
+          "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/setting-up-the-versioning/#version-alias",
+          "type": "boolean",
+          "default": true
         }
       }
     },

material/overrides/assets/javascripts/custom.63a6dff3.min.js renamed to material/overrides/assets/javascripts/custom.b457887c.min.js

@@ -23,5 +23,5 @@
 {% endblock %}
 {% block scripts %}
   {{ super() }}
-  <script src="{{ 'assets/javascripts/custom.63a6dff3.min.js' | url }}"></script>
+  <script src="{{ 'assets/javascripts/custom.b457887c.min.js' | url }}"></script>
 {% endblock %}

material/overrides/assets/javascripts/custom.63a6dff3.min.js.map renamed to material/overrides/assets/javascripts/custom.b457887c.min.js.map

@@ -44,7 +44,7 @@
       {% endif %}
     {% endblock %}
     {% block styles %}
-      <link rel="stylesheet" href="{{ 'assets/stylesheets/main.732c4fb1.min.css' | url }}">
+      <link rel="stylesheet" href="{{ 'assets/stylesheets/main.6543a935.min.css' | url }}">
       {% if config.theme.palette %}
         {% set palette = config.theme.palette %}
         <link rel="stylesheet" href="{{ 'assets/stylesheets/palette.06af60db.min.css' | url }}">
@@ -249,7 +249,7 @@
       </script>
     {% endblock %}
     {% block scripts %}
-      <script src="{{ 'assets/javascripts/bundle.7c1205d0.min.js' | url }}"></script>
+      <script src="{{ 'assets/javascripts/bundle.ebd0bdb7.min.js' | url }}"></script>
       {% for script in config.extra_javascript %}
         {{ script | script_tag }}
       {% endfor %}

material/overrides/main.html

@@ -83,6 +83,7 @@ export type Translations =
 export interface Versioning {
   provider: "mike"                     /* Version provider */
   default?: string | string[]          /* Default version */
+  alias?: boolean                      /* Show alias */
 }
 
 /**

material/templates/assets/javascripts/bundle.7c1205d0.min.js renamed to material/templates/assets/javascripts/bundle.ebd0bdb7.min.js

@@ -64,6 +64,11 @@ function renderVersion(version: Version): HTMLElement {
     <li class="md-version__item">
       <a href={`${url}`} class="md-version__link">
         {version.title}
+        {config.version?.alias && version.aliases.length && (
+          <span class="md-version__alias">
+            {version.aliases[0]}
+          </span>
+        )}
       </a>
     </li>
   )
@@ -84,6 +89,7 @@ function renderVersion(version: Version): HTMLElement {
 export function renderVersionSelector(
   versions: Version[], active: Version
 ): HTMLElement {
+  const config = configuration()
   versions = versions.filter(version => !version.properties?.hidden)
   return (
     <div class="md-version">
@@ -92,6 +98,11 @@ export function renderVersionSelector(
         aria-label={translation("select.version")}
       >
         {active.title}
+        {config.version?.alias && active.aliases.length && (
+          <span class="md-version__alias">
+            {active.aliases[0]}
+          </span>
+        )}
       </button>
       <ul class="md-version__list">
         {versions.map(renderVersion)}

material/templates/assets/javascripts/bundle.7c1205d0.min.js.map renamed to material/templates/assets/javascripts/bundle.ebd0bdb7.min.js.map

@@ -76,6 +76,12 @@
     }
   }
 
+  // Version alias
+  &__alias {
+    margin-left: px2rem(6px);
+    opacity: 0.7;
+  }
+
   // Version selection list
   &__list {
     position: absolute;