Stacks
Stacks são o sistema de construção reutilizável dentro do editor de blocks do Chinaski. Um stack é um grupo nomeado e ordenado de blocks que você atribui uma vez e reutiliza entre pages e posts, uma seção hero, uma grade de recursos, um conjunto de calls-to-action que devem viver em cada página de produto. No Chinaski eles são stacks, com aninhamento, herança, conteúdo por idioma e histórico de revisões. Esta página explica como construí-los e gerenciá-los.
Construindo um stack
Crie um stack sob Stacks na área de administração:
- Dê-lhe um nome (único entre stacks que não tenham sido excluídos), uma descrição, e seu idioma.
- Adicione blocks a ele a partir do editor de Blocks, na ordem em que devem renderizar.
- Opcionalmente dê ao stack um wrapper de Layout JSON - uma configuração de markup estilo
{"tag":"section","class":"my-cta"}que envolve o grupo de blocks renderizado uma vez.
Stacks também podem incluir outros stacks aninhados, cada um com sua própria ordem de classificação. Um stack também pode estender outro: o filho antepõe os blocks do pai antes dos seus, de modo que uma seção compartilhada do site pode ser montada uma vez e estendida por caso. Se o stack pai for excluído, o link do filho é limpo automaticamente.
Uma nota sobre editores e stacks: stacks são deliberadamente restritos. Se a lista de entidades permitidas de um editor exclui stacks, ele não pode ver nem modificar quaisquer telas de stacks, a restrição se aplica tanto à leitura quanto à escrita.
Atribuindo stacks ao conteúdo
Stacks se anexam a partir do editor Blocks a uma page ou um post. Ao atribuir um stack, existem controles por emparelhamento: a ordem em que o stack aparece, sobrescritas por instância, e (avançado) um JSON de regras de disponibilidade. Cada stack anexado é rastreado pelo build, de modo que o manifest de build assinado do site registra quais stacks foram usados por página.
Cada block no stack pode carregar sobrescritas por instância, de modo que o mesmo block pode aparecer com conteúdo diferente em stacks diferentes. E uma page não pode renderizar o mesmo block duas vezes via resolução de stack: um block já apresentado por um stack é ignorado onde quer que mais apareça durante o build daquela page.
Stacks por idioma
Stacks são conscientes de idioma de duas maneiras:
- O próprio stack carrega um campo de idioma, de modo que stacks paralelos para diferentes idiomas podem existir. As referências a blocks dentro resolvem por idioma, com fallback para um block sem idioma (abrangente do site) quando aquele idioma não tem um block com o nome referenciado.
- Uma tradução de stack (definida por stack + idioma) fornece uma lista alternativa de blocks apenas para aquele idioma. Quando uma tradução existe para o idioma em serviço, ela substitui completamente a sequência base de blocks para aquele idioma, substituindo as sobrescritas de cada block listado. Sem linha de tradução, a ordenação base vence.
Aninhamento e herança
- Stacks aninhados permitem que um stack incorpore outros stacks, cada um com ordem de classificação. O builder os resolve recursivamente e protege contra loops infinitos e cadeias absurdamente profundas (mais de cinco níveis de profundidade), de modo que uma configuração errada não possa travar um build.
- Estender é para estrutura reutilizável: faça um stack que estende outro (um pai com outros antepostos); a exclusão do pai limpa o link do filho graciosamente em vez de corrompê-lo.
Onde é usado e o que mudou
O dashboard de Stacks mostra onde cada stack é usado: a lista "usado em" nomeia pages e posts (com um limite de primeiros N e uma nota quando a lista é mais longa). As telas de edição mostram stacks de mudanças recentes; cada mudança é capturada nas revisões do stack, de modo que você possa comparar quaisquer duas revisões e restaurar uma configuração anterior a um stack vivo.
Qualidade e auditorias nos bastidores
Cada renderização de stack faz parte da varredura de qualidade do build, renderizações de stack contribuem para as contagens abrangentes do site de acessibilidade e links quebrados mostradas no build guard, e cada restauração/atualização/mudança de stack registra no trilho de auditoria (entradas "stack restaurado para a revisão selecionada" são auditadas). Quando um relatório de build sinaliza uma degradação, stacks ordenados contribuem e fazem parte das estatísticas por stack dos mesmos dados usados para bloquear um promote ruim.