2012-02-03 14 views
5

tôi đã được sử dụng Sandcastle Sandcastle cùng với tập tin trợ giúp Builder và theo mặc định nó cung cấp ba phong cách trình bày: hana, nguyên mẫuvs2005.Sandcastle có thể tạo tài liệu HTML theo kiểu MSDN mới nhất không?

Mặc dù phong cách vs2005 có vẻ ổn, nhưng tôi đặc biệt thích kiểu kiểu MSDN nhẹ mới nhất. Có cách nào để cấu hình Sandcastle để tạo ra tài liệu với phong cách này?

Trả lời

5

Các chính sách sản phẩm của Microsoft/chiến lược tương ứng thực sự là một chút kỳ lạ và một số mở rộng mâu thuẫn với việc chuyển sang một quá trình phát triển cởi mở hơn trong những năm gần đây - Documentation comments, SandCastle and new documentation transforms là một rant tốt tóm tắt tình trạng chính thức của vấn đề.

Điều đó nói rằng, dường như là một giải pháp không chính thức (và do đó một cách hợp pháp ngờ thách thức, xem dưới đây) có sẵn: Dự án sandcastle-presentationnhằm tạo mẫu trình bày mới cho Sandcastle mà sẽ tạo ra tài liệu hướng dẫn trong phong cách của MSDN Thương hiệu nhẹ.

Đặc biệt, nó nhằm mục đích tích hợp với rất khuyến khích Sandcastle Help File Builder (SHFB), mà giải quyết thâm hụt ngân sách khác được đề cập trong rant nói trên, cụ thể là nó được tạo ra để lấp đầy khoảng trống, cung cấp thiếu tính năng NDoc giống như được sử dụng thường xuyên nhất và cung cấp các công cụ dựa trên dòng lệnh và đồ họa để xây dựng tệp trợ giúp theo cách tự động.

Vui lòng xem lại các chủ đề thảo luận SHFB MSDN presentation style available on google code! cho quan điểm khác nhau về tính hợp pháp của lâu đài cát-trình bày sử dụng và thực hiện phán quyết của riêng bạn cho phù hợp.