JSdoc - Tạo documentation trực tiếp từ comments trong file JavaScript
TIL
607
@100daysTIL
72
White

Minh-Trung Nguyễn viết ngày 27/02/2018

JSdoc - Tạo documentation trực tiếp từ comments trong file JavaScript

Day 27

  • JSDoc là 1 module giúp tạo project documentation từ comments trong các file JavaScript.
  • Điều này có nghĩa là ông nào code, hiểu rõ code của mình nhất, thì trực tiếp viết docs cho chính code của ông ý đơn giản chỉ bằng các comments đặt ngay bên trên các module/ function.
  • Tất nhiên các comments này phải tuân theo quy tắc chung, đưa ra bởi JSDoc, để JSDoc có thể hiểu và chuyển nó thành documentation.
  • Có nhiều format cho documentation để người dùng lựa chọn, gọi là template. Documentation xuất ra có thể là dạng html hoặc markdown. Nhưng html có lẽ là định dạng chính.
  • Để chạy được jsdoc, cần:
    • Cài jsdoc thông qua npm install --save
    • Sau đó, để tránh gõ command line dài dòng, thì thêm cấu hình trong package.json phần script.
    • Để truyền vào các tham số cho jsdoc, thì có thể đặt cầu hình trong jsdoc.json.

ngminhtrung 27-02-2018

Bình luận


White
{{ comment.user.name }}
Bỏ hay Hay
{{comment.like_count}}
Male avatar
{{ comment_error }}
Hủy
   

Hiển thị thử

Chỉnh sửa

White

Minh-Trung Nguyễn

58 bài viết.
74 người follow
Kipalog
{{userFollowed ? 'Following' : 'Follow'}}
Cùng một tác giả
White
44 15
Đăng lại một bài đã viết từ cách đây mấy tháng. Chủ đề này đã có không ít, nhưng chẳng hiểu sao lượng bài tự viết của dân lập trình người Việt ta v...
Minh-Trung Nguyễn viết 4 tháng trước
44 15
White
27 5
Ghi chú: Tiêu đề hoàn toàn mang tính câu view. Bài copy từ blog của tác giả :) Tại sao lại có bài viết này? Một ngày đẹp giời tôi cần kiểm t...
Minh-Trung Nguyễn viết 8 tháng trước
27 5
White
16 4
Về bước tìm và xử lý dữ liệu của Việt Nam phục vụ Data Visualization nền web Làm việc với D3js được nửa năm, một trong những điều bận lòng là chưa...
Minh-Trung Nguyễn viết 3 tháng trước
16 4
Bài viết liên quan
White
0 2
fCC: Technical Documentation Page note So I have finished the HTML part of this exercise and I want to come here to lament about the lengthy HTML ...
HungHayHo viết 2 tháng trước
0 2
White
2 1
Javascript inititalValue trong reduce() có quan trọng không? Day 41: Đọc code mẫu về hàm reduce() trong (Link), thấy hàm reduce() khá "đơn giản"....
Minh-Trung Nguyễn viết 4 tháng trước
2 1
{{like_count}}

kipalog

{{ comment_count }}

bình luận

{{liked ? "Đã kipalog" : "Kipalog"}}


White
{{userFollowed ? 'Following' : 'Follow'}}
58 bài viết.
74 người follow

 Đầu mục bài viết

Vẫn còn nữa! x

Kipalog vẫn còn rất nhiều bài viết hay và chủ đề thú vị chờ bạn khám phá!