Appearance
Přidání nové stránky přímo do sekce Arduino pomocí příkazu
Tento postup umožňuje vytvořit nový dokument v konkrétní sekci pomocí jednoho příkazu.
1. Vytvoření skriptu
V kořeni projektu vytvoř složku: scripts a soubor: scripts/new-doc.js
2. Obsah skriptu
javascript
import fs from "fs"
import path from "path"
const title = process.argv[2]
const section = process.argv[3] || "Arduino"
if (!title) {
console.log("Použití: npm run new \"NazevStranky\" Sekce")
process.exit(1)
}
const slug = title
.toLowerCase()
.replace(/\s+/g, "-")
.replace(/[^\w\-]/g, "")
const dir = path.join("docs", section)
const file = path.join(dir, `${slug}.md`)
if (!fs.existsSync(dir)) {
fs.mkdirSync(dir, { recursive: true })
}
const content = `# ${title}
## Popis
Krátký popis.
## Příklad
\`\`\`
kód nebo ukázka
\`\`\`
## Poznámky
Další informace.fs.writeFileSync(file, content)
console.log("Vytvořen soubor:", file)
3. Úprava package.json
Do package.json přidej script:
JSON
{
"scripts": {
"new": "node scripts/new-doc.js"
}
}4. Použití pro sekci Arduino
V terminálu spusť: npm run new "Servo knihovna" Arduino Vytvoří se soubor: docs/Arduino/servo-knihovna.md
5. Použití pro podsekci
Například Libraries: npm run new "Servo knihovna" Arduino/Libraries Vytvoří se: docs/Arduino/Libraries/servo-knihovna.md
6. Další příklady
npm run new "OLED display" Arduino/Displaynpm run new "Git commit" Git
7. Další postup
- Po vytvoření stránky:
- uprav obsah
- přidej stránku do sidebaru
- commitni změny
git add .
git commit -m "add new doc"
git push