Bản mẫu:link/doc

Bản mẫu này tạo ra một liên kết trỏ đến một mục từ trong một ngôn ngữ cụ thể. Nó liên kết đến phần ngôn ngữ tương ứng trên trang đích và áp dụng định dạng đặc trưng cho ngôn ngữ đó. Bản mẫu cũng có thể hiển thị nhiều chú thích sau mục từ được liên kết.

Có một số bản mẫu liên kết:

• {{link}} (lối tắt {{l}}). Sử dụng bản mẫu này bên ngoài các đoạn văn bản thông thường, trong các phần liệt kê mục từ như, ví dụ như “Đồng nghĩa”, “Từ liên quan”, và “Từ dẫn xuất”.
• {{mention}} (lối tắt {{m}}). Sử dụng khi một mục từ cụ thể được đề cập đến (chứ không phải được "sử dụng") trong văn bản tiếng Việt liên tục, đặc biệt là trong các phần “Từ nguyên” và “Ghi chú sử dụng”, và đôi khi trong phần định nghĩa.
• {{l-self}}. Sử dụng trong các bảng biến cách và các bản mẫu khác liệt kê nhiều mục từ. Nó hoạt động tương tự như {{link}}, nhưng khi liên kết đến chính trang hiện tại, liên kết sẽ trở thành chữ đậm thay vì là một liên kết thông thường. Điều này mô phỏng hành vi của phần mềm MediaWiki khi liên kết đến cùng một trang, nhưng vẫn có đầy đủ hỗ trợ ngôn ngữ của {{link}}.
• {{m-self}}. Sử dụng trong các bản mẫu đề cập đến nhiều mục từ trong văn bản chính. Nó hiển thị giống như {{mention}}, nhưng hoạt động giống như {{l-self}} khi liên kết đến trang hiện tại.
• {{ll}}. Bản mẫu này tạo ra một liên kết, nhưng không thêm bất kỳ định dạng hoặc chú thích bổ sung nào. Hiện tại vẫn chưa có sự đồng thuận về việc có nên sử dụng bản mẫu này trong các mục từ hay không.

Tất cả các bản mẫu này đều tạo ra liên kết đến phần ngôn ngữ của một mục từ, hoặc nếu sử dụng tham số |id=, chúng sẽ liên kết đến một định danh nghĩa cụ thể được tạo bởi bản mẫu {{senseid}}.

Nếu tham số thứ hai của {{l}}, {{m}}, {{l-self}}, hoặc {{m-self}} chứa liên kết wiki ([[entryname|text]] hoặc [[entryname]]), thì liên kết này sẽ được chuyển đổi thành liên kết trỏ đến phần ngôn ngữ của mục từ đó. Ví dụ, nếu mã ngôn ngữ được cung cấp cho bản mẫu là en, thì the [[word]] sẽ được chuyển đổi thành the [[word#English|word]] và these [[word|words]] sẽ được chuyển đổi thành these [[word#English|words]].

Các chú thích – bao gồm chuyển tự, bản dịch nghĩa, nghĩa đen, và từ loại – được hiển thị trong dấu ngoặc đơn sau mục từ được liên kết bởi {{l}}, {{m}}, {{l-self}}, hoặc {{m-self}}. {{ll}} không hỗ trợ bất kỳ chú thích nào trong số này.

Bản mẫu này sử dụng Module:links làm phần phụ trợ, do đó nó hỗ trợ tất cả các chức năng và xử lý lỗi của mô-đun đó. Xem tài liệu của mô-đun để biết thêm chi tiết.

Tham số

Bản mẫu chấp nhận một vị trí tham số bắt buộc và một số tham số tùy chọn. Lưu ý rằng bạn nên cung cấp một trong hai tham số vị trí thứ hai hoặc thứ ba, mặc dù về mặt kỹ thuật cả hai đều không bắt buộc.

|1= (cần thiết)

Mã ngôn ngữ của mục từ (xem Wiktionary:Ngôn ngữ). Hỗ trợ tất cả các mã ngôn ngữ Wiktionary, bao gồm cả mã cho ngôn ngữ nhân tạo và ngôn ngữ tái tạo.

|2= (tùy chọn)

Tên trang cần liên kết đến. Bản mẫu sẽ tự động loại bỏ các dấu phụ và dấu câu khỏi tiêu đề trang dựa theo cài đặt entry_name trong Module:languages, nhưng vẫn giữ nguyên chúng trong văn bản hiển thị.

• Để liên kết đến một từ tái tạo, ví dụ *dagaz trong tiếng German nguyên thủy, hãy thêm dấu * vào trước tham số này.
• Đối với các hệ chữ viết không phân biệt hoa thường (như Devanagari, chữ Hán, Mông Cổ...), bạn có thể viết hoa các chữ cái trong bản chuyển tự tự động bằng cách đặt dấu ^ trước ký tự tương ứng trong mục từ. Ví dụ, {{l|zh|^西方}} sẽ tạo ra 西方. Xin lưu ý rằng nên được sử dụng tính năng này thay vì đưa ra một bản chuyển tự viết hoa thủ công.
• Có thể liên kết đến các tiêu đề không được hỗ trợ (xem Special:PrefixIndex/Tiêu đề không được hỗ trợ) bằng cách thêm tiêu đề hiển thị, loại trừ tiền tố Tiêu đề không được hỗ trợ/: Ví dụ, {{m|mul|:}} → : liên kết đến Tiêu đề không được hỗ trợ/Colon. Tính năng này được thực hiện nhờ vào danh sách có tại Module:links/data. Để thêm các tiêu đề không được hỗ trợ mới, hãy làm theo hướng dẫn trong mô-đun đó.

|3= (tùy chọn)

Văn bản thay thế sẽ hiển thị làm tiêu đề liên kết, nếu khác với tên trang. Không sử dụng tham số này chỉ để thêm dấu phụ hoặc dấu câu cho từ, vì bản mẫu có thể tự động loại bỏ chúng.

|t= hoặc |4= (tùy chọn)

Định nghĩa hoặc bản dịch ngắn gọn của từ. Tham số |gloss= hiện đã không còn được dùng cho mục đích này.

|sc= (tùy chọn)

Mã chữ viết cho hệ chữ viết của mục từ. Khi không được cung cấp, bản mẫu sẽ cố gắng phát hiện chữ viết dựa trên các ký tự trong mục từ và dữ liệu ngôn ngữ (xem Module:languages § Language:findBestScript). Trong hầu hết các trường hợp, nó sẽ thành công. Nếu thất bại, nó sẽ sử dụng mã None.

|tr= (tùy chọn)

Bản chuyển tự cho các mục từ viết bằng chữ viết không phải Latinh. Khi không được cung cấp, bản mẫu sẽ cố gắng thêm chuyển tự mặc định nếu có thể. Đối với một số ngôn ngữ, chuyển tự tự động có thể ghi đè giá trị của tham số này. Nếu bạn không muốn chuyển tự tự động được tạo, hãy sử dụng tr=- (mặc dù bạn thực sự không nên làm điều này trong các mục từ).

|ts= (tùy chọn)

Phiên âm (gần với cách phát âm thực tế) cho các từ viết bằng hệ chữ viết không phải Latinh, nếu bản chuyển tự khác biệt đáng kể so với phát âm. Không dùng cho phiên âm IPA.

|pos= (tùy chọn)

Nhãn từ loại cho mục từ.

|g=, |g2=, |g3= v.v... (optional)

Giống và số; xem chi tiết tại Module:gender and number.

|lit= (tùy chọn)

Bản dịch nghĩa đen của mục từ.

|id= (tùy chọn)

Định danh nghĩa của mục từ, dùng để liên kết đến một neo trên trang được thiết lập bởi bản mẫu {{senseid}}.

|accel-form= (tùy chọn)

Specifies an accelerated creation tag to be used by the WT:ACCEL gadget, to automatically generate an entry for a non-lemma form when the link is clicked. For information about acceleration tags, see WT:ACCEL#Acceleration tags. You should only provide this parameter when using the linking template as part of a headword-line or inflection-table template. Don't use it directly in entries. If the acceleration tag contains a vertical bar |, use {{!}} instead.

|accel-translit= (tùy chọn)

Specifies a manual transliteration of the non-lemma form for use with accelerated creation of entries; see WT:ACCEL and |accel-form= above. The value of this parameter goes into param |tr= of the call to {{head}} in the accelerated entry. You only need to specify this for languages that use a non-Latin script, and only when the auto-generated transliteration is insufficient, incorrect or nonexistent.

|accel-lemma= (tùy chọn)

Specifies the lemma corresponding to the non-lemma form for use with accelerated creation of entries; see WT:ACCEL and |accel-form= above. The value of this parameter goes into param |2= of the call to {{inflection of}} in the accelerated entry. It defaults to the name of the current page, and only needs to be specified when the lemma contains additional diacritics that are stripped in order to generate the pagename (as in Latin, Russian, Ancient Greek, Old English, etc.).

|accel-lemma-translit= (tùy chọn)

Specifies a manual transliteration of the lemma corresponding to the non-lemma form for use with accelerated creation of entries; see WT:ACCEL and |accel-form= above. The value of this parameter goes into param |tr= of the call to {{inflection of}} in the accelerated entry. You only need to specify this for languages that use a non-Latin script, and only when the auto-generated transliteration is insufficient, incorrect or nonexistent.

|accel-gender= (tùy chọn)

Specifies the gender of the non-lemma form for use with accelerated creation of entries; see WT:ACCEL and |accel-form= above. The value of this parameter goes into param |g= of the call to {{head}} in the accelerated entry. You should only rarely specify this.

|accel-nostore=1

For use with accelerated creation of entries. Place this on links that appear in the collapsed state of collapsible tables; see WT:ACCEL.

Ví dụ

Cách dùng đơn giản:

{{l|cs|háček}}

<span class="Latn" lang="cs">[[háček#Czech|háček]]</span>

háček

Hiển thị văn bản thay thế:

{{l|en|go|went}}

<span class="Latn" lang="en">[[go#English|went]]</span>

went

Đầu vào chứa liên kết wiki:

{{l|en|[[God]] be [[with]] [[you]]}}

<span class="Latn" lang="en">[[God#English|God]] be [[with#English|with]] [[you#English|you]]</span>

God be with you

Loại bỏ dấu phụ:

{{l|la|exemplī grātiā}}

<span class="Latn" lang="la">[[exempli gratia#Latin|exemplī grātiā]]</span>

exemplī grātiā

Từ tái tạo:

{{l|ine-pro|*bʰréh₂tēr}}

<span class="Latn" lang="ine-pro">[[Reconstruction:Proto-Indo-European/bʰréh₂tēr|*bʰréh₂tēr]]</span>

*bʰréh₂tēr

Bản dịch:

{{l|la|similis|t=like}} or {{l|la|similis||like}}

<span class="Latn" lang="la">[[:similis#Tiếng_Latinh|similis]]</span> <span class="mention-gloss-paren annotation-paren">(</span><span class="mention-gloss-double-quote">“</span><span class="mention-gloss">like</span><span class="mention-gloss-double-quote">”</span><span class="mention-gloss-paren annotation-paren">)</span>

similis (“like”)

Ví dụ tổng hợp/nhiều tùy chọn:

{{l|ru|ру́сский||Russian|g=m}}

<span class="Cyrl" lang="ru">[[русский#Russian|ру́сский]]</span> <span class="gender"><abbr title="masculine gender">m</abbr></span> <span class="mention-gloss-paren">(</span><span lang="" class="tr">rússkij</span>, <span class="mention-gloss-double-quote">“</span><span class="mention-gloss">Russian</span><span class="mention-gloss-double-quote">”</span><span class="mention-gloss-paren">)</span>

ру́сский gđ (rússkij, “Russian”)

Use of accelerators (in an inflection-table entry):

{{l-self|ang|{{{dat_pl_f}}}|accel-form=dat{{!}}f{{!}}p|accel-lemma={{{nom_sg_m}}}}}

<span class="Latn form-of lang-ang dat|f|p-form-of origin-{{{nom￰sg￰m}}}" lang="ang">[[:Tiêu đề không được hỗ trợ/`lcub``lcub``lcub`dat`lowbar`pl`lowbar`f`rcub``rcub``rcub`#Tiếng_Anh_cổ|{{{dat_pl_f}}}]]</span>

{{{dat_pl_f}}}

Wikicode

Các bản mẫu {{l}}, {{m}}, {{l-self}}, hoặc {{m-self}} đều thêm các thẻ HTML khi tạo liên kết. {{l|en|word}} tạo ra mã wiki <span class="Latn" lang="en">[[word#English|word]]</span>, và {{m|en|word}} tạo ra <i class="Latn mention" lang="en">[[word#English|word]]</i>. {{l-self}} cũng hoạt động tương tự, nhưng sẽ không tạo liên kết nếu trang được liên kết chính là trang hiện tại. HTML này được áp dụng bởi Module:script utilities; xem Module:script utilities/documentation#tag text để biết thêm chi tiết .

Tùy chỉnh

Kiểu hiển thị mặc định cho các mục từ được đề cập là chữ nghiêng đối với các chữ viết Latinh (không chỉ riêng hệ ngôn ngữ Roman). Để tùy chỉnh nâng cao hơn, độc giả có thể thêm các quy tắc CSS vào stylesheet cá nhân của họ (như hướng dẫn tại WT:CUSTOM:

• Để có định dạng thông thường (ví dụ từ mot + ...):

  .mention-Latn { font-style: normal }

• Để có định dạng chữ đậm (ví dụ từ mot + ...):

  .mention-Latn { font-weight: bold; font-style: normal }

• Để có định dạng chữ nghiêng (ví dụ từ mot + ...):

  .mention-Latn { font-style: italic }

Ngoài ra, kiểu hiển thị mặc định cho các bản dịch nghĩa tiếng Anh đi kèm là dấu ngoặc kép.

Xem thêm

• {{m+}} – Tạo liên kết tương tự {{m}} nhưng kèm theo tên ngôn ngữ.
• {{user}} – để đề cập thành viên
• {{mention-gloss}} ({{m-g}}) – Tạo các dấu ngoặc được định dạng bằng cùng HTML như {{link}} hoặc {{mention}} (cho bản dịch nghĩa).
• {{zh-l}} – Bản mẫu tương tự nhưng dành riêng cho tiếng Trung.
• {{ltc-l}} – Bản mẫu dành riêng cho tiếng Trung Quốc Trung Cổ.
• {{ja-l}} – Bản mẫu dành riêng cho tiếng Nhật.
• {{ko-l}} – Bản mẫu dành riêng cho tiếng Hàn.
• {{th-l}} – Bản mẫu dành riêng cho tiếng Thái.
• {{vi-l}} – Bản mẫu dành riêng cho tiếng Việt.
• {{section link}} – để liên kết đến một mục nào đó trong trang.

Bản mẫu con đặc trưng cho ngôn ngữ

Đối với một vài ngôn ngữ, có các phiên bản hiệu suất cao của bản mẫu này. Chúng thường chấp nhận hai tham số: từ vựng và văn bản thay thế. Một số có thể hỗ trợ chuyển tự, nhưng vì lý do tốc độ, chúng không nên hỗ trợ bất kỳ tham số nào khác. Việc sử dụng các bản mẫu con này đôi khi cần thiết cho các trang có rất nhiều liên kết vì chúng nhanh hơn. Đối với sử dụng thông thường, không cần thiết phải làm vậy và bạn nên sử dụng {{l}} thông thường.

• l/doc
• l/ja/Jpan
• l/vi/Hani
• l/vi/Latn

• link/doc
• link/vi/Hani
• link/vi/Latn

TemplateData

Đây là tài liệu TemplateData cho bản mẫu này, được sử dụng bởi TemplateWizard, VisualEditor và các công cụ khác.

TemplateData cho link

Bản mẫu này tạo ra một liên kết chỉ đến một mục từ trong một ngôn ngữ cụ thể. Nó liên kết đến phần ngôn ngữ tương ứng trên trang đích và áp dụng định dạng đặc trưng cho ngôn ngữ đó. Bản mẫu cũng có thể hiển thị nhiều chú thích sau mục từ được liên kết.

Tham số bản mẫu

Nên dùng bản mẫu này với các tham số đặt trên cùng một hàng.

Tham số		Miêu tả	Kiểu	Trạng thái
Mã ngôn ngữ	1	Mã ngôn ngữ của mục từ (xem Wiktionary:Ngôn ngữ) Hỗ trợ tất cả các mã, bao gồm cả ngôn ngữ nhân tạo và tái tạo. Ví dụ en	Chuỗi dài	bắt buộc
Mục từ cần liên kết	2	Tên trang cần liên kết đến. Ví dụ house	Tên trang	bắt buộc
Văn bản hiển thị	3	Văn bản thay thế hiển thị làm liên kết, nếu khác với tên trang.	Chuỗi dài	khuyên dùng
Dịch nghĩa	4 t gloss	Định nghĩa hoặc bản dịch ngắn gọn cho mục từ.	Chuỗi dài	khuyên dùng
Nghĩa đen	lit	Bản dịch nghĩa đen của mục từ.	Chuỗi dài	tùy chọn
sense ID	id	Sense ID cho mục từ, liên kết đến mỏ neo từ {{senseid}}. Ví dụ Q20502	Chuỗi dài	tùy chọn
Mã chữ viết	sc	(tùy chọn) Mã chữ viết cho hệ chữ viết của mục từ (xem [[Wiktionary:Chữ viết]]). Thường tự động phát hiện, ít khi cần. Khi không được cung cấp, bản mẫu sẽ cố gắng phát hiện chữ viết dựa trên các ký tự trong mục từ và dữ liệu ngôn ngữ, nếu thất bại, nó sẽ sử dụng mã <code>None</code>. Ví dụ Latn	Chuỗi dài	tùy chọn
Từ loại	pos	Nhãn từ loại cho mục từ. Ví dụ noun	Chuỗi dài	khuyên dùng
Chuyển tự	tr	Bản chuyển tự cho hệ chữ viết không phải Latinh. Khi không được cung cấp, bản mẫu sẽ cố gắng thêm chuyển tự mặc định nếu có thể. Đối với một số ngôn ngữ, chuyển tự tự động có thể ghi đè giá trị của tham số này. . Dùng <code>tr=-</code> nếu bạn không muốn chuyển tự tự động được tạo (mặc dù bạn thực sự không nên làm điều này trong các mục từ).	Chuỗi dài	khuyên dùng
Giống và số	g	Giống và số; xem [[Module:gender and number]] để biết thêm chi tiết.	Chuỗi dài	tùy chọn