mydoc_kb_layout.md 4.3 KB


title: Knowledge-base layout tags: [special_layouts] keywords: knowledge base, support portal, grid, doc portal last_updated: July 3, 2016 summary: "This shows a sample layout for a knowledge base. Each square could link to a tag archive page. In this example, font icons from Font Awesome are used for the graphics, and the layout is pulled from the Modern Business theme. ." sidebar: mydoc_sidebar permalink: mydoc_kb_layout.html toc: false

folder: mydoc

Here's the sample knowledge-base style layout:

Knowledge Base Categories

Getting started

Lorem ipsum dolor sit amet, consectetur adipisicing elit.

Learn More

Navigation

Lorem ipsum dolor sit amet, consectetur adipisicing elit.

Learn More

Single sourcing

Lorem ipsum dolor sit amet, consectetur adipisicing elit.

Learn More

Formatting

Lorem ipsum dolor sit amet, consectetur adipisicing elit.

Learn More

Generating a list of all pages with a certain tag

If you don't want to link to a tag archive index, but instead want to list all pages that have a certain tag, you could use this code:

{% raw %}Getting started pages:
<ul>
{% assign sorted_pages = site.pages | sort: 'title' %}
{% for page in sorted_pages %}
{% for tag in page.tags %}
{% if tag == "getting_started" %}
<li><a href="{{ page.url | remove: "/" }}">{{page.title}}</a></li>
{% endif %}
{% endfor %}
{% endfor %}
</ul>{% endraw %}

Here's the result:

Getting started pages:

    {% assign sorted_pages = site.pages | sort: 'title' %} {% for page in sorted_pages %} {% for tag in page.tags %} {% if tag == "getting_started" %}
  • {{page.title}}
  • {% endif %} {% endfor %} {% endfor %}

{% include links.html %}