Xem mã nguồn của Bản mẫu:Tài liệu/doc

{{Viết tắt bản mẫu|doc}}
{{Phân biệt|Bản mẫu:Trang con tài liệu}}
{{Trang con tài liệu}}
{{Sử dụng nhiều|16752}}
{{stack|{{Lua|Module:Documentation}}}}
<!---- Categories where indicated at the bottom of this page, please; interwikis at Wikidata ---->

Đây là bản mẫu {{Template link with link off|Tài liệu}} được sử dụng trên hầu hết các trang bản mẫu để chứa thông tin tài liệu hướng dẫn của bản mẫu đó.

Để biết hướng dẫn chi tiết về cách thức và thời điểm sử dụng bản mẫu này, hãy xem [[Wikipedia:Tài liệu bản mẫu]].

Bản mẫu này hiển thị hộp tài liệu màu xanh lá cây bạn đang thấy và tự động tải nội dung từ trang con /doc. Nó cũng có thể tải nội dung từ những nơi khác nếu được hướng dẫn.

Bản mẫu này được dùng để trên các bản mẫu và các trang khác được [[:en:Wikipedia:Transclusion|chuyển tải]] lên các trang khác. Nó có thể được sử dụng trong [[:en:Wikipedia:Template namespace|không gian tên bản mẫu]] và hầu hết các [[Wikipedia:Không gian tên|không gian tên]].

Sử dụng bản mẫu này cho phép các bản mẫu được [[Wikipedia:Quy định khóa trang|khóa]] khi cần thiết vẫn có thể cho phép bất cứ ai sửa đổi tài liệu và thể loại.

===Sử dụng===
Thông thường bản mẫu này được sử dụng mà không có bất kỳ tham số nào, được đặt ở dưới cùng của bản mẫu hoặc trang, trong phạm vi {{tag|noinclude}} chứa:

<syntaxhighlight lang="xml+smarty">
<!--Dòng cuối cùng của mã bản mẫu của bạn--><noinclude>
{{Tài liệu}}
<!-- Add categories to the /doc subpage, interwikis to Wikidata, not here -->
</noinclude>
</syntaxhighlight>

Sau đó, bản mẫu này tự động tải nội dung từ trang con /doc của bản mẫu.

Bản mẫu này cũng có thể tải nội dung từ bất kỳ trang nào khác. Như thế này:

<syntaxhighlight lang="xml+smarty">
<!--Last line of your template code--><noinclude>
{{Tài liệu |Bản mẫu:Other page/doc}}
</noinclude>
</syntaxhighlight>

Lưu ý rằng khi tải tài liệu từ một trang không phải là trang cục bộ /doc, việc xử lý các thể loại có thể trở nên khó khăn.

Nội dung cũng có thể được thêm trực tiếp dưới dạng văn bản. Như thế này:

<syntaxhighlight lang="xml+smarty">
<!--Last line of your template code--><noinclude>
{{Tài liệu
 | content =
(một số tài liệu)
}}</noinclude>
</syntaxhighlight>

Khi tham số {{Thông số|content}}/{{Thông số|nội dung}} được sử dụng, hộp tài liệu thường không hiển thị các liên kết [sửa] [làm mới] ở góc trên cùng bên phải. Lưu ý rằng nếu trang /doc tồn tại, một liên kết đến nó vẫn được hiển thị trong hộp liên kết bên dưới hộp tài liệu.

Tham số {{Thông số|1}} và {{Thông số|content}}/{{Thông số|nội dung}} cũng có thể được kết hợp, như thế này:

<syntaxhighlight lang="xml+smarty">
<!--Last line of your template code--><noinclude>
{{Tài liệu |1=Bản mẫu:Any page/doc
| content =
{{Any page/doc |tham số}}
}}</noinclude>
</syntaxhighlight>

Sau đó, tên trang được cung cấp dưới dạng tham số 1 được sử dụng cho các liên kết [sửa] [làm mới] và cho liên kết /doc trong hộp liên kết bên dưới hộp tài liệu. Nhưng tham số '''content'''được sử dụng cho nội dung hiển thị trong hộp tài liệu. Đoạn mã trên có nghĩa là nội dung được bao gồm là {{Template link null|Bản mẫu:Any page/doc{{!}}parameters}}. Trong ví dụ này, một tham số cũng được đưa đến trang /doc đang được tải.

=== Lối tắt ===
Để tự động chèn [[:en:Wikipedia:Noinclude|noinclude tags]], cuộc gọi bản mẫu và nhận xét hướng dẫn, use mã này [[Wikipedia:Thay thế bản mẫu|thay thế]]:<br>

:<code><nowiki>{{subst:doc-code}}</nowiki></code>

===Mẹo===
Mã phải được thêm vào ở dưới cùng của mã bản mẫu, không có khoảng trắng trước {{Tag| noinclude|o}} (sẽ gây thêm không gian trên các trang sử dụng bản mẫu).

Các thể loại áp dụng cho chính bản mẫu nên được thêm vào cuối trang con /doc, bên trong các thẻ {{Tag|includeonly}}. Các liên kết liên mạng áp dụng cho bản mẫu nên được liệt kê tại [[d:|Wikidata]] (xem thêm [[Wikipedia:Wikidata]]).  Đối với các trường hợp phức tạp hơn, xem [[:en:Wikipedia:Template documentation#Categories and interwiki links]].

Nếu trang tài liệu có chứa tags {{tag|includeonly|o}} hoặc {{tag|noinclude|o}}  như một phần của văn bản tài liệu hiển thị, thay thế "<code>&lt;</code>" với "<code>&amp;lt;</code>" hoặc dùng [[Bản mẫu:tag]].

===Đầu đề===
Khi trong không gian tên bản mẫu, bản mẫu này hiển thị tiêu đề này:
:[[File:Test Template Info-Icon - Version (2).svg|32px|link=[[Wikipedia:Tài liệu bản mẫu]]]] '''Tài liệu bản mẫu'''

Trong hầu hết các không gian tên khác, chẳng hạn như "Wikipedia:", nó hiển thị tiêu đề này:
:'''Tài liệu'''

Nhưng khi trên trang Tập tim (hình ảnh), nó hiển thị tiêu đề này:
:'''Tóm tắt'''

Tham số '''heading''' có thể được sử dụng để đặt tiêu đề cho một cái gì đó khác. Như thế này:

:<code><nowiki>{{Tài liệu |heading=Infobox documentation}}</nowiki></code>

Nếu tham số '''heading''' trống nhưng được xác định, sẽ không có tiêu đề nào được hiển thị và không có liên kết [sửa] [làm mới] nào được hiển thị. Như thế này:

:<code><nowiki>{{Tài liệu |heading=}}</nowiki></code>

Tham số '''heading-style''' parameter có thể được cung cấp các giá trị [[CSS|CSS]] tùy chọn. Không có dấu ngoặc kép <code>" "</code> nhưng với dấu chấm phẩy kết thúc <code>;</code>. Ví dụ:
:<code>heading-style=font-size:150%;color:red;</code>

===Hộp liên kết===
Bên dưới hộp tài liệu lớn là một hộp liên kết nhỏ hiển thị một số dữ liệu meta về tài liệu. Hộp liên kết hiển thị những thứ khác nhau tùy thuộc vào tham số nào được cung cấp cho bản mẫu này và trong không gian tên được sử dụng. Trong một số trường hợp, hộp liên kết hoàn toàn không hiển thị.

Để ẩn hộp liên kết, thêm tham số
: {{Thông số|link box|off}}.

Bạn cũng có thể chèn văn bản tùy chỉnh vào hộp liên kết, bằng cách đặt tham số {{Thông số|link box}}. Ví dụ:
<pre style="width:auto; overflow:scroll">
  |link box=Tài liệu này được tạo tự động bởi [[Bản mẫu:Country showdata]]
</pre>

===Chức năng tự động===
Nếu trang tài liệu không tồn tại, liên kết [tạo] bao gồm một trang [[mw:Manual:Creating pages with preloaded text|tự động tải]] để nhấp vào nó sẽ điền trước biểu mẫu chỉnh sửa với định dạng trang tài liệu cơ bản. Tải trước văn bản cũng được sử dụng cho các liên kết [tạo] / sandbox và /testcases.

Khi bản mẫu này nằm trên trang bản mẫu được bảo vệ, giờ đây nó sẽ tự động thêm {{tl|Khóa-bản mẫu}}, trong đó cho thấy ổ khóa màu xám hoặc khác ở góc trên bên phải. Vì vậy, không cần phải thêm thủ công {{tl|Khóa-bản mẫu}} vào bản mẫu sử dụng {{tl|Tài liệu}}.

Khi bản mẫu này nằm trên trang con /sandbox, nó sẽ tự động thêm {{tl|Template sandbox notice}}.

===Không gian tên mục tiêu so với không gian tên thảo luận===
Thuật ngữ: ''Không gian tên mục đích'' trái ngược với ''không gian tên thảo luận''. Ví dụ: "Bản mẫu:" là không gian mục đích của "Thảo luận bản mẫu:".

Mẫu này thường được đặt trong một không gian tên mục đích, trong {{tag|noinclude|o}} tags. Nhưng trong một số trường hợp, bản mẫu này cần phải có trên trang thảo luận:

* Trong không gian tên Mediawiki, vì {{tag|noinclude o}} thường không hoạt động trong các thông báo hệ thống và vì không gian tên Mediawiki cần được giữ sạch vì lý do hiệu suất.

Khi được đặt trên các trang thảo luận, bản mẫu này thường được đặt ở gần đầu trang và không có {{tag|noinclude}} tags.

The /doc, /sandbox and /testcases các trang thường phải ở trong không gian tên mục tiêu, ngoại trừ trong các không gian tên không có MediaWiki [[meta:Help:Link#Subpage feature|chức năng trang con ]] được mở: Chính, Tập tin, Mediawiki và Thể loại. (Nhưng hiện tại chúng tôi chỉ hiển thị các liên kết /sandbox và /testcase từ các không gian tên thành viên, thảo luận thành viên, Bản mẫu và Thảo luận bản mẫu.) Ngoài ra còn có một loạt các lý do kỹ thuật khác tại sao trang /doc phải được lưu trữ dưới trang thảo luận cho những người đó (nhưng chỉ những) không gian tên.
Bản mẫu này tự động trỏ các liên kết [tạo] của nó cho /doc, /sandbox và /testcase vào không gian tên bên phải.

===Thử===
Bạn có thể mô phỏng đầu ra cho một trang nhất định bằng cách sử dụng tham số {{Thông số|page}}. Ví dụ: nếu bạn sử dụng mã {{Thông số|page|Bản mẫu:Sửa trang khóa}}, bản mẫu sẽ hoạt động chính xác như thể nó ở trên trang [[BẢn mẫu:Sửa trang khóa]], bao gồm hiển thị các tài liệu từ [[Bản mẫu:Sửa trang khóa/doc]], liên kết đến [[Bản mẫu:Sửa trang khóa/sandbox]], etc. Tham số này hữu ích để thử nghiệm và được sử dụng rộng rãi trên [[Module:Documentation/testcases|trang thử nghiệm mô-đun]]. 

===Thông tin kĩ thuật===
Trang tải trước cho liên kết / doc [tạo] là [[Bản mẫu:Tài liệu/preload]]. Các trang tải trước cho các liên kết / sandbox và / testcase [tạo] là [[Bản mẫu:Tài liệu/preload-sandbox]] và [[Bản mẫu:Tài liệu/preload-testcases]]. Trang tải trước cho liên kết / sandbox [sao] là [[Bản mẫu:Tài liệu/mirror]].

Để biết thêm chi tiết, xem [[:en:Template talk:Documentation|trang thảo luận]].

====Tất cả tham số====
<pre>
{{Tài liệu}}

{{Tài liệu
 | content =
}}

{{Tài liệu
| [đường dẫn đến trang tài liệu]
| heading-style = 
| heading = 
| link box = 
}}
</pre>

===Xem thêm===
* {{tl|Trang con tài liệu}}, một thông báo được đặt ở đầu trang con /doc giải thích vai trò của nó và bao gồm một liên kết đến trang mà nó ghi lại.
* {{tl|Barnstar documentation}}, một biến thể của {{tl|Documentation}} để sử dụng với bản mẫu [[Wikipedia:Barnstars|barnstar]].
* {{tl|Documentation/color scheme}} trình bày bảng màu được sử dụng bởi {{tl|Documentation}}.
* [[Wikipedia:Tài liệu bản mẫu]] là một hướng dẫn cách làm tài liệu bản mẫu.
* [[:en:Wikipedia:Template sandbox and test cases]] explains the use of /sandbox and /testcases subpages and includes more information about template testing.
* [[:en:User:Technical 13/Scripts/editTemplateNoDoc.js]], a beta script that enables documentation to be hidden by default when editing templates.

<includeonly>{{When pagename is |/sandbox= |/testcases= |other=
<!---- Categories below this line, please; interwikis to Wikidata ---->
[[Thể loại:Tài liệu bản mẫu| ]]
[[Thể loại:Bản mẫu không gian tên Bản mẫu]]
}}</includeonly>