Partial
Um bloco escrito uma vez e apresentado em todas as fontes que dele precisam.
Em linha, e o único componente que sai da fonte da própria página: _partials/
em qualquer fonte alimenta uma coleção partilhada.
Utilização
:partial{name="install"}
API
Props
| Prop | Tipo | Por omissão | Notas |
|---|---|---|---|
name | string | — | O ficheiro em _partials/, sem .md |
Notas
O Content não traz nenhuma diretiva de inclusão e, entre repositórios, isso é uma lacuna sem alternativa: uma nota de instalação que tem de dizer o mesmo em três projetos é copiada para três projetos e diverge. Um bloco definido num repositório pode ser chamado a partir das páginas de outro.
Traduzido como uma página. Uma fonte que declara locales recebe uma coleção de
fragmentos por idioma — docs/de/_partials/install.md é o install alemão — e
o componente recorre exatamente como a página à sua volta, terminando no
original por traduzir. Escreve apenas os idiomas que tens; os restantes
resolvem-se para cima.