2011-02-09 7 views
0

우선, PHP 소스에서 문서를 생성하는 방법에 대해 묻지 않습니다. Doxygen이나 PHPDocumentor 같은 라이브러리를 사용하면 충분합니다. 내가 찾고있는 클래스, 메소드, 속성 등 인라인 phpdoc 기반 주석 스텁을 자동으로 생성하는 방법입니다 거기에 이미 할 수있는 기존 라이브러리가 있습니까? 나는 약간의 검색을했고 아무 것도 생각 나지 않았다.자동 인라인 문서 생성

나는 가려움 때문에 내가 묻고있다. 나는 내 자신을 쓰는 것으로 긁기를 원한다. 나는 문서를 마지막 단계로 저장하면서 코드를 대량 작성하는 데 시간을 소비하는 경향이 있습니다. 문제는 심지어 인라인 문서의 중요성을 인식하면서도 수십 가지 방법과 속성을 사용하여 8 시간 연속 코딩하고 12 가지 클래스를 작성한 후에는 멈추고 기사 작성을 시작하기에 다소 벗어났습니다.

분명히, 나는 완벽한 문서를 자동으로 만들 수 없다. 클래스, 속성 및 메서드에 대한 자세한 설명 같은 것은 손으로 직접 입력해야합니다. 하지만 리플렉션을 사용하면 빈 자리 표시자를 사용하여 주석 스텁을 만드는 데 필요한 정보를 쉽게 얻을 수 있습니다.

누구나 이와 같은 솔루션을 검색하는 데 도움이 될 수 있다면, 굉장합니다. 그렇지 않다면 새로운 Github 저장소를 만들고 커뮤니티에 유용한 것을 제공 할 것입니다. :)

+1

Eclipse와 같은 많은 IDE에는 PHPDoc 스텁을 생성 할 수있는 기능이 있습니다. –

+0

+1 예, 프로그래밍 방식으로 실제로이를 수행 할 방법을 찾고 있습니다. 기본적으로 명령 줄에서 실행하고 반복하여 문서화 할 디렉토리 (+ 필터)를 지정하십시오. 사실 Eclipse를 알고 있지만 불행히도 Netbeans를 사용하기 때문에이 기능을 찾지 못하는 것 같습니다. 어느 쪽이든 재미있는 작은 애완 동물 프로젝트가 될 것입니다. :) –

+1

[PHP 소스 코드 문서를 추가하고 완성하는 도구] 가능한 중복 (http://stackoverflow.com/questions/1936376/a-tool-to-add-and-complete-php-source-code-documentation) –

답변

1

DocumentX (반복 할 수 있음).

1

docgen의 도움이 필요하십니까? Document generation software에는 docgen을 최대한 활용할 수있는 자료가로드되어 있습니다. docgen 시스템을 최적화하는 방법에 대한 좋은 제안