Sandcastle Documentation 웹 사이트에서 링크와 같은 MSDN을 만드는 방법은 무엇입니까?
-
06-07-2019 - |
문제
Sandcastle과 함께 프로젝트의 웹 사이트 문서를 생성했습니다. 이 웹 사이트는 프레임을 사용하므로 사이트를 클릭하면 브라우저의 URL이 변경되지 않습니다.
Sandcastle로 생성 된 웹 사이트 문서를 탐색 할 때 브라우저에서 URL을 변경하고 싶습니다. 왜요? 개발자 환경의 다른 부분에서 문서의 구체적인 서브 페지에 연결하고 싶습니다.
그리고 더도이 링크를 영구적으로 갖고 싶습니다. 따라서 새 버전의 프로젝트에서 다시 문서를 생성하면 모든 링크를 새로 변경할 필요가 없도록 링크가 변경되지 않습니다.
이것이 가능하고 이것을 어떻게 압도 하는가?
해결책
문서의 특정 하위 페이지에 대한 올바른 링크를 만들려면 유사한 요청을 사용할 수 있습니다. $ documentation_root $/index.aspx? Topic = html/$ topic_id $ .htm.
예를 들어 http://www.ewoodruff.us/shfbdocs/index.aspx?topic=html/8dcb69b-7a1a-4049-8e6b-2bf344444444444449.htm대신에 http://www.ewoodruff.us/shfbdocs/html/8dcbb69b-7a1a-4049-8e6b-2bf344efbc9.htm
다른 팁
아래 코드를 상단에 추가하면 SplitScreen.js
브라우저는 TOC 프레임을 "주입"하고 직접 연결된 내용에 중점을 둡니다 (Vitaly Shibaev를 사용하여 표시).
if (window==top) {
window.location = "/?topic=" + (window.location.pathname.substring(1));
}
이 코드는 문서가 웹 사이트의 루트에 배치됩니다. 서브 폴더에있는 경우 "/? icure"에서 확장하고 PathName 부분에서 하위 폴더 부분을 제거해야합니다.
이 변경으로 "직접 링크"를 사용할 수 있습니다. 또한 Google을 통해 귀하를 찾는 사람들이 더 나은 경험을 얻을 것으로 기대합니다 (검색 한 콘텐츠 및 Toc Bar).