Sandcastle Documentation 웹 사이트에서 링크와 같은 MSDN을 만드는 방법은 무엇입니까?

Question

Sandcastle과 함께 프로젝트의 웹 사이트 문서를 생성했습니다. 이 웹 사이트는 프레임을 사용하므로 사이트를 클릭하면 브라우저의 URL이 변경되지 않습니다.

Sandcastle로 생성 된 웹 사이트 문서를 탐색 할 때 브라우저에서 URL을 변경하고 싶습니다. 왜요? 개발자 환경의 다른 부분에서 문서의 구체적인 서브 페지에 연결하고 싶습니다.

그리고 더도이 링크를 영구적으로 갖고 싶습니다. 따라서 새 버전의 프로젝트에서 다시 문서를 생성하면 모든 링크를 새로 변경할 필요가 없도록 링크가 변경되지 않습니다.

이것이 가능하고 이것을 어떻게 압도 하는가?

Answer 1

문서의 특정 하위 페이지에 대한 올바른 링크를 만들려면 유사한 요청을 사용할 수 있습니다. $ 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

Answer 2

아래 코드를 상단에 추가하면 SplitScreen.js 브라우저는 TOC 프레임을 "주입"하고 직접 연결된 내용에 중점을 둡니다 (Vitaly Shibaev를 사용하여 표시).

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

이 코드는 문서가 웹 사이트의 루트에 배치됩니다. 서브 폴더에있는 경우 "/? icure"에서 확장하고 PathName 부분에서 하위 폴더 부분을 제거해야합니다.

이 변경으로 "직접 링크"를 사용할 수 있습니다. 또한 Google을 통해 귀하를 찾는 사람들이 더 나은 경험을 얻을 것으로 기대합니다 (검색 한 콘텐츠 및 Toc Bar).

Answer 3

Vitaliy 그리고 Mawtex 질문의 '문서 소호지에 연결하는 방법'을 해결했습니다.

"문서화를 재생할 때 변경되지 않도록 링크 만들기"는 질문의 일부가 자동으로 해결됩니다. 즉 문서화중인 코드의 일부를 변경하지 않으면 동일한 파일 이름을 사용합니다.

HTML 파일 이름이 생성되는 방식을 변경할 수 있지만 주어진 모든 메소드는 주제 ID의 멤버 이름 또는 해시를 기반으로하므로 코드가 변경되지 않은 경우 링크가 나지 않아야합니다.

Sandcastle 도움말 파일 빌더를 참조하십시오 이름 지정 메드 자세한 정보를위한 문서.