Files
gitea-pages/doc_content_reuse.md
2015-08-11 16:48:17 -07:00

1.5 KiB

title, tags, audience, keywords, last_updated, summary
title tags audience keywords last_updated summary
Content reuse single-sourcing writer, designer

{% include linkrefs.html %}

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 folder, and then use a tag like this:

{% raw %}

{% include mypage.html %}

{% endraw %}

With content in your _includes folder, you don't add any frontmatter to these pages because they will be included on other pages already containing frontmatter.

Also, 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 Jekyll's documentation for more information on that.

Page-level variables

You can also create custom variables in your frontmatter like this:

---
title: Page-level variables
permalink: /page_level_variables/
thing1: Joe
thing2: Dave
---

You can then access the values in those custom variables using the page namespace, like this:

{% raw %}

thing1: {{page.thing1}}
thing2: {{page.thing2}}

{% endraw %}

Honestly, I haven't found a tremendous use case for page-level variables, but it's nice to know they're available.

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.