|
SPIP |
Article validé
L’article « Usando os modelos » vient d’être publié par Ricardo Porto.
Usando os modelos
quinta-feira 6 de Março de 2025, por Ricardo Porto
Um modelo é um pequeno template SPIP que descreve um fragmento de HTML que é fácil de inserir num outro template ou — e essa é a principal vantagem — no texto de uma matéria.
Sommaire- Usos mútiplos
- Na prática
- Parâmetros em abundância
- Um possível emprego nos templates
- Os modelos padrão
- Conselhos para escrever um modelo
- Ver também
Inspirado nos modelos da Wikipédia, o sistema de modelos oferece novas funcionalidades aos webmasters e aos redatores.
Os modelos são uma extensão dos atalhos clássicos <img1> e <doc1>. Estes correspondem aos modelos /plugins-dist/medias/modeles/img.html e /plugins-dist/medias/modeles/doc.html.
A sua sintaxe foi ampliada e é possível especificar, seja o alinhamento (<img1|left>, <img1|right> ou <img1|center>), uma classe mais genérica, que pode corresponder a um template específico, se existir, ou a uma classe CSS (<img1|classe> irá procurar o modelo modeles/img_classe.html, se o ficheiro existir, senão usará o modelo modeles/img.html, mas com o parâmetro class="classe").
Mas os modelos não se limitam apenas às imagens e documentos; é também possível criar novos atalhos no formato <modelo1>, incluindo simplesmente um template no diretório modeles/ do seu diretório de templates!
Deve-se ter o cuidado de nomear o ficheiro em letras minúsculas («caixa baixa»). Para evitar as diferenciações em alguns sistemas de servidor entre o_ficheiro01.html e O_Ficheiro01.html, o SPIP só procurará por ficheiros nomeados em minúsculas.
Na ausência de qualquer modelo correspondente ao atalho indicado (por exemplo,
<breve1>), o gestor de modelo do SPIP avalia se o objeto solicitado lhe é conhecido (aqui,breve), e se este último tem um URL.
<breve1>Neste caso (verificado aqui, já que as notas (breves) são conhecidas do sistema e dispõem de uma função de URL), o SPIP substitui o atalho<breve1>com uma pequena caixa flutuante com um link para a nota, e a exibição do seu título, como se tivesse sido indicado[->breve1].Se o objeto não for conhecido, o SPIP deixa o atalho intacto, para que ele seja tratado eventualmente em seguida (por um plugin ou um filtro adicional), ou simplesmente ignorado.
Também é possível passar parâmetros adicionais aos modelos. A sintaxe égeneralizada e aceita inclusive HTML, como no exemplo:
<som19|cor=#ff0000
|legenda=O grande <i>Count Basie</i>
|foto=12>
que poderá chamar um modelo modeles/som.html, o qual usará os parâmetros para exibir a foto número 12, numa caixa de cor #ff0000, com uma legenda que suporta palavras em itálico.
[1] Se preferir que o atalho se chame <img12|timbre>, o nome do modelo deverá ser modeles/img_timbre.html.
— Enviado por SPIP