Trợ giúp:Lỗi chú thích

"H:CE" đổi hướng tới đây. Đối với biểu thức điều kiện, xem Trợ giúp:Tính toán.

Phần mở rộng Cite của phần mềm MediaWiki, được Wikipedia sử dụng, có khả năng phát hiện lỗi. Trang này ghi lại các thông báo lỗi đồng thời cung cấp thông tin về vấn đề cùng cách giải quyết vấn đề đó.

Các thông báo lỗi

Các tin nhắn sẽ được định dạng dưới dạng , và sẽ xuất hiện trên trang được kết xuất sau khi nhấn nút "Đăng thay đổi".

Những thông báo này phụ thuộc vào cài đặt ngôn ngữ trong Đặc biệt:Tùy chọn—danh sách này chỉ áp dụng cho "vi - Tiếng Việt".

• Lỗi chú thích: $1
• Thẻ <ref> không hợp lệ; ref không có tên phải có nội dung
• Thẻ mở <ref> bị hỏng hoặc có tên sai
• Tham số "$1" không hợp lệ trong thẻ <ref>. Các tham số được hỗ trợ là: $2.
• Thẻ <ref> không hợp lệ; tên không thể chỉ là một số nguyên. Hãy sử dụng tiêu đề có tính miêu tả
• Thiếu thẻ đóng </ref> cho thẻ <ref>
• Thẻ <ref> không hợp lệ; không có nội dung trong ref có tên $1
• Tham số "$1" không hợp lệ trong thẻ <references>. Các tham số được hỗ trợ là: $2.
• Tồn tại thẻ <ref> cho nhóm chú thích với tên "$1", nhưng không tìm thấy thẻ <references group="$1"/> tương ứng
• Thẻ <ref> trong <references> có thuộc tính nhóm mâu thuẫn "$1".
• Thẻ <ref> có tên "$1" được định nghĩa trong <references> không được đoạn văn trên sử dụng.
• Thẻ <ref> được định nghĩa trong <references> không có thuộc tính name.
• Thẻ <ref> không hợp lệ; tên "$1" được định nghĩa nhiều lần với nội dung khác nhau
• Thẻ <ref> có tên "$1" được định nghĩa trong <references> nhóm "$2" không có nội dung nào.

Các thông báo lỗi sau trong phần mở rộng Cite hiện chưa có trang trợ giúp nào vì chúng ít khi xảy ra hoặc mới được thêm vào:

• Thẻ <ref follow="…"> tiếp nối thẻ trước đó không thể được đặt tên riêng hoặc có nội dung chi tiết.
• dir="$1" không hợp lệ, phải là ltr hoặc rtl
• Một trong các thẻ <ref> với tên "$1" có thuộc tính dir mâu thuẫn.
• Thẻ <ref> không hợp lệ; thiếu thuộc tính name. Phải cung cấp thuộc tính name kèm một thuộc tính nội dung.
• Thiếu thẻ đóng cho <references>
• Thẻ <ref> có nội dung chi tiết phải chứa nội dung hoặc dùng tên để trỏ tới một chú thích gốc.
• Thẻ <ref> có tên "$1" không thể sử dụng nội dung chi tiết khi được đặt trong <references>.
• Tham số "$1" không hợp lệ trong thẻ <ref>. Có phải ý bạn là "$2"?

Các vấn đề khác

Một số vấn đề có thể không hiển thị thông báo lỗi chú thích, trong khi một số vấn đề có thể không dễ dàng nhận thấy được.

Trong tên thẻ ref chỉ sử dụng dấu ngoặc kép thẳng

Khi bạn chú thích cùng một nguồn nhiều hơn một lần trên một trang, chỉ sử dụng dấu ngoặc kép thẳng " " để bọc tên chú thích. Đừng sử dụng dấu ngoặc kép cong “ ”, vì chúng chỉ được coi là một ký tự thông thường, chứ không phải dấu ngoặc kép. Thông báo lỗi sẽ xuất hiện khi chú thích gốc và chú thích lặp lại sử dụng cả dấu ngoặc kép thẳng lẫn dấu ngoặc kép cong. Cú pháp định nghĩa việc đặt tên một nguồn tham khảo là:

<ref name="name">content</ref>

Để lặp lại một chú thích có tên:

<ref name="name" />

Một trang hiển thị trong thể loại lỗi chú thích nhưng không hiển thị lỗi chú thích

Nếu <ref>...</ref> chứa một URL có dấu =, và nếu chú thích đó nằm trong một bản mẫu, thì bản mẫu đó sẽ bị lỗi. Tùy vào vị trí của URL mà thông báo lỗi chú thích có thể không hiển thị, dù vậy trang đó vẫn sẽ được xếp vào thể loại lỗi. Hãy đảm bảo rằng dấu = được mã hóa thành =

refTools sẽ bắt lỗi này.

Ví dụ, một chú thích được lồng sai mà {{lower}} được dùng để làm thu nhỏ chú thích đó:

{{lower|<ref>content1<ref>content2</ref>[http://www.washingtoninstitute.org/templateC05.php?CID=2386]</ref>}}

Liên kết chú thích hiện trong thân bài viết nhưng không hiện trong danh sách chú thích

Điều này có thể do bản mẫu không được đóng đúng cách bằng }}.

Nó cũng có thể gây ra do nhiều phụ chú (chú thích cuối trang) được định rõ dùng cùng một tên. Các liên kết sẽ được tạo ra cho cả hai, tuy vậy chỉ có cái đầu tiên sẽ được hiển thị trên danh sách chú thích: Ví dụ:

<ref name="foo">content1</ref>

<ref name="foo">content2</ref>

Chỉ content1 sẽ được hiển thị. refTools sẽ bắt lỗi này.

Thiếu nội dung trên trang không phải bài viết

Nếu phụ chú không có thẻ đóng </ref>, nó sẽ "ăn" đoạn văn sau đó, khiến cho nó không được hiển thị. Điều này thường hiển thị một lỗi chú thích, trừ khi nó là phụ chú cuối cùng trên trang. Thông thường, nó sẽ ẩn luôn thẻ <references /> và phát sinh ra lỗi, tuy vậy thông báo thiếu thẻ <references /> bị ẩn đi trên các trang không phải là bài viết. refTools sẽ bắt lỗi này.

Bản mẫu

Một số bản mẫu có thể chứa thẻ <ref>...</ref>; ví dụ {{botanist}}. Nếu một bản mẫu kiểu này được đưa vào mà không có thẻ <references /> thì sẽ phát sinh lỗi, nhưng không dễ nhận ra vấn đề đó. refTools sẽ không bắt lỗi này.

Có một số cách giải quyết vấn đề này. Dưới đây là danh sách sắp xếp theo thứ tự ưu tiên. Lưu ý rằng chỉ cần dùng đến một trong số đó là đủ, không cần dùng tất cả.

Cách 1

Nếu bản mẫu có trang tài liệu, hãy thêm <references /> vào đó.

Cách 2

Thêm đoạn mã sau vào cuối bản mẫu:

<noinclude>
{{Template reference list}}
</noinclude>

Cách 3

Thêm đoạn mã sau vào cuối bản mẫu:

<noinclude>
<div style="display: none"><references /></div>
</noinclude>

Nhược điểm: Ẩn chú thích, không thông báo cho người dùng rằng nó ở đó; các biên tập viên sẽ không thể kiểm tra định dạng chú thích.

Cách 4

Đưa thẻ <references /> vào chính bản mẫu đó sử dụng tham số group. Xem en:Help talk:Cite errors/Testcases1 để biết ví dụ.

Nhược điểm: Tạo ra một đề mục tham khảo riêng không dễ nhận thấy được; không cho tái sử dụng chú thích trong thân bài viết đó.

Công cụ

refTools có thể được bật tại Tuỳ chọn → Sửa đổi → Tính năng sẵn dùng. Nó bao gồm cả công cụ kiểm tra lỗi cho các lỗi phổ biến.

Thông báo, không gian tên và thể loại

Các thông báo nội bộ được tạo bởi phần mở rộng Cite và hiển thị dưới dạng thông báo MediaWiki. Xem phần hook của trình phân tích cú pháp tại Đặc biệt:Phiên bản để biết phiên bản Cite được cài đặt. Những trang này nằm trong không gian tên MediaWiki và chỉ có thể được bảo quản viên thay đổi.

Các thông báo MediaWiki sử dụng {{broken ref}} để kiểm soát không gian tên và thể loại. Các thông báo chỉ hiển thị trên các trang (bài viết) chính, thành viên, bản mẫu, thể loại, trợ giúp và tập tin. Các trang thảo luận không hiển thị thông báo lỗi.

Việc xếp thể loại mặc định theo {{PAGENAME}} cho không gian tên chính và theo τ{{PAGENAME}} cho các không gian tên bản mẫu, thể loại, trợ giúp và tập tin.

Xem thêm

• Trợ giúp:Lỗi CS1: Thông báo và cách giải quyết các lỗi xảy ra bên trong chú thích được tạo ra bởi bản mẫu Văn phong Chú thích 1