Neue Code-Beispiele hinzufügen
Richtlinien für die Beitragseinreichung von Code-Beispielen
- Einreichungen müssen auf Englisch verfasst sein.
- Dokumentieren Sie Ihr Beispiel so gründlich wie möglich.
- Stellen Sie sicher, dass Ihr Code funktioniert und ordnungsgemäß getestet wurde.
Wir behalten uns das Recht vor:
- Ihre Einreichung nach der Übermittlung anzupassen.
- Ihre Einreichung bei Bedarf zu entfernen.
Erstellen eines neuen Code-Beispiels
1. Forken Sie dieses Repository
2. Klonen Sie Ihren Fork und wechseln Sie mit cd in das Projektverzeichnis
3. Installieren Sie VitePress
Die Voraussetzungen für VitePress finden Sie in der offiziellen Dokumentation.
sh
npm add -D vitepress@nextsh
pnpm add -D vitepress@nextsh
yarn add -D vitepress@next vuesh
bun add -D vitepress@next4. Fügen Sie Ihr Code-Beispiel hinzu
4.1 Erstellen Sie die Beispieldatei
- Erstellen Sie eine neue Datei in
/docs/examples, benannt nach der Programmiersprache. - Der Dateiname muss auf
.mdenden. - Fügen Sie mindestens zwei verschiedene Möglichkeiten hinzu, um API-Aufrufe durchzuführen.
4.2 Fügen Sie das Beispiel zur Seitenleiste hinzu
- Öffnen Sie
/docs/.vitepress/config.mts. - Suchen Sie den Abschnitt „Code-Beispiele“ in der Seitenleiste.
- Fügen Sie Ihre neue Datei zur Liste hinzu.
- Halten Sie die Liste in alphabetischer Reihenfolge nach Programmiersprache.
5. Starten Sie den Entwicklungsserver
Bevor Sie einen Pull Request erstellen, überprüfen Sie lokal, ob Ihre Änderungen nichts beschädigt haben.
sh
npm run devsh
pnpm run devsh
yarn devsh
bun run dev6. Erstellen Sie einen Pull Request
Reichen Sie einen Pull Request beim ursprünglichen Repository ein.