Hướng dẫn / Tài liệu kỹ thuật
Đọc tài liệu kỹ thuật tiếng Anh trên MDN
LangBox ·
Dùng một câu thật từ trang "What is JavaScript?" của MDN để xem cách đọc trang web song ngữ và nhấp đúp tra từ giúp bạn đọc tài liệu cho lập trình viên bằng tiếng Anh.
Trước khi đọc
- Mở liên kết tài liệu MDN bên dưới. Bài viết có thể được cập nhật theo thời gian; hãy dùng câu mở đầu chứa "implement complex features" làm đoạn để đọc.
Cách đọc một trang MDN với LangBox
Mở bài MDN và bật Nối thêm bản dịch
Mở trang "What is JavaScript?" của MDN trong Chrome máy tính và bật Nối thêm bản dịch để bản dịch hiện bên dưới đoạn tiếng Anh.
Nhấp đúp vào "implement" để so sánh các nghĩa
Nhấp đúp vào "implement" trong câu "allows you to implement complex features on web pages" để xác nhận đây là động từ mang nghĩa xây dựng hoặc thực hiện, không phải danh từ.
Đọc lại tiếng Anh gốc và ghi chú các thuật ngữ chính
Đọc lại câu tiếng Anh gốc mà không dựa vào bản dịch, và ghi lại các cụm động từ-danh từ hữu ích như "implement features" để ôn tập.
Lưu ý quan trọng khi đọc tài liệu kỹ thuật
- Để chạy quy trình thực tế này trên các trang dành cho lập trình viên, bạn cần tiện ích LangBox trong Chrome máy tính; các ghi chú mẫu trên trang này chỉ là ví dụ biên tập minh họa, không phải ảnh chụp màn hình thực.
- Hãy giữ nguyên tên API, tên biến và cú pháp mã bằng tiếng Anh gốc, đừng dựa vào các thuật ngữ đã dịch.
- Bản dịch và ghi chú từ điển chỉ là công cụ hỗ trợ đọc; hãy luôn kiểm tra lệnh và mã với tài liệu chính thức trước khi dùng.
Đoạn trích gốc và ghi chú đọc
JavaScript is a scripting or programming language that allows you to implement complex features on web pages […]
JavaScript là một ngôn ngữ lập trình có thể thêm các tính năng phức tạp vào trang web.
Đoạn trích gốc của những người đóng góp MDN, theo giấy phép CC BY-SA 2.5; phần diễn giải để đọc và phân tích câu là ví dụ biên tập, được cung cấp theo cùng giấy phép. MDN · CC BY-SA 2.5
- a scripting or programming language
- Cho biết JavaScript thuộc nhóm ngôn ngữ nào; "or" nối hai cách mô tả cho cùng một ngôn ngữ, chứ không liệt kê hai sản phẩm riêng biệt.
- that allows you to…
- Một mệnh đề quan hệ bổ nghĩa cho "language", giải thích ngôn ngữ đó cho phép bạn làm gì. Hãy xác định mệnh đề cốt lõi trước, rồi phân tích phần mô tả khả năng.
- implement complex features
- "Implement" là ngoại động từ có nghĩa là xây dựng, thực thi hoặc đưa vào thực hành; trong tài liệu kỹ thuật, "features" chỉ các chức năng, không phải đặc điểm ngoại hình của một người.
Hai câu kiểm tra mức hiểu
Câu này đang giải thích JavaScript dùng để làm gì, hay đưa ra hướng dẫn cài đặt?
Xem đáp án tham khảo
Câu này giải thích mục đích của JavaScript. Nó định nghĩa JavaScript là một ngôn ngữ và mô tả những khả năng mà ngôn ngữ này cho phép bạn đưa vào trang web.
Nếu từ điển có định nghĩa danh từ cho implement, bạn có nên áp dụng ở đây không?
Xem đáp án tham khảo
Không. Ngữ pháp ở đây là "allows you to implement", trong đó "to" dẫn vào một động từ nguyên mẫu; kết hợp với "complex features", nó có nghĩa là đưa các khả năng kỹ thuật vào thực hành.
Xử lý các vấn đề thường gặp
Phần giải thích hoặc bản dịch mâu thuẫn với nghĩa kỹ thuật
Giữ nguyên dạng gốc của định danh API, tên biến và cú pháp mã, đồng thời đối chiếu với tài liệu xung quanh. Bản dịch và ghi chú chỉ là công cụ hỗ trợ đọc; luôn dựa vào tài liệu kỹ thuật chính thức trước khi chạy mã hoặc thay đổi cấu hình.