Bản mẫu:Hộp thông báo thể loại

Tài liệu bản mẫu

Siêu bản mẫu hộp thông tin
bản mẫu	dùng cho
{{Hộp thông báo}}	bài viết
{{hộp thông báo thể loại}}	thể loại
{{Hộp thông báo hình}}	hình
{{Hộp thông báo thảo luận}}	thảo luận
{{Fmbox}}	cuối / đầu
{{Ombox}}	các trang khác
{{Mbox}}	auto-detect
{{Hộp sơ khai}}	bài sơ khai
{{Dmbox}}	ghi chú

Đây là {{cmbox}} hay siêu bản mẫu hộp thông báo thể loại.

Nó dùng để tạo bản mẫu hộp thông báo cho các trang thể loại, như {{Thể loại bản mẫu}}. Nó có một số màu sắc khác nhau, dùng hình mặc định nếu không có thông số hình và có một số tính năng khác.

Bản mẫu này hoạt động giống như {{hộp thông báo bài viết}} và dùng cùng thông số.

Cách sử dụng

Cách dùng đơn giản:

{{hộp thông báo thể loại | chữ = Văn bản.}}

Văn bản.

Ví dụ phức tạp:

{{hộp thông báo thể loại
| loại      = văn phong
| hình      = [[hình:Emblem-question-yellow.svg|40px]]
| kiểu      = width: 400px; 
| kiểu chữ  = color: red; font-weight: bold; font-style: italic;
| chữ       = Nội dung văn bản trong hộp.
}}

Nội dung văn bản trong hộp.

Các loại hộp thông báo thể loại

Các ví dụ sau sử dụng các thông số loại khác nhau nhưng không dùng thông số hình vì chúng dùng các hình mặc định khác nhau cho mỗi loại.

loại=xóa nhanh – Các bản mẫu xóa nhanh như {{thể loại trống}}.

loại=xóa – Các bản mẫu xóa như {{cfd}}.

loại=nội dung – Các thông báo và vấn đề lớn, như {{CategorisationDisputedPeople}}.

loại=style – Các thông báo và vấn đề nhỏ, ví dụ {{popcat}}.

loại=thông báo – Các thông báo và chú ý về bất cứ loại nào, cả vĩnh viễn lẫn tạm thời.

loại=di chuyển – thông báo và đề nghị di chuyển, hợp nhất và tách, như {{đổi hướng thể loại}}.

loại=khóa – bản mẫu khóa như {{khóa-nửa}} khi hiện trên trang thể loại.

Hình khác

Những hình mặc định ở trên chỉ để thuận tiện khi sử dụng. Nhiều trường hợp sẽ thích hợp hơn nếu chọn hình cụ thể hơn. Các ví dụ sau sử dụng thông số hình để chỉ định một hình khác với hình mặc định.

loại = văn phong
hình = [[hình:Sub-arrows.svg|40px]]
Hình này dùng trong {{verylarge}} và {{CatDiffuse}}.

loại = di chuyển
hình = [[hình:Redirect arrow.svg|52px]]
Hình này dùng cho {{thể loại đổi hướng}}.

Đặc biệt

Một số kết hợp thông số khác.

Không có loại và hình (mặc định)

Không có loại và hình=không – Không có hình và chữ dùng toàn bộ khu vực hộp thông báo.

hình = [[hình:Gnome globe current event.svg|42px]]
hình phải = [[hình:Nuvola apps bookcase.svg|40px]]

Thể loại này liệt kê các bài viết về chuyến bay không gian hiện tại và tương lai.
Nó có trong bản mẫu {{current spaceflight}}.

Thông số

Liệt kê mọi thông số:

{{hộp thông báo thể loại
| loại  = xóa nhanh / xóa / nội dung / văn phong / thông báo / di chuyển / khóa
| hình  = không / [[hình:Some image.svg|40px]]
| hình phải = [[hình:Some image.svg|40px]]
| kiểu = Giá trị CSS
| kiểu chữ  = Giá trị CSS
| chữ   = Nội dung văn bản trong hộp. 
}}

loại

Nếu không có thông số loại bản mẫu mặc định sẽ là loại thông báo. Tức là có hình nền màu xanh biển.

hình

Không thông số = Nếu không có thông số hình bản mẫu sử dụng hình mặc định. Hình nào mặc định thì tùy vào thông số loại.

Một tấm hình = Là hình với ký hiệu wiki thông dụng. Rộng 40px - 50px thường thích hợp tùy thuộc vào tỷ lệ cao rộng của hình. Ví dụ:

hình = [[hình:Sub-arrows.svg|40px]]

không = Có nghĩa không sử dụng hình.

hình phải

Không thông số = Nếu không có thông số hình phải tức là không có hình bên phải.

Một tấm hình = Là hình với ký hiệu wiki thông thường. Rộng 40px - 50px thường thích hợp tùy thuộc vào tỷ lệ cao rộng của hình. Ví dụ:

hình phải = [[hình:Nuvola apps bookcase.png|40px]]

Bất cứ thứ gì khác = Bất cứ thứ gì bạn muốn hiện ở bên phải.

kiểu

Giá trị CSS tùy chọn dùng cho toàn bộ bảng chứa hộp thông tin. Không có dấu " ". Ví dụ:

kiểu = margin-bottom: 0.5em;

kiểu chữ

Là giá trị CSS tùy chọn dùng cho ô chữ. Ví dụ:

kiểu chữ = text-align: center;

chữ

Nội dung văn bản trong hộp.

Chi tiết kỹ thuật

Nếu bạn cần dùng các ký tự đặc biệt trong thông số chữ thì bạn cần phải thoát chúng ra như sau:

{{hộp thông báo thể loại
| chữ   = <div>
Dấu bằng = và dấu ngoặc móc đơn { } sẽ hoạt động bình thường.
Nhưng ở đây một dấu sổ dọc {{!}} và hai dấu đóng ngoặc móc <nowiki>}}</nowiki>. 
Và giờ là dấu sổ dọc và các dấu đóng ngoặc móc <nowiki>|}}</nowiki>.
</div>
}}

Dấu bằng = và dấu ngoặc móc đơn { } sẽ hoạt động bình thường. Nhưng ở đây một dấu sổ dọc | và hai dấu đóng ngoặc móc }}. Và giờ là dấu sổ dọc và các dấu đóng ngoặc móc |}}.

Bản mẫu nàu sử dụng lớp CSS cmbox trong MediaWiki:Common.css để được hiển thị, do đó nó có thể thay đổi theo hình dạng.

Bên trong, siêu bản mẫu này sử dụng mã HTML thay vì mã wiki để viết mã bảng. Đây là cách thông dụng để viết siêu bản mẫu vì mã wiki có một số nhược điểm. Ví dụ nó làm khó dùng hàm cú pháp và các ký tự đặc biệt trong thông số hơn.

Các hình mặc định cho siêu bản mẫu ở định dạng png thay vì svg. Lý do chính là một số trình duyệt web cũ hơn có vấn đề với hình nền trong suốt mà bộ phân giải MediaWiki sử dụng cho hình svg. Hình png có màu nền trong suốt đã được tối ưu hóa cho nên nó trông tốt với mọi trình duyệt. Chú ý là các biểu tượng svg chỉ trông xấu ở các trình duyệt cũ, do đó việc tối ưu hóa bằng tay này chỉ gặp rắc rối với các biểu tượng được dùng rộng rãi.

Xem thêm

Các siêu bản mẫu khác cùng trong gia đình Mô đun:Message box

• {{Hộp thông báo}} (Ambox) – dùng cho không gian tên Chính (bài viết)
• {{Hộp thông báo thể loại}} (Cmbox) – dùng cho không gian tên Thể loại
• {{Hộp thông báo thảo luận}} (Tmbox) – dùng cho không gian tên Thảo luận
• {{Hộp thông báo hình}} (Imbox) – dùng cho không gian tên Tập tin
• {{Fmbox}} – các hộp thông báo dạng footer và header
• {{Ombox}} – dùng cho các không gian tên khác (Thành viên, Wikipedia,…)
• {{Hộp thông báo}} (Mbox) – tự động kiểm tra không gian tên, dành cho hộp thông báo được sử dụng tại nhiều không gian tên và do đó cần thay đổi kiểu tùy vào trang chúng được dùng

Siêu bản mẫu tương tự:

• {{Hộp sơ khai}} (Asbox) – siêu bản mẫu dành cho hệ thống bản mẫu sơ khai.
• {{Dmbox}}, for messageboxes on disambiguation or set-index pages.
• {{Ivmbox}}, a simple full-width box with default ivory background intended to frame important messages or notices.