Tool sharing -- annotate C # documentation to generate. chm help documentation

Source: Internet
Author: User

Recently, I need to write a document for a previous project, but I don't know what to write at the moment. I just found a tool that can generate chm. So I just studied it and I feel pretty good, so I would like to share it with you. Well, there is not much nonsense. Let's implement it below.

Before proceeding, we should add one note: we generate help documents through the XML file generated by C # document annotations. Therefore, the first step is to generate an XML document:

Procedure: Open VS and create a project at Will (the console project is used here). Then, add the following content:

                              Name { ;                     Age { ;                                                Say( name,  + name +  +

Sandcastle is an official Microsoft document generation tool. After NDoc development is stopped, it seems to be the only tool in this regard. It can generate a complete help document from the dll file and Its xml annotation file, and supports multiple generation formats (Helpe1x: chm, Helper2x: Hxs, Website, HelperView ), combined with the newly released Sandcastle Help File Builder visual tool, the entire generation process is very simple, and the SHFB tool looks very powerful, not only can you directly configure the attributes of the generated document, it also supports flexible extension settings to provide us with perfect. NET class library documentation becomes a possibility.

Download the tool from here:

Sandcastle: http://sandcastle.codeplex.com/. click downloadon the right.

Sandcastle Help File Builder: http://shfb.codeplex.com/

I found a VS plug-in the SHFB compressed package, so I plan to use VS for demonstration next. If you do not want to install this plug-in, you can run C: \ Program Files (x86) \ EWSoftware \ Sandcastle Help File Builder \ SandcastleBuilderGUI.exe, the results are the same

The most important thing is opening VS and creating a project:

It seems that there is nothing to summarize ....

References: http://www.cnblogs.com/lonely7345/archive/2010/01/13/1647245.html

Related Article

Contact Us

The content source of this page is from Internet, which doesn't represent Alibaba Cloud's opinion; products and services mentioned on that page don't have any relationship with Alibaba Cloud. If the content of the page makes you feel confusing, please write us an email, we will handle the problem within 5 days after receiving your email.

If you find any instances of plagiarism from the community, please send an email to: info-contact@alibabacloud.com and provide relevant evidence. A staff member will contact you within 5 working days.

A Free Trial That Lets You Build Big!

Start building with 50+ products and up to 12 months usage for Elastic Compute Service

  • Sales Support

    1 on 1 presale consultation

  • After-Sales Support

    24/7 Technical Support 6 Free Tickets per Quarter Faster Response

  • Alibaba Cloud offers highly flexible support services tailored to meet your exact needs.