Có một plugin giống như Javadoc cho Xcode tự động tạo mẫu tài liệu không?

Question

Tôi biết Doxygen để tạo tài liệu. Những gì tôi đang tìm kiếm là cách nhanh chóng để chèn tài liệu vào Xcode tương tự như những gì Eclipse thực hiện khi chỉnh sửa các tệp Java.

Hãy nói rằng tôi có một phương pháp khách quan-c với một vài lập luận như thế này:

-(NSInteger*) sumOf: (NSInteger*) one and:(NSInteger*) two {... 

Trong Eclipse, nếu bạn đặt con trỏ trên phương pháp và loại: /**<Enter> bạn nhận được một Javadoc mẫu trước được điền bằng các thẻ @param và @return.

Có thể đạt được điều gì đó tương tự trong Xcode không? Sau khi gõ /**<Enter>, tôi muốn có được điều này tự động:

/** 
* 
* @param one 
* @param two 
* 
* @return 
*/ 
-(NSInteger*) sumOf: (NSInteger*) one and:(NSInteger*) two {... 

Answer 1

Nếu bạn đã có sự kiên nhẫn, hãy xem here vì nó giải thích hành vi hoàn thành và ghi đè trong XCode. Tôi không biết nếu điều này sẽ làm việc cho bộ bình luận nhưng nó có vẻ như là một khởi đầu tốt.

- Frank

Answer 2

Các "User Scripts" menu (mà ít biểu tượng cuộn màu đen trên thanh menu Xcode của) có một menu con HeaderDoc với mẫu cho tất cả các loại đánh dấu tài liệu trong cú pháp HD. Bạn có thể thiết lập một phím tắt cho các mục bạn muốn sử dụng bằng cách vào "Key Bindings" trong cửa sổ "Preferences" của Xcode.

Vì kịch bản lệnh là tập lệnh shell, bạn có thể sử dụng bất kỳ ngôn ngữ kịch bản nào để viết, do đó nếu bạn muốn bạn thậm chí có thể viết một tập lệnh hỗ trợ regex phân tích tên tham số ra khỏi dòng đã chọn và điền vào các khái niệm cơ bản về nhận xét HeaderDoc của bạn.

Answer 3

Tập lệnh ở đây http://www.duckrowing.com/2011/05/14/using-the-doxygen-helper-in-xcode-4/ thực hiện chính xác những gì bạn muốn.

EDIT: Dưới đây là một phiên bản cập nhật của Script: https://github.com/premosystems/DoxygenXCodeHelper

Answer 4

tôi đã được sử dụng thành công trong VVDocumenter-Xcode Xcode 5 và nó hoạt động tốt. Nó sẽ tự động tạo một mẫu cụ thể cho một phương thức khi bạn nhập "///" phía trên phương thức.