views:

622

answers:

2

I need to

  1. convert my Sandcastle Help File Builder (SHFB) output that is a Web site (HTML) to Media wiki format
  2. Find a way to transfer/include the converted pages directly into the MediaWiki we have set up.

Any ideas? we have over 1000 pages of HTML files inthe Website (output of SHFB). I thought of using a html2wiki converter ..I could think of looking around for a a script to convert those 1000 pages into wiki format...that could take care of (1)... but then i would still be left with the block in the last bit of the pipeline..how to feed converted pages directly into the wiki?

A: 

i did some work with ingesting existing material from several sites into a comprehensive wiki. it did not involve Sandcastle, but if you're dealing with HTML it shouldn't matter much. html2wiki extensions are out there, and from what i have read they can solve a lot of problems. i needed a little more control over each node in the DOM, so i used Simple HTML DOM Parser. it's in php and was easily dropped into mediawiki's includes.

for creating the new pages, i ended up writing a small script that uses mediawiki's Article class, specifically the doEdit function. this allows you to create new articles programatically, without user interaction. of course, you'd want to be careful with this... the last thing you need is to create 1000 pages that are no good and have to be deleted. but perhaps this will help get you going.

+2  A: 

Take a look at Help Server. It allows to publish .CHM / .HxS produced by any tool (including Sandcastle) on the web and provides URL-based integration API.

We use MediaWiki as well. A set of templates for it allows us to create links to class reference shared by Help Server. Some examples of such links can be found right on that page.

Note that DataObjects.Net Help web site is running on Help Server 2.X, but the newest one is 3.X (example web site is here).

Alex Yakunin