Tabs : docmd docs

Inhalte schreiben
Container
Tabs

Tabs präsentieren sich gegenseitig ausschließende oder alternative Datensätze (wie die Wahl des Paketmanagers oder Befehle für Betriebssysteme). Sie verdichten technische Anweisungen in saubere, interaktive Tab-Container.

Container-Syntax

::: tabs # Äußerer Tab-Gruppen-Container Öffner
::: tab [title:"Tab-Beschriftung"] [icon:icon_name] # Einzelnes Tab-Element Öffner
Inhalt für Tab 1 (Code-Blöcke, Text, Listen)...
::: /tab # Expliziter Tab-Element-Schließer

::: tab [title:"Tab-Beschriftung 2"] [icon:icon_name] # Zweites Tab Öffner
Inhalt für Tab 2...
::: /tab
::: /tabs # Expliziter Tab-Gruppen-Schließer

Funktionen & Unterstützte Attribute

Parameter / Eigenschaft	Typ	Beschreibung
Tab-Beschriftung	`"String"` \| `title:"..."`	Text auf der Tab-Auswahlschaltfläche (1. Parameter oder `title:"..."`).
Iconografie	`icon:NAME`	Optional. Fügt ein Lucide-Icon vor der Beschriftung hinzu.
Sub-Container	`::: tab` … `::: /tab`	Explizite Tab-Element-Wrapper. Legacy `== tab` Syntax wird ebenfalls unterstützt.
Schließ-Tags	`::: /tabs`, `::: /tab`, `:::`	Unterstützt benannte Schließ-Tags oder generische `:::`-Schließer.

v0.9.1+ Standardisierung der Container-Syntax

Ab v0.9.1 führt docmd explizite Öffnungs- und Schließungs-Container-Tags (z.B. ::: card … ::: /card, ::: tab … ::: /tab), explizite Key-Value-Eigenschaften (title:"...", url:"...") und nachfolgende # Kommentare ein. Diese modernisierte Syntax wird für alle neuen Dokumentationen empfohlen. Die vollständige Abwärtskompatibilität für alte Sub-Block-Marker (== tab, 1.) und Positionsparameter bleibt strikt erhalten.

Anwendungsbeispiele

Paketmanager-Umschalter

Zeigen Sie Installationsbefehle über mehrere Paketmanager hinweg mit expliziten Sub-Containern an:

::: tabs # Paketmanager-Optionen
::: tab "pnpm" icon:box # Empfohlener Paketmanager
```bash
pnpm add @docmd/core
```
::: /tab

::: tab "npm" icon:terminal
```bash
npm install @docmd/core
```
::: /tab

::: tab "yarn" icon:package
```bash
yarn add @docmd/core
```
::: /tab
::: /tabs

pnpm

npm

yarn

pnpm add @docmd/core

npm install @docmd/core

yarn add @docmd/core

Mehrsprachige Code-Snippets

Gruppieren Sie sprachspezifische Implementierungen mithilfe von Tab-Icons und benannten Schließungs-Tags:

::: tabs
::: tab title:"TypeScript" icon:hexagon
```typescript
import { build } from '@docmd/core';
await build('./docmd.config.json');
```
::: /tab

::: tab title:"JavaScript" icon:braces
```javascript
const { build } = require('@docmd/core');
build('./docmd.config.json');
```
::: /tab
::: /tabs

TypeScript

JavaScript

import { build } from '@docmd/core';
await build('./docmd.config.json');

const { build } = require('@docmd/core');
build('./docmd.config.json');

Legacy == tab Syntax

Bestehende Dokumentationen mit == tab-Syntax werden weiterhin nahtlos verarbeitet:

::: tabs
== tab "JavaScript"
console.log("Legacy-Syntax");
::: /tabs