How to have /year/month/slug.html as blog URL

[copdips]

Hello,

Current blog post url format is:
/blog/year/month/day/slug/,

as I'm migrating from other blog system to mkdocs-material, the orignal url format is:
/year/month/slug.html,

is there a way to keep the orignal format in mkdocs-material ? Thanks

[kamilkrzyskow]

Hello,
I modified the https://github.com/mkdocs-material/examples/tree/master/examples/blog-basic example for your needs;
blog-basic-for-copdips.zip

To remove the blog prefix of the URL you need to setup a stand-alone blog only site:
https://squidfunk.github.io/mkdocs-material/plugins/blog/#config.blog_dir-blog-only
To remove the day part of the URL you need to change the post_url_date_format option:
https://squidfunk.github.io/mkdocs-material/plugins/blog/#config.post_url_date_format
To enable .html path endings you need to disable the use_directory_urls global MkDocs option:
https://www.mkdocs.org/user-guide/configuration/#use_directory_urls

[copdips]

Thanks a lot @kamilkrzyskow for your prompt response, the zip file you provided especially for me works like a charm !
Now I have the same URLs between the old blog system and the new mkdocs-material one, so cool.

And I noticed that in the zip, the posts folder is under docs folder directly which is good for my needs, but the exmaple in the repo is still under docs/blog folder:

[kamilkrzyskow]

Yes, it's inside the blog directory, because that's the default for the Documentation + Blog setup:
https://squidfunk.github.io/mkdocs-material/plugins/blog/#config.blog_dir-documentation--blog
But you need to use the Blog only setup with files inside the root of docs to achieve the result you want.

[copdips]

thanks for this trick, it would be nice to document this somewhere for other users having the same needs probabally :)

[kamilkrzyskow]

But it's documented: https://squidfunk.github.io/mkdocs-material/plugins/blog/#config.blog_dir
Are you saying that the requirement of changing the path via blog_dir isn't enough of an indication that the files need to be in the root of docs as well?

[copdips]

yes, I just made a pull request, please check:
#6435

[copdips]

@kamilkrzyskow
One more question about slug genetation please.

Say I have a blog post with top level head:

# Github - Test

Within the old blog system, its slug is : github-test, but within mkdocs material, by default, it's github---test, is there any way to keep the old way, which means consider - as special chars, just like white spaces. And would be better to have a param to set a list of such special chars.

[squidfunk]

You can try the standard slug function from Python Markdown, which filters all Unicode characters:

plugins:
  - blog:
      post_slugify: !!python/name:markdown.extensions.toc.slugify

However, you'll get an error when you'll do this anywhere except on master, because I just discovered that the typings are too strict, which I fixed in adad823, so either use master or wait for the next release.

Additionally, you might encounter cases where you need to set the slug manually. This is also possible and simple:

---
slug: help-im-trapped-in-a-universe-factory
---

# Post title
...

[copdips]

thx a lot, I'll wait for the new release !