Files
gitea-pages/pages/special-layouts/kb_layout.md

49 lines
2.0 KiB
Markdown

---
title: Knowledge-base homepage
permalink: /kb_layout/
tags: special-layouts
keywords:
audience:
last_updated:
summary:
metadata: 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.
<div class="row">
<div class="col-md-4"><a href="{{ "/tag-getting-started" | prepend: site.baseurl }}"><i class="fa fa-server fa-7x border"></i></a></div>
<div class="col-md-4"><a href="{{ "/tag-overview" | prepend: site.baseurl }}"><i class="fa fa-bar-chart-o fa-7x border"></i></a></div>
<div class="col-md-4"><a href="{{ "/tag-single-sourcing" | prepend: site.baseurl }}"><i class="fa fa-code fa-7x border"></i></a></div>
</div>
<p>&nbsp;</p>
<div class="row">
<div class="col-md-4"><a href="{{ "/tag-publishing" | prepend: site.baseurl }}"><i class="fa fa-dashboard fa-7x border"></i></a></div>
<div class="col-md-4"><a href="{{ "/tag-special-layouts" | prepend: site.baseurl }}"><i class="fa fa-desktop fa-7x border"></i></a></div>
<div class="col-md-4"><a href="{{ "/tag-formtting" | prepend: site.baseurl }}"><i class="fa fa-cloud fa-7x border"></i></a></div>
</div>
## 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 %}
```html
Here are all pages tagged with getting_started:
<ul>
{% assign counter = '0' %}
{% for page in site.pages %}
{% for tag in page.tags %}
{% if tag == "getting-started" and counter < '25' %}
{% capture counter %}{{ counter | plus:'1' }}{% endcapture %}
<li><a href="{{ page.permalink | prepend: site.baseurl }}">{{page.title}}</a></li>
{% endif %}
{% endfor %}
{% endfor %}
</ul>
```
{% endraw %}