A very simple and scalable blog platform
Blog Wiki
Table of contents
Howto publish content
Content are located in the content folder.
Articles are located in the article folder and sub folders.
Images are located in the images folder and sub folders.
Simply save your article in the correct folder and voila, it’s published.
Blog posts are separated into sections.
Possible sections are:
| Section | Tag | Example of usage | Description |
|---|---|---|---|
| author | :author | :author | The blog author. |
| title | :title | :title My title | Title of the blog post. |
| published | :published | :published 2014-10-05 | Publish date of the blog post. |
| teaser | :teaser | Teaser text used on the frontpage and on the very top. | |
| ingress | :ingress | Blog intro. The start of the blog post. Keep it relatively short. | |
| body | :body | The blog post. | |
| img | :img | :img photo1.jpg | Standard images used in the blog. It depends on the template where they are placed. You may use |
| aside | :aside | Boxes with content to go on the right side of the blog post. | |
| images | :images | :images /path/ | Load all images from one of the content categories. |
| col | :col | Same as body but separated into 3 different columns. | |
| footnote | :footnote | Comments that goes into the bottom of the blog post. |
If you want more chapters in one blog post you can postfix img with 2-10. Ie. : img2 starts a new chapter. Then you have to use title2, ingress2, body2, col2, etc.
Special tags
| Tag name | Tag | Example of usage | Description |
|---|---|---|---|
| toc | [:toc] | [:toc] | Automatic generated table of contents. |
| fact | [:fact file] | [:fact about-md] | A general fact box. This is usually shared between several blog posts. |
| menu | [:menu] | [:menu] | List all categories inside the content dir. |
| artlist | [:artlist] | [:artlist [category]] | List all articles inside the content dir in a plain list format. |
| artlist_block | [:artlist_block ] | [:artlist_block [category]] | List all articles inside the content dir in a plain list format. |
| fa-* | [:fa-star] | [:fa-star] | Inserts an icon from font-awesome |
| [:fa-star 5] | Insert 5 stars. |
Example blog post
:title My blog post title
:teaser Read all about it!
:body
## Hello world!
This is my first blog post.
That’s all there is to it.
Content
Columns
If you want to write your content in columns instead of a big body chunk. You can do it like this.
:col
Content of your first column.
:col
Content of your second column.
:col
Content of your third column.
Plugins
flot
Flot graphs are automatically picked up if you write the graph data wrapped in a code slot like this:
[3 x backticks]flot
{
"usa": {
label: "USA",
lines: { show: true },
data: [[1988, 483994], [1989, 479060], [1990, 457648], [1991, 401949], [1992, 424705], [1993, 402375], [1994, 377867], [1995, 357382], [1996, 337946], [1997, 336185], [1998, 328611], [1999, 329421], [2000, 342172], [2001, 344932], [2002, 387303], [2003, 440813], [2004, 480451], [2005, 504638], [2006, 528692]]
},
"russia": {
label: "Russia",
lines: { show: true },
data: [[1988, 218000], [1989, 203000], [1990, 171000], [1992, 42500], [1993, 37600], [1994, 36600], [1995, 21700], [1996, 19200], [1997, 21300], [1998, 13600], [1999, 14000], [2000, 19100], [2001, 21300], [2002, 23600], [2003, 25100], [2004, 26100], [2005, 31100], [2006, 34700]]
}
}
[3 x backticks]
github-gist
Links to a Github-gists are automatically expanded into a javascript with the gist content.https://gist.github.com/5orenso/f54f402b5e3414ea2f45
googleMaps
Google maps can be implemented with a simple @ followed by coordinates or a text search for the desired place.
A plain map of Halddetoppen in Alta, Norway:@halddetoppen,alta,norway
A map based on coordinates:@69.9396,22.9232
A satellite map of Halddetoppen:@69.9396,22.9232;maptype=satellite&mode=view
A place map of Alta:@alta,norway;mode=place
A streetview map of Halddetoppen:@69.9396,22.9232;mode=streetview&heading=90&pitch=-15&fov=100
A map with directions from Oslo to Alta in Norway:@oslo,norway;mode=directions&destination=Alta,Norway
spotify
Links to a Spotify tracks are automatically expanded into an iframe with the content.https://open.spotify.com/track/1lCRw5FEZ1gPDNPzy1K4zW
spotify-uri
Spotify URIs are also automatically expanded into an iframe with the content.spotify:track:1lCRw5FEZ1gPDNPzy1K4zW
strava
Links to a Strava segments are automatically expanded into an iframe with the content.https://www.strava.com/segments/1942901
vimeo
Links to a Vimeo videos are automatically expanded into an iframe with the content.https://vimeo.com/132027577
wsd
Web Sequence texts are automatically expanded into a Web Sequence Diagram.
[3 x backtick]wsd
title Central Identification Service
Browser->VG.no: GET /
[3 x backtick]
youtube
Links to a Youtube videos are automatically expanded into an iframe with the content.https://www.youtube.com/watch?v=itwQKMGl22Y
Markdown is used for writing.
Markdown is intended to be as easy-to-read and easy-to-write as is feasible.
Readability, however, is emphasized above all else. A Markdown-formatted document should be publishable as-is, as plain text, without looking like it’s been marked up with tags or formatting instructions.
- Read more in Markdown official syntax guide.
- Github markdown page
- [Markdown cheatsheet](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet#links)
| Tag | Example | Result |
|---|---|---|
| Headlines | # This is H1 | [See below](#headlines-and-subheadlines) |
| ## This is H2 | ||
| Emphasis |
_italic_
| italic |
| Bold |
__bold__
| bold |
| Link |
[Link to an example](http://example.com/)
| Link to an example |
| Images |

|
Image alt text
|
| Quotes |
> This is the quoted text
| [See below](#text-quotes) |
| Unordered lists | - First element | [See below](#ordered-and-unordered-lists) |
| - Second element | ||
| Ordered lists | 1. First element | [See below](#ordered-and-unordered-lists) |
| 2. Second element | ||
| Strike through |
~~Mistaken text~~
|
|
| Horizontal line |
----- or *****
| [See below](#horizontal-line) |
| Table | [See below](#tables) |
Headlines and subheadlines
# This is an H1
## This is an H2
### This is an H3
#### This is an H4
Turns into this:
<h1>This is an H1</h1>
<h2>This is an H2</h2>
<h3>This is an H3</h3>
<h4>This is an H4</h4>
Text formatting
_This is emphasis_
__This is bold emphasis__
Looks like this:
This is emphasis
This is bold emphasis
Links
[Link to an example](http://example.com/ "Title")
Looks like this:
Link to an example
Images
Inline-style:

Text quotes
> Quotes are
> written this way
Turns into this:
Quotes are
written this way
Quotes can also contain Markdown elements.
> ### The Fox
>
> Ching ching ching.
> Pow, pow, pow.
Looks like this:
The Fox
Ching ching ching.
Pow, pow, pow.
Ordered and unordered lists
- Cat
- Dog
- Horse
1. Donkey
2. Squirrel
3. Rat
Turns into this:
- Cat
- Dog
- Horse
And ordered list:
- Donkey
- Squirrel
- Rat
Tables
Draw a text table and it becomes a html table.
| First Header | Second Header |
| ------------- | ------------- |
| Content Cell | Content Cell |
| Content Cell | Content Cell |
Looks like this:
| First Header | Second Header |
|---|---|
| Content Cell | Content Cell |
| Content Cell | Content Cell |
If you want spesific alignment use colons within the header row on the side you want to align to.
| Left-Aligned | Center Aligned | Right Aligned |
| :------------ |:---------------:| -------------:|
| col 3 is | some wordy text | $1600 |
Looks like this:
| Left-Aligned | Center Aligned | Right Aligned |
|---|---|---|
| col 3 is | some wordy text | $1600 |
Horizontal line
-----
*****
Turns into the same line like this: