2009-12-02 47 views
21

Tôi muốn bắt đầu sử dụng phpDocumentor nhưng tôi cảm thấy khó khăn - giao diện web không phát độc đáo và tôi không thể phân tích cú pháp các tệp mẫuBất kỳ hướng dẫn nào về cách sử dụng phpDocumentor?

Tôi có thể chưa thiết lập đúng và Tôi muốn một hướng dẫn từng bước tốt đẹp (ví dụ: NOT THIS ONE) để kiểm tra nơi tôi đã đi sai và hy vọng làm cho nó phân tích cú pháp một cái gì đó

Nhưng tôi không thể tìm thấy bất cứ điều gì thông qua google - bất cứ ai có thể đề xuất bất kỳ hướng dẫn hay nguồn lực để bắt đầu với phpdoc?

Rất cám ơn!

Ian

EDIT: Cảm ơn bạn đã nhảy vào, ashnazg! Đây là những bước tôi đi theo:

  1. Pear đã không làm việc trên Mac phiên bản của tôi để tải về 1.4.3 và giải nén nó vào một thư mục
  2. rõ đường dẫn tuyệt đối để lấy mẫu tập 2 trên HD của tôi dưới tab tập tin
  3. Chỉ định thư mục đầu ra có thể ghi trên thế giới
  4. Nhấp vào Tạo nội dung ... đang diễn ra trong nhật ký, thư mục phương tiện được tạo nhưng không có báo cáo. Nhật ký kết thúc "L ERI: không có gì được phân tích cú pháp"

Tôi có Pear làm việc và cài đặt phpdoc theo cách đó; có thể sử dụng nó thông qua dòng lệnh, nhưng bất kỳ ý tưởng nào về những gì có thể xảy ra với giao diện web để ngăn không cho nó phân tích cú pháp tệp? Dường như được hạnh phúc trong tất cả các khía cạnh khác.

CHỈNH SỬA 2: Cảm ơn bạn đã liên kết đến Developer.com article, Liz: Nó rất cơ bản nhưng là một khởi đầu hữu ích.

+0

Được phân bổ. Tôi đã viết mã thân thiện với phpDoc trong hơn một năm nhưng chưa bao giờ có được thứ chết tiệt chạy đúng cách. Cũng sẽ thực sự biết ơn đối với một hướng dẫn từng bước tốt. Giao diện web và tài liệu để lại một LOT được mong muốn. –

+0

LRI: không có gì được phân tích cú pháp ===> bạn cần chỉ định đường dẫn quét -. C: \ xampp \ htdocs \ my_project> phpdoc -o HTML: khung: earthli, PDF: mặc định: mặc định t ./docs -d ./ – websky

Trả lời

-1
+2

Điều đó thực sự vô cùng vô ích - nếu bạn đọc câu hỏi tôi đã hỏi, đó cũng chính là câu hỏi tôi đã liên kết. Vấn đề là các hướng dẫn không có tác dụng đối với tôi và tôi đã yêu cầu các hướng dẫn KHÁC. – Polsonby

+0

Bạn đã chính xác, tôi đã trả lời sai cho bạn. Điều này có hữu ích không? http://www.developer.com/lang/php/article.php/10941_3440261_2/Tài liệu-PHP-Code-with-PHPDocumentor.htm –

+0

Cảm ơn vì điều đó; vâng tôi thấy rằng sử dụng Google quá :) Nhưng nó là khá tốt. – Polsonby

0

Tôi không biết về bất kỳ hướng dẫn ví dụ về sử dụng giao diện web. Tôi không thực sự nhận được nhiều câu hỏi để hỗ trợ bằng cách sử dụng nó. Nếu bạn có thể làm nổi bật cách bạn đang sử dụng nó mà không thành công, tôi có thể giúp bạn.

+0

Cảm ơn điều đó - đã thêm một số giải thích cho bài đăng của tôi ở trên – Polsonby

+0

"L ERI: không phân tích cú pháp" cho biết phpDocumentor không nghĩ rằng bạn đã cho nó bất kỳ tệp PHP nào để xử lý. Hãy xem xét kỹ hơn đầu ra thời gian chạy và xem bạn có phát hiện ra nơi nó cố gắng sử dụng đường dẫn tuyệt đối mà bạn đã cung cấp hay không. Linh cảm đầu tiên của tôi có thể là nó chứa một thư mục với một không gian trong tên của nó ... rằng _might_ đang gây ra một vấn đề. – ashnazg

1

Cá nhân, tôi sử dụng các thẻ tiêu chuẩn JavaDoc và một chương trình Python nhỏ để chuyển đổi tệp PHP thành tệp Java của tôi (với các thân phương thức trống). Sau đó, tôi chạy JavaDoc - Tôi thích các tính năng và giao diện của nó tốt hơn bất cứ điều gì khác tôi đã nhìn thấy. Vâng, tôi đã bắt đầu với java trước PHP.

chương trình python nhỏ này là một phần của công cụ PHP của tôi và có thể được tìm thấy trên

http://code.google.com/p/mcrwebapp/source/browse/trunk/tools/php2java

(cho những gì nó có giá trị.)

+0

Rất thú vị Don, JavaDoc luôn là yêu thích của tôi. Không phải là một nhiệm vụ lớn, nhưng bạn có thể chia sẻ chương trình Python của mình để chuyển đổi PHP thành một bộ xương Java không? – defines

5

Các tài liệu không cho bạn biết điều này, nhưng bạn phải di chuyển mẫu tập tin vào một thư mục mà không có chuỗi "hướng dẫn" bất cứ nơi nào trong đường dẫn. phpDocumentor coi "hướng dẫn" là một từ dành riêng và từ chối phân tích cú pháp bất kỳ tệp nào có trong đường dẫn.

Các vấn đề liên quan