hexo-custom-fields

hexo-custom-fields

A Hexo plugin that allows the default Markdown source files to be used as custom fields

Motive

I am a front-end developer originally. I used many CMS throughout the years and with many of them it was common to have custom fields. Which is a functionality that allows the coder to be able to include just snippets of text or an image path into a template. I wanted to try a static-site generator more deeply and chose Hexo which I like so far. It is just missing an easy way to include custom fields directly from your Markdown source files. That's exactly what this plugin is trying to solve!

Installation

NPM

npm install --save hexo-custom-fields

Yarn

yarn add hexo-custom-fields

Usage

Insert the custom_field() tag in your templates (in this example with EJS):

<%- custom_field('posts|pages, 'title_in_the_front_matter', 'name_of_the_field') %>

Argument	Description
first	'posts' or 'pages' - this determines if the directory 'source/_posts' or 'source/' is used for that field - Read more about the location in the Hexo documentation
second	'title' value in the front-matter of the Markdown source file - Read more about the front-matter in the Hexo documentation
third	the actual name of the chosen field. Below this table there is another one with possible options.

One can use the default fields provided by Hexo. The most important options for the third argument are these:

Option	Description
'any_field_name'	You can use an unlimited amount of custom fields in the front-matter of a source file. You can directly get these with their respective names - string
'content'	The rendered content of the Markdown file (so everything after the front-matter) - HTML
'title'	The given title - string
'date'	The date and time the source file was created at - formatted date (with timezone)
'updated'	The date and time the source file was last updated at - formatted date (with timezone)
'permalink'	The full URL of the post or page - URL
'_id'	The unique ID Hexo assigned to the source file - string

Example:

Display the custom field 'birthday' from the Markdown source file 'front-page' in the 'source' directory (which makes it a 'page') Read more about the location in the Hexo documentation

<%- custom_field('pages', 'front-page', 'birthday') %>

License

MIT