Blog Support Library

this is a library of WikiTalk functions to support blogging with FlexWiki

How To Blog

An author creates blog entries by creating a wiki topic, as a separate page. That topic must include the the property 'Keywords:', with a value of 'Blog' and the name used to identify the author. For example, this page has the 'Keyword:' entry

 :KeywordsX: JohnDavidson, Blog

There must also be a main Blog topic for each author. The topic JohnDavidsonBlog is constructed as:

:Summary: a sample blog for JohnDavidson
:KeywordsX: JohnDavidson

@@SelectBlogBody("JohnDavidson", 1)@@
@@SelectAuthorBlogLinks("JohnDavidson", 15)@@ 

:With: BlogSupportLibrary

The function SelectBlogBody(author, displayEntries) is used to select the blog author and the number of blog topics for that author to be displayed on the blog page. Reasonable values for displayEntries would range from 1 to 5, depending upon the length of the topics referenced. The ':KeywordsX:' entry above should really be ':Keywords:', but if that is entered then the WikiTalk fails to process correctly.

SelectBlogBody

{author, entries | namespace.Topics.Select{ each | each.Keywords.Contains("Blog")}

.Select{each | each.Keywords.Contains(author)}.SortBy{each |

DateTime.Now.SpanBetween(each.LastModified)}.Snip(entries).Collect{ each |

[

"!!!", each.Name, Newline,

each.LastModified.ToLongDateString(), " - ", each.LastModified.ToShortTimeString(), Newline,

each.GetProperty("_Body"),

Newline,

]}

}

The function SelectAuthorBlogLinks(author, displayLinks) is used to display the links to previous blog topics for that author. The links will be to the most recent showing the number of links specified.

SelectAuthorBlogLinks

{linkAuthor, linkEntries |

[

"!!!!Archived Blog Entry Links", Newline,

namespace.Topics.Select{ each | each.Keywords.Contains("Blog")}

.Select{each | each.Keywords.Contains(linkAuthor)}.SortBy{each |

DateTime.Now.SpanBetween(each.LastModified)}.Snip(linkEntries).Collect{ each |

[

" 1. ", each.Name, " :", each.LastModified.ToLongDateString(), " - ", each.LastModified.ToShortTimeString(), Newline,

]}

]

}

The function SelectAllBlogLinks(displayLinks) is used when there is a blog farm and the individual author wants to display links to the most recent blog entries, whether by that author, or any other author in the blog farm.

SelectAllBlogLinks

{allEntries |

[

"!!!!Archived Blog Entry Links for All Authors", Newline,

namespace.Topics.Select{ each | each.Keywords.Contains("Blog")}

.SortBy{each |

DateTime.Now.SpanBetween(each.LastModified)}.Snip(allEntries).Collect{ each |

[

" 1. ", each.Name, " :", each.LastModified.ToLongDateString(), " - ", each.LastModified.ToShortTimeString(), Newline,

]}

]

}

The function ShowBlogLinks() puts a permalink on the topic and allows for talkback support if it is in use on the local wiki. ShwoBlogLinks() also calls ShowtalkBack, which causes a talkback link to be displayed, or created if necessary. Talkback is only possible in version 2.0.0.158 or greater. The call to ShowBlogLinks() should be placed on the actual topic content page that will be displayed on the blog page. It should be placed at the bottom of the content for usability.

 @@ShowBlogLinks()@@

ShowBlogLinks

{[ ["\"Permalink\":", topic.Name].ToOneString, ",", Space, ShowTalkBack,Newline,]}

ShowTalkBack

{ProductVersion.Substring(0,1).AsInteger.GreaterThanOrEqualTo(2).

IfTrueIfFalse({namespace.GetTopicInfo([topic.Name,"Tback"].ToOneString).Exists.

IfTrueIfFalse({["\"Talkback\":",topic.Name,"Tback"].ToOneString}, {Presentations.Link(federation.LinkMaker

.SimpleLinkTo(["MessagePost.aspx?topic=",namespace.Name,".",topic.Name,"&blog=true","\""].ToOneString),

"Create Talkback Topic")})},{ ""})

}

Inspiration for this solution for implementing a blog in FlexWiki came from reading ZDNet Blogs on my smartphone, which gave a layout almost identical to the one created here.

	Show Changes
	Print
	Recent Changes
	Subscriptions
	Lost and Found
	Find References
	Rename
	Administration Page