fluig-scaffolding-layout
Gera o esqueleto de um Layout WCM do Fluig — a view FreeMarker (.ftl) que define as regiões/áreas onde os widgets são posicionados, usando o grid responsivo do Style Guide. Use quando o desenvolvedor pedir para criar/iniciar um novo layout (template de página) do Fluig a partir de um nome ou propósito.
totvs · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add totvs/fluig-agent-skills --skill fluig-scaffolding-layout技能说明
name: fluig-scaffolding-layout description: Gera o esqueleto de um Layout WCM do Fluig — a view FreeMarker (.ftl) que define as regiões/áreas onde os widgets são posicionados, usando o grid responsivo do Style Guide. Use quando o desenvolvedor pedir para criar/iniciar um novo layout (template de página) do Fluig a partir de um nome ou propósito. argument-hint: 'nome e/ou propósito do layout a ser gerado (ex.: "layout de duas colunas para o portal")'
Scaffolding de Layout (WCM)
Esta skill gera o esqueleto de um Layout WCM do Fluig; ela não duplica convenções — os arquivos de context/ são a fonte de verdade, referenciada abaixo.
Objetivo
Produzir, com responsabilidade única, o esqueleto de um Layout WCM do Fluig na estrutura oficial de pastas/arquivos: o descritor application.info (application.type=layout), a view FreeMarker (layout.ftl) que reproduz a estrutura HTML rígida de portal e declara os slots/regiões onde os widgets são encaixados, e os arquivos .properties de i18n.
Quando Usar
- Ao criar um novo layout (template de página) do Fluig a partir do zero.
- Quando o desenvolvedor fornece um nome/propósito e quer um ponto de partida correto (view com regiões) seguindo as convenções oficiais.
- Quando é preciso garantir, desde o início, uso do grid do Style Guide, i18n nos textos visíveis e ausência de cores fixas.
Diferenças Críticas em Relação a um Widget
Layout e widget compartilham a estrutura WAR, mas o descritor e a view diferem. Atenção a estes pontos para não confundir os dois:
| Item | Widget | Layout |
|---|---|---|
application.type | widget | layout |
| Template principal | view.file=view.ftl | layout.file=layout.ftl |
| Slot padrão | — | layout.defaultSlot=<Slot> (obrigatório) |
| Slots pré-configurados | — | slot.<Nome>=<código-widget> (opcional) |
| Flag no construtor | application.uiwidget | application.uilayout |
| Responsivo | — | application.responsiveLayout=true |
| Renderização da área | conteúdo próprio | <@wcm.renderSlot id="..." /> por slot |
Entradas Esperadas
| Entrada | Descrição | Obrigatória |
|---|---|---|
| Nome do layout | Identificador em Inglês do layout (ex.: PortalTwoColumns) | sim |
| Propósito/estrutura | Quantas regiões/colunas e como o conteúdo se distribui | não |
| Chaves i18n | Chaves de tradução para títulos/textos visíveis do layout | não |
Contexto de Referência (Fonte de Verdade)
Leia antes de executar — não reproduza o conteúdo aqui:
- architecture.md — modelo conceitual do Layout (template de página que define slots/regiões para widgets; view FreeMarker renderizada no servidor) e a estrutura oficial de pastas/arquivos do layout (descritor
application.info,layout.ftl,.propertiesde i18n). - style-guide.md — grid responsivo (
.container/.row/.col-*), componentes e variáveis CSS de tema (var(--fs-color-*)) para estruturar a página. - conventions.md — i18n (
${i18n.getTranslation('chave')}) para textos visíveis e demais convenções públicas de código.
Estrutura de Saída
O layout gerado segue a estrutura oficial (fonte de verdade em architecture.md).
O descritor application.info é obrigatório (com application.type=layout);
a layout.ftl declara os slots/regiões. Use <code> como o código do layout
(minúsculo).
<layout>/
├── pom.xml # quando o projeto usa Maven ou sob pedido
└── src/main/
├── resources/
│ ├── application.info # descritor (application.type=layout)
│ ├── <code>.properties # i18n base
│ ├── <code>_pt_BR.properties # i18n pt-BR
│ ├── <code>_en_US.properties # i18n en-US
│ ├── <code>_es.properties # i18n es
│ └── layout.ftl # view do layout (declara os slots)
└── webapp/
├── WEB-INF/{web.xml, jboss-web.xml}
└── resources/
├── css/responsive_layout.css # CSS padrão de responsividade (obrigatório)
├── css/<code>.css # CSS próprio do layout (opcional)
└── images/icon.png # ícone
No
application.info, declarelayout.file=layout.ftlelayout.defaultSlot(slot padrão). Ponto de partida público: archetype Mavenlayout-wcm.
responsive_layout.cssé padrão: todo layout inclui umresponsive_layout.cssemwebapp/resources/css/, que cuida da responsividade das regiões/slots (container queries + media queries; empilha colunas em telas estreitas, com fallback.not-supports-container-queries). O descritor declara dois recursos CSS, nesta ordem:application.resource.css.1aponta para a folha global do Fluig (/portal/resources/css/wcm_responsive_layout.css, caminho do portal) eapplication.resource.css.2para oresponsive_layout.csspadrão do layout. Um<code>.csspróprio (opcional) entra como recurso adicional. Conteúdo de referência emarchitecture.md.A pasta
WEB-INFtrazweb.xmlejboss-web.xml(comcontext-root=/<application.code>); opom.xmlaparece quando o projeto usa Maven ou sob pedido. Os blocos de referência desses arquivos vivem emarchitecture.md.Em um projeto Fluig Studio, o layout fica em
wcm/layout/<nome>(ver a seção "Estrutura de um Projeto Fluig Studio" emarchitecture.md).
pom.xml (quando o projeto usa Maven ou sob pedido)
Quando for necessário gerar o pom.xml, use a estrutura abaixo como ponto de
partida — ajustando groupId/artifactId/version/name/description ao
artefato. O empacotamento é war e o finalName usa ${project.artifactId}. A
referência canônica completa está em architecture.md.
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<project xmlns="http://maven.apache.org/POM
阅读完整来源 ↗