Visual Studio XML 출력에서 MSDN 스타일의 문서를 쉽게 만들 수 있습니까?
나는이 다리를 건너는 첫 사람이 아니기 때문에 좋은 xslt를 설정할만큼 참을성이 없습니다.API 문서에 .NET XML 주석
최근에 나는 모래 껍질을 세우려고했지만 실제로 눈을 멀게 만들었습니다. 이 과정에서 중요한 것을 놓친 것이거나 너무 복잡합니다.
나는 누군가가 정말 멋진 죽은 단순한 해결책을 알고 있습니다.
내 서식을 읽고 그 단락이 아닌 초대를 만든 생각하기 때문에 내가 여기 되풀이 해요 : 나는 모래 시도하는 듯했으나이 설정 점점 정말 힘든 시간을했다
. 내가 실제로 염두에두고있는 것은 훨씬 단순한 것입니다.
즉, 단지 모래 껍질 과정을 이해하지 않는 한. 테스터들이 잘 작업 할 수있는 무언가를 만들어내는 것은 엄청난 양의 여분의 수하물처럼 보였습니다.
당신은 샌드캐슬
프로젝트 페이지를 찾고 : Sandcastle Releases
블로그 : Sandcastle Blog 선택의 도구로 사용
NDoc Code Documentation Generator for .NET하지만 지원을 모두 가지고 있지만 중단했다.
정확하게 이것을하는 Sandcastle을보십시오. 또한 더 간단한 솔루션 중 하나이기도하고 선택 도구이기 때문에 장기적으로 설치 중에 발생한 문제를 지정하면 Sandcastle을 설정하는 데 도움이 될 수 있습니다.
방금 Sandcastle을 다시 설정했습니다. 그것을 설치 (2008 년 5 월 출시)하고 SandcastleGui.exe 또는 비슷한 것을 찾으십시오 (예제 폴더에 있습니다.).
어셈블리 추가를 클릭하고 어셈블리 또는 어셈블리를 추가하고 .xml 문서 파일 (해당 옵션을 활성화 한 경우 컴파일러에서 생성 한 파일)을 추가 한 다음 빌드를 추가합니다.
다소 시간이 걸릴 수 있지만 결과는 입니다.은 노력할 가치가 있습니다. 실제로 MSDN의 내용을 조회 할 것이므로 결과 문서에는 MSDN과 같은 링크가있는 System.Object에 대한 클래스 상속이 있습니다.
Sandcastle은 처음에는 약간 복잡해 보였습니다. 특히 자동화 된 빌드에서 사용하고자 할 때 그렇습니다.하지만 노력할만한 가치가 있다는 것을 확신합니다.
또한 Sandcastle Help File Builder을 살펴 보겠습니다. 다소 고급 GUI입니다.
따라 서 this simple 5 step article을 수행하면 거의 완료됩니다. 보너스로 H2Viewer을 사용하여 Html Help 2.x 파일을 볼 수 있습니다.
Sandcastle 도움말 파일 작성기도 사용해야합니다. 도움말 파일을 생성하는 GUI와 같은 ndoc을 제공하므로 명령 프롬프트에서 아무 것도하지 않아도됩니다.
내가 시도
NDoc3를 사용 http://sourceforge.net/projects/ndoc3/ – Muxa