Prevent header title changing to page title?

[StarfallProjects]

Hi! At present, the main title in the header changes to the page title on scroll.
So for example: https://squidfunk.github.io/mkdocs-material/getting-started/ "Material for MkDocs" changes to "Getting started" when you scroll the page.

Is it possible to disable this?

[squidfunk]

There's no feature flag, but you can override header.html and remove the following part:

mkdocs-material/src/partials/header.html

Lines 60 to 67 in 55a58da

	<div class="md-header__topic" data-md-component="header-topic">
	<span class="md-ellipsis">
	{% if page and page.meta and page.meta.title %}
	{{ page.meta.title }}
	{% else %}
	{{ page.title }}
	{% endif %}
	</span>

[StarfallProjects]

Thanks! I ended up doing this to avoid the title vanishing:

    <div class="md-header__title" data-md-component="header-title">
      <div class="md-header__ellipsis">
        <div class="md-header__topic">
          <span class="md-ellipsis">
            {{ config.site_name }}
          </span>
        </div>
        <div class="md-header__topic" data-md-component="header-topic">
          <span class="md-ellipsis">
            {{ config.site_name }}
          </span>
        </div>
      </div>
    </div>

[mfncooper]

I know I'm late to the party, but ...

While the solution from @squidfunk does prevent the page title from replacing the site title, it causes the site title to go blank, rather than leaving it unchanged. For me, what @StarfallProjects used causes the site title to be replaced with the site title again but with a slightly different styling, so there's still a subtle change.

It turns out that simply removing the data-md-component attribute from this line does the right thing and prevents the site title from being replaced at all:

https://github.com/squidfunk/mkdocs-material/blob/master/src/templates/partials/header.html#L56

Hope that helps someone else digging for a solution.

[rodrigoalcarazdelaosa]

Is there any way to prevent this just on the homepage for example? I'm also using the toc extension (with permalink: true) and would like to disable it but just on the homepage. Thanks in advance!

[squidfunk]

Yes, you can override content.html and remove the following lines:

mkdocs-material/src/templates/partials/content.html

Lines 31 to 37 in 1b346eb

	<!--
	Hack: check whether the content contains a h1 headline. If it doesn't, the
	page title (or respectively site name) is used as the main headline.
	-->
	{% if "\x3ch1" not in page.content %}
	<h1>{{ page.title | d(config.site_name, true)}}</h1>
	{% endif %}

[rodrigoalcarazdelaosa]

Thanks, that helps me with the <h1> element, but if I add a <h2> heading, I still see the paragraph symbol. It'd be nice if we could control markdown extensions on a per page basis (setting them on the front matter), not sure how hard this could be. Thanks!

[squidfunk]

MkDocs is currently undergoing a major refactor, so it's a good idea to ask the maintainers of MkDocs – maybe it's a good fit for the next version of MkDocs? Could be a sound use case, i.e., influencing Markdown rendering per page (or folder).

[rodrigoalcarazdelaosa]

For reference: mkdocs/mkdocs#3715