About content reuse
You can embed content from one file inside another using includes. Put the file containing content you want to reuse (e.g., mypage.html) inside the _includes/custom folder and then use a tag like this:
{% include custom/mypage.html %}
With content in your _includesfolder, you don’t add any frontmatter to these pages because they will be included on other pages already containing frontmatter.
Note:
By convention, content intended to be included in other pages is kept in the _includes/content directory, to distinguish it from include templates and other snippets of HTML such as header and footer layout.
When you include a file, all of the file’s contents get included. You can’t specify that you only want a specific part of the file included. However, you can use parameters with includes. See the following Jekyll cast for more info about using parameters with includes:
Relative includes
In addition to using the {% include .. %} directive, Jekyll has an {% include_relative .. %} directive
that enables you to specify a relative path for the content, instead of keeping it on the _include directory. This is enables you to have included/reused content that is specific to a particular release.
For example, see the files in pages/en/lb3/includes.
Page-level variables
You can also create custom variables in your frontmatter like this:
---
title: Page-level variables
permalink: /doc/en/contrib/page_level_variables/
thing1: Joe
thing2: Dave
---
You can then access the values in those custom variables using the page namespace, like this:
thing1: {{page.thing1}}
thing2: {{page.thing2}}
I use includes all the time. Most of the includes in the _includes directory are pulled into the theme layouts. For those includes that change, I put them inside custom and then inside a specific project folder.