[Permalink] Using the document's actual title instead of the its file name

[wsmd]

Say I have this document named 2015-10-06-dont-show-this.md

and in in its front matter I have this title

---
title: this is the actual title

---

I've set the permalink in my _config.yml to :categories/:title and I understand that the documentation clearly states:

title => Title from the document’s filename. May be overridden via the document’s slug YAML front matter.

So, when the site renders, of course the link to the page will be:

http://link.to.site/category/dont-show-this

Is there any way I can use the article's actual title in the link? So it would be:

http://link.to.site/category/this-is-the-actual-title

Maybe something like auto slugging the actual title?

[mattr-]

I believe your answer is "hidden" in the docs you posted.

title => Title from the document’s filename. May be overridden via the document’s slug YAML front matter.

You'll need a piece of front matter named slug with the slug you actually want the post to have.

[wsmd]

@mattr- That's right. But I'm looking for an "automatic" way to do it without having to enter the slug manually. Simply put, Jekyll should use the title (front matter) of the article and automatically creates an a slug from it.

[parkr]

The filename will always need a slug. title from your front matter cannot be used in the slug at this point. :title will always be the filename slug, at least at the time of this writing (v3.0.1).

jekyll/lib/jekyll/document.rb

Lines 189 to 191 in 970edaf

	title: Utils.slugify(data['slug'], mode: "pretty", cased: true) || Utils
	.slugify(basename_without_ext, mode: "pretty", cased: true),
	slug: Utils.slugify(data['slug']) || Utils.slugify(basename_without_ext),

Changing this would cause lots of issues, so I'm going to mark this as "Won't Fix."