changed _pages to pages and removed include pages from config file. turned out this wasn't necessary.
This commit is contained in:
111
pages/mydoc/mydoc_glossary.md
Normal file
111
pages/mydoc/mydoc_glossary.md
Normal file
@ -0,0 +1,111 @@
|
||||
---
|
||||
title: Glossary layout
|
||||
tags: [formatting, special_layouts]
|
||||
keywords: definitions, glossaries, terms, style guide
|
||||
last_updated: July 3, 2016
|
||||
summary: "Your glossary page can take advantage of definitions stored in a data file. This gives you the ability to reuse the same definition in multiple places. Additionally, you can use Bootstrap classes to arrange your definition list horizontally."
|
||||
sidebar: mydoc_sidebar
|
||||
permalink: mydoc_glossary.html
|
||||
toc: false
|
||||
folder: mydoc
|
||||
---
|
||||
|
||||
|
||||
You can create a glossary for your content. First create your glossary items in a data file such as glossary.yml.
|
||||
|
||||
Then create a page and use definition list formatting, like this:
|
||||
|
||||
fractious
|
||||
: {{site.data.glossary.fractious}}
|
||||
|
||||
gratuitous
|
||||
: {{site.data.glossary.gratuitous}}
|
||||
|
||||
haughty
|
||||
: {{site.data.glossary.haughty}}
|
||||
|
||||
gratuitous
|
||||
: {{site.data.glossary.gratuitous}}
|
||||
|
||||
impertinent
|
||||
: {{site.data.glossary.intrepid}}
|
||||
|
||||
Here's the code:
|
||||
|
||||
```
|
||||
{% raw %}fractious
|
||||
: {{site.data.glossary.fractious}}
|
||||
|
||||
gratuitous
|
||||
: {{site.data.glossary.gratuitous}}
|
||||
|
||||
haughty
|
||||
: {{site.data.glossary.haughty}}
|
||||
|
||||
gratuitous
|
||||
: {{site.data.glossary.gratuitous}}
|
||||
|
||||
impertinent
|
||||
: {{site.data.glossary.intrepid}}{% endraw %}
|
||||
```
|
||||
|
||||
The glossary works well as a link in the top navigation bar.
|
||||
|
||||
## Horizontally styled definiton lists
|
||||
|
||||
You can also change the definition list (`dl`) class to `dl-horizontal`. This is a Bootstrap specific class. If you do, the styling looks like this:
|
||||
|
||||
<dl class="dl-horizontal">
|
||||
|
||||
<dt id="fractious">fractious</dt>
|
||||
<dd>{{site.data.glossary.fractious}}</dd>
|
||||
|
||||
<dt id="gratuitous">gratuitous</dt>
|
||||
<dd>{{site.data.glossary.gratuitous}}</dd>
|
||||
|
||||
<dt id="haughty">haughty</dt>
|
||||
<dd>{{site.data.glossary.haughty}}</dd>
|
||||
|
||||
<dt id="benchmark_id">gratuitous</dt>
|
||||
<dd>{{site.data.glossary.gratuitous}}</dd>
|
||||
|
||||
<dt id="impertinent">impertinent</dt>
|
||||
<dd>{{site.data.glossary.impertinent}}</dd>
|
||||
|
||||
<dt id="intrepid">intrepid</dt>
|
||||
<dd>{{site.data.glossary.intrepid}}</dd>
|
||||
|
||||
</dl>
|
||||
|
||||
For this type of list, you must use HTML. The list would then look like this:
|
||||
|
||||
```html
|
||||
{% raw %}<dl class="dl-horizontal">
|
||||
|
||||
<dt id="fractious">fractious</dt>
|
||||
<dd>{{site.data.glossary.fractious}}</dd>
|
||||
|
||||
<dt id="gratuitous">gratuitous</dt>
|
||||
<dd>{{site.data.glossary.gratuitous}}</dd>
|
||||
|
||||
<dt id="haughty">haughty</dt>
|
||||
<dd>{{site.data.glossary.haughty}}</dd>
|
||||
|
||||
<dt id="benchmark_id">gratuitous</dt>
|
||||
<dd>{{site.data.glossary.gratuitous}}</dd>
|
||||
|
||||
<dt id="impertinent">impertinent</dt>
|
||||
<dd>{{site.data.glossary.impertinent}}</dd>
|
||||
|
||||
<dt id="intrepid">intrepid</dt>
|
||||
<dd>{{site.data.glossary.intrepid}}</dd>
|
||||
|
||||
</dl>{% endraw %}
|
||||
```
|
||||
|
||||
If you squish your screen small enough, at a certain breakpoint this style reverts to the regular `dl` class.
|
||||
|
||||
Although I like the side-by-side view for shorter definitions, I found it problematic with longer definitions.
|
||||
|
||||
|
||||
{% include links.html %}
|
Reference in New Issue
Block a user