Tài liệu bản mẫu[xem] [sửa] [sử] [xóa]

Bản mẫu:High-use Bản mẫu:Lua Bản mẫu:Mbox templates (small) Đâ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í 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.
}}

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.

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.

Đặc biệt

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

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>
}}

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