Partial
Ein Block, einmal geschrieben und in jeder Quelle gerendert, die ihn braucht.
Inline, und die eine Komponente, die über die eigene Quelle der Seite
hinausgreift: _partials/ in jeder Quelle speist eine gemeinsame Collection.
Verwendung
:partial{name="install"}
API
Props
| Prop | Typ | Standard | Anmerkungen |
|---|---|---|---|
name | string | — | Die Datei in _partials/, ohne .md |
Anmerkungen
Content liefert keine Include-Direktive, und über Repositories hinweg ist das eine Lücke ohne Umweg: Ein Installationshinweis, der in drei Projekten gleich lauten muss, wird in drei Projekte kopiert und driftet auseinander. Ein Block, der in einem Repository definiert ist, ist aus den Seiten eines anderen aufrufbar.
Wie eine Seite übersetzt. Eine Quelle, die locales deklariert, bekommt eine
Partials-Collection je Sprache — docs/de/_partials/install.md ist das deutsche
install —, und die Komponente fällt genau so zurück wie die Seite um sie
herum, bis hin zum unübersetzten Original. Schreibe nur die Sprachen, die du
hast; der Rest löst sich nach oben auf.