How can I rid of all JavaScript?

[ghost]

Hi, I'm loving Material, but my site does not need JS nor Search functionality.
My readers are supposed to be Mass-Surveillance aware people (hopefully) and they are not going to run any JS.
(It will actually look bad that I try to run JS in someone else browsers)

Also LibreJS will block anyway several JS from loading reporting some warnings.

Thank you in advance.
Chip

[kamilkrzyskow]

Hello @alithechemist,
you can override the theme and prevent adding JavaScript to the HTML code:
https://squidfunk.github.io/mkdocs-material/customization/#extending-the-theme
https://squidfunk.github.io/mkdocs-material/customization/#overriding-blocks

mkdocs-material/src/templates/base.html

Lines 389 to 441 in 246266f

	{% block config %}
	{%- set app = {
	"base": base_url,
	"features": features,
	"translations": {},
	"search": "assets/javascripts/workers/search.js" | url
	} -%}
	<!-- Versioning -->
	{%- if config.extra.version -%}
	{%- set mike = config.plugins.get("mike") -%}
	{%- if not mike or mike.config.version_selector -%}
	{%- set _ = app.update({ "version": config.extra.version }) -%}
	{%- endif -%}
	{%- endif -%}
	<!-- Tags -->
	{%- if config.extra.tags -%}
	{%- set _ = app.update({ "tags": config.extra.tags }) -%}
	{%- endif -%}
	<!-- Translations -->
	{%- set translations = app.translations -%}
	{%- for key in [
	"clipboard.copy",
	"clipboard.copied",
	"search.result.placeholder",
	"search.result.none",
	"search.result.one",
	"search.result.other",
	"search.result.more.one",
	"search.result.more.other",
	"search.result.term.missing",
	"select.version"
	] -%}
	{%- set _ = translations.update({ key: lang.t(key) }) -%}
	{%- endfor -%}
	<!-- Configuration -->
	<script id="__config" type="application/json">
	{{- app | tojson -}}
	</script>
	{% endblock %}
	<!-- Theme-related JavaScript -->
	{% block scripts %}
	<script src="{{ 'assets/javascripts/bundle.js' | url }}"></script>
	<!-- Custom JavaScript -->
	{% for script in config.extra_javascript %}
	{{ script | script_tag }}
	{% endfor %}
	{% endblock %}

Override the config and scripts blocks ans keep them empty.

If you require that no bundle.js is even included in the deployed files, then you would have to add a hook that removes the file from the rendered site directory:
https://www.mkdocs.org/user-guide/configuration/#hooks

If you need more help I could stitch together some example.

[ghost]

Hi, thanks, for the super quick reply.
I'm actually trying to override the blocks as you suggested, but I end up with a white page.

What I did.

• create a folder 'overrides' in the same folder that contains mkdocs.yml
• add a file called base.html
• add content from mkdocs-material/src/templates/base.html
• remove the content between the two blocks like you suggested.

content of overrides/base.html

{% block config %} 
{% endblock %} 
  
 <!-- Theme-related JavaScript --> 
 {% block scripts %} 
 {% endblock %}

Am I missing something?
Thanks in advance.

[ghost]

oopsy, Just got it working, I had to call the override "main.html" and use

{% extends "base.html" %}
{% block config %} 
{% endblock %} 
  
 <!-- Theme-related JavaScript --> 
 {% block scripts %} 
 {% endblock %}

Everything working as expected.

Also there is one Javascript used by mkdocs to reload the pages when I change the source, that's ok.

Thanks a lot!
Chip

[ghost]

@kamilkrzyskow me again,
I have now the following directory tree:

mkdocs.yml
overrides
├── main.html
└── partials
    └── javascript
        ├── announce.html
        ├── base.html
        ├── consent.html
        ├── content.html
        ├── outdated.html
        └── palette.html

all the files in partials/javascripts/* are empty.

But still I see the script in the LibreJS warning (the one on line 41 in the image I attached)
I did not see it before...

As you suggested the JS is in base.html and I created an empty file in overrides/javascripts.
Are these directories correct for partials overrides?
What might be the reason why this one is not working?
I did not see any cache...

Thanks in advance for any suggestions.
Chip

[kamilkrzyskow]

Based on the message I see that you created a partials/javascript directory instead of partials/javascripts

As you suggested the JS is in base.html and I created an empty file in overrides/javascripts.

overrides/javascripts also isn't correct.

You have to map the directory tree 1:1 to override it.

mkdocs-material/src/templates/base.html

Lines 152 to 155 in 246266f

	<!-- Helper functions for inline scripts -->
	{% include "partials/javascripts/base.html" %}

[ghost]

Renaming javascript to javascripts made it work.
Thanks again, sorry for the rookie mistake.
Chip