Bản mẫu:Hộp thông báo bài viết

Văn thư lưu trữ mở Wikisource
Buớc tưới chuyển hướng Bước tới tìm kiếm
[sửa] Template-info.svg Tài liệu bản mẫu
Information icon.svg Tiêu bản này sử dụng các đặc trưng phức tạp trong cú pháp tiêu bản.
Bạn được khuyến khích làm quen với việc thiết lập nó và các hàm phân tích cú pháp trước khi sửa đổi tiêu bản. Nếu sửa đổi của bạn gây ra các vấn đề không được dự báo trước, đề nghị hủy bỏ nó ngay, do tiêu bản này có thể xuất hiện trên nhiều trang.
Ghi nhớ rằng bạn có thể thực hiện các thử nghiệm, và chỉ nên thí nghiệm mọi cải tiến, trong hoặc chỗ thử tiêu bản chung hoặc không gian người sử dụng của bạn trước khi thay đổi bất kỳ điều gì ở đây.

Đây là siêu bản mẫu ambox hay hộp thông báo bài viết.

Nó được sử dụng để tạo ra các bản mẫu hộp thông báo bài viết, như {{wikify}} v.v. Nó cho phép một vài lựa chọn màu, sử dụng các hình ảnh mặc định nếu không có tham biến về hình ảnh được đưa vào và có một vài đặc trưng khác.

Siêu bản mẫu này chỉ là lớp bao bọc mỏng cho các lớp ambox CSS trong MediaWiki:Common.css. Các lớp cũng có thể sử dụng trực tiếp trong wikitable, đặc biệt khi cần dùng cụ thể chức năng này. Xem hướng dẫn cho điều này.

Lưu ý:

Nếu hai hộp trông không giống nhau, bạn cần làm mới bộ nhớ đệm trong trình duyệt web của bạn:

Hộp mã chuẩn.

Đây là vấn đề cache tạm thời và sẽ mất đi sau một khoảng thời gian nào đó.

Sử dụng[sửa]

Ví dụ sử dụng đơn giản:

{{hộp thông báo | chữ = Văn bản gì đó.}}


Ví dụ sử dụng phức tạp:

{{hộp thông báo
| loại  = văn phong
| hình = [[Hình:Icon apps query.svg|38px]]
| chữ  = Nội dung văn bản thông điệp.
}}

Hình ảnh mặc định[sửa]

Các ví dụ sau sử dụng các tham biến loại nhưng không sử dụng tham biến hình ảnh vì thế chúng sử dụng các hình ảnh mặc định cho mỗi kiểu.

Hộp thông báo này đang sử dụng một tham số “loại=nghiêm trọng” sai quy cách và cần được sửa chữa.
Hộp thông báo này đang sử dụng một tham số “loại=hợp nhất” sai quy cách và cần được sửa chữa.

Hình ảnh khác[sửa]

Các hình ảnh mặc định chỉ ra trên đây là thuận tiện nhất. Tuy nhiên, trong nhiều trường hợp thì việc sử dụng các hình ảnh cụ thể hơn sẽ là thích hợp hơn. Các ví dụ này sử dụng tham biến hình để chỉ rõ hình ảnh được dùng thay vì hình ảnh mặc định.

Hộp thông báo này đang sử dụng một tham số “loại=hợp nhất” sai quy cách và cần được sửa chữa.

Đặc biệt[sửa]

Một vài tổ hợp tham biến khác.

Các tham biến[sửa]

Danh sách các tham biến:

{{hộp thông báo
| loại  = nghiêm trọng / nội dung / văn phong / hợp nhất / chú ý
| hình = không / trống / [[Hình:Some image.svg|40px]]
| hình phải = [[Hình:Some image.svg|40px]]
| chữ  = Nội dung văn bản thông điệp. 
}}

loại

Nếu không đưa vào tham biến loại thì bản mẫu mặc định lấy theo loại chú ý, được sử dụng cho "thông báo về bài viết". Điều đó có nghĩa là nó có thanh dọc mé trái màu xanh lam tương tự như trong ví dụ sử dụng đơn giản trên đây.

hình

Không tham số = Nếu không có tham biến hình 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 biến loại 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 là đẹ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ụ:
[[Hình:Unbalanced scales.svg|40px]]
không = Nghĩa là không dùng hình.
trống = Nghĩa là không dùng hình nhưng một khoảng trống cùng kích thước với hình mặc định được sử dụng, điều này làm cho văn bản của hộp thông điệp được căn lề tương xứng với các hộp thông điệp khác về bài viết. (Xem các ví dụ "Đặc biệt" trên đây.)

hình phải

Không tham số = Néu không đưa ra tham biến hình phải thì ở mé phải của hộp thông điệ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 là đẹ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ụ:
[[Hình:Nuvola apps bookcase.png|40px]]
Bất kỳ thứ gì = Bất kỳ thứ gì mà bạn muốn thể hiện ở mé phải hộp thông điệp.

chữ

Nội dung văn bản thông điệp.

Các chi tiết kỹ thuật[sửa]

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

{{hộp thông báo
| chữ  = <div>
Dấu bằng = và dấu ngoặc móc đóng và mở { } hoạt động bình thường.
Nhưng ở đây dấu suyệt đứng {{!}} và dấu móc kép <nowiki>}}</nowiki>. 
Và giờ là dấu suyệt đứng và các dấu móc đóng <nowiki>|}}</nowiki>.
</div>
}}

Xem thêm[sửa]