Trang trợ giúp này là một hướng dẫn. Nó là một hướng dẫn chi tiết các cách thực hiện quy chuẩn của Wikipedia và không phải là quy định, bởi vì nó chưa được cộng đồng xem xét một cách kỹ lưỡng. |
Một hộp thông tin (tiếng Anh: Infobox) là một bảng định dạng sẵn thường được đặt vào góc trên bên phải của một bài viết để tóm tắt một cách nhất quán những lĩnh vực nhất định của bài viết và thỉnh thoảng cũng để tăng cường khả năng định hướng đến các bài viết liên quan. Nhiều hộp thông tin cũng đưa ra các cấu trúc siêu dữ liệu có nguồn gốc từ DBpedia và những người dùng lại bên thứ ba khác. Các tính năng của hộp thông tin nói chung được phát triển từ các taxobox (taxonomy infoboxes – hộp thông tin phân loại) nguyên thủy – thứ do các biên tập viên phát triển để biểu diễn một cách trực quan sự phân loại khoa học của các loài sinh vật.
Việc sử dụng hộp thông tin không phải là bắt buộc hoặc bị cấm ở mọi bài viết. Việc nhúng một hộp thông tin, nhúng hộp thông tin nào và dùng phần nào của hộp thông tin, đều phải được xác định thông qua thảo luận và đồng thuận giữa các thành viên với mỗi bài viết.
Các bản mẫu hộp thông tin có chứa các sự thật hiển nhiên và số liệu của một thể loại thường liên quan đến bài viết. Ví dụ: các loại động vật đều có một mục phân loại khoa học (loài, họ,…) cũng như tình trạng bảo tồn. Thêm một {{taxobox}} vào bài viết về động vật sẽ giúp người đọc tìm thông tin nhanh hơn và so sánh nó với các bài viết khác.
Các bản mẫu hộp thông tin giống như các tờ thông tin và thanh bên trong các bài viết ở tạp chí. Chúng nhanh chóng tóm lược các điểm quan trọng theo một định dạng dễ đọc. Dù sao, chúng cũng không phải là bảng "số liệu" (nói chung) chỉ tóm tắt tài liệu từ một bài viết.Nói cách khác, các thông tin vẫn phải được trình bày trong văn bản chính, bởi vì không phải ai cũng có thể tiếp cận được hộp thông tin. Cụ thể, nếu bản mẫu hộp thông tin ẩn các cột dài của dữ liệu bên trong các bảng đã sập[note 1] thì những người sử dụng công nghệ hỗ trợ (trình đọc màn hình dành cho người khiếm thị) sẽ hoàn toàn mất đi sự hiện diện của họ.
Nhiều hộp thông tin cũng phát ra các siêu dữ liệu chẳng hạn như "vi định dạng" (microformat).
Nhìn chung, dữ liệu trong hộp thông tin nên:
Nhìn chung, dữ liệu trong hộp thông tin không nên:
Có hai bước cơ bản để thêm một hộp thông tin vào một bài viết:
Để sử dụng hộp thông tin trong bài viết, một biên tập viên phải biết tên, các tham số của nó và cách các tham số sắp được sử dụng. Bởi vì hộp thông tin được đặt ở một không gian tên khác với bài viết, sẽ mất một chút thời gian để tìm thấy hộp thông tin bằng tên. Một khi biên tập viên đã tìm được tên, chỉ cần nhìn thẳng vào phần tài liệu của hộp thông tin.
Có hai cách mà biên tập viên thường dùng để xác định hộp thông tin mà người đó cần dùng:
Ví dụ: Bài viết HDMI có chứa một hộp thông tin. Để xác định nó, chỉ cần vào mục sửa mã nguồn của nó:
{{Thông tin cổng kết nối ... }}
Phần "{{Thông tin cổng kết nối
" cho biết phần ngoặc nhọn bao quanh là phần chứa dữ liệu của hộp thông tin "cổng kết nối
". Biên tập viên có thể nghiên cứu phần tài liệu của bản mẫu – bao gồm danh sách các tham số – ở phần không gian tên bản mẫu có dạng Bản mẫu:Thông tin cổng kết nối.
Theo Cẩm nang biên soạn, hộp thông tin nên được đặt lên đầu bài viết và sau bất cứ liên kết đổi hướng hoặc bản mẫu thông báo nào..
Trang tài liệu của hộp thông tin chường chứa một bản mẫu "rỗng" mà người viết có thể chép y hệt vào bài viết. Nó gồm ngoặc nhọn mở ({{
) và đóng (}}
) có chứa tên hộp thông tin và các tham số để biên tập viên điền vào. Biên tập viên sẽ điền giá trị vào bên phải dấu bằng tương ứng với mỗi mục.
Ví dụ:
{{Thông tin nhân vật | tên = | hình = | ghi chú hình = ... | website = }}
có thể được thêm thông tin vào thành:
{{Thông tin nhân vật | tên = Hồ Chí Minh | hình = Ho Chi Minh 1946.jpg | ghi chú hình = Chủ tịch Hồ Chí Minh năm 1946 ... | website = }}
Trong ví dụ này, tên của các tham số ("tên
", "hình
", "ghi chú hình
", "website
") là cố định trong thiết kế của hộp thông tin và dược miêu tả ở phần tài liệu của nó. Một tham số bị viết sai chính tả, viết hoa không đúng hoặc không được hộp thông tin hỗ trợ sẽ không hiển thị ra. Để xem tham số nào có chức năng, hãy nhìn vào phần tài liệu của hộp thông tin. Những cái không được liệt kê ở đó sẽ bị bỏ qua, kể cả khi chúng hoạt động ở những hộp thông tin khác. Nếu bạn muốn một tham số nào đó được thêm vào hộp thông tin nào đó, hãy gợi ý ở trang thảo luận của hộp thông tin.
Phần tài liệu của hộp thông tin cho biết tham số nào là bắt buộc và tham số nào là tùy chọn (không bắt buộc phải điền). Tham số bắt buộc sẽ hiển thị giữa ba dấu ngoặc nhọn đóng và mở (ví dụ: {{{requiredparametername}}}
) khi xem trước hoặc xuất bản. Các tham số tùy chọn có thể sẽ không hiển thị hoặc bị bỏ qua hoàn toàn.
Nếu bạn đã thêm một hộp thông tin và nó không hiển thị một cách bình thường, đây là một số lỗi cơ bản:
ngày_sinh
). Mặc dù đa số các hộp thông tin ở Wikipedia tiếng Việt thường không sử dụng dấu gạch chân trong tên tham số, nhưng vẫn có một số ngoại lệ.Hình:
, Tập tin:
hay File:
trước tên hình ảnh (hoặc bạn không viết vào, nhưng hộp thông tin đó lại cần tiền tố đó).Hình ảnh thường được định nghĩ bởi các tham số hình
và ghi chú hình
. Dù sao thì, mỗi hộp thông tin có thể sẽ dùng tác tên khác nhau đối với tham số này. Ví dụ, {{Thông tin album nhạc}} dùng "Hình" và "Ghi chú hình" thay vì "hình" và "ghi chú hình".
Tham số hình
thỉnh thoảng yêu cầu Wikipedia:Cú pháp hình ảnh mở rộng; còn lại thì nó chỉ yêu cầu tên hình ảnh (tùy thuộc vào "khẩu vị" của viên tập viên đã tạo ra hộp thông tin đó). Một biên tập viên có thể xác định điều này này bằng cách thử nghiệm (sử dụng chức năng "xem trước") hoặc nghiên cứu phần tài liệu của hộp thông tin.
Nhiều hình trong hộp thông tin nên có một văn bản thay thế đặc biệt cho những người không nhìn được ảnh.
Sẽ tốt hơn nếu hỏi ý kiến các biên tập viên khác trước khi thiết kế (hoặc thiết kế lại) một hộp thông tin. Hầu hết các yêu cầu đều đã được đáp ứng bởi một hộp thông tin hiện có và hầu hết các phần còn lại có thể được đáp ứng với một điều chỉnh. Sự trùng lặp không cần thiết dẫn đến sự lộn xộn và phân mảnh bài viết. Hãy trình bày nguyên mẫu thiết kế của bạn ở không gian tên người dùng của bạn. Sau khi trình bày nguyên mẫu, hãy đề nghị thay đổi hộp thông tin ở Wikipedia:Dự án thích hợp và đạt được sự đồng thuận của mọi người trước khi áp dụng nó vào không gian tên bản mẫu.
Các yêu cầu xóa hộp thông tin nên được thảo luận ở Wikipedia:Thảo luận về bản mẫu và bất cứ dự án nào liên quan đến hộp thông tin đó. Một bản mẫu có thể hợp nhất với bản mẫu khác hơn là xóa nó đi.