added new shortcodes and respective docs

exampleSite/content/docs/shortcodes/index.md

@@ -37,6 +37,25 @@ Don't forget to [follow me](https://twitter.com/nunocoracao) on Twitter.
 Don't forget to [follow me](https://twitter.com/nunocoracao) on Twitter.
 {{< /alert >}}
 
+## Article
+`Article` will embed a single article into a markdown file. The `link` to the file should be the `.RelPermalink` of the file to be embedded. Note that the shortcode will not display anything if it's referencing it's parent.
+
+<!-- prettier-ignore-start -->
+|Parameter|Description|
+|---|---|
+|`link`| **Required.** the `.RelPermalink` to the target article.|
+<!-- prettier-ignore-end -->
+
+**Example:**
+
+```md
+{{</* article link="/docs/welcome/" */>}}
+```
+
+{{< article link="/docs/welcome/" >}}
+
+
+
 ## Badge
 
 `badge` outputs a styled badge component which is useful for displaying metadata.
@@ -164,6 +183,33 @@ Custom icons can be added by providing your own icon assets in the `assets/icons
 
 Icons can also be used in partials by calling the [icon partial]({{< ref "partials#icon" >}}).
 
+## List
+`List` will display a list of recent articles. This shortcode requires a limit value to constraint the list. Additionally, it supports a `where` and a `value` in order to filter articles by their parameters. Note that this shortcode will not display its parent page but it will count for the limit value.
+
+<!-- prettier-ignore-start -->
+|Parameter|Description|
+|---|---|
+|`limit`| **Required.** the number of recent articles to display.|
+|`where`| the number of recent articles to display.|
+|`value`| the number of recent articles to display.|
+
+<!-- prettier-ignore-end -->
+
+**Example #1:**
+```md
+{{</* list limit=2 */>}}
+```
+
+{{< list limit=2 >}}
+
+**Example #2:**
+```md
+{{</* list limit=2 where="Type" value="sample" */>}}
+```
+
+{{< list limit=2 where="Type" value="sample">}}
+
+
 ## Swatches
 `swatches` outputs a set of up to three different colors to showcase color elements like a color palette. This shortcode takes the `HEX` codes of each color and creates the visual elements for each.
 

exampleSite/content/samples/emoji.md

@@ -4,6 +4,7 @@ date: 2019-03-05
 description: "Guide to Emoji usage in Blowfish"
 summary: "📖🏞️🧗🏽🐉🧙🏽‍♂️🧚🏽👸"
 tags: ["emoji", "sample"]
+type: 'sample'
 ---
 
 Emoji is supported throughout Blowfish by default. Emoji can be used in titles, menu items and article content.