Help:TemplateData/vi



Dữ liệu bản mẫu là gì?
TemplateData luôn lưu các thông tin về một template và các thông số của nó, do đó VisualEditor có thể truy hồi và hiển thị nó trong template editor, điều này giúp cho việc chỉnh sửa template được dễ dàng hơn.

Cú pháp của Dữ liệu bản mẫu cho phép người dùng viết một ít dữ liệu có cấu trúc vào một trang bản mẫu, hoặc chuyển nó thành trang bản mẫu (như trên một trang bản mẫu tài liệu). Do một bản mẫu có chứa dữ liệu có cấu trúc, nó có thể được hiển thị đúng trong Trình soạn thảo trực quan. Nghe có vẻ khá phức tạp, thực tế nó lại rất dễ.



Trình biên tập Dữ liệu bản mẫu
Có một công cụ cài sẵn cho việc biên tập Dữ liệu bản mẫu theo một cách dễ dàng hơn.

Để sử dụng trình biên tập Dữ liệu bản mẫu, vào trang template (hoặc các trang tài tiệu con của nó) và nhấn vào nút “Sửa đổi”. Khi đó sẽ xuất hiện một nút “”, nằm bên trên cửa sổ biên tập vừa mở: Nhấn chuột vào nút này để vào giao diện biên tập Dữ liệu bản mẫu. Trình biên tập này cho phép bạn thêm vào một hàng trên một thông số bản mẫu và đặt hầu hết các thuộc tính chung. Nếu trang mà bạn biên tập đã chứa một khối Dữ liệu bản mẫu, thì thông tin đã được biên tập sẽ tự động hiển thị lên khi bạn mở đúng trong trong trình biên tập Dữ liệu bản mẫu. Trong hộp đầu tiên, bạn có thể thêm hoặc cập nhật một đoạn miêu tả ngắn về bản mẫu đó trong một đoạn văn bản đơn thuần. Sau đó, bạn có thể sử dụng các nút “Nhập tham số” và “Thêm tham số” để biên tập tên và các thông số của các tham số mà bản mẫu sử dụng.

Bạn có thể liệt kê tên của các tham số, bất kì bí danh nào cho nó, nhãn và miêu tả sẽ được hiển thị cho người dùng. Trường bắt buộc duy nhất là Tên (trường đầu tiên của mỗi hàng), là nơi mà bạn phải ghi chính xác, phân biệt chữ hoa chữ thường của các tham số. Trong trình đơn nổi lên, bạn có thể chọn loại nội dung mà tham số sẽ nhận được, như là một chuỗi (cho các câu trả lời đơn thuần là văn bản), trang (cho các liên kết tới các trang khác), hoặc ngày tháng. Bản mẫu sẽ tạo ra một lỗi nếu tham số này để trống, xin hãy đánh dấu nó là “Bắt buộc”. Nếu tham số là thường sử dụng hoặc khuyến cáo nên dùng, thì đánh dấu là “Khuyến khích”. Nút “Loại bỏ” sẽ xóa nội dung của tham số từ trong Dữ liệu bản mẫu.

Khi bạn kết thúc việc chỉnh sửa mỗi tham số, nhấn chuột vào nút “Áp dụng” để chêm vào Dữ liệu bản mẫu đã định hình sẵn vào hộp biên tập đang mở. Bạn vẫn phải lưu trang này lại, sử dụng nút “Lưu trang” bình thường ở phía dưới cửa sổ biên tập.

Lưu ý: Trình biên tập Dữ liệu bản mẫu sẽ thay Dữ liệu bản mẫu trong hoặc là trang bản mẫu hoặc trong một trang tài liệu con. Bạn xác định nơi mà Dữ liệu bản mẫu sẽ được thêm vào bởi cách mở(biên tập) trang mà bạn muốn Dữ liệu bản mẫu sẽ được đặt vào. Tuy nhiên, nếu nhiều khối Dữ liệu bản mẫu được đặt vào cùng bản mẫu, thì chỉ một trong số khối Dữ liệu bản mẫu sẽ được sử dụng. Nếu đã có một Dữ liệu bản mẫu trong trang này, thì bạn cần phải biên tập trang mà Dữ liệu bản mẫu đã được đặt trước đó để tránh việc tạo thành ngẫu nhiêu nhiều khối Dữ liệu bản mẫu.



Cấu trúc Dữ liệu bản mẫu
Cấu trúc của Dữ liệu bản mẫu dựa trên tiêu chuẩn JSON, và khá là đơn giản. Chú ý rằng toàn bộ các miêu tả trong Dữ liệu bản mẫu phải ở dạng thuần văn bản (không mã wiki, không liên kết, …).

Điều đầu tiên phải là là đánh lại cặp thẻ, bất kể ở đâu trong trang tài liệu con của bản mẫu, như vầy:

Điều này với phần mềm rằng mọi thứ giữa hai thẻ là Dữ liệu bản mẫu, và phải được tham khảo khi bản mẫu được sử dụng.



Ví dụ
Những miêu tả bên trong Dữ liệu bản mẫu tuân theo một bố trí tiêu chuẩn; giả định rằng bạn có một bản mẫu gọi là “Commons” để liên kết tới danh mục Commons về một chủ đề. Nó yêu cầu một tham số bắt buộc: tên của danh mục trong phần Commons. Dữ liệu bản mẫu phải trông giống như vầy:

Danh mục này sẽ hiển thị, trong template, như thế này: {       "description": "Một template để liên kết tới một danh mục chung về một bài viết", "params": { "1": {                       "label": "Danh mục chung", "description": "Danh mục chung mà bạn muốn liên kết tới.", "default": "Category:CommonsRoot", "type": "string", "required": true }       } }



Miêu tả và tham số
Once you're done, hit "save". If you've made errors, it will not let you save (which is disruptive, but means you can't break anything). Should you run into errors, explain on the feedback page what you were trying to do, and we will be happy to help.

Note that each bit of information is enclosed in quotation marks (except for  and  ), and separated from the next bit by a comma (unless it's the last one).



Parameter aliases
Some templates allow a same parameter to have different names.

For example,  could also be written as   or.

To add this information to TemplateData, you simply need to add the aliases to the parameter's information:



Auto value
You can specify an "autovalue" for a parameter. When users add the template to a page, this value will be added automatically. For example, many clean-up templates need to have the date added; if you specify an autovalue for the template's date parameter, then the date will be filled in automatically.

To add this information to TemplateData, simply add the autovalue to the parameter's information. You will probably want to use  to make the values stick:



Multiple parameters
If you have multiple parameters, just repeat each section (starting from the "1" tag) and fill it out as you see fit. Note that if a template has multiple parameters, you need to separate them with a comma in the templatedata, like so:



Similar parameters
When a template has multiple parameters, sometimes some of them can be of the same kind. In this case, you only need to provide full properties for the first one, and the others can "inherit" their properties from it.



Blank boilerplate
You can copy the blank boilerplate below to add new TemplateData to a template. Only the most common tags are included.



Limitations and questions

 * Missing features — TemplateData is very much an example of tool that was made available with few features, in hope that users would help to guide development of features that they desired. If you'd like to request new features for TemplateData, please let us know.
 * Delays in showing in templates — After adding TemplateData to a template, the metadata should be visible immediately when the template is opened in VisualEditor. However, it is possible that it takes hours before the metadata show. You can force an update by making a null edit to the template page itself (not the documentation subpage). To perform a null edit, open the template page for editing, and save the page without making any change.
 * Current issues — A list of current bugs and feature requests is available in bugzilla.



Các công cụ khác

 * TemplateDataEditor — Một kịch bản cá nhân khiến quá trình thêm Dữ liệu bản mẫu dễ dàng hơn. Hiện tại nó có trong tiếng Pháp (bao gồm các bản dịch tiếng Anh, Ý, Nhật, Hàn), và có thể dễ dàng dịch sang các ngôn ngữ khác.
 * TemplateData Wizard — Một công cụ tạo ra Dữ liệu bản mẫu thông qua một giao diện tương tác.
 * Skeleton TemplateData generator — Một công cụ đọc mã nguồn wikicode của một template, cố gắng tìm tất cả các tham số đã sử dụng và xuất ra một tài liệu sường với các tham số được liệt kê.
 * JSONLint — Một công cụ cho phép bạn hợp lệ hóa JSON tự viết để tìm các lỗi trong cú pháp.
 * Danh sách toàn bộ các bản mẫu có Dữ liệu bản mẫu trên wiki này