Partial
Un bloque escrito una vez y renderizado en cada fuente que lo necesita.
En línea, y el único componente que sale de la fuente de la propia página:
_partials/ en cualquier fuente alimenta una única colección compartida.
Uso
:partial{name="install"}
API
Props
| Prop | Tipo | Por defecto | Notas |
|---|---|---|---|
name | string | — | El archivo en _partials/, sin .md |
Notas
Content no trae ninguna directiva de inclusión, y entre repositorios eso es una carencia sin solución: una nota de instalación que tiene que leerse igual en tres proyectos se copia en tres proyectos y se desvía. Un bloque definido en un repositorio se puede invocar desde las páginas de otro.
Traducido como una página. Una fuente que declara locales obtiene una
colección de fragmentos por idioma — docs/de/_partials/install.md es el
install alemán — y el componente recurre exactamente igual que la página que
lo rodea, terminando en el original sin traducir. Escribe solo los idiomas que
tengas; el resto se resuelve hacia arriba.