Làm cách nào để định cấu hình DoxyGen để ghi lại các tệp ActionScript?Tôi có thể sử dụng DoxyGen để ghi lại mã ActionScript không?
Tôi đã bao gồm các tệp * .as và * .asi trong mẫu tìm kiếm của doxygen, nhưng các lớp, hàm và biến không hiển thị ở đó.
Thay vì doxygen, bạn nên sử dụng trình tạo tài liệu hỗ trợ cụ thể cho ngôn ngữ. Đối với ActionScript 2, bạn có một vài lựa chọn:
Nếu bạn đang sử dụng ActionScript 3, Adobe bao gồm trình tạo tài liệu miễn phí cùng với trình biên dịch mã nguồn mở của chúng (số Flex SDK), được gọi là "ASDoc". Nếu bạn đang sử dụng FlashDevelop, latest beta có tích hợp sẵn GUI để chạy ASDoc, do đó bạn không phải làm bẩn tay bằng dòng lệnh.
tôi đã có thể để tạo ra một số tài liệu với doxygen (Tôi có thể nói gì - Tôi thích tính năng và khả năng của mình) Bằng cách làm như sau:
Add * .as và * .asi vào danh sách các tập tin loại để nhập.
Chọn:
OPTIMIZE_OUTPUT_JAVA = YES
EXTRACT_ALL = YES
HIDE_UNDOC_MEMBERS = NO
HIDE_UNDOC_CLASSES = NO
Một vấn đề khác trong AS3 là câu lệnh package. Bạn cần báo cho DoxyGen bỏ qua định nghĩa gói. Điều này là dễ dàng để làm bằng cách sử dụng cond. Vì vậy, bạn sẽ có sự thay đổi:
package myPackage {
vào
/// @cond
package myPackage {
/// @endcond
Mà sẽ gây Doxygen bỏ qua dòng (s) giữa cond và endcond. Lưu ý rằng có vẻ như không cần phải làm tương tự đối với dấu ngoặc nhọn ở cuối tệp .as của bạn.
Bạn cũng có thể sử dụng Ortelius. Dễ sử dụng hơn ASDoc vì nó đi kèm với một GUI đơn giản và nó được tha thứ hơn cho mã của bạn. Miễn phí và mã nguồn mở của nó, nhưng chỉ có các cửa sổ.
Nó không hiệu quả với tôi. Doxygen không nhận ra ngữ pháp của AS3. Nó phân tích cú pháp không chính xác các phần tử chức năng như "Các hàm thành viên công khai", v.v. –