2012-01-12 31 views
15

Có điều gì đó giống như JavaDocs cho Javascript không? Khi tôi nhấn ctrl + dấu cách trong netbeans IDE trong khiTài liệu Javascript

viết javascript, tài liệu javascript xuất hiện cho đối tượng được chỉ định. Nhưng tài liệu này tôi đoán là tài sản của Netbeans.

Nếu chúng tôi viết javascript theo cách nhận xét thích hợp, Netbeans cũng xây dựng tài liệu cho javascript tùy chỉnh của chúng tôi.

Chúng tôi có thể tìm thấy bất kỳ tài liệu javascript nào như vậy, bên ngoài Netbeans không? Vì vậy, chúng tôi có thể tham khảo nó?

Cảm ơn bạn đã trả lời.

Trả lời

11

Có một cái nhìn tại các trang doc tại Developer Network Mozilla (MDN) cho một tham chiếu tĩnh:

Tuy nhiên, tôi sợ rằng không có tab -kết hợp có thể được sử dụng bên trong một IDE.

+0

Chính xác những gì tôi cần. – Acn

+9

Mẹo tìm kiếm của Google: thêm "mdn" sau một thuật ngữ javascript, ví dụ: "substr mdn" và trang MDN tương ứng sẽ hầu như luôn là kết quả tìm kiếm đầu tiên. – nnnnnn

+1

Tôi sẽ không từ bỏ việc hoàn thành tab cho JsDoc (Javadocish) bên trong một IDE. WebStorm cho biết họ hỗ trợ nó: http://stackoverflow.com/questions/11076572/seeking-example-of-how-to-use-jsdoc-with-the-webstorm-ide-v-4 – SimplGy

8

Trong mã nguồn của hình tượng trưng trang chủ của Google, họ sử dụng các nhận xét trông rất giống với nhận xét javadoc, vì vậy phải có một số tiêu chuẩn mà ít nhất là Google sử dụng.

Dưới đây là một ví dụ:

/** 
* Configuration for a simulator speed setting. 
* - stepTime: ms between simulation steps that do something. 
* - emptyStepTime: ms between no-op steps. 
* - tapeTime: ms for a tape operation. 
* - branchTime: ms for a branch operation. 
* @typedef {{stepTime: number, tapeTime: number, emptyStepTime: number, 
*   branchTime: number}} 
* @private 
*/ 
+2

Đây là [JSDoc] (Các thẻ http://en.wikipedia.org/wiki/JSDoc), trong trường hợp này cho [Trình biên dịch đóng cửa của Google] (https://developers.google.com/closure/compiler/docs/js-for-compiler), để chúng thực sự có thể phục vụ một mục đích chức năng (tôi nghĩ trình biên dịch thực sự thực thi chúng, chẳng hạn như các thẻ '@ typedef' và' @ private' trong ví dụ được dán của bạn). – Ricket

0

Hãy thử một ứng dụng gọi là Ortelius. Nó sử dụng một số loại cú pháp như javadoc để genrate tài liệu. ortelius.marten.dk

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