Karten

Karten sind Links, als Raster angeordnet: gut für eine Startseite, den Anfang eines Bereichs oder „wie es weitergeht“. Schreib eine Liste von Links:

::: cards
- [Schnellstart](../../getting-started/quick-start.md)
- [Veröffentlichen](../../publishing/index.md)
- [Suche](../../features/search.md)
:::

Eine Karte, die zu einer Seite deiner Dokumentation führt, zeigt deren icon und description aus dem Front Matter. Du schreibst sie einmal, und jede Karte bleibt aktuell.

#Eigenes Icon und eigener Text

Gib einer Karte ein Icon in geschweiften Klammern nach dem Link und ihren Text in den Zeilen darunter:

::: cards
- [Clay auf GitHub](https://github.com/clay-doc/clay) {fa-brands fa-github}
  Quellcode, Issues und Releases.
- [Codeblöcke](../code-blocks.md) {fa-solid fa-star}
  Unsere Lieblingsseite: Hervorhebung, Diffs und Fokus.
:::

• Der Text des Links ist der Titel der Karte. Die Karte führt dorthin, wohin der Link führt.
• Das Icon ist ein Font-Awesome-Icon, geschrieben als seine Klassen.
• Der Text ist bis zum Link eingerückt, wie die zweite Zeile jedes Listenpunkts. Fett, kursiv und Code funktionieren; Links darin erscheinen als Text, denn die ganze Karte ist ein Link.
• Karten zu anderen Websites haben keine Seite, von der sie Icon und Text übernehmen: Gib ihnen eigene.

#Karten oder list

list: true in der index.md eines Ordners listet alle Seiten des Ordners, in der Reihenfolge der Seitenleiste. Karten zeigen die Seiten, die du wählst, in der Reihenfolge, in der du sie schreibst, aus der ganzen Dokumentation und darüber hinaus. Siehe Indexseiten.

#Anordnung

Karten füllen so viele Spalten, wie Platz haben, und stehen auf Smartphones untereinander. Links in Karten werden bei jedem Build geprüft wie alle anderen Links.