Tiêu bản:Hộp thông báo

[sửa] Tài liệu tiêu bản

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 tiêu bản ambox hay hộp thông báo bài viết.

Nó được sử dụng để tạo ra các tiêu bản 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 tiêu bản 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:

Đâ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ửa] Sử dụng

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

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

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

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

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

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.

Loại=nghiêm trọng – Vấn đề xóa bài, chẳng hạn như {{chờ xóa}} và {{mời biểu quyết}}.

Loại=nội dung – Vấn đề nội dung, chẳng hạn như {{Thái độ trung lập}} và {{Tầm nhìn hẹp}}.

Loại=văn phong – Vấn đề văn phong, chẳng hạn như {{cần dọn dẹp}} và {{wiki hóa}}.

Loại=hợp nhất – Hợp nhất, chia cắt và đề xuất chuyển sang dự án wiki khác, chẳng hạn như {{chia}} và {{Di chuyển đến Wiktionary}}.

Loại=chú ý – Thông báo về bài viết, chẳng hạn {{đang diễn ra}} và {{đang sửa đổi}}.

Loại=khóa – Đánh dấu rằng bài viết được khóa, chẳng hạn {{bảo vệ phân nửa}}.

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

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.

Loại =nội dung hình = [[Hình:Unbalanced scales.svg|40px]] Hình ảnh này thông thường được dùng cho {{POV}} và các vấn đề tương tự.

Loại = văn phong hình = [[Hình:Wikitext.svg|50px]] Hình ảnh này thông thường được dùng cho {{wikify}} v.v.

Loại =hợp nhất hình = [[Hình:Merge-arrows.svg|50px]] Hình ảnh này được dùng cho {{hợp nhất}} v.v.

[sửa] Đặc biệt

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

Không đưa ra kiểu và hình ảnh (mặc định)

Không đưa ra kiểu và hình=trống – Tạo ra một vùng trống cùng kích thước như của hình mặc định. Làm cho văn bản được dóng hàng đẹp với các hộp thông điệp khác.

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

Bài này hoặc đoạn này nói về chuyến bay vào vũ trụ đang diễn ra. Nội dung bài có thể bị thay đổi trong quá trình diễn ra chuyến bay.

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

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ì tiêu bản 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ì tiêu bản 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.

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

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

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 }}. Và giờ là dấu suyệt đứng và các dấu móc đóng |}}.

[sửa] Xem thêm

• Wikipedia:Lớp CSS cho hộp thông báo – Miêu tả việc sử dụng các lớp ambox CSS trực tiếp trong các wikitable và bảng HTML.
• Wikipedia:Hộp thông điệp về bài viết - Chỉ dẫn kiểu cách (đề xuất) cho việc tạo ra các hộp thông điệp về bài viết.
• en:Wikipedia talk:Article message boxes - Thảo luận về vấn đề này.