Axuda: Modelo

Da Wikipedia, a enciclopedia libre.
Ir á navegación Ir á busca
TIPOS DE PÁXINA
Elemento · Fío ( barra )
Categoría · Portal
Ficheiro ( imaxe · son )
Páxina de servizo
Modelo ·Pauta
Proxecto · Páxina de usuario
Módulo
Todos os espazos de nomes
Abreviaturas
WP: TL
WP: Tl

En Wikipedia, un modelo [1] é unha páxina especial creada para ser incluída noutras páxinas a través do mecanismo de inclusión .

Pode usarse para varios fins:

  • insira facilmente texto repetido en diferentes páxinas, escribíndoo unha vez, como para os modelos de navegación
  • inserir elementos estándar, táboas de información ou avisos
  • inserir elementos cuxo comportamento pode programarse segundo algunhas variables.

Os modelos están contidos no modelo de espazo de nomes (ou nome 10), é dicir, o espazo de nomes cuxas páxinas teñen a forma " Modelo: NOME " (por exemplo: Modelo: S , Modelo: Benvido , Modelo: Europa ).

Para referirse a un modelo tamén pode usar a abreviatura T, por exemplo. t: Europa .

Gnome-help.svg - Mesa de información

Inserción

Icona de lupa mgx2.svg O mesmo tema en detalle: Axuda: inclusión .
Exemplo de inclusión

Todas as páxinas pertencentes ao espazo de nome 10 pódense inserir rapidamente nunha páxina, simplemente escribindo o nome do modelo (a parte que segue o modelo: texto) entre dobres corchetes [2] , como en {{ NAME }}. Esta referencia no wikitexto fai que se insira o contido do modelo cando se amosa a páxina.

Se a páxina "Modelo: nome " non existe, entón {{ nome }} funciona como [[Modelo: nome ]], unha ligazón a unha páxina inexistente, que leva á páxina de edición.

Non está permitido inserir modelos inexistentes.

Se o modelo non está no espazo de nomes adecuado (porque aínda se está traballando ou porque é unha inserción doutra páxina) pódese usar de calquera xeito, introducindo o nome co camiño completo (por exemplo {{usuario: NOME) APELIDO / Páxina de proba}}).

A entrada é sensible a maiúsculas, é dicir, os distingue de software maiúsculas e minúsculas, con excepción da primeira letra e espazos que son equivalentes a subliñados ( "_"). Polo tanto:

  • o modelo {{páxina de proba}} e o modelo {{páxina de proba}} recoñeceranse como diferentes
  • os modelos {{páxina de proba}} e {{páxina_proba}} serán idénticos.

Podes usar a inclusión aniñada: un modelo incluído nunha páxina tamén pode conter un ou máis modelos.

Ao inserir modelos, é posible declarar variables que se empregarán dentro do modelo : neste caso falamos dun modelo paramétrico .

Tirantes

Para inserir os corchetes dobres que abren e pechan un modelo hai varias formas que dependen tanto da disposición do teclado como do sistema operativo . Tamén pode copiar e pegar desde aquí: {{}}

clip aberto clip pechado sistema
Alt + Gr + 7 Alt + Gr + 0 GNU / Linux
Alt + Gr + 8 Alt + Gr + 9 GNU / Linux
Alt + 123 Alt + 125 Microsoft Windows
Alt + Gr + Shift + é Alt + Gr + Maiús + + Microsoft Windows : GNU / Linux
Alt + Ctrl + Shift + é Alt + Ctrl + Maiús + + Microsoft Windows
+ + é + + + macOS (co deseño italiano - Pro )

Nota : a clave Shift , nalgúns teclados tamén se pode chamar "Shift". A miúdo atópase xusto debaixo da clave Intro (ou "Intro").

Uso

Os modelos son útiles para calquera elemento complexo, especialmente co formato gráfico, que debe repetirse en dúas ou máis páxinas sen ter que escribilo cada vez. Grazas aos parámetros tamén é posible cambiar o seu aspecto segundo o elemento, sempre sen ter que escribir todo sempre. Os modelos non só son convenientes senón que poden axudar a conseguir a coherencia entre as páxinas.

As aplicacións típicas son:

Usos desaconsellados

Non se recomenda duplicar contido textual (con e sen modelos), por exemplo poñer unha sección que teña que ver con A e B tanto no elemento A como no elemento B. Isto crea confusión, especialmente para os colaboradores novatos. Nestes casos é recomendable ver o texto nun só lugar e empregar ligazóns para conectalo desde varios lugares.

Modelos paramétricos

Curly Brackets.svg

Ao construír un modelo, pode ser necesario deixar ao usuario a posibilidade de personalizar parte do texto ou comportamento do modelo, dependendo da páxina onde se insira. Neste caso, o usuario indica un ou máis parámetros que logo serán explotados para a representación en vídeo do propio modelo. Por exemplo, o modelo: Movie mostra datos diferentes segundo a película que describe.

En cada páxina onde se insire o modelo, os parámetros exprésanse despois do nome do modelo, separados por barras verticais e pódense identificar cun nome de parámetro ou cunha orde progresiva. O método de identificación depende de como se creou o modelo e explícase no seu manual ; ambos os dous tamén se poden soportar.

Exemplo de inclusión con parámetros chamados por nome:

 {{nome do modelo | nome = Tom | apelido = Tom | data = martes}}

Exemplo de inclusión con parámetros secuenciais:

 {{nome do modelo | Tizio | Caio | martes}}

Dentro do propio modelo, no medio do wikicode que constitúe a páxina "Modelo: nome do modelo", os parámetros están representados por etiquetas encerradas en triples chaves; cando se inclúe o modelo, estas etiquetas substituiranse polos valores de texto asignados de cando en vez polo usuario aos parámetros.

No primeiro exemplo:

 {{{name}}}, {{{surname}}} e {{{data}}}

No segundo:

 {{{1}}}, {{{2}}} e {{{3}}}

A sintaxe na súa totalidade é, polo tanto

 {{nome do modelo | nome do parámetro1 = valor do parámetro1 | nome do parámetro2 = valor do parámetro2}}
coas etiquetas {{{nomeparametro}}} no modelo
ou
 {{templatename|valoreparametro1|valoreparametro2}}
coas etiquetas {{{1}}} , {{{2}}} , etc. no modelo.

notas importantes :

  • as etiquetas de parámetros do modelo teñen tres corchetes e non dous .
  • os nomes dos parámetros deben coincidir exactamente; as maiúsculas teñen importancia e os espazos non son equivalentes aos guións baixos.
Exemplo

A páxina "Modelo: saúdo" contén:

 Ola {{{name}}}, como estás?

O modelo inclúese nunha entrada escribindo:

 {{Saúdo | nome = Tom}}

Despois de gardar o cambio (ou na vista previa ), o elemento mostrará:

 Ola, cara, como estás?

Na fase de representación (é dicir, xerando o resultado de inserir o modelo na pantalla), ignoraranse os parámetros adicionais. Se, por outra banda, os parámetros son insuficientes, normalmente producirase un erro, a non ser que se prevea a posibilidade de omitir un parámetro determinado.

Parámetros opcionais

Normalmente un parámetro faise opcional co formulario {{{1|}}} ou {{{1|Pippo}}} , é dicir, cunha barra vertical despois do nome. A barra significa que, a falta dese parámetro, o valor seguinte á barra será usado por defecto (nada no primeiro caso; "Pippo" no segundo).

O valor predeterminado non se aplica se o parámetro está baleiro, pero a súa declaración segue presente: chamando a {{nome template|}} (ou {{nome template|nome=}} se ese parámetro ten un nome) o valor do parámetro será só nulo e non "Pippo". Para comprobar que o parámetro non está ausente nin está baleiro, é necesaria a función #if .

Personaxes espaciais

Cando se usa = notación, calquera espazo e devolución do carro arredor dos valores dos parámetros ignóranse, polo que {{Saluto|nome=Tizio}} equivale a {{Saluto| nome = Tizio }} . Por esta razón, os modelos que teñen moitos parámetros nomeados adoitan colocarse no seguinte formato, que é máis lexible e máis fácil de cubrir:

 {{nome do modelo
| nome = Tom
| apelido = Caio
...
}}

Non obstante, este non é o caso das declaracións implícitas: {{Saluto|Tizio}} e {{Saluto| Tizio }} son diferentes e, no segundo caso, os espazos serán informados textualmente na páxina de chamada. Os espazos adoitan ser inofensivos de todos os xeitos, pero se non, un posible truco para eliminalos é empregar {{#if:toglispazi|{{{1}}}}} no código do modelo ("space-removed" é calquera cadea ).

Limitacións

Un nome de parámetro ou o seu valor non poden conter o carácter " | ", xa que se usa para separar parámetros. Calquera "|" dentro de wikilinks ( ligazóns canalizadas ) ou outros modelos non son un problema, pero se precisa inserir un "|" por outras razóns, use o comando {{!}}.

esta sintaxe funciona correctamente: {{Modelo | [[Marte (astronomía) | Marte]]}}
pero isto non funciona: {{Modelo | La | é un bar}}
para remediar isto, cómpre empregar esta variante: {{Modelo | O {{!}} é unha barra inclinada}}

Ademais, se non se especifica o nome da variable, o seu valor non pode conter o signo " = ". Se precisa inserir o signo "=" nun modelo que usa nomes de variables implícitos, deberá especificar o nome, por exemplo:

esta sintaxe funciona correctamente: {{Modelo | A | B}}
pero isto non funciona: {{Modelo | A = 10 | B = 32}}
para remediar isto, cómpre empregar esta variante: {{Modelo | 1 = A = 10 | 2 = B = 32 }}

Ou pode usar o modelo {{ = }} do seguinte xeito: {{Modelo | A {{=}} 10 | B {{=}} 32}}.

Edite un modelo

Para ver o contido dun modelo é necesario abrilo no modo de edición.

Simplemente dirixíndose á páxina do modelo, dependendo de como se configure, obterá nos casos máis comúns un exemplo de visualización do modelo ou unha páxina de instrucións, ás veces acompañada dun aviso que marca os modelos máis complexos e difíciles de modificar.

Para ir á páxina dun modelo, ademais de escribir o seu nome no cadro de busca, é posible facer clic na etiqueta de edición dun elemento no que está o modelo. Na parte inferior esquerda, despois do wikicode do elemento, aparecerá unha sección co título "Modelos usados ​​nesta páxina", que contén ligazóns a todos os modelos inseridos na páxina.

É necesaria unha importante aclaración:

NUNCA MODIFÍQUESE O CONTIDO DUN MODELO EN USO SE NON SABES O QUE FACES

A edición dun modelo moi recordado pode danar numerosas páxinas, así como sobrecargar os servidores de Wikipedia, que teñen que actualizar todas as páxinas que o inclúen. En particular, non cambie o nome / orde dos parámetros , a menos que pretenda corrixir unha por unha todas as páxinas que xa inclúen o modelo. Sempre é mellor experimentar antes de modificar modelos populares, usando a vista previa ou probas .

Cando un modelo está aberto para editalo, é posible, como en todas as páxinas, ver a vista previa do propio modelo; ademais, hai outra función dispoñible para os modelos (a caixa "Ver unha páxina con este modelo") que permite ver directamente o efecto que terían os cambios nun elemento que xa inclúe o modelo, sen ter que gardalo, nin sequera caixa de area.

Crea un modelo

A creación dun novo modelo faise como para calquera outra páxina. Dado que un modelo está feito para ser usado en varias voces, ás veces incluso miles, é bo discutir a conveniencia da súa creación, por exemplo nun proxecto temático .

Ao escribir un modelo sempre é unha boa idea inserir as categorías ás que pertence o modelo, un pequeno texto de instrución (ou mellor aínda un manual ) e unha presentación das funcións do modelo entre as etiquetas <noinclude> </noinclude>. Vexa Axuda: inclusión para unha descrición destas etiquetas. Se non usa noinclude, as categorías e instrucións tamén aparecerán erróneamente en todos os elementos nos que se insire o modelo.

Se é necesario, o código do modelo real inclúese en etiquetas <includeonly> </includeonly> para evitar que se amose un resultado sen sentido na propia páxina do modelo. Non insira espazos nin envolva fóra das etiquetas include e onlyinclude, xa que tamén aparecerían nas entradas.

Nomes de modelos

Non hai límites técnicos nos títulos distintos dos que teñen todas as demais páxinas; un modelo pódese chamar facilmente "Modelo: principais cidades italianas", sen necesidade de nomes de linguaxe de programación como "Modelo: CittaITA1" (o mesmo se pode dicir dos nomes dos parámetros). Polo tanto, en xeral, siga as mesmas convencións para as voces , escollendo nomes en italiano correcto.

As abreviaturas normalmente úsanse só para modelos moi empregados que requiren unha velocidade de entrada manual elevada, é o caso por exemplo das advertencias principais.

Teña en conta que as redireccións tamén funcionan para os modelos.

Lista de páxinas que conteñen un modelo

Para comprobar que páxinas conteñen un modelo que usa (como para calquera páxina) as ferramentas Sinalar aquí á esquerda. A ferramenta permítelle distinguir que páxinas inclúen o modelo e cales simplemente o apuntan cun wikilink.

Lista de modelos incluídos nunha páxina

Se desexa ver a lista de modelos incluídos nunha páxina, abra esa páxina no modo de edición (ou ver a fonte, para as páxinas protexidas).

Xusto debaixo do cadro de edición, á esquerda, hai unha parte da páxina titulada "Modelos usados ​​nesta páxina:" que lista os distintos modelos incluídos na páxina en cuestión. Podes facer clic no nome dun deles para acceder á páxina correspondente e, se é necesario, editalo desde alí.

Nota: non só se indican os modelos incluídos directamente, senón tamén indirectamente (é dicir, os incluídos á súa vez nun modelo incluído na páxina, etc.).

Caché

Icona de lupa mgx2.svg O mesmo tema en detalle: Axuda: purga .

Cando se modifica un modelo, a versión HTML almacenada na caché de todas as páxinas que o usan márcanse como rexeneradas, que se realiza a través dunha cola de traballo polos servidores. Polo tanto, a actualización pode levar algún tempo, especialmente cando o modelo está incluído en moitas páxinas; así que non te preocupes se os cambios de modelo non aparecen de inmediato nas páxinas. Para forzar de inmediato a actualización dunha páxina determinada, só tes que gardar a páxina (incluso sen modificacións).

Substitución dun modelo (subst :)

Icona de lupa mgx2.svg O mesmo tema en detalle: Axuda: Subst .

Ao poñer "subst:" despois das dobres chaves, este comando no wikitexto substituirase polo contido do modelo cando se garde a páxina. Se alguén cambia a páxina máis tarde, xa non verá a etiqueta no wikitexto senón só o texto substituído.

Comprobe o aspecto

Ao editar os gráficos dun modelo, é unha boa idea comprobar o seu aspecto cos navegadores principais, xa que non todos os navegadores amosan os gráficos da Wikipedia do mesmo xeito. Vexa tamén Wikipedia: Accesibilidade ao contido .

Variables do sistema

As variables do sistema pódense considerar como modelos especiais xestionados coa mesma sintaxe, aínda que o sistema as recoñeza sen necesidade dunha páxina correspondente no espazo de nomes Modelo, que de feito, se se crea cun nome xa usado polas variables, sería ignorado.

Tamén é posible usar variables dentro dos modelos, ademais dos parámetros declarados polo usuario, para obter algunha información como os nomes das páxinas nas que está incluído o modelo ({{PAGENAME}}) ou a data ({{ CURRENTDAY}} {{CURRENTMONTHNAME}} e {{CURRENTYEAR}} nas distintas combinacións). Unha palabra máxica nun modelo avalíase despois da inserción na páxina que o fai referencia, por exemplo, se a palabra máxica {{PAGENAME}} aparece no wikicode dun modelo, renderízase co nome da páxina que o contén e non co nome do modelo.

msgnw

Use "msgnw:" despois das chaves abertas para amosar o wikicode interno do modelo no canto do seu aspecto. Por exemplo, {{ITA}} e {{msgnw: ITA}} amosan respectivamente:

Italia Italia
E
{{bandeira | ITA | nome}} <noinclude> {{Protexido}} [[Categoría: modelos de bandeira nacional]] [[fr: Model: Italie]] </noinclude>

Busca combinada

Exquisite-kfind.png Árbore de categorías relativas aos modelos
(páxinas en cursiva )

Exquisite-kfind.png Busque no espazo de nomes Modelo


Nota

  1. ^ O termo está en inglés ( [ˈtɛmpleɪt] ou [ˈtɛmplɪt] ): en italiano significa "modelo", pero literalmente é "silhouette", "cast". Para obter información xeral, consulte a entrada Modelo .
  2. ^ Co teclado italiano, a chave aberta pódese obter premendo Alt Gr + Maiús + [ , mentres se chama a tecla premendo Alt Gr + Maiús + ] )

Páxinas relacionadas

Outros proxectos

modelo Proxecto de modelo : colabora coa Wikipedia no tema do modelo