2008-08-03 29 views
14

Có cách nào dễ dàng để tạo tài liệu kiểu MSDN từ đầu ra XML của Visual Studio không?
Tôi không đủ kiên nhẫn để thiết lập một xslt tốt cho nó vì tôi biết tôi không phải là người đầu tiên vượt qua cây cầu này..Net XML bình luận vào tài liệu API

Ngoài ra, tôi đã thử thiết lập lâu đài cát gần đây, nhưng nó thực sự làm cho đôi mắt của tôi vượt qua. Hoặc là tôi đã thiếu một cái gì đó quan trọng trong quá trình này hoặc nó chỉ là cách quá tham gia.

Tôi biết ai đó ngoài kia có giải pháp chết đơn giản thực sự tốt đẹp.

Tôi nhắc lại ở đây vì tôi nghĩ rằng định dạng của tôi đưa ra là đoạn phi mời đọc:

Tôi đưa lâu đài cát thử nhưng đã có một thời gian thực sự khó khăn nhận được nó thiết lập. Những gì tôi thực sự có trong tâm trí là một cái gì đó đơn giản hơn nhiều.

Tức là, trừ khi tôi không hiểu quy trình lâu đài cát. Nó có vẻ như là một hành lý quá lớn đối với tôi chỉ để tạo ra thứ gì đó tốt đẹp cho những người thử nghiệm làm việc cùng.

Trả lời

5

Hãy xem Sandcastle, thực hiện chính xác điều đó. Nó cũng là một trong những giải pháp đơn giản hơn trên mạng, và nó ít nhiều là công cụ lựa chọn, do đó, về lâu dài, có lẽ chúng tôi có thể giúp bạn thiết lập Sandcastle nếu bạn chỉ định những vấn đề bạn gặp phải trong khi thiết lập?

3

Tôi vừa thiết lập lại Sandcastle. Hãy thử cài đặt nó (bản phát hành tháng 5 năm 2008) và tìm kiếm SandcastleGui.exe hoặc một cái gì đó tương tự (trong thư mục ví dụ hoặc như vậy).

Nhấp vào Thêm hội và thêm hội hoặc hội đồng của bạn, thêm bất kỳ tệp tài liệu .xml nào (tệp được tạo bởi trình biên dịch nếu bạn bật tùy chọn đó) và sau đó xây dựng.

Sẽ mất một khoảng thời gian, nhưng kết quả sẽ là đáng để thử. Nó sẽ thực sự tìm kiếm công cụ từ MSDN, vì vậy tài liệu kết quả của bạn cũng sẽ có Class Inheritance tất cả các con đường xuống System.Object với các liên kết đến MSDN và các công cụ.

Sandcastle có vẻ hơi phức tạp lúc đầu, đặc biệt là khi bạn muốn sử dụng nó trong một bản dựng tự động, nhưng tôi hoàn toàn chắc chắn rằng nó sẽ có giá trị nỗ lực.

Ngoài ra, hãy xem Sandcastle Help File Builder, đây là giao diện nâng cao hơn một chút cho nó.

5

Bạn cũng nên sử dụng Trình tạo tệp trợ giúp Sandcastle. Nó cung cấp cho bạn một GUI giống như ndoc để tạo các tệp trợ giúp, do đó bạn không phải làm bất cứ điều gì từ một dấu nhắc lệnh.

Welcome to the Sandcastle Help File Builder Project

Các vấn đề liên quan