ProsePre
Der Code-Block: Dateiname, Sprach-Icon, Kopier-Button.
Jeder Code-Block mit Fences auf der Seite, und die Komponente, die einen mermaid-Fence in ein Diagramm verwandelt.
Was sie hinzufügt
Die Karte um den Code — den Dateinamen, ein Icon für seine Sprache und einen Kopier-Button — plus optionale Zeilennummern.
Sprachen
Jede Sprache, die Shiki mitbringt, wird gefärbt, und jeder Alias, den es kennt,
ebenso: ts und typescript, py und python, yml und console färben
gleich. Nichts einzustellen — der Layer listet sie alle, und ein eigener
langs-Eintrag kommt zu dieser Liste hinzu, statt sie zu ersetzen.
Ein Name, den Shiki nicht kennt, fällt auf Plaintext zurück. Beim Entwickeln
warnt er, im Produktions-Build schweigt er — ein Tippfehler wie pyhton
geht also als grauer Text raus, ohne irgendetwas rot zu machen.
Vier Aliase sind die Ausnahme, aus einem Grund, den keine Liste behebt: c++,
c#, f# und 文言 können kein Paket-Subpath sein. Die Grammatik dahinter wird
über ihren eigenen Namen erreicht — schreibe cpp, csharp, fsharp oder
wenyan.
Zeilennummern
Pro Fence einzuschalten, in seinem Meta geschrieben:
```ts line-numbers
```
Standardmäßig aus: Die meisten Schnipsel in einer Dokumentation sind vier Zeilen lang, und eine Spalte Zahlen daneben ist Rauschen. Die Zahlen zeichnet ein CSS-Counter, ein Leser, der den Block kopiert, bekommt also den Code und nicht die Nummerierung.
Shiki-Annotationen
Zwei wirken auf dem Fence selbst, über die vier hinaus, die Content mitliefert:
| Geschrieben | Tut |
|---|---|
```ts {2,4-6} | Hebt diese Zeilen hervor |
```ts /useDuxtConfig/ | Hebt dieses Wort hervor |
API
Props
| Prop | Typ | Anmerkungen |
|---|---|---|
code | string | Der rohe Quelltext, für den Kopier-Button |
language | string | Aus dem Fence |
filename | string | Aus dem […] des Fence |