2016-09-21 1 views
-1

많은 소스 코드가있는 프로젝트가 있습니다. 문서화를 위해 모든 소스 코드를 PDF, HTML 또는 DOCX와 같은 단일 파일로 병합해야합니다. 바람직하게는, 병합 된 각 파일 콘텐츠는 그 상대적인 원점을 갖는 캡션을 가져야한다. 좋은 형식은 바람직하지만 의무 사항은 아닙니다.프로젝트의 소스 코드로 문서 작성

아무도이 작업을 수행하지 않았습니까? 작업을 자동화하는 간단한 코드 스 니펫이 있습니까? 이상하게도 나는 주변을 수색하여이 도전에 대한 어떤 힌트도 찾지 못했습니다.

답변

1

유닉스에 있다면 a2ps은 포스트 스크립트에 많은 양의 원본을 인쇄하는 정말 좋은 작업을 수행합니다.이 작업은 예를 들어를 통해 PDF로 변환하는 것이 간단합니다. ps2pdf. 같은 :이 명령 줄에서 지정한 모든 소스를 덤프

a2ps *.c -o foo.ps 
ps2pdf foo.ps foo.pdf 

(그리고 당신은 찾아 xargs를 또는 유사한 몇 가지 콤보와 함께 순환 갈 수 있습니다.) 전체 소스 덤프가 필요하지 않은 경우 언어의 기본 소스 문서 센터 (doxygen 또는 javadoc 또는 유사)에서 읽는 것이 가장 좋습니다. 대부분의 소스 문서 센터 시스템은 일련의 형식으로 출력 할 수 있습니다.

+0

제안 해 주셔서 감사합니다. 나는 실제로 Windows에 있지만 어떤 유닉스 물건을 돌리는데 문제가 있어서는 안된다. 나는 유닉스가 이런 유형의 작업에 더 적합하다는 것을 나 스스로 의심했다. 결과에 대한 시도와 업데이트를 제공 할 것입니다. –

+0

a2ps (http://gnuwin32.sourceforge.net/packages/a2ps.htm)의 windows 포트를 사용했는데 정말 좋았습니다. 나는 비슷한 상황에서 그것을 추천한다. 다시 한 번 감사드립니다! –

+0

대단히 환영합니다! –