SandCastle 이란 놈을 이용하면 XML을 이용해서 문서를 작성 할 수가 있다.

SandCastle 설치 폴더에 Examples\generic아래에 Gui에 해당하는 실행 프로그램을 실행한 후

각 해당하는 항목에 Add 해 주면 된다.

-. Assembly And Comment Files


Assemblies :
작성할 대상의 DLL 설정한다. 개의 DLL 또는 다수의 DLL, 폴더를 통째로 지정할 있다.

 

Comments : DLL 생성시 같이 생성되는 XML 코멘트 파일을 설정한다.

Comments파일을 지정하지 않더라도 Help File 생성할 있지만 경우 Syntax 외에 중요한 정보들은 Help File 나타나지 않는다.

                   

Dependent Assemblies : 해당 DLL에서 참조하는 DLL들을 지정한다. 참조하는 DLL 지정하지 않을 경우 Help File 생성되지 않는다.

 

-. Options

Name : Sandcastle 프로젝트 명이자, 출력될 폴더 명이 된다.

 

Presentation Style : Help File 출력 타입을 설정한다.

 

Language ID : 생성될 Help File 언어를 설정, 한국어는 1042

 

Default Targets : 출력할  대상 설정

-. Log : Build버튼을 눌러 실행하면 모든 로그가 항목에 나타난다.

          Build 실패할 경우 로그를 통해 원인을 있다.


Build
완료되면 지정된 폴더에 Name항목에 설정한 폴더가 생성된다.

기본적으로 생성물은 C:\Program Files\Sandcastle\Examples 폴더아래에 Name 설정한 폴더명으로 생성이 되며, generic.targets파일의 BuildDir 항목을 수정하여 변경할 있다.

 

기본적으로 Sandcastle 사용되는 모든 파일을 복사하여 사용하고, 원본 파일은 사용하지 않는다.

comments : 화면에서 지정한 코멘트파일(XML) 폴더에 자동 복사되어 진다.

 

dll : Assemblies 에서 지정한 DLL Dependent Assemblies 지정한 참조 파일들이

폴더에 자동으로 복사되어진다.

 

hana, vs2005, prototype : Presentation Style에서 지정한 Style 폴더가 생성되고

최종 결과물(.chm파일) 폴더 하위의 chm 폴더에 생성된다.

SandCastle 파일은 아래 주소에 가면 받을 수 있다.

http://www.codeplex.com/Sandcastle/Release/ProjectReleases.aspx?ReleaseId=13873