Làm thế nào để tạo MSDN như liên kết trong trang web tài liệu Sandcastle?

Question

Tôi đã tạo tài liệu trang web về dự án của mình với Sandcastle. Trang web này sử dụng khung nên khi tôi nhấp vào mặc dù trang web, URL của tôi trong trình duyệt không thay đổi.

Tôi muốn thay đổi URL trong trình duyệt khi duyệt qua tài liệu trang web được tạo bằng Sandcastle. Tại sao? Bởi vì tôi muốn liên kết đến các trang con cụ thể của tài liệu từ các phần khác của môi trường nhà phát triển của tôi.

Và hơn thế nữa, tôi muốn có các liên kết này vĩnh viễn. Vì vậy, khi tôi tạo ra một lần nữa tài liệu từ phiên bản mới của dự án của tôi, liên kết sẽ không thay đổi để tôi sẽ không cần phải thay đổi tất cả các liên kết đến mới.

Điều này có thể thực hiện được và làm cách nào để hoàn thành điều này?

Answer 1

Để tạo liên kết đúng vào các trang con cụ thể của tài liệu bạn có thể sử dụng yêu cầu tương tự: $ DOCUMENTATION_ROOT $/index.aspx topic = html/$ TOPIC_ID $ .htm

Ví dụ: http://www.ewoodruff.us/shfbdocs/Index.aspx?topic=html/8dcbb69b-7a1a-4049-8e6b-2bf344efbbc9.htm thay vì http://www.ewoodruff.us/shfbdocs/html/8dcbb69b-7a1a-4049-8e6b-2bf344efbbc9.htm

Answer 2

Nếu bạn thêm mã dưới đây để phía trên cùng của SplitScreen.js trình duyệt sẽ "bơm" khung TOC và tập trung vào các nội dung mà bạn liên kết trực tiếp (sử dụng các trick Vitaly Shibaev cho thấy).

if (window==top) { 
    window.location = "/?topic=" + (window.location.pathname.substring(1)); 
} 

Mã này hoạt động nó trở thành tài liệu được đặt ở thư mục gốc của trang web của bạn - nếu bạn có nó trong một thư mục con bạn cần phải mở rộng "/ chủ đề?" Và loại bỏ các phần phụ thư mục từ phần đường dẫn.

Với thay đổi này, bạn có thể sử dụng "liên kết trực tiếp". Tôi cũng hy vọng những người tìm thấy bạn qua Google sẽ có trải nghiệm tốt hơn (nhận nội dung họ tìm kiếm VÀ thanh TOC).

Answer 3

Vitaliy và mawtex đã giải quyết phần 'cách liên kết tới trang phụ của tài liệu' trong câu hỏi của bạn.

"Tạo liên kết vĩnh viễn để chúng không thay đổi khi tạo lại tài liệu" một phần câu hỏi của bạn được giải quyết tự động, vì tên tệp html được tạo dựa trên băm của tên chủ đề theo mặc định. I E. Nếu bạn không thay đổi một phần mã mà bạn đang tạo tài liệu, thì nó sẽ sử dụng cùng tên tệp.

Bạn có thể thay đổi cách tạo tên tệp html, nhưng tất cả các phương pháp đã cho đều dựa trên tên thành viên hoặc mã băm của ID chủ đề, vì vậy các liên kết không được ngắt nếu mã không thay đổi.

Xem tài liệu về tài liệu NamingMethod của Nhà xây dựng trợ giúp Sandcastle để biết thêm thông tin.