The front-matter's permalink can not override config.permalink

[yoshinorin]

from #3442

Environment Info

Your site _config.yml (Optional):

new_post_name: :year-:month-:day-:title.md

and frontmatter is

---
title: "This is a test"
date: 2019-01-31 20:44:31
permalink: first-blog
---

Expected behavior

URL is http://localhost:3000/first-blog

Actual behaviot

URL is http://localhost:3000/2019/01/first-blog

[gautamz07]

@yoshinorin curious , so if you exclude permalink from the front matter the expected behavior is ::-

http://localhost:3000/2019/01/first-blog ?

[yoshinorin]

Thanks @gautamz07 :)

I think maybe ...

// _config.yml
new_post_name: :year-:month-:day-:title.md

// Front-matter
---
title: "This is a test"
date: 2019-01-31 20:44:31
---

// Result
http://localhost:3000/2019/01/31/This-is-a-test

But it is just my personal opinion...

[gautamz07]

Oh got it :) i ran into this same issue a while back .. i did't want that YY/MM/DD

[stevenjoezhang]

Relevant issues:
#1099
#1158
#1813

[SukkaW]

It seems that only post is affected. The dedicated pages won't be affected.

[SukkaW]

Since only the post is affected, I wonder if the issue is about new_post_path filter or post_permalink filter.

[SukkaW]

@yoshinorin @stevenjoezhang

Let me make the issue a little more clear:

When config.permalink is set and no permalink in the front-matter

# _config.yml
new_post_name: :title.md # File name of new posts
permalink: post/:name/
permalink_defaults: :title/

source/_posts/2020/hello-world.md:

---
title: "This is a test"
date: 2021-01-31 20:44:31
---

Then I get: /post/hello-world/. LGTM, it fits config.permalink just as I want it to be.

And if I change it to this:

# _config.yml
new_post_name: :title.md # File name of new posts
permalink: post/:title/ # Use :title instead of :name
permalink_defaults: :title/

---
title: "This is a test"
date: 2021-01-31 20:44:31
---

I will get http://localhost:5000/post/2020/hello-world/. Still, it fits config.permalink.

Try to use front-matter to override config.permalink

Here you go!

# _config.yml
new_post_name: :title.md # File name of new posts
permalink: post/:title/ # Use :title instead of :name
permalink_defaults: :title/

---
title: "This is a test"
date: 2021-01-31 20:44:31
permalink: hexo-hexo-hexo/i-love-hexo
---

Guess what! I get /post/hexo-hexo-hexo/i-love-hexo/ instead of /hexo-hexo-hexo/i-love-hexo/!

So I changed my config again, this time I will use :name instead of :title

# _config.yml
new_post_name: :title.md # File name of new posts
permalink: post/:title/ # Use :title instead of :name
permalink_defaults: :title/

---
title: "This is a test"
date: 2021-01-31 20:44:31
permalink: hexo-hexo-hexo/i-love-hexo
---

Then what? I get /post/i-love-hexo/! Even the hexo-hexo-hexo is now gone!

---

So it appears that not only page.permalink can't override anything, it is even being affected by config.permalink.

[SukkaW]

So here is what I found.

hexo/lib/plugins/processor/post.js

Lines 123 to 126 in edef5c2

	if (data.permalink) {
	data.slug = data.permalink;
	delete data.permalink;
	}

As you can see, permalink in the front-matter will become data.slug (permalink overriding slug), and data.permalink will be deleted.

But post.slug doesn't matter much. The real thing that matters most is post.path. Then guess what? post.path is a [getter]:

So what [getter]? Take a look at the model of the post:

hexo/lib/models/post.js

Lines 48 to 51 in edef5c2

	Post.virtual('path').get(function() {
	const path = ctx.execFilterSync('post_permalink', this, {context: ctx});
	return typeof path === 'string' ? path : '';
	});

Ha! The post.path is actually post_permalink filter.

Yes, post_permalink is what we should looking at.

Even the post.permalink we used in out template is not the permalink in the front-matter. It is also a [getter], which is full_url_for(this.path). That means post.permalink is still affected by post_permalink filter.

hexo/lib/models/post.js

Lines 53 to 55 in edef5c2

	Post.virtual('permalink').get(function() {
	return full_url_for.call(ctx, this.path);
	});