일식 안팎에서 PHPDOC 문서 생성기? [닫은
-
19-09-2019 - |
문제
Eclipse + Pdt로 개발 중입니다. 내 코드에 PHPDOC 댓글을 추가했지만 실제로 Eclipse에서 결과 문서를 생성하지 않았습니다. 어떻게해야합니까? 일식에 어떤 기능이 있습니까? 아니면 DOC 생성이 외부에서 수행되어야합니까?
해결책
문서를 생성하려면 사용해야합니다 phpdocumentor, 배 패키지로 설치할 수 있습니다.
그런 다음 명령 줄에서 호출해야합니다. 나는 그것을 Eclipse PDT에서 실제로 부르는 것을 본 적이 없다.
훌륭한 솔루션은 연속 통합 플랫폼을 사용하는 것입니다 (사용 phpundercontrol, 예를 들어), 빌드 구성 파일에서 PHPDOC 생성에 통합; 이런 식으로 PHPDOC는 누군가가 커밋 할 때마다 생성됩니다. (또는 하루에 한 번 또는 원할 때마다 ^^).
Eclipse PDT에서는 "외부 도구"(메뉴에서 "실행> 외부 도구"참조)를 호출 할 수 있습니다. 이를 통해 CLI에서와 같이 PHPDOC 명령을 시작할 수 있습니다. 그러나 그것은 Zend Studio가 제공하는 것만 큼 사용자 친화적이지는 않습니다. 그러나 같은 가격도 아닙니다 ^^
다른 팁
문서를 생성하는 또 다른 훌륭한 도구는입니다 아피 겐. 배로 설치할 필요는 없지만 (포함) 독립형 패키지처럼 사용할 수 있습니다.
예, Zend에는 마법사가 있습니다. 이것을 확인하십시오 간단한 가이드.
또는 표준을 호출하기 위해 외부 시작 구성을 만들 수 있습니다. phpdocumentor.
- 실행-> 외부 도구-> 외부 도구 구성 ...
- 왼쪽 창에서 프로그램을 선택한 다음 새 아이콘 (창 위의 왼쪽 아이콘)을 선택하십시오.
- 오른쪽 창에서 메인 탭을 선택하십시오.
- 이름 : 필드로 Generate_Doc을 입력하십시오.
- 위치 : 필드에 Phpdoc CLI 도구로가는 경로를 입력하십시오.
- 현재 프로젝트 입력 $ {project_loc}에 대한 인수 필드에 필요한 인수를 입력하십시오.
- 외부 구성을 실행하려면 실행을 선택하십시오.
구성을 다시 실행하려면 몇 가지 선택 사항이 있습니다.
- 메뉴 표시 줄에서 외부 도구 아이콘을 선택하십시오 외부 도구 아이콘 http://help.eclipse.org/ganymede/topic/org.eclipse.cdt.doc.user/images/icon%5fext%5ftools.png " 그런 다음 generate_doc을 클릭하십시오
- run-> 외부 도구-> Generate_doc을 선택하십시오
- Alt+R, E, 1을 누르십시오 (Generate_Doc이 목록의 첫 번째 항목이라고 가정합니다. 그렇지 않으면 적절한 번호를 선택하십시오)