2011-01-16 5 views
5

Tôi đang tìm một công cụ để tạo tài liệu mã nguồn Delphi, và tôi muốn thử một cách để Doc-O-Matic Express (miễn phí). Có bất kỳ hướng dẫn cho người mới bắt đầu làm thế nào để sử dụng Doc-O-Matic Express để tài liệu mã nguồn Delphi (quản lý dự án doc-o-matic, phong cách docblock ưa thích, cú pháp docblock hoàn chỉnh, vv)?Sử dụng Doc-O-Matic (Express) với Delphi

+0

Chỉ miễn phí cho mục đích phi thương mại. –

+2

Doc-O-Matic là một công cụ thực sự rất tốt nhưng cuối cùng, chất lượng tài liệu của bạn chỉ tốt như những nỗ lực bạn đã đưa vào trong việc bình luận mã của bạn. –

+0

Bạn có thể thử DelphiCodeToDoc (phần mềm mã nguồn mở được viết bằng Delphi). Tạo một dự án đầu tiên chỉ là vài giây. Sau đó, nếu bạn cần thêm tính năng 'chuyên nghiệp', hãy thử Doc-o-matic (VERY mạnh mẽ). http://dephicodetodoc.sourceforge.net/ – TridenT

Trả lời

1

Trong số này page bạn có thể tìm thấy tài liệu có thể hữu ích cho bạn Delphi Documentation Guidelines. Tôi đã sử dụng nguyên tắc này để ghi lại mã nguồn của mình trong số project này.

2

Đừng bận tâm với cài đặt Doc-o-matic ngay bây giờ. Phiên bản nhanh chỉ là dòng lệnh.

  1. Chọn một bình luận phong cách
  2. Bình luận mã của bạn
  3. Tạo tài liệu (một dự án mặc định là đủ để bắt đầu)
  4. Xác minh bạn bình luận bảo hiểm

Doc-o-matic hỗ trợ JavaDoc và XMLDoc (hoặc thậm chí là các kiểu nhận xét gốc). Công cụ tự nó sẽ chỉ giúp nếu mã của bạn đã được bình luận, hoặc nếu bạn muốn bình luận trực tiếp bên trong IDE của nó.

Nếu bạn thích Doc XML hoặc javadoc, Doc-O-Matic không hỗ trợ cả hai đều tốt và cả ba phong cách là hỗ trợ khi viết bình luận của nguồn thông qua trình biên tập tích hợp trở lại nguồn.

+0

Lưu ý rằng phiên bản tốc hành chỉ lấy ý kiến ​​từ phần giao diện. – pritaeas

+0

@pritaes: Đúng vậy! và đây là liên kết đến ma trận tính năng (Express thực sự là phiên bản trống). http://www.doc-o-matic.com/features.html?tab=matrix – TridenT