Bản mẫu:Hộp thông báo hình/doc
Đây là một trang con tài liệu dành cho Bản mẫu:Hộp thông báo hình. Nó gồm có các thông tin hướng dẫn sử dụng, thể loại và các nội dung khác không thuộc về phần trang bản mẫu gốc. |
Bản mẫu này được sử dụng ở khoảng 30.000 trang, vì thế những thay đổi đến nó sẽ hiện ra rõ ràng. Vui lòng thử nghiệm các thay đổi ở trang con /sandbox, /testcases của bản mẫu, hoặc ở không gian người dùng của bạn. Cân nhắc thảo luận các thay đổi tại trang thảo luận trước khi áp dụng sửa đổi. |
Bản mẫu này sử dụng Lua: |
Các siêu bản mẫu hộp thông báo (Mbox) | |
---|---|
{{Ambox}} | bài viết |
{{Cmbox}} | thể loại |
{{Imbox}} | hình |
{{Fmbox}} | thảo luận |
{{Ombox}} | chân / đầu trang |
{{Mbox}} | (auto-detect) |
{{Asbox}} | bài sơ khai |
{{Dmbox}} | trang định hướng |
Đây là siêu bản mẫu {{Hộp thông báo hình}} hay image message box (Hộp thông báo hình).
Nó được dùng để tạo nên những bản mẫu hộp thông báo dành cho các trang hình, như {{cleanup-image}}. Nó có vài màu khác nhau, sử dụng hình mặc định nếu không chỉ định tham số hình và có một số tính năng khác.
Bản mẫu này hoạt động gần như y hệt {{Hộp thông báo}} và sử dụng cùng tham số.
Cách dùng
[sửa mã nguồn]Ví dụ đơn giản:
{{Hộp thông báo hình |text=Some text.}}
Some text. |
Ví dụ phức tạp:
{{Hộp thông báo hình | type = style | style = width:400px; | image = [[File:Emblem-question-yellow.svg|40px]] | textstyle = font-style:italic; font-weight:bold; color:red; | text = The message body text. }}
The message body text. |
Các loại hộp thông báo
[sửa mã nguồn]Các ví dụ dưới đây sử dụng các tham số type khác nhau nhưng không dùng tham số hình ảnh do đó chúng đang dùng hình mặc định cho mỗi loại.
type=speedy – Các bản mẫu xóa nhanh như {{isd}}. |
type=delete – Bản mẫu xóa như {{Bản sao}}. |
type=content – Các cảnh báo và vấn đề lớn, như {{non-free reduce}}. |
type=style – Các cảnh báo và vấn đề nhỏ, như {{Thiếu lời miêu tả}}. |
type=notice – Chú ý và thông báo các loại, cả vĩnh viễn và tạm thời. |
type=move – thông báo di chuyển và đổi tên và các đề nghị, như {{Hiện có tại Commons}}. |
type=protection – bản mẫu khóa như {{Khóa}} khi hiển thị ở trang hình ảnh. |
type=license – bản mẫu giấy phép như {{GFDL}}. |
type=featured – bản mẫu hình chọn lọc như {{Hình ảnh của tuần}}. |
Các hình khác
[sửa mã nguồn]Những hình mặc định ở trên là để cho thuận tiện. Trong nhiều trường hợp sẽ thích hợp hơn nếu dùng các hình cụ thể hơn. Những ví dụ dưới đây sử dụng tham số image để xác định hình khác ngoài hình mặc định.
type = style image = [[File:Gnome-dev-camera.svg|42px]] Hình này được dùng trong {{cleanup-image}}. |
type = move image = [[File:To Commons.svg|52px]] Hình này được dùng trong {{Chuyển sang Commons}}. |
type = license image = [[File:Heckert GNU white.svg|48px]] Hình này được dùng trong các bản mẫu giấy phép GFDL như {{GFDL}}. |
Đặc biệt
[sửa mã nguồn]Vài kết hợp tham số đặc biệt khác.
Không có loại và không có hình (mặc định) |
Không có loại và image=none – Không sử dụng hình và text sử dụng toàn bộ khu vực hộp |
type = license image = [[Hình:PD-icon.svg|40px]] <br> [[Hình:Ambox warning yellow.svg|40px]] hình phải = [[Hình:Shuttle.svg|30px]] |
| Tập tin này nằm trong phạm vi công cộng vì nó được NASA tạo ra.
Chú ý rằng việc sử dụng biểu trưng, con dấu và biểu tượng của NASA bị giới hạn theo luật Hoa Kỳ. |
type = license image = [[File:PD-icon.svg|40px]] below = {{Hộp thông báo hình |type=content |text='''Thẻ quyền này đã lỗi thời!'''}} | |||
|
Các tham số
[sửa mã nguồn]Danh sách tất cả các tham số:
{{Hộp thông báo hình | name = name of the template | type = speedy / delete / content / style / notice / move / protection / license / featured | image = none / [[File:Some image.svg|40px]] | imageright = [[File:Some image.svg|40px]] | style = CSS value | textstyle = CSS value | text = The message body text. | below = More text or another Hộp thông báo hình. | plainlinks = no }}
type
- Nếu không đưa vào tham số type thì bản mẫu mặc định lấy theo loại notice. Có nghĩa là nó có viền màu xanh.
image
- Không tham số = Nếu không có tham số image thì bản mẫu sử dụng hình ảnh mặc định. Hình ảnh mặc định nào được dùng phụ thuộc vào tham số type trên đây.
- Một tấm hình = Phải có hình với ký hiệu wiki thông thường. Độ rộng 40px-50px thường phù hợp nhất, phụ thuộc vào tỷ lệ chiều cao so với chiều rộng của hình. Ví dụ:
image = [[Hình:Gnome-dev-camera.svg|40px]]
- none = Có nghĩa là không sử dụng hình.
imageright
- Không tham số = Nếu không đưa ra tham số imageright thì ở bên phải của hộp sẽ không có hình nào cả.
- Một tấm hình = Phải là hình ảnh với ký hiệu wiki thông thường. Độ rộng 40px-50px thường phù hợp nhất, phụ thuộc vào tỷ lệ chiều cao so với chiều rộng của hình. Ví dụ:
imageright = [[Hình:Nuvola apps bookcase.png|40px]]
- Bất kỳ thứ khác = Bất kỳ thứ nào khác mà bạn muốn hiển thị ở phía phải.
style
- Giá trị CSS tùy chọn dùng cho toàn bộ hộp. Không có dấu
" "
. Ví dụ:style = margin-bottom: 0.5em;
textstyle
- Là giá trị CSS tùy chọn dùng cho chữ trong hộp. Ví dụ:
textstyle = text-align: center;
text
- Nội dung văn bản trong hộp.
below
- Một khoảng không gian với chiều dài đầy đủ nằm phía dưới hình và chữ. Có thể có một nội dung mới hoặc bất kỳ đối tượng nào khác, ví dụ một Hộp thông báo hình khác:
below = {{Hộp thông báo hình |type=content |text=This license tag is deprecated.}}
plainlinks
Chi tiết kỹ thuật
[sửa mã nguồn]Nếu bạn cần sử dụng các ký tự đặc biệt trong tham số chữ bạn cần phải để dấu thoát như sau:
{{Hộp thông báo hình | text = <div> Dấu bằng = và dấu mở đóng ngoặc kép { } hoạt động bình thường. Nhưng ở đây là dấu sổ đứng {{!}} và hai dấu đóng ngoặc <nowiki>}}</nowiki>. Và giờ là dấu sổ đứng và các dấu đóng ngoặc <nowiki>|}}</nowiki>. </div> }}
Dấu bằng = và dấu mở đóng ngoặc nhọn { } hoạt động bình thường. Nhưng ở đây là dấu sổ đứng | và hai dấu đóng ngoặc nhọn }}. Và giờ là dấu sổ đứng và các dấu đóng ngoặc nhọn |}}. |
Bản mẫu này sử dụng các lớp CSS Hộp thông báo hình trong MediaWiki:Common.css để hiển thị hình dáng, do đó nó có thể thay đổi được hình dáng.
Xem thêm
[sửa mã nguồn]Có 7 siêu bản mẫu trong gia đình hộp thông báo (Mbox):
- {{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,…)
- {{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 nơi chúng được dùng.
Siêu bản mẫu có liên quan gần:
- {{Hộp sơ khai}} (Asbox) – siêu bản mẫu dành cho hệ thống bản mẫu sơ khai.
- {{Dmbox}}, cho các hộp thông báo trên các trang định hướng hoặc trang chỉ mục.
- {{Ivmbox}}, một hộp đơn giản có chiều rộng đầy đủ với nền ngà mặc định dành cho các thông điệp hoặc thông báo quan trọng.