Template:Senseid/documentation: Difference between revisions

From The Languages of David J. Peterson
Jump to navigation Jump to search
(Created page with "{{documentation subpage}} This template generates link targets for senses. Whenever a page of Wiktionary has multiple senses for each language you can give the sense you want...")
 
No edit summary
 
Line 1: Line 1:
{{documentation subpage}}
{{documentation subpage}}
This template generates link targets for senses. Whenever a page of Wiktionary has multiple senses for each language you can give the sense you want to link to an ID. You can then link to this specific id using a variety of linking templates, with the {{para|id}} parameter of those templates. The template must be placed at the beginning of a definition line or the beginning of a paragraph (with the parameter {{para|tag|p}}). In particular, it must come before any {{template|lb}} context labels, or else it will create a line break after them.
This template generates link targets for senses. Whenever a page of Wiktionary has multiple senses for each language you can give the sense you want to link to an ID. You can then link to this specific id using a variety of linking templates, with the {{para|id}} parameter of those templates. The template must be placed at the beginning of a definition line or the beginning of a paragraph (with the parameter {{para|tag|p}}). In particular, it must come before any {{template|lb}} context labels, or else it will create a line break after them.
'''Recommended:''' You can also use this template via the graphical editor by [[User:Yair_rand]], which you can find under preferences -> Gadgets -> Enable definition editing options.


This template uses [[Module:senseid]] and [[Module:senseid/templates]] as a back-end.
This template uses [[Module:senseid]] and [[Module:senseid/templates]] as a back-end.

Latest revision as of 13:01, 5 July 2023

Documentation for Template:Senseid. [edit]
This page contains usage information, categories, interwiki links and other content describing the template.

This template generates link targets for senses. Whenever a page of Wiktionary has multiple senses for each language you can give the sense you want to link to an ID. You can then link to this specific id using a variety of linking templates, with the |id= parameter of those templates. The template must be placed at the beginning of a definition line or the beginning of a paragraph (with the parameter |tag=p). In particular, it must come before any {{lb}} context labels, or else it will create a line break after them.

This template uses Module:senseid and Module:senseid/templates as a back-end.

When using this template with |tag=p you will also need to use {{senseid-close|tag=p}} at the end of the relevant paragraph of definition. This is to ensure the correct markup is generated.

Parameters

|1=
The language code (see Wiktionary:Languages) of the current language section.
|2=

The ID that you want to assign to the current sense. This can be anything, and can include spaces. (Apostrophes may not work for link resolution.) Keep it short and concise, as it will have to be typed verbatim by anyone who wants to create a link to this sense. Also make sure to choose something that will not need to be changed in the future, because if the ID is changed later, all links that point to it will break.

When using the template in an English entry, the translation table corresponding to this sense should be given an |id= argument with the same ID as this sense.

Wikidata item ID's can be used as sense ID's; see below for more information.

|tag=
Tag name. Default is li. Do not specify this parameter when the template is used in a definition line or other list. Specify |tag=p when the template is used in a regular paragraph of text, as in an etymology section (but consider using {{etymid}} instead).

Examples

For example you want to add a sense ID to the English word "house" in the sense of a "house music", you can {{senseid}} to the sense:

# {{senseid|en|genre of music}} [[house music|House music]].

resulting in

  1. House music.

Now, when you want to link to this sense from within Wiktionary, you can use the |id= parameter on, for example, {{l}} or {{m}}:

{{m|en|house|id=genre of music}}

The URL to the link will look like this:

https://en.wiktionary.org/wiki/house#English:_genre_of_music

The result is:

house

Since this is an English entry, the translation table should be tagged with a matching ID.

In some cases it may be desired to provide a numbered link to a specific sense, on the entry for the word itself. Examples could be in image captions or usage notes. You can use {{senseno}} for this. For example, on the entry fork:

{{senseno|en|tool for laboring}}

The result is:

sense Script error: No such module "senseno".

Using Wikidata item IDs

Wikidata is a repository for structured data about just about anything. In some cases, a sense on Wiktionary will refer to something that Wikidata has an item on. In that case, it is possible to use the Wikidata ID (Q followed by numbers) as the senseid. For example, for the music style demonstrated above, one could use {{senseid|en|Q20502}}, with Q20502 being the ID of the Wikidata item for house music. This not only establishes a conceptual link between the Wiktionary sense and Wikidata item, but also establishes that all senses with that senseid anywhere on Wiktionary with that senseid are synonyms. In the future, the {{senseid}} template may be extended to query Wikidata itself as well.

Keep in mind that Wikidata ids should only be used when the sense matches exactly. This will mean that a Wikidata ID should only be used on nouns, as Wikidata items are generally "things" or "concepts" which are noun-like in nature. It is unclear how such ID's should be interpreted for other parts of speech, for example the adjective green with the Wikidata item Q3133 about this colour. Moreover, green is both a noun and an adjective, and senseids must be unique per language per page, so you can't use the same senseid Q3133 twice on the page, and it is not clear whether it belongs on the noun or the adjective sense.

Use with affixes

The templates {{affix}}, {{suffix}} and such use the |idN= parameter to disambiguate the categories for various homographical affixes. When the parameter is provided on these templates, then in addition to linking to the correct sense ID anchor, the derivations category name is also modified to include this ID. For example, {{affix|la|habeō|-tus|id2=action noun}} will link to the "action noun" sense id on the page -tus, but it will also place the entry in the category Category:Latin terms suffixed with -tus (action noun) rather than the plain Category:Latin terms suffixed with -tus.

Use in regular wikilinks

The format of the anchor generated by this template is LanguageName:_id, such that {{senseid|en|leading or managerial position in certain organizations}} in the entry for secretary can be linked to using [[secretary#English:_leading or managerial position in certain organizations|secretary]].

TemplateData

This is the TemplateData documentation for this template used by VisualEditor and other tools.

TemplateData for Senseid

Anchors a sense ID tag on the entry for the term to aid entries referring to a specific sense of the word, phrase or morpheme.

Template parameters[Edit template data]

This template prefers inline formatting of parameters.

ParameterDescriptionTypeStatus
Language code1

The language code of the current entry

Example
en
Stringrequired
Sense ID2

The ID that you want to assign to the current sense. This can be anything, and can include spaces. Make sure to choose something that will not need to be changed in the future, because if the ID is changed later, all links that point to it will break. See template page for more

Example
music genre
Linerequired