Bản mẫu là một tính năng mạnh mẽ của MediaWiki, nhưng cũng là thứ khó hiểu đối với nhiều thành viên.
Trang trợ giúp này là một hướng dẫn. Nó là một hướng dẫn chi tiết các cách thực hiện quy chuẩn của Wikipedia và không phải là quy định, bởi vì nó chưa được cộng đồng xem xét một cách kỹ lưỡng. |
Ngay cả các thành viên có kinh nghiệm đôi khi cũng gặp khó khăn để hiểu được những bản mẫu với cú pháp phức tạp. Vì thế, mỗi bản mẫu thường có một trang tài liệu đi kèm để giải thích thêm, cũng như để hướng dẫn sử dụng.
Tài liệu bản mẫu cần giải thích được mục đích, cách sử dụng của bản mẫu, sao cho để những thành viên không có kiến thức đầy đủ về cú pháp bản mẫu – vốn chiếm số đông thành viên – vẫn có thể sử dụng bản mẫu được đúng cách.
...
nếu chúng nằm tại trang bản mẫu, hoặc giữa cặp thẻ ...
nếu chúng nằm tại trang con tài liệu.Các liên kết ngôn ngữ trước đây cũng thuộc tài liệu bản mẫu, nhưng nay đã được lưu trữ tại Wikidata.
Tài liệu bản mẫu thường được đặt ở trang con của chính bản mẫu đó, sau đó nội dung trang con được nhúng vào và hiển thị ở trang bản mẫu chính. Việc làm này giúp tách rời nội dung hướng dẫn sử dụng ra một trang riêng, rời khỏi mã nguồn của bản mẫu (vốn đã phức tạp). Điều này cho phép các bảo quản viên có thể khoá các bản mẫu khi cần thiết mà vẫn cho phép mọi thành viên cập nhật tài liệu hướng dẫn.
Ngoài ra, cách làm này cũng được các nhà phát triển phần mềm MediaWiki khuyến khích, vì nó giúp cải thiện hiệu năng làm việc của bản mẫu so với cách làm trước đó. Trước đó, phần mã bản mẫu và hướng dẫn sử dụng nằm một chỗ ở ngay trang bản mẫu (với phần văn bản hướng dẫn sử dụng nằm kẹp giữa cặp thẻ
), điều này làm tăng thời gian cần thiết cho phần mềm đọc bản mẫu để hiển thị nó, và không có lợi về mặt kĩ thuật.
Để duy trình tính thống nhất, tài liệu bản mẫu ở Wikipedia tiếng Việt được tạo ở trang con /doc của bản mẫu mà nó thuyết trình. Nghĩa là nếu tên bản mẫu là Bản mẫu:X
, thì trang tài liệu cần được viết ở Bản mẫu:X/doc
.
Cùng lúc đó ở trang bản mẫu chính (Bản mẫu:X
), ở phần kết thúc bản mẫu cần có dòng mã sau:
[--dòng cuối cùng của mã bản mẫu--]{{Tài liệu}}
Đoạn mã này sẽ nhúng trang tài liệu vào bản mẫu, giúp nội dung thuyết trình hiện ra tại trang bản mẫu.
Quan trọng: Cần phải đặt thẻ
ngay sau kí tự cuối cùng của mã bản mẫu, đừng xuống dòng hoặc để thừa ra kí tự trắng nào. Nếu không, kí tự trắng hoặc kí tự xuống dòng thừa vô tình sẽ được nhúng vào tất cả các trang có sử dụng bản mẫu – đây là điều không mong muốn.
Để tạo trang tài liệu bản mẫu, có 2 cách để tạo trang
[Tạo]
trong hộp tài liệu trống, sẽ tự động tạo tài liệu với một mẫu được nhập sẫn trong đó. Nhập nội dung vào đó sau đó lưu để tạo tài liệu bản mẫu.Bản mẫu:X/doc
. Xem chi tiết tại {{Documentation subpage}} hoặc bắt đầu trang bằng cách sao chép và dán văn bản wikitext mẫu sau, nhập nội dung vào đó sau đó lưu để tạo tài liệu bản mẫu:{{Trang con tài liệu}} == Sử dụng == {{sandbox other|| }}
Để tạo một mẫu tham số trống, có thể được sao chép từ tài liệu và dán vào một trang khác, hãy sử dụng:
{{subst:#tag:pre|{{subst:Parameters|code|base={{subst:BASEPAGENAME}}}}|style=overflow: auto;}}
Để tạo một phiên bản ví dụ đầu ra của tham số trong bản mẫu, hãy sử dụng:
{{subst:Parameters|demo|base={{subst:BASEPAGENAME}}|_base=}}
[[Thể loại:Tên thể loại]]
vào bên trong phần mã ...
nằm trong trang con doc.[[Thể loại:Tên thể loại]]
vào bên trong phần mã ...
nằm trong trang bản mẫu. Vị trí chính xác trong mã bản mẫu có thể ảnh hưởng đến việc bản mẫu thêm bài viết vào thể loại.Khi một trang con tài liệu chưa được tạo, có thể dùng tham số |content=
trong {{Tài liệu}} để tạo tài liệu trên chính trang bản mẫu, bạn cũng có thể đặt bản mẫu vào một thể loại bằng cách thêm [[Thể loại:Tên thể loại]]
bên trong bản mẫu tài liệu, sau nội dung. Ví dụ:
{{Tài liệu | content = [[Thể loại:Tên thể loại]] [[Thể loại:Tên thể loại 2]] }}
và
tại MetaThis article uses material from the Wikipedia Tiếng Việt article Wiki:Tài liệu bản mẫu, which is released under the Creative Commons Attribution-ShareAlike 3.0 license ("CC BY-SA 3.0"); additional terms may apply (view authors). Nội dung được phát hành theo CC BY-SA 4.0, ngoại trừ khi có ghi chú khác. Images, videos and audio are available under their respective licenses.
®Wikipedia is a registered trademark of the Wiki Foundation, Inc. Wiki Tiếng Việt (DUHOCTRUNGQUOC.VN) is an independent company and has no affiliation with Wiki Foundation.