Why does the Netlify template require to have at least overrides/hooks/on_env.py as hook and generate_graph: false as extra?

[ooker777]

I notice the minimal workable mkdocs.yaml setting for the latest commit of the netlify template is:

site_name: your_site_name

theme:
    name: 'material'
    custom_dir: overrides
hooks:
  - overrides/hooks/on_env.py
extra:
  generate_graph: false

Error if the hook is not provided

  File "D:\Programming\Static web\mkdocs\template-netlify-vercel\overrides\main.html", line 27, in template   
    {% set pg_title = 'title' | value_in_frontmatter(page.meta) %}
    ^^^^^^^^^^^^^^^^^^^^^^^^^
jinja2.exceptions.TemplateAssertionError: No filter named 'value_in_frontmatter'.

Error if the extra is not provided

  File "D:\Programming\Static web\mkdocs\template-netlify-vercel\overrides\hooks\on_env.py", line 181, in on_env
    obsidian_graph()
  File "D:\Programming\Static web\mkdocs\template-netlify-vercel\overrides\hooks\on_env.py", line 16, in obsidian_graph
    import obsidiantools.api as otools

The code works if custom_dir is not provided. Do you have any idea?

[Mara-Li]

Extra and hooks have different purpose.
Hooks run python script and is needed for the build.
Extra add custom yaml parameters needed to tell the on_env script how to build the website.

[Mara-Li]

Moreover, in this Holiday season / after my finals, I will upgrade the template to have only one repository and set-up a scripts where you can define the value of mkdocs.yaml directly.
The idea is to run the Github Actions, fill the value, and you don't need extra configuration!

[ooker777]

As stated in Compatibility of publishing solution, GitHub Pages building time is very long. Is there a way to build it on my machine first and then push the result after automatically?

[Mara-Li]

Well, i don't think it will be better.
Here is my timer :

[Mara-Li]

I accelerated the build because :

• Python 3.11+
• Optimization with assets

[Mara-Li]

A future upgrade of Material should accelerate more the build, but the plugin is paid for the moment.