gitea-pages/doc_kb_layout.md

title, tags, keywords, audience, last_updated, summary, metadata

title	tags	keywords	audience	last_updated	summary	metadata
Knowledge-base layout	special-layouts					false

{% include linkrefs.html %}

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 enlarged to a large size. You could also add captions below each icon, and so forth. In a real implementation, you would probably make your own square graphics that included the text inside them.

Getting Started

Navigation

Single-sourcing

 

Publishing

Special layouts

Formatting

Linking to non-tag archive pages

If you don't want to link to a tag archive index, you could link to a page with code like this: {% raw %}

Getting started pages:
<ul>
{% for page in site.pages %}
{% for tag in page.tags %}
{% if tag == "getting-started" %}
<li><a href="{{page.url}}">{{page.title}}</a></li>
{% endif %}
{% endfor %}
{% endfor %} 
</ul>

{% endraw %}

Getting started pages:

Here are all pages tagged with getting_started:

{% for page in site.pages %} {% for tag in page.tags %} {% if tag == "getting-started" %}
• {{page.title}}
{% endif %} {% endfor %} {% endfor %}