Mòdul:enllaç/ús

De Viccionari

Aquesta és la pàgina de documentació per a Mòdul:enllaç

Aquest mòdul proporciona diferents funcions d'utilitat per crear i processar enllaços de wikitext en el Viccionari.

full_link[modifica]

full_link(data, face, allowSelfLink, dontLinkRecons)

Crea un enllaç complet, a l'estil de {{e}} o {{m}}. El primer paràmetre és una taula amb les dades del terme: term (nom de la pàgina), alt (nom alternatiu a mostrar), langcode (codi de llengua), sc (sistema d'escriptura), tr (transcripció), gloss (glossa o traducció). Els següents paràmetres són: tipus de lletra, permetre un enllaç a la mateixa pàgina, permetre un enllaç a reconstruccions. Tots els paràmetres poden ser nil, però es mostrarà un error si no hi ha cap terme, alt o transliteració.

  • Si no es proporciona el sistema d'escriptura, en posa un per defecte per la llengua.
  • Crida language_link amb el terme per treure diacrítics en el nom de pàgina, per les llengües que ho requereixin, i per processar els enllaços inclosos convertint-los en enllaços a la secció de llengua.
  • Crida tag_text per afegir les etiquetes apropiades de llengua i sistema d'escriptura.
  • Afegeix les anotacions (transliteració, gènere, etc.) després de l'enllaç.

format_link_annotations[modifica]

format_link_annotations(terminfo)

Formata anotacions que es mostren amb l'enllaç. Les anotacions són informació addicional que inclou coses com el gènere, transliteració, traducció, etc. El paràmetre és una taula amb alguna de les següents claus:

genders
Taula amb una llista d'especificacions de gènere amb el format indicat a Mòdul:categoria gramatical.
tr
Transliteració.
gloss
Traducció o informació descriptiva.
pos
Categoria lèxica (part of speech).
lit
Significat literal, si no es correspon amb l'accepció.

Tots els valors anteriors es poden ometre en el paràmetre info. Si es proporciona una taula buida (sense cap anotació), llavors retorna una cadena buida.

language_link[modifica]

language_link(terminfo, allowSelfLink)

Crea un enllaç bàsic a la secció de llengua (com ara == Català ==), sense altres anotacions que afegeix tag_text.

Accepta els següents paràmetres:

terminfo
Taula amb la informació indicada a continuació (term, alt, langcode).
terminfo.term
El text a enllaçar. Generalment és el nom d'una pàgina. La cadena pot incloure enllaços wiki. S'afegirà la secció de llengua a cada enllaç.
terminfo.alt
Text alternatiu a mostrar en l'enllaç, si és diferent de la pàgina enllaçada. Si és igual a nil, llavors s'utilitza el paràmetre terminfo.term. Si terminfo.term conté enllaços wiki, aquest paràmetre és ignorat i no té cap efecte.
terminfo.langcode
El codi de llengua a afegir en l'enllaç.
allowSelfLink
Amb valor true enllaça a una secció de la mateixa pàgina. Per defecte és false.

sense_diacritics[modifica]

sense_diacritics(lang, text)

Treu determinats diacrítics que no són apropiats pel títol de pàgina seguint les convencions d'una determinada llengua. Per exemple, en llatí s'inclouen per marcar la pronúncia però no en la forma gràfica del mot.

remove_links[modifica]

remove_links(text)

Substitueix tots els [[enllaços]] pel títol enllaçat com a text simple. Aquesta funció es pot cridar tant des d'una plantilla com des d'un altre mòdul.