clickable site_name

[sheldygg]

how i can make this name clickable?

[alexvoss]

The way to make changes like this is to override the relevant partial, header.html in this case. You will find it where mkdocs-material is installed.

[sheldygg]

This works if i override all file. In documentation i read what I can override one block.
I do this

{% extends "partials/header.html" %}

{% block htmltitle %}
  <div class="md-header__title" data-md-component="header-title">
      <div class="md-header__ellipsis">
        <div class="md-header__topic">
          <span class="md-ellipsis">
              <a
                href="{{ config.extra.homepage | d(nav.homepage.url, true) | url }}"
                title="{{ config.site_name | e }}"
              >{{ config.site_name | e }}</a>
          </span>
        </div>
        <div class="md-header__topic" data-md-component="header-topic">
          <span class="md-ellipsis">
            {% if page.meta and page.meta.title %}
              {{ page.meta.title }}
            {% else %}
              {{ page.title }}
            {% endif %}
          </span>
        </div>
      </div>
    </div>
{% endblock %}

But i get error

Error

``` Traceback (most recent call last): File "", line 198, in _run_module_as_main File "", line 88, in _run_code File "E:\default\projects\docs\venv\Scripts\mkdocs.exe\__main__.py", line 7, in File "E:\default\projects\docs\venv\Lib\site-packages\click\core.py", line 1157, in __call__ return self.main(*args, **kwargs) ^^^^^^^^^^^^^^^^^^^^^^^^^^ File "E:\default\projects\docs\venv\Lib\site-packages\click\core.py", line 1078, in main rv = self.invoke(ctx) ^^^^^^^^^^^^^^^^ File "E:\default\projects\docs\venv\Lib\site-packages\click\core.py", line 1688, in invoke return _process_result(sub_ctx.command.invoke(sub_ctx)) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ File "E:\default\projects\docs\venv\Lib\site-packages\click\core.py", line 1434, in invoke return ctx.invoke(self.callback, **ctx.params) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ File "E:\default\projects\docs\venv\Lib\site-packages\click\core.py", line 783, in invoke return __callback(*args, **kwargs) ^^^^^^^^^^^^^^^^^^^^^^^^^^^ File "E:\default\projects\docs\venv\Lib\site-packages\mkdocs\__main__.py", line 270, in serve_command serve.serve(**kwargs) File "E:\default\projects\docs\venv\Lib\site-packages\mkdocs\commands\serve.py", line 86, in serve builder(config) File "E:\default\projects\docs\venv\Lib\site-packages\mkdocs\commands\serve.py", line 67, in builder build(config, live_server=None if is_clean else server, dirty=is_dirty) File "E:\default\projects\docs\venv\Lib\site-packages\mkdocs\commands\build.py", line 340, in build _build_theme_template(template, env, files, config, nav) File "E:\default\projects\docs\venv\Lib\site-packages\mkdocs\commands\build.py", line 110, in _build_theme_template output = _build_template(template_name, template, files, config, nav) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ File "E:\default\projects\docs\venv\Lib\site-packages\mkdocs\commands\build.py", line 89, in _build_template output = template.render(context) ^^^^^^^^^^^^^^^^^^^^^^^^ File "E:\default\projects\docs\venv\Lib\site-packages\jinja2\environment.py", line 1301, in render self.environment.handle_exception() File "E:\default\projects\docs\venv\Lib\site-packages\jinja2\environment.py", line 936, in handle_exception raise rewrite_traceback_stack(source=source) File "E:\default\projects\docs\overrides\404.html", line 1, in top-level template code {% extends "main.html" %} File "E:\default\projects\docs\venv\Lib\site-packages\material\templates\main.html", line 4, in top-level template code {% extends "base.html" %} File "E:\default\projects\docs\venv\Lib\site-packages\material\templates\base.html", line 143, in top-level template code {% block header %} ^^^^^^^^^^^^^^^^^^^^^^^ File "E:\default\projects\docs\venv\Lib\site-packages\material\templates\base.html", line 144, in block 'header' {% include "partials/header.html" %} ^^^^^^^^^^^^^^^^^^^^^^^ File "E:\default\projects\docs\overrides\partials\header.html", line 1, in top-level template code {% extends "partials/header.html" %} ^^^^^^^^^^^^^^^^^^^^^^^^^ File "E:\default\projects\docs\overrides\partials\header.html", line 1, in top-level template code {% extends "partials/header.html" %} ^^^^^^^^^^^^^^^^^^^^^^^^^ File "E:\default\projects\docs\overrides\partials\header.html", line 1, in top-level template code {% extends "partials/header.html" %} ^^^^^^^^^^^^^^^^^^^^^^^^^ [Previous line repeated 975 more times] File "E:\default\projects\docs\venv\Lib\site-packages\jinja2\utils.py", line 466, in get return self[key] ~~~~^^^^^ RecursionError: maximum recursion depth exceeded ```

[alexvoss]

There are no blocks at the level of a partial. This is a limitation of the jinja2 templating engine that is being used, so will not change anytime soon unless they decide to fix it. It has been like this for a while. Generally speaking, you can only override a block that exists within one of the template files but you won't find any in the partials, so you always need to override those.

I know this is a bit of a pain as changes to partials can break your customization but any changes to templates and partials are mentioned in the changelog

[sheldygg]

Okay, thanks.