Wiki topics are written in WikiText, which FlexWiki converts into HTML and serves up in a dynamic, server-side ASP.NET Web page (*.aspx) when an end user requests the page. WikiText is a simple markup language that does not descend from the SGML family as do HTML and XML. For an example of WikiText, click the Edit control in the righthand pane.
Publishing existing content to a Wiki from any format, be it SGML, HTML, XML, WordML, plain text, rich text, or any other format is fairly straightforward. Converting a binary file might be a bit more challenging.
Manual Conversion
To manually convert your source docs into WikiText, create a new WikiTopic (by typing a CamelCased word in an existing WikiTopic and then cliking on the link) and overwrite the template text in the new topic with your source content. You can then approximate the formatting of the source content by applying wiki formatting markup (see Formatting Tips in the righthand pane for tips).
Programatic Conversion
To programatically publish multiple source files/topics to a wiki, you must transform it (for example, if the source is xml, use XSLT), copy the transformed content to memory (eg, write to a FileStream Object), create a new WikiTopicName.wiki topic in the WikiBase (requires Admin access to the Wiki virtual server) and then write the content from memory to and save the new file. Alternatively, perform the translation to a local disk and use FwSync to get it to the server.
Conversion Tips and Tools
Use the following tools, utilities, code snippets, and humble words of advice to devise your own strategy for publishing existing documentation to a Wiki.
Korby Parnell is a program manager on the Microsoft MSDN & TechNet Community team who formerly worked on Microsoft VisualStudioTeamSystem and before that, VisualStudio.
9/18/2007 2:21:16 PM - -74.15.253.150
Korby Parnell is a program manager on the Microsoft MSDN & TechNet Community team who formerly worked on Microsoft VisualStudioTeamSystem and before that, VisualStudio.
9/18/2007 2:21:16 PM - -74.15.253.150
background information about FlexWiki
8/19/2007 10:36:06 AM - -66.78.124.101
background information about FlexWiki
8/19/2007 10:36:06 AM - -66.78.124.101
background information about FlexWiki
8/19/2007 10:36:06 AM - -66.78.124.101
background information about FlexWiki
8/19/2007 10:36:06 AM - -66.78.124.101
defines and describes what a topic is.
9/12/2007 2:58:29 PM - -10.10.192.22
defines and describes what a topic is.
9/12/2007 2:58:29 PM - -10.10.192.22
a collection of wiki topics in a single TopicNamespace
9/13/2007 2:22:08 PM - -74.15.247.173
FwSync is a command-line tool for editing the wiki.
9/12/2007 5:43:19 PM - -10.10.192.22
a command-line tool for generating FlexWiki pages from C# compiler-generated XML documentation files.
