Project Description
MAML Generator / Converter utilizes Microsoft Workflow to generate MAML files from HTML

2008.12.01 UPDATE

Dave Sexton, author of DocProject, is actively involved in MAML related work to include a WYSIWYG Editor and MAML Converter (making this project obsolete).

http://davesexton.com/blog/blogs/blog/archive/tags/MAML/default.aspx has his applicable blog links.

Eric Woodruff released a Html to Maml converter on the following link. http://www.codeplex.com/SandcastleStyles/Release/ProjectReleases.aspx?ReleaseId=18782


I'm currently evaluating DocProject for a client and may be switching to it (versus Sandcastle Help File Builder); it is highly probable this project will be shutdown.

------------

NOTE: using TDD so only the unit test work; command line usage not available yet. You can view debug output for workflow results.

Sandcastle's Help File Builder is deprecating the ContentSiteMap and moving forward with ConceptualContent which utilizes the MAML file format. My MEFContrib, SDMS and later CASKDotNet open source documentation requirements promise to have me spending more time documenting than coding if I don't have a tool that will permit me to produce MAML files. The ROI (return on investment) is there for me to stop and create a tool that will simplify my documention requirements.

Vision Statement: Create an HTML to MAML conversion utility that will permit me to easily generate documentation using my favorite HTML Editor (Expression Web and/or Visual Studio 2008 Designer).


  • Core requirements: Meet minimal requires to generate output that supports MAML syntax required to generate the first 5 links presented in the SandCastle MAML Guide documentation.
    • Configuration file to identify files HTML files to convert (preference towards pointing to VS Solution and SHFB 1.8.0.0 project)
    • Command line utility to process configuration file
    • Unit test

  • Development Environment
    • Visual Studio 2008 SP1 / .NET 3.5 SP1
    • Workflow
    • LINQ
    • Unity

Last edited Tue at 3:08 AM by BillKrat, version 33
Comments
No comments yet.

Updating...