Merge pull request #252 from mrueg/add-blog-posts-macro

Add blog-posts macro

README.md

@@ -334,8 +334,8 @@ By default, mark provides several built-in templates and macros:
   - Frameborder: Choose whether to draw a border around content in the iframe.
       - `show` (Default)
       - `hide`
-  - Width: Width in px. Defualts to "640px"
+  - Width: Width in px. Defaults to "640px"
-  - Height: Height in px. Defualts to "360px"
+  - Height: Height in px. Defaults to "360px"
   - Scrolling: Allow or prevent scrolling in the iframe to see additional content.
       - `yes`
       - `no`
@@ -346,6 +346,24 @@ By default, mark provides several built-in templates and macros:
 
   See: https://support.atlassian.com/confluence-cloud/docs/insert-the-iframe-macro
 
+* template: `ac:blog-posts`to include blog-posts
+  - Content: How much content will be shown
+      - titles (default)
+      - excerpts
+      - entire
+  - Time: Specify how much back in time Confluence should look for blog posts (default: unlimited)
+  - Label: Restrict to blog posts with specific labels
+  - Author: Restrict to blog posts by specific authors
+  - Spaces: Restrict to blog posts in specific spaces
+  - Max: Maximum number of blog posts shown (default: 15)
+  - Sort: Sorting posts by
+      - title
+      - creation (default)
+      - modified
+  - Reverse: Reverses the Sort parameter from oldest to newest (default: false)
+
+  See: https://confluence.atlassian.com/doc/blog-posts-macro-139470.html
+
 * macro `@{...}` to mention user by name specified in the braces.
 
 ## Template & Macros Usecases

pkg/mark/stdlib/stdlib.go

@@ -236,6 +236,21 @@ func templates(api *confluence.API) (*template.Template, error) {
 			`</ac:structured-macro>{{printf "\n"}}`,
 		),
 
+		/* https://confluence.atlassian.com/doc/blog-posts-macro-139470.html */
+
+		`ac:blog-posts`: text(
+			`<ac:structured-macro ac:name="blog-posts">{{printf "\n"}}`,
+			`{{ if .Content }}<ac:parameter ac:name="content">{{ .Content }}</ac:parameter>{{printf "\n"}}{{end}}`,
+			`{{ if .Spaces }}<ac:parameter ac:name="spaces">{{ .Spaces }}</ac:parameter>{{printf "\n"}}{{end}}`,
+			`{{ if .Author }}<ac:parameter ac:name="author">{{ .Author }}</ac:parameter>{{printf "\n"}}{{end}}`,
+			`{{ if .Time }}<ac:parameter ac:name="time">{{ .Time }}</ac:parameter>{{printf "\n"}}{{end}}`,
+			`{{ if .Reverse }}<ac:parameter ac:name="reverse">{{ .Reverse }}</ac:parameter>{{printf "\n"}}{{end}}`,
+			`{{ if .Sort }}<ac:parameter ac:name="sort">{{ .Sort }}</ac:parameter>{{printf "\n"}}{{end}}`,
+			`{{ if .Max }}<ac:parameter ac:name="max">{{ .Max }}</ac:parameter>{{printf "\n"}}{{end}}`,
+			`{{ if .Label }}<ac:parameter ac:name="label">{{ .Label }}</ac:parameter>{{printf "\n"}}{{end}}`,
+			`</ac:structured-macro>{{printf "\n"}}`,
+		),
+
 		// TODO(seletskiy): more templates here
 	} {
 		templates, err = templates.New(name).Parse(body)