2009-03-03 36 views
17

Chúng tôi sử dụng sandcastle (và SHFB) để tạo tài liệu thư viện lớp học từ các nhận xét XML nội tuyến. Đó là một công cụ tuyệt vời để duy trì tài liệu tham khảo + tổng quan về tìm kiếm hoàn chỉnh và chuyên nghiệp, bao gồm correct code samples.Chúng ta có thể tăng tốc độ lâu đài cát không?

Thật không may, nó cũng là con chó chậm. Đó là bước tốn nhiều thời gian nhất trong quá trình xây dựng tự động của chúng tôi và nó bắt đầu bị tổn thương. Có cách nào để tăng tốc nó không?

+0

Tôi khuyên bạn nên sử dụng [Live Documenter] (http://theboxsoftware.com/products/live-documenter/ "Live Documenter") để xem tài liệu của bạn nhanh chóng. Chương trình chỉ xem tài liệu của bạn từ tệp XML được tạo trên mỗi bản dựng. Khi bạn hài lòng với tài liệu của mình, hãy sử dụng lâu đài cát để thực sự xây dựng nó. –

+0

@JaredBeach: Vấn đề là khi Sandcastle là một trong nhiều bước thực hiện khi chuẩn bị một bản dựng (tự động bởi một kịch bản, tất nhiên). Xem trước tài liệu có thể thậm chí không là mục tiêu ở đó; Sandcastle chỉ đơn giản là chạy như một trong nhiều công cụ khi lắp ráp các tập tin phát hành vì lý do nào. –

Trả lời

12

Nếu bạn có lâu đài cát SdkLinkType = Msdn (xem thuộc tính của dự án SHFB) của bạn kết nối với tài liệu MSDN bằng dịch vụ web. Điều đó có thể slooowww xây dựng xuống trong trường hợp khó khăn kết nối. Bạn có thể thử đặt SdkLinkType = None để tắt liên kết xây dựng MSDN (trong trường hợp đó bạn sẽ không có liên kết đến MSDN trong trợ giúp của bạn). Trong trường hợp của tôi đã cải thiện thời gian xây dựng của tôi 5 lần (2 phút thay vì 10 phút).

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