From 3d84bd91d27428c52c1a98d4978d52ee7efcb8f8 Mon Sep 17 00:00:00 2001 From: Saurav Panda Date: Fri, 29 Nov 2024 18:01:31 -0800 Subject: [PATCH] feat: added docs and its updates! --- README.md | 30 +- docs/README.md | 2 +- .../en/docs/contributing/how-to-contribute.md | 2 +- .../en/docs/getting-started/features.md | 12 - .../en/docs/getting-started/requirements.md | 39 +- .../en/docs/installation/configuration.md | 1 + docs/_contents/en/docs/installation/setup.md | 40 +- .../en/docs/seo-and-performance/robot-txt.md | 23 +- .../seo-and-performance/sitemap-generation.md | 47 -- docs/akiradocs.config.json | 10 +- docs/compiled/de/articles/ai_integration.json | 65 +- docs/compiled/de/articles/template.json | 8 +- docs/compiled/de/articles/welcome.json | 32 +- .../de/docs/api-reference/usage-guide.json | 160 +++++ .../content-management/creating-pages.json | 152 +++++ .../de/docs/contributing/code-of-conduct.json | 99 +++ .../docs/contributing/how-to-contribute.json | 213 ++++++ docs/compiled/de/docs/editor/features.json | 205 ++++++ docs/compiled/de/docs/editor/overview.json | 185 ++++++ .../de/docs/getting-started/features.json | 137 ++++ .../de/docs/getting-started/quickstart.json | 135 +++- .../de/docs/getting-started/requirements.json | 179 ++++++ docs/compiled/de/docs/guides/analytics.json | 113 ++++ .../de/docs/installation/configuration.json | 92 +++ docs/compiled/de/docs/installation/setup.json | 261 ++++++++ .../de/docs/installation/troubleshooting.json | 314 +++++++++ .../internationalization/ai-translation.json | 91 +++ .../managing-translation.json | 120 ++++ .../de/docs/internationalization/setup.json | 116 ++++ docs/compiled/de/docs/introduction.json | 113 +++- .../docs/seo-and-performance/robot-txt.json | 45 ++ .../sitemap-generation.json | 58 ++ docs/compiled/en/articles/ai_integration.json | 65 +- docs/compiled/en/articles/welcome.json | 29 +- docs/compiled/en/docs/_meta.json | 62 +- .../en/docs/api-reference/usage-guide.json | 84 +-- .../content-management/creating-pages.json | 79 +-- .../en/docs/contributing/code-of-conduct.json | 46 +- .../docs/contributing/how-to-contribute.json | 111 +--- docs/compiled/en/docs/editor/features.json | 117 +--- docs/compiled/en/docs/editor/overview.json | 104 +-- .../en/docs/getting-started/features.json | 142 +--- .../en/docs/getting-started/quickstart.json | 83 +-- .../en/docs/getting-started/requirements.json | 249 +------- docs/compiled/en/docs/guides/analytics.json | 57 +- .../en/docs/installation/configuration.json | 60 +- docs/compiled/en/docs/installation/setup.json | 209 ++---- .../en/docs/installation/troubleshooting.json | 190 +++--- .../internationalization/ai-translation.json | 56 +- .../managing-translation.json | 88 +-- .../en/docs/internationalization/setup.json | 114 +++- docs/compiled/en/docs/introduction.json | 94 +-- .../docs/seo-and-performance/robot-txt.json | 149 +---- .../sitemap-generation.json | 173 +---- docs/compiled/es/articles/ai_integration.json | 65 +- docs/compiled/es/articles/template.json | 8 +- docs/compiled/es/articles/welcome.json | 32 +- .../es/docs/api-reference/usage-guide.json | 160 +++++ .../content-management/creating-pages.json | 152 +++++ .../es/docs/contributing/code-of-conduct.json | 99 +++ .../docs/contributing/how-to-contribute.json | 213 ++++++ docs/compiled/es/docs/editor/features.json | 205 ++++++ docs/compiled/es/docs/editor/overview.json | 185 ++++++ .../es/docs/getting-started/features.json | 137 ++++ .../es/docs/getting-started/quickstart.json | 135 +++- .../es/docs/getting-started/requirements.json | 179 ++++++ docs/compiled/es/docs/guides/analytics.json | 113 ++++ .../es/docs/installation/configuration.json | 92 +++ docs/compiled/es/docs/installation/setup.json | 261 ++++++++ .../es/docs/installation/troubleshooting.json | 314 +++++++++ .../internationalization/ai-translation.json | 91 +++ .../managing-translation.json | 120 ++++ .../es/docs/internationalization/setup.json | 116 ++++ docs/compiled/es/docs/introduction.json | 113 +++- .../docs/seo-and-performance/robot-txt.json | 45 ++ .../sitemap-generation.json | 58 ++ docs/compiled/fr/articles/ai_integration.json | 65 +- docs/compiled/fr/articles/template.json | 8 +- docs/compiled/fr/articles/welcome.json | 32 +- .../fr/docs/api-reference/usage-guide.json | 160 +++++ .../content-management/creating-pages.json | 152 +++++ .../fr/docs/contributing/code-of-conduct.json | 99 +++ .../docs/contributing/how-to-contribute.json | 213 ++++++ docs/compiled/fr/docs/editor/features.json | 205 ++++++ docs/compiled/fr/docs/editor/overview.json | 185 ++++++ .../fr/docs/getting-started/features.json | 137 ++++ .../fr/docs/getting-started/quickstart.json | 135 +++- .../fr/docs/getting-started/requirements.json | 179 ++++++ docs/compiled/fr/docs/guides/analytics.json | 113 ++++ .../fr/docs/installation/configuration.json | 92 +++ docs/compiled/fr/docs/installation/setup.json | 261 ++++++++ .../fr/docs/installation/troubleshooting.json | 314 +++++++++ .../internationalization/ai-translation.json | 91 +++ .../managing-translation.json | 120 ++++ .../fr/docs/internationalization/setup.json | 116 ++++ docs/compiled/fr/docs/introduction.json | 113 +++- .../docs/seo-and-performance/robot-txt.json | 45 ++ .../sitemap-generation.json | 58 ++ docs/package-lock.json | 4 +- docs/package.json | 2 +- docs/public/context/en_docs.txt | 604 ++++++++---------- docs/scripts/compile.js | 72 ++- docs/scripts/generate-sitemap.mjs | 11 +- .../app/[locale]/[type]/[...slug]/page.tsx | 8 +- docs/src/components/aiSearch/AIResponse.tsx | 1 - .../aiSearch/RecommendedArticles.tsx | 2 +- docs/src/components/blocks/ListBlock.tsx | 13 +- docs/src/components/blocks/ParagraphBlock.tsx | 13 +- docs/src/components/editor/AddBlockButton.tsx | 1 - docs/src/components/layout/Footer.tsx | 11 +- docs/src/components/layout/Navigation.tsx | 28 +- .../src/components/layout/TableOfContents.tsx | 81 +-- docs/src/lib/navigationUtils.ts | 1 - docs/src/styles/globals.css | 12 + docs/src/types/AkiraConfigType.tsx | 5 + gifs/ai_rewrites.gif | Bin 0 -> 972371 bytes gifs/akiradocs_editor.gif | Bin 0 -> 599405 bytes gifs/install_akiradocs.gif | Bin 0 -> 350650 bytes gifs/translate.gif | Bin 0 -> 3420221 bytes packages/akiradocs/akiradocs.config.json | 5 +- packages/akiradocs/example.env | 1 + packages/akiradocs/scripts/compile.js | 3 +- .../app/[locale]/[type]/[...slug]/page.tsx | 8 +- .../src/components/aiSearch/AIResponse.tsx | 1 - .../src/components/blocks/ListBlock.tsx | 13 +- .../src/components/editor/AddBlockButton.tsx | 1 - .../src/components/layout/Navigation.tsx | 4 +- packages/akiradocs/src/lib/navigationUtils.ts | 1 - .../akiradocs/src/types/AkiraConfigType.tsx | 5 + packages/create-app/package.json | 2 +- 130 files changed, 9467 insertions(+), 2692 deletions(-) create mode 100644 docs/compiled/de/docs/api-reference/usage-guide.json create mode 100644 docs/compiled/de/docs/content-management/creating-pages.json create mode 100644 docs/compiled/de/docs/contributing/code-of-conduct.json create mode 100644 docs/compiled/de/docs/contributing/how-to-contribute.json create mode 100644 docs/compiled/de/docs/editor/features.json create mode 100644 docs/compiled/de/docs/editor/overview.json create mode 100644 docs/compiled/de/docs/getting-started/features.json create mode 100644 docs/compiled/de/docs/getting-started/requirements.json create mode 100644 docs/compiled/de/docs/guides/analytics.json create mode 100644 docs/compiled/de/docs/installation/configuration.json create mode 100644 docs/compiled/de/docs/installation/setup.json create mode 100644 docs/compiled/de/docs/installation/troubleshooting.json create mode 100644 docs/compiled/de/docs/internationalization/ai-translation.json create mode 100644 docs/compiled/de/docs/internationalization/managing-translation.json create mode 100644 docs/compiled/de/docs/internationalization/setup.json create mode 100644 docs/compiled/de/docs/seo-and-performance/robot-txt.json create mode 100644 docs/compiled/de/docs/seo-and-performance/sitemap-generation.json create mode 100644 docs/compiled/es/docs/api-reference/usage-guide.json create mode 100644 docs/compiled/es/docs/content-management/creating-pages.json create mode 100644 docs/compiled/es/docs/contributing/code-of-conduct.json create mode 100644 docs/compiled/es/docs/contributing/how-to-contribute.json create mode 100644 docs/compiled/es/docs/editor/features.json create mode 100644 docs/compiled/es/docs/editor/overview.json create mode 100644 docs/compiled/es/docs/getting-started/features.json create mode 100644 docs/compiled/es/docs/getting-started/requirements.json create mode 100644 docs/compiled/es/docs/guides/analytics.json create mode 100644 docs/compiled/es/docs/installation/configuration.json create mode 100644 docs/compiled/es/docs/installation/setup.json create mode 100644 docs/compiled/es/docs/installation/troubleshooting.json create mode 100644 docs/compiled/es/docs/internationalization/ai-translation.json create mode 100644 docs/compiled/es/docs/internationalization/managing-translation.json create mode 100644 docs/compiled/es/docs/internationalization/setup.json create mode 100644 docs/compiled/es/docs/seo-and-performance/robot-txt.json create mode 100644 docs/compiled/es/docs/seo-and-performance/sitemap-generation.json create mode 100644 docs/compiled/fr/docs/api-reference/usage-guide.json create mode 100644 docs/compiled/fr/docs/content-management/creating-pages.json create mode 100644 docs/compiled/fr/docs/contributing/code-of-conduct.json create mode 100644 docs/compiled/fr/docs/contributing/how-to-contribute.json create mode 100644 docs/compiled/fr/docs/editor/features.json create mode 100644 docs/compiled/fr/docs/editor/overview.json create mode 100644 docs/compiled/fr/docs/getting-started/features.json create mode 100644 docs/compiled/fr/docs/getting-started/requirements.json create mode 100644 docs/compiled/fr/docs/guides/analytics.json create mode 100644 docs/compiled/fr/docs/installation/configuration.json create mode 100644 docs/compiled/fr/docs/installation/setup.json create mode 100644 docs/compiled/fr/docs/installation/troubleshooting.json create mode 100644 docs/compiled/fr/docs/internationalization/ai-translation.json create mode 100644 docs/compiled/fr/docs/internationalization/managing-translation.json create mode 100644 docs/compiled/fr/docs/internationalization/setup.json create mode 100644 docs/compiled/fr/docs/seo-and-performance/robot-txt.json create mode 100644 docs/compiled/fr/docs/seo-and-performance/sitemap-generation.json create mode 100644 gifs/ai_rewrites.gif create mode 100644 gifs/akiradocs_editor.gif create mode 100644 gifs/install_akiradocs.gif create mode 100644 gifs/translate.gif create mode 100644 packages/akiradocs/example.env diff --git a/README.md b/README.md index c40784b..80c0435 100644 --- a/README.md +++ b/README.md @@ -3,6 +3,12 @@

AkiraDocs

+

+ + Join Our Discord + +

+

Beautiful docs that write, translate, and optimize themselves

@@ -40,6 +46,8 @@ Or via CLI: npx create-akiradocs ``` +![AkiraDocs installation](gifs/install_akiradocs.gif) + ## 🎯 Perfect For - **Developers**: API docs, SDK guides, implementation examples - **Product Teams**: User guides, release notes, tutorials @@ -47,8 +55,23 @@ npx create-akiradocs ## ✹ Key Features +### Notion-like Editor +Intuitive block-based interface with real-time preview + +![AkiraDocs editor](gifs/akiradocs_editor.gif) + +### AI-Powered Content Generation +Automatically enhance your content with AI + +![AkiraDocs AI](gifs/ai_rewrites.gif) + +### Translation +Translate your content to multiple languages with AI + +![AkiraDocs Translation](gifs/translate.gif) + ### 🔍 AI-Generated SEO Optimization -- Automatically optimize your documentation for search engines with AI-driven SEO +Automatically optimize your documentation for search engines with AI-driven SEO - Improve discoverability and reach without manual SEO adjustments - AI recommendations for keywords and metadata @@ -64,11 +87,6 @@ npx create-akiradocs - Rich media support - Reusable content blocks -### 🏱 Enterprise-Ready -- SSO/SAML integration -- Audit logs -- Custom deployment options -- Version control ## 🌍 Going Global Built-in AI-powered translation. Just add API keys: diff --git a/docs/README.md b/docs/README.md index b5af5dd..c40784b 100644 --- a/docs/README.md +++ b/docs/README.md @@ -100,7 +100,7 @@ npx akiradocs-migrate import --from=source --to=mydocs - [Live Demo](https://demo.akiradocs.ai) - [Documentation](https://docs.akiradocs.com) - [Discord Community](https://discord.gg/zvYZukgeH2) -- [GitHub Discussions](https://github.com/akiradocs/discussions) +- [GitHub Discussions](https://github.com/Cloud-Code-AI/akiradocs/discussions) - [Join Waitlist](https://forms.gle/KunU4BGhToH4NJ1t7) for early access ## 📄 Licensing diff --git a/docs/_contents/en/docs/contributing/how-to-contribute.md b/docs/_contents/en/docs/contributing/how-to-contribute.md index 0ea4e3c..3127a74 100644 --- a/docs/_contents/en/docs/contributing/how-to-contribute.md +++ b/docs/_contents/en/docs/contributing/how-to-contribute.md @@ -18,7 +18,7 @@ Guide to contributing to the AkiraDocs open-source project. ### Setup Development Environment ```bash # Clone repository -git clone https://github.com/akiradocs/akiradocs +git clone https://github.com/Cloud-Code-AI/akiradocs cd akiradocs # Install dependencies diff --git a/docs/_contents/en/docs/getting-started/features.md b/docs/_contents/en/docs/getting-started/features.md index e447b48..6c1b1ae 100644 --- a/docs/_contents/en/docs/getting-started/features.md +++ b/docs/_contents/en/docs/getting-started/features.md @@ -52,15 +52,3 @@ A comprehensive overview of AkiraDocs' core features and capabilities. ✓ Docusaurus ✓ ReadTheDocs ``` - -## Feature Comparison - -| Feature | AkiraDocs | Traditional Docs | -|---------|-----------|------------------| -| Notion-like Editor | ✓ | ✗ | -| AI Translation | ✓ | ✗ | -| AI Search | ✓ | ✗ | -| Auto SEO | ✓ | Partial | -| Markdown Support | ✓ | ✓ | -| Build Optimization | ✓ | Varies | - diff --git a/docs/_contents/en/docs/getting-started/requirements.md b/docs/_contents/en/docs/getting-started/requirements.md index a8cd607..b4f4198 100644 --- a/docs/_contents/en/docs/getting-started/requirements.md +++ b/docs/_contents/en/docs/getting-started/requirements.md @@ -20,12 +20,11 @@ Before installing AkiraDocs, ensure your environment meets the following require - Recommended: Latest LTS version ### System Memory -- Minimum: 4GB RAM -- Recommended: 8GB RAM or more +- Minimum: 2GB RAM +- Recommended: 4GB RAM or more ### Storage -- Minimum: 1GB free space -- Recommended: 5GB+ for larger documentation projects +- Recommended: 1GB free space ## Software Dependencies @@ -46,34 +45,6 @@ Before installing AkiraDocs, ensure your environment meets the following require - Linux (Ubuntu 20.04 or later recommended) ### IDE/Editor Support -- VS Code (recommended) -- WebStorm +- VS Code (coming soon) +- WebStorm (coming soon) - Any text editor with Markdown support - -## Network Requirements - -### Cloud Features -- Stable internet connection -- Access to npm registry -- Access to GitHub (for version control) - -### Enterprise Features -- Outbound HTTPS (443) access -- WebSocket support -- Custom domain (optional) - -## Browser Support - -### Desktop Browsers -- Chrome (last 2 versions) -- Firefox (last 2 versions) -- Safari (last 2 versions) -- Edge (last 2 versions) - -### Mobile Browsers -- iOS Safari -- Android Chrome - -## Verification - -Run the following command to check if your environment is ready: diff --git a/docs/_contents/en/docs/installation/configuration.md b/docs/_contents/en/docs/installation/configuration.md index fade145..4ed82cf 100644 --- a/docs/_contents/en/docs/installation/configuration.md +++ b/docs/_contents/en/docs/installation/configuration.md @@ -20,6 +20,7 @@ Edit `akiradocs.config.json`: ```json { + "url": "https://docs.akiradocs.com", "site": { "title": "Your Docs", "description": "Your documentation description" diff --git a/docs/_contents/en/docs/installation/setup.md b/docs/_contents/en/docs/installation/setup.md index 22b8cae..0682e0a 100644 --- a/docs/_contents/en/docs/installation/setup.md +++ b/docs/_contents/en/docs/installation/setup.md @@ -21,38 +21,30 @@ Ensure your system meets the [requirements](../getting-started/requirements.md) ### 1. Local Development Setup -1. **Clone the Repository** +1. **Create New Project** ```bash -git clone https://github.com/your-org/akira-docs-template -cd akira-docs-template +npx create-akiradocs@latest my-docs-site +cd my-docs-site ``` 2. **Install Dependencies** +Dependencies are automatically installed during project creation. If you need to reinstall: ```bash npm install ``` 3. **Create Environment File** -```bash -cp .env.example .env.local -``` +The environment file is created automatically. You can modify it at `.env.local` -4. **Configure Environment Variables** -```env -NEXT_PUBLIC_API_URL=your_api_url -NEXT_PUBLIC_SITE_URL=your_site_url -``` - -### 2. Docker Installation - -1. **Pull the Docker Image** +4. **Start Development Server** ```bash -docker pull akiradocs/akiradocs:latest +npm run dev ``` -2. **Run the Container** +5. **Update AkiraDocs** +To update an existing installation to the latest version: ```bash -docker run -p 3000:3000 akiradocs/akiradocs:latest +npx create-akiradocs@latest update ``` ### 3. Cloud Platform Deployment @@ -64,10 +56,10 @@ docker run -p 3000:3000 akiradocs/akiradocs:latest 4. Deploy #### Other Platforms -- AWS Amplify -- Netlify -- Digital Ocean -- Custom server +- AWS Amplify (Coming Soon) +- Netlify (Coming Soon) +- Digital Ocean (Coming Soon) +- Custom server (Coming Soon) ## Post-Installation Steps @@ -106,7 +98,3 @@ DEBUG=false NODE_ENV=test TEST_MODE=true ``` - -## Next Steps -- [Configuration Guide](./configuration.md) -- [Troubleshooting](./troubleshooting.md) \ No newline at end of file diff --git a/docs/_contents/en/docs/seo-and-performance/robot-txt.md b/docs/_contents/en/docs/seo-and-performance/robot-txt.md index 8832a46..15def06 100644 --- a/docs/_contents/en/docs/seo-and-performance/robot-txt.md +++ b/docs/_contents/en/docs/seo-and-performance/robot-txt.md @@ -11,7 +11,7 @@ keywords: # Robots.txt Configuration -Guide to customizing and managing your robots.txt file in AkiraDocs. +The robots.txt file is automatically generated during the build process and can be found in the `public` folder of your project. ## Default Configuration @@ -19,28 +19,9 @@ Guide to customizing and managing your robots.txt file in AkiraDocs. ```txt User-agent: * Allow: / -Sitemap: https://yourdocs.com/sitemap.xml +Sitemap: https://docs.akiradocs.com/sitemap.xml # Private sections Disallow: /admin/ Disallow: /private/ ``` - -## Customization - -### Configuration Options -```json -{ - "seo": { - "robots": { - "enabled": true, - "autoGenerate": true, - "custom": { - "disallow": ["/internal/", "/draft/"], - "allow": ["/public/"], - "crawlDelay": 10 - } - } - } -} -``` diff --git a/docs/_contents/en/docs/seo-and-performance/sitemap-generation.md b/docs/_contents/en/docs/seo-and-performance/sitemap-generation.md index 5ec1f8c..fde10dd 100644 --- a/docs/_contents/en/docs/seo-and-performance/sitemap-generation.md +++ b/docs/_contents/en/docs/seo-and-performance/sitemap-generation.md @@ -17,20 +17,6 @@ Learn how AkiraDocs automatically generates and manages your documentation sitem AkiraDocs automatically generates a sitemap.xml file during the build process, ensuring search engines can efficiently crawl your documentation. -### Default Configuration -```json -{ - "seo": { - "sitemap": { - "enabled": true, - "autoGenerate": true, - "changefreq": "weekly", - "priority": 0.7 - } - } -} -``` - ## Generated Sitemap Structure ### Example Output @@ -51,36 +37,3 @@ AkiraDocs automatically generates a sitemap.xml file during the build process, e ``` - -## Customization Options - -### Priority Settings -```json -{ - "seo": { - "sitemap": { - "priorities": { - "home": 1.0, - "docs": 0.8, - "blog": 0.6, - "other": 0.5 - } - } - } -} -``` - -### Update Frequency -```json -{ - "seo": { - "sitemap": { - "changefreq": { - "home": "daily", - "docs": "weekly", - "blog": "monthly" - } - } - } -} -``` diff --git a/docs/akiradocs.config.json b/docs/akiradocs.config.json index 2d5f66a..f1d5b4b 100644 --- a/docs/akiradocs.config.json +++ b/docs/akiradocs.config.json @@ -1,4 +1,5 @@ { + "url": "https://docs.akiradocs.com", "site": { "title": "Akira Docs", "description": "Next-gen documentation powered by AI" @@ -73,9 +74,12 @@ }, "analytics": { "google": { - "measurementId": "", - "enabled": false + "measurementId": "G-GPZ4Z4QP6F", + "enabled": true }, "debug": false + }, + "features": { + "textToSpeech": false } -} \ No newline at end of file +} diff --git a/docs/compiled/de/articles/ai_integration.json b/docs/compiled/de/articles/ai_integration.json index 0fa84e3..c964452 100644 --- a/docs/compiled/de/articles/ai_integration.json +++ b/docs/compiled/de/articles/ai_integration.json @@ -1,5 +1,5 @@ { - "title": "", + "title": "AI-Assistent-Integration", "description": "", "author": "Akira Team", "publishDate": "2024-11-10T00:00:00.000Z", @@ -15,23 +15,15 @@ { "id": "1", "type": "paragraph", - "content": "" + "content": "Lernen Sie, den integrierten KI-Assistenten von Akira zu nutzen, um die Dokumentation zu verbessern" }, { "id": "2", - "type": "heading", - "content": "Integration des KI-Assistenten", - "metadata": { - "level": 1 - } - }, - { - "id": "3", "type": "paragraph", - "content": "Lernen Sie, den integrierten KI-Assistenten von Akira zu nutzen, um die Dokumentation zu verbessern\n\nDer KI-Assistent von Akira ist ein leistungsstarkes Tool, das Entwicklern und technischen Redakteuren hilft, Dokumentationen durch natĂŒrliche Sprachinteraktionen zu erstellen, zu pflegen und zu verbessern. Diese Anleitung behandelt die wichtigsten Funktionen und Best Practices fĂŒr die effiziente Nutzung des KI-Assistenten." + "content": "Hier ist die Übersetzung ins Deutsche, wobei die ursprĂŒngliche Formatierung beibehalten wird:\n\nAkiras KI-Assistent ist ein leistungsstarkes Tool, das Entwicklern und technischen Redakteuren hilft, Dokumentationen durch natĂŒrliche Sprachinteraktionen zu erstellen, zu warten und zu verbessern. Diese Anleitung behandelt die wichtigsten Funktionen und Best Practices fĂŒr die effektive Nutzung des KI-Assistenten." }, { - "id": "4", + "id": "3", "type": "heading", "content": "Hier ist die Übersetzung ins Deutsche:\n\nHauptmerkmale", "metadata": { @@ -39,12 +31,7 @@ } }, { - "id": "5", - "type": "paragraph", - "content": "" - }, - { - "id": "6", + "id": "4", "type": "list", "content": [ "Generierung von Dokumentation in natĂŒrlicher Sprache", @@ -58,12 +45,7 @@ } }, { - "id": "7", - "type": "paragraph", - "content": "" - }, - { - "id": "8", + "id": "5", "type": "heading", "content": "Beginnend", "metadata": { @@ -71,12 +53,12 @@ } }, { - "id": "9", + "id": "6", "type": "paragraph", "content": "Hier ist die Übersetzung ins Deutsche:\n\nDer KI-Assistent kann ĂŒber das BefehlsmenĂŒ (Strg+Umschlag+P) oder mit dem Befehl `/ai` in jedem Inhaltsblock aufgerufen werden. Er versteht kontextbezogene Anfragen und kann Ihnen bei verschiedenen Dokumentationsaufgaben helfen." }, { - "id": "10", + "id": "7", "type": "heading", "content": "Hier ist die Übersetzung ins Deutsche, wobei die ursprĂŒngliche Formatierung beibehalten wird:\n\nGĂ€ngige AnwendungsfĂ€lle", "metadata": { @@ -84,12 +66,12 @@ } }, { - "id": "11", + "id": "8", "type": "paragraph", "content": "1. Code-Beispiele generieren\n2. Technische Konzepte erklĂ€ren\n3. Inhalte umstrukturieren\n4. Dokumentationsschemata erstellen\n5. Dokumentation ĂŒbersetzen" }, { - "id": "12", + "id": "9", "type": "heading", "content": "Voici la traduction en allemand, avec le formatage d'origine conservĂ© :\n\nBeste Praktiken", "metadata": { @@ -97,12 +79,7 @@ } }, { - "id": "13", - "type": "paragraph", - "content": "" - }, - { - "id": "14", + "id": "10", "type": "list", "content": [ "Geben Sie einen klaren Kontext an, wenn Sie Anfragen formulieren", @@ -116,12 +93,7 @@ } }, { - "id": "15", - "type": "paragraph", - "content": "" - }, - { - "id": "16", + "id": "11", "type": "heading", "content": "Hier ist die Übersetzung ins Deutsche:\n\nKonfigurationsoptionen", "metadata": { @@ -129,12 +101,12 @@ } }, { - "id": "17", + "id": "12", "type": "paragraph", "content": "Hier ist die Übersetzung ins Deutsche, wobei die ursprĂŒngliche Formatierung beibehalten wird:\n\nSie können das Verhalten des KI-Assistenten ĂŒber die Datei `config.yaml` anpassen:" }, { - "id": "18", + "id": "13", "type": "code", "content": "ai_assistant:\n Modell: \"advanced-docs-v2\"\n Temperatur: 0,7\n max_tokens: 2048\n Stilhandbuch: \"path/to/style/guide.md\"", "metadata": { @@ -143,12 +115,7 @@ } }, { - "id": "19", - "type": "paragraph", - "content": "" - }, - { - "id": "20", + "id": "14", "type": "heading", "content": "Hier ist die Übersetzung ins Deutsche:\n\nNĂ€chste Schritte", "metadata": { @@ -156,7 +123,7 @@ } }, { - "id": "21", + "id": "15", "type": "paragraph", "content": "Erkunden Sie unseren Leitfaden zu den [Erweiterten KI-Funktionen](/advanced-ai-features), um mehr ĂŒber spezialisierte AnwendungsfĂ€lle und Integrationsmöglichkeiten zu erfahren." } diff --git a/docs/compiled/de/articles/template.json b/docs/compiled/de/articles/template.json index bcca0c8..7569dd9 100644 --- a/docs/compiled/de/articles/template.json +++ b/docs/compiled/de/articles/template.json @@ -2,7 +2,13 @@ "title": "Testblogbeitrag", "description": "Ein Test-Blogbeitrag, um alle Blocktypen zu demonstrieren.", "author": "Anonymous", - "date": "2024-11-08", + "publishDate": "2024-11-10T00:00:00.000Z", + "modifiedDate": "2024-11-10T00:00:00.000Z", + "heroImage": { + "url": "/blog-hero-image.jpg", + "alt": "Hero image for the blog post", + "caption": "Optional caption for the hero image" + }, "blocks": [ { "id": "1", diff --git a/docs/compiled/de/articles/welcome.json b/docs/compiled/de/articles/welcome.json index 564a240..fdf3155 100644 --- a/docs/compiled/de/articles/welcome.json +++ b/docs/compiled/de/articles/welcome.json @@ -14,23 +14,10 @@ { "id": "1", "type": "paragraph", - "content": "" - }, - { - "id": "2", - "type": "heading", - "content": "Willkommen bei Akira Doc", - "metadata": { - "level": 1 - } - }, - { - "id": "3", - "type": "paragraph", "content": "Willkommen bei Akira Docs, der KI-gestĂŒtzten Dokumentationsplattform der nĂ€chsten Generation. Dieses Modell hilft Ihnen, mit der Erstellung Ihrer eigenen Dokumentation zu beginnen." }, { - "id": "4", + "id": "2", "type": "heading", "content": "Hier ist die Übersetzung ins Deutsche:\n\nHauptmerkmale", "metadata": { @@ -38,12 +25,7 @@ } }, { - "id": "5", - "type": "paragraph", - "content": "" - }, - { - "id": "6", + "id": "3", "type": "list", "content": [ "Einfach zu personalisieren", @@ -56,9 +38,13 @@ } }, { - "id": "7", - "type": "paragraph", - "content": "> [!info] Erste Schritte\n> Passen Sie diese Vorlage zunĂ€chst an die BedĂŒrfnisse Ihres Projekts an!" + "id": "4", + "type": "callout", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nBeginnen Sie damit, diese Vorlage an die BedĂŒrfnisse Ihres Projekts anzupassen!", + "metadata": { + "type": "info", + "title": "Getting Started" + } } ] } \ No newline at end of file diff --git a/docs/compiled/de/docs/api-reference/usage-guide.json b/docs/compiled/de/docs/api-reference/usage-guide.json new file mode 100644 index 0000000..0eb0a67 --- /dev/null +++ b/docs/compiled/de/docs/api-reference/usage-guide.json @@ -0,0 +1,160 @@ +{ + "title": "API-Dokumentationsleitfaden", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "API Reference", + "keywords": [ + "API", + "Documentation", + "Integration" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Lernen Sie, eine vollstĂ€ndige API-Dokumentation mit AkiraDocs zu erstellen." + }, + { + "id": "2", + "type": "heading", + "content": "Schnellstart", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "Laden Sie die API-Spezifikation", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "paragraph", + "content": "1. Platzieren Sie hier Ihre OpenAPI/Swagger-Spezifikation:" + }, + { + "id": "5", + "type": "code", + "content": "_inhalt/{sprache_code}/api/apiSpec.json", + "metadata": { + "language": "plaintext", + "showLineNumbers": true + } + }, + { + "id": "6", + "type": "paragraph", + "content": "2. AkiraDocs generiert die Dokumentation automatisch." + }, + { + "id": "7", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nBeispiel-API-Spezifikation", + "metadata": { + "level": 3 + } + }, + { + "id": "8", + "type": "code", + "content": "{\n \"openapi\": \"3.0.0\",\n \"info\": {\n \"title\": \"API-Beispiel\",\n \"version\": \"1.0.0\"\n },\n \"paths\": {\n \"/users\": {\n \"get\": {\n \"summary\": \"Benutzer abrufen\",\n \"responses\": {\n \"200\": {\n \"description\": \"Erfolg\"\n }\n }\n }\n }\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + }, + { + "id": "9", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nGenerierte Dokumentation", + "metadata": { + "level": 2 + } + }, + { + "id": "10", + "type": "heading", + "content": "Automatische Merkmale", + "metadata": { + "level": 3 + } + }, + { + "id": "11", + "type": "list", + "content": [ + "Interaktiver API-Explorer", + "Codebeispiele in mehreren Sprachen", + "Hier ist die Übersetzung ins Deutsche, wobei das ursprĂŒngliche Format beibehalten wurde:\n\nBeispiele fĂŒr Anfragen/Antworten", + "Hier ist die Übersetzung ins Deutsche:\n\nAuthentifizierungsdokumentation" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "12", + "type": "heading", + "content": "Beispielausgabe", + "metadata": { + "level": 3 + } + }, + { + "id": "13", + "type": "code", + "content": "// Beispiel: Benutzer abrufen\nconst response = await fetch('https://api.example.com/users', {\n method: 'GET',\n headers: {\n 'Authorization': 'Bearer DEIN_TOKEN'\n }\n});\n\nconst users = await response.json();", + "metadata": { + "language": "javascript", + "showLineNumbers": true + } + }, + { + "id": "14", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nPersonalisierung", + "metadata": { + "level": 2 + } + }, + { + "id": "15", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nThemenoptionen", + "metadata": { + "level": 3 + } + }, + { + "id": "16", + "type": "code", + "content": "{\n \"api\": {\n \"docs\": {\n \"thĂšme\": \"dunkel\",\n \"syntaxeColorĂ©e\": true,\n \"afficherExemples\": true\n }\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + }, + { + "id": "17", + "type": "heading", + "content": "Sprachauswahl", + "metadata": { + "level": 3 + } + }, + { + "id": "18", + "type": "code", + "content": "{\n \"api\": {\n \"Beispiele\": {\n \"Sprachen\": [\"javascript\", \"python\", \"curl\"]\n }\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/de/docs/content-management/creating-pages.json b/docs/compiled/de/docs/content-management/creating-pages.json new file mode 100644 index 0000000..43cd633 --- /dev/null +++ b/docs/compiled/de/docs/content-management/creating-pages.json @@ -0,0 +1,152 @@ +{ + "title": "Erstellen und Organisieren von Seiten", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Content Management", + "keywords": [ + "Content Creation", + "Pages", + "Organization" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Lernen Sie, wie Sie Ihre Dokumentationsseiten in AkiraDocs erstellen, strukturieren und organisieren. Sie können Markdown-Seiten erstellen oder einfach die BenutzeroberflĂ€che des Editors verwenden. Beachten Sie, dass Sie im Ordner _contents nur den Markdown-Inhalt sehen, den Sie erstellt haben. Wenn Sie die BenutzeroberflĂ€che des Editors verwenden, wird der Inhalt im kompilierten Ordner gespeichert und automatisch in andere Sprachen ĂŒbersetzt." + }, + { + "id": "2", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nSeitenstruktur", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "Vorlage fĂŒr Basisseite", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "code", + "content": "---\ntitel: Ihre Seitentitel\nbeschreibung: Kurze Beschreibung der Seite\nautor: Ihr Name\nveröffentlichungsdatum: 2024-11-26\nletztesÄnderungsdatum: 2024-11-26\nkategorie: Name der Kategorie\nschlĂŒsselwörter:\n - SchlĂŒsselwort 1\n - SchlĂŒsselwort 2\n---\n\n# Haupttitel\n\nDer Inhalt beginnt hier...", + "metadata": { + "language": "markdown", + "showLineNumbers": true + } + }, + { + "id": "5", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nVerzeichnisstruktur", + "metadata": { + "level": 3 + } + }, + { + "id": "6", + "type": "code", + "content": "dossier_nom/\n├── _contenus/\n│ ├── de/\n│ │ ├── um-loszulegen/\n│ │ ├── anleitungen/\n│ │ └── api/", + "metadata": { + "language": "plaintext", + "showLineNumbers": true + } + }, + { + "id": "7", + "type": "paragraph", + "content": "Sie können einfach Seiten fĂŒr die Standardsprache (en) erstellen und AkiraDocs wird sie automatisch in andere Sprachen ĂŒbersetzen." + }, + { + "id": "8", + "type": "heading", + "content": "Erstellen neuer Seiten", + "metadata": { + "level": 2 + } + }, + { + "id": "9", + "type": "heading", + "content": "Methode 1: Verwendung der BenutzeroberflĂ€che", + "metadata": { + "level": 3 + } + }, + { + "id": "10", + "type": "paragraph", + "content": "1. Klicken Sie auf \"Neue Seite\" in der Seitenleiste\n2. Beginnen Sie, Inhalte hinzuzufĂŒgen" + }, + { + "id": "11", + "type": "heading", + "content": "MĂ©thode 2: Direkte Dateierstellung", + "metadata": { + "level": 3 + } + }, + { + "id": "12", + "type": "paragraph", + "content": "1. Erstellen Sie eine neue `.md`-Datei im entsprechenden Verzeichnis\n2. FĂŒgen Sie die erforderlichen Metadaten (Frontmatter) hinzu\n3. Schreiben Sie den Inhalt mit Markdown\n4. Speichern und kompilieren Sie" + }, + { + "id": "13", + "type": "heading", + "content": "Organisation der Seite", + "metadata": { + "level": 2 + } + }, + { + "id": "14", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nKategorien und Etiketten", + "metadata": { + "level": 3 + } + }, + { + "id": "15", + "type": "list", + "content": [ + "Verwenden Sie konsistente Kategorien", + "Wenden Sie die relevanten Etiketten an", + "Organisieren nach Thema", + "Erstellen Sie logische Hierarchien" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "16", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nNavigationsstruktur", + "metadata": { + "level": 3 + } + }, + { + "id": "17", + "type": "paragraph", + "content": "Hier ist die Übersetzung ins Deutsche, wobei das ursprĂŒngliche Format beibehalten wird:\n\nDies wird automatisch aus der Ordnerstruktur generiert. Sie können es anpassen, indem Sie die Datei `_meta.json` im kompilierten Ordner bearbeiten." + }, + { + "id": "18", + "type": "code", + "content": "{\n \"docs\": {\n \"getting-started\": {\n \"title\": \"Loslegen\",\n \"items\": {\n \"introduction\": {\n \"title\": \"EinfĂŒhrung\",\n \"path\": \"/docs/getting-started/introduction\"\n }\n }\n }\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/de/docs/contributing/code-of-conduct.json b/docs/compiled/de/docs/contributing/code-of-conduct.json new file mode 100644 index 0000000..a90fc07 --- /dev/null +++ b/docs/compiled/de/docs/contributing/code-of-conduct.json @@ -0,0 +1,99 @@ +{ + "title": "Verhaltenskodex", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Contributing", + "keywords": [ + "Code of Conduct", + "Contributing" + ], + "blocks": [ + { + "id": "1", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nUnser Engagement", + "metadata": { + "level": 2 + } + }, + { + "id": "2", + "type": "paragraph", + "content": "Wir, als Mitglieder, Mitwirkende und FĂŒhrungskrĂ€fte, verpflichten uns, dafĂŒr zu sorgen, dass die Teilnahme an unserer Gemeinschaft fĂŒr alle eine Erfahrung frei von BelĂ€stigung ist, unabhĂ€ngig von Alter, KörpergrĂ¶ĂŸe, sichtbarer oder unsichtbarer Behinderung, ethnischer Herkunft, sexuellen Merkmalen, GeschlechtsidentitĂ€t und Ausdruck, Erfahrungsniveau, Bildung, sozioökonomischem Status, NationalitĂ€t, persönlichem Erscheinungsbild, Rasse, Religion oder sexueller IdentitĂ€t und Orientierung." + }, + { + "id": "3", + "type": "paragraph", + "content": "Wir verpflichten uns, auf Weisen zu handeln und zu interagieren, die zu einer offenen, einladenden, vielfĂ€ltigen, inklusiven und gesunden Gemeinschaft beitragen." + }, + { + "id": "4", + "type": "heading", + "content": "Unsere Normen", + "metadata": { + "level": 2 + } + }, + { + "id": "5", + "type": "paragraph", + "content": "Hier ist die Übersetzung ins Deutsche, wobei das ursprĂŒngliche Format beibehalten wurde:\n\nBeispiele fĂŒr Verhaltensweisen, die zu einer positiven Umgebung beitragen:" + }, + { + "id": "6", + "type": "paragraph", + "content": "* Zeigen Sie MitgefĂŒhl und Freundlichkeit gegenĂŒber anderen\n* Respektieren Sie unterschiedliche Meinungen, Ansichten und Erfahrungen\n* Geben und akzeptieren Sie konstruktive Kritik mit Anmut\n* Übernehmen Sie Verantwortung und entschuldigen Sie sich bei denen, die von unseren Fehlern betroffen waren\n* Konzentrieren Sie sich darauf, was fĂŒr die Gemeinschaft als Ganzes am besten ist" + }, + { + "id": "7", + "type": "paragraph", + "content": "Hier ist die Übersetzung ins Deutsche, wobei das ursprĂŒngliche Format beibehalten wurde:\n\nBeispiele fĂŒr inakzeptables Verhalten:" + }, + { + "id": "8", + "type": "paragraph", + "content": "* Die Verwendung von sexualisierter Sprache oder Bildern und sexuelle Aufmerksamkeit oder Anspielungen\n* Trolling, beleidigende oder anstĂ¶ĂŸige Kommentare und persönliche oder politische Angriffe\n* Öffentliche oder private BelĂ€stigung\n* Die Veröffentlichung privater Informationen anderer Personen ohne deren ausdrĂŒckliche Zustimmung\n* Jedes andere Verhalten, das in einer professionellen Umgebung als unangemessen angesehen werden könnte" + }, + { + "id": "9", + "type": "heading", + "content": "Voici la traduction en allemand :\n\nCompliance-Verantwortlichkeiten", + "metadata": { + "level": 2 + } + }, + { + "id": "10", + "type": "paragraph", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nGemeinschaftsleiter sind dafĂŒr verantwortlich, unsere Standards fĂŒr akzeptables Verhalten zu klĂ€ren und durchzusetzen, und werden angemessene und faire Korrekturmaßnahmen als Reaktion auf Verhaltensweisen ergreifen, die sie als unangemessen, bedrohlich, beleidigend oder schĂ€dlich erachten." + }, + { + "id": "11", + "type": "heading", + "content": "KonformitĂ€t", + "metadata": { + "level": 2 + } + }, + { + "id": "12", + "type": "paragraph", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nFĂ€lle von missbrĂ€uchlichem, belĂ€stigendem oder anderweitig inakzeptablem Verhalten können den fĂŒr die Durchsetzung zustĂ€ndigen Community-Verantwortlichen gemeldet werden. Alle Beschwerden werden prompt und fair geprĂŒft und untersucht." + }, + { + "id": "13", + "type": "heading", + "content": "Hier ist die Übersetzung auf Deutsch:\n\nZuschreibung", + "metadata": { + "level": 2 + } + }, + { + "id": "14", + "type": "paragraph", + "content": "Hier ist die Übersetzung ins Deutsche, wobei das ursprĂŒngliche Formatieren beibehalten wurde:\n\nDieser Verhaltenskodex wurde vom [Contributor Covenant](https://www.contributor-covenant.org), Version 2.0, verfĂŒgbar unter https://www.contributor-covenant.org/version/2/0/code_of_conduct.html, ĂŒbernommen." + } + ] +} \ No newline at end of file diff --git a/docs/compiled/de/docs/contributing/how-to-contribute.json b/docs/compiled/de/docs/contributing/how-to-contribute.json new file mode 100644 index 0000000..2723472 --- /dev/null +++ b/docs/compiled/de/docs/contributing/how-to-contribute.json @@ -0,0 +1,213 @@ +{ + "title": "Beitragen zu AkiraDocs", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Contributing", + "keywords": [ + "Contributing", + "Open Source", + "Development" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nLeitfaden zur Mitwirkung am Open-Source-Projekt AkiraDocs." + }, + { + "id": "2", + "type": "heading", + "content": "Beginnend", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "Konfigurieren der Entwicklungsumgebung", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "code", + "content": "# Repository klonen\ngit clone https://github.com/Cloud-Code-AI/akiradocs\ncd akiradocs\n\n# AbhĂ€ngigkeiten installieren\nnpm install\n\n# Entwicklungsserver starten\nnpm run dev", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "5", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche, wobei das ursprĂŒngliche Format beibehalten wurde:\n\nRichtlinien fĂŒr BeitrĂ€ge", + "metadata": { + "level": 2 + } + }, + { + "id": "6", + "type": "heading", + "content": "Hier ist die Übersetzung auf Deutsch:\n\nArten von BeitrĂ€gen", + "metadata": { + "level": 3 + } + }, + { + "id": "7", + "type": "list", + "content": [ + "Fehlerkorrekturen", + "Übersetzung der Funktionen", + "Hier ist die Übersetzung ins Deutsche:\n\nVerbesserungen an der Dokumentation", + "Hier ist die Übersetzung ins Deutsche:\n\nÜbersetzungshilfe", + "Fehlerbericht" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "8", + "type": "heading", + "content": "Prozess fĂŒr Extraktionsanfragen", + "metadata": { + "level": 3 + } + }, + { + "id": "9", + "type": "paragraph", + "content": "1. Gabel das Repository\n2. Erstelle einen Feature-Branch\n3. FĂŒhre Änderungen durch\n4. Sende einen Pull-Request" + }, + { + "id": "10", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nBestĂ€tigungsnachrichten", + "metadata": { + "level": 3 + } + }, + { + "id": "11", + "type": "code", + "content": "# Format\ntype(Reichweite): Beschreibung\n\n# Beispiele\nfeat(Editor): Neuen Blocktyp hinzufĂŒgen\nfix(Übersetzung): Spracherkennung korrigieren\ndocs(API): Authentifizierungsanleitung aktualisieren", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "12", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nEntwicklungsleitfĂ€den", + "metadata": { + "level": 2 + } + }, + { + "id": "13", + "type": "heading", + "content": "Codestil", + "metadata": { + "level": 3 + } + }, + { + "id": "14", + "type": "list", + "content": [ + "Folgen Sie den bestehenden Mustern", + "Verwenden Sie TypeScript", + "Kommentare hinzufĂŒgen", + "Schreiben von Tests" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "15", + "type": "heading", + "content": "Hier ist die Übersetzung auf Deutsch:\n\nTest", + "metadata": { + "level": 3 + } + }, + { + "id": "16", + "type": "code", + "content": "# Tests ausfĂŒhren\nnpm run test\n\n# Typen ĂŒberprĂŒfen\nnpm run type-check\n\n# Code linting\nnpm run lint", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "17", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nDokumentation", + "metadata": { + "level": 2 + } + }, + { + "id": "18", + "type": "heading", + "content": "Dokumente aktualisieren", + "metadata": { + "level": 3 + } + }, + { + "id": "19", + "type": "paragraph", + "content": "1. Relevante Dateien Ă€ndern\n2. Beispiele aktualisieren\n3. Links ĂŒberprĂŒfen\n4. Format ĂŒberprĂŒfen" + }, + { + "id": "20", + "type": "heading", + "content": "Erstellen von Beispielen", + "metadata": { + "level": 3 + } + }, + { + "id": "21", + "type": "list", + "content": [ + "Klar und prĂ€gnant", + "Gut dokumentiert", + "Hier ist die Übersetzung ins Deutsche:\n\nGetestet", + "Wartbar" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "22", + "type": "heading", + "content": "Hilfe erhalten", + "metadata": { + "level": 2 + } + }, + { + "id": "23", + "type": "list", + "content": [ + "Tritt [Discord](https://discord.gg/zvYZukgeH2) bei", + "ÜberprĂŒfen Sie die [Probleme](https://github.com/Cloud-Code-AI/akiradocs/issues)", + "Lesen Sie die [Dokumentation](https://docs.akiradocs.com)" + ], + "metadata": { + "listType": "unordered" + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/de/docs/editor/features.json b/docs/compiled/de/docs/editor/features.json new file mode 100644 index 0000000..2c0f5bd --- /dev/null +++ b/docs/compiled/de/docs/editor/features.json @@ -0,0 +1,205 @@ +{ + "title": "Editormerkmale", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Editor", + "keywords": [ + "Editor Features", + "Blocks", + "Formatting" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nDetaillierte Beschreibung der FĂ€higkeiten und Funktionen des AkiraDocs-Editors." + }, + { + "id": "2", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nBlocksystem", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche, wobei das ursprĂŒngliche Format beibehalten wurde:\n\nTextformat", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "list", + "content": [ + "Basisformat", + "Fett, kursiv, unterstrichen", + "BarrĂ©", + "Hervorheben", + "Code online" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "5", + "type": "list", + "content": [ + "Fortgeschrittenes Format", + "Benutzerdefinierte Farben", + "Hier ist die Übersetzung auf Deutsch:\n\nMehrere Quellen", + "Textausrichtung", + "EinrĂŒckung" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "6", + "type": "heading", + "content": "Inhaltsbereiche", + "metadata": { + "level": 3 + } + }, + { + "id": "7", + "type": "heading", + "content": "Angereicherter Text", + "metadata": { + "level": 4 + } + }, + { + "id": "8", + "type": "code", + "content": "# Titel 1\n## Titel 2\n> Textzitat\n- AufzĂ€hlungszeichen\n1. Nummerierte Liste", + "metadata": { + "language": "markdown", + "showLineNumbers": true + } + }, + { + "id": "9", + "type": "heading", + "content": "Codeblocken", + "metadata": { + "level": 4 + } + }, + { + "id": "10", + "type": "code", + "content": "// Hervorhebung der Syntax\nconsole.log('Hallo Welt');", + "metadata": { + "language": "javascript", + "showLineNumbers": true + } + }, + { + "id": "11", + "type": "heading", + "content": "Medienblöcke", + "metadata": { + "level": 4 + } + }, + { + "id": "12", + "type": "list", + "content": [ + "Laden und Einbinden von Bildern", + "Videointegration", + "Anlagen", + "Hier ist die Übersetzung ins Deutsche:\n\nInteraktive Integration" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "13", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nKI-Merkmale", + "metadata": { + "level": 2 + } + }, + { + "id": "14", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nVerbesserung des Inhalts", + "metadata": { + "level": 3 + } + }, + { + "id": "15", + "type": "list", + "content": [ + "Hier ist die Übersetzung ins Deutsche:\n\nVorschlĂ€ge zur Grammatik und zum Stil", + "Hier ist die Übersetzung ins Deutsche:\n\nOptimierung des Inhalts", + "Hier ist die Übersetzung ins Deutsche:\n\nSEO-Empfehlungen", + "Hier ist die Übersetzung ins Deutsche:\n\nÜbersetzungshilfe" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "16", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nIntelligentes Format", + "metadata": { + "level": 3 + } + }, + { + "id": "17", + "type": "list", + "content": [ + "Automatische Formatierung", + "Hier ist die Übersetzung ins Deutsche:\n\nIntelligente Listen", + "Hier ist die Übersetzung ins Deutsche, wobei das ursprĂŒngliche Format beibehalten wurde:\n\nTabellenformat", + "Erkennung der Codeblocksprache" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "18", + "type": "heading", + "content": "Merkmale der Zusammenarbeit", + "metadata": { + "level": 2 + } + }, + { + "id": "19", + "type": "heading", + "content": "Versionskontrolle", + "metadata": { + "level": 3 + } + }, + { + "id": "20", + "type": "list", + "content": [ + "Integrieren von Git", + "Hier ist die Übersetzung ins Deutsche:\n\nÄnderungsverlauf", + "Hier ist die Übersetzung ins Deutsche:\n\nRĂŒckgĂ€ngigmachungsfĂ€higkeiten" + ], + "metadata": { + "listType": "unordered" + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/de/docs/editor/overview.json b/docs/compiled/de/docs/editor/overview.json new file mode 100644 index 0000000..09efc94 --- /dev/null +++ b/docs/compiled/de/docs/editor/overview.json @@ -0,0 +1,185 @@ +{ + "title": "Überblick ĂŒber den Editor", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Editor", + "keywords": [ + "Editor", + "Notion-like", + "Interface" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "AkiraDocs verfĂŒgt ĂŒber einen modernen Editor Ă€hnlich wie Notion, der die Einfachheit der blockbasierten Bearbeitung mit der LeistungsfĂ€higkeit von Markdown kombiniert." + }, + { + "id": "2", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nEditor-OberflĂ€che", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche, wobei die ursprĂŒngliche Formatierung beibehalten wird:\n\nHauptkomponenten", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "list", + "content": [ + "Werkzeugleiste: Schnellzugriff auf Formatierungsoptionen und Blockarten", + "Inhaltsbereich: Blockbasierter Bearbeitungsbereich", + "Seitenleiste: Navigation und Dokumentstruktur", + "Befehlspalette: Schnellbefehle (Ctrl/Cmd + P)" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "5", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nBlockstruktur", + "metadata": { + "level": 3 + } + }, + { + "id": "6", + "type": "paragraph", + "content": "Hier ist die Übersetzung ins Deutsche, wobei das ursprĂŒngliche Format beibehalten wird:\n\nJedes Inhaltselement ist ein Block, der sein kann:" + }, + { + "id": "7", + "type": "list", + "content": [ + "Ziehen und Ablegen zum Neuanordnen", + "Konvertieren zwischen verschiedenen Typen", + "Dupliziert oder gelöscht", + "Eingebettet in andere Blöcke" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "8", + "type": "heading", + "content": "Beginnend", + "metadata": { + "level": 2 + } + }, + { + "id": "9", + "type": "heading", + "content": "Inhaltserstellung", + "metadata": { + "level": 3 + } + }, + { + "id": "10", + "type": "paragraph", + "content": "1. Klicken Sie auf die SchaltflĂ€che '+' oder drĂŒcken Sie '/', um einen neuen Block hinzuzufĂŒgen\n2. WĂ€hlen Sie den Blocktyp im Dropdown-MenĂŒ aus\n3. Beginnen Sie mit dem Schreiben oder fĂŒgen Sie Inhalte ein" + }, + { + "id": "11", + "type": "heading", + "content": "Grundlegende Operationen", + "metadata": { + "level": 3 + } + }, + { + "id": "12", + "type": "code", + "content": "/ → MenĂŒ des Blocks öffnen\n⌘/Ctrl + P → Befehlspalette\n⌘/Ctrl + / → Tastenkombinationen anzeigen\n↑↓ → Zwischen Blöcken navigieren", + "metadata": { + "language": "plaintext", + "showLineNumbers": true + } + }, + { + "id": "13", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nArten von Blöcken", + "metadata": { + "level": 2 + } + }, + { + "id": "14", + "type": "heading", + "content": "Textblöcke", + "metadata": { + "level": 3 + } + }, + { + "id": "15", + "type": "list", + "content": [ + "Hier ist die Übersetzung ins Deutsche, wobei das ursprĂŒngliche Format beibehalten wurde:\n\nAbsĂ€tze", + "Hier ist die Übersetzung ins Deutsche, wobei das ursprĂŒngliche Formatieren beibehalten wurde:\n\nÜberschriften (H1-H6)", + "Listen (mit AufzĂ€hlungszeichen, nummeriert)", + "Hier ist die Übersetzung ins Deutsche:\n\nZitate", + "Hier ist die Übersetzung ins Deutsche:\n\nAnrufe" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "16", + "type": "heading", + "content": "Reichhaltiger Multimediainhalt", + "metadata": { + "level": 3 + } + }, + { + "id": "17", + "type": "list", + "content": [ + "Hier ist die Übersetzung auf Deutsch:\n\nBilder", + "Hier ist die Übersetzung ins Deutsche:\n\nVideos", + "Inkrustationen", + "Dateien", + "Codeblocken" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "18", + "type": "heading", + "content": "Spezialblöcke", + "metadata": { + "level": 3 + } + }, + { + "id": "19", + "type": "list", + "content": [ + "Tableaux (DemnĂ€chst)", + "Teiler", + "Benutzerdefinierte Komponenten (Bald verfĂŒgbar)" + ], + "metadata": { + "listType": "unordered" + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/de/docs/getting-started/features.json b/docs/compiled/de/docs/getting-started/features.json new file mode 100644 index 0000000..aeb703a --- /dev/null +++ b/docs/compiled/de/docs/getting-started/features.json @@ -0,0 +1,137 @@ +{ + "title": "AkiraDocs Funktionen", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Getting Started", + "keywords": [ + "Akira Docs", + "Documentation", + "AI" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nEine vollstĂ€ndige allgemeine Beschreibung der Funktionen und HauptfĂ€higkeiten von AkiraDocs." + }, + { + "id": "2", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nInhaltserstellung und -verwaltung", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "list", + "content": [ + "Ähnlicher Editor wie Notion: Intuitive blockbasierte OberflĂ€che mit Echtzeit-Vorschau", + "Markdown-UnterstĂŒtzung: Native KompatibilitĂ€t mit Markdown und MDX", + "Benutzerdefinierte Komponenten: Erstellen und Wiederverwenden Sie Ihre eigenen Inhaltsbereiche" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "4", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nInternationalisierung und Übersetzung", + "metadata": { + "level": 2 + } + }, + { + "id": "5", + "type": "list", + "content": [ + "Mehrsprachige UnterstĂŒtzung: Dokumentation in mehreren Sprachen pflegen", + "Von KI unterstĂŒtzte Übersetzung: Kontextbewusste, automatisierte InhaltsĂŒbersetzung", + "Übersetzungsverwaltung: Integrierte Tools zur Verwaltung lokalisierten Inhalts" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "6", + "type": "heading", + "content": "Voici la traduction en allemand :\n\nForschung und Entdeckung", + "metadata": { + "level": 2 + } + }, + { + "id": "7", + "type": "list", + "content": [ + "KI-gestĂŒtzte Suche: Kontextbezogene Beantwortung von Fragen in natĂŒrlicher Sprache", + "SEO-Optimierung: Automatisierte SEO-Tools und -Optimierungen", + "Intelligente Indizierung: Echtzeit-Aktualisierung der Suchindizes" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "8", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nKonstruktion und Leistung", + "metadata": { + "level": 2 + } + }, + { + "id": "9", + "type": "list", + "content": [ + "Statische Generierung: Optimierter Kompilierungsprozess mit Ressourcenoptimierung", + "Entwicklererfahrung: Schnelle Aktualisierung und umfassende Debugging-Tools", + "Fokus auf Leistung: Integrierte Best Practices fĂŒr Geschwindigkeit und Effizienz" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "10", + "type": "heading", + "content": "Unternehmensmerkmale (Bald verfĂŒgbar)", + "metadata": { + "level": 2 + } + }, + { + "id": "11", + "type": "list", + "content": [ + "Sicherheit und Compliance: SSO, RBAC und Audit-Protokollierung", + "Analyse und Perspektiven: Überwachung der Nutzung und Dokumentationsmetriken", + "Teamzusammenarbeit: Unternehmensweite Kollaborationswerkzeuge" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "12", + "type": "heading", + "content": "UnterstĂŒtzung fĂŒr die Migration (demnĂ€chst verfĂŒgbar)", + "metadata": { + "level": 2 + } + }, + { + "id": "13", + "type": "code", + "content": "# Kompatible Plattformen fĂŒr eine einfache Migration\n✓ Nextra\n✓ GitBook\n✓ Docusaurus\n✓ ReadTheDocs", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/de/docs/getting-started/quickstart.json b/docs/compiled/de/docs/getting-started/quickstart.json index 996cef8..5378b87 100644 --- a/docs/compiled/de/docs/getting-started/quickstart.json +++ b/docs/compiled/de/docs/getting-started/quickstart.json @@ -14,35 +14,146 @@ { "id": "1", "type": "paragraph", - "content": "Starten Sie mit Akira Docs in wenigen Minuten\n\nFolgen Sie diesen Schritten, um mit der Verwendung von Akira Docs fĂŒr Ihre Dokumentationsanforderungen zu beginnen." + "content": "Starten Sie in wenigen Minuten mit AkiraDocs." }, { "id": "2", + "type": "heading", + "content": "Schnelle Bereitstellung", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "Hier ist die Übersetzung auf Deutsch:\n\nOption 1: Mit Vercel implementieren", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "paragraph", + "content": "Hier ist die Übersetzung ins Deutsche, wobei das ursprĂŒngliche Format beibehalten wurde:\n\nDer schnellste Weg, um loszulegen, ist die Verwendung von Vercel:" + }, + { + "id": "5", + "type": "paragraph", + "content": "[![Mit Vercel bereitstellen](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2FCloud-Code-AI%2Fakiradocs-template)" + }, + { + "id": "6", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nOption 2: Verwendung der Befehlszeilenschnittstelle", + "metadata": { + "level": 3 + } + }, + { + "id": "7", + "type": "paragraph", + "content": "Erstellen Sie ein neues Projekt mit unserem CLI:" + }, + { + "id": "8", "type": "code", - "content": "bash\ngit clone https://github.com/tu-org/plantilla-docs-akira\ncd plantilla-docs-akira\nnpm install\nnpm run dev", + "content": "npx create-akiradocs@latest mi-documentos", "metadata": { - "language": "plaintext", + "language": "bash", "showLineNumbers": true } }, { - "id": "3", + "id": "9", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche, wobei das ursprĂŒngliche Format beibehalten wurde:\n\nGrundlegende Konfigurationsschritte", + "metadata": { + "level": 2 + } + }, + { + "id": "10", "type": "paragraph", - "content": "" + "content": "1. Repository klonen (wenn Quick Deploy nicht verwendet wird)" }, { - "id": "4", - "type": "callout", - "content": "Stellen Sie sicher, dass Node.js 16 oder eine neuere Version auf Ihrem System installiert ist.", + "id": "11", + "type": "code", + "content": "git clonen https://github.com/your-org/akira-docs-template\ncd akira-docs-template", "metadata": { - "type": "warning", - "title": "Prerequisites" + "language": "bash", + "showLineNumbers": true } }, { - "id": "5", + "id": "12", "type": "paragraph", - "content": "" + "content": "2. Installieren Sie die AbhĂ€ngigkeiten" + }, + { + "id": "13", + "type": "code", + "content": "npm installieren\n# oder\nyarn installieren", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "14", + "type": "paragraph", + "content": "3. Starten Sie den Entwicklungsserver" + }, + { + "id": "15", + "type": "code", + "content": "npm run dev\n# oder\nyarn dev", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "16", + "type": "paragraph", + "content": "4. Öffnen Sie `http://localhost:3000` in Ihrem Browser" + }, + { + "id": "17", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nAnfĂ€ngliche Konfiguration", + "metadata": { + "level": 2 + } + }, + { + "id": "18", + "type": "paragraph", + "content": "1. Aktualisieren Sie die Website-Konfiguration\nBearbeiten Sie `akiradocs.config.json`:" + }, + { + "id": "19", + "type": "code", + "content": "{\n \"site\": {\n \"title\": \"Ihre Dokumente\",\n \"description\": \"Die Beschreibung Ihrer Dokumentation\"\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + }, + { + "id": "20", + "type": "paragraph", + "content": "2. Übersetzung konfigurieren (Optional)" + }, + { + "id": "21", + "type": "code", + "content": "{\n \"Übersetzung\": {\n \"auto_ĂŒbersetzen\": true,\n \"Anbieter\": \"anthropic\",\n \"Zielsprachen\": [\"es\", \"fr\", \"de\"]\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } } ] } \ No newline at end of file diff --git a/docs/compiled/de/docs/getting-started/requirements.json b/docs/compiled/de/docs/getting-started/requirements.json new file mode 100644 index 0000000..fbde298 --- /dev/null +++ b/docs/compiled/de/docs/getting-started/requirements.json @@ -0,0 +1,179 @@ +{ + "title": "Systemanforderungen", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Getting Started", + "keywords": [ + "Akira Docs", + "Documentation", + "AI" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Bevor Sie AkiraDocs installieren, stellen Sie sicher, dass Ihre Umgebung die folgenden Anforderungen erfĂŒllt." + }, + { + "id": "2", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche, wobei das ursprĂŒngliche Format beibehalten wurde:\n\nMindestanforderungen", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "Node.js\n\nNode.js", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "list", + "content": [ + "Hier ist die Übersetzung ins Deutsche:\n\nVersion: 16.x oder höher", + "Empfohlen: Neueste LTS-Version" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "5", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nSystemspeicher", + "metadata": { + "level": 3 + } + }, + { + "id": "6", + "type": "list", + "content": [ + "Hier ist die Übersetzung ins Deutsche:\n\nMindest-RAM: 2 GB", + "Empfohlen: 4 GB RAM oder mehr" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "7", + "type": "heading", + "content": "Lagerung", + "metadata": { + "level": 3 + } + }, + { + "id": "8", + "type": "list", + "content": [ + "Empfohlen: 1 GB freier Speicherplatz" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "9", + "type": "heading", + "content": "SoftwareabhĂ€ngigkeiten", + "metadata": { + "level": 2 + } + }, + { + "id": "10", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nErforderlich", + "metadata": { + "level": 3 + } + }, + { + "id": "11", + "type": "list", + "content": [ + "Git (die neueste Version wird empfohlen)", + "Paketmanager npm oder yarn", + "Moderner Webbrowser (Chrome, Firefox, Safari, Edge)" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "12", + "type": "heading", + "content": "Fakultativ", + "metadata": { + "level": 3 + } + }, + { + "id": "13", + "type": "list", + "content": [ + "Docker (fĂŒr die containerisierte Bereitstellung)", + "PostgreSQL (fĂŒr Enterprise-Funktionen)" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "14", + "type": "heading", + "content": "Entwicklungsumgebung", + "metadata": { + "level": 2 + } + }, + { + "id": "15", + "type": "heading", + "content": "Kompatible Betriebssysteme", + "metadata": { + "level": 3 + } + }, + { + "id": "16", + "type": "list", + "content": [ + "macOS (Version 10.15 oder neuer)", + "Hier ist die Übersetzung ins Deutsche, wobei das ursprĂŒngliche Format beibehalten wurde:\n\nWindows 10/11\n\nWindows 10/11", + "Linux (Ubuntu 20.04 oder höhere Version empfohlen)" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "17", + "type": "heading", + "content": "UnterstĂŒtzung fĂŒr IDEs/Editoren", + "metadata": { + "level": 3 + } + }, + { + "id": "18", + "type": "list", + "content": [ + "VS Code (bald)", + "WebStorm (demnĂ€chst)", + "Jeder Texteditor, der Markdown unterstĂŒtzt" + ], + "metadata": { + "listType": "unordered" + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/de/docs/guides/analytics.json b/docs/compiled/de/docs/guides/analytics.json new file mode 100644 index 0000000..b2e3c47 --- /dev/null +++ b/docs/compiled/de/docs/guides/analytics.json @@ -0,0 +1,113 @@ +{ + "title": "Analyseintegration", + "description": "Erfahren Sie, wie Sie Analysen-Tracking zu Ihrer Dokumentation hinzufĂŒgen", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Guides", + "keywords": [ + "Akira Docs", + "Analytics", + "Google Analytics" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "AkiraDocs ist standardmĂ€ĂŸig mit Google Analytics 4 (GA4) kompatibel. Diese Anleitung hilft Ihnen dabei, die Analyseerfassung fĂŒr Ihre Dokumentation einzurichten." + }, + { + "id": "2", + "type": "heading", + "content": "Konfigurieren Sie Google Analytics", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "paragraph", + "content": "1. Erstellen Sie eine Google Analytics 4-Eigenschaft in Ihrem [Google Analytics-Konto](https://analytics.google.com/)\n2. Holen Sie sich Ihre Mess-ID (beginnt mit \"G-\")\n3. FĂŒgen Sie die ID zu Ihrer `akiradocs.config.json` hinzu:" + }, + { + "id": "4", + "type": "code", + "content": "{\n\"analytisch\": {\n\"google\": {\n\"messungsId\": \"G-XXXXXXXXXX\",\n\"aktiviert\": true\n},\n\"debugging\": false\n}\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + }, + { + "id": "5", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nWas wird automatisch verfolgt?", + "metadata": { + "level": 2 + } + }, + { + "id": "6", + "type": "list", + "content": [ + "Seitenansichten", + "Hier ist die Übersetzung ins Deutsche:\n\nNavigation zwischen den Seiten", + "Zeit auf der Seite", + "Benutzer-Spracheinstellungen", + "GerĂ€teinformationen und Browser" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "7", + "type": "heading", + "content": "Nachverfolgung benutzerdefinierter Ereignisse", + "metadata": { + "level": 2 + } + }, + { + "id": "8", + "type": "paragraph", + "content": "Hier ist die Übersetzung auf Deutsch:\n\nSie können benutzerdefinierte Ereignisse mit dem Hook `useAnalytics` verfolgen:" + }, + { + "id": "9", + "type": "code", + "content": "importieren { useAnalytics } from '@/hooks/useAnalytics'\nfunktion MyComponent() {\n const { track } = useAnalytics()\n const handleClick = () => {\n track('doc_rating', {\n rating: 5,\n page: 'getting-started',\n helpful: true\n })\n }\n return \n}", + "metadata": { + "language": "typescript", + "showLineNumbers": true + } + }, + { + "id": "10", + "type": "heading", + "content": "Hier ist die Übersetzung auf Deutsch:\n\nDebug-Modus", + "metadata": { + "level": 2 + } + }, + { + "id": "11", + "type": "paragraph", + "content": "Aktivieren Sie den Debugmodus, um Analyseereignisse wĂ€hrend der Entwicklung in der Konsole zu sehen:" + }, + { + "id": "12", + "type": "code", + "content": "{\n\"analytisch\": {\n\"debuggen\": wahr\n}\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + }, + { + "id": "13", + "type": "paragraph", + "content": "Dies bietet eine vollstĂ€ndige analytische Integration, die fĂŒr Benutzer je nach Bedarf einfach zu konfigurieren und zu erweitern ist." + } + ] +} \ No newline at end of file diff --git a/docs/compiled/de/docs/installation/configuration.json b/docs/compiled/de/docs/installation/configuration.json new file mode 100644 index 0000000..eaa02bc --- /dev/null +++ b/docs/compiled/de/docs/installation/configuration.json @@ -0,0 +1,92 @@ +{ + "title": "Konfigurationshandbuch", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Installation", + "keywords": [ + "Configuration", + "Settings", + "Setup" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nVollstĂ€ndige Anleitung zur Einrichtung Ihrer AkiraDocs-Installation." + }, + { + "id": "2", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nHauptkonfiguration", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nKonfiguration der Website", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "paragraph", + "content": "Ändern Sie `akiradocs.config.json`:" + }, + { + "id": "5", + "type": "code", + "content": "{\n \"url\": \"https://docs.akiradocs.com\",\n \"site\": {\n \"title\": \"Ihre Dokumente\",\n \"description\": \"Beschreibung Ihrer Dokumentation\"\n },\n \"branding\": {\n \"logo\": {\n \"path\": \"/your_logo.svg\",\n \"width\": 120,\n \"height\": 30,\n \"show\": true\n },\n \"favicon\": {\n \"path\": \"/favicon.png\",\n \"show\": true\n }\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + }, + { + "id": "6", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nEinrichtung der Navigation", + "metadata": { + "level": 3 + } + }, + { + "id": "7", + "type": "code", + "content": "{\n \"navigation\": {\n \"en-tĂȘte\": {\n \"Ă©lĂ©ments\": [\n { \"Ă©tiquette\": \"Dokumente\", \"href\": \"/docs\", \"icĂŽne\": \"/docs.svg\" },\n { \"Ă©tiquette\": \"API\", \"href\": \"/api\", \"icĂŽne\": \"/api.svg\" }\n ]\n }\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + }, + { + "id": "8", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nInternationalisierung", + "metadata": { + "level": 2 + } + }, + { + "id": "9", + "type": "heading", + "content": "Spracheinstellungen", + "metadata": { + "level": 3 + } + }, + { + "id": "10", + "type": "code", + "content": "{\n \"localization\": {\n \"defaultLocale\": \"en\",\n \"fallbackLocale\": \"en\",\n \"locales\": [\n {\n \"code\": \"en\",\n \"name\": \"Englisch\",\n \"flag\": \"đŸ‡ș🇾\"\n },\n {\n \"code\": \"es\",\n \"name\": \"Spanisch\",\n \"flag\": \"đŸ‡Ș🇾\"\n },\n {\n \"code\": \"fr\",\n \"name\": \"Französisch\",\n \"flag\": \"đŸ‡«đŸ‡·\"\n },\n {\n \"code\": \"de\",\n \"name\": \"Deutsch\",\n \"flag\": \"đŸ‡©đŸ‡Ș\"\n }\n ]\n },\n \"translation\": {\n \"auto_translate\": true,\n \"provider\": \"anthropic\",\n \"model\": \"claude-3-sonnet-20240229\",\n \"targetLanguages\": [\"es\", \"fr\", \"de\"],\n \"excludedPaths\": [\"_meta.json\"]\n },\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/de/docs/installation/setup.json b/docs/compiled/de/docs/installation/setup.json new file mode 100644 index 0000000..bf18162 --- /dev/null +++ b/docs/compiled/de/docs/installation/setup.json @@ -0,0 +1,261 @@ +{ + "title": "AusfĂŒhrliche Installationsanleitung", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Installation", + "keywords": [ + "Installation", + "Setup", + "Deployment" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nVollstĂ€ndige Anleitung zur Installation von AkiraDocs in verschiedenen Umgebungen." + }, + { + "id": "2", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche, wobei das ursprĂŒngliche Format beibehalten wurde:\n\nVoraussetzungen", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "paragraph", + "content": "Stellen Sie sicher, dass Ihr System die [Anforderungen](../getting-started/requirements.md) erfĂŒllt, bevor Sie fortfahren." + }, + { + "id": "4", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nInstallationsmethoden", + "metadata": { + "level": 2 + } + }, + { + "id": "5", + "type": "heading", + "content": "1. Konfiguration der lokalen Entwicklung", + "metadata": { + "level": 3 + } + }, + { + "id": "6", + "type": "paragraph", + "content": "1. Neues Projekt erstellen" + }, + { + "id": "7", + "type": "code", + "content": "npx create-akiradocs@latest meine-dokumentationsseite\ncd meine-dokumentationsseite", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "8", + "type": "paragraph", + "content": "2. AbhĂ€ngigkeiten installieren\nDie AbhĂ€ngigkeiten werden bei der Projekterstellung automatisch installiert. Wenn Sie sie erneut installieren mĂŒssen:" + }, + { + "id": "9", + "type": "code", + "content": "npm installieren", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "10", + "type": "paragraph", + "content": "3. Eine Umgebungsdatei erstellen\nDie Umgebungsdatei wird automatisch erstellt. Sie können sie in `.env.local` bearbeiten" + }, + { + "id": "11", + "type": "paragraph", + "content": "4. Starten Sie den Entwicklungsserver" + }, + { + "id": "12", + "type": "code", + "content": "npm ausfĂŒhren dev", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "13", + "type": "paragraph", + "content": "5. AkiraDocs aktualisieren\nUm eine bestehende Installation auf die neueste Version zu aktualisieren:" + }, + { + "id": "14", + "type": "code", + "content": "npx create-akiradocs@latest aktualisieren", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "15", + "type": "heading", + "content": "3. Bereitstellung auf der Cloud-Plattform", + "metadata": { + "level": 3 + } + }, + { + "id": "16", + "type": "heading", + "content": "Hier ist die Übersetzung auf Deutsch:\n\nVercel", + "metadata": { + "level": 4 + } + }, + { + "id": "17", + "type": "paragraph", + "content": "1. Gabel das Repository\n2. Verbinde dich mit Vercel\n3. Konfiguriere die Umgebungsvariablen\n4. Deployen" + }, + { + "id": "18", + "type": "heading", + "content": "Andere Plattformen", + "metadata": { + "level": 4 + } + }, + { + "id": "19", + "type": "list", + "content": [ + "AWS Amplify (DemnĂ€chst verfĂŒgbar)", + "Netlify (DemnĂ€chst)", + "Hier ist die Übersetzung auf Deutsch:\n\nDigital Ocean (DemnĂ€chst)", + "Benutzerdefinierter Server (Bald verfĂŒgbar)" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "20", + "type": "heading", + "content": "Schritte nach der Installation", + "metadata": { + "level": 2 + } + }, + { + "id": "21", + "type": "paragraph", + "content": "1. ÜberprĂŒfen Sie die Installation" + }, + { + "id": "22", + "type": "code", + "content": "npm ausfĂŒhren build\nnpm ausfĂŒhren start", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "23", + "type": "paragraph", + "content": "2. Konfigurieren der Git-Integration" + }, + { + "id": "24", + "type": "code", + "content": "git remote add origin deine-repository-url", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "25", + "type": "paragraph", + "content": "3. Konfigurieren Sie das Inhaltsverzeichnis" + }, + { + "id": "26", + "type": "code", + "content": "mkdir -p docs/_inhalte/de", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "27", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nUmgebungsspezifische Konfigurationen", + "metadata": { + "level": 2 + } + }, + { + "id": "28", + "type": "heading", + "content": "Entwicklung", + "metadata": { + "level": 3 + } + }, + { + "id": "29", + "type": "code", + "content": "NODE_ENV=Entwicklung\nDEBUG=wahr", + "metadata": { + "language": "env", + "showLineNumbers": true + } + }, + { + "id": "30", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche, wobei die ursprĂŒngliche Formatierung beibehalten wird:\n\nProduktion", + "metadata": { + "level": 3 + } + }, + { + "id": "31", + "type": "code", + "content": "NODE_ENV=Produktion\nDEBUG=falsch", + "metadata": { + "language": "env", + "showLineNumbers": true + } + }, + { + "id": "32", + "type": "heading", + "content": "Hier ist die Übersetzung auf Deutsch:\n\nTest", + "metadata": { + "level": 3 + } + }, + { + "id": "33", + "type": "code", + "content": "NODE_ENV=Test\nTEST_MODE=wahr", + "metadata": { + "language": "env", + "showLineNumbers": true + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/de/docs/installation/troubleshooting.json b/docs/compiled/de/docs/installation/troubleshooting.json new file mode 100644 index 0000000..aad64ca --- /dev/null +++ b/docs/compiled/de/docs/installation/troubleshooting.json @@ -0,0 +1,314 @@ +{ + "title": "Fehlerbehebungsanleitung", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Installation", + "keywords": [ + "Troubleshooting", + "Issues", + "Solutions" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nHĂ€ufige Probleme und deren Lösungen bei der Einrichtung von AkiraDocs." + }, + { + "id": "2", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche, wobei das ursprĂŒngliche Formatieren beibehalten wurde:\n\nHĂ€ufige Installationsprobleme", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "Versionsabweichung von Node.js", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "paragraph", + "content": "Problem: Fehler bezĂŒglich der KompatibilitĂ€t der Node.js-Version" + }, + { + "id": "5", + "type": "code", + "content": "Fehler: Die \"node\"-Engine ist mit diesem Modul nicht kompatibel", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "6", + "type": "paragraph", + "content": "Lösung:\n1. ÜberprĂŒfen Sie Ihre Node.js-Version:" + }, + { + "id": "7", + "type": "code", + "content": "Knoten --version", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "8", + "type": "paragraph", + "content": "2. Installieren Sie die richtige Version (16.x oder höher)\n3. Verwenden Sie nvm, um Node.js-Versionen zu verwalten:" + }, + { + "id": "9", + "type": "code", + "content": "Installieren Sie nvm 20\nVerwenden Sie nvm 20", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "10", + "type": "heading", + "content": "Fehlschlag bei der Installation der AbhĂ€ngigkeiten", + "metadata": { + "level": 3 + } + }, + { + "id": "11", + "type": "paragraph", + "content": "Problem: npm install schlĂ€gt mit Fehlern fehl" + }, + { + "id": "12", + "type": "paragraph", + "content": "Lösung:\n1. Leeren Sie den npm-Cache:" + }, + { + "id": "13", + "type": "code", + "content": "Hier ist die Übersetzung auf Deutsch:\n\nnpm cache clean --force", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "14", + "type": "paragraph", + "content": "2. Entfernen Sie node_modules und package-lock.json:" + }, + { + "id": "15", + "type": "code", + "content": "Lösche -rf node_modules package-lock.json\nnpm installieren", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "16", + "type": "heading", + "content": "Probleme beim Kompilieren", + "metadata": { + "level": 2 + } + }, + { + "id": "17", + "type": "heading", + "content": "Übersetzungsfehler", + "metadata": { + "level": 3 + } + }, + { + "id": "18", + "type": "paragraph", + "content": "Problem: `npm run build` schlĂ€gt fehl" + }, + { + "id": "19", + "type": "paragraph", + "content": "Lösung:\n1. ÜberprĂŒfen Sie die TypeScript-Fehler:" + }, + { + "id": "20", + "type": "code", + "content": "npm ausfĂŒhren type-check", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "21", + "type": "paragraph", + "content": "2. ÜberprĂŒfen Sie, ob die Umgebungsvariablen korrekt konfiguriert sind\n3. Leeren Sie den next.js-Cache:" + }, + { + "id": "22", + "type": "code", + "content": "Löschen -rekursiv -erzwingen .nĂ€chste", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "23", + "type": "heading", + "content": "Probleme bei der statischen Exportierung", + "metadata": { + "level": 3 + } + }, + { + "id": "24", + "type": "paragraph", + "content": "Problem: Die statische Exportierung schlĂ€gt mit dynamischen Routen fehl" + }, + { + "id": "25", + "type": "paragraph", + "content": "Lösung:\n1. Konfiguriere `next.config.js`:" + }, + { + "id": "26", + "type": "code", + "content": "module.exports = {\n sortie: 'exportieren',\n images: {\n sansOptimisation: wahr\n }\n}", + "metadata": { + "language": "js", + "showLineNumbers": true + } + }, + { + "id": "27", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nÜbersetzungsprobleme", + "metadata": { + "level": 2 + } + }, + { + "id": "28", + "type": "heading", + "content": "KI-Übersetzung funktioniert nicht", + "metadata": { + "level": 3 + } + }, + { + "id": "29", + "type": "paragraph", + "content": "Problem: Die automatische Übersetzung schlĂ€gt fehl" + }, + { + "id": "30", + "type": "paragraph", + "content": "Lösung:\n1. ÜberprĂŒfen Sie, ob die API-SchlĂŒssel korrekt konfiguriert sind\n2. ÜberprĂŒfen Sie die Übersetzungskonfiguration:" + }, + { + "id": "31", + "type": "code", + "content": "{\n \"Übersetzung\": {\n \"auto_ĂŒbersetzen\": true,\n \"Anbieter\": \"anthropic\",\n \"Zielsprachen\": [\"es\", \"fr\", \"de\"]\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + }, + { + "id": "32", + "type": "heading", + "content": "Inhaltsprobleme", + "metadata": { + "level": 2 + } + }, + { + "id": "33", + "type": "heading", + "content": "Inhalt wird nicht aktualisiert", + "metadata": { + "level": 3 + } + }, + { + "id": "34", + "type": "paragraph", + "content": "Problem: Änderungen an Inhaltsdateien werden nicht ĂŒbernommen" + }, + { + "id": "35", + "type": "paragraph", + "content": "Lösung:\nInhaltliche Änderungen werden zur Kompilierzeit erstellt. Wenn Sie den lokalen Entwicklungsserver verwenden, mĂŒssen Sie den Server nach Änderungen neu starten.\n1. Leeren Sie den Cache:" + }, + { + "id": "36", + "type": "code", + "content": "npm ausfĂŒhren sauber", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "37", + "type": "paragraph", + "content": "2. Starten Sie den Entwicklungsserver neu\n3. ÜberprĂŒfen Sie die Dateiberechtigungen" + }, + { + "id": "38", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nImplementierungsprobleme", + "metadata": { + "level": 2 + } + }, + { + "id": "39", + "type": "heading", + "content": "Vercel-Bereitstellung fehlgeschlagen", + "metadata": { + "level": 3 + } + }, + { + "id": "40", + "type": "paragraph", + "content": "Problem: Die Vercel-Bereitstellung schlĂ€gt fehl" + }, + { + "id": "41", + "type": "paragraph", + "content": "Lösung:\n1. ÜberprĂŒfen Sie die Kompilierungsprotokolle\n2. ÜberprĂŒfen Sie, ob die Umgebungsvariablen im Vercel-Dashboard konfiguriert sind\n3. Stellen Sie sicher, dass alle AbhĂ€ngigkeiten in der package.json-Datei aufgefĂŒhrt sind" + }, + { + "id": "42", + "type": "heading", + "content": "Hilfe erhalten", + "metadata": { + "level": 2 + } + }, + { + "id": "43", + "type": "paragraph", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nWenn Sie weiterhin Probleme haben:" + }, + { + "id": "44", + "type": "paragraph", + "content": "1. Besuchen Sie unsere [GitHub-Probleme](https://github.com/Cloud-Code-AI/Akiradocs/issues)\n2. Treten Sie unserer [Discord-Community](https://discord.gg/zvYZukgeH2) bei\n3. Kontaktieren Sie den [Support](mailto:saurav.panda@akiradocs.ai)" + } + ] +} \ No newline at end of file diff --git a/docs/compiled/de/docs/internationalization/ai-translation.json b/docs/compiled/de/docs/internationalization/ai-translation.json new file mode 100644 index 0000000..db3d297 --- /dev/null +++ b/docs/compiled/de/docs/internationalization/ai-translation.json @@ -0,0 +1,91 @@ +{ + "title": "KI-gestĂŒtzte Übersetzung", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Internationalization", + "keywords": [ + "AI Translation", + "Automation", + "Language Processing" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nAnleitung zur Verwendung der KI-Übersetzungsfunktionen von AkiraDocs." + }, + { + "id": "2", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nKonfiguration", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nKonfiguration", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "code", + "content": "{\n \"Übersetzung\": {\n \"auto_ĂŒbersetzen\": true,\n \"Anbieter\": \"anthropic\",\n \"Modell\": \"claude-3-sonnet-20240229\",\n \"ZielSprachen\": [\"es\", \"fr\", \"de\"],\n \"ausgeschlossenePfade\": [\"_meta.json\"]\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + }, + { + "id": "5", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nAPI-Konfiguration", + "metadata": { + "level": 3 + } + }, + { + "id": "6", + "type": "code", + "content": "ANTHROPIC_API_KEY=der_API-SchlĂŒssel", + "metadata": { + "language": "env", + "showLineNumbers": true + } + }, + { + "id": "7", + "type": "heading", + "content": "Merkmale", + "metadata": { + "level": 2 + } + }, + { + "id": "8", + "type": "heading", + "content": "Automatische Übersetzung", + "metadata": { + "level": 3 + } + }, + { + "id": "9", + "type": "list", + "content": [ + "Übersetzung des Inhalts wĂ€hrend der Kompilierung", + "Kontextbewusste Übersetzungen", + "Hier ist die Übersetzung ins Deutsche, wobei das ursprĂŒngliche Formatieren beibehalten wird:\n\nBeibehaltung der Fachbegriffe", + "Hier ist die Übersetzung ins Deutsche, wobei das ursprĂŒngliche Format beibehalten wird:\n\nBeibehaltung der Formatierung" + ], + "metadata": { + "listType": "unordered" + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/de/docs/internationalization/managing-translation.json b/docs/compiled/de/docs/internationalization/managing-translation.json new file mode 100644 index 0000000..4afdbe7 --- /dev/null +++ b/docs/compiled/de/docs/internationalization/managing-translation.json @@ -0,0 +1,120 @@ +{ + "title": "Übersetzungen verwalten", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Internationalization", + "keywords": [ + "Translation Management", + "Content Localization", + "Workflow" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Lernen Sie, ĂŒbersetzten Inhalt in AkiraDocs effizient zu verwalten und zu pflegen." + }, + { + "id": "2", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nÜbersetzungs-Workflow", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "Automatische Übersetzung", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "paragraph", + "content": "1. Erstellen Sie Inhalte in der Ausgangssprache\n2. Aktivieren Sie die automatische Übersetzung in den Einstellungen\n3. Bauen/Bereitstellen Sie, um Übersetzungen zu generieren\n4. ÜberprĂŒfen und verfeinern Sie die Übersetzungen" + }, + { + "id": "5", + "type": "heading", + "content": "Manuelle Übersetzung", + "metadata": { + "level": 3 + } + }, + { + "id": "6", + "type": "paragraph", + "content": "1. Erstellen Sie spezifische Verzeichnisse fĂŒr jede Sprache\n2. Kopieren Sie den Quellinhalt\n3. Übersetzen Sie manuell\n4. Aktualisieren Sie die Metadaten" + }, + { + "id": "7", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nInhaltsorganisation", + "metadata": { + "level": 2 + } + }, + { + "id": "8", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nDateistruktur", + "metadata": { + "level": 3 + } + }, + { + "id": "9", + "type": "code", + "content": "_inhalt/\n├── de/\n│ └── docs/\n│ ├── intro.md\n│ └── anleitung.md\n├── es/\n│ └── docs/\n│ ├── intro.md\n│ └── guide.md\n└── fr/\n └── docs/\n ├── intro.md\n └── guide.md", + "metadata": { + "language": "plaintext", + "showLineNumbers": true + } + }, + { + "id": "10", + "type": "heading", + "content": "QualitĂ€tskontrolle", + "metadata": { + "level": 2 + } + }, + { + "id": "11", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nÜberprĂŒfungsprozess", + "metadata": { + "level": 3 + } + }, + { + "id": "12", + "type": "paragraph", + "content": "1. KI-Übersetzung\n2. Menschliche Überarbeitung\n3. Technische ÜberprĂŒfung\n4. Veröffentlichung" + }, + { + "id": "13", + "type": "heading", + "content": "Versionskontrolle", + "metadata": { + "level": 3 + } + }, + { + "id": "14", + "type": "list", + "content": [ + "Änderungen in mehreren Sprachen verfolgen", + "Hier ist die Übersetzung ins Deutsche:\n\nBleiben Sie synchronisiert", + "Effizientes Verwalten von Updates" + ], + "metadata": { + "listType": "unordered" + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/de/docs/internationalization/setup.json b/docs/compiled/de/docs/internationalization/setup.json new file mode 100644 index 0000000..43de9e3 --- /dev/null +++ b/docs/compiled/de/docs/internationalization/setup.json @@ -0,0 +1,116 @@ +{ + "title": "Einrichten der Internationalisierung", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Internationalization", + "keywords": [ + "i18n", + "Setup", + "Languages" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Konfigurieren Sie AkiraDocs fĂŒr mehrere Sprachen mit KI-gestĂŒtzter ÜbersetzungsunterstĂŒtzung." + }, + { + "id": "2", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nSchnellkonfiguration", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nGrundkonfiguration", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "paragraph", + "content": "FĂŒgen Sie die Sprachkonfiguration zu `akiradocs.config.json` hinzu:" + }, + { + "id": "5", + "type": "code", + "content": "{\n \"localization\": {\n \"defaultLocale\": \"en\",\n \"fallbackLocale\": \"en\",\n \"locales\": [\n {\n \"code\": \"en\",\n \"name\": \"Englisch\",\n \"flag\": \"ïżœđŸ‡ŹđŸ‡§\"\n },\n {\n \"code\": \"es\",\n \"name\": \"Spanisch\",\n \"flag\": \"đŸ‡Ș🇾\"\n },\n {\n \"code\": \"fr\",\n \"name\": \"Französisch\",\n \"flag\": \"đŸ‡«đŸ‡·\"\n }\n ]\n },\n \"translation\": {\n \"auto_translate\": true,\n \"provider\": \"anthropic\",\n \"targetLanguages\": [\"es\", \"fr\", \"de\"],\n \"excludedPaths\": [\"_meta.json\"]\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + }, + { + "id": "6", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nVerzeichnisstruktur", + "metadata": { + "level": 3 + } + }, + { + "id": "7", + "type": "code", + "content": "docs/\n├── _contents/\n│ ├── en/ # Quellsprache\n│ │ └── docs/\n│ ├── es/ # Spanische Übersetzung\n│ │ └── docs/\n│ └── fr/ # Französische Übersetzung\n│ └── docs/", + "metadata": { + "language": "plaintext", + "showLineNumbers": true + } + }, + { + "id": "8", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nKonfigurationsoptionen", + "metadata": { + "level": 2 + } + }, + { + "id": "9", + "type": "heading", + "content": "Spracheinstellungen", + "metadata": { + "level": 3 + } + }, + { + "id": "10", + "type": "list", + "content": [ + "`defaultLocale`: Standardsprache des Inhalts", + "`fallbackLocale`: Ausweichressource, wenn die Übersetzung fehlt", + "`locales`: VerfĂŒgbare Spracheinstellungen" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "11", + "type": "heading", + "content": "Übersetzungsparameter", + "metadata": { + "level": 3 + } + }, + { + "id": "12", + "type": "list", + "content": [ + "`auto_translate`: Automatische Übersetzung aktivieren/deaktivieren", + "`fournisseur`: KI-Übersetzungsanbieter", + "`zielsprachen`: Sprachen, in die ĂŒbersetzt werden soll", + "`rutasExcluidas` : Dateien, die wĂ€hrend der Übersetzung ignoriert werden" + ], + "metadata": { + "listType": "unordered" + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/de/docs/introduction.json b/docs/compiled/de/docs/introduction.json index c680d22..a3e4659 100644 --- a/docs/compiled/de/docs/introduction.json +++ b/docs/compiled/de/docs/introduction.json @@ -1,5 +1,5 @@ { - "title": "", + "title": "EinfĂŒhrung in AkiraDocs", "description": "", "author": "Akira Team", "publishDate": "2024-11-10T00:00:00.000Z", @@ -14,12 +14,12 @@ { "id": "1", "type": "paragraph", - "content": "Entdecken Sie Akira Docs und seine Hauptfunktionen\n\nAkira Docs ist eine moderne Dokumentationsplattform, die die Leistung von KI mit einem intuitiven blockbasierten Inhaltssystem kombiniert. Dieser Leitfaden hilft Ihnen, die wichtigsten Konzepte und Funktionen zu verstehen." + "content": "AkiraDocs ist eine Dokumentationsplattform der neuen Generation, die die LeistungsfĂ€higkeit von KI mit einem intuitiven Content-Management-System kombiniert. Sie wurde entwickelt, um Ihren Dokumentationsarbeitsablauf von Tagen auf Minuten zu verkĂŒrzen." }, { "id": "2", "type": "heading", - "content": "Hier ist die Übersetzung ins Deutsche:\n\nHauptmerkmale", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nWarum AkiraDocs?", "metadata": { "level": 2 } @@ -27,17 +27,17 @@ { "id": "3", "type": "paragraph", - "content": "" + "content": "Hier ist die Übersetzung ins Deutsche, wobei das ursprĂŒngliche Format beibehalten wurde:\n\nDie Dokumentation ist oft eine Herausforderung fĂŒr Teams:" }, { "id": "4", "type": "list", "content": [ - "KI-gestĂŒtzte Suche", - "Blockbasierte Inhaltserstellung", - "AnpassungsfĂ€higes Konzept", - "Anpassbare Themen", - "KompatibilitĂ€t mit Markdown" + "Hier ist die Übersetzung auf Deutsch:\n\nDie Entwickler möchten weiterhin Markdown und Git verwenden", + "Die Content-Teams benötigen benutzerfreundliche Editoren", + "Hier ist die Übersetzung ins Deutsche:\n\nTechnische Redakteure kĂ€mpfen mit dem Versionsmanagement", + "Hier ist die Übersetzung ins Deutsche:\n\nProduktmanager haben es mit veralteter Dokumentation zu tun", + "Hier ist die Übersetzung ins Deutsche:\n\nUnternehmensfĂŒhrer brauchen bessere Analysen" ], "metadata": { "listType": "unordered" @@ -46,7 +46,100 @@ { "id": "5", "type": "paragraph", - "content": "" + "content": "AkiraDocs löst diese Herausforderungen, indem es eine einheitliche Plattform bietet, die den Arbeitsablauf aller zusammenfĂŒhrt." + }, + { + "id": "6", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche, wobei das ursprĂŒngliche Formatieren beibehalten wurde:\n\nHauptvorteile", + "metadata": { + "level": 2 + } + }, + { + "id": "7", + "type": "list", + "content": [ + "Universeller Workflow: Entwickler behalten ihren Markdown/Git-Workflow bei, wĂ€hrend Content-Teams einen blockbasierten WYSIWYG-Editor erhalten", + "Angetrieben von KI: Automatische Inhaltsaktualisierungen, Übersetzungen und Optimierungen", + "Optimiert fĂŒr SEO: StandardmĂ€ĂŸig gut sortierte Dokumentation", + "Mehrsprachige UnterstĂŒtzung: Übersetzungen mit kĂŒnstlicher Intelligenz und BerĂŒcksichtigung des Kontexts", + "Bereit fĂŒr Unternehmen: SSO/SAML-Integration, Audit-Logs und benutzerdefinierte Bereitstellungsoptionen" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "8", + "type": "heading", + "content": "FĂŒr wen ist das?", + "metadata": { + "level": 2 + } + }, + { + "id": "9", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nDokumentation fĂŒr Entwickler", + "metadata": { + "level": 3 + } + }, + { + "id": "10", + "type": "list", + "content": [ + "Hier ist die Übersetzung ins Deutsche:\n\nAPI-Dokumentation", + "Hier ist die Übersetzung ins Deutsche:\n\nSDK-Anleitungen", + "Technische Spezifikationen", + "Hier ist die Übersetzung ins Deutsche:\n\nImplementierungsleitfĂ€den" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "11", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nProduktdokumentation", + "metadata": { + "level": 3 + } + }, + { + "id": "12", + "type": "list", + "content": [ + "Hier ist die Übersetzung ins Deutsche:\n\nBenutzerhandbĂŒcher", + "Hier ist die Übersetzung ins Deutsche:\n\nFunktionsdokumentation", + "Hier ist die Übersetzung ins Deutsche, wobei das ursprĂŒngliche Formatieren beibehalten wurde:\n\nVersionshinweise", + "Hier ist die Übersetzung ins Deutsche:\n\nHĂ€ufig gestellte Fragen" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "13", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nUnternehmensdokumentation", + "metadata": { + "level": 3 + } + }, + { + "id": "14", + "type": "list", + "content": [ + "Interne Wissensdatenbanken", + "Hier ist die Übersetzung ins Deutsche:\n\nProzessdokumentation", + "Hier ist die Übersetzung ins Deutsche:\n\nCompliance-Dokumentation", + "Hier ist die Übersetzung ins Deutsche:\n\nSchulungsmaterialien" + ], + "metadata": { + "listType": "unordered" + } } ] } \ No newline at end of file diff --git a/docs/compiled/de/docs/seo-and-performance/robot-txt.json b/docs/compiled/de/docs/seo-and-performance/robot-txt.json new file mode 100644 index 0000000..0278948 --- /dev/null +++ b/docs/compiled/de/docs/seo-and-performance/robot-txt.json @@ -0,0 +1,45 @@ +{ + "title": "Robots.txt-Konfiguration", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "SEO & Performance", + "keywords": [ + "SEO", + "Robots.txt", + "Crawling" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Der robots.txt-Datei wird wĂ€hrend des Kompilierungsprozesses automatisch generiert und kann im `public`-Ordner Ihres Projekts gefunden werden." + }, + { + "id": "2", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nStandardkonfiguration", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "robots.txt Grundlage\n\nBenutzer-Agent: *\nNicht zulassen: /", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "code", + "content": "Hier ist die Übersetzung ins Deutsche, wobei die ursprĂŒngliche Formatierung beibehalten wird:\n\nUser-agent: *\nAllow: /\nSitemap: https://docs.akiradocs.com/sitemap.xml\n\n# Private Bereiche\nDisallow: /admin/\nDisallow: /private/", + "metadata": { + "language": "txt", + "showLineNumbers": true + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/de/docs/seo-and-performance/sitemap-generation.json b/docs/compiled/de/docs/seo-and-performance/sitemap-generation.json new file mode 100644 index 0000000..b587299 --- /dev/null +++ b/docs/compiled/de/docs/seo-and-performance/sitemap-generation.json @@ -0,0 +1,58 @@ +{ + "title": "Automatische Sitemap-Generierung", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "SEO & Performance", + "keywords": [ + "SEO", + "Sitemap", + "XML" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Erfahren Sie, wie AkiraDocs automatisch den Gliederungsplan Ihrer Dokumentation erstellt und verwaltet." + }, + { + "id": "2", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nAllgemeine Beschreibung", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "paragraph", + "content": "AkiraDocs generiert wĂ€hrend des Kompilierungsprozesses automatisch eine sitemap.xml-Datei, um sicherzustellen, dass Suchmaschinen Ihre Dokumentation effizient verfolgen können." + }, + { + "id": "4", + "type": "heading", + "content": "Hier ist die Übersetzung ins Deutsche:\n\nStruktur der generierten Website-Karte", + "metadata": { + "level": 2 + } + }, + { + "id": "5", + "type": "heading", + "content": "Beispielausgabe", + "metadata": { + "level": 3 + } + }, + { + "id": "6", + "type": "code", + "content": "\n\n \n https://yourdocs.com/\n 2024-11-26\n wöchentlich\n 1.0\n \n \n https://yourdocs.com/docs/getting-started\n 2024-11-26\n wöchentlich\n 0.8\n \n", + "metadata": { + "language": "xml", + "showLineNumbers": true + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/en/articles/ai_integration.json b/docs/compiled/en/articles/ai_integration.json index d09ccde..0cf2d71 100644 --- a/docs/compiled/en/articles/ai_integration.json +++ b/docs/compiled/en/articles/ai_integration.json @@ -1,5 +1,5 @@ { - "title": "", + "title": "AI Assistant Integration", "description": "", "author": "Akira Team", "publishDate": "2024-11-10T00:00:00.000Z", @@ -15,23 +15,15 @@ { "id": "1", "type": "paragraph", - "content": "" + "content": "Learn how to use Akira's built-in AI assistant for documentation enhancement" }, { "id": "2", - "type": "heading", - "content": "AI Assistant Integration", - "metadata": { - "level": 1 - } - }, - { - "id": "3", "type": "paragraph", - "content": "Learn how to use Akira's built-in AI assistant for documentation enhancement\n\nAkira's AI Assistant is a powerful tool that helps developers and technical writers create, maintain, and improve documentation through natural language interactions. This guide covers the essential features and best practices for utilizing the AI assistant effectively." + "content": "Akira's AI Assistant is a powerful tool that helps developers and technical writers create, maintain, and improve documentation through natural language interactions. This guide covers the essential features and best practices for utilizing the AI assistant effectively." }, { - "id": "4", + "id": "3", "type": "heading", "content": "Key Features", "metadata": { @@ -39,12 +31,7 @@ } }, { - "id": "5", - "type": "paragraph", - "content": "" - }, - { - "id": "6", + "id": "4", "type": "list", "content": [ "Natural language documentation generation", @@ -58,12 +45,7 @@ } }, { - "id": "7", - "type": "paragraph", - "content": "" - }, - { - "id": "8", + "id": "5", "type": "heading", "content": "Getting Started", "metadata": { @@ -71,12 +53,12 @@ } }, { - "id": "9", + "id": "6", "type": "paragraph", "content": "The AI Assistant can be accessed through the command palette (Ctrl+Shift+P) or by using the `/ai` command in any content block. It understands context-aware requests and can help with various documentation tasks." }, { - "id": "10", + "id": "7", "type": "heading", "content": "Common Use Cases", "metadata": { @@ -84,12 +66,12 @@ } }, { - "id": "11", + "id": "8", "type": "paragraph", "content": "1. Generating code examples\n2. Explaining technical concepts\n3. Restructuring content\n4. Creating documentation outlines\n5. Translating documentation" }, { - "id": "12", + "id": "9", "type": "heading", "content": "Best Practices", "metadata": { @@ -97,12 +79,7 @@ } }, { - "id": "13", - "type": "paragraph", - "content": "" - }, - { - "id": "14", + "id": "10", "type": "list", "content": [ "Provide clear context when making requests", @@ -116,12 +93,7 @@ } }, { - "id": "15", - "type": "paragraph", - "content": "" - }, - { - "id": "16", + "id": "11", "type": "heading", "content": "Configuration Options", "metadata": { @@ -129,12 +101,12 @@ } }, { - "id": "17", + "id": "12", "type": "paragraph", "content": "You can customize the AI Assistant's behavior through the `config.yaml` file:" }, { - "id": "18", + "id": "13", "type": "code", "content": "ai_assistant:\n model: \"advanced-docs-v2\"\n temperature: 0.7\n max_tokens: 2048\n style_guide: \"path/to/style/guide.md\"", "metadata": { @@ -143,12 +115,7 @@ } }, { - "id": "19", - "type": "paragraph", - "content": "" - }, - { - "id": "20", + "id": "14", "type": "heading", "content": "Next Steps", "metadata": { @@ -156,7 +123,7 @@ } }, { - "id": "21", + "id": "15", "type": "paragraph", "content": "Explore our [Advanced AI Features](/advanced-ai-features) guide to learn more about specialized use cases and integration possibilities." } diff --git a/docs/compiled/en/articles/welcome.json b/docs/compiled/en/articles/welcome.json index 04108e4..813ef17 100644 --- a/docs/compiled/en/articles/welcome.json +++ b/docs/compiled/en/articles/welcome.json @@ -14,23 +14,10 @@ { "id": "1", "type": "paragraph", - "content": "" - }, - { - "id": "2", - "type": "heading", - "content": "Welcome to Akira Doc", - "metadata": { - "level": 1 - } - }, - { - "id": "3", - "type": "paragraph", "content": "Welcome to Akira Docs, the next-generation documentation platform powered by AI. This template will help you get started with creating your own documentation." }, { - "id": "4", + "id": "2", "type": "heading", "content": "Key Features", "metadata": { @@ -38,12 +25,7 @@ } }, { - "id": "5", - "type": "paragraph", - "content": "" - }, - { - "id": "6", + "id": "3", "type": "list", "content": [ "Easy to customize", @@ -56,12 +38,7 @@ } }, { - "id": "7", - "type": "paragraph", - "content": "" - }, - { - "id": "8", + "id": "4", "type": "callout", "content": "Start by customizing this template to match your project's needs!", "metadata": { diff --git a/docs/compiled/en/docs/_meta.json b/docs/compiled/en/docs/_meta.json index 04a6fce..adfd1cc 100644 --- a/docs/compiled/en/docs/_meta.json +++ b/docs/compiled/en/docs/_meta.json @@ -4,19 +4,6 @@ "title": "Introduction", "path": "/docs/introduction" }, - "seoAndPerformance": { - "title": "Seo-and-performance", - "items": { - "sitemapGeneration": { - "title": "Sitemap-generation", - "path": "/docs/seo-and-performance/sitemap-generation" - }, - "robotTxt": { - "title": "Robot-txt", - "path": "/docs/seo-and-performance/robot-txt" - } - } - }, "internationalization": { "title": "Internationalization", "items": { @@ -51,6 +38,28 @@ } } }, + "guides": { + "title": "Guides", + "items": { + "analytics": { + "title": "Analytics Integration", + "path": "/docs/guides/analytics" + } + } + }, + "seoAndPerformance": { + "title": "Seo-and-performance", + "items": { + "sitemapGeneration": { + "title": "Sitemap-generation", + "path": "/docs/seo-and-performance/sitemap-generation" + }, + "robotTxt": { + "title": "Robot-txt", + "path": "/docs/seo-and-performance/robot-txt" + } + } + }, "gettingStarted": { "title": "Getting-started", "items": { @@ -68,15 +77,6 @@ } } }, - "guides": { - "title": "Guides", - "items": { - "analytics": { - "title": "Analytics Integration", - "path": "/docs/guides/analytics" - } - } - }, "editor": { "title": "Editor", "items": { @@ -103,15 +103,6 @@ } } }, - "apiReference": { - "title": "Api-reference", - "items": { - "usageGuide": { - "title": "Usage-guide", - "path": "/docs/api-reference/usage-guide" - } - } - }, "contentManagement": { "title": "Content-management", "items": { @@ -120,5 +111,14 @@ "path": "/docs/content-management/creating-pages" } } + }, + "apiReference": { + "title": "Api-reference", + "items": { + "usageGuide": { + "title": "Usage-guide", + "path": "/docs/api-reference/usage-guide" + } + } } } \ No newline at end of file diff --git a/docs/compiled/en/docs/api-reference/usage-guide.json b/docs/compiled/en/docs/api-reference/usage-guide.json index cf62367..642ef37 100644 --- a/docs/compiled/en/docs/api-reference/usage-guide.json +++ b/docs/compiled/en/docs/api-reference/usage-guide.json @@ -1,5 +1,5 @@ { - "title": "", + "title": "API Documentation Guide", "description": "", "author": "Akira Team", "publishDate": "2024-11-26T00:00:00.000Z", @@ -14,23 +14,10 @@ { "id": "1", "type": "paragraph", - "content": "" - }, - { - "id": "2", - "type": "heading", - "content": "API Documentation Guide", - "metadata": { - "level": 1 - } - }, - { - "id": "3", - "type": "paragraph", "content": "Learn how to generate comprehensive API documentation using AkiraDocs." }, { - "id": "4", + "id": "2", "type": "heading", "content": "Quick Start", "metadata": { @@ -38,12 +25,7 @@ } }, { - "id": "5", - "type": "paragraph", - "content": "" - }, - { - "id": "6", + "id": "3", "type": "heading", "content": "Upload API Spec", "metadata": { @@ -51,12 +33,12 @@ } }, { - "id": "7", + "id": "4", "type": "paragraph", "content": "1. Place your OpenAPI/Swagger spec in:" }, { - "id": "8", + "id": "5", "type": "code", "content": "_contents/{language_code}/api/apiSpec.json", "metadata": { @@ -65,12 +47,12 @@ } }, { - "id": "9", + "id": "6", "type": "paragraph", "content": "2. AkiraDocs automatically generates documentation." }, { - "id": "10", + "id": "7", "type": "heading", "content": "Example API Spec", "metadata": { @@ -78,7 +60,7 @@ } }, { - "id": "11", + "id": "8", "type": "code", "content": "{\n \"openapi\": \"3.0.0\",\n \"info\": {\n \"title\": \"Sample API\",\n \"version\": \"1.0.0\"\n },\n \"paths\": {\n \"/users\": {\n \"get\": {\n \"summary\": \"Get users\",\n \"responses\": {\n \"200\": {\n \"description\": \"Success\"\n }\n }\n }\n }\n }\n}", "metadata": { @@ -87,12 +69,7 @@ } }, { - "id": "12", - "type": "paragraph", - "content": "" - }, - { - "id": "13", + "id": "9", "type": "heading", "content": "Generated Documentation", "metadata": { @@ -100,12 +77,7 @@ } }, { - "id": "14", - "type": "paragraph", - "content": "" - }, - { - "id": "15", + "id": "10", "type": "heading", "content": "Automatic Features", "metadata": { @@ -113,7 +85,7 @@ } }, { - "id": "16", + "id": "11", "type": "list", "content": [ "Interactive API explorer", @@ -126,12 +98,7 @@ } }, { - "id": "17", - "type": "paragraph", - "content": "" - }, - { - "id": "18", + "id": "12", "type": "heading", "content": "Example Output", "metadata": { @@ -139,7 +106,7 @@ } }, { - "id": "19", + "id": "13", "type": "code", "content": "// Example: Get Users\nconst response = await fetch('https://api.example.com/users', {\n method: 'GET',\n headers: {\n 'Authorization': 'Bearer YOUR_TOKEN'\n }\n});\n\nconst users = await response.json();", "metadata": { @@ -148,12 +115,7 @@ } }, { - "id": "20", - "type": "paragraph", - "content": "" - }, - { - "id": "21", + "id": "14", "type": "heading", "content": "Customization", "metadata": { @@ -161,12 +123,7 @@ } }, { - "id": "22", - "type": "paragraph", - "content": "" - }, - { - "id": "23", + "id": "15", "type": "heading", "content": "Theme Options", "metadata": { @@ -174,7 +131,7 @@ } }, { - "id": "24", + "id": "16", "type": "code", "content": "{\n \"api\": {\n \"docs\": {\n \"theme\": \"dark\",\n \"syntaxHighlight\": true,\n \"showExamples\": true\n }\n }\n}", "metadata": { @@ -183,12 +140,7 @@ } }, { - "id": "25", - "type": "paragraph", - "content": "" - }, - { - "id": "26", + "id": "17", "type": "heading", "content": "Language Selection", "metadata": { @@ -196,7 +148,7 @@ } }, { - "id": "27", + "id": "18", "type": "code", "content": "{\n \"api\": {\n \"examples\": {\n \"languages\": [\"javascript\", \"python\", \"curl\"]\n }\n }\n}", "metadata": { diff --git a/docs/compiled/en/docs/content-management/creating-pages.json b/docs/compiled/en/docs/content-management/creating-pages.json index 88e0bee..e0a3006 100644 --- a/docs/compiled/en/docs/content-management/creating-pages.json +++ b/docs/compiled/en/docs/content-management/creating-pages.json @@ -1,5 +1,5 @@ { - "title": "", + "title": "Creating and Organizing Pages", "description": "", "author": "Akira Team", "publishDate": "2024-11-26T00:00:00.000Z", @@ -14,23 +14,10 @@ { "id": "1", "type": "paragraph", - "content": "" - }, - { - "id": "2", - "type": "heading", - "content": "Creating and Organizing Pages", - "metadata": { - "level": 1 - } - }, - { - "id": "3", - "type": "paragraph", "content": "Learn how to create, structure, and organize your documentation pages in AkiraDocs. You can create markdown pages or just use the editor UI. Note in _contents folder, you will only see markdown content created by you. If you use Editor UI, the content will be saved in the compiled folder and will be automatically translated to other languages." }, { - "id": "4", + "id": "2", "type": "heading", "content": "Page Structure", "metadata": { @@ -38,12 +25,7 @@ } }, { - "id": "5", - "type": "paragraph", - "content": "" - }, - { - "id": "6", + "id": "3", "type": "heading", "content": "Basic Page Template", "metadata": { @@ -51,7 +33,7 @@ } }, { - "id": "7", + "id": "4", "type": "code", "content": "---\ntitle: Your Page Title\ndescription: Brief description of the page\nauthor: Your Name\npublishDate: 2024-11-26\nmodifiedDate: 2024-11-26\ncategory: Category Name\nkeywords:\n - keyword1\n - keyword2\n---\n\n# Main Title\n\nContent starts here...", "metadata": { @@ -60,12 +42,7 @@ } }, { - "id": "8", - "type": "paragraph", - "content": "" - }, - { - "id": "9", + "id": "5", "type": "heading", "content": "Directory Structure", "metadata": { @@ -73,7 +50,7 @@ } }, { - "id": "10", + "id": "6", "type": "code", "content": "folder_name/\n├── _contents/\n│ ├── en/\n│ │ ├── getting-started/\n│ │ ├── guides/\n│ │ └── api/", "metadata": { @@ -82,12 +59,12 @@ } }, { - "id": "11", + "id": "7", "type": "paragraph", "content": "You can just create pages for default language (en) and AkiraDocs will automatically translate them to other languages." }, { - "id": "12", + "id": "8", "type": "heading", "content": "Creating New Pages", "metadata": { @@ -95,12 +72,7 @@ } }, { - "id": "13", - "type": "paragraph", - "content": "" - }, - { - "id": "14", + "id": "9", "type": "heading", "content": "Method 1: Using the UI", "metadata": { @@ -108,12 +80,12 @@ } }, { - "id": "15", + "id": "10", "type": "paragraph", "content": "1. Click \"New Page\" in the sidebar\n2. Start adding content" }, { - "id": "16", + "id": "11", "type": "heading", "content": "Method 2: Direct File Creation", "metadata": { @@ -121,12 +93,12 @@ } }, { - "id": "17", + "id": "12", "type": "paragraph", "content": "1. Create a new `.md` file in the appropriate directory\n2. Add required frontmatter\n3. Write content using Markdown\n4. Save and compile" }, { - "id": "18", + "id": "13", "type": "heading", "content": "Page Organization", "metadata": { @@ -134,12 +106,7 @@ } }, { - "id": "19", - "type": "paragraph", - "content": "" - }, - { - "id": "20", + "id": "14", "type": "heading", "content": "Categories and Tags", "metadata": { @@ -147,7 +114,7 @@ } }, { - "id": "21", + "id": "15", "type": "list", "content": [ "Use consistent categories", @@ -160,12 +127,7 @@ } }, { - "id": "22", - "type": "paragraph", - "content": "" - }, - { - "id": "23", + "id": "16", "type": "heading", "content": "Navigation Structure", "metadata": { @@ -173,23 +135,18 @@ } }, { - "id": "24", + "id": "17", "type": "paragraph", "content": "This is automatically generated from the folder structure. You can customize it by editing the `_meta.json` file inside compiled folder." }, { - "id": "25", + "id": "18", "type": "code", "content": "{\n \"docs\": {\n \"getting-started\": {\n \"title\": \"Getting Started\",\n \"items\": {\n \"introduction\": {\n \"title\": \"Introduction\",\n \"path\": \"/docs/getting-started/introduction\"\n }\n }\n }\n }\n}", "metadata": { "language": "json", "showLineNumbers": true } - }, - { - "id": "26", - "type": "paragraph", - "content": "" } ] } \ No newline at end of file diff --git a/docs/compiled/en/docs/contributing/code-of-conduct.json b/docs/compiled/en/docs/contributing/code-of-conduct.json index 9552bb9..1f5e071 100644 --- a/docs/compiled/en/docs/contributing/code-of-conduct.json +++ b/docs/compiled/en/docs/contributing/code-of-conduct.json @@ -1,5 +1,5 @@ { - "title": "", + "title": "Code of Conduct", "description": "", "author": "Akira Team", "publishDate": "2024-11-26T00:00:00.000Z", @@ -12,26 +12,26 @@ "blocks": [ { "id": "1", - "type": "paragraph", - "content": "" - }, - { - "id": "2", "type": "heading", - "content": "Code of Conduct", + "content": "Our Pledge", "metadata": { - "level": 1 + "level": 2 } }, + { + "id": "2", + "type": "paragraph", + "content": "We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation." + }, { "id": "3", "type": "paragraph", - "content": "" + "content": "We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community." }, { "id": "4", "type": "heading", - "content": "Our Pledge", + "content": "Our Standards", "metadata": { "level": 2 } @@ -39,23 +39,25 @@ { "id": "5", "type": "paragraph", - "content": "We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.\n\nWe pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community." + "content": "Examples of behavior that contributes to a positive environment:" }, { "id": "6", - "type": "heading", - "content": "Our Standards", - "metadata": { - "level": 2 - } + "type": "paragraph", + "content": "* Demonstrating empathy and kindness toward other people\n* Being respectful of differing opinions, viewpoints, and experiences\n* Giving and gracefully accepting constructive feedback\n* Accepting responsibility and apologizing to those affected by our mistakes\n* Focusing on what is best for the overall community" }, { "id": "7", "type": "paragraph", - "content": "Examples of behavior that contributes to a positive environment:\n\n* Demonstrating empathy and kindness toward other people\n* Being respectful of differing opinions, viewpoints, and experiences\n* Giving and gracefully accepting constructive feedback\n* Accepting responsibility and apologizing to those affected by our mistakes\n* Focusing on what is best for the overall community\n\nExamples of unacceptable behavior:\n\n* The use of sexualized language or imagery, and sexual attention or advances\n* Trolling, insulting or derogatory comments, and personal or political attacks\n* Public or private harassment\n* Publishing others' private information without explicit permission\n* Other conduct which could reasonably be considered inappropriate in a professional setting" + "content": "Examples of unacceptable behavior:" }, { "id": "8", + "type": "paragraph", + "content": "* The use of sexualized language or imagery, and sexual attention or advances\n* Trolling, insulting or derogatory comments, and personal or political attacks\n* Public or private harassment\n* Publishing others' private information without explicit permission\n* Other conduct which could reasonably be considered inappropriate in a professional setting" + }, + { + "id": "9", "type": "heading", "content": "Enforcement Responsibilities", "metadata": { @@ -63,12 +65,12 @@ } }, { - "id": "9", + "id": "10", "type": "paragraph", "content": "Community leaders are responsible for clarifying and enforcing our standards of acceptable behavior and will take appropriate and fair corrective action in response to any behavior that they deem inappropriate, threatening, offensive, or harmful." }, { - "id": "10", + "id": "11", "type": "heading", "content": "Enforcement", "metadata": { @@ -76,12 +78,12 @@ } }, { - "id": "11", + "id": "12", "type": "paragraph", "content": "Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement. All complaints will be reviewed and investigated promptly and fairly." }, { - "id": "12", + "id": "13", "type": "heading", "content": "Attribution", "metadata": { @@ -89,7 +91,7 @@ } }, { - "id": "13", + "id": "14", "type": "paragraph", "content": "This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org), version 2.0, available at https://www.contributor-covenant.org/version/2/0/code_of_conduct.html." } diff --git a/docs/compiled/en/docs/contributing/how-to-contribute.json b/docs/compiled/en/docs/contributing/how-to-contribute.json index cf750a2..2464f2e 100644 --- a/docs/compiled/en/docs/contributing/how-to-contribute.json +++ b/docs/compiled/en/docs/contributing/how-to-contribute.json @@ -1,5 +1,5 @@ { - "title": "", + "title": "Contributing to AkiraDocs", "description": "", "author": "Akira Team", "publishDate": "2024-11-26T00:00:00.000Z", @@ -14,23 +14,10 @@ { "id": "1", "type": "paragraph", - "content": "" - }, - { - "id": "2", - "type": "heading", - "content": "Contributing to AkiraDocs", - "metadata": { - "level": 1 - } - }, - { - "id": "3", - "type": "paragraph", "content": "Guide to contributing to the AkiraDocs open-source project." }, { - "id": "4", + "id": "2", "type": "heading", "content": "Getting Started", "metadata": { @@ -38,12 +25,7 @@ } }, { - "id": "5", - "type": "paragraph", - "content": "" - }, - { - "id": "6", + "id": "3", "type": "heading", "content": "Setup Development Environment", "metadata": { @@ -51,21 +33,16 @@ } }, { - "id": "7", + "id": "4", "type": "code", - "content": "# Clone repository\ngit clone https://github.com/akiradocs/akiradocs\ncd akiradocs\n\n# Install dependencies\nnpm install\n\n# Start development server\nnpm run dev", + "content": "# Clone repository\ngit clone https://github.com/Cloud-Code-AI/akiradocs\ncd akiradocs\n\n# Install dependencies\nnpm install\n\n# Start development server\nnpm run dev", "metadata": { "language": "bash", "showLineNumbers": true } }, { - "id": "8", - "type": "paragraph", - "content": "" - }, - { - "id": "9", + "id": "5", "type": "heading", "content": "Contribution Guidelines", "metadata": { @@ -73,12 +50,7 @@ } }, { - "id": "10", - "type": "paragraph", - "content": "" - }, - { - "id": "11", + "id": "6", "type": "heading", "content": "Types of Contributions", "metadata": { @@ -86,7 +58,7 @@ } }, { - "id": "12", + "id": "7", "type": "list", "content": [ "Bug fixes", @@ -100,12 +72,7 @@ } }, { - "id": "13", - "type": "paragraph", - "content": "" - }, - { - "id": "14", + "id": "8", "type": "heading", "content": "Pull Request Process", "metadata": { @@ -113,12 +80,12 @@ } }, { - "id": "15", + "id": "9", "type": "paragraph", "content": "1. Fork the repository\n2. Create feature branch\n3. Make changes\n4. Submit pull request" }, { - "id": "16", + "id": "10", "type": "heading", "content": "Commit Messages", "metadata": { @@ -126,7 +93,7 @@ } }, { - "id": "17", + "id": "11", "type": "code", "content": "# Format\ntype(scope): description\n\n# Examples\nfeat(editor): add new block type\nfix(translation): correct language detection\ndocs(api): update authentication guide", "metadata": { @@ -135,12 +102,7 @@ } }, { - "id": "18", - "type": "paragraph", - "content": "" - }, - { - "id": "19", + "id": "12", "type": "heading", "content": "Development Guidelines", "metadata": { @@ -148,12 +110,7 @@ } }, { - "id": "20", - "type": "paragraph", - "content": "" - }, - { - "id": "21", + "id": "13", "type": "heading", "content": "Code Style", "metadata": { @@ -161,7 +118,7 @@ } }, { - "id": "22", + "id": "14", "type": "list", "content": [ "Follow existing patterns", @@ -174,12 +131,7 @@ } }, { - "id": "23", - "type": "paragraph", - "content": "" - }, - { - "id": "24", + "id": "15", "type": "heading", "content": "Testing", "metadata": { @@ -187,7 +139,7 @@ } }, { - "id": "25", + "id": "16", "type": "code", "content": "# Run tests\nnpm run test\n\n# Check types\nnpm run type-check\n\n# Lint code\nnpm run lint", "metadata": { @@ -196,12 +148,7 @@ } }, { - "id": "26", - "type": "paragraph", - "content": "" - }, - { - "id": "27", + "id": "17", "type": "heading", "content": "Documentation", "metadata": { @@ -209,12 +156,7 @@ } }, { - "id": "28", - "type": "paragraph", - "content": "" - }, - { - "id": "29", + "id": "18", "type": "heading", "content": "Update Docs", "metadata": { @@ -222,12 +164,12 @@ } }, { - "id": "30", + "id": "19", "type": "paragraph", "content": "1. Edit relevant files\n2. Update examples\n3. Check links\n4. Verify formatting" }, { - "id": "31", + "id": "20", "type": "heading", "content": "Create Examples", "metadata": { @@ -235,7 +177,7 @@ } }, { - "id": "32", + "id": "21", "type": "list", "content": [ "Clear and concise", @@ -248,12 +190,7 @@ } }, { - "id": "33", - "type": "paragraph", - "content": "" - }, - { - "id": "34", + "id": "22", "type": "heading", "content": "Getting Help", "metadata": { @@ -261,7 +198,7 @@ } }, { - "id": "35", + "id": "23", "type": "list", "content": [ "Join [Discord](https://discord.gg/zvYZukgeH2)", diff --git a/docs/compiled/en/docs/editor/features.json b/docs/compiled/en/docs/editor/features.json index c28d475..8b78b6d 100644 --- a/docs/compiled/en/docs/editor/features.json +++ b/docs/compiled/en/docs/editor/features.json @@ -1,5 +1,5 @@ { - "title": "", + "title": "Editor Features", "description": "", "author": "Akira Team", "publishDate": "2024-11-26T00:00:00.000Z", @@ -14,23 +14,10 @@ { "id": "1", "type": "paragraph", - "content": "" - }, - { - "id": "2", - "type": "heading", - "content": "Editor Features", - "metadata": { - "level": 1 - } - }, - { - "id": "3", - "type": "paragraph", "content": "Detailed overview of AkiraDocs editor capabilities and features." }, { - "id": "4", + "id": "2", "type": "heading", "content": "Block System", "metadata": { @@ -38,12 +25,7 @@ } }, { - "id": "5", - "type": "paragraph", - "content": "" - }, - { - "id": "6", + "id": "3", "type": "heading", "content": "Text Formatting", "metadata": { @@ -51,10 +33,10 @@ } }, { - "id": "7", + "id": "4", "type": "list", "content": [ - "**Basic Formatting**", + "Basic Formatting", "Bold, italic, underline", "Strikethrough", "Highlight", @@ -65,15 +47,10 @@ } }, { - "id": "8", - "type": "paragraph", - "content": "" - }, - { - "id": "9", + "id": "5", "type": "list", "content": [ - "**Advanced Formatting**", + "Advanced Formatting", "Custom colors", "Multiple fonts", "Text alignment", @@ -84,12 +61,7 @@ } }, { - "id": "10", - "type": "paragraph", - "content": "" - }, - { - "id": "11", + "id": "6", "type": "heading", "content": "Content Blocks", "metadata": { @@ -97,12 +69,7 @@ } }, { - "id": "12", - "type": "paragraph", - "content": "" - }, - { - "id": "13", + "id": "7", "type": "heading", "content": "Rich Text", "metadata": { @@ -110,7 +77,7 @@ } }, { - "id": "14", + "id": "8", "type": "code", "content": "# Heading 1\n## Heading 2\n> Blockquote\n- Bullet list\n1. Numbered list", "metadata": { @@ -119,12 +86,7 @@ } }, { - "id": "15", - "type": "paragraph", - "content": "" - }, - { - "id": "16", + "id": "9", "type": "heading", "content": "Code Blocks", "metadata": { @@ -132,7 +94,7 @@ } }, { - "id": "17", + "id": "10", "type": "code", "content": "// Syntax highlighting\nconsole.log('Hello World');", "metadata": { @@ -141,12 +103,7 @@ } }, { - "id": "18", - "type": "paragraph", - "content": "" - }, - { - "id": "19", + "id": "11", "type": "heading", "content": "Media Blocks", "metadata": { @@ -154,7 +111,7 @@ } }, { - "id": "20", + "id": "12", "type": "list", "content": [ "Image upload and embedding", @@ -167,12 +124,7 @@ } }, { - "id": "21", - "type": "paragraph", - "content": "" - }, - { - "id": "22", + "id": "13", "type": "heading", "content": "AI Features", "metadata": { @@ -180,12 +132,7 @@ } }, { - "id": "23", - "type": "paragraph", - "content": "" - }, - { - "id": "24", + "id": "14", "type": "heading", "content": "Content Enhancement", "metadata": { @@ -193,7 +140,7 @@ } }, { - "id": "25", + "id": "15", "type": "list", "content": [ "Grammar and style suggestions", @@ -206,12 +153,7 @@ } }, { - "id": "26", - "type": "paragraph", - "content": "" - }, - { - "id": "27", + "id": "16", "type": "heading", "content": "Smart Formatting", "metadata": { @@ -219,7 +161,7 @@ } }, { - "id": "28", + "id": "17", "type": "list", "content": [ "Auto-formatting", @@ -232,12 +174,7 @@ } }, { - "id": "29", - "type": "paragraph", - "content": "" - }, - { - "id": "30", + "id": "18", "type": "heading", "content": "Collaboration Features", "metadata": { @@ -245,12 +182,7 @@ } }, { - "id": "31", - "type": "paragraph", - "content": "" - }, - { - "id": "32", + "id": "19", "type": "heading", "content": "Version Control", "metadata": { @@ -258,7 +190,7 @@ } }, { - "id": "33", + "id": "20", "type": "list", "content": [ "Git integration", @@ -268,11 +200,6 @@ "metadata": { "listType": "unordered" } - }, - { - "id": "34", - "type": "paragraph", - "content": "" } ] } \ No newline at end of file diff --git a/docs/compiled/en/docs/editor/overview.json b/docs/compiled/en/docs/editor/overview.json index 86a7fab..db11b36 100644 --- a/docs/compiled/en/docs/editor/overview.json +++ b/docs/compiled/en/docs/editor/overview.json @@ -1,5 +1,5 @@ { - "title": "", + "title": "Editor Overview", "description": "", "author": "Akira Team", "publishDate": "2024-11-26T00:00:00.000Z", @@ -14,23 +14,10 @@ { "id": "1", "type": "paragraph", - "content": "" - }, - { - "id": "2", - "type": "heading", - "content": "Editor Overview", - "metadata": { - "level": 1 - } - }, - { - "id": "3", - "type": "paragraph", "content": "AkiraDocs features a modern, Notion-like editor that combines the simplicity of block-based editing with the power of Markdown." }, { - "id": "4", + "id": "2", "type": "heading", "content": "Editor Interface", "metadata": { @@ -38,12 +25,7 @@ } }, { - "id": "5", - "type": "paragraph", - "content": "" - }, - { - "id": "6", + "id": "3", "type": "heading", "content": "Main Components", "metadata": { @@ -51,25 +33,20 @@ } }, { - "id": "7", + "id": "4", "type": "list", "content": [ - "**Toolbar**: Quick access to formatting options and block types", - "**Content Area**: Block-based editing space", - "**Sidebar**: Navigation and document structure", - "**Command Palette**: Quick commands (Ctrl/Cmd + P)" + "Toolbar: Quick access to formatting options and block types", + "Content Area: Block-based editing space", + "Sidebar: Navigation and document structure", + "Command Palette: Quick commands (Ctrl/Cmd + P)" ], "metadata": { "listType": "unordered" } }, { - "id": "8", - "type": "paragraph", - "content": "" - }, - { - "id": "9", + "id": "5", "type": "heading", "content": "Block Structure", "metadata": { @@ -77,12 +54,12 @@ } }, { - "id": "10", + "id": "6", "type": "paragraph", "content": "Each content element is a block that can be:" }, { - "id": "11", + "id": "7", "type": "list", "content": [ "Dragged and dropped to reorganize", @@ -95,12 +72,7 @@ } }, { - "id": "12", - "type": "paragraph", - "content": "" - }, - { - "id": "13", + "id": "8", "type": "heading", "content": "Getting Started", "metadata": { @@ -108,12 +80,7 @@ } }, { - "id": "14", - "type": "paragraph", - "content": "" - }, - { - "id": "15", + "id": "9", "type": "heading", "content": "Creating Content", "metadata": { @@ -121,12 +88,12 @@ } }, { - "id": "16", + "id": "10", "type": "paragraph", "content": "1. Click the '+' button or press '/' to add a new block\n2. Choose block type from the popup menu\n3. Start typing or add content" }, { - "id": "17", + "id": "11", "type": "heading", "content": "Basic Operations", "metadata": { @@ -134,7 +101,7 @@ } }, { - "id": "18", + "id": "12", "type": "code", "content": "/ → Open block menu\n⌘/Ctrl + P → Command palette\n⌘/Ctrl + / → Show keyboard shortcuts\n↑↓ → Navigate between blocks", "metadata": { @@ -143,12 +110,7 @@ } }, { - "id": "19", - "type": "paragraph", - "content": "" - }, - { - "id": "20", + "id": "13", "type": "heading", "content": "Block Types", "metadata": { @@ -156,12 +118,7 @@ } }, { - "id": "21", - "type": "paragraph", - "content": "" - }, - { - "id": "22", + "id": "14", "type": "heading", "content": "Text Blocks", "metadata": { @@ -169,7 +126,7 @@ } }, { - "id": "23", + "id": "15", "type": "list", "content": [ "Paragraphs", @@ -183,12 +140,7 @@ } }, { - "id": "24", - "type": "paragraph", - "content": "" - }, - { - "id": "25", + "id": "16", "type": "heading", "content": "Rich Media", "metadata": { @@ -196,7 +148,7 @@ } }, { - "id": "26", + "id": "17", "type": "list", "content": [ "Images", @@ -210,12 +162,7 @@ } }, { - "id": "27", - "type": "paragraph", - "content": "" - }, - { - "id": "28", + "id": "18", "type": "heading", "content": "Special Blocks", "metadata": { @@ -223,7 +170,7 @@ } }, { - "id": "29", + "id": "19", "type": "list", "content": [ "Tables (Coming Soon)", @@ -233,11 +180,6 @@ "metadata": { "listType": "unordered" } - }, - { - "id": "30", - "type": "paragraph", - "content": "" } ] } \ No newline at end of file diff --git a/docs/compiled/en/docs/getting-started/features.json b/docs/compiled/en/docs/getting-started/features.json index 2226b34..919d785 100644 --- a/docs/compiled/en/docs/getting-started/features.json +++ b/docs/compiled/en/docs/getting-started/features.json @@ -1,5 +1,5 @@ { - "title": "", + "title": "AkiraDocs Features", "description": "", "author": "Akira Team", "publishDate": "2024-11-26T00:00:00.000Z", @@ -14,23 +14,10 @@ { "id": "1", "type": "paragraph", - "content": "" - }, - { - "id": "2", - "type": "heading", - "content": "AkiraDocs Features", - "metadata": { - "level": 1 - } - }, - { - "id": "3", - "type": "paragraph", "content": "A comprehensive overview of AkiraDocs' core features and capabilities." }, { - "id": "4", + "id": "2", "type": "heading", "content": "Content Creation & Management", "metadata": { @@ -38,29 +25,19 @@ } }, { - "id": "5", - "type": "paragraph", - "content": "" - }, - { - "id": "6", + "id": "3", "type": "list", "content": [ - "**Notion-like Editor**: Intuitive block-based interface with real-time preview", - "**Markdown Support**: Native Markdown and MDX compatibility", - "**Custom Components**: Create and reuse your own content blocks" + "Notion-like Editor: Intuitive block-based interface with real-time preview", + "Markdown Support: Native Markdown and MDX compatibility", + "Custom Components: Create and reuse your own content blocks" ], "metadata": { "listType": "unordered" } }, { - "id": "7", - "type": "paragraph", - "content": "" - }, - { - "id": "8", + "id": "4", "type": "heading", "content": "Internationalization & Translation", "metadata": { @@ -68,29 +45,19 @@ } }, { - "id": "9", - "type": "paragraph", - "content": "" - }, - { - "id": "10", + "id": "5", "type": "list", "content": [ - "**Multi-Language Support**: Maintain documentation in multiple languages", - "**AI-Powered Translation**: Automated, context-aware content translation", - "**Translation Management**: Built-in tools for managing localized content" + "Multi-Language Support: Maintain documentation in multiple languages", + "AI-Powered Translation: Automated, context-aware content translation", + "Translation Management: Built-in tools for managing localized content" ], "metadata": { "listType": "unordered" } }, { - "id": "11", - "type": "paragraph", - "content": "" - }, - { - "id": "12", + "id": "6", "type": "heading", "content": "Search & Discovery", "metadata": { @@ -98,29 +65,19 @@ } }, { - "id": "13", - "type": "paragraph", - "content": "" - }, - { - "id": "14", + "id": "7", "type": "list", "content": [ - "**AI-Powered Search**: Natural language question answering with context awareness", - "**SEO Optimization**: Automated SEO tools and optimizations", - "**Smart Indexing**: Real-time search index updates" + "AI-Powered Search: Natural language question answering with context awareness", + "SEO Optimization: Automated SEO tools and optimizations", + "Smart Indexing: Real-time search index updates" ], "metadata": { "listType": "unordered" } }, { - "id": "15", - "type": "paragraph", - "content": "" - }, - { - "id": "16", + "id": "8", "type": "heading", "content": "Build & Performance", "metadata": { @@ -128,29 +85,19 @@ } }, { - "id": "17", - "type": "paragraph", - "content": "" - }, - { - "id": "18", + "id": "9", "type": "list", "content": [ - "**Static Generation**: Optimized build process with asset optimization", - "**Developer Experience**: Fast refresh and comprehensive debugging tools", - "**Performance Focus**: Built-in best practices for speed and efficiency" + "Static Generation: Optimized build process with asset optimization", + "Developer Experience: Fast refresh and comprehensive debugging tools", + "Performance Focus: Built-in best practices for speed and efficiency" ], "metadata": { "listType": "unordered" } }, { - "id": "19", - "type": "paragraph", - "content": "" - }, - { - "id": "20", + "id": "10", "type": "heading", "content": "Enterprise Features (Coming Soon)", "metadata": { @@ -158,29 +105,19 @@ } }, { - "id": "21", - "type": "paragraph", - "content": "" - }, - { - "id": "22", + "id": "11", "type": "list", "content": [ - "**Security & Compliance**: SSO, RBAC, and audit logging", - "**Analytics & Insights**: Usage tracking and documentation metrics", - "**Team Collaboration**: Enterprise-grade collaboration tools" + "Security & Compliance: SSO, RBAC, and audit logging", + "Analytics & Insights: Usage tracking and documentation metrics", + "Team Collaboration: Enterprise-grade collaboration tools" ], "metadata": { "listType": "unordered" } }, { - "id": "23", - "type": "paragraph", - "content": "" - }, - { - "id": "24", + "id": "12", "type": "heading", "content": "Migration Support (Coming Soon)", "metadata": { @@ -188,36 +125,13 @@ } }, { - "id": "25", - "type": "paragraph", - "content": "" - }, - { - "id": "26", + "id": "13", "type": "code", "content": "# Supported platforms for easy migration\n✓ Nextra\n✓ GitBook\n✓ Docusaurus\n✓ ReadTheDocs", "metadata": { "language": "bash", "showLineNumbers": true } - }, - { - "id": "27", - "type": "paragraph", - "content": "" - }, - { - "id": "28", - "type": "heading", - "content": "Feature Comparison", - "metadata": { - "level": 2 - } - }, - { - "id": "29", - "type": "paragraph", - "content": "| Feature | AkiraDocs | Traditional Docs |\n|---------|-----------|------------------|\n| Notion-like Editor | ✓ | ✗ |\n| AI Translation | ✓ | ✗ |\n| AI Search | ✓ | ✗ |\n| Auto SEO | ✓ | Partial |\n| Markdown Support | ✓ | ✓ |\n| Build Optimization | ✓ | Varies |" } ] } \ No newline at end of file diff --git a/docs/compiled/en/docs/getting-started/quickstart.json b/docs/compiled/en/docs/getting-started/quickstart.json index 2287771..291504c 100644 --- a/docs/compiled/en/docs/getting-started/quickstart.json +++ b/docs/compiled/en/docs/getting-started/quickstart.json @@ -14,23 +14,10 @@ { "id": "1", "type": "paragraph", - "content": "" - }, - { - "id": "2", - "type": "heading", - "content": "Quick Start Guide", - "metadata": { - "level": 1 - } - }, - { - "id": "3", - "type": "paragraph", "content": "Get up and running with AkiraDocs in minutes." }, { - "id": "4", + "id": "2", "type": "heading", "content": "Quick Deploy", "metadata": { @@ -38,12 +25,7 @@ } }, { - "id": "5", - "type": "paragraph", - "content": "" - }, - { - "id": "6", + "id": "3", "type": "heading", "content": "Option 1: Deploy with Vercel", "metadata": { @@ -51,12 +33,17 @@ } }, { - "id": "7", + "id": "4", "type": "paragraph", - "content": "The fastest way to get started is using Vercel:\n\n[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2FCloud-Code-AI%2Fakiradocs-template)" + "content": "The fastest way to get started is using Vercel:" }, { - "id": "8", + "id": "5", + "type": "paragraph", + "content": "[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2FCloud-Code-AI%2Fakiradocs-template)" + }, + { + "id": "6", "type": "heading", "content": "Option 2: Using CLI", "metadata": { @@ -64,12 +51,12 @@ } }, { - "id": "9", + "id": "7", "type": "paragraph", "content": "Create a new project using our CLI:" }, { - "id": "10", + "id": "8", "type": "code", "content": "npx create-akiradocs@latest my-docs", "metadata": { @@ -78,12 +65,7 @@ } }, { - "id": "11", - "type": "paragraph", - "content": "" - }, - { - "id": "12", + "id": "9", "type": "heading", "content": "Basic Setup Steps", "metadata": { @@ -91,12 +73,12 @@ } }, { - "id": "13", + "id": "10", "type": "paragraph", - "content": "1. **Clone the Repository** (if not using Quick Deploy)" + "content": "1. Clone the Repository (if not using Quick Deploy)" }, { - "id": "14", + "id": "11", "type": "code", "content": "git clone https://github.com/your-org/akira-docs-template\ncd akira-docs-template", "metadata": { @@ -105,12 +87,12 @@ } }, { - "id": "15", + "id": "12", "type": "paragraph", - "content": "2. **Install Dependencies**" + "content": "2. Install Dependencies" }, { - "id": "16", + "id": "13", "type": "code", "content": "npm install\n# or\nyarn install", "metadata": { @@ -119,12 +101,12 @@ } }, { - "id": "17", + "id": "14", "type": "paragraph", - "content": "3. **Start Development Server**" + "content": "3. Start Development Server" }, { - "id": "18", + "id": "15", "type": "code", "content": "npm run dev\n# or\nyarn dev", "metadata": { @@ -133,12 +115,12 @@ } }, { - "id": "19", + "id": "16", "type": "paragraph", "content": "4. Open `http://localhost:3000` in your browser" }, { - "id": "20", + "id": "17", "type": "heading", "content": "Initial Configuration", "metadata": { @@ -146,12 +128,12 @@ } }, { - "id": "21", + "id": "18", "type": "paragraph", - "content": "1. **Update Site Configuration**\nEdit `akiradocs.config.json`:" + "content": "1. Update Site Configuration\nEdit `akiradocs.config.json`:" }, { - "id": "22", + "id": "19", "type": "code", "content": "{\n \"site\": {\n \"title\": \"Your Docs\",\n \"description\": \"Your documentation description\"\n }\n}", "metadata": { @@ -160,23 +142,18 @@ } }, { - "id": "23", + "id": "20", "type": "paragraph", - "content": "2. **Configure Translation** (Optional)" + "content": "2. Configure Translation (Optional)" }, { - "id": "24", + "id": "21", "type": "code", "content": "{\n \"translation\": {\n \"auto_translate\": true,\n \"provider\": \"anthropic\",\n \"targetLanguages\": [\"es\", \"fr\", \"de\"]\n }\n}", "metadata": { "language": "json", "showLineNumbers": true } - }, - { - "id": "25", - "type": "paragraph", - "content": "" } ] } \ No newline at end of file diff --git a/docs/compiled/en/docs/getting-started/requirements.json b/docs/compiled/en/docs/getting-started/requirements.json index 1c37ef0..84bc5c0 100644 --- a/docs/compiled/en/docs/getting-started/requirements.json +++ b/docs/compiled/en/docs/getting-started/requirements.json @@ -1,5 +1,5 @@ { - "title": "", + "title": "System Requirements", "description": "", "author": "Akira Team", "publishDate": "2024-11-26T00:00:00.000Z", @@ -14,23 +14,10 @@ { "id": "1", "type": "paragraph", - "content": "" - }, - { - "id": "2", - "type": "heading", - "content": "System Requirements", - "metadata": { - "level": 1 - } - }, - { - "id": "3", - "type": "paragraph", "content": "Before installing AkiraDocs, ensure your environment meets the following requirements." }, { - "id": "4", + "id": "2", "type": "heading", "content": "Minimum Requirements", "metadata": { @@ -38,12 +25,7 @@ } }, { - "id": "5", - "type": "paragraph", - "content": "" - }, - { - "id": "6", + "id": "3", "type": "heading", "content": "Node.js", "metadata": { @@ -51,7 +33,7 @@ } }, { - "id": "7", + "id": "4", "type": "list", "content": [ "Version: 16.x or higher", @@ -62,12 +44,7 @@ } }, { - "id": "8", - "type": "paragraph", - "content": "" - }, - { - "id": "9", + "id": "5", "type": "heading", "content": "System Memory", "metadata": { @@ -75,23 +52,18 @@ } }, { - "id": "10", + "id": "6", "type": "list", "content": [ - "Minimum: 4GB RAM", - "Recommended: 8GB RAM or more" + "Minimum: 2GB RAM", + "Recommended: 4GB RAM or more" ], "metadata": { "listType": "unordered" } }, { - "id": "11", - "type": "paragraph", - "content": "" - }, - { - "id": "12", + "id": "7", "type": "heading", "content": "Storage", "metadata": { @@ -99,23 +71,17 @@ } }, { - "id": "13", + "id": "8", "type": "list", "content": [ - "Minimum: 1GB free space", - "Recommended: 5GB+ for larger documentation projects" + "Recommended: 1GB free space" ], "metadata": { "listType": "unordered" } }, { - "id": "14", - "type": "paragraph", - "content": "" - }, - { - "id": "15", + "id": "9", "type": "heading", "content": "Software Dependencies", "metadata": { @@ -123,12 +89,7 @@ } }, { - "id": "16", - "type": "paragraph", - "content": "" - }, - { - "id": "17", + "id": "10", "type": "heading", "content": "Required", "metadata": { @@ -136,7 +97,7 @@ } }, { - "id": "18", + "id": "11", "type": "list", "content": [ "Git (latest version recommended)", @@ -148,12 +109,7 @@ } }, { - "id": "19", - "type": "paragraph", - "content": "" - }, - { - "id": "20", + "id": "12", "type": "heading", "content": "Optional", "metadata": { @@ -161,7 +117,7 @@ } }, { - "id": "21", + "id": "13", "type": "list", "content": [ "Docker (for containerized deployment)", @@ -172,12 +128,7 @@ } }, { - "id": "22", - "type": "paragraph", - "content": "" - }, - { - "id": "23", + "id": "14", "type": "heading", "content": "Development Environment", "metadata": { @@ -185,12 +136,7 @@ } }, { - "id": "24", - "type": "paragraph", - "content": "" - }, - { - "id": "25", + "id": "15", "type": "heading", "content": "Supported Operating Systems", "metadata": { @@ -198,7 +144,7 @@ } }, { - "id": "26", + "id": "16", "type": "list", "content": [ "macOS (10.15 or later)", @@ -210,12 +156,7 @@ } }, { - "id": "27", - "type": "paragraph", - "content": "" - }, - { - "id": "28", + "id": "17", "type": "heading", "content": "IDE/Editor Support", "metadata": { @@ -223,160 +164,16 @@ } }, { - "id": "29", + "id": "18", "type": "list", "content": [ - "VS Code (recommended)", - "WebStorm", + "VS Code (coming soon)", + "WebStorm (coming soon)", "Any text editor with Markdown support" ], "metadata": { "listType": "unordered" } - }, - { - "id": "30", - "type": "paragraph", - "content": "" - }, - { - "id": "31", - "type": "heading", - "content": "Network Requirements", - "metadata": { - "level": 2 - } - }, - { - "id": "32", - "type": "paragraph", - "content": "" - }, - { - "id": "33", - "type": "heading", - "content": "Cloud Features", - "metadata": { - "level": 3 - } - }, - { - "id": "34", - "type": "list", - "content": [ - "Stable internet connection", - "Access to npm registry", - "Access to GitHub (for version control)" - ], - "metadata": { - "listType": "unordered" - } - }, - { - "id": "35", - "type": "paragraph", - "content": "" - }, - { - "id": "36", - "type": "heading", - "content": "Enterprise Features", - "metadata": { - "level": 3 - } - }, - { - "id": "37", - "type": "list", - "content": [ - "Outbound HTTPS (443) access", - "WebSocket support", - "Custom domain (optional)" - ], - "metadata": { - "listType": "unordered" - } - }, - { - "id": "38", - "type": "paragraph", - "content": "" - }, - { - "id": "39", - "type": "heading", - "content": "Browser Support", - "metadata": { - "level": 2 - } - }, - { - "id": "40", - "type": "paragraph", - "content": "" - }, - { - "id": "41", - "type": "heading", - "content": "Desktop Browsers", - "metadata": { - "level": 3 - } - }, - { - "id": "42", - "type": "list", - "content": [ - "Chrome (last 2 versions)", - "Firefox (last 2 versions)", - "Safari (last 2 versions)", - "Edge (last 2 versions)" - ], - "metadata": { - "listType": "unordered" - } - }, - { - "id": "43", - "type": "paragraph", - "content": "" - }, - { - "id": "44", - "type": "heading", - "content": "Mobile Browsers", - "metadata": { - "level": 3 - } - }, - { - "id": "45", - "type": "list", - "content": [ - "iOS Safari", - "Android Chrome" - ], - "metadata": { - "listType": "unordered" - } - }, - { - "id": "46", - "type": "paragraph", - "content": "" - }, - { - "id": "47", - "type": "heading", - "content": "Verification", - "metadata": { - "level": 2 - } - }, - { - "id": "48", - "type": "paragraph", - "content": "Run the following command to check if your environment is ready:" } ] } \ No newline at end of file diff --git a/docs/compiled/en/docs/guides/analytics.json b/docs/compiled/en/docs/guides/analytics.json index 1c11f44..fdd0109 100644 --- a/docs/compiled/en/docs/guides/analytics.json +++ b/docs/compiled/en/docs/guides/analytics.json @@ -14,23 +14,10 @@ { "id": "1", "type": "paragraph", - "content": "" - }, - { - "id": "2", - "type": "heading", - "content": "Analytics Integration", - "metadata": { - "level": 1 - } - }, - { - "id": "3", - "type": "paragraph", "content": "AkiraDocs supports Google Analytics 4 (GA4) out of the box. This guide will help you set up analytics tracking for your documentation." }, { - "id": "4", + "id": "2", "type": "heading", "content": "Setting up Google Analytics", "metadata": { @@ -38,12 +25,12 @@ } }, { - "id": "5", + "id": "3", "type": "paragraph", "content": "1. Create a Google Analytics 4 property in your [Google Analytics account](https://analytics.google.com/)\n2. Get your Measurement ID (starts with \"G-\")\n3. Add the ID to your `akiradocs.config.json`:" }, { - "id": "6", + "id": "4", "type": "code", "content": "{\n\"analytics\": {\n\"google\": {\n\"measurementId\": \"G-XXXXXXXXXX\",\n\"enabled\": true\n},\n\"debug\": false\n}\n}", "metadata": { @@ -52,12 +39,7 @@ } }, { - "id": "7", - "type": "paragraph", - "content": "" - }, - { - "id": "8", + "id": "5", "type": "heading", "content": "What's Tracked Automatically", "metadata": { @@ -65,12 +47,7 @@ } }, { - "id": "9", - "type": "paragraph", - "content": "" - }, - { - "id": "10", + "id": "6", "type": "list", "content": [ "Page views", @@ -84,12 +61,7 @@ } }, { - "id": "11", - "type": "paragraph", - "content": "" - }, - { - "id": "12", + "id": "7", "type": "heading", "content": "Custom Event Tracking", "metadata": { @@ -97,12 +69,12 @@ } }, { - "id": "13", + "id": "8", "type": "paragraph", "content": "You can track custom events using the `useAnalytics` hook:" }, { - "id": "14", + "id": "9", "type": "code", "content": "import { useAnalytics } from '@/hooks/useAnalytics'\nfunction MyComponent() {\n const { track } = useAnalytics()\n const handleClick = () => {\n track('doc_rating', {\n rating: 5,\n page: 'getting-started',\n helpful: true\n })\n }\n return \n}", "metadata": { @@ -111,12 +83,7 @@ } }, { - "id": "15", - "type": "paragraph", - "content": "" - }, - { - "id": "16", + "id": "10", "type": "heading", "content": "Debug Mode", "metadata": { @@ -124,12 +91,12 @@ } }, { - "id": "17", + "id": "11", "type": "paragraph", "content": "Enable debug mode to see analytics events in the console during development:" }, { - "id": "18", + "id": "12", "type": "code", "content": "{\n\"analytics\": {\n\"debug\": true\n}\n}", "metadata": { @@ -138,7 +105,7 @@ } }, { - "id": "19", + "id": "13", "type": "paragraph", "content": "This provides a complete analytics integration that's easy for users to set up and extend as needed." } diff --git a/docs/compiled/en/docs/installation/configuration.json b/docs/compiled/en/docs/installation/configuration.json index fa554ac..1052ad2 100644 --- a/docs/compiled/en/docs/installation/configuration.json +++ b/docs/compiled/en/docs/installation/configuration.json @@ -1,5 +1,5 @@ { - "title": "", + "title": "Configuration Guide", "description": "", "author": "Akira Team", "publishDate": "2024-11-26T00:00:00.000Z", @@ -14,23 +14,10 @@ { "id": "1", "type": "paragraph", - "content": "" - }, - { - "id": "2", - "type": "heading", - "content": "Configuration Guide", - "metadata": { - "level": 1 - } - }, - { - "id": "3", - "type": "paragraph", "content": "Complete guide to configuring your AkiraDocs installation." }, { - "id": "4", + "id": "2", "type": "heading", "content": "Core Configuration", "metadata": { @@ -38,12 +25,7 @@ } }, { - "id": "5", - "type": "paragraph", - "content": "" - }, - { - "id": "6", + "id": "3", "type": "heading", "content": "Site Configuration", "metadata": { @@ -51,26 +33,21 @@ } }, { - "id": "7", + "id": "4", "type": "paragraph", "content": "Edit `akiradocs.config.json`:" }, { - "id": "8", + "id": "5", "type": "code", - "content": "{\n \"site\": {\n \"title\": \"Your Docs\",\n \"description\": \"Your documentation description\"\n },\n \"branding\": {\n \"logo\": {\n \"path\": \"/your_logo.svg\",\n \"width\": 120,\n \"height\": 30,\n \"show\": true\n },\n \"favicon\": {\n \"path\": \"/favicon.png\",\n \"show\": true\n }\n }\n}", + "content": "{\n \"url\": \"https://docs.akiradocs.com\",\n \"site\": {\n \"title\": \"Your Docs\",\n \"description\": \"Your documentation description\"\n },\n \"branding\": {\n \"logo\": {\n \"path\": \"/your_logo.svg\",\n \"width\": 120,\n \"height\": 30,\n \"show\": true\n },\n \"favicon\": {\n \"path\": \"/favicon.png\",\n \"show\": true\n }\n }\n}", "metadata": { "language": "json", "showLineNumbers": true } }, { - "id": "9", - "type": "paragraph", - "content": "" - }, - { - "id": "10", + "id": "6", "type": "heading", "content": "Navigation Setup", "metadata": { @@ -78,7 +55,7 @@ } }, { - "id": "11", + "id": "7", "type": "code", "content": "{\n \"navigation\": {\n \"header\": {\n \"items\": [\n { \"label\": \"Docs\", \"href\": \"/docs\", \"icon\": \"/docs.svg\" },\n { \"label\": \"API\", \"href\": \"/api\", \"icon\": \"/api.svg\" }\n ]\n }\n }\n}", "metadata": { @@ -87,12 +64,7 @@ } }, { - "id": "12", - "type": "paragraph", - "content": "" - }, - { - "id": "13", + "id": "8", "type": "heading", "content": "Internationalization", "metadata": { @@ -100,12 +72,7 @@ } }, { - "id": "14", - "type": "paragraph", - "content": "" - }, - { - "id": "15", + "id": "9", "type": "heading", "content": "Language Configuration", "metadata": { @@ -113,18 +80,13 @@ } }, { - "id": "16", + "id": "10", "type": "code", "content": "{\n \"localization\": {\n \"defaultLocale\": \"en\",\n \"fallbackLocale\": \"en\",\n \"locales\": [\n {\n \"code\": \"en\",\n \"name\": \"English\",\n \"flag\": \"đŸ‡ș🇾\"\n },\n {\n \"code\": \"es\",\n \"name\": \"Español\",\n \"flag\": \"đŸ‡Ș🇾\"\n },\n {\n \"code\": \"fr\",\n \"name\": \"Français\",\n \"flag\": \"đŸ‡«đŸ‡·\"\n },\n {\n \"code\": \"de\",\n \"name\": \"Deutsch\",\n \"flag\": \"đŸ‡©đŸ‡Ș\"\n }\n ]\n },\n \"translation\": {\n \"auto_translate\": true,\n \"provider\": \"anthropic\",\n \"model\": \"claude-3-sonnet-20240229\",\n \"targetLanguages\": [\"es\", \"fr\", \"de\"],\n \"excludedPaths\": [\"_meta.json\"]\n },\n}", "metadata": { "language": "json", "showLineNumbers": true } - }, - { - "id": "17", - "type": "paragraph", - "content": "" } ] } \ No newline at end of file diff --git a/docs/compiled/en/docs/installation/setup.json b/docs/compiled/en/docs/installation/setup.json index 8ae61a7..9363af7 100644 --- a/docs/compiled/en/docs/installation/setup.json +++ b/docs/compiled/en/docs/installation/setup.json @@ -1,5 +1,5 @@ { - "title": "", + "title": "Detailed Installation Guide", "description": "", "author": "Akira Team", "publishDate": "2024-11-26T00:00:00.000Z", @@ -14,23 +14,10 @@ { "id": "1", "type": "paragraph", - "content": "" - }, - { - "id": "2", - "type": "heading", - "content": "Detailed Installation Guide", - "metadata": { - "level": 1 - } - }, - { - "id": "3", - "type": "paragraph", "content": "Complete guide to installing AkiraDocs in different environments." }, { - "id": "4", + "id": "2", "type": "heading", "content": "Prerequisites", "metadata": { @@ -38,12 +25,12 @@ } }, { - "id": "5", + "id": "3", "type": "paragraph", "content": "Ensure your system meets the [requirements](../getting-started/requirements.md) before proceeding." }, { - "id": "6", + "id": "4", "type": "heading", "content": "Installation Methods", "metadata": { @@ -51,12 +38,7 @@ } }, { - "id": "7", - "type": "paragraph", - "content": "" - }, - { - "id": "8", + "id": "5", "type": "heading", "content": "1. Local Development Setup", "metadata": { @@ -64,26 +46,26 @@ } }, { - "id": "9", + "id": "6", "type": "paragraph", - "content": "1. **Clone the Repository**" + "content": "1. Create New Project" }, { - "id": "10", + "id": "7", "type": "code", - "content": "git clone https://github.com/your-org/akira-docs-template\ncd akira-docs-template", + "content": "npx create-akiradocs@latest my-docs-site\ncd my-docs-site", "metadata": { "language": "bash", "showLineNumbers": true } }, { - "id": "11", + "id": "8", "type": "paragraph", - "content": "2. **Install Dependencies**" + "content": "2. Install Dependencies\nDependencies are automatically installed during project creation. If you need to reinstall:" }, { - "id": "12", + "id": "9", "type": "code", "content": "npm install", "metadata": { @@ -92,81 +74,40 @@ } }, { - "id": "13", - "type": "paragraph", - "content": "3. **Create Environment File**" - }, - { - "id": "14", - "type": "code", - "content": "cp .env.example .env.local", - "metadata": { - "language": "bash", - "showLineNumbers": true - } - }, - { - "id": "15", - "type": "paragraph", - "content": "4. **Configure Environment Variables**" - }, - { - "id": "16", - "type": "code", - "content": "NEXT_PUBLIC_API_URL=your_api_url\nNEXT_PUBLIC_SITE_URL=your_site_url", - "metadata": { - "language": "env", - "showLineNumbers": true - } - }, - { - "id": "17", + "id": "10", "type": "paragraph", - "content": "" + "content": "3. Create Environment File\nThe environment file is created automatically. You can modify it at `.env.local`" }, { - "id": "18", - "type": "heading", - "content": "2. Docker Installation", - "metadata": { - "level": 3 - } - }, - { - "id": "19", + "id": "11", "type": "paragraph", - "content": "1. **Pull the Docker Image**" + "content": "4. Start Development Server" }, { - "id": "20", + "id": "12", "type": "code", - "content": "docker pull akiradocs/akiradocs:latest", + "content": "npm run dev", "metadata": { "language": "bash", "showLineNumbers": true } }, { - "id": "21", + "id": "13", "type": "paragraph", - "content": "2. **Run the Container**" + "content": "5. Update AkiraDocs\nTo update an existing installation to the latest version:" }, { - "id": "22", + "id": "14", "type": "code", - "content": "docker run -p 3000:3000 akiradocs/akiradocs:latest", + "content": "npx create-akiradocs@latest update", "metadata": { "language": "bash", "showLineNumbers": true } }, { - "id": "23", - "type": "paragraph", - "content": "" - }, - { - "id": "24", + "id": "15", "type": "heading", "content": "3. Cloud Platform Deployment", "metadata": { @@ -174,12 +115,7 @@ } }, { - "id": "25", - "type": "paragraph", - "content": "" - }, - { - "id": "26", + "id": "16", "type": "heading", "content": "Vercel", "metadata": { @@ -187,12 +123,12 @@ } }, { - "id": "27", + "id": "17", "type": "paragraph", "content": "1. Fork the repository\n2. Connect to Vercel\n3. Configure environment variables\n4. Deploy" }, { - "id": "28", + "id": "18", "type": "heading", "content": "Other Platforms", "metadata": { @@ -200,25 +136,20 @@ } }, { - "id": "29", + "id": "19", "type": "list", "content": [ - "AWS Amplify", - "Netlify", - "Digital Ocean", - "Custom server" + "AWS Amplify (Coming Soon)", + "Netlify (Coming Soon)", + "Digital Ocean (Coming Soon)", + "Custom server (Coming Soon)" ], "metadata": { "listType": "unordered" } }, { - "id": "30", - "type": "paragraph", - "content": "" - }, - { - "id": "31", + "id": "20", "type": "heading", "content": "Post-Installation Steps", "metadata": { @@ -226,12 +157,12 @@ } }, { - "id": "32", + "id": "21", "type": "paragraph", - "content": "1. **Verify Installation**" + "content": "1. Verify Installation" }, { - "id": "33", + "id": "22", "type": "code", "content": "npm run build\nnpm run start", "metadata": { @@ -240,12 +171,12 @@ } }, { - "id": "34", + "id": "23", "type": "paragraph", - "content": "2. **Configure Git Integration**" + "content": "2. Configure Git Integration" }, { - "id": "35", + "id": "24", "type": "code", "content": "git remote add origin your-repository-url", "metadata": { @@ -254,12 +185,12 @@ } }, { - "id": "36", + "id": "25", "type": "paragraph", - "content": "3. **Setup Content Directory**" + "content": "3. Setup Content Directory" }, { - "id": "37", + "id": "26", "type": "code", "content": "mkdir -p docs/_contents/en", "metadata": { @@ -268,12 +199,7 @@ } }, { - "id": "38", - "type": "paragraph", - "content": "" - }, - { - "id": "39", + "id": "27", "type": "heading", "content": "Environment-Specific Configurations", "metadata": { @@ -281,12 +207,7 @@ } }, { - "id": "40", - "type": "paragraph", - "content": "" - }, - { - "id": "41", + "id": "28", "type": "heading", "content": "Development", "metadata": { @@ -294,7 +215,7 @@ } }, { - "id": "42", + "id": "29", "type": "code", "content": "NODE_ENV=development\nDEBUG=true", "metadata": { @@ -303,12 +224,7 @@ } }, { - "id": "43", - "type": "paragraph", - "content": "" - }, - { - "id": "44", + "id": "30", "type": "heading", "content": "Production", "metadata": { @@ -316,7 +232,7 @@ } }, { - "id": "45", + "id": "31", "type": "code", "content": "NODE_ENV=production\nDEBUG=false", "metadata": { @@ -325,12 +241,7 @@ } }, { - "id": "46", - "type": "paragraph", - "content": "" - }, - { - "id": "47", + "id": "32", "type": "heading", "content": "Testing", "metadata": { @@ -338,37 +249,13 @@ } }, { - "id": "48", + "id": "33", "type": "code", "content": "NODE_ENV=test\nTEST_MODE=true", "metadata": { "language": "env", "showLineNumbers": true } - }, - { - "id": "49", - "type": "paragraph", - "content": "" - }, - { - "id": "50", - "type": "heading", - "content": "Next Steps", - "metadata": { - "level": 2 - } - }, - { - "id": "51", - "type": "list", - "content": [ - "[Configuration Guide](./configuration.md)", - "[Troubleshooting](./troubleshooting.md)" - ], - "metadata": { - "listType": "unordered" - } } ] } \ No newline at end of file diff --git a/docs/compiled/en/docs/installation/troubleshooting.json b/docs/compiled/en/docs/installation/troubleshooting.json index de6ba03..3d5f8d0 100644 --- a/docs/compiled/en/docs/installation/troubleshooting.json +++ b/docs/compiled/en/docs/installation/troubleshooting.json @@ -1,5 +1,5 @@ { - "title": "", + "title": "Troubleshooting Guide", "description": "", "author": "Akira Team", "publishDate": "2024-11-26T00:00:00.000Z", @@ -14,23 +14,10 @@ { "id": "1", "type": "paragraph", - "content": "" - }, - { - "id": "2", - "type": "heading", - "content": "Troubleshooting Guide", - "metadata": { - "level": 1 - } - }, - { - "id": "3", - "type": "paragraph", "content": "Common issues and their solutions when setting up AkiraDocs." }, { - "id": "4", + "id": "2", "type": "heading", "content": "Common Installation Issues", "metadata": { @@ -38,12 +25,7 @@ } }, { - "id": "5", - "type": "paragraph", - "content": "" - }, - { - "id": "6", + "id": "3", "type": "heading", "content": "Node.js Version Mismatch", "metadata": { @@ -51,12 +33,12 @@ } }, { - "id": "7", + "id": "4", "type": "paragraph", - "content": "**Problem**: Error about Node.js version compatibility" + "content": "Problem: Error about Node.js version compatibility" }, { - "id": "8", + "id": "5", "type": "code", "content": "Error: The engine \"node\" is incompatible with this module", "metadata": { @@ -65,12 +47,12 @@ } }, { - "id": "9", + "id": "6", "type": "paragraph", - "content": "**Solution**:\n1. Check your Node.js version:" + "content": "Solution:\n1. Check your Node.js version:" }, { - "id": "10", + "id": "7", "type": "code", "content": "node --version", "metadata": { @@ -79,12 +61,12 @@ } }, { - "id": "11", + "id": "8", "type": "paragraph", "content": "2. Install the correct version (16.x or higher)\n3. Use nvm to manage Node.js versions:" }, { - "id": "12", + "id": "9", "type": "code", "content": "nvm install 20\nnvm use 20", "metadata": { @@ -93,12 +75,7 @@ } }, { - "id": "13", - "type": "paragraph", - "content": "" - }, - { - "id": "14", + "id": "10", "type": "heading", "content": "Dependencies Installation Failed", "metadata": { @@ -106,12 +83,17 @@ } }, { - "id": "15", + "id": "11", "type": "paragraph", - "content": "**Problem**: npm install fails with errors\n\n**Solution**:\n1. Clear npm cache:" + "content": "Problem: npm install fails with errors" }, { - "id": "16", + "id": "12", + "type": "paragraph", + "content": "Solution:\n1. Clear npm cache:" + }, + { + "id": "13", "type": "code", "content": "npm cache clean --force", "metadata": { @@ -120,12 +102,12 @@ } }, { - "id": "17", + "id": "14", "type": "paragraph", "content": "2. Delete node_modules and package-lock.json:" }, { - "id": "18", + "id": "15", "type": "code", "content": "rm -rf node_modules package-lock.json\nnpm install", "metadata": { @@ -134,12 +116,7 @@ } }, { - "id": "19", - "type": "paragraph", - "content": "" - }, - { - "id": "20", + "id": "16", "type": "heading", "content": "Build Issues", "metadata": { @@ -147,12 +124,7 @@ } }, { - "id": "21", - "type": "paragraph", - "content": "" - }, - { - "id": "22", + "id": "17", "type": "heading", "content": "Build Fails", "metadata": { @@ -160,12 +132,17 @@ } }, { - "id": "23", + "id": "18", "type": "paragraph", - "content": "**Problem**: `npm run build` fails\n\n**Solution**:\n1. Check for TypeScript errors:" + "content": "Problem: `npm run build` fails" }, { - "id": "24", + "id": "19", + "type": "paragraph", + "content": "Solution:\n1. Check for TypeScript errors:" + }, + { + "id": "20", "type": "code", "content": "npm run type-check", "metadata": { @@ -174,12 +151,12 @@ } }, { - "id": "25", + "id": "21", "type": "paragraph", "content": "2. Verify environment variables are set correctly\n3. Clear next.js cache:" }, { - "id": "26", + "id": "22", "type": "code", "content": "rm -rf .next", "metadata": { @@ -188,12 +165,7 @@ } }, { - "id": "27", - "type": "paragraph", - "content": "" - }, - { - "id": "28", + "id": "23", "type": "heading", "content": "Static Export Issues", "metadata": { @@ -201,12 +173,17 @@ } }, { - "id": "29", + "id": "24", "type": "paragraph", - "content": "**Problem**: Static export fails with dynamic routes\n\n**Solution**:\n1. Configure `next.config.js`:" + "content": "Problem: Static export fails with dynamic routes" }, { - "id": "30", + "id": "25", + "type": "paragraph", + "content": "Solution:\n1. Configure `next.config.js`:" + }, + { + "id": "26", "type": "code", "content": "module.exports = {\n output: 'export',\n images: {\n unoptimized: true\n }\n}", "metadata": { @@ -215,12 +192,7 @@ } }, { - "id": "31", - "type": "paragraph", - "content": "" - }, - { - "id": "32", + "id": "27", "type": "heading", "content": "Translation Issues", "metadata": { @@ -228,12 +200,7 @@ } }, { - "id": "33", - "type": "paragraph", - "content": "" - }, - { - "id": "34", + "id": "28", "type": "heading", "content": "AI Translation Not Working", "metadata": { @@ -241,12 +208,17 @@ } }, { - "id": "35", + "id": "29", "type": "paragraph", - "content": "**Problem**: Automatic translation fails\n\n**Solution**:\n1. Verify API keys are set correctly\n2. Check translation configuration:" + "content": "Problem: Automatic translation fails" }, { - "id": "36", + "id": "30", + "type": "paragraph", + "content": "Solution:\n1. Verify API keys are set correctly\n2. Check translation configuration:" + }, + { + "id": "31", "type": "code", "content": "{\n \"translation\": {\n \"auto_translate\": true,\n \"provider\": \"anthropic\",\n \"targetLanguages\": [\"es\", \"fr\", \"de\"]\n }\n}", "metadata": { @@ -255,12 +227,7 @@ } }, { - "id": "37", - "type": "paragraph", - "content": "" - }, - { - "id": "38", + "id": "32", "type": "heading", "content": "Content Issues", "metadata": { @@ -268,12 +235,7 @@ } }, { - "id": "39", - "type": "paragraph", - "content": "" - }, - { - "id": "40", + "id": "33", "type": "heading", "content": "Content Not Updating", "metadata": { @@ -281,12 +243,17 @@ } }, { - "id": "41", + "id": "34", "type": "paragraph", - "content": "**Problem**: Changes to content files not reflecting\n\n**Solution**:\nContent changes are built on build time. If you are using the local development server, you need to restart the server after making changes.\n1. Clear the cache:" + "content": "Problem: Changes to content files not reflecting" }, { - "id": "42", + "id": "35", + "type": "paragraph", + "content": "Solution:\nContent changes are built on build time. If you are using the local development server, you need to restart the server after making changes.\n1. Clear the cache:" + }, + { + "id": "36", "type": "code", "content": "npm run clean", "metadata": { @@ -295,12 +262,12 @@ } }, { - "id": "43", + "id": "37", "type": "paragraph", "content": "2. Restart the development server\n3. Check file permissions" }, { - "id": "44", + "id": "38", "type": "heading", "content": "Deployment Issues", "metadata": { @@ -308,12 +275,7 @@ } }, { - "id": "45", - "type": "paragraph", - "content": "" - }, - { - "id": "46", + "id": "39", "type": "heading", "content": "Vercel Deployment Failed", "metadata": { @@ -321,12 +283,17 @@ } }, { - "id": "47", + "id": "40", + "type": "paragraph", + "content": "Problem: Deployment to Vercel fails" + }, + { + "id": "41", "type": "paragraph", - "content": "**Problem**: Deployment to Vercel fails\n\n**Solution**:\n1. Check build logs\n2. Verify environment variables are set in Vercel dashboard\n3. Ensure all dependencies are listed in package.json" + "content": "Solution:\n1. Check build logs\n2. Verify environment variables are set in Vercel dashboard\n3. Ensure all dependencies are listed in package.json" }, { - "id": "48", + "id": "42", "type": "heading", "content": "Getting Help", "metadata": { @@ -334,9 +301,14 @@ } }, { - "id": "49", + "id": "43", + "type": "paragraph", + "content": "If you're still experiencing issues:" + }, + { + "id": "44", "type": "paragraph", - "content": "If you're still experiencing issues:\n\n1. Check our [GitHub Issues](https://github.com/Cloud-Code-AI/Akiradocs/issues)\n2. Join our [Discord Community](https://discord.gg/zvYZukgeH2)\n3. Contact [Support](mailto:saurav.panda@akiradocs.ai)" + "content": "1. Check our [GitHub Issues](https://github.com/Cloud-Code-AI/Akiradocs/issues)\n2. Join our [Discord Community](https://discord.gg/zvYZukgeH2)\n3. Contact [Support](mailto:saurav.panda@akiradocs.ai)" } ] } \ No newline at end of file diff --git a/docs/compiled/en/docs/internationalization/ai-translation.json b/docs/compiled/en/docs/internationalization/ai-translation.json index 8506a3b..d8d2e13 100644 --- a/docs/compiled/en/docs/internationalization/ai-translation.json +++ b/docs/compiled/en/docs/internationalization/ai-translation.json @@ -1,5 +1,5 @@ { - "title": "", + "title": "AI-Powered Translation", "description": "", "author": "Akira Team", "publishDate": "2024-11-26T00:00:00.000Z", @@ -14,23 +14,10 @@ { "id": "1", "type": "paragraph", - "content": "" - }, - { - "id": "2", - "type": "heading", - "content": "AI-Powered Translation", - "metadata": { - "level": 1 - } - }, - { - "id": "3", - "type": "paragraph", "content": "Guide to using AkiraDocs' AI translation capabilities." }, { - "id": "4", + "id": "2", "type": "heading", "content": "Setup", "metadata": { @@ -38,12 +25,7 @@ } }, { - "id": "5", - "type": "paragraph", - "content": "" - }, - { - "id": "6", + "id": "3", "type": "heading", "content": "Configuration", "metadata": { @@ -51,7 +33,7 @@ } }, { - "id": "7", + "id": "4", "type": "code", "content": "{\n \"translation\": {\n \"auto_translate\": true,\n \"provider\": \"anthropic\",\n \"model\": \"claude-3-sonnet-20240229\",\n \"targetLanguages\": [\"es\", \"fr\", \"de\"],\n \"excludedPaths\": [\"_meta.json\"]\n }\n}", "metadata": { @@ -60,12 +42,7 @@ } }, { - "id": "8", - "type": "paragraph", - "content": "" - }, - { - "id": "9", + "id": "5", "type": "heading", "content": "API Setup", "metadata": { @@ -73,7 +50,7 @@ } }, { - "id": "10", + "id": "6", "type": "code", "content": "ANTHROPIC_API_KEY=your_api_key", "metadata": { @@ -82,12 +59,7 @@ } }, { - "id": "11", - "type": "paragraph", - "content": "" - }, - { - "id": "12", + "id": "7", "type": "heading", "content": "Features", "metadata": { @@ -95,12 +67,7 @@ } }, { - "id": "13", - "type": "paragraph", - "content": "" - }, - { - "id": "14", + "id": "8", "type": "heading", "content": "Automatic Translation", "metadata": { @@ -108,7 +75,7 @@ } }, { - "id": "15", + "id": "9", "type": "list", "content": [ "Content translation during build", @@ -119,11 +86,6 @@ "metadata": { "listType": "unordered" } - }, - { - "id": "16", - "type": "paragraph", - "content": "" } ] } \ No newline at end of file diff --git a/docs/compiled/en/docs/internationalization/managing-translation.json b/docs/compiled/en/docs/internationalization/managing-translation.json index 54223f9..9c7d44b 100644 --- a/docs/compiled/en/docs/internationalization/managing-translation.json +++ b/docs/compiled/en/docs/internationalization/managing-translation.json @@ -1,5 +1,5 @@ { - "title": "", + "title": "Managing Translations", "description": "", "author": "Akira Team", "publishDate": "2024-11-26T00:00:00.000Z", @@ -14,23 +14,10 @@ { "id": "1", "type": "paragraph", - "content": "" - }, - { - "id": "2", - "type": "heading", - "content": "Managing Translations", - "metadata": { - "level": 1 - } - }, - { - "id": "3", - "type": "paragraph", "content": "Learn how to effectively manage and maintain translated content in AkiraDocs." }, { - "id": "4", + "id": "2", "type": "heading", "content": "Translation Workflow", "metadata": { @@ -38,12 +25,7 @@ } }, { - "id": "5", - "type": "paragraph", - "content": "" - }, - { - "id": "6", + "id": "3", "type": "heading", "content": "Automatic Translation", "metadata": { @@ -51,12 +33,12 @@ } }, { - "id": "7", + "id": "4", "type": "paragraph", "content": "1. Create content in source language\n2. Enable auto-translation in config\n3. Build/deploy to generate translations\n4. Review and refine translations" }, { - "id": "8", + "id": "5", "type": "heading", "content": "Manual Translation", "metadata": { @@ -64,12 +46,12 @@ } }, { - "id": "9", + "id": "6", "type": "paragraph", "content": "1. Create language-specific directories\n2. Copy source content\n3. Translate manually\n4. Update metadata" }, { - "id": "10", + "id": "7", "type": "heading", "content": "Content Organization", "metadata": { @@ -77,12 +59,7 @@ } }, { - "id": "11", - "type": "paragraph", - "content": "" - }, - { - "id": "12", + "id": "8", "type": "heading", "content": "File Structure", "metadata": { @@ -90,7 +67,7 @@ } }, { - "id": "13", + "id": "9", "type": "code", "content": "_contents/\n├── en/\n│ └── docs/\n│ ├── intro.md\n│ └── guide.md\n├── es/\n│ └── docs/\n│ ├── intro.md\n│ └── guide.md\n└── fr/\n └── docs/\n ├── intro.md\n └── guide.md", "metadata": { @@ -99,34 +76,7 @@ } }, { - "id": "14", - "type": "paragraph", - "content": "" - }, - { - "id": "15", - "type": "heading", - "content": "Translation Status Tracking", - "metadata": { - "level": 3 - } - }, - { - "id": "16", - "type": "code", - "content": "{\n \"translationStatus\": {\n \"es\": {\n \"completion\": \"85%\",\n \"lastUpdated\": \"2024-11-26\",\n \"pendingFiles\": [\"advanced/config.md\"]\n }\n }\n}", - "metadata": { - "language": "json", - "showLineNumbers": true - } - }, - { - "id": "17", - "type": "paragraph", - "content": "" - }, - { - "id": "18", + "id": "10", "type": "heading", "content": "Quality Control", "metadata": { @@ -134,12 +84,7 @@ } }, { - "id": "19", - "type": "paragraph", - "content": "" - }, - { - "id": "20", + "id": "11", "type": "heading", "content": "Review Process", "metadata": { @@ -147,12 +92,12 @@ } }, { - "id": "21", + "id": "12", "type": "paragraph", "content": "1. AI Translation\n2. Human Review\n3. Technical Verification\n4. Publication" }, { - "id": "22", + "id": "13", "type": "heading", "content": "Version Control", "metadata": { @@ -160,7 +105,7 @@ } }, { - "id": "23", + "id": "14", "type": "list", "content": [ "Track changes across languages", @@ -170,11 +115,6 @@ "metadata": { "listType": "unordered" } - }, - { - "id": "24", - "type": "paragraph", - "content": "" } ] } \ No newline at end of file diff --git a/docs/compiled/en/docs/internationalization/setup.json b/docs/compiled/en/docs/internationalization/setup.json index e3f021b..ed786cf 100644 --- a/docs/compiled/en/docs/internationalization/setup.json +++ b/docs/compiled/en/docs/internationalization/setup.json @@ -1,16 +1,116 @@ { - "title": "", + "title": "Setting Up Internationalization", "description": "", - "author": "Anonymous", - "publishDate": "2024-11-29", - "modifiedDate": "2024-11-29", - "category": "", - "keywords": [], + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Internationalization", + "keywords": [ + "i18n", + "Setup", + "Languages" + ], "blocks": [ { "id": "1", "type": "paragraph", - "content": "" + "content": "Configure AkiraDocs for multiple languages with AI-powered translation support." + }, + { + "id": "2", + "type": "heading", + "content": "Quick Setup", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "Basic Configuration", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "paragraph", + "content": "Add language settings to `akiradocs.config.json`:" + }, + { + "id": "5", + "type": "code", + "content": "{\n \"localization\": {\n \"defaultLocale\": \"en\",\n \"fallbackLocale\": \"en\",\n \"locales\": [\n {\n \"code\": \"en\",\n \"name\": \"English\",\n \"flag\": \"ïżœđŸ‡ž\"\n },\n {\n \"code\": \"es\",\n \"name\": \"Español\",\n \"flag\": \"đŸ‡Ș🇾\"\n },\n {\n \"code\": \"fr\",\n \"name\": \"Français\",\n \"flag\": \"đŸ‡«đŸ‡·\"\n }\n ]\n },\n \"translation\": {\n \"auto_translate\": true,\n \"provider\": \"anthropic\",\n \"targetLanguages\": [\"es\", \"fr\", \"de\"],\n \"excludedPaths\": [\"_meta.json\"]\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + }, + { + "id": "6", + "type": "heading", + "content": "Directory Structure", + "metadata": { + "level": 3 + } + }, + { + "id": "7", + "type": "code", + "content": "docs/\n├── _contents/\n│ ├── en/ # Source language\n│ │ └── docs/\n│ ├── es/ # Spanish translation\n│ │ └── docs/\n│ └── fr/ # French translation\n│ └── docs/", + "metadata": { + "language": "plaintext", + "showLineNumbers": true + } + }, + { + "id": "8", + "type": "heading", + "content": "Configuration Options", + "metadata": { + "level": 2 + } + }, + { + "id": "9", + "type": "heading", + "content": "Language Settings", + "metadata": { + "level": 3 + } + }, + { + "id": "10", + "type": "list", + "content": [ + "`defaultLocale`: Primary content language", + "`fallbackLocale`: Fallback when translation missing", + "`locales`: Available language configurations" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "11", + "type": "heading", + "content": "Translation Settings", + "metadata": { + "level": 3 + } + }, + { + "id": "12", + "type": "list", + "content": [ + "`auto_translate`: Enable/disable automatic translation", + "`provider`: AI translation provider", + "`targetLanguages`: Languages to translate into", + "`excludedPaths`: Files to skip during translation" + ], + "metadata": { + "listType": "unordered" + } } ] } \ No newline at end of file diff --git a/docs/compiled/en/docs/introduction.json b/docs/compiled/en/docs/introduction.json index 30ecf6d..551a066 100644 --- a/docs/compiled/en/docs/introduction.json +++ b/docs/compiled/en/docs/introduction.json @@ -1,5 +1,5 @@ { - "title": "", + "title": "Introduction to AkiraDocs", "description": "", "author": "Akira Team", "publishDate": "2024-11-10T00:00:00.000Z", @@ -14,36 +14,23 @@ { "id": "1", "type": "paragraph", - "content": "" + "content": "AkiraDocs is a next-generation documentation platform that combines the power of AI with an intuitive content management system. It's designed to transform your documentation workflow from days to minutes." }, { "id": "2", "type": "heading", - "content": "Introduction to AkiraDocs", - "metadata": { - "level": 1 - } - }, - { - "id": "3", - "type": "paragraph", - "content": "AkiraDocs is a next-generation documentation platform that combines the power of AI with an intuitive content management system. It's designed to transform your documentation workflow from months to minutes." - }, - { - "id": "4", - "type": "heading", "content": "Why AkiraDocs?", "metadata": { "level": 2 } }, { - "id": "5", + "id": "3", "type": "paragraph", "content": "Documentation is often a challenge for teams:" }, { - "id": "6", + "id": "4", "type": "list", "content": [ "Developers want to keep using Markdown and Git", @@ -57,12 +44,12 @@ } }, { - "id": "7", + "id": "5", "type": "paragraph", "content": "AkiraDocs solves these challenges by providing a unified platform that brings everyone's workflow together." }, { - "id": "8", + "id": "6", "type": "heading", "content": "Core Benefits", "metadata": { @@ -70,31 +57,21 @@ } }, { - "id": "9", - "type": "paragraph", - "content": "" - }, - { - "id": "10", + "id": "7", "type": "list", "content": [ - "**Universal Workflow**: Developers keep their Markdown/Git workflow while content teams get a block-based WYSIWYG editor", - "**AI-Powered**: Automatic content updates, translations, and optimizations", - "**SEO-Optimized**: Documentation that ranks well by default", - "**Multi-Language Support**: AI-powered translations with context awareness", - "**Enterprise-Ready**: SSO/SAML integration, audit logs, and custom deployment options" + "Universal Workflow: Developers keep their Markdown/Git workflow while content teams get a block-based WYSIWYG editor", + "AI-Powered: Automatic content updates, translations, and optimizations", + "SEO-Optimized: Documentation that ranks well by default", + "Multi-Language Support: AI-powered translations with context awareness", + "Enterprise-Ready: SSO/SAML integration, audit logs, and custom deployment options" ], "metadata": { "listType": "unordered" } }, { - "id": "11", - "type": "paragraph", - "content": "" - }, - { - "id": "12", + "id": "8", "type": "heading", "content": "Who Is It For?", "metadata": { @@ -102,12 +79,7 @@ } }, { - "id": "13", - "type": "paragraph", - "content": "" - }, - { - "id": "14", + "id": "9", "type": "heading", "content": "Developer Documentation", "metadata": { @@ -115,7 +87,7 @@ } }, { - "id": "15", + "id": "10", "type": "list", "content": [ "API documentation", @@ -128,12 +100,7 @@ } }, { - "id": "16", - "type": "paragraph", - "content": "" - }, - { - "id": "17", + "id": "11", "type": "heading", "content": "Product Documentation", "metadata": { @@ -141,7 +108,7 @@ } }, { - "id": "18", + "id": "12", "type": "list", "content": [ "User guides", @@ -154,12 +121,7 @@ } }, { - "id": "19", - "type": "paragraph", - "content": "" - }, - { - "id": "20", + "id": "13", "type": "heading", "content": "Enterprise Documentation", "metadata": { @@ -167,7 +129,7 @@ } }, { - "id": "21", + "id": "14", "type": "list", "content": [ "Internal knowledge bases", @@ -178,24 +140,6 @@ "metadata": { "listType": "unordered" } - }, - { - "id": "22", - "type": "paragraph", - "content": "" - }, - { - "id": "23", - "type": "heading", - "content": "Next Steps", - "metadata": { - "level": 2 - } - }, - { - "id": "24", - "type": "paragraph", - "content": "Ready to get started? Check out our [Quick Start Guide](./quick-start.md) or explore our [detailed features](./features.md)." } ] } \ No newline at end of file diff --git a/docs/compiled/en/docs/seo-and-performance/robot-txt.json b/docs/compiled/en/docs/seo-and-performance/robot-txt.json index 648199d..e9cab23 100644 --- a/docs/compiled/en/docs/seo-and-performance/robot-txt.json +++ b/docs/compiled/en/docs/seo-and-performance/robot-txt.json @@ -1,5 +1,5 @@ { - "title": "", + "title": "Robots.txt Configuration", "description": "", "author": "Akira Team", "publishDate": "2024-11-26T00:00:00.000Z", @@ -14,36 +14,18 @@ { "id": "1", "type": "paragraph", - "content": "" + "content": "The robots.txt file is automatically generated during the build process and can be found in the `public` folder of your project." }, { "id": "2", "type": "heading", - "content": "Robots.txt Configuration", - "metadata": { - "level": 1 - } - }, - { - "id": "3", - "type": "paragraph", - "content": "Guide to customizing and managing your robots.txt file in AkiraDocs." - }, - { - "id": "4", - "type": "heading", "content": "Default Configuration", "metadata": { "level": 2 } }, { - "id": "5", - "type": "paragraph", - "content": "" - }, - { - "id": "6", + "id": "3", "type": "heading", "content": "Basic robots.txt", "metadata": { @@ -51,134 +33,13 @@ } }, { - "id": "7", - "type": "code", - "content": "User-agent: *\nAllow: /\nSitemap: https://yourdocs.com/sitemap.xml\n\n# Private sections\nDisallow: /admin/\nDisallow: /private/", - "metadata": { - "language": "txt", - "showLineNumbers": true - } - }, - { - "id": "8", - "type": "paragraph", - "content": "" - }, - { - "id": "9", - "type": "heading", - "content": "Customization", - "metadata": { - "level": 2 - } - }, - { - "id": "10", - "type": "paragraph", - "content": "" - }, - { - "id": "11", - "type": "heading", - "content": "Configuration Options", - "metadata": { - "level": 3 - } - }, - { - "id": "12", - "type": "code", - "content": "{\n \"seo\": {\n \"robots\": {\n \"enabled\": true,\n \"autoGenerate\": true,\n \"custom\": {\n \"disallow\": [\"/internal/\", \"/draft/\"],\n \"allow\": [\"/public/\"],\n \"crawlDelay\": 10\n }\n }\n }\n}", - "metadata": { - "language": "json", - "showLineNumbers": true - } - }, - { - "id": "13", - "type": "paragraph", - "content": "" - }, - { - "id": "14", - "type": "heading", - "content": "Advanced Rules", - "metadata": { - "level": 3 - } - }, - { - "id": "15", + "id": "4", "type": "code", - "content": "# Custom crawl rate\nUser-agent: Googlebot\nCrawl-delay: 10\n\n# Allow specific bot\nUser-agent: Bingbot\nAllow: /public/\nDisallow: /private/\n\n# Block specific bot\nUser-agent: BadBot\nDisallow: /", + "content": "User-agent: *\nAllow: /\nSitemap: https://docs.akiradocs.com/sitemap.xml\n\n# Private sections\nDisallow: /admin/\nDisallow: /private/", "metadata": { "language": "txt", "showLineNumbers": true } - }, - { - "id": "16", - "type": "paragraph", - "content": "" - }, - { - "id": "17", - "type": "heading", - "content": "Best Practices", - "metadata": { - "level": 2 - } - }, - { - "id": "18", - "type": "paragraph", - "content": "1. **Access Control**" - }, - { - "id": "19", - "type": "list", - "content": [ - "Block sensitive content", - "Allow public content", - "Manage crawl rates" - ], - "metadata": { - "listType": "unordered" - } - }, - { - "id": "20", - "type": "paragraph", - "content": "2. **Performance**" - }, - { - "id": "21", - "type": "list", - "content": [ - "Optimize crawl budget", - "Prevent unnecessary indexing", - "Monitor bot behavior" - ], - "metadata": { - "listType": "unordered" - } - }, - { - "id": "22", - "type": "paragraph", - "content": "3. **Maintenance**" - }, - { - "id": "23", - "type": "list", - "content": [ - "Regular updates", - "Verify syntax", - "Test configuration" - ], - "metadata": { - "listType": "unordered" - } } ] } \ No newline at end of file diff --git a/docs/compiled/en/docs/seo-and-performance/sitemap-generation.json b/docs/compiled/en/docs/seo-and-performance/sitemap-generation.json index 60508b2..7d66cb1 100644 --- a/docs/compiled/en/docs/seo-and-performance/sitemap-generation.json +++ b/docs/compiled/en/docs/seo-and-performance/sitemap-generation.json @@ -1,5 +1,5 @@ { - "title": "", + "title": "Automatic Sitemap Generation", "description": "", "author": "Akira Team", "publishDate": "2024-11-26T00:00:00.000Z", @@ -14,23 +14,10 @@ { "id": "1", "type": "paragraph", - "content": "" - }, - { - "id": "2", - "type": "heading", - "content": "Automatic Sitemap Generation", - "metadata": { - "level": 1 - } - }, - { - "id": "3", - "type": "paragraph", "content": "Learn how AkiraDocs automatically generates and manages your documentation sitemap." }, { - "id": "4", + "id": "2", "type": "heading", "content": "Overview", "metadata": { @@ -38,34 +25,12 @@ } }, { - "id": "5", + "id": "3", "type": "paragraph", "content": "AkiraDocs automatically generates a sitemap.xml file during the build process, ensuring search engines can efficiently crawl your documentation." }, { - "id": "6", - "type": "heading", - "content": "Default Configuration", - "metadata": { - "level": 3 - } - }, - { - "id": "7", - "type": "code", - "content": "{\n \"seo\": {\n \"sitemap\": {\n \"enabled\": true,\n \"autoGenerate\": true,\n \"changefreq\": \"weekly\",\n \"priority\": 0.7\n }\n }\n}", - "metadata": { - "language": "json", - "showLineNumbers": true - } - }, - { - "id": "8", - "type": "paragraph", - "content": "" - }, - { - "id": "9", + "id": "4", "type": "heading", "content": "Generated Sitemap Structure", "metadata": { @@ -73,12 +38,7 @@ } }, { - "id": "10", - "type": "paragraph", - "content": "" - }, - { - "id": "11", + "id": "5", "type": "heading", "content": "Example Output", "metadata": { @@ -86,134 +46,13 @@ } }, { - "id": "12", + "id": "6", "type": "code", "content": "\n\n \n https://yourdocs.com/\n 2024-11-26\n weekly\n 1.0\n \n \n https://yourdocs.com/docs/getting-started\n 2024-11-26\n weekly\n 0.8\n \n", "metadata": { "language": "xml", "showLineNumbers": true } - }, - { - "id": "13", - "type": "paragraph", - "content": "" - }, - { - "id": "14", - "type": "heading", - "content": "Customization Options", - "metadata": { - "level": 2 - } - }, - { - "id": "15", - "type": "paragraph", - "content": "" - }, - { - "id": "16", - "type": "heading", - "content": "Priority Settings", - "metadata": { - "level": 3 - } - }, - { - "id": "17", - "type": "code", - "content": "{\n \"seo\": {\n \"sitemap\": {\n \"priorities\": {\n \"home\": 1.0,\n \"docs\": 0.8,\n \"blog\": 0.6,\n \"other\": 0.5\n }\n }\n }\n}", - "metadata": { - "language": "json", - "showLineNumbers": true - } - }, - { - "id": "18", - "type": "paragraph", - "content": "" - }, - { - "id": "19", - "type": "heading", - "content": "Update Frequency", - "metadata": { - "level": 3 - } - }, - { - "id": "20", - "type": "code", - "content": "{\n \"seo\": {\n \"sitemap\": {\n \"changefreq\": {\n \"home\": \"daily\",\n \"docs\": \"weekly\",\n \"blog\": \"monthly\"\n }\n }\n }\n}", - "metadata": { - "language": "json", - "showLineNumbers": true - } - }, - { - "id": "21", - "type": "paragraph", - "content": "" - }, - { - "id": "22", - "type": "heading", - "content": "Best Practices", - "metadata": { - "level": 2 - } - }, - { - "id": "23", - "type": "paragraph", - "content": "1. **Regular Updates**" - }, - { - "id": "24", - "type": "list", - "content": [ - "Keep content fresh", - "Maintain accurate lastmod dates", - "Remove obsolete URLs" - ], - "metadata": { - "listType": "unordered" - } - }, - { - "id": "25", - "type": "paragraph", - "content": "2. **Structure Optimization**" - }, - { - "id": "26", - "type": "list", - "content": [ - "Logical URL hierarchy", - "Consistent naming", - "Clear categories" - ], - "metadata": { - "listType": "unordered" - } - }, - { - "id": "27", - "type": "paragraph", - "content": "3. **Performance**" - }, - { - "id": "28", - "type": "list", - "content": [ - "Compress large sitemaps", - "Use sitemap index for large sites", - "Monitor crawl stats" - ], - "metadata": { - "listType": "unordered" - } } ] } \ No newline at end of file diff --git a/docs/compiled/es/articles/ai_integration.json b/docs/compiled/es/articles/ai_integration.json index e3db03e..548aa5a 100644 --- a/docs/compiled/es/articles/ai_integration.json +++ b/docs/compiled/es/articles/ai_integration.json @@ -1,5 +1,5 @@ { - "title": "", + "title": "IntegraciĂłn de Asistente de IA", "description": "", "author": "Akira Team", "publishDate": "2024-11-10T00:00:00.000Z", @@ -15,23 +15,15 @@ { "id": "1", "type": "paragraph", - "content": "" + "content": "Aprende cĂłmo utilizar el asistente de IA integrado de Akira para mejorar la documentaciĂłn" }, { "id": "2", - "type": "heading", - "content": "IntegraciĂłn de Asistente de IA", - "metadata": { - "level": 1 - } - }, - { - "id": "3", "type": "paragraph", - "content": "Aprende cĂłmo utilizar el asistente de IA integrado de Akira para mejorar la documentaciĂłn\n\nEl Asistente de IA de Akira es una poderosa herramienta que ayuda a los desarrolladores y escritores tĂ©cnicos a crear, mantener y mejorar la documentaciĂłn a travĂ©s de interacciones en lenguaje natural. Esta guĂ­a cubre las caracterĂ­sticas esenciales y las mejores prĂĄcticas para utilizar el asistente de IA de manera efectiva." + "content": "AquĂ­ estĂĄ la traducciĂłn al español, manteniendo el formato original:\n\nEl Asistente de IA de Akira es una poderosa herramienta que ayuda a los desarrolladores y escritores tĂ©cnicos a crear, mantener y mejorar la documentaciĂłn a travĂ©s de interacciones en lenguaje natural. Esta guĂ­a cubre las caracterĂ­sticas esenciales y las mejores prĂĄcticas para utilizar de manera efectiva el asistente de IA." }, { - "id": "4", + "id": "3", "type": "heading", "content": "CaracterĂ­sticas clave", "metadata": { @@ -39,12 +31,7 @@ } }, { - "id": "5", - "type": "paragraph", - "content": "" - }, - { - "id": "6", + "id": "4", "type": "list", "content": [ "GeneraciĂłn de documentaciĂłn de lenguaje natural", @@ -58,12 +45,7 @@ } }, { - "id": "7", - "type": "paragraph", - "content": "" - }, - { - "id": "8", + "id": "5", "type": "heading", "content": "Comenzando", "metadata": { @@ -71,12 +53,12 @@ } }, { - "id": "9", + "id": "6", "type": "paragraph", "content": "El Asistente de IA se puede acceder a travĂ©s del menĂș de comandos (Ctrl+Shift+P) o utilizando el comando `/ai` en cualquier bloque de contenido. Comprende solicitudes conscientes del contexto y puede ayudar con diversas tareas de documentaciĂłn." }, { - "id": "10", + "id": "7", "type": "heading", "content": "Casos de uso comunes", "metadata": { @@ -84,12 +66,12 @@ } }, { - "id": "11", + "id": "8", "type": "paragraph", "content": "1. Generando ejemplos de cĂłdigo\n2. Explicando conceptos tĂ©cnicos\n3. Reestructurando contenido\n4. Creando esquemas de documentaciĂłn\n5. Traduciendo documentaciĂłn" }, { - "id": "12", + "id": "9", "type": "heading", "content": "Mejores PrĂĄcticas", "metadata": { @@ -97,12 +79,7 @@ } }, { - "id": "13", - "type": "paragraph", - "content": "" - }, - { - "id": "14", + "id": "10", "type": "list", "content": [ "Proporciona un contexto claro al hacer solicitudes", @@ -116,12 +93,7 @@ } }, { - "id": "15", - "type": "paragraph", - "content": "" - }, - { - "id": "16", + "id": "11", "type": "heading", "content": "Opciones de configuraciĂłn", "metadata": { @@ -129,12 +101,12 @@ } }, { - "id": "17", + "id": "12", "type": "paragraph", "content": "Puedes personalizar el comportamiento del Asistente de IA a travĂ©s del archivo `config.yaml`:" }, { - "id": "18", + "id": "13", "type": "code", "content": "ai_assistant:\n modelo: \"advanced-docs-v2\"\n temperatura: 0.7\n max_tokens: 2048\n guĂ­a_de_estilo: \"path/to/style/guide.md\"", "metadata": { @@ -143,12 +115,7 @@ } }, { - "id": "19", - "type": "paragraph", - "content": "" - }, - { - "id": "20", + "id": "14", "type": "heading", "content": "PrĂłximos pasos", "metadata": { @@ -156,7 +123,7 @@ } }, { - "id": "21", + "id": "15", "type": "paragraph", "content": "Explora nuestra guĂ­a de [Funciones Avanzadas de IA](/advanced-ai-features) para aprender mĂĄs sobre casos de uso especializados y posibilidades de integraciĂłn." } diff --git a/docs/compiled/es/articles/template.json b/docs/compiled/es/articles/template.json index 6b4e059..56c042c 100644 --- a/docs/compiled/es/articles/template.json +++ b/docs/compiled/es/articles/template.json @@ -2,7 +2,13 @@ "title": "Entrada de prueba del blog", "description": "Una entrada de blog de prueba para demostrar todos los tipos de bloque.", "author": "Anonymous", - "date": "2024-11-08", + "publishDate": "2024-11-10T00:00:00.000Z", + "modifiedDate": "2024-11-10T00:00:00.000Z", + "heroImage": { + "url": "/blog-hero-image.jpg", + "alt": "Hero image for the blog post", + "caption": "Optional caption for the hero image" + }, "blocks": [ { "id": "1", diff --git a/docs/compiled/es/articles/welcome.json b/docs/compiled/es/articles/welcome.json index de88238..b612070 100644 --- a/docs/compiled/es/articles/welcome.json +++ b/docs/compiled/es/articles/welcome.json @@ -14,23 +14,10 @@ { "id": "1", "type": "paragraph", - "content": "" - }, - { - "id": "2", - "type": "heading", - "content": "Bienvenido a Akira Doc", - "metadata": { - "level": 1 - } - }, - { - "id": "3", - "type": "paragraph", "content": "Bienvenido a Akira Docs, la plataforma de documentaciĂłn de prĂłxima generaciĂłn impulsada por IA. Esta plantilla te ayudarĂĄ a comenzar a crear tu propia documentaciĂłn." }, { - "id": "4", + "id": "2", "type": "heading", "content": "CaracterĂ­sticas clave", "metadata": { @@ -38,12 +25,7 @@ } }, { - "id": "5", - "type": "paragraph", - "content": "" - }, - { - "id": "6", + "id": "3", "type": "list", "content": [ "FĂĄcil de personalizar", @@ -56,9 +38,13 @@ } }, { - "id": "7", - "type": "paragraph", - "content": "> [!info] Primeros pasos\n> ÂĄComienza personalizando esta plantilla para que coincida con las necesidades de tu proyecto!" + "id": "4", + "type": "callout", + "content": "ÂĄComienza personalizando esta plantilla para que coincida con las necesidades de tu proyecto!", + "metadata": { + "type": "info", + "title": "Getting Started" + } } ] } \ No newline at end of file diff --git a/docs/compiled/es/docs/api-reference/usage-guide.json b/docs/compiled/es/docs/api-reference/usage-guide.json new file mode 100644 index 0000000..deff0a5 --- /dev/null +++ b/docs/compiled/es/docs/api-reference/usage-guide.json @@ -0,0 +1,160 @@ +{ + "title": "GuĂ­a de documentaciĂłn de API", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "API Reference", + "keywords": [ + "API", + "Documentation", + "Integration" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Aprende cĂłmo generar documentaciĂłn completa de API utilizando AkiraDocs." + }, + { + "id": "2", + "type": "heading", + "content": "Inicio rĂĄpido", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "Cargar especificaciĂłn de API", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "paragraph", + "content": "1. Coloque su especificaciĂłn OpenAPI/Swagger en:" + }, + { + "id": "5", + "type": "code", + "content": "_contenido/{cĂłdigo_de_idioma}/api/apiSpec.json", + "metadata": { + "language": "plaintext", + "showLineNumbers": true + } + }, + { + "id": "6", + "type": "paragraph", + "content": "2. AkiraDocs genera automĂĄticamente la documentaciĂłn." + }, + { + "id": "7", + "type": "heading", + "content": "EspecificaciĂłn de API de ejemplo", + "metadata": { + "level": 3 + } + }, + { + "id": "8", + "type": "code", + "content": "{\n \"openapi\": \"3.0.0\",\n \"info\": {\n \"title\": \"API de muestra\",\n \"version\": \"1.0.0\"\n },\n \"paths\": {\n \"/users\": {\n \"get\": {\n \"summary\": \"Obtener usuarios\",\n \"responses\": {\n \"200\": {\n \"description\": \"Éxito\"\n }\n }\n }\n }\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + }, + { + "id": "9", + "type": "heading", + "content": "DocumentaciĂłn generada", + "metadata": { + "level": 2 + } + }, + { + "id": "10", + "type": "heading", + "content": "CaracterĂ­sticas automĂĄticas", + "metadata": { + "level": 3 + } + }, + { + "id": "11", + "type": "list", + "content": [ + "Explorador de API interactivo", + "Muestras de cĂłdigo en mĂșltiples idiomas", + "Ejemplos de solicitud/respuesta", + "DocumentaciĂłn de autenticaciĂłn" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "12", + "type": "heading", + "content": "Salida de ejemplo", + "metadata": { + "level": 3 + } + }, + { + "id": "13", + "type": "code", + "content": "// Ejemplo: Obtener usuarios\nconst response = await fetch('https://api.example.com/users', {\n method: 'GET',\n headers: {\n 'Authorization': 'Bearer TU_TOKEN'\n }\n});\n\nconst users = await response.json();", + "metadata": { + "language": "javascript", + "showLineNumbers": true + } + }, + { + "id": "14", + "type": "heading", + "content": "PersonalizaciĂłn", + "metadata": { + "level": 2 + } + }, + { + "id": "15", + "type": "heading", + "content": "Opciones de tema", + "metadata": { + "level": 3 + } + }, + { + "id": "16", + "type": "code", + "content": "{\n \"api\": {\n \"docs\": {\n \"tema\": \"oscuro\",\n \"resaltadoDeSintaxis\": true,\n \"mostrarEjemplos\": true\n }\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + }, + { + "id": "17", + "type": "heading", + "content": "SelecciĂłn de idioma", + "metadata": { + "level": 3 + } + }, + { + "id": "18", + "type": "code", + "content": "{\n \"api\": {\n \"ejemplos\": {\n \"idiomas\": [\"javascript\", \"python\", \"curl\"]\n }\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/es/docs/content-management/creating-pages.json b/docs/compiled/es/docs/content-management/creating-pages.json new file mode 100644 index 0000000..68a62d5 --- /dev/null +++ b/docs/compiled/es/docs/content-management/creating-pages.json @@ -0,0 +1,152 @@ +{ + "title": "CreaciĂłn y organizaciĂłn de pĂĄginas", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Content Management", + "keywords": [ + "Content Creation", + "Pages", + "Organization" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Aprende cĂłmo crear, estructurar y organizar tus pĂĄginas de documentaciĂłn en AkiraDocs. Puedes crear pĂĄginas de markdown o simplemente usar la interfaz de usuario del editor. Ten en cuenta que en la carpeta _contents solo verĂĄs el contenido de markdown creado por ti. Si usas la interfaz de usuario del Editor, el contenido se guardarĂĄ en la carpeta compilada y se traducirĂĄ automĂĄticamente a otros idiomas." + }, + { + "id": "2", + "type": "heading", + "content": "Estructura de pĂĄgina", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "Plantilla BĂĄsica de PĂĄgina", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "code", + "content": "---\ntĂ­tulo: Tu tĂ­tulo de pĂĄgina\ndescripciĂłn: Breve descripciĂłn de la pĂĄgina\nautor: Tu nombre\nfechaDePublicaciĂłn: 2024-11-26\nfechaDeModificaciĂłn: 2024-11-26\ncategorĂ­a: Nombre de categorĂ­a\npalabrasClaves:\n - palabra clave 1\n - palabra clave 2\n---\n\n# TĂ­tulo principal\n\nEl contenido comienza aquĂ­...", + "metadata": { + "language": "markdown", + "showLineNumbers": true + } + }, + { + "id": "5", + "type": "heading", + "content": "Estructura de directorios", + "metadata": { + "level": 3 + } + }, + { + "id": "6", + "type": "code", + "content": "folder_name/\n├── _contents/\n│ ├── es/\n│ │ ├── getting-started/\n│ │ ├── guides/\n│ │ └── api/", + "metadata": { + "language": "plaintext", + "showLineNumbers": true + } + }, + { + "id": "7", + "type": "paragraph", + "content": "Puedes simplemente crear pĂĄginas para el idioma predeterminado (en) y AkiraDocs las traducirĂĄ automĂĄticamente a otros idiomas." + }, + { + "id": "8", + "type": "heading", + "content": "CreaciĂłn de nuevas pĂĄginas", + "metadata": { + "level": 2 + } + }, + { + "id": "9", + "type": "heading", + "content": "MĂ©todo 1: Usando la interfaz de usuario", + "metadata": { + "level": 3 + } + }, + { + "id": "10", + "type": "paragraph", + "content": "1. Haga clic en \"Nueva pĂĄgina\" en la barra lateral\n2. Comience a agregar contenido" + }, + { + "id": "11", + "type": "heading", + "content": "MĂ©todo 2: CreaciĂłn de archivo directo", + "metadata": { + "level": 3 + } + }, + { + "id": "12", + "type": "paragraph", + "content": "1. Crea un nuevo archivo `.md` en el directorio apropiado\n2. Agrega el frontmatter requerido\n3. Escribe el contenido usando Markdown\n4. Guarda y compila" + }, + { + "id": "13", + "type": "heading", + "content": "OrganizaciĂłn de la pĂĄgina", + "metadata": { + "level": 2 + } + }, + { + "id": "14", + "type": "heading", + "content": "CategorĂ­as y Etiquetas", + "metadata": { + "level": 3 + } + }, + { + "id": "15", + "type": "list", + "content": [ + "Utiliza categorĂ­as consistentes", + "Aplica las etiquetas relevantes", + "Organizar por tema", + "Crea jerarquĂ­as lĂłgicas" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "16", + "type": "heading", + "content": "Estructura de navegaciĂłn", + "metadata": { + "level": 3 + } + }, + { + "id": "17", + "type": "paragraph", + "content": "Esta es generada automĂĄticamente a partir de la estructura de carpetas. Puedes personalizarla editando el archivo `_meta.json` dentro de la carpeta compilada." + }, + { + "id": "18", + "type": "code", + "content": "{\n \"docs\": {\n \"getting-started\": {\n \"title\": \"Comenzando\",\n \"items\": {\n \"introduction\": {\n \"title\": \"IntroducciĂłn\",\n \"path\": \"/docs/getting-started/introduction\"\n }\n }\n }\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/es/docs/contributing/code-of-conduct.json b/docs/compiled/es/docs/contributing/code-of-conduct.json new file mode 100644 index 0000000..7b4c5bd --- /dev/null +++ b/docs/compiled/es/docs/contributing/code-of-conduct.json @@ -0,0 +1,99 @@ +{ + "title": "CĂłdigo de Conducta", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Contributing", + "keywords": [ + "Code of Conduct", + "Contributing" + ], + "blocks": [ + { + "id": "1", + "type": "heading", + "content": "Nuestro Compromiso", + "metadata": { + "level": 2 + } + }, + { + "id": "2", + "type": "paragraph", + "content": "Nosotros, como miembros, colaboradores y lĂ­deres, nos comprometemos a hacer que la participaciĂłn en nuestra comunidad sea una experiencia libre de acoso para todos, independientemente de la edad, el tamaño corporal, la discapacidad visible o invisible, la etnia, las caracterĂ­sticas sexuales, la identidad y expresiĂłn de gĂ©nero, el nivel de experiencia, la educaciĂłn, el estado socioeconĂłmico, la nacionalidad, la apariencia personal, la raza, la religiĂłn o la identidad y orientaciĂłn sexual." + }, + { + "id": "3", + "type": "paragraph", + "content": "Nos comprometemos a actuar e interactuar de maneras que contribuyan a una comunidad abierta, acogedora, diversa, inclusiva y saludable." + }, + { + "id": "4", + "type": "heading", + "content": "Nuestras Normas", + "metadata": { + "level": 2 + } + }, + { + "id": "5", + "type": "paragraph", + "content": "Ejemplos de comportamiento que contribuyen a un entorno positivo:" + }, + { + "id": "6", + "type": "paragraph", + "content": "* Demostrando empatĂ­a y amabilidad hacia otras personas\n* Siendo respetuoso con las opiniones, puntos de vista y experiencias diferentes\n* Dando y aceptando con gracia las crĂ­ticas constructivas\n* Aceptando la responsabilidad y disculpĂĄndose con quienes se vieron afectados por nuestros errores\n* EnfocĂĄndose en lo que es mejor para la comunidad en general" + }, + { + "id": "7", + "type": "paragraph", + "content": "Ejemplos de comportamiento inaceptable:" + }, + { + "id": "8", + "type": "paragraph", + "content": "* El uso de lenguaje o imĂĄgenes sexualizadas, y atenciĂłn o insinuaciones sexuales\n* Troleo, comentarios insultantes o despectivos, y ataques personales o polĂ­ticos\n* Acoso pĂșblico o privado\n* Publicar informaciĂłn privada de otros sin permiso explĂ­cito\n* Otra conducta que razonablemente podrĂ­a considerarse inapropiada en un entorno profesional" + }, + { + "id": "9", + "type": "heading", + "content": "Responsabilidades de Cumplimiento", + "metadata": { + "level": 2 + } + }, + { + "id": "10", + "type": "paragraph", + "content": "Los lĂ­deres de la comunidad son responsables de aclarar y hacer cumplir nuestros estĂĄndares de comportamiento aceptable y tomarĂĄn las medidas correctivas apropiadas y justas en respuesta a cualquier comportamiento que consideren inapropiado, amenazante, ofensivo o dañino." + }, + { + "id": "11", + "type": "heading", + "content": "Cumplimiento", + "metadata": { + "level": 2 + } + }, + { + "id": "12", + "type": "paragraph", + "content": "Instancias de comportamiento abusivo, acosador o inaceptable de otro modo pueden ser reportadas a los lĂ­deres comunitarios responsables de la aplicaciĂłn. Todas las quejas serĂĄn revisadas e investigadas de manera rĂĄpida y justa." + }, + { + "id": "13", + "type": "heading", + "content": "AtribuciĂłn", + "metadata": { + "level": 2 + } + }, + { + "id": "14", + "type": "paragraph", + "content": "Este CĂłdigo de Conducta estĂĄ adaptado del [Contributor Covenant](https://www.contributor-covenant.org), versiĂłn 2.0, disponible en https://www.contributor-covenant.org/version/2/0/code_of_conduct.html." + } + ] +} \ No newline at end of file diff --git a/docs/compiled/es/docs/contributing/how-to-contribute.json b/docs/compiled/es/docs/contributing/how-to-contribute.json new file mode 100644 index 0000000..29bef71 --- /dev/null +++ b/docs/compiled/es/docs/contributing/how-to-contribute.json @@ -0,0 +1,213 @@ +{ + "title": "Contribuir a AkiraDocs", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Contributing", + "keywords": [ + "Contributing", + "Open Source", + "Development" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "GuĂ­a para contribuir al proyecto de cĂłdigo abierto AkiraDocs." + }, + { + "id": "2", + "type": "heading", + "content": "Comenzando", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "Configurar el Entorno de Desarrollo", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "code", + "content": "# Clonar repositorio\ngit clone https://github.com/Cloud-Code-AI/akiradocs\ncd akiradocs\n\n# Instalar dependencias\nnpm install\n\n# Iniciar servidor de desarrollo\nnpm run dev", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "5", + "type": "heading", + "content": "Directrices de contribuciĂłn", + "metadata": { + "level": 2 + } + }, + { + "id": "6", + "type": "heading", + "content": "Tipos de contribuciones", + "metadata": { + "level": 3 + } + }, + { + "id": "7", + "type": "list", + "content": [ + "Correcciones de errores", + "Adiciones de funciones", + "Mejoras en la documentaciĂłn", + "Ayuda de traducciĂłn", + "Informes de problemas" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "8", + "type": "heading", + "content": "Proceso de solicitud de extracciĂłn", + "metadata": { + "level": 3 + } + }, + { + "id": "9", + "type": "paragraph", + "content": "1. Bifurcar el repositorio\n2. Crear rama de funcionalidad\n3. Realizar cambios\n4. Enviar solicitud de extracciĂłn" + }, + { + "id": "10", + "type": "heading", + "content": "Mensajes de confirmaciĂłn", + "metadata": { + "level": 3 + } + }, + { + "id": "11", + "type": "code", + "content": "# Formato\ntipo(ĂĄmbito): descripciĂłn\n\n# Ejemplos\nfeat(editor): agregar nuevo tipo de bloque\nfix(traducciĂłn): corregir detecciĂłn de idioma\ndocs(api): actualizar guĂ­a de autenticaciĂłn", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "12", + "type": "heading", + "content": "GuĂ­as de desarrollo", + "metadata": { + "level": 2 + } + }, + { + "id": "13", + "type": "heading", + "content": "Estilo de cĂłdigo", + "metadata": { + "level": 3 + } + }, + { + "id": "14", + "type": "list", + "content": [ + "Sigue los patrones existentes", + "Utiliza TypeScript", + "Añadir comentarios", + "Escribir pruebas" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "15", + "type": "heading", + "content": "Prueba", + "metadata": { + "level": 3 + } + }, + { + "id": "16", + "type": "code", + "content": "# Ejecutar pruebas\nnpm run test\n\n# Verificar tipos\nnpm run type-check\n\n# Lint cĂłdigo\nnpm run lint", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "17", + "type": "heading", + "content": "DocumentaciĂłn", + "metadata": { + "level": 2 + } + }, + { + "id": "18", + "type": "heading", + "content": "Actualizar Documentos", + "metadata": { + "level": 3 + } + }, + { + "id": "19", + "type": "paragraph", + "content": "1. Editar los archivos relevantes\n2. Actualizar ejemplos\n3. Verificar enlaces\n4. Verificar formato" + }, + { + "id": "20", + "type": "heading", + "content": "Crear ejemplos", + "metadata": { + "level": 3 + } + }, + { + "id": "21", + "type": "list", + "content": [ + "Claro y conciso", + "Bien documentado", + "Probado", + "Mantenible" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "22", + "type": "heading", + "content": "Obtener ayuda", + "metadata": { + "level": 2 + } + }, + { + "id": "23", + "type": "list", + "content": [ + "Únete a [Discord](https://discord.gg/zvYZukgeH2)", + "Revisa [Problemas](https://github.com/Cloud-Code-AI/akiradocs/issues)", + "Lea [DocumentaciĂłn](https://docs.akiradocs.com)" + ], + "metadata": { + "listType": "unordered" + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/es/docs/editor/features.json b/docs/compiled/es/docs/editor/features.json new file mode 100644 index 0000000..94102ec --- /dev/null +++ b/docs/compiled/es/docs/editor/features.json @@ -0,0 +1,205 @@ +{ + "title": "CaracterĂ­sticas del editor", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Editor", + "keywords": [ + "Editor Features", + "Blocks", + "Formatting" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "DescripciĂłn detallada de las capacidades y funciones del editor AkiraDocs." + }, + { + "id": "2", + "type": "heading", + "content": "Sistema de bloques", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "Formato de texto", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "list", + "content": [ + "Formato BĂĄsico", + "Negrita, cursiva, subrayado", + "Tachado", + "Resaltar", + "CĂłdigo en lĂ­nea" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "5", + "type": "list", + "content": [ + "Formato Avanzado", + "Colores personalizados", + "MĂșltiples fuentes", + "AlineaciĂłn de texto", + "SangrĂ­a" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "6", + "type": "heading", + "content": "Bloques de contenido", + "metadata": { + "level": 3 + } + }, + { + "id": "7", + "type": "heading", + "content": "Texto enriquecido", + "metadata": { + "level": 4 + } + }, + { + "id": "8", + "type": "code", + "content": "# Encabezado 1\n## Encabezado 2\n> Cita textual\n- Lista de viñetas\n1. Lista numerada", + "metadata": { + "language": "markdown", + "showLineNumbers": true + } + }, + { + "id": "9", + "type": "heading", + "content": "Bloques de cĂłdigo", + "metadata": { + "level": 4 + } + }, + { + "id": "10", + "type": "code", + "content": "// Resaltado de sintaxis\nconsole.log('Hola Mundo');", + "metadata": { + "language": "javascript", + "showLineNumbers": true + } + }, + { + "id": "11", + "type": "heading", + "content": "Bloques de medios", + "metadata": { + "level": 4 + } + }, + { + "id": "12", + "type": "list", + "content": [ + "Carga e incrustaciĂłn de imĂĄgenes", + "IncrustaciĂłn de video", + "Archivos adjuntos", + "IntegraciĂłn interactiva" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "13", + "type": "heading", + "content": "CaracterĂ­sticas de la IA", + "metadata": { + "level": 2 + } + }, + { + "id": "14", + "type": "heading", + "content": "Mejora de contenido", + "metadata": { + "level": 3 + } + }, + { + "id": "15", + "type": "list", + "content": [ + "Sugerencias de gramĂĄtica y estilo", + "OptimizaciĂłn de contenido", + "Recomendaciones de SEO", + "Asistencia de traducciĂłn" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "16", + "type": "heading", + "content": "Formato inteligente", + "metadata": { + "level": 3 + } + }, + { + "id": "17", + "type": "list", + "content": [ + "Formato automĂĄtico", + "Listas inteligentes", + "Formato de tabla", + "DetecciĂłn de lenguaje de bloque de cĂłdigo" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "18", + "type": "heading", + "content": "CaracterĂ­sticas de colaboraciĂłn", + "metadata": { + "level": 2 + } + }, + { + "id": "19", + "type": "heading", + "content": "Control de versiones", + "metadata": { + "level": 3 + } + }, + { + "id": "20", + "type": "list", + "content": [ + "IntegraciĂłn de Git", + "Historial de cambios", + "Capacidades de reversiĂłn" + ], + "metadata": { + "listType": "unordered" + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/es/docs/editor/overview.json b/docs/compiled/es/docs/editor/overview.json new file mode 100644 index 0000000..66d8ebb --- /dev/null +++ b/docs/compiled/es/docs/editor/overview.json @@ -0,0 +1,185 @@ +{ + "title": "DescripciĂłn general del editor", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Editor", + "keywords": [ + "Editor", + "Notion-like", + "Interface" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "AkiraDocs cuenta con un editor moderno similar a Notion que combina la sencillez de la ediciĂłn basada en bloques con la potencia de Markdown." + }, + { + "id": "2", + "type": "heading", + "content": "Interfaz del editor", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "Componentes principales", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "list", + "content": [ + "Barra de herramientas: Acceso rĂĄpido a opciones de formato y tipos de bloque", + "Área de contenido: Espacio de ediciĂłn basado en bloques", + "Barra lateral: NavegaciĂłn y estructura del documento", + "Paleta de comandos: Comandos rĂĄpidos (Ctrl/Cmd + P)" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "5", + "type": "heading", + "content": "Estructura de Bloques", + "metadata": { + "level": 3 + } + }, + { + "id": "6", + "type": "paragraph", + "content": "Cada elemento de contenido es un bloque que puede ser:" + }, + { + "id": "7", + "type": "list", + "content": [ + "Arrastrado y soltado para reorganizar", + "Convertido entre diferentes tipos", + "Duplicado o eliminado", + "Anidado dentro de otros bloques" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "8", + "type": "heading", + "content": "Comenzando", + "metadata": { + "level": 2 + } + }, + { + "id": "9", + "type": "heading", + "content": "CreaciĂłn de contenido", + "metadata": { + "level": 3 + } + }, + { + "id": "10", + "type": "paragraph", + "content": "1. Haz clic en el botĂłn '+' o presiona '/' para agregar un nuevo bloque\n2. Elige el tipo de bloque desde el menĂș emergente\n3. Comienza a escribir o agrega contenido" + }, + { + "id": "11", + "type": "heading", + "content": "Operaciones bĂĄsicas", + "metadata": { + "level": 3 + } + }, + { + "id": "12", + "type": "code", + "content": "/ → Abrir menĂș de bloque\n⌘/Ctrl + P → Paleta de comandos\n⌘/Ctrl + / → Mostrar atajos de teclado\n↑↓ → Navegar entre bloques", + "metadata": { + "language": "plaintext", + "showLineNumbers": true + } + }, + { + "id": "13", + "type": "heading", + "content": "Tipos de bloques", + "metadata": { + "level": 2 + } + }, + { + "id": "14", + "type": "heading", + "content": "Bloques de texto", + "metadata": { + "level": 3 + } + }, + { + "id": "15", + "type": "list", + "content": [ + "PĂĄrrafos", + "Encabezados (H1-H6)", + "Listas (con viñetas, numeradas)", + "Citas", + "Llamadas" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "16", + "type": "heading", + "content": "Contenido Multimedia Enriquecido", + "metadata": { + "level": 3 + } + }, + { + "id": "17", + "type": "list", + "content": [ + "ImĂĄgenes", + "VĂ­deos", + "Incrustaciones", + "Archivos", + "Bloques de cĂłdigo" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "18", + "type": "heading", + "content": "Bloques especiales", + "metadata": { + "level": 3 + } + }, + { + "id": "19", + "type": "list", + "content": [ + "Tablas (PrĂłximamente)", + "Divisores", + "Componentes personalizados (PrĂłximamente)" + ], + "metadata": { + "listType": "unordered" + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/es/docs/getting-started/features.json b/docs/compiled/es/docs/getting-started/features.json new file mode 100644 index 0000000..dfac7d8 --- /dev/null +++ b/docs/compiled/es/docs/getting-started/features.json @@ -0,0 +1,137 @@ +{ + "title": "CaracterĂ­sticas de AkiraDocs", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Getting Started", + "keywords": [ + "Akira Docs", + "Documentation", + "AI" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Una descripciĂłn general completa de las funciones y capacidades principales de AkiraDocs." + }, + { + "id": "2", + "type": "heading", + "content": "CreaciĂłn y gestiĂłn de contenido", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "list", + "content": [ + "Editor similar a Notion: Interfaz intuitiva basada en bloques con vista previa en tiempo real", + "Soporte de Markdown: Compatibilidad nativa con Markdown y MDX", + "Componentes personalizados: Crea y reutiliza tus propios bloques de contenido" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "4", + "type": "heading", + "content": "InternacionalizaciĂłn y traducciĂłn", + "metadata": { + "level": 2 + } + }, + { + "id": "5", + "type": "list", + "content": [ + "Soporte para mĂșltiples idiomas: Mantener la documentaciĂłn en varios idiomas", + "TraducciĂłn impulsada por IA: TraducciĂłn de contenido automatizada y consciente del contexto", + "GestiĂłn de traducciones: Herramientas integradas para administrar contenido localizado" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "6", + "type": "heading", + "content": "BĂșsqueda y descubrimiento", + "metadata": { + "level": 2 + } + }, + { + "id": "7", + "type": "list", + "content": [ + "BĂșsqueda Impulsada por IA: Respuesta a preguntas en lenguaje natural con conciencia de contexto", + "OptimizaciĂłn SEO: Herramientas y optimizaciones SEO automatizadas", + "IndexaciĂłn inteligente: Actualizaciones de Ă­ndice de bĂșsqueda en tiempo real" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "8", + "type": "heading", + "content": "ConstrucciĂłn y rendimiento", + "metadata": { + "level": 2 + } + }, + { + "id": "9", + "type": "list", + "content": [ + "GeneraciĂłn EstĂĄtica: Proceso de compilaciĂłn optimizado con optimizaciĂłn de recursos", + "Experiencia de desarrollador: ActualizaciĂłn rĂĄpida y herramientas de depuraciĂłn completas", + "Enfoque en el rendimiento: PrĂĄcticas recomendadas integradas para la velocidad y la eficiencia" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "10", + "type": "heading", + "content": "CaracterĂ­sticas empresariales (PrĂłximamente)", + "metadata": { + "level": 2 + } + }, + { + "id": "11", + "type": "list", + "content": [ + "Seguridad y cumplimiento: SSO, RBAC y registro de auditorĂ­a", + "AnĂĄlisis y perspectivas: Seguimiento del uso y mĂ©tricas de documentaciĂłn", + "ColaboraciĂłn de equipo: Herramientas de colaboraciĂłn de grado empresarial" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "12", + "type": "heading", + "content": "Soporte de migraciĂłn (prĂłximamente)", + "metadata": { + "level": 2 + } + }, + { + "id": "13", + "type": "code", + "content": "# Plataformas compatibles para una migraciĂłn sencilla\n✓ Nextra\n✓ GitBook\n✓ Docusaurus\n✓ ReadTheDocs", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/es/docs/getting-started/quickstart.json b/docs/compiled/es/docs/getting-started/quickstart.json index 3f057e3..fc8f3e9 100644 --- a/docs/compiled/es/docs/getting-started/quickstart.json +++ b/docs/compiled/es/docs/getting-started/quickstart.json @@ -14,35 +14,146 @@ { "id": "1", "type": "paragraph", - "content": "Ponte en marcha con Akira Docs en minutos\n\nSigue estos pasos para comenzar a usar Akira Docs para tus necesidades de documentaciĂłn." + "content": "Ponte en marcha con AkiraDocs en cuestiĂłn de minutos." }, { "id": "2", + "type": "heading", + "content": "Despliegue rĂĄpido", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "OpciĂłn 1: Implementar con Vercel", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "paragraph", + "content": "La forma mĂĄs rĂĄpida de comenzar es usando Vercel:" + }, + { + "id": "5", + "type": "paragraph", + "content": "[![Desplegar con Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2FCloud-Code-AI%2Fakiradocs-template)" + }, + { + "id": "6", + "type": "heading", + "content": "OpciĂłn 2: Usando la CLI", + "metadata": { + "level": 3 + } + }, + { + "id": "7", + "type": "paragraph", + "content": "Crea un nuevo proyecto usando nuestra CLI:" + }, + { + "id": "8", "type": "code", - "content": "bash\ngit clone https://github.com/tu-org/plantilla-docs-akira\ncd plantilla-docs-akira\nnpm install\nnpm run dev", + "content": "npx create-akiradocs@latest mi-documentos", "metadata": { - "language": "plaintext", + "language": "bash", "showLineNumbers": true } }, { - "id": "3", + "id": "9", + "type": "heading", + "content": "Pasos de configuraciĂłn bĂĄsica", + "metadata": { + "level": 2 + } + }, + { + "id": "10", "type": "paragraph", - "content": "" + "content": "1. Clonar el repositorio (si no se utiliza Quick Deploy)" }, { - "id": "4", - "type": "callout", - "content": "AsegĂșrate de tener Node.js 16 o superior instalado en tu sistema.", + "id": "11", + "type": "code", + "content": "git clonar https://github.com/your-org/akira-docs-template\ncd akira-docs-template", "metadata": { - "type": "warning", - "title": "Prerequisites" + "language": "bash", + "showLineNumbers": true } }, { - "id": "5", + "id": "12", "type": "paragraph", - "content": "" + "content": "2. Instalar dependencias" + }, + { + "id": "13", + "type": "code", + "content": "npm install\n# o\nyarn install", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "14", + "type": "paragraph", + "content": "3. Iniciar el servidor de desarrollo" + }, + { + "id": "15", + "type": "code", + "content": "npm run dev\n# o\nyarn dev", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "16", + "type": "paragraph", + "content": "4. Abra `http://localhost:3000` en su navegador" + }, + { + "id": "17", + "type": "heading", + "content": "ConfiguraciĂłn inicial", + "metadata": { + "level": 2 + } + }, + { + "id": "18", + "type": "paragraph", + "content": "1. Actualizar la configuraciĂłn del sitio\nEdita `akiradocs.config.json`:" + }, + { + "id": "19", + "type": "code", + "content": "{\n \"site\": {\n \"title\": \"Tus Documentos\",\n \"description\": \"La descripciĂłn de tu documentaciĂłn\"\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + }, + { + "id": "20", + "type": "paragraph", + "content": "2. Configurar traducciĂłn (Opcional)" + }, + { + "id": "21", + "type": "code", + "content": "{\n \"traducciĂłn\": {\n \"auto_traducir\": true,\n \"proveedor\": \"anthropic\",\n \"lenguasObjetivo\": [\"es\", \"fr\", \"de\"]\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } } ] } \ No newline at end of file diff --git a/docs/compiled/es/docs/getting-started/requirements.json b/docs/compiled/es/docs/getting-started/requirements.json new file mode 100644 index 0000000..aa9f7cb --- /dev/null +++ b/docs/compiled/es/docs/getting-started/requirements.json @@ -0,0 +1,179 @@ +{ + "title": "Requisitos del sistema", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Getting Started", + "keywords": [ + "Akira Docs", + "Documentation", + "AI" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Antes de instalar AkiraDocs, asegĂșrate de que tu entorno cumpla con los siguientes requisitos." + }, + { + "id": "2", + "type": "heading", + "content": "Requisitos mĂ­nimos", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "Node.js\n\nNode.js", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "list", + "content": [ + "VersiĂłn: 16.x o superior", + "Recomendado: Última versiĂłn LTS" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "5", + "type": "heading", + "content": "Memoria del sistema", + "metadata": { + "level": 3 + } + }, + { + "id": "6", + "type": "list", + "content": [ + "MĂ­nimo: 2GB de RAM", + "Recomendado: 4GB de RAM o mĂĄs" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "7", + "type": "heading", + "content": "Almacenamiento", + "metadata": { + "level": 3 + } + }, + { + "id": "8", + "type": "list", + "content": [ + "Recomendado: 1GB de espacio libre" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "9", + "type": "heading", + "content": "Dependencias de software", + "metadata": { + "level": 2 + } + }, + { + "id": "10", + "type": "heading", + "content": "Requerido", + "metadata": { + "level": 3 + } + }, + { + "id": "11", + "type": "list", + "content": [ + "Git (se recomienda la Ășltima versiĂłn)", + "gestor de paquetes npm o yarn", + "Navegador web moderno (Chrome, Firefox, Safari, Edge)" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "12", + "type": "heading", + "content": "Opcional", + "metadata": { + "level": 3 + } + }, + { + "id": "13", + "type": "list", + "content": [ + "Docker (para el despliegue containerizado)", + "PostgreSQL (para caracterĂ­sticas empresariales)" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "14", + "type": "heading", + "content": "Entorno de desarrollo", + "metadata": { + "level": 2 + } + }, + { + "id": "15", + "type": "heading", + "content": "Sistemas operativos compatibles", + "metadata": { + "level": 3 + } + }, + { + "id": "16", + "type": "list", + "content": [ + "macOS (10.15 o posterior)", + "Windows 10/11\n\nWindows 10/11", + "Linux (se recomienda Ubuntu 20.04 o posterior)" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "17", + "type": "heading", + "content": "Soporte de IDE/Editor", + "metadata": { + "level": 3 + } + }, + { + "id": "18", + "type": "list", + "content": [ + "VS Code (prĂłximamente)", + "WebStorm (prĂłximamente)", + "Cualquier editor de texto con soporte para Markdown" + ], + "metadata": { + "listType": "unordered" + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/es/docs/guides/analytics.json b/docs/compiled/es/docs/guides/analytics.json new file mode 100644 index 0000000..092e950 --- /dev/null +++ b/docs/compiled/es/docs/guides/analytics.json @@ -0,0 +1,113 @@ +{ + "title": "IntegraciĂłn de anĂĄlisis", + "description": "Aprende cĂłmo agregar seguimiento de anĂĄlisis a tu documentaciĂłn", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Guides", + "keywords": [ + "Akira Docs", + "Analytics", + "Google Analytics" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "AkiraDocs es compatible con Google Analytics 4 (GA4) de forma predeterminada. Esta guĂ­a le ayudarĂĄ a configurar el seguimiento de anĂĄlisis para su documentaciĂłn." + }, + { + "id": "2", + "type": "heading", + "content": "Configurar Google Analytics", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "paragraph", + "content": "1. Crea una propiedad de Google Analytics 4 en tu [cuenta de Google Analytics](https://analytics.google.com/)\n2. ObtĂ©n tu ID de mediciĂłn (comienza con \"G-\")\n3. Agrega el ID a tu `akiradocs.config.json`:" + }, + { + "id": "4", + "type": "code", + "content": "{\n\"analĂ­tica\": {\n\"google\": {\n\"idDeMediciĂłn\": \"G-XXXXXXXXXX\",\n\"habilitado\": true\n},\n\"depuraciĂłn\": false\n}\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + }, + { + "id": "5", + "type": "heading", + "content": "ÂżQuĂ© se rastrea automĂĄticamente?", + "metadata": { + "level": 2 + } + }, + { + "id": "6", + "type": "list", + "content": [ + "Vistas de pĂĄgina", + "NavegaciĂłn entre pĂĄginas", + "Tiempo en la pĂĄgina", + "Preferencias de idioma del usuario", + "InformaciĂłn del dispositivo y navegador" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "7", + "type": "heading", + "content": "Seguimiento de eventos personalizados", + "metadata": { + "level": 2 + } + }, + { + "id": "8", + "type": "paragraph", + "content": "Puedes realizar un seguimiento de eventos personalizados utilizando el hook `useAnalytics`:" + }, + { + "id": "9", + "type": "code", + "content": "importar { useAnalytics } from '@/hooks/useAnalytics'\nfunciĂłn MyComponent() {\n const { track } = useAnalytics()\n const handleClick = () => {\n track('doc_rating', {\n rating: 5,\n page: 'getting-started',\n helpful: true\n })\n }\n return \n}", + "metadata": { + "language": "typescript", + "showLineNumbers": true + } + }, + { + "id": "10", + "type": "heading", + "content": "Modo de depuraciĂłn", + "metadata": { + "level": 2 + } + }, + { + "id": "11", + "type": "paragraph", + "content": "Habilita el modo de depuraciĂłn para ver los eventos de anĂĄlisis en la consola durante el desarrollo:" + }, + { + "id": "12", + "type": "code", + "content": "{\n\"analĂ­tica\": {\n\"depurar\": verdadero\n}\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + }, + { + "id": "13", + "type": "paragraph", + "content": "Esto proporciona una integraciĂłn analĂ­tica completa que es fĂĄcil de configurar y ampliar para los usuarios segĂșn sea necesario." + } + ] +} \ No newline at end of file diff --git a/docs/compiled/es/docs/installation/configuration.json b/docs/compiled/es/docs/installation/configuration.json new file mode 100644 index 0000000..1f632b9 --- /dev/null +++ b/docs/compiled/es/docs/installation/configuration.json @@ -0,0 +1,92 @@ +{ + "title": "GuĂ­a de configuraciĂłn", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Installation", + "keywords": [ + "Configuration", + "Settings", + "Setup" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "GuĂ­a completa para configurar su instalaciĂłn de AkiraDocs." + }, + { + "id": "2", + "type": "heading", + "content": "ConfiguraciĂłn principal", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "ConfiguraciĂłn del sitio", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "paragraph", + "content": "Edita `akiradocs.config.json`:" + }, + { + "id": "5", + "type": "code", + "content": "{\n \"url\": \"https://docs.akiradocs.com\",\n \"site\": {\n \"title\": \"Tus Documentos\",\n \"description\": \"DescripciĂłn de tu documentaciĂłn\"\n },\n \"branding\": {\n \"logo\": {\n \"path\": \"/your_logo.svg\",\n \"width\": 120,\n \"height\": 30,\n \"show\": true\n },\n \"favicon\": {\n \"path\": \"/favicon.png\",\n \"show\": true\n }\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + }, + { + "id": "6", + "type": "heading", + "content": "ConfiguraciĂłn de navegaciĂłn", + "metadata": { + "level": 3 + } + }, + { + "id": "7", + "type": "code", + "content": "{\n \"navegaciĂłn\": {\n \"encabezado\": {\n \"elementos\": [\n { \"etiqueta\": \"Documentos\", \"href\": \"/docs\", \"icono\": \"/docs.svg\" },\n { \"etiqueta\": \"API\", \"href\": \"/api\", \"icono\": \"/api.svg\" }\n ]\n }\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + }, + { + "id": "8", + "type": "heading", + "content": "InternacionalizaciĂłn", + "metadata": { + "level": 2 + } + }, + { + "id": "9", + "type": "heading", + "content": "ConfiguraciĂłn de idioma", + "metadata": { + "level": 3 + } + }, + { + "id": "10", + "type": "code", + "content": "{\n \"localization\": {\n \"defaultLocale\": \"en\",\n \"fallbackLocale\": \"en\",\n \"locales\": [\n {\n \"code\": \"en\",\n \"name\": \"InglĂ©s\",\n \"flag\": \"đŸ‡ș🇾\"\n },\n {\n \"code\": \"es\",\n \"name\": \"Español\",\n \"flag\": \"đŸ‡Ș🇾\"\n },\n {\n \"code\": \"fr\",\n \"name\": \"FrancĂ©s\",\n \"flag\": \"đŸ‡«đŸ‡·\"\n },\n {\n \"code\": \"de\",\n \"name\": \"AlemĂĄn\",\n \"flag\": \"đŸ‡©đŸ‡Ș\"\n }\n ]\n },\n \"translation\": {\n \"auto_translate\": true,\n \"provider\": \"anthropic\",\n \"model\": \"claude-3-sonnet-20240229\",\n \"targetLanguages\": [\"es\", \"fr\", \"de\"],\n \"excludedPaths\": [\"_meta.json\"]\n },\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/es/docs/installation/setup.json b/docs/compiled/es/docs/installation/setup.json new file mode 100644 index 0000000..3b7b78d --- /dev/null +++ b/docs/compiled/es/docs/installation/setup.json @@ -0,0 +1,261 @@ +{ + "title": "GuĂ­a de instalaciĂłn detallada", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Installation", + "keywords": [ + "Installation", + "Setup", + "Deployment" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "GuĂ­a completa para instalar AkiraDocs en diferentes entornos." + }, + { + "id": "2", + "type": "heading", + "content": "Requisitos previos", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "paragraph", + "content": "AsegĂșrate de que tu sistema cumpla con los [requisitos](../getting-started/requirements.md) antes de continuar." + }, + { + "id": "4", + "type": "heading", + "content": "MĂ©todos de instalaciĂłn", + "metadata": { + "level": 2 + } + }, + { + "id": "5", + "type": "heading", + "content": "1. ConfiguraciĂłn de desarrollo local", + "metadata": { + "level": 3 + } + }, + { + "id": "6", + "type": "paragraph", + "content": "1. Crear nuevo proyecto" + }, + { + "id": "7", + "type": "code", + "content": "npx create-akiradocs@latest mi-sitio-de-documentaciĂłn\ncd mi-sitio-de-documentaciĂłn", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "8", + "type": "paragraph", + "content": "2. Instalar dependencias\nLas dependencias se instalan automĂĄticamente durante la creaciĂłn del proyecto. Si necesita reinstalarlas:" + }, + { + "id": "9", + "type": "code", + "content": "npm instalar", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "10", + "type": "paragraph", + "content": "3. Crear archivo de entorno\nEl archivo de entorno se crea automĂĄticamente. Puedes modificarlo en `.env.local`" + }, + { + "id": "11", + "type": "paragraph", + "content": "4. Iniciar el servidor de desarrollo" + }, + { + "id": "12", + "type": "code", + "content": "npm ejecutar dev", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "13", + "type": "paragraph", + "content": "5. Actualizar AkiraDocs\nPara actualizar una instalaciĂłn existente a la Ășltima versiĂłn:" + }, + { + "id": "14", + "type": "code", + "content": "npx create-akiradocs@latest actualizar", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "15", + "type": "heading", + "content": "3. Despliegue en la Plataforma en la Nube", + "metadata": { + "level": 3 + } + }, + { + "id": "16", + "type": "heading", + "content": "Vercel", + "metadata": { + "level": 4 + } + }, + { + "id": "17", + "type": "paragraph", + "content": "1. Bifurcar el repositorio\n2. Conectar a Vercel\n3. Configurar variables de entorno\n4. Desplegar" + }, + { + "id": "18", + "type": "heading", + "content": "Otras plataformas", + "metadata": { + "level": 4 + } + }, + { + "id": "19", + "type": "list", + "content": [ + "AWS Amplify (PrĂłximamente)", + "Netlify (PrĂłximamente)", + "Digital Ocean (PrĂłximamente)", + "Servidor personalizado (PrĂłximamente)" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "20", + "type": "heading", + "content": "Pasos posteriores a la instalaciĂłn", + "metadata": { + "level": 2 + } + }, + { + "id": "21", + "type": "paragraph", + "content": "1. Verificar instalaciĂłn" + }, + { + "id": "22", + "type": "code", + "content": "npm ejecutar compilaciĂłn\nnpm ejecutar inicio", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "23", + "type": "paragraph", + "content": "2. Configurar la integraciĂłn de Git" + }, + { + "id": "24", + "type": "code", + "content": "git remote add origin tu-repositorio-url", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "25", + "type": "paragraph", + "content": "3. Configurar el directorio de contenido" + }, + { + "id": "26", + "type": "code", + "content": "mkdir -p docs/_contenidos/es", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "27", + "type": "heading", + "content": "Configuraciones especĂ­ficas del entorno", + "metadata": { + "level": 2 + } + }, + { + "id": "28", + "type": "heading", + "content": "Desarrollo", + "metadata": { + "level": 3 + } + }, + { + "id": "29", + "type": "code", + "content": "NODE_ENV=desarrollo\nDEBUG=verdadero", + "metadata": { + "language": "env", + "showLineNumbers": true + } + }, + { + "id": "30", + "type": "heading", + "content": "ProducciĂłn", + "metadata": { + "level": 3 + } + }, + { + "id": "31", + "type": "code", + "content": "NODE_ENV=producciĂłn\nDEBUG=falso", + "metadata": { + "language": "env", + "showLineNumbers": true + } + }, + { + "id": "32", + "type": "heading", + "content": "Prueba", + "metadata": { + "level": 3 + } + }, + { + "id": "33", + "type": "code", + "content": "NODE_ENV=prueba\nTEST_MODE=verdadero", + "metadata": { + "language": "env", + "showLineNumbers": true + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/es/docs/installation/troubleshooting.json b/docs/compiled/es/docs/installation/troubleshooting.json new file mode 100644 index 0000000..9c4123b --- /dev/null +++ b/docs/compiled/es/docs/installation/troubleshooting.json @@ -0,0 +1,314 @@ +{ + "title": "GuĂ­a de soluciĂłn de problemas", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Installation", + "keywords": [ + "Troubleshooting", + "Issues", + "Solutions" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Problemas comunes y sus soluciones al configurar AkiraDocs." + }, + { + "id": "2", + "type": "heading", + "content": "Problemas comunes de instalaciĂłn", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "Discordancia de versiĂłn de Node.js", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "paragraph", + "content": "Problema: Error sobre la compatibilidad de la versiĂłn de Node.js" + }, + { + "id": "5", + "type": "code", + "content": "Error: El motor \"node\" es incompatible con este mĂłdulo", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "6", + "type": "paragraph", + "content": "SoluciĂłn:\n1. Comprueba tu versiĂłn de Node.js:" + }, + { + "id": "7", + "type": "code", + "content": "nodo --versiĂłn", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "8", + "type": "paragraph", + "content": "2. Instala la versiĂłn correcta (16.x o superior)\n3. Usa nvm para administrar las versiones de Node.js:" + }, + { + "id": "9", + "type": "code", + "content": "instalar nvm 20\nusar nvm 20", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "10", + "type": "heading", + "content": "InstalaciĂłn de dependencias fallida", + "metadata": { + "level": 3 + } + }, + { + "id": "11", + "type": "paragraph", + "content": "Problema: npm install falla con errores" + }, + { + "id": "12", + "type": "paragraph", + "content": "SoluciĂłn:\n1. Limpiar el cachĂ© de npm:" + }, + { + "id": "13", + "type": "code", + "content": "AquĂ­ estĂĄ la traducciĂłn al español:\n\nnpm cachĂ© limpiar --fuerza", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "14", + "type": "paragraph", + "content": "2. Eliminar node_modules y package-lock.json:" + }, + { + "id": "15", + "type": "code", + "content": "Eliminar -rf node_modules package-lock.json\nnpm instalar", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "16", + "type": "heading", + "content": "Problemas de compilaciĂłn", + "metadata": { + "level": 2 + } + }, + { + "id": "17", + "type": "heading", + "content": "Fallos de compilaciĂłn", + "metadata": { + "level": 3 + } + }, + { + "id": "18", + "type": "paragraph", + "content": "Problema: `npm run build` falla" + }, + { + "id": "19", + "type": "paragraph", + "content": "SoluciĂłn:\n1. Verificar errores de TypeScript:" + }, + { + "id": "20", + "type": "code", + "content": "npm ejecutar type-check", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "21", + "type": "paragraph", + "content": "2. Verificar que las variables de entorno estĂ©n configuradas correctamente\n3. Borrar el cachĂ© de next.js:" + }, + { + "id": "22", + "type": "code", + "content": "Eliminar -recursivo -forzar .siguiente", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "23", + "type": "heading", + "content": "Problemas de exportaciĂłn estĂĄtica", + "metadata": { + "level": 3 + } + }, + { + "id": "24", + "type": "paragraph", + "content": "Problema: La exportaciĂłn estĂĄtica falla con rutas dinĂĄmicas" + }, + { + "id": "25", + "type": "paragraph", + "content": "SoluciĂłn:\n1. Configurar `next.config.js`:" + }, + { + "id": "26", + "type": "code", + "content": "mĂłdulo.exportaciones = {\n salida: 'exportar',\n imĂĄgenes: {\n sinOptimizar: verdadero\n }\n}", + "metadata": { + "language": "js", + "showLineNumbers": true + } + }, + { + "id": "27", + "type": "heading", + "content": "Problemas de traducciĂłn", + "metadata": { + "level": 2 + } + }, + { + "id": "28", + "type": "heading", + "content": "TraducciĂłn de IA no funcionando", + "metadata": { + "level": 3 + } + }, + { + "id": "29", + "type": "paragraph", + "content": "Problema: La traducciĂłn automĂĄtica falla" + }, + { + "id": "30", + "type": "paragraph", + "content": "SoluciĂłn:\n1. Verifica que las claves de API estĂ©n configuradas correctamente\n2. Revisa la configuraciĂłn de traducciĂłn:" + }, + { + "id": "31", + "type": "code", + "content": "{\n \"traducciĂłn\": {\n \"auto_traducir\": true,\n \"proveedor\": \"anthropic\",\n \"lenguasObjetivo\": [\"es\", \"fr\", \"de\"]\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + }, + { + "id": "32", + "type": "heading", + "content": "Problemas de contenido", + "metadata": { + "level": 2 + } + }, + { + "id": "33", + "type": "heading", + "content": "Contenido no actualizĂĄndose", + "metadata": { + "level": 3 + } + }, + { + "id": "34", + "type": "paragraph", + "content": "Problema: Los cambios en los archivos de contenido no se reflejan" + }, + { + "id": "35", + "type": "paragraph", + "content": "SoluciĂłn:\nLos cambios de contenido se construyen en tiempo de compilaciĂłn. Si estĂĄ utilizando el servidor de desarrollo local, necesita reiniciar el servidor despuĂ©s de realizar cambios.\n1. Borrar la cachĂ©:" + }, + { + "id": "36", + "type": "code", + "content": "npm ejecutar limpio", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "37", + "type": "paragraph", + "content": "2. Reiniciar el servidor de desarrollo\n3. Comprobar los permisos de los archivos" + }, + { + "id": "38", + "type": "heading", + "content": "Problemas de implementaciĂłn", + "metadata": { + "level": 2 + } + }, + { + "id": "39", + "type": "heading", + "content": "Despliegue de Vercel Fallido", + "metadata": { + "level": 3 + } + }, + { + "id": "40", + "type": "paragraph", + "content": "Problema: La implementaciĂłn en Vercel falla" + }, + { + "id": "41", + "type": "paragraph", + "content": "SoluciĂłn:\n1. Revisar los registros de compilaciĂłn\n2. Verificar que las variables de entorno estĂ©n configuradas en el panel de Vercel\n3. Asegurarse de que todas las dependencias estĂ©n listadas en package.json" + }, + { + "id": "42", + "type": "heading", + "content": "Obtener ayuda", + "metadata": { + "level": 2 + } + }, + { + "id": "43", + "type": "paragraph", + "content": "Si aĂșn estĂĄs experimentando problemas:" + }, + { + "id": "44", + "type": "paragraph", + "content": "1. Consulta nuestros [GitHub Issues](https://github.com/Cloud-Code-AI/Akiradocs/issues)\n2. Únete a nuestra [Comunidad de Discord](https://discord.gg/zvYZukgeH2)\n3. Contacta con el [Soporte](mailto:saurav.panda@akiradocs.ai)" + } + ] +} \ No newline at end of file diff --git a/docs/compiled/es/docs/internationalization/ai-translation.json b/docs/compiled/es/docs/internationalization/ai-translation.json new file mode 100644 index 0000000..d7b87ba --- /dev/null +++ b/docs/compiled/es/docs/internationalization/ai-translation.json @@ -0,0 +1,91 @@ +{ + "title": "TraducciĂłn impulsada por la IA", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Internationalization", + "keywords": [ + "AI Translation", + "Automation", + "Language Processing" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "GuĂ­a para usar las capacidades de traducciĂłn de IA de AkiraDocs." + }, + { + "id": "2", + "type": "heading", + "content": "ConfiguraciĂłn", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "ConfiguraciĂłn", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "code", + "content": "{\n \"traducciĂłn\": {\n \"auto_traducir\": true,\n \"proveedor\": \"anthropic\",\n \"modelo\": \"claude-3-sonnet-20240229\",\n \"lenguasObjetivo\": [\"es\", \"fr\", \"de\"],\n \"rutasExcluidas\": [\"_meta.json\"]\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + }, + { + "id": "5", + "type": "heading", + "content": "ConfiguraciĂłn de la API", + "metadata": { + "level": 3 + } + }, + { + "id": "6", + "type": "code", + "content": "ANTHROPIC_API_KEY=tu_clave_api", + "metadata": { + "language": "env", + "showLineNumbers": true + } + }, + { + "id": "7", + "type": "heading", + "content": "CaracterĂ­sticas", + "metadata": { + "level": 2 + } + }, + { + "id": "8", + "type": "heading", + "content": "TraducciĂłn automĂĄtica", + "metadata": { + "level": 3 + } + }, + { + "id": "9", + "type": "list", + "content": [ + "TraducciĂłn de contenido durante la compilaciĂłn", + "Traducciones conscientes del contexto", + "PreservaciĂłn de tĂ©rminos tĂ©cnicos", + "Mantenimiento del formato" + ], + "metadata": { + "listType": "unordered" + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/es/docs/internationalization/managing-translation.json b/docs/compiled/es/docs/internationalization/managing-translation.json new file mode 100644 index 0000000..e3ed3dd --- /dev/null +++ b/docs/compiled/es/docs/internationalization/managing-translation.json @@ -0,0 +1,120 @@ +{ + "title": "GestiĂłn de traducciones", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Internationalization", + "keywords": [ + "Translation Management", + "Content Localization", + "Workflow" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Aprende cĂłmo gestionar y mantener de manera efectiva el contenido traducido en AkiraDocs." + }, + { + "id": "2", + "type": "heading", + "content": "Flujo de trabajo de traducciĂłn", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "TraducciĂłn automĂĄtica", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "paragraph", + "content": "1. Crear contenido en el idioma de origen\n2. Habilitar la traducciĂłn automĂĄtica en la configuraciĂłn\n3. Construir/implementar para generar traducciones\n4. Revisar y refinar las traducciones" + }, + { + "id": "5", + "type": "heading", + "content": "TraducciĂłn manual", + "metadata": { + "level": 3 + } + }, + { + "id": "6", + "type": "paragraph", + "content": "1. Crear directorios especĂ­ficos para cada idioma\n2. Copiar el contenido fuente\n3. Traducir manualmente\n4. Actualizar los metadatos" + }, + { + "id": "7", + "type": "heading", + "content": "OrganizaciĂłn del contenido", + "metadata": { + "level": 2 + } + }, + { + "id": "8", + "type": "heading", + "content": "Estructura de archivos", + "metadata": { + "level": 3 + } + }, + { + "id": "9", + "type": "code", + "content": "_contenido/\n├── en/\n│ └── docs/\n│ ├── intro.md\n│ └── guĂ­a.md\n├── es/\n│ └── docs/\n│ ├── intro.md\n│ └── guĂ­a.md\n└── fr/\n └── docs/\n ├── intro.md\n └── guĂ­a.md", + "metadata": { + "language": "plaintext", + "showLineNumbers": true + } + }, + { + "id": "10", + "type": "heading", + "content": "Control de Calidad", + "metadata": { + "level": 2 + } + }, + { + "id": "11", + "type": "heading", + "content": "Proceso de revisiĂłn", + "metadata": { + "level": 3 + } + }, + { + "id": "12", + "type": "paragraph", + "content": "1. TraducciĂłn de IA\n2. RevisiĂłn humana\n3. VerificaciĂłn tĂ©cnica\n4. PublicaciĂłn" + }, + { + "id": "13", + "type": "heading", + "content": "Control de versiones", + "metadata": { + "level": 3 + } + }, + { + "id": "14", + "type": "list", + "content": [ + "Realizar un seguimiento de los cambios en varios idiomas", + "Mantener la sincronizaciĂłn", + "Gestionar las actualizaciones de manera eficiente" + ], + "metadata": { + "listType": "unordered" + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/es/docs/internationalization/setup.json b/docs/compiled/es/docs/internationalization/setup.json new file mode 100644 index 0000000..1fdea47 --- /dev/null +++ b/docs/compiled/es/docs/internationalization/setup.json @@ -0,0 +1,116 @@ +{ + "title": "Configurar la internacionalizaciĂłn", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Internationalization", + "keywords": [ + "i18n", + "Setup", + "Languages" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Configura AkiraDocs para mĂșltiples idiomas con soporte de traducciĂłn impulsado por IA." + }, + { + "id": "2", + "type": "heading", + "content": "ConfiguraciĂłn rĂĄpida", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "ConfiguraciĂłn bĂĄsica", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "paragraph", + "content": "Agregue la configuraciĂłn de idioma a `akiradocs.config.json`:" + }, + { + "id": "5", + "type": "code", + "content": "{\n \"localization\": {\n \"defaultLocale\": \"en\",\n \"fallbackLocale\": \"en\",\n \"locales\": [\n {\n \"code\": \"en\",\n \"name\": \"InglĂ©s\",\n \"flag\": \"ïżœđŸ‡ž\"\n },\n {\n \"code\": \"es\",\n \"name\": \"Español\",\n \"flag\": \"đŸ‡Ș🇾\"\n },\n {\n \"code\": \"fr\",\n \"name\": \"FrancĂ©s\",\n \"flag\": \"đŸ‡«đŸ‡·\"\n }\n ]\n },\n \"translation\": {\n \"auto_translate\": true,\n \"provider\": \"anthropic\",\n \"targetLanguages\": [\"es\", \"fr\", \"de\"],\n \"excludedPaths\": [\"_meta.json\"]\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + }, + { + "id": "6", + "type": "heading", + "content": "Estructura de directorios", + "metadata": { + "level": 3 + } + }, + { + "id": "7", + "type": "code", + "content": "docs/\n├── _contents/\n│ ├── en/ # Idioma de origen\n│ │ └── docs/\n│ ├── es/ # TraducciĂłn al español\n│ │ └── docs/\n│ └── fr/ # TraducciĂłn al francĂ©s\n│ └── docs/", + "metadata": { + "language": "plaintext", + "showLineNumbers": true + } + }, + { + "id": "8", + "type": "heading", + "content": "Opciones de configuraciĂłn", + "metadata": { + "level": 2 + } + }, + { + "id": "9", + "type": "heading", + "content": "ConfiguraciĂłn de idioma", + "metadata": { + "level": 3 + } + }, + { + "id": "10", + "type": "list", + "content": [ + "`defaultLocale`: Idioma principal del contenido", + "`fallbackLocale`: Recurso alternativo cuando falta la traducciĂłn", + "`locales`: Configuraciones de idioma disponibles" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "11", + "type": "heading", + "content": "ConfiguraciĂłn de traducciĂłn", + "metadata": { + "level": 3 + } + }, + { + "id": "12", + "type": "list", + "content": [ + "`auto_translate`: Habilitar/deshabilitar la traducciĂłn automĂĄtica", + "`proveedor`: proveedor de traducciĂłn de IA", + "`idiomasDestino`: Idiomas a los que traducir", + "`rutasExcluidas`: Archivos que se omitirĂĄn durante la traducciĂłn" + ], + "metadata": { + "listType": "unordered" + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/es/docs/introduction.json b/docs/compiled/es/docs/introduction.json index 3f0a130..c7935c6 100644 --- a/docs/compiled/es/docs/introduction.json +++ b/docs/compiled/es/docs/introduction.json @@ -1,5 +1,5 @@ { - "title": "", + "title": "IntroducciĂłn a AkiraDocs", "description": "", "author": "Akira Team", "publishDate": "2024-11-10T00:00:00.000Z", @@ -14,12 +14,12 @@ { "id": "1", "type": "paragraph", - "content": "Conozca Akira Docs y sus funciones principales\n\nAkira Docs es una plataforma de documentaciĂłn moderna que combina el poder de la IA con un intuitivo sistema de contenido basado en bloques. Esta guĂ­a le ayudarĂĄ a comprender los conceptos y funciones principales." + "content": "AkiraDocs es una plataforma de documentaciĂłn de prĂłxima generaciĂłn que combina el poder de la IA con un intuitivo sistema de gestiĂłn de contenidos. EstĂĄ diseñada para transformar su flujo de trabajo de documentaciĂłn de dĂ­as a minutos." }, { "id": "2", "type": "heading", - "content": "CaracterĂ­sticas clave", + "content": "ÂżPor quĂ© AkiraDocs?", "metadata": { "level": 2 } @@ -27,17 +27,17 @@ { "id": "3", "type": "paragraph", - "content": "" + "content": "La documentaciĂłn suele ser un desafĂ­o para los equipos:" }, { "id": "4", "type": "list", "content": [ - "BĂșsqueda impulsada por IA", - "EdiciĂłn de contenido basada en bloques", - "Diseño adaptable", - "Temas personalizables", - "Compatibilidad con Markdown" + "Desarrolladores quieren seguir usando Markdown y Git", + "Los equipos de contenido necesitan editores fĂĄciles de usar", + "Los redactores tĂ©cnicos luchan con la gestiĂłn de versiones", + "Los gestores de productos se enfrentan a documentaciĂłn desactualizada", + "LĂ­deres empresariales necesitan mejores anĂĄlisis" ], "metadata": { "listType": "unordered" @@ -46,7 +46,100 @@ { "id": "5", "type": "paragraph", - "content": "" + "content": "AkiraDocs resuelve estos desafĂ­os al proporcionar una plataforma unificada que une el flujo de trabajo de todos." + }, + { + "id": "6", + "type": "heading", + "content": "Beneficios principales", + "metadata": { + "level": 2 + } + }, + { + "id": "7", + "type": "list", + "content": [ + "Flujo de trabajo universal: Los desarrolladores mantienen su flujo de trabajo de Markdown/Git mientras que los equipos de contenido obtienen un editor WYSIWYG basado en bloques", + "Impulsado por IA: Actualizaciones automĂĄticas de contenido, traducciones y optimizaciones", + "Optimizado para SEO: DocumentaciĂłn que se clasifica bien por defecto", + "Soporte multilingĂŒe: traducciones con inteligencia artificial y conciencia del contexto", + "Listo para empresas: integraciĂłn de SSO/SAML, registros de auditorĂ­a y opciones de implementaciĂłn personalizadas" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "8", + "type": "heading", + "content": "ÂżPara quiĂ©n es?", + "metadata": { + "level": 2 + } + }, + { + "id": "9", + "type": "heading", + "content": "DocumentaciĂłn para desarrolladores", + "metadata": { + "level": 3 + } + }, + { + "id": "10", + "type": "list", + "content": [ + "DocumentaciĂłn de la API", + "GuĂ­as del SDK", + "Especificaciones tĂ©cnicas", + "GuĂ­as de implementaciĂłn" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "11", + "type": "heading", + "content": "DocumentaciĂłn del producto", + "metadata": { + "level": 3 + } + }, + { + "id": "12", + "type": "list", + "content": [ + "GuĂ­as de usuario", + "DocumentaciĂłn de caracterĂ­sticas", + "Notas de la versiĂłn", + "Preguntas frecuentes" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "13", + "type": "heading", + "content": "DocumentaciĂłn empresarial", + "metadata": { + "level": 3 + } + }, + { + "id": "14", + "type": "list", + "content": [ + "Bases de conocimiento internas", + "DocumentaciĂłn de procesos", + "DocumentaciĂłn de cumplimiento", + "Materiales de capacitaciĂłn" + ], + "metadata": { + "listType": "unordered" + } } ] } \ No newline at end of file diff --git a/docs/compiled/es/docs/seo-and-performance/robot-txt.json b/docs/compiled/es/docs/seo-and-performance/robot-txt.json new file mode 100644 index 0000000..706250d --- /dev/null +++ b/docs/compiled/es/docs/seo-and-performance/robot-txt.json @@ -0,0 +1,45 @@ +{ + "title": "ConfiguraciĂłn de robots.txt", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "SEO & Performance", + "keywords": [ + "SEO", + "Robots.txt", + "Crawling" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "El archivo robots.txt se genera automĂĄticamente durante el proceso de compilaciĂłn y se puede encontrar en la carpeta `public` de tu proyecto." + }, + { + "id": "2", + "type": "heading", + "content": "ConfiguraciĂłn predeterminada", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "robots.txt bĂĄsico\n\nUser-agent: *\nDisallow: /", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "code", + "content": "AquĂ­ estĂĄ la traducciĂłn al español, manteniendo el formato original:\n\nUser-agent: *\nAllow: /\nSitemap: https://docs.akiradocs.com/sitemap.xml\n\n# Secciones privadas\nDisallow: /admin/\nDisallow: /private/", + "metadata": { + "language": "txt", + "showLineNumbers": true + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/es/docs/seo-and-performance/sitemap-generation.json b/docs/compiled/es/docs/seo-and-performance/sitemap-generation.json new file mode 100644 index 0000000..34377ea --- /dev/null +++ b/docs/compiled/es/docs/seo-and-performance/sitemap-generation.json @@ -0,0 +1,58 @@ +{ + "title": "GeneraciĂłn automĂĄtica de mapas del sitio", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "SEO & Performance", + "keywords": [ + "SEO", + "Sitemap", + "XML" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Aprende cĂłmo AkiraDocs genera y gestiona automĂĄticamente el mapa del sitio de tu documentaciĂłn." + }, + { + "id": "2", + "type": "heading", + "content": "DescripciĂłn general", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "paragraph", + "content": "AkiraDocs genera automĂĄticamente un archivo sitemap.xml durante el proceso de compilaciĂłn, asegurando que los motores de bĂșsqueda puedan rastrear eficientemente su documentaciĂłn." + }, + { + "id": "4", + "type": "heading", + "content": "Estructura del Mapa del Sitio Generado", + "metadata": { + "level": 2 + } + }, + { + "id": "5", + "type": "heading", + "content": "Salida de ejemplo", + "metadata": { + "level": 3 + } + }, + { + "id": "6", + "type": "code", + "content": "\n\n \n https://yourdocs.com/\n 2024-11-26\n semanal\n 1.0\n \n \n https://yourdocs.com/docs/getting-started\n 2024-11-26\n semanal\n 0.8\n \n", + "metadata": { + "language": "xml", + "showLineNumbers": true + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/fr/articles/ai_integration.json b/docs/compiled/fr/articles/ai_integration.json index 68bf424..2dfecf2 100644 --- a/docs/compiled/fr/articles/ai_integration.json +++ b/docs/compiled/fr/articles/ai_integration.json @@ -1,5 +1,5 @@ { - "title": "", + "title": "IntĂ©gration de l'IA", "description": "", "author": "Akira Team", "publishDate": "2024-11-10T00:00:00.000Z", @@ -15,23 +15,15 @@ { "id": "1", "type": "paragraph", - "content": "" + "content": "Apprenez Ă  utiliser l'assistant IA intĂ©grĂ© d'Akira pour amĂ©liorer la documentation" }, { "id": "2", - "type": "heading", - "content": "IntĂ©gration de l'Assistant IA", - "metadata": { - "level": 1 - } - }, - { - "id": "3", "type": "paragraph", - "content": "Apprenez Ă  utiliser l'assistant IA intĂ©grĂ© d'Akira pour amĂ©liorer la documentation\n\nL'Assistant IA d'Akira est un outil puissant qui aide les dĂ©veloppeurs et les rĂ©dacteurs techniques Ă  crĂ©er, maintenir et amĂ©liorer la documentation grĂące Ă  des interactions en langage naturel. Ce guide couvre les fonctionnalitĂ©s essentielles et les meilleures pratiques pour utiliser efficacement l'assistant IA." + "content": "Voici la traduction en français, en conservant la mise en forme d'origine :\n\nL'assistant IA d'Akira est un outil puissant qui aide les dĂ©veloppeurs et les rĂ©dacteurs techniques Ă  crĂ©er, maintenir et amĂ©liorer la documentation grĂące Ă  des interactions en langage naturel. Ce guide couvre les fonctionnalitĂ©s essentielles et les meilleures pratiques pour utiliser efficacement l'assistant IA." }, { - "id": "4", + "id": "3", "type": "heading", "content": "Voici la traduction en français :\n\nCaractĂ©ristiques clĂ©s", "metadata": { @@ -39,12 +31,7 @@ } }, { - "id": "5", - "type": "paragraph", - "content": "" - }, - { - "id": "6", + "id": "4", "type": "list", "content": [ "GĂ©nĂ©ration de documentation en langage naturel", @@ -58,12 +45,7 @@ } }, { - "id": "7", - "type": "paragraph", - "content": "" - }, - { - "id": "8", + "id": "5", "type": "heading", "content": "Commençant", "metadata": { @@ -71,12 +53,12 @@ } }, { - "id": "9", + "id": "6", "type": "paragraph", "content": "Voici la traduction en français :\n\nL'Assistant IA peut ĂȘtre accĂ©dĂ© via le menu des commandes (Ctrl+Maj+P) ou en utilisant la commande `/ai` dans n'importe quel bloc de contenu. Il comprend les demandes contextuelles et peut vous aider dans diverses tĂąches de documentation." }, { - "id": "10", + "id": "7", "type": "heading", "content": "Voici la traduction en français, en conservant la mise en forme d'origine :\n\nCas d'utilisation courants", "metadata": { @@ -84,12 +66,12 @@ } }, { - "id": "11", + "id": "8", "type": "paragraph", "content": "1. GĂ©nĂ©rer des exemples de code\n2. Expliquer des concepts techniques\n3. Restructurer le contenu\n4. CrĂ©er des schĂ©mas de documentation\n5. Traduire la documentation" }, { - "id": "12", + "id": "9", "type": "heading", "content": "Meilleures Pratiques", "metadata": { @@ -97,12 +79,7 @@ } }, { - "id": "13", - "type": "paragraph", - "content": "" - }, - { - "id": "14", + "id": "10", "type": "list", "content": [ "Fournissez un contexte clair lors de la formulation de demandes", @@ -116,12 +93,7 @@ } }, { - "id": "15", - "type": "paragraph", - "content": "" - }, - { - "id": "16", + "id": "11", "type": "heading", "content": "Voici la traduction en français :\n\nOptions de configuration", "metadata": { @@ -129,12 +101,12 @@ } }, { - "id": "17", + "id": "12", "type": "paragraph", "content": "Voici la traduction en français, en conservant la mise en forme d'origine :\n\nVous pouvez personnaliser le comportement de l'Assistant IA via le fichier `config.yaml` :" }, { - "id": "18", + "id": "13", "type": "code", "content": "ai_assistant:\n modĂšle: \"advanced-docs-v2\"\n tempĂ©rature: 0,7\n max_tokens: 2048\n guide_de_style: \"path/to/style/guide.md\"", "metadata": { @@ -143,12 +115,7 @@ } }, { - "id": "19", - "type": "paragraph", - "content": "" - }, - { - "id": "20", + "id": "14", "type": "heading", "content": "Voici la traduction en français :\n\nProchaines Ă©tapes", "metadata": { @@ -156,7 +123,7 @@ } }, { - "id": "21", + "id": "15", "type": "paragraph", "content": "Explorez notre guide des [FonctionnalitĂ©s avancĂ©es d'IA](/advanced-ai-features) pour en apprendre davantage sur les cas d'utilisation spĂ©cialisĂ©s et les possibilitĂ©s d'intĂ©gration." } diff --git a/docs/compiled/fr/articles/template.json b/docs/compiled/fr/articles/template.json index 036dd81..20ef6ab 100644 --- a/docs/compiled/fr/articles/template.json +++ b/docs/compiled/fr/articles/template.json @@ -2,7 +2,13 @@ "title": "Voici la traduction en français, avec le formatage d'origine conservĂ© :\n\nTest de billet de blog", "description": "Voici la traduction en français, avec le formatage d'origine conservĂ© :\n\nUn article de blog de test pour dĂ©montrer tous les types de blocs.", "author": "Anonymous", - "date": "2024-11-08", + "publishDate": "2024-11-10T00:00:00.000Z", + "modifiedDate": "2024-11-10T00:00:00.000Z", + "heroImage": { + "url": "/blog-hero-image.jpg", + "alt": "Hero image for the blog post", + "caption": "Optional caption for the hero image" + }, "blocks": [ { "id": "1", diff --git a/docs/compiled/fr/articles/welcome.json b/docs/compiled/fr/articles/welcome.json index 83df3fd..f3faa83 100644 --- a/docs/compiled/fr/articles/welcome.json +++ b/docs/compiled/fr/articles/welcome.json @@ -14,23 +14,10 @@ { "id": "1", "type": "paragraph", - "content": "" - }, - { - "id": "2", - "type": "heading", - "content": "Bienvenue sur Akira Doc", - "metadata": { - "level": 1 - } - }, - { - "id": "3", - "type": "paragraph", "content": "Bienvenue sur Akira Docs, la plateforme de documentation de nouvelle gĂ©nĂ©ration propulsĂ©e par l'IA. Ce modĂšle vous aidera Ă  commencer Ă  crĂ©er votre propre documentation." }, { - "id": "4", + "id": "2", "type": "heading", "content": "Voici la traduction en français :\n\nCaractĂ©ristiques clĂ©s", "metadata": { @@ -38,12 +25,7 @@ } }, { - "id": "5", - "type": "paragraph", - "content": "" - }, - { - "id": "6", + "id": "3", "type": "list", "content": [ "Facile Ă  personnaliser", @@ -56,9 +38,13 @@ } }, { - "id": "7", - "type": "paragraph", - "content": "> [!info] Premiers pas\n> Commencez par personnaliser ce modĂšle pour qu'il corresponde aux besoins de votre projet !" + "id": "4", + "type": "callout", + "content": "Voici la traduction en français :\n\nCommencez par personnaliser ce modĂšle pour qu'il corresponde aux besoins de votre projet !", + "metadata": { + "type": "info", + "title": "Getting Started" + } } ] } \ No newline at end of file diff --git a/docs/compiled/fr/docs/api-reference/usage-guide.json b/docs/compiled/fr/docs/api-reference/usage-guide.json new file mode 100644 index 0000000..649845b --- /dev/null +++ b/docs/compiled/fr/docs/api-reference/usage-guide.json @@ -0,0 +1,160 @@ +{ + "title": "Voici la traduction en français :\n\nGuide de documentation de l'API", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "API Reference", + "keywords": [ + "API", + "Documentation", + "Integration" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Apprenez Ă  gĂ©nĂ©rer une documentation d'API complĂšte Ă  l'aide d'AkiraDocs." + }, + { + "id": "2", + "type": "heading", + "content": "DĂ©marrage rapide", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "Charger la spĂ©cification de l'API", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "paragraph", + "content": "1. Placez votre spĂ©cification OpenAPI/Swagger ici :" + }, + { + "id": "5", + "type": "code", + "content": "_contenu/{code_langue}/api/apiSpec.json", + "metadata": { + "language": "plaintext", + "showLineNumbers": true + } + }, + { + "id": "6", + "type": "paragraph", + "content": "2. AkiraDocs gĂ©nĂšre automatiquement la documentation." + }, + { + "id": "7", + "type": "heading", + "content": "Voici la traduction en français :\n\nSpĂ©cification d'API d'exemple", + "metadata": { + "level": 3 + } + }, + { + "id": "8", + "type": "code", + "content": "{\n \"openapi\": \"3.0.0\",\n \"info\": {\n \"title\": \"Exemple d'API\",\n \"version\": \"1.0.0\"\n },\n \"paths\": {\n \"/users\": {\n \"get\": {\n \"summary\": \"Obtenir les utilisateurs\",\n \"responses\": {\n \"200\": {\n \"description\": \"SuccĂšs\"\n }\n }\n }\n }\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + }, + { + "id": "9", + "type": "heading", + "content": "Voici la traduction en français :\n\nDocumentation gĂ©nĂ©rĂ©e", + "metadata": { + "level": 2 + } + }, + { + "id": "10", + "type": "heading", + "content": "CaractĂ©ristiques automatiques", + "metadata": { + "level": 3 + } + }, + { + "id": "11", + "type": "list", + "content": [ + "Explorateur d'API interactif", + "Échantillons de code dans plusieurs langues", + "Voici la traduction en français, avec le formatage d'origine conservĂ© :\n\nExemples de requĂȘte/rĂ©ponse", + "Voici la traduction en français :\n\nDocumentation d'authentification" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "12", + "type": "heading", + "content": "Sortie d'exemple", + "metadata": { + "level": 3 + } + }, + { + "id": "13", + "type": "code", + "content": "// Exemple : Obtenir les utilisateurs\nconst response = await fetch('https://api.example.com/users', {\n method: 'GET',\n headers: {\n 'Authorization': 'Bearer TON_JET'\n }\n});\n\nconst users = await response.json();", + "metadata": { + "language": "javascript", + "showLineNumbers": true + } + }, + { + "id": "14", + "type": "heading", + "content": "Voici la traduction en français :\n\nPersonnalisation", + "metadata": { + "level": 2 + } + }, + { + "id": "15", + "type": "heading", + "content": "Voici la traduction en français :\n\nOptions de thĂšme", + "metadata": { + "level": 3 + } + }, + { + "id": "16", + "type": "code", + "content": "{\n \"api\": {\n \"docs\": {\n \"thĂšme\": \"sombre\",\n \"syntaxeColorĂ©e\": true,\n \"afficherExemples\": true\n }\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + }, + { + "id": "17", + "type": "heading", + "content": "SĂ©lection de langue", + "metadata": { + "level": 3 + } + }, + { + "id": "18", + "type": "code", + "content": "{\n \"api\": {\n \"exemples\": {\n \"langues\": [\"javascript\", \"python\", \"curl\"]\n }\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/fr/docs/content-management/creating-pages.json b/docs/compiled/fr/docs/content-management/creating-pages.json new file mode 100644 index 0000000..4ce4332 --- /dev/null +++ b/docs/compiled/fr/docs/content-management/creating-pages.json @@ -0,0 +1,152 @@ +{ + "title": "Voici la traduction en français :\n\nCrĂ©er et organiser des pages", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Content Management", + "keywords": [ + "Content Creation", + "Pages", + "Organization" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Apprenez Ă  crĂ©er, structurer et organiser vos pages de documentation dans AkiraDocs. Vous pouvez crĂ©er des pages markdown ou simplement utiliser l'interface utilisateur de l'Ă©diteur. Notez que dans le dossier _contents, vous ne verrez que le contenu markdown que vous avez crĂ©Ă©. Si vous utilisez l'interface utilisateur de l'Ă©diteur, le contenu sera enregistrĂ© dans le dossier compilĂ© et sera automatiquement traduit dans d'autres langues." + }, + { + "id": "2", + "type": "heading", + "content": "Voici la traduction en français :\n\nStructure de page", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "ModĂšle de Page de Base", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "code", + "content": "---\ntitre: Votre titre de page\ndescription: BrĂšve description de la page\nauteur: Votre nom\ndateDePublication: 2024-11-26\ndateDerniereModification: 2024-11-26\ncategorie: Nom de la catĂ©gorie\nmotsCles:\n - mot clĂ© 1\n - mot clĂ© 2\n---\n\n# Titre principal\n\nLe contenu commence ici...", + "metadata": { + "language": "markdown", + "showLineNumbers": true + } + }, + { + "id": "5", + "type": "heading", + "content": "Voici la traduction en français :\n\nStructure des rĂ©pertoires", + "metadata": { + "level": 3 + } + }, + { + "id": "6", + "type": "code", + "content": "dossier_nom/\n├── _contenus/\n│ ├── fr/\n│ │ ├── pour-commencer/\n│ │ ├── guides/\n│ │ └── api/", + "metadata": { + "language": "plaintext", + "showLineNumbers": true + } + }, + { + "id": "7", + "type": "paragraph", + "content": "Vous pouvez simplement crĂ©er des pages pour la langue par dĂ©faut (en) et AkiraDocs les traduira automatiquement dans d'autres langues." + }, + { + "id": "8", + "type": "heading", + "content": "CrĂ©ation de nouvelles pages", + "metadata": { + "level": 2 + } + }, + { + "id": "9", + "type": "heading", + "content": "MĂ©thode 1 : Utilisation de l'interface utilisateur", + "metadata": { + "level": 3 + } + }, + { + "id": "10", + "type": "paragraph", + "content": "1. Cliquez sur \"Nouvelle page\" dans la barre latĂ©rale\n2. Commencez Ă  ajouter du contenu" + }, + { + "id": "11", + "type": "heading", + "content": "MĂ©thode 2 : CrĂ©ation de fichier directe", + "metadata": { + "level": 3 + } + }, + { + "id": "12", + "type": "paragraph", + "content": "1. CrĂ©ez un nouveau fichier `.md` dans le rĂ©pertoire appropriĂ©\n2. Ajoutez les mĂ©tadonnĂ©es (frontmatter) requises\n3. Écrivez le contenu en utilisant Markdown\n4. Enregistrez et compilez" + }, + { + "id": "13", + "type": "heading", + "content": "Organisation de la page", + "metadata": { + "level": 2 + } + }, + { + "id": "14", + "type": "heading", + "content": "Voici la traduction en français :\n\nCatĂ©gories et Étiquettes", + "metadata": { + "level": 3 + } + }, + { + "id": "15", + "type": "list", + "content": [ + "Utilisez des catĂ©gories cohĂ©rentes", + "Appliquez les Ă©tiquettes pertinentes", + "Organiser par thĂšme", + "CrĂ©ez des hiĂ©rarchies logiques" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "16", + "type": "heading", + "content": "Voici la traduction en français :\n\nStructure de navigation", + "metadata": { + "level": 3 + } + }, + { + "id": "17", + "type": "paragraph", + "content": "Voici la traduction en français, avec le formatage d'origine conservĂ© :\n\nCeci est gĂ©nĂ©rĂ© automatiquement Ă  partir de la structure des dossiers. Vous pouvez le personnaliser en Ă©ditant le fichier `_meta.json` dans le dossier compilĂ©." + }, + { + "id": "18", + "type": "code", + "content": "{\n \"docs\": {\n \"getting-started\": {\n \"title\": \"Commencer\",\n \"items\": {\n \"introduction\": {\n \"title\": \"Introduction\",\n \"path\": \"/docs/getting-started/introduction\"\n }\n }\n }\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/fr/docs/contributing/code-of-conduct.json b/docs/compiled/fr/docs/contributing/code-of-conduct.json new file mode 100644 index 0000000..9c1a04b --- /dev/null +++ b/docs/compiled/fr/docs/contributing/code-of-conduct.json @@ -0,0 +1,99 @@ +{ + "title": "Code de conduite", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Contributing", + "keywords": [ + "Code of Conduct", + "Contributing" + ], + "blocks": [ + { + "id": "1", + "type": "heading", + "content": "Voici la traduction en français :\n\nNotre Engagement", + "metadata": { + "level": 2 + } + }, + { + "id": "2", + "type": "paragraph", + "content": "Nous, en tant que membres, collaborateurs et dirigeants, nous nous engageons Ă  faire en sorte que la participation Ă  notre communautĂ© soit une expĂ©rience exempte de harcĂšlement pour tous, indĂ©pendamment de l'Ăąge, de la taille corporelle, du handicap visible ou invisible, de l'origine ethnique, des caractĂ©ristiques sexuelles, de l'identitĂ© et de l'expression de genre, du niveau d'expĂ©rience, de l'Ă©ducation, de la situation socio-Ă©conomique, de la nationalitĂ©, de l'apparence personnelle, de la race, de la religion ou de l'identitĂ© et de l'orientation sexuelle." + }, + { + "id": "3", + "type": "paragraph", + "content": "Nous nous engageons Ă  agir et Ă  interagir de maniĂšres qui contribuent Ă  une communautĂ© ouverte, accueillante, diversifiĂ©e, inclusive et saine." + }, + { + "id": "4", + "type": "heading", + "content": "Nos Normes", + "metadata": { + "level": 2 + } + }, + { + "id": "5", + "type": "paragraph", + "content": "Voici la traduction en français, avec le formatage d'origine conservĂ© :\n\nExemples de comportements contribuant Ă  un environnement positif :" + }, + { + "id": "6", + "type": "paragraph", + "content": "* Faire preuve d'empathie et de gentillesse envers les autres\n* Respecter les opinions, points de vue et expĂ©riences diffĂ©rents\n* Donner et accepter avec grĂące les critiques constructives\n* Accepter la responsabilitĂ© et s'excuser auprĂšs de ceux qui ont Ă©tĂ© affectĂ©s par nos erreurs\n* Se concentrer sur ce qui est le mieux pour la communautĂ© dans son ensemble" + }, + { + "id": "7", + "type": "paragraph", + "content": "Voici la traduction en français, avec le formatage d'origine conservĂ© :\n\nExemples de comportements inacceptables :" + }, + { + "id": "8", + "type": "paragraph", + "content": "* L'utilisation d'un langage ou d'images sexualisĂ©es, et l'attention ou les insinuations sexuelles\n* Le trolling, les commentaires insultants ou dĂ©sobligeants, et les attaques personnelles ou politiques\n* Le harcĂšlement public ou privĂ©\n* La publication d'informations privĂ©es d'autres personnes sans leur autorisation explicite\n* Tout autre comportement qui pourrait raisonnablement ĂȘtre considĂ©rĂ© comme inappropriĂ© dans un environnement professionnel" + }, + { + "id": "9", + "type": "heading", + "content": "ResponsabilitĂ©s de ConformitĂ©", + "metadata": { + "level": 2 + } + }, + { + "id": "10", + "type": "paragraph", + "content": "Voici la traduction en français :\n\nLes leaders communautaires sont chargĂ©s de clarifier et de faire respecter nos normes de comportement acceptable et prendront les mesures correctives appropriĂ©es et Ă©quitables en rĂ©ponse Ă  tout comportement qu'ils jugeraient inappropriĂ©, menaçant, offensant ou nuisible." + }, + { + "id": "11", + "type": "heading", + "content": "ConformitĂ©", + "metadata": { + "level": 2 + } + }, + { + "id": "12", + "type": "paragraph", + "content": "Voici la traduction en français :\n\nDes cas de comportement abusif, harcelant ou inacceptable d'une autre maniĂšre peuvent ĂȘtre signalĂ©s aux responsables communautaires chargĂ©s de l'application. Toutes les plaintes seront examinĂ©es et Ă©tudiĂ©es de maniĂšre rapide et Ă©quitable." + }, + { + "id": "13", + "type": "heading", + "content": "Voici la traduction en français :\n\nAttribution", + "metadata": { + "level": 2 + } + }, + { + "id": "14", + "type": "paragraph", + "content": "Voici la traduction en français, avec le formatage d'origine conservĂ© :\n\nCe Code de Conduite est adaptĂ© du [Contributor Covenant](https://www.contributor-covenant.org), version 2.0, disponible sur https://www.contributor-covenant.org/version/2/0/code_of_conduct.html." + } + ] +} \ No newline at end of file diff --git a/docs/compiled/fr/docs/contributing/how-to-contribute.json b/docs/compiled/fr/docs/contributing/how-to-contribute.json new file mode 100644 index 0000000..03e0b90 --- /dev/null +++ b/docs/compiled/fr/docs/contributing/how-to-contribute.json @@ -0,0 +1,213 @@ +{ + "title": "Contribuer Ă  AkiraDocs", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Contributing", + "keywords": [ + "Contributing", + "Open Source", + "Development" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Voici la traduction en français :\n\nGuide pour contribuer au projet de code source ouvert AkiraDocs." + }, + { + "id": "2", + "type": "heading", + "content": "Commençant", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "Configurer l'Environnement de DĂ©veloppement", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "code", + "content": "# Cloner le dĂ©pĂŽt\ngit clone https://github.com/Cloud-Code-AI/akiradocs\ncd akiradocs\n\n# Installer les dĂ©pendances\nnpm install\n\n# DĂ©marrer le serveur de dĂ©veloppement\nnpm run dev", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "5", + "type": "heading", + "content": "Voici la traduction en français, avec le formatage d'origine conservĂ© :\n\nLignes directrices pour contribuer", + "metadata": { + "level": 2 + } + }, + { + "id": "6", + "type": "heading", + "content": "Voici la traduction en français :\n\nTypes de contributions", + "metadata": { + "level": 3 + } + }, + { + "id": "7", + "type": "list", + "content": [ + "Corrections d'erreurs", + "Traductions des fonctions", + "Voici la traduction en français :\n\nAmĂ©liorations de la documentation", + "Voici la traduction en français :\n\nAide Ă  la traduction", + "Rapports de problĂšmes" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "8", + "type": "heading", + "content": "Processus de demande d'extraction", + "metadata": { + "level": 3 + } + }, + { + "id": "9", + "type": "paragraph", + "content": "1. Bifurquer le dĂ©pĂŽt\n2. CrĂ©er une branche de fonctionnalitĂ©\n3. Effectuer des modifications\n4. Envoyer une demande de pull" + }, + { + "id": "10", + "type": "heading", + "content": "Voici la traduction en français :\n\nMessages de confirmation", + "metadata": { + "level": 3 + } + }, + { + "id": "11", + "type": "code", + "content": "# Format\ntype(portĂ©e) : description\n\n# Exemples\nfeat(Ă©diteur) : ajouter un nouveau type de bloc\nfix(traduction) : corriger la dĂ©tection de langue\ndocs(api) : mettre Ă  jour le guide d'authentification", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "12", + "type": "heading", + "content": "Voici la traduction en français :\n\nGuides de dĂ©veloppement", + "metadata": { + "level": 2 + } + }, + { + "id": "13", + "type": "heading", + "content": "Style du code", + "metadata": { + "level": 3 + } + }, + { + "id": "14", + "type": "list", + "content": [ + "Suivez les modĂšles existants", + "Utilisez TypeScript", + "Ajouter des commentaires", + "Écrire des tests" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "15", + "type": "heading", + "content": "Voici la traduction en français :\n\nTest", + "metadata": { + "level": 3 + } + }, + { + "id": "16", + "type": "code", + "content": "# ExĂ©cuter les tests\nnpm run test\n\n# VĂ©rifier les types\nnpm run type-check\n\n# Lint code\nnpm run lint", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "17", + "type": "heading", + "content": "Voici la traduction en français :\n\nDocumentation", + "metadata": { + "level": 2 + } + }, + { + "id": "18", + "type": "heading", + "content": "Mettre Ă  jour les documents", + "metadata": { + "level": 3 + } + }, + { + "id": "19", + "type": "paragraph", + "content": "1. Modifier les fichiers pertinents\n2. Mettre Ă  jour les exemples\n3. VĂ©rifier les liens\n4. VĂ©rifier le format" + }, + { + "id": "20", + "type": "heading", + "content": "CrĂ©er des exemples", + "metadata": { + "level": 3 + } + }, + { + "id": "21", + "type": "list", + "content": [ + "Clair et concis", + "Bien documentĂ©", + "Voici la traduction en français :\n\nTestĂ©", + "Maintenable" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "22", + "type": "heading", + "content": "Obtenir de l'aide", + "metadata": { + "level": 2 + } + }, + { + "id": "23", + "type": "list", + "content": [ + "Rejoins [Discord](https://discord.gg/zvYZukgeH2)", + "VĂ©rifiez les [ProblĂšmes](https://github.com/Cloud-Code-AI/akiradocs/issues)", + "Lisez la [Documentation](https://docs.akiradocs.com)" + ], + "metadata": { + "listType": "unordered" + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/fr/docs/editor/features.json b/docs/compiled/fr/docs/editor/features.json new file mode 100644 index 0000000..db01e65 --- /dev/null +++ b/docs/compiled/fr/docs/editor/features.json @@ -0,0 +1,205 @@ +{ + "title": "FonctionnalitĂ©s de l'Ă©diteur", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Editor", + "keywords": [ + "Editor Features", + "Blocks", + "Formatting" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Voici la traduction en français :\n\nDescription dĂ©taillĂ©e des capacitĂ©s et fonctions de l'Ă©diteur AkiraDocs." + }, + { + "id": "2", + "type": "heading", + "content": "Voici la traduction en français :\n\nSystĂšme de blocs", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "Voici la traduction en français, avec le formatage d'origine conservĂ© :\n\nFormat du texte", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "list", + "content": [ + "Format de base", + "Gras, italique, soulignĂ©", + "BarrĂ©", + "Mettre en Ă©vidence", + "Code en ligne" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "5", + "type": "list", + "content": [ + "Format AvancĂ©", + "Couleurs personnalisĂ©es", + "Voici la traduction en français :\n\nSources multiples", + "Alignement du texte", + "Indentation" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "6", + "type": "heading", + "content": "Blocs de contenu", + "metadata": { + "level": 3 + } + }, + { + "id": "7", + "type": "heading", + "content": "Texte enrichi", + "metadata": { + "level": 4 + } + }, + { + "id": "8", + "type": "code", + "content": "# Titre 1\n## Titre 2\n> Citation textuelle\n- Liste Ă  puces\n1. Liste numĂ©rotĂ©e", + "metadata": { + "language": "markdown", + "showLineNumbers": true + } + }, + { + "id": "9", + "type": "heading", + "content": "Blocs de code", + "metadata": { + "level": 4 + } + }, + { + "id": "10", + "type": "code", + "content": "// Mise en Ă©vidence de la syntaxe\nconsole.log('Bonjour le monde');", + "metadata": { + "language": "javascript", + "showLineNumbers": true + } + }, + { + "id": "11", + "type": "heading", + "content": "Blocs de mĂ©dias", + "metadata": { + "level": 4 + } + }, + { + "id": "12", + "type": "list", + "content": [ + "Chargement et incorporation d'images", + "IntĂ©gration vidĂ©o", + "PiĂšces jointes", + "Voici la traduction en français :\n\nIntĂ©gration interactive" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "13", + "type": "heading", + "content": "Voici la traduction en français :\n\nCaractĂ©ristiques de l'IA", + "metadata": { + "level": 2 + } + }, + { + "id": "14", + "type": "heading", + "content": "Voici la traduction en français :\n\nAmĂ©lioration du contenu", + "metadata": { + "level": 3 + } + }, + { + "id": "15", + "type": "list", + "content": [ + "Voici la traduction en français :\n\nSuggestions de grammaire et de style", + "Voici la traduction en français :\n\nOptimisation du contenu", + "Voici la traduction en français :\n\nRecommandations de SEO", + "Voici la traduction en français :\n\nAssistance de traduction" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "16", + "type": "heading", + "content": "Voici la traduction en français :\n\nFormat intelligent", + "metadata": { + "level": 3 + } + }, + { + "id": "17", + "type": "list", + "content": [ + "Mise en forme automatique", + "Voici la traduction en français :\n\nListes intelligentes", + "Voici la traduction en français, avec le formatage d'origine conservĂ© :\n\nFormat de tableau", + "DĂ©tection de langue de bloc de code" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "18", + "type": "heading", + "content": "CaractĂ©ristiques de collaboration", + "metadata": { + "level": 2 + } + }, + { + "id": "19", + "type": "heading", + "content": "ContrĂŽle de version", + "metadata": { + "level": 3 + } + }, + { + "id": "20", + "type": "list", + "content": [ + "IntĂ©gration de Git", + "Voici la traduction en français :\n\nHistorique des modifications", + "Voici la traduction en français :\n\nCapacitĂ©s de rĂ©version" + ], + "metadata": { + "listType": "unordered" + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/fr/docs/editor/overview.json b/docs/compiled/fr/docs/editor/overview.json new file mode 100644 index 0000000..32dd643 --- /dev/null +++ b/docs/compiled/fr/docs/editor/overview.json @@ -0,0 +1,185 @@ +{ + "title": "Aperçu de l'Ă©diteur", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Editor", + "keywords": [ + "Editor", + "Notion-like", + "Interface" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "AkiraDocs dispose d'un Ă©diteur moderne similaire Ă  Notion qui combine la simplicitĂ© de l'Ă©dition basĂ©e sur des blocs avec la puissance de Markdown." + }, + { + "id": "2", + "type": "heading", + "content": "Voici la traduction en français :\n\nInterface de l'Ă©diteur", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "Voici la traduction en français tout en conservant la mise en forme d'origine :\n\nComposants principaux", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "list", + "content": [ + "Barre d'outils : AccĂšs rapide aux options de formatage et aux types de blocs", + "Zone de contenu : Espace d'Ă©dition basĂ© sur des blocs", + "Barre latĂ©rale : Navigation et structure du document", + "Palette de commandes : Commandes rapides (Ctrl/Cmd + P)" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "5", + "type": "heading", + "content": "Voici la traduction en français :\n\nStructure de Blocs", + "metadata": { + "level": 3 + } + }, + { + "id": "6", + "type": "paragraph", + "content": "Voici la traduction en français, avec le formatage d'origine conservĂ© :\n\nChaque Ă©lĂ©ment de contenu est un bloc qui peut ĂȘtre :" + }, + { + "id": "7", + "type": "list", + "content": [ + "Glisser-dĂ©poser pour rĂ©organiser", + "Converti entre diffĂ©rents types", + "DupliquĂ© ou supprimĂ©", + "ImbriquĂ© dans d'autres blocs" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "8", + "type": "heading", + "content": "Commençant", + "metadata": { + "level": 2 + } + }, + { + "id": "9", + "type": "heading", + "content": "CrĂ©ation de contenu", + "metadata": { + "level": 3 + } + }, + { + "id": "10", + "type": "paragraph", + "content": "1. Cliquez sur le bouton '+' ou appuyez sur '/' pour ajouter un nouveau bloc\n2. Choisissez le type de bloc dans le menu dĂ©roulant\n3. Commencez Ă  Ă©crire ou ajoutez du contenu" + }, + { + "id": "11", + "type": "heading", + "content": "OpĂ©rations de base", + "metadata": { + "level": 3 + } + }, + { + "id": "12", + "type": "code", + "content": "/ → Ouvrir le menu du bloc\n⌘/Ctrl + P → Palette de commandes\n⌘/Ctrl + / → Afficher les raccourcis clavier\n↑↓ → Naviguer entre les blocs", + "metadata": { + "language": "plaintext", + "showLineNumbers": true + } + }, + { + "id": "13", + "type": "heading", + "content": "Voici la traduction en français :\n\nTypes de blocs", + "metadata": { + "level": 2 + } + }, + { + "id": "14", + "type": "heading", + "content": "Blocs de texte", + "metadata": { + "level": 3 + } + }, + { + "id": "15", + "type": "list", + "content": [ + "Voici la traduction en français, avec le formatage d'origine conservĂ© :\n\nParagraphes", + "Voici la traduction en français, avec le formatage d'origine conservĂ© :\n\nTitres (H1-H6)", + "Listes (avec puces, numĂ©rotĂ©es)", + "Voici la traduction en français :\n\nCitations", + "Voici la traduction en français :\n\nAppels" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "16", + "type": "heading", + "content": "Contenu MultimĂ©dia Enrichi", + "metadata": { + "level": 3 + } + }, + { + "id": "17", + "type": "list", + "content": [ + "Voici la traduction en français :\n\nImages", + "Voici la traduction en français :\n\nVidĂ©os", + "Incrustations", + "Fichiers", + "Blocs de code" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "18", + "type": "heading", + "content": "Blocs spĂ©ciaux", + "metadata": { + "level": 3 + } + }, + { + "id": "19", + "type": "list", + "content": [ + "Tableaux (Prochainement)", + "Diviseurs", + "Composants personnalisĂ©s (BientĂŽt disponible)" + ], + "metadata": { + "listType": "unordered" + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/fr/docs/getting-started/features.json b/docs/compiled/fr/docs/getting-started/features.json new file mode 100644 index 0000000..6a30f6b --- /dev/null +++ b/docs/compiled/fr/docs/getting-started/features.json @@ -0,0 +1,137 @@ +{ + "title": "FonctionnalitĂ©s d'AkiraDocs", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Getting Started", + "keywords": [ + "Akira Docs", + "Documentation", + "AI" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Voici la traduction en français :\n\nUne description gĂ©nĂ©rale complĂšte des fonctions et des principales capacitĂ©s d'AkiraDocs." + }, + { + "id": "2", + "type": "heading", + "content": "Voici la traduction en français :\n\nCrĂ©ation et gestion de contenu", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "list", + "content": [ + "Éditeur similaire Ă  Notion : Interface intuitive basĂ©e sur des blocs avec aperçu en temps rĂ©el", + "Prise en charge de Markdown : CompatibilitĂ© native avec Markdown et MDX", + "Composants personnalisĂ©s : CrĂ©ez et rĂ©utilisez vos propres blocs de contenu" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "4", + "type": "heading", + "content": "Voici la traduction en français :\n\nInternationalisation et traduction", + "metadata": { + "level": 2 + } + }, + { + "id": "5", + "type": "list", + "content": [ + "Prise en charge de plusieurs langues : Maintenir la documentation dans plusieurs langues", + "Traduction alimentĂ©e par l'IA : Traduction de contenu automatisĂ©e et consciente du contexte", + "Gestion des traductions : Outils intĂ©grĂ©s pour gĂ©rer le contenu localisĂ©" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "6", + "type": "heading", + "content": "Recherche et dĂ©couverte", + "metadata": { + "level": 2 + } + }, + { + "id": "7", + "type": "list", + "content": [ + "Recherche AlimentĂ©e par l'IA : RĂ©ponse aux questions en langage naturel avec prise en compte du contexte", + "Optimisation SEO : Outils et optimisations SEO automatisĂ©s", + "Indexation intelligente : Mises Ă  jour d'index de recherche en temps rĂ©el" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "8", + "type": "heading", + "content": "Voici la traduction en français :\n\nConstruction et performance", + "metadata": { + "level": 2 + } + }, + { + "id": "9", + "type": "list", + "content": [ + "GĂ©nĂ©ration Statique : Processus de compilation optimisĂ© avec optimisation des ressources", + "ExpĂ©rience de dĂ©veloppeur : Mise Ă  jour rapide et outils de dĂ©bogage complets", + "Accent sur les performances : Pratiques recommandĂ©es intĂ©grĂ©es pour la vitesse et l'efficacitĂ©" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "10", + "type": "heading", + "content": "CaractĂ©ristiques d'entreprise (BientĂŽt disponible)", + "metadata": { + "level": 2 + } + }, + { + "id": "11", + "type": "list", + "content": [ + "SĂ©curitĂ© et conformitĂ© : SSO, RBAC et journalisation d'audit", + "Analyse et perspectives : Suivi de l'utilisation et des mĂ©triques de documentation", + "Collaboration d'Ă©quipe : Outils de collaboration de niveau entreprise" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "12", + "type": "heading", + "content": "Prise en charge de la migration (bientĂŽt disponible)", + "metadata": { + "level": 2 + } + }, + { + "id": "13", + "type": "code", + "content": "# Plateformes compatibles pour une migration simple\n✓ Nextra\n✓ GitBook\n✓ Docusaurus\n✓ ReadTheDocs", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/fr/docs/getting-started/quickstart.json b/docs/compiled/fr/docs/getting-started/quickstart.json index f207aa0..b271a25 100644 --- a/docs/compiled/fr/docs/getting-started/quickstart.json +++ b/docs/compiled/fr/docs/getting-started/quickstart.json @@ -14,35 +14,146 @@ { "id": "1", "type": "paragraph", - "content": "DĂ©marrez avec Akira Docs en quelques minutes\n\nSuivez ces Ă©tapes pour commencer Ă  utiliser Akira Docs pour vos besoins de documentation." + "content": "DĂ©marrez avec AkiraDocs en quelques minutes." }, { "id": "2", + "type": "heading", + "content": "DĂ©ploiement rapide", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "Voici la traduction en français :\n\nOption 1 : Mettre en Ɠuvre avec Vercel", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "paragraph", + "content": "Voici la traduction en français, avec le formatage d'origine conservĂ© :\n\nLa façon la plus rapide de commencer est d'utiliser Vercel :" + }, + { + "id": "5", + "type": "paragraph", + "content": "[![DĂ©ployer avec Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2FCloud-Code-AI%2Fakiradocs-template)" + }, + { + "id": "6", + "type": "heading", + "content": "Voici la traduction en français :\n\nOption 2 : Utilisation de l'interface en ligne de commande", + "metadata": { + "level": 3 + } + }, + { + "id": "7", + "type": "paragraph", + "content": "CrĂ©ez un nouveau projet en utilisant notre CLI :" + }, + { + "id": "8", "type": "code", - "content": "bash\ngit clone https://github.com/tu-org/plantilla-docs-akira\ncd plantilla-docs-akira\nnpm install\nnpm run dev", + "content": "npx create-akiradocs@latest mi-documentos", "metadata": { - "language": "plaintext", + "language": "bash", "showLineNumbers": true } }, { - "id": "3", + "id": "9", + "type": "heading", + "content": "Voici la traduction en français, avec le formatage d'origine conservĂ© :\n\nÉtapes de configuration de base", + "metadata": { + "level": 2 + } + }, + { + "id": "10", "type": "paragraph", - "content": "" + "content": "1. Cloner le dĂ©pĂŽt (si Quick Deploy n'est pas utilisĂ©)" }, { - "id": "4", - "type": "callout", - "content": "Assurez-vous d'avoir Node.js 16 ou une version supĂ©rieure installĂ©e sur votre systĂšme.", + "id": "11", + "type": "code", + "content": "git cloner https://github.com/your-org/akira-docs-template\ncd akira-docs-template", "metadata": { - "type": "warning", - "title": "Prerequisites" + "language": "bash", + "showLineNumbers": true } }, { - "id": "5", + "id": "12", "type": "paragraph", - "content": "" + "content": "2. Installer les dĂ©pendances" + }, + { + "id": "13", + "type": "code", + "content": "npm install\n# ou\nyarn install", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "14", + "type": "paragraph", + "content": "3. DĂ©marrer le serveur de dĂ©veloppement" + }, + { + "id": "15", + "type": "code", + "content": "npm run dev\n# ou\nyarn dev", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "16", + "type": "paragraph", + "content": "4. Ouvrez `http://localhost:3000` dans votre navigateur" + }, + { + "id": "17", + "type": "heading", + "content": "Voici la traduction en français :\n\nConfiguration initiale", + "metadata": { + "level": 2 + } + }, + { + "id": "18", + "type": "paragraph", + "content": "1. Mettre Ă  jour la configuration du site\nÉditez `akiradocs.config.json` :" + }, + { + "id": "19", + "type": "code", + "content": "{\n \"site\": {\n \"title\": \"Vos Documents\",\n \"description\": \"La description de votre documentation\"\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + }, + { + "id": "20", + "type": "paragraph", + "content": "2. Configurer la traduction (Facultatif)" + }, + { + "id": "21", + "type": "code", + "content": "{\n \"traduction\": {\n \"auto_traduire\": true,\n \"fournisseur\": \"anthropic\",\n \"languesCibles\": [\"es\", \"fr\", \"de\"]\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } } ] } \ No newline at end of file diff --git a/docs/compiled/fr/docs/getting-started/requirements.json b/docs/compiled/fr/docs/getting-started/requirements.json new file mode 100644 index 0000000..67202a3 --- /dev/null +++ b/docs/compiled/fr/docs/getting-started/requirements.json @@ -0,0 +1,179 @@ +{ + "title": "Voici la traduction en français, avec le formatage d'origine conservĂ© :\n\nConfiguration Requise", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Getting Started", + "keywords": [ + "Akira Docs", + "Documentation", + "AI" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Avant d'installer AkiraDocs, assurez-vous que votre environnement rĂ©pond aux exigences suivantes." + }, + { + "id": "2", + "type": "heading", + "content": "Voici la traduction en français, avec le formatage d'origine conservĂ© :\n\nConfiguration minimale requise", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "Node.js\n\nNode.js", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "list", + "content": [ + "Voici la traduction en français :\n\nVersion : 16.x ou supĂ©rieure", + "RecommandĂ© : DerniĂšre version LTS" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "5", + "type": "heading", + "content": "Voici la traduction en français :\n\nMĂ©moire du systĂšme", + "metadata": { + "level": 3 + } + }, + { + "id": "6", + "type": "list", + "content": [ + "Voici la traduction en français :\n\nRAM minimale : 2 Go", + "RecommandĂ© : 4 Go de RAM ou plus" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "7", + "type": "heading", + "content": "Stockage", + "metadata": { + "level": 3 + } + }, + { + "id": "8", + "type": "list", + "content": [ + "RecommandĂ© : 1 Go d'espace libre" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "9", + "type": "heading", + "content": "DĂ©pendances logicielles", + "metadata": { + "level": 2 + } + }, + { + "id": "10", + "type": "heading", + "content": "Voici la traduction en français :\n\nRequis", + "metadata": { + "level": 3 + } + }, + { + "id": "11", + "type": "list", + "content": [ + "Git (la derniĂšre version est recommandĂ©e)", + "gestionnaire de paquets npm ou yarn", + "Navigateur web moderne (Chrome, Firefox, Safari, Edge)" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "12", + "type": "heading", + "content": "Facultatif", + "metadata": { + "level": 3 + } + }, + { + "id": "13", + "type": "list", + "content": [ + "Docker (pour le dĂ©ploiement containerisĂ©)", + "PostgreSQL (pour les fonctionnalitĂ©s d'entreprise)" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "14", + "type": "heading", + "content": "Environnement de dĂ©veloppement", + "metadata": { + "level": 2 + } + }, + { + "id": "15", + "type": "heading", + "content": "SystĂšmes d'exploitation compatibles", + "metadata": { + "level": 3 + } + }, + { + "id": "16", + "type": "list", + "content": [ + "macOS (10.15 ou version ultĂ©rieure)", + "Voici la traduction en français, avec le formatage d'origine conservĂ© :\n\nWindows 10/11\n\nWindows 10/11", + "Linux (Ubuntu 20.04 ou version ultĂ©rieure recommandĂ©e)" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "17", + "type": "heading", + "content": "Prise en charge des IDE/Ă©diteurs", + "metadata": { + "level": 3 + } + }, + { + "id": "18", + "type": "list", + "content": [ + "VS Code (bientĂŽt)", + "WebStorm (bientĂŽt)", + "Tout Ă©diteur de texte prenant en charge Markdown" + ], + "metadata": { + "listType": "unordered" + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/fr/docs/guides/analytics.json b/docs/compiled/fr/docs/guides/analytics.json new file mode 100644 index 0000000..b66fce0 --- /dev/null +++ b/docs/compiled/fr/docs/guides/analytics.json @@ -0,0 +1,113 @@ +{ + "title": "IntĂ©gration des analyses", + "description": "Apprenez Ă  ajouter un suivi analytique Ă  votre documentation", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Guides", + "keywords": [ + "Akira Docs", + "Analytics", + "Google Analytics" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "AkiraDocs est compatible avec Google Analytics 4 (GA4) par dĂ©faut. Ce guide vous aidera Ă  configurer le suivi analytique pour votre documentation." + }, + { + "id": "2", + "type": "heading", + "content": "Configurer Google Analytics", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "paragraph", + "content": "1. CrĂ©ez une propriĂ©tĂ© Google Analytics 4 dans votre [compte Google Analytics](https://analytics.google.com/)\n2. Obtenez votre ID de mesure (commençant par \"G-\")\n3. Ajoutez l'ID Ă  votre `akiradocs.config.json` :" + }, + { + "id": "4", + "type": "code", + "content": "{\n\"analytique\": {\n\"google\": {\n\"idDeMesure\": \"G-XXXXXXXXXX\",\n\"activĂ©\": true\n},\n\"dĂ©bogage\": false\n}\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + }, + { + "id": "5", + "type": "heading", + "content": "Voici la traduction en français :\n\nQue suit-on automatiquement ?", + "metadata": { + "level": 2 + } + }, + { + "id": "6", + "type": "list", + "content": [ + "Vues de page", + "Voici la traduction en français :\n\nNavigation entre les pages", + "Temps sur la page", + "PrĂ©fĂ©rences de langue de l'utilisateur", + "Informations sur l'appareil et le navigateur" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "7", + "type": "heading", + "content": "Suivi des Ă©vĂ©nements personnalisĂ©s", + "metadata": { + "level": 2 + } + }, + { + "id": "8", + "type": "paragraph", + "content": "Voici la traduction en français :\n\nVous pouvez suivre des Ă©vĂ©nements personnalisĂ©s Ă  l'aide du hook `useAnalytics` :" + }, + { + "id": "9", + "type": "code", + "content": "importer { useAnalytics } from '@/hooks/useAnalytics'\nfonction MyComponent() {\n const { track } = useAnalytics()\n const handleClick = () => {\n track('doc_rating', {\n rating: 5,\n page: 'getting-started',\n helpful: true\n })\n }\n return \n}", + "metadata": { + "language": "typescript", + "showLineNumbers": true + } + }, + { + "id": "10", + "type": "heading", + "content": "Voici la traduction en français :\n\nMode dĂ©bogage", + "metadata": { + "level": 2 + } + }, + { + "id": "11", + "type": "paragraph", + "content": "Activez le mode dĂ©bogage pour voir les Ă©vĂ©nements d'analyse dans la console pendant le dĂ©veloppement :" + }, + { + "id": "12", + "type": "code", + "content": "{\n\"analytique\": {\n\"dĂ©boguer\": vrai\n}\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + }, + { + "id": "13", + "type": "paragraph", + "content": "Cela fournit une intĂ©gration analytique complĂšte qui est facile Ă  configurer et Ă  Ă©tendre pour les utilisateurs selon les besoins." + } + ] +} \ No newline at end of file diff --git a/docs/compiled/fr/docs/installation/configuration.json b/docs/compiled/fr/docs/installation/configuration.json new file mode 100644 index 0000000..f214838 --- /dev/null +++ b/docs/compiled/fr/docs/installation/configuration.json @@ -0,0 +1,92 @@ +{ + "title": "Voici la traduction en français, avec le formatage d'origine conservĂ© :\n\nGuide de configuration", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Installation", + "keywords": [ + "Configuration", + "Settings", + "Setup" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Voici la traduction en français :\n\nGuide complet pour configurer votre installation d'AkiraDocs." + }, + { + "id": "2", + "type": "heading", + "content": "Voici la traduction en français :\n\nConfiguration principale", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "Voici la traduction en français :\n\nConfiguration du site", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "paragraph", + "content": "Modifiez `akiradocs.config.json` :" + }, + { + "id": "5", + "type": "code", + "content": "{\n \"url\": \"https://docs.akiradocs.com\",\n \"site\": {\n \"title\": \"Vos Documents\",\n \"description\": \"Description de votre documentation\"\n },\n \"branding\": {\n \"logo\": {\n \"path\": \"/your_logo.svg\",\n \"width\": 120,\n \"height\": 30,\n \"show\": true\n },\n \"favicon\": {\n \"path\": \"/favicon.png\",\n \"show\": true\n }\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + }, + { + "id": "6", + "type": "heading", + "content": "Voici la traduction en français :\n\nConfiguration de la navigation", + "metadata": { + "level": 3 + } + }, + { + "id": "7", + "type": "code", + "content": "{\n \"navigation\": {\n \"en-tĂȘte\": {\n \"Ă©lĂ©ments\": [\n { \"Ă©tiquette\": \"Documents\", \"href\": \"/docs\", \"icĂŽne\": \"/docs.svg\" },\n { \"Ă©tiquette\": \"API\", \"href\": \"/api\", \"icĂŽne\": \"/api.svg\" }\n ]\n }\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + }, + { + "id": "8", + "type": "heading", + "content": "Voici la traduction en français :\n\nInternationalisation", + "metadata": { + "level": 2 + } + }, + { + "id": "9", + "type": "heading", + "content": "ParamĂštres de langue", + "metadata": { + "level": 3 + } + }, + { + "id": "10", + "type": "code", + "content": "{\n \"localization\": {\n \"defaultLocale\": \"en\",\n \"fallbackLocale\": \"en\",\n \"locales\": [\n {\n \"code\": \"en\",\n \"name\": \"Anglais\",\n \"flag\": \"đŸ‡ș🇾\"\n },\n {\n \"code\": \"es\",\n \"name\": \"Espagnol\",\n \"flag\": \"đŸ‡Ș🇾\"\n },\n {\n \"code\": \"fr\",\n \"name\": \"Français\",\n \"flag\": \"đŸ‡«đŸ‡·\"\n },\n {\n \"code\": \"de\",\n \"name\": \"Allemand\",\n \"flag\": \"đŸ‡©đŸ‡Ș\"\n }\n ]\n },\n \"translation\": {\n \"auto_translate\": true,\n \"provider\": \"anthropic\",\n \"model\": \"claude-3-sonnet-20240229\",\n \"targetLanguages\": [\"es\", \"fr\", \"de\"],\n \"excludedPaths\": [\"_meta.json\"]\n },\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/fr/docs/installation/setup.json b/docs/compiled/fr/docs/installation/setup.json new file mode 100644 index 0000000..e035801 --- /dev/null +++ b/docs/compiled/fr/docs/installation/setup.json @@ -0,0 +1,261 @@ +{ + "title": "Guide d'installation dĂ©taillĂ©", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Installation", + "keywords": [ + "Installation", + "Setup", + "Deployment" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Voici la traduction en français :\n\nGuide complet pour installer AkiraDocs dans diffĂ©rents environnements." + }, + { + "id": "2", + "type": "heading", + "content": "Voici la traduction en français, avec le formatage d'origine conservĂ© :\n\nPrĂ©requis", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "paragraph", + "content": "Assurez-vous que votre systĂšme rĂ©pond aux [exigences](../getting-started/requirements.md) avant de continuer." + }, + { + "id": "4", + "type": "heading", + "content": "Voici la traduction en français :\n\nMĂ©thodes d'installation", + "metadata": { + "level": 2 + } + }, + { + "id": "5", + "type": "heading", + "content": "1. Configuration du dĂ©veloppement local", + "metadata": { + "level": 3 + } + }, + { + "id": "6", + "type": "paragraph", + "content": "1. CrĂ©er un nouveau projet" + }, + { + "id": "7", + "type": "code", + "content": "npx create-akiradocs@latest mon-site-de-documentation\ncd mon-site-de-documentation", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "8", + "type": "paragraph", + "content": "2. Installer les dĂ©pendances\nLes dĂ©pendances sont installĂ©es automatiquement lors de la crĂ©ation du projet. Si vous avez besoin de les rĂ©installer :" + }, + { + "id": "9", + "type": "code", + "content": "npm installer", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "10", + "type": "paragraph", + "content": "3. CrĂ©er un fichier d'environnement\nLe fichier d'environnement est crĂ©Ă© automatiquement. Vous pouvez le modifier dans `.env.local`" + }, + { + "id": "11", + "type": "paragraph", + "content": "4. DĂ©marrer le serveur de dĂ©veloppement" + }, + { + "id": "12", + "type": "code", + "content": "npm exĂ©cuter dev", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "13", + "type": "paragraph", + "content": "5. Mettre Ă  jour AkiraDocs\nPour mettre Ă  jour une installation existante vers la derniĂšre version :" + }, + { + "id": "14", + "type": "code", + "content": "npx create-akiradocs@latest mettre Ă  jour", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "15", + "type": "heading", + "content": "3. DĂ©ploiement sur la Plateforme dans le Cloud", + "metadata": { + "level": 3 + } + }, + { + "id": "16", + "type": "heading", + "content": "Voici la traduction en français :\n\nVercel", + "metadata": { + "level": 4 + } + }, + { + "id": "17", + "type": "paragraph", + "content": "1. Bifurquer le dĂ©pĂŽt\n2. Se connecter Ă  Vercel\n3. Configurer les variables d'environnement\n4. DĂ©ployer" + }, + { + "id": "18", + "type": "heading", + "content": "Autres plateformes", + "metadata": { + "level": 4 + } + }, + { + "id": "19", + "type": "list", + "content": [ + "AWS Amplify (BientĂŽt disponible)", + "Netlify (Prochainement)", + "Voici la traduction en français :\n\nDigital Ocean (Prochainement)", + "Serveur personnalisĂ© (BientĂŽt disponible)" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "20", + "type": "heading", + "content": "Étapes suivant l'installation", + "metadata": { + "level": 2 + } + }, + { + "id": "21", + "type": "paragraph", + "content": "1. VĂ©rifier l'installation" + }, + { + "id": "22", + "type": "code", + "content": "npm exĂ©cuter build\nnpm exĂ©cuter start", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "23", + "type": "paragraph", + "content": "2. Configurer l'intĂ©gration de Git" + }, + { + "id": "24", + "type": "code", + "content": "git remote add origin ton-dĂ©pĂŽt-url", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "25", + "type": "paragraph", + "content": "3. Configurer le rĂ©pertoire de contenu" + }, + { + "id": "26", + "type": "code", + "content": "mkdir -p docs/_contenus/fr", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "27", + "type": "heading", + "content": "Voici la traduction en français :\n\nConfigurations spĂ©cifiques Ă  l'environnement", + "metadata": { + "level": 2 + } + }, + { + "id": "28", + "type": "heading", + "content": "DĂ©veloppement", + "metadata": { + "level": 3 + } + }, + { + "id": "29", + "type": "code", + "content": "NODE_ENV=dĂ©veloppement\nDEBUG=vrai", + "metadata": { + "language": "env", + "showLineNumbers": true + } + }, + { + "id": "30", + "type": "heading", + "content": "Voici la traduction en français tout en conservant la mise en forme d'origine :\n\nProduction", + "metadata": { + "level": 3 + } + }, + { + "id": "31", + "type": "code", + "content": "NODE_ENV=production\nDEBUG=faux", + "metadata": { + "language": "env", + "showLineNumbers": true + } + }, + { + "id": "32", + "type": "heading", + "content": "Voici la traduction en français :\n\nTest", + "metadata": { + "level": 3 + } + }, + { + "id": "33", + "type": "code", + "content": "NODE_ENV=test\nTEST_MODE=vrai", + "metadata": { + "language": "env", + "showLineNumbers": true + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/fr/docs/installation/troubleshooting.json b/docs/compiled/fr/docs/installation/troubleshooting.json new file mode 100644 index 0000000..51dfec6 --- /dev/null +++ b/docs/compiled/fr/docs/installation/troubleshooting.json @@ -0,0 +1,314 @@ +{ + "title": "Voici la traduction en français, en conservant la mise en forme d'origine :\n\nGuide de dĂ©pannage", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Installation", + "keywords": [ + "Troubleshooting", + "Issues", + "Solutions" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Voici la traduction en français :\n\nProblĂšmes courants et leurs solutions lors de la configuration d'AkiraDocs." + }, + { + "id": "2", + "type": "heading", + "content": "Voici la traduction en français, avec le formatage d'origine conservĂ© :\n\nProblĂšmes d'installation courants", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "Discordance de version de Node.js", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "paragraph", + "content": "ProblĂšme : Erreur concernant la compatibilitĂ© de la version de Node.js" + }, + { + "id": "5", + "type": "code", + "content": "Erreur : Le moteur \"node\" est incompatible avec ce module", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "6", + "type": "paragraph", + "content": "Solution :\n1. VĂ©rifiez votre version de Node.js :" + }, + { + "id": "7", + "type": "code", + "content": "nƓud --version", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "8", + "type": "paragraph", + "content": "2. Installez la bonne version (16.x ou supĂ©rieure)\n3. Utilisez nvm pour gĂ©rer les versions de Node.js :" + }, + { + "id": "9", + "type": "code", + "content": "installer nvm 20\nutiliser nvm 20", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "10", + "type": "heading", + "content": "Échec de l'installation des dĂ©pendances", + "metadata": { + "level": 3 + } + }, + { + "id": "11", + "type": "paragraph", + "content": "ProblĂšme : npm install Ă©choue avec des erreurs" + }, + { + "id": "12", + "type": "paragraph", + "content": "Solution :\n1. Nettoyer le cache de npm :" + }, + { + "id": "13", + "type": "code", + "content": "Voici la traduction en français :\n\nnpm cache clean --force", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "14", + "type": "paragraph", + "content": "2. Supprimer node_modules et package-lock.json :" + }, + { + "id": "15", + "type": "code", + "content": "Supprimer -rf node_modules package-lock.json\nnpm installer", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "16", + "type": "heading", + "content": "ProblĂšmes de compilation", + "metadata": { + "level": 2 + } + }, + { + "id": "17", + "type": "heading", + "content": "Erreurs de compilation", + "metadata": { + "level": 3 + } + }, + { + "id": "18", + "type": "paragraph", + "content": "ProblĂšme : `npm run build` Ă©choue" + }, + { + "id": "19", + "type": "paragraph", + "content": "Solution :\n1. VĂ©rifier les erreurs de TypeScript :" + }, + { + "id": "20", + "type": "code", + "content": "npm exĂ©cuter type-check", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "21", + "type": "paragraph", + "content": "2. VĂ©rifiez que les variables d'environnement sont correctement configurĂ©es\n3. Effacez le cache de next.js :" + }, + { + "id": "22", + "type": "code", + "content": "Supprimer -rĂ©cursif -force .suivant", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "23", + "type": "heading", + "content": "ProblĂšmes d'exportation statique", + "metadata": { + "level": 3 + } + }, + { + "id": "24", + "type": "paragraph", + "content": "ProblĂšme : L'exportation statique Ă©choue avec des routes dynamiques" + }, + { + "id": "25", + "type": "paragraph", + "content": "Solution :\n1. Configurer `next.config.js` :" + }, + { + "id": "26", + "type": "code", + "content": "module.exports = {\n sortie: 'exporter',\n images: {\n sansOptimisation: vrai\n }\n}", + "metadata": { + "language": "js", + "showLineNumbers": true + } + }, + { + "id": "27", + "type": "heading", + "content": "Voici la traduction en français :\n\nProblĂšmes de traduction", + "metadata": { + "level": 2 + } + }, + { + "id": "28", + "type": "heading", + "content": "Traduction d'IA ne fonctionnant pas", + "metadata": { + "level": 3 + } + }, + { + "id": "29", + "type": "paragraph", + "content": "ProblĂšme : La traduction automatique Ă©choue" + }, + { + "id": "30", + "type": "paragraph", + "content": "Solution :\n1. VĂ©rifiez que les clĂ©s d'API sont configurĂ©es correctement\n2. VĂ©rifiez la configuration de traduction :" + }, + { + "id": "31", + "type": "code", + "content": "{\n \"traduction\": {\n \"auto_traduire\": true,\n \"fournisseur\": \"anthropic\",\n \"languesCibles\": [\"es\", \"fr\", \"de\"]\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + }, + { + "id": "32", + "type": "heading", + "content": "ProblĂšmes de contenu", + "metadata": { + "level": 2 + } + }, + { + "id": "33", + "type": "heading", + "content": "Contenu ne se mettant pas Ă  jour", + "metadata": { + "level": 3 + } + }, + { + "id": "34", + "type": "paragraph", + "content": "ProblĂšme : Les modifications apportĂ©es aux fichiers de contenu ne sont pas rĂ©percutĂ©es" + }, + { + "id": "35", + "type": "paragraph", + "content": "Solution :\nLes changements de contenu sont construits au moment de la compilation. Si vous utilisez le serveur de dĂ©veloppement local, vous devez redĂ©marrer le serveur aprĂšs avoir effectuĂ© des modifications.\n1. Videz le cache :" + }, + { + "id": "36", + "type": "code", + "content": "npm exĂ©cuter propre", + "metadata": { + "language": "bash", + "showLineNumbers": true + } + }, + { + "id": "37", + "type": "paragraph", + "content": "2. RedĂ©marrer le serveur de dĂ©veloppement\n3. VĂ©rifier les permissions des fichiers" + }, + { + "id": "38", + "type": "heading", + "content": "Voici la traduction en français :\n\nProblĂšmes de mise en Ɠuvre", + "metadata": { + "level": 2 + } + }, + { + "id": "39", + "type": "heading", + "content": "DĂ©ploiement Vercel ÉchouĂ©", + "metadata": { + "level": 3 + } + }, + { + "id": "40", + "type": "paragraph", + "content": "ProblĂšme : Le dĂ©ploiement sur Vercel Ă©choue" + }, + { + "id": "41", + "type": "paragraph", + "content": "Solution :\n1. VĂ©rifier les journaux de compilation\n2. VĂ©rifier que les variables d'environnement sont configurĂ©es dans le tableau de bord Vercel\n3. S'assurer que toutes les dĂ©pendances sont rĂ©pertoriĂ©es dans package.json" + }, + { + "id": "42", + "type": "heading", + "content": "Obtenir de l'aide", + "metadata": { + "level": 2 + } + }, + { + "id": "43", + "type": "paragraph", + "content": "Voici la traduction en français :\n\nSi vous rencontrez encore des problĂšmes :" + }, + { + "id": "44", + "type": "paragraph", + "content": "1. Consultez nos [GitHub Issues](https://github.com/Cloud-Code-AI/Akiradocs/issues)\n2. Rejoignez notre [CommunautĂ© Discord](https://discord.gg/zvYZukgeH2)\n3. Contactez le [Support](mailto:saurav.panda@akiradocs.ai)" + } + ] +} \ No newline at end of file diff --git a/docs/compiled/fr/docs/internationalization/ai-translation.json b/docs/compiled/fr/docs/internationalization/ai-translation.json new file mode 100644 index 0000000..4e140b0 --- /dev/null +++ b/docs/compiled/fr/docs/internationalization/ai-translation.json @@ -0,0 +1,91 @@ +{ + "title": "Voici la traduction en français, avec le formatage d'origine conservĂ© :\n\nTraduction alimentĂ©e par l'IA", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Internationalization", + "keywords": [ + "AI Translation", + "Automation", + "Language Processing" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Voici la traduction en français :\n\nGuide pour utiliser les capacitĂ©s de traduction d'IA d'AkiraDocs." + }, + { + "id": "2", + "type": "heading", + "content": "Voici la traduction en français :\n\nConfiguration", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "Voici la traduction en français :\n\nConfiguration", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "code", + "content": "{\n \"traduction\": {\n \"auto_traduire\": true,\n \"fournisseur\": \"anthropic\",\n \"modĂšle\": \"claude-3-sonnet-20240229\",\n \"languesCibles\": [\"es\", \"fr\", \"de\"],\n \"cheminsExclus\": [\"_meta.json\"]\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + }, + { + "id": "5", + "type": "heading", + "content": "Voici la traduction en français :\n\nConfiguration de l'API", + "metadata": { + "level": 3 + } + }, + { + "id": "6", + "type": "code", + "content": "ANTHROPIC_API_KEY=ta_clĂ©_api", + "metadata": { + "language": "env", + "showLineNumbers": true + } + }, + { + "id": "7", + "type": "heading", + "content": "CaractĂ©ristiques", + "metadata": { + "level": 2 + } + }, + { + "id": "8", + "type": "heading", + "content": "Traduction automatique", + "metadata": { + "level": 3 + } + }, + { + "id": "9", + "type": "list", + "content": [ + "Traduction du contenu lors de la compilation", + "Traductions conscientes du contexte", + "Voici la traduction en français tout en conservant le formatage d'origine :\n\nPrĂ©servation des termes techniques", + "Voici la traduction en français tout en conservant le formatage d'origine :\n\nMaintien de la mise en forme" + ], + "metadata": { + "listType": "unordered" + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/fr/docs/internationalization/managing-translation.json b/docs/compiled/fr/docs/internationalization/managing-translation.json new file mode 100644 index 0000000..105f91c --- /dev/null +++ b/docs/compiled/fr/docs/internationalization/managing-translation.json @@ -0,0 +1,120 @@ +{ + "title": "Voici la traduction en français :\n\nGestion des traductions", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Internationalization", + "keywords": [ + "Translation Management", + "Content Localization", + "Workflow" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Apprenez Ă  gĂ©rer et Ă  maintenir efficacement le contenu traduit dans AkiraDocs." + }, + { + "id": "2", + "type": "heading", + "content": "Voici la traduction en français :\n\nFlux de travail de traduction", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "Traduction automatique", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "paragraph", + "content": "1. CrĂ©er du contenu dans la langue source\n2. Activer la traduction automatique dans les paramĂštres\n3. Construire/dĂ©ployer pour gĂ©nĂ©rer des traductions\n4. RĂ©viser et affiner les traductions" + }, + { + "id": "5", + "type": "heading", + "content": "Traduction manuelle", + "metadata": { + "level": 3 + } + }, + { + "id": "6", + "type": "paragraph", + "content": "1. CrĂ©er des rĂ©pertoires spĂ©cifiques pour chaque langue\n2. Copier le contenu source\n3. Traduire manuellement\n4. Mettre Ă  jour les mĂ©tadonnĂ©es" + }, + { + "id": "7", + "type": "heading", + "content": "Voici la traduction en français :\n\nOrganisation du contenu", + "metadata": { + "level": 2 + } + }, + { + "id": "8", + "type": "heading", + "content": "Voici la traduction en français :\n\nStructure des fichiers", + "metadata": { + "level": 3 + } + }, + { + "id": "9", + "type": "code", + "content": "_contenu/\n├── en/\n│ └── docs/\n│ ├── intro.md\n│ └── guide.md\n├── es/\n│ └── docs/\n│ ├── intro.md\n│ └── guide.md\n└── fr/\n └── docs/\n ├── intro.md\n └── guide.md", + "metadata": { + "language": "plaintext", + "showLineNumbers": true + } + }, + { + "id": "10", + "type": "heading", + "content": "ContrĂŽle de QualitĂ©", + "metadata": { + "level": 2 + } + }, + { + "id": "11", + "type": "heading", + "content": "Voici la traduction en français :\n\nProcessus de rĂ©vision", + "metadata": { + "level": 3 + } + }, + { + "id": "12", + "type": "paragraph", + "content": "1. Traduction par IA\n2. RĂ©vision humaine\n3. VĂ©rification technique\n4. Publication" + }, + { + "id": "13", + "type": "heading", + "content": "ContrĂŽle de version", + "metadata": { + "level": 3 + } + }, + { + "id": "14", + "type": "list", + "content": [ + "Suivre les changements dans plusieurs langues", + "Voici la traduction en français :\n\nRester synchronisĂ©", + "GĂ©rer les mises Ă  jour de maniĂšre efficace" + ], + "metadata": { + "listType": "unordered" + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/fr/docs/internationalization/setup.json b/docs/compiled/fr/docs/internationalization/setup.json new file mode 100644 index 0000000..a23c8e9 --- /dev/null +++ b/docs/compiled/fr/docs/internationalization/setup.json @@ -0,0 +1,116 @@ +{ + "title": "Configurer l'internationalisation", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "Internationalization", + "keywords": [ + "i18n", + "Setup", + "Languages" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Configurez AkiraDocs pour plusieurs langues avec prise en charge de la traduction alimentĂ©e par l'IA." + }, + { + "id": "2", + "type": "heading", + "content": "Voici la traduction en français :\n\nConfiguration rapide", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "Voici la traduction en français :\n\nConfiguration de base", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "paragraph", + "content": "Ajoutez la configuration de la langue Ă  `akiradocs.config.json` :" + }, + { + "id": "5", + "type": "code", + "content": "{\n \"localization\": {\n \"defaultLocale\": \"en\",\n \"fallbackLocale\": \"en\",\n \"locales\": [\n {\n \"code\": \"en\",\n \"name\": \"Anglais\",\n \"flag\": \"ïżœđŸ‡ž\"\n },\n {\n \"code\": \"es\",\n \"name\": \"Espagnol\",\n \"flag\": \"đŸ‡Ș🇾\"\n },\n {\n \"code\": \"fr\",\n \"name\": \"Français\",\n \"flag\": \"đŸ‡«đŸ‡·\"\n }\n ]\n },\n \"translation\": {\n \"auto_translate\": true,\n \"provider\": \"anthropic\",\n \"targetLanguages\": [\"es\", \"fr\", \"de\"],\n \"excludedPaths\": [\"_meta.json\"]\n }\n}", + "metadata": { + "language": "json", + "showLineNumbers": true + } + }, + { + "id": "6", + "type": "heading", + "content": "Voici la traduction en français :\n\nStructure des rĂ©pertoires", + "metadata": { + "level": 3 + } + }, + { + "id": "7", + "type": "code", + "content": "docs/\n├── _contents/\n│ ├── en/ # Langue source\n│ │ └── docs/\n│ ├── es/ # Traduction en espagnol\n│ │ └── docs/\n│ └── fr/ # Traduction en français\n│ └── docs/", + "metadata": { + "language": "plaintext", + "showLineNumbers": true + } + }, + { + "id": "8", + "type": "heading", + "content": "Voici la traduction en français :\n\nOptions de configuration", + "metadata": { + "level": 2 + } + }, + { + "id": "9", + "type": "heading", + "content": "ParamĂštres de langue", + "metadata": { + "level": 3 + } + }, + { + "id": "10", + "type": "list", + "content": [ + "`defaultLocale`: Langue principale du contenu", + "`fallbackLocale`: Ressource de repli lorsque la traduction est manquante", + "`locales`: ParamĂštres de langue disponibles" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "11", + "type": "heading", + "content": "ParamĂštres de traduction", + "metadata": { + "level": 3 + } + }, + { + "id": "12", + "type": "list", + "content": [ + "`auto_translate`: Activer/dĂ©sactiver la traduction automatique", + "`fournisseur`: fournisseur de traduction d'IA", + "`languesDestination`: Langues vers lesquelles traduire", + "`rutasExcluidas` : Fichiers qui seront ignorĂ©s pendant la traduction" + ], + "metadata": { + "listType": "unordered" + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/fr/docs/introduction.json b/docs/compiled/fr/docs/introduction.json index 90ec809..cdac386 100644 --- a/docs/compiled/fr/docs/introduction.json +++ b/docs/compiled/fr/docs/introduction.json @@ -1,5 +1,5 @@ { - "title": "", + "title": "Introduction Ă  AkiraDocs", "description": "", "author": "Akira Team", "publishDate": "2024-11-10T00:00:00.000Z", @@ -14,12 +14,12 @@ { "id": "1", "type": "paragraph", - "content": "DĂ©couvrez Akira Docs et ses principales fonctionnalitĂ©s\n\nAkira Docs est une plateforme de documentation moderne qui combine la puissance de l'IA avec un systĂšme de contenu intuitif basĂ© sur des blocs. Ce guide vous aidera Ă  comprendre les principaux concepts et fonctionnalitĂ©s." + "content": "AkiraDocs est une plateforme de documentation de nouvelle gĂ©nĂ©ration qui combine la puissance de l'IA avec un systĂšme de gestion de contenu intuitif. Elle est conçue pour transformer votre flux de travail de documentation de jours Ă  minutes." }, { "id": "2", "type": "heading", - "content": "Voici la traduction en français :\n\nCaractĂ©ristiques clĂ©s", + "content": "Voici la traduction en français :\n\nPourquoi AkiraDocs ?", "metadata": { "level": 2 } @@ -27,17 +27,17 @@ { "id": "3", "type": "paragraph", - "content": "" + "content": "Voici la traduction en français, avec le formatage d'origine conservĂ© :\n\nLa documentation est souvent un dĂ©fi pour les Ă©quipes :" }, { "id": "4", "type": "list", "content": [ - "Recherche propulsĂ©e par l'IA", - "Édition de contenu basĂ©e sur des blocs", - "Conception adaptable", - "ThĂšmes personnalisables", - "CompatibilitĂ© avec Markdown" + "Voici la traduction en français :\n\nLes dĂ©veloppeurs veulent continuer Ă  utiliser Markdown et Git", + "Les Ă©quipes de contenu ont besoin d'Ă©diteurs faciles Ă  utiliser", + "Voici la traduction en français :\n\nLes rĂ©dacteurs techniques luttent avec la gestion des versions", + "Voici la traduction en français :\n\nLes gestionnaires de produits sont confrontĂ©s Ă  une documentation obsolĂšte", + "Voici la traduction en français :\n\nLes dirigeants d'entreprise ont besoin de meilleures analyses" ], "metadata": { "listType": "unordered" @@ -46,7 +46,100 @@ { "id": "5", "type": "paragraph", - "content": "" + "content": "AkiraDocs rĂ©sout ces dĂ©fis en fournissant une plateforme unifiĂ©e qui rĂ©unit le flux de travail de tous." + }, + { + "id": "6", + "type": "heading", + "content": "Voici la traduction en français, avec le formatage d'origine conservĂ© :\n\nPrincipaux avantages", + "metadata": { + "level": 2 + } + }, + { + "id": "7", + "type": "list", + "content": [ + "Flux de travail universel : Les dĂ©veloppeurs conservent leur flux de travail Markdown/Git tandis que les Ă©quipes de contenu obtiennent un Ă©diteur WYSIWYG basĂ© sur des blocs", + "PropulsĂ© par l'IA : Mises Ă  jour automatiques du contenu, traductions et optimisations", + "OptimisĂ© pour le SEO : Documentation bien classĂ©e par dĂ©faut", + "Prise en charge multilingue : traductions avec intelligence artificielle et prise en compte du contexte", + "PrĂȘt pour les entreprises : intĂ©gration SSO/SAML, journaux d'audit et options de dĂ©ploiement personnalisĂ©es" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "8", + "type": "heading", + "content": "Pour qui est-ce ?", + "metadata": { + "level": 2 + } + }, + { + "id": "9", + "type": "heading", + "content": "Voici la traduction en français :\n\nDocumentation pour les dĂ©veloppeurs", + "metadata": { + "level": 3 + } + }, + { + "id": "10", + "type": "list", + "content": [ + "Voici la traduction en français :\n\nDocumentation de l'API", + "Voici la traduction en français :\n\nGuides du SDK", + "SpĂ©cifications techniques", + "Voici la traduction en français :\n\nGuides de mise en Ɠuvre" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "11", + "type": "heading", + "content": "Voici la traduction en français :\n\nDocumentation du produit", + "metadata": { + "level": 3 + } + }, + { + "id": "12", + "type": "list", + "content": [ + "Voici la traduction en français :\n\nGuides d'utilisation", + "Voici la traduction en français :\n\nDocumentation des fonctionnalitĂ©s", + "Voici la traduction en français, avec le formatage d'origine conservĂ© :\n\nNotes de version", + "Voici la traduction en français :\n\nQuestions frĂ©quentes" + ], + "metadata": { + "listType": "unordered" + } + }, + { + "id": "13", + "type": "heading", + "content": "Voici la traduction en français :\n\nDocumentation d'entreprise", + "metadata": { + "level": 3 + } + }, + { + "id": "14", + "type": "list", + "content": [ + "Bases de connaissances internes", + "Voici la traduction en français :\n\nDocumentation des processus", + "Voici la traduction en français :\n\nDocumentation de conformitĂ©", + "Voici la traduction en français :\n\nMatĂ©riels de formation" + ], + "metadata": { + "listType": "unordered" + } } ] } \ No newline at end of file diff --git a/docs/compiled/fr/docs/seo-and-performance/robot-txt.json b/docs/compiled/fr/docs/seo-and-performance/robot-txt.json new file mode 100644 index 0000000..746517c --- /dev/null +++ b/docs/compiled/fr/docs/seo-and-performance/robot-txt.json @@ -0,0 +1,45 @@ +{ + "title": "Configuration robots.txt", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "SEO & Performance", + "keywords": [ + "SEO", + "Robots.txt", + "Crawling" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Le fichier robots.txt est gĂ©nĂ©rĂ© automatiquement pendant le processus de compilation et peut ĂȘtre trouvĂ© dans le dossier `public` de votre projet." + }, + { + "id": "2", + "type": "heading", + "content": "Voici la traduction en français :\n\nConfiguration par dĂ©faut", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "heading", + "content": "robots.txt de base\n\nUser-agent: *\nDisallow: /", + "metadata": { + "level": 3 + } + }, + { + "id": "4", + "type": "code", + "content": "Voici la traduction en français, en conservant la mise en forme d'origine :\n\nUser-agent: *\nAllow: /\nSitemap: https://docs.akiradocs.com/sitemap.xml\n\n# Sections privĂ©es\nDisallow: /admin/\nDisallow: /private/", + "metadata": { + "language": "txt", + "showLineNumbers": true + } + } + ] +} \ No newline at end of file diff --git a/docs/compiled/fr/docs/seo-and-performance/sitemap-generation.json b/docs/compiled/fr/docs/seo-and-performance/sitemap-generation.json new file mode 100644 index 0000000..6e2c41b --- /dev/null +++ b/docs/compiled/fr/docs/seo-and-performance/sitemap-generation.json @@ -0,0 +1,58 @@ +{ + "title": "GĂ©nĂ©ration automatique de plan du site", + "description": "", + "author": "Akira Team", + "publishDate": "2024-11-26T00:00:00.000Z", + "modifiedDate": "2024-11-26T00:00:00.000Z", + "category": "SEO & Performance", + "keywords": [ + "SEO", + "Sitemap", + "XML" + ], + "blocks": [ + { + "id": "1", + "type": "paragraph", + "content": "Apprenez comment AkiraDocs gĂ©nĂšre et gĂšre automatiquement le plan de votre documentation." + }, + { + "id": "2", + "type": "heading", + "content": "Voici la traduction en français :\n\nDescription gĂ©nĂ©rale", + "metadata": { + "level": 2 + } + }, + { + "id": "3", + "type": "paragraph", + "content": "AkiraDocs gĂ©nĂšre automatiquement un fichier sitemap.xml pendant le processus de compilation, assurant que les moteurs de recherche peuvent suivre efficacement votre documentation." + }, + { + "id": "4", + "type": "heading", + "content": "Voici la traduction en français :\n\nStructure de la Carte du Site GĂ©nĂ©rĂ©e", + "metadata": { + "level": 2 + } + }, + { + "id": "5", + "type": "heading", + "content": "Sortie d'exemple", + "metadata": { + "level": 3 + } + }, + { + "id": "6", + "type": "code", + "content": "\n\n \n https://yourdocs.com/\n 2024-11-26\n hebdomadaire\n 1.0\n \n \n https://yourdocs.com/docs/getting-started\n 2024-11-26\n hebdomadaire\n 0.8\n \n", + "metadata": { + "language": "xml", + "showLineNumbers": true + } + } + ] +} \ No newline at end of file diff --git a/docs/package-lock.json b/docs/package-lock.json index a5cdb21..0c5b59b 100644 --- a/docs/package-lock.json +++ b/docs/package-lock.json @@ -1,12 +1,12 @@ { "name": "akiradocs", - "version": "1.0.34", + "version": "1.0.1", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "akiradocs", - "version": "1.0.34", + "version": "1.0.1", "dependencies": { "@ai-sdk/anthropic": "^1.0.1", "@dnd-kit/core": "^6.1.0", diff --git a/docs/package.json b/docs/package.json index d4657ff..81e7833 100644 --- a/docs/package.json +++ b/docs/package.json @@ -1,6 +1,6 @@ { "name": "akiradocs", - "version": "1.0.34", + "version": "1.0.37", "private": true, "scripts": { "translate": "npm run compile && node scripts/translate.js", diff --git a/docs/public/context/en_docs.txt b/docs/public/context/en_docs.txt index 8714eb1..0074d0b 100644 --- a/docs/public/context/en_docs.txt +++ b/docs/public/context/en_docs.txt @@ -1,7 +1,40 @@ +[Document: docs/introduction.json] +Title: Introduction to AkiraDocs +AkiraDocs is a next-generation documentation platform that combines the power of AI with an intuitive content management system. It's designed to transform your documentation workflow from days to minutes. +Why AkiraDocs? +Documentation is often a challenge for teams: +Developers want to keep using Markdown and Git +Content teams need user-friendly editors +Technical writers struggle with version management +Product managers deal with out-of-sync documentation +Enterprise leaders need better analytics +AkiraDocs solves these challenges by providing a unified platform that brings everyone's workflow together. +Core Benefits +Universal Workflow: Developers keep their Markdown/Git workflow while content teams get a block-based WYSIWYG editor +AI-Powered: Automatic content updates, translations, and optimizations +SEO-Optimized: Documentation that ranks well by default +Multi-Language Support: AI-powered translations with context awareness +Enterprise-Ready: SSO/SAML integration, audit logs, and custom deployment options +Who Is It For? +Developer Documentation +API documentation +SDK guides +Technical specifications +Implementation guides +Product Documentation +User guides +Feature documentation +Release notes +FAQs +Enterprise Documentation +Internal knowledge bases +Process documentation +Compliance documentation +Training materials +------------- [Document: articles/welcome.json] Title: Welcome to Akira Doc Get started with Akira Docs - Next-gen documentation powered by AI -Welcome to Akira Doc Welcome to Akira Docs, the next-generation documentation platform powered by AI. This template will help you get started with creating your own documentation. Key Features Easy to customize @@ -23,9 +56,8 @@ Item 3 Important: This is an important callout message. ------------- [Document: articles/ai_integration.json] -AI Assistant Integration +Title: AI Assistant Integration Learn how to use Akira's built-in AI assistant for documentation enhancement - Akira's AI Assistant is a powerful tool that helps developers and technical writers create, maintain, and improve documentation through natural language interactions. This guide covers the essential features and best practices for utilizing the AI assistant effectively. Key Features Natural language documentation generation @@ -58,59 +90,11 @@ ai_assistant: Next Steps Explore our [Advanced AI Features](/advanced-ai-features) guide to learn more about specialized use cases and integration possibilities. ------------- -[Document: docs/introduction.json] -Introduction to AkiraDocs -AkiraDocs is a next-generation documentation platform that combines the power of AI with an intuitive content management system. It's designed to transform your documentation workflow from months to minutes. -Why AkiraDocs? -Documentation is often a challenge for teams: -Developers want to keep using Markdown and Git -Content teams need user-friendly editors -Technical writers struggle with version management -Product managers deal with out-of-sync documentation -Enterprise leaders need better analytics -AkiraDocs solves these challenges by providing a unified platform that brings everyone's workflow together. -Core Benefits -**Universal Workflow**: Developers keep their Markdown/Git workflow while content teams get a block-based WYSIWYG editor -**AI-Powered**: Automatic content updates, translations, and optimizations -**SEO-Optimized**: Documentation that ranks well by default -**Multi-Language Support**: AI-powered translations with context awareness -**Enterprise-Ready**: SSO/SAML integration, audit logs, and custom deployment options -Who Is It For? -Developer Documentation -API documentation -SDK guides -Technical specifications -Implementation guides -Product Documentation -User guides -Feature documentation -Release notes -FAQs -Enterprise Documentation -Internal knowledge bases -Process documentation -Compliance documentation -Training materials -Next Steps -Ready to get started? Check out our [Quick Start Guide](./quick-start.md) or explore our [detailed features](./features.md). -------------- [Document: docs/seo-and-performance/sitemap-generation.json] -Automatic Sitemap Generation +Title: Automatic Sitemap Generation Learn how AkiraDocs automatically generates and manages your documentation sitemap. Overview AkiraDocs automatically generates a sitemap.xml file during the build process, ensuring search engines can efficiently crawl your documentation. -Default Configuration -Code example: -{ - "seo": { - "sitemap": { - "enabled": true, - "autoGenerate": true, - "changefreq": "weekly", - "priority": 0.7 - } - } -} Generated Sitemap Structure Example Output Code example: @@ -129,107 +113,80 @@ Code example: 0.8 -Customization Options -Priority Settings -Code example: -{ - "seo": { - "sitemap": { - "priorities": { - "home": 1.0, - "docs": 0.8, - "blog": 0.6, - "other": 0.5 - } - } - } -} -Update Frequency -Code example: -{ - "seo": { - "sitemap": { - "changefreq": { - "home": "daily", - "docs": "weekly", - "blog": "monthly" - } - } - } -} -Best Practices -1. **Regular Updates** -Keep content fresh -Maintain accurate lastmod dates -Remove obsolete URLs -2. **Structure Optimization** -Logical URL hierarchy -Consistent naming -Clear categories -3. **Performance** -Compress large sitemaps -Use sitemap index for large sites -Monitor crawl stats ------------- [Document: docs/seo-and-performance/robot-txt.json] -Robots.txt Configuration -Guide to customizing and managing your robots.txt file in AkiraDocs. +Title: Robots.txt Configuration +The robots.txt file is automatically generated during the build process and can be found in the `public` folder of your project. Default Configuration Basic robots.txt Code example: User-agent: * Allow: / -Sitemap: https://yourdocs.com/sitemap.xml +Sitemap: https://docs.akiradocs.com/sitemap.xml # Private sections Disallow: /admin/ Disallow: /private/ -Customization -Configuration Options +------------- +[Document: docs/internationalization/setup.json] +Title: Setting Up Internationalization +Configure AkiraDocs for multiple languages with AI-powered translation support. +Quick Setup +Basic Configuration +Add language settings to `akiradocs.config.json`: Code example: { - "seo": { - "robots": { - "enabled": true, - "autoGenerate": true, - "custom": { - "disallow": ["/internal/", "/draft/"], - "allow": ["/public/"], - "crawlDelay": 10 + "localization": { + "defaultLocale": "en", + "fallbackLocale": "en", + "locales": [ + { + "code": "en", + "name": "English", + "flag": "ïżœđŸ‡ž" + }, + { + "code": "es", + "name": "Español", + "flag": "đŸ‡Ș🇾" + }, + { + "code": "fr", + "name": "Français", + "flag": "đŸ‡«đŸ‡·" } - } + ] + }, + "translation": { + "auto_translate": true, + "provider": "anthropic", + "targetLanguages": ["es", "fr", "de"], + "excludedPaths": ["_meta.json"] } } -Advanced Rules +Directory Structure Code example: -# Custom crawl rate -User-agent: Googlebot -Crawl-delay: 10 - -# Allow specific bot -User-agent: Bingbot -Allow: /public/ -Disallow: /private/ - -# Block specific bot -User-agent: BadBot -Disallow: / -Best Practices -1. **Access Control** -Block sensitive content -Allow public content -Manage crawl rates -2. **Performance** -Optimize crawl budget -Prevent unnecessary indexing -Monitor bot behavior -3. **Maintenance** -Regular updates -Verify syntax -Test configuration +docs/ +├── _contents/ +│ ├── en/ # Source language +│ │ └── docs/ +│ ├── es/ # Spanish translation +│ │ └── docs/ +│ └── fr/ # French translation +│ └── docs/ +Configuration Options +Language Settings +`defaultLocale`: Primary content language +`fallbackLocale`: Fallback when translation missing +`locales`: Available language configurations +Translation Settings +`auto_translate`: Enable/disable automatic translation +`provider`: AI translation provider +`targetLanguages`: Languages to translate into +`excludedPaths`: Files to skip during translation ------------- [Document: docs/internationalization/managing-translation.json] -Managing Translations +Title: Managing Translations Learn how to effectively manage and maintain translated content in AkiraDocs. Translation Workflow Automatic Translation @@ -258,17 +215,6 @@ _contents/ └── docs/ ├── intro.md └── guide.md -Translation Status Tracking -Code example: -{ - "translationStatus": { - "es": { - "completion": "85%", - "lastUpdated": "2024-11-26", - "pendingFiles": ["advanced/config.md"] - } - } -} Quality Control Review Process 1. AI Translation @@ -281,7 +227,7 @@ Maintain synchronization Handle updates efficiently ------------- [Document: docs/internationalization/ai-translation.json] -AI-Powered Translation +Title: AI-Powered Translation Guide to using AkiraDocs' AI translation capabilities. Setup Configuration @@ -306,14 +252,14 @@ Technical term preservation Format maintenance ------------- [Document: docs/installation/troubleshooting.json] -Troubleshooting Guide +Title: Troubleshooting Guide Common issues and their solutions when setting up AkiraDocs. Common Installation Issues Node.js Version Mismatch -**Problem**: Error about Node.js version compatibility +Problem: Error about Node.js version compatibility Code example: Error: The engine "node" is incompatible with this module -**Solution**: +Solution: 1. Check your Node.js version: Code example: node --version @@ -323,9 +269,8 @@ Code example: nvm install 20 nvm use 20 Dependencies Installation Failed -**Problem**: npm install fails with errors - -**Solution**: +Problem: npm install fails with errors +Solution: 1. Clear npm cache: Code example: npm cache clean --force @@ -335,9 +280,8 @@ rm -rf node_modules package-lock.json npm install Build Issues Build Fails -**Problem**: `npm run build` fails - -**Solution**: +Problem: `npm run build` fails +Solution: 1. Check for TypeScript errors: Code example: npm run type-check @@ -346,9 +290,8 @@ npm run type-check Code example: rm -rf .next Static Export Issues -**Problem**: Static export fails with dynamic routes - -**Solution**: +Problem: Static export fails with dynamic routes +Solution: 1. Configure `next.config.js`: Code example: module.exports = { @@ -359,9 +302,8 @@ module.exports = { } Translation Issues AI Translation Not Working -**Problem**: Automatic translation fails - -**Solution**: +Problem: Automatic translation fails +Solution: 1. Verify API keys are set correctly 2. Check translation configuration: Code example: @@ -374,9 +316,8 @@ Code example: } Content Issues Content Not Updating -**Problem**: Changes to content files not reflecting - -**Solution**: +Problem: Changes to content files not reflecting +Solution: Content changes are built on build time. If you are using the local development server, you need to restart the server after making changes. 1. Clear the cache: Code example: @@ -385,47 +326,41 @@ npm run clean 3. Check file permissions Deployment Issues Vercel Deployment Failed -**Problem**: Deployment to Vercel fails - -**Solution**: +Problem: Deployment to Vercel fails +Solution: 1. Check build logs 2. Verify environment variables are set in Vercel dashboard 3. Ensure all dependencies are listed in package.json Getting Help If you're still experiencing issues: - 1. Check our [GitHub Issues](https://github.com/Cloud-Code-AI/Akiradocs/issues) 2. Join our [Discord Community](https://discord.gg/zvYZukgeH2) 3. Contact [Support](mailto:saurav.panda@akiradocs.ai) ------------- [Document: docs/installation/setup.json] -Detailed Installation Guide +Title: Detailed Installation Guide Complete guide to installing AkiraDocs in different environments. Prerequisites Ensure your system meets the [requirements](../getting-started/requirements.md) before proceeding. Installation Methods 1. Local Development Setup -1. **Clone the Repository** +1. Create New Project Code example: -git clone https://github.com/your-org/akira-docs-template -cd akira-docs-template -2. **Install Dependencies** +npx create-akiradocs@latest my-docs-site +cd my-docs-site +2. Install Dependencies +Dependencies are automatically installed during project creation. If you need to reinstall: Code example: npm install -3. **Create Environment File** -Code example: -cp .env.example .env.local -4. **Configure Environment Variables** -Code example: -NEXT_PUBLIC_API_URL=your_api_url -NEXT_PUBLIC_SITE_URL=your_site_url -2. Docker Installation -1. **Pull the Docker Image** +3. Create Environment File +The environment file is created automatically. You can modify it at `.env.local` +4. Start Development Server Code example: -docker pull akiradocs/akiradocs:latest -2. **Run the Container** +npm run dev +5. Update AkiraDocs +To update an existing installation to the latest version: Code example: -docker run -p 3000:3000 akiradocs/akiradocs:latest +npx create-akiradocs@latest update 3. Cloud Platform Deployment Vercel 1. Fork the repository @@ -433,19 +368,19 @@ Vercel 3. Configure environment variables 4. Deploy Other Platforms -AWS Amplify -Netlify -Digital Ocean -Custom server +AWS Amplify (Coming Soon) +Netlify (Coming Soon) +Digital Ocean (Coming Soon) +Custom server (Coming Soon) Post-Installation Steps -1. **Verify Installation** +1. Verify Installation Code example: npm run build npm run start -2. **Configure Git Integration** +2. Configure Git Integration Code example: git remote add origin your-repository-url -3. **Setup Content Directory** +3. Setup Content Directory Code example: mkdir -p docs/_contents/en Environment-Specific Configurations @@ -461,18 +396,16 @@ Testing Code example: NODE_ENV=test TEST_MODE=true -Next Steps -[Configuration Guide](./configuration.md) -[Troubleshooting](./troubleshooting.md) ------------- [Document: docs/installation/configuration.json] -Configuration Guide +Title: Configuration Guide Complete guide to configuring your AkiraDocs installation. Core Configuration Site Configuration Edit `akiradocs.config.json`: Code example: { + "url": "https://docs.akiradocs.com", "site": { "title": "Your Docs", "description": "Your documentation description" @@ -544,7 +477,6 @@ Code example: [Document: docs/guides/analytics.json] Title: Analytics Integration Learn how to add analytics tracking to your documentation -Analytics Integration AkiraDocs supports Google Analytics 4 (GA4) out of the box. This guide will help you set up analytics tracking for your documentation. Setting up Google Analytics 1. Create a Google Analytics 4 property in your [Google Analytics account](https://analytics.google.com/) @@ -591,155 +523,15 @@ Code example: } This provides a complete analytics integration that's easy for users to set up and extend as needed. ------------- -[Document: docs/getting-started/requirements.json] -System Requirements -Before installing AkiraDocs, ensure your environment meets the following requirements. -Minimum Requirements -Node.js -Version: 16.x or higher -Recommended: Latest LTS version -System Memory -Minimum: 4GB RAM -Recommended: 8GB RAM or more -Storage -Minimum: 1GB free space -Recommended: 5GB+ for larger documentation projects -Software Dependencies -Required -Git (latest version recommended) -npm or yarn package manager -Modern web browser (Chrome, Firefox, Safari, Edge) -Optional -Docker (for containerized deployment) -PostgreSQL (for enterprise features) -Development Environment -Supported Operating Systems -macOS (10.15 or later) -Windows 10/11 -Linux (Ubuntu 20.04 or later recommended) -IDE/Editor Support -VS Code (recommended) -WebStorm -Any text editor with Markdown support -Network Requirements -Cloud Features -Stable internet connection -Access to npm registry -Access to GitHub (for version control) -Enterprise Features -Outbound HTTPS (443) access -WebSocket support -Custom domain (optional) -Browser Support -Desktop Browsers -Chrome (last 2 versions) -Firefox (last 2 versions) -Safari (last 2 versions) -Edge (last 2 versions) -Mobile Browsers -iOS Safari -Android Chrome -Verification -Run the following command to check if your environment is ready: -------------- -[Document: docs/getting-started/quickstart.json] -Title: Quickstart Guide -Quick Start Guide -Get up and running with AkiraDocs in minutes. -Quick Deploy -Option 1: Deploy with Vercel -The fastest way to get started is using Vercel: - -[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2FCloud-Code-AI%2Fakiradocs-template) -Option 2: Using CLI -Create a new project using our CLI: -Code example: -npx create-akiradocs@latest my-docs -Basic Setup Steps -1. **Clone the Repository** (if not using Quick Deploy) -Code example: -git clone https://github.com/your-org/akira-docs-template -cd akira-docs-template -2. **Install Dependencies** -Code example: -npm install -# or -yarn install -3. **Start Development Server** -Code example: -npm run dev -# or -yarn dev -4. Open `http://localhost:3000` in your browser -Initial Configuration -1. **Update Site Configuration** -Edit `akiradocs.config.json`: -Code example: -{ - "site": { - "title": "Your Docs", - "description": "Your documentation description" - } -} -2. **Configure Translation** (Optional) -Code example: -{ - "translation": { - "auto_translate": true, - "provider": "anthropic", - "targetLanguages": ["es", "fr", "de"] - } -} -------------- -[Document: docs/getting-started/features.json] -AkiraDocs Features -A comprehensive overview of AkiraDocs' core features and capabilities. -Content Creation & Management -**Notion-like Editor**: Intuitive block-based interface with real-time preview -**Markdown Support**: Native Markdown and MDX compatibility -**Custom Components**: Create and reuse your own content blocks -Internationalization & Translation -**Multi-Language Support**: Maintain documentation in multiple languages -**AI-Powered Translation**: Automated, context-aware content translation -**Translation Management**: Built-in tools for managing localized content -Search & Discovery -**AI-Powered Search**: Natural language question answering with context awareness -**SEO Optimization**: Automated SEO tools and optimizations -**Smart Indexing**: Real-time search index updates -Build & Performance -**Static Generation**: Optimized build process with asset optimization -**Developer Experience**: Fast refresh and comprehensive debugging tools -**Performance Focus**: Built-in best practices for speed and efficiency -Enterprise Features (Coming Soon) -**Security & Compliance**: SSO, RBAC, and audit logging -**Analytics & Insights**: Usage tracking and documentation metrics -**Team Collaboration**: Enterprise-grade collaboration tools -Migration Support (Coming Soon) -Code example: -# Supported platforms for easy migration -✓ Nextra -✓ GitBook -✓ Docusaurus -✓ ReadTheDocs -Feature Comparison -| Feature | AkiraDocs | Traditional Docs | -|---------|-----------|------------------| -| Notion-like Editor | ✓ | ✗ | -| AI Translation | ✓ | ✗ | -| AI Search | ✓ | ✗ | -| Auto SEO | ✓ | Partial | -| Markdown Support | ✓ | ✓ | -| Build Optimization | ✓ | Varies | -------------- [Document: docs/editor/overview.json] -Editor Overview +Title: Editor Overview AkiraDocs features a modern, Notion-like editor that combines the simplicity of block-based editing with the power of Markdown. Editor Interface Main Components -**Toolbar**: Quick access to formatting options and block types -**Content Area**: Block-based editing space -**Sidebar**: Navigation and document structure -**Command Palette**: Quick commands (Ctrl/Cmd + P) +Toolbar: Quick access to formatting options and block types +Content Area: Block-based editing space +Sidebar: Navigation and document structure +Command Palette: Quick commands (Ctrl/Cmd + P) Block Structure Each content element is a block that can be: Dragged and dropped to reorganize @@ -776,16 +568,16 @@ Dividers Custom components (Coming Soon) ------------- [Document: docs/editor/features.json] -Editor Features +Title: Editor Features Detailed overview of AkiraDocs editor capabilities and features. Block System Text Formatting -**Basic Formatting** +Basic Formatting Bold, italic, underline Strikethrough Highlight Code inline -**Advanced Formatting** +Advanced Formatting Custom colors Multiple fonts Text alignment @@ -825,13 +617,13 @@ Change history Rollback capabilities ------------- [Document: docs/contributing/how-to-contribute.json] -Contributing to AkiraDocs +Title: Contributing to AkiraDocs Guide to contributing to the AkiraDocs open-source project. Getting Started Setup Development Environment Code example: # Clone repository -git clone https://github.com/akiradocs/akiradocs +git clone https://github.com/Cloud-Code-AI/akiradocs cd akiradocs # Install dependencies @@ -893,22 +685,18 @@ Check [Issues](https://github.com/Cloud-Code-AI/akiradocs/issues) Read [Documentation](https://docs.akiradocs.com) ------------- [Document: docs/contributing/code-of-conduct.json] -Code of Conduct +Title: Code of Conduct Our Pledge We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation. - We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community. Our Standards Examples of behavior that contributes to a positive environment: - * Demonstrating empathy and kindness toward other people * Being respectful of differing opinions, viewpoints, and experiences * Giving and gracefully accepting constructive feedback * Accepting responsibility and apologizing to those affected by our mistakes * Focusing on what is best for the overall community - Examples of unacceptable behavior: - * The use of sexualized language or imagery, and sexual attention or advances * Trolling, insulting or derogatory comments, and personal or political attacks * Public or private harassment @@ -921,8 +709,116 @@ Instances of abusive, harassing, or otherwise unacceptable behavior may be repor Attribution This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org), version 2.0, available at https://www.contributor-covenant.org/version/2/0/code_of_conduct.html. ------------- +[Document: docs/getting-started/requirements.json] +Title: System Requirements +Before installing AkiraDocs, ensure your environment meets the following requirements. +Minimum Requirements +Node.js +Version: 16.x or higher +Recommended: Latest LTS version +System Memory +Minimum: 2GB RAM +Recommended: 4GB RAM or more +Storage +Recommended: 1GB free space +Software Dependencies +Required +Git (latest version recommended) +npm or yarn package manager +Modern web browser (Chrome, Firefox, Safari, Edge) +Optional +Docker (for containerized deployment) +PostgreSQL (for enterprise features) +Development Environment +Supported Operating Systems +macOS (10.15 or later) +Windows 10/11 +Linux (Ubuntu 20.04 or later recommended) +IDE/Editor Support +VS Code (coming soon) +WebStorm (coming soon) +Any text editor with Markdown support +------------- +[Document: docs/getting-started/quickstart.json] +Title: Quickstart Guide +Get up and running with AkiraDocs in minutes. +Quick Deploy +Option 1: Deploy with Vercel +The fastest way to get started is using Vercel: +[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2FCloud-Code-AI%2Fakiradocs-template) +Option 2: Using CLI +Create a new project using our CLI: +Code example: +npx create-akiradocs@latest my-docs +Basic Setup Steps +1. Clone the Repository (if not using Quick Deploy) +Code example: +git clone https://github.com/your-org/akira-docs-template +cd akira-docs-template +2. Install Dependencies +Code example: +npm install +# or +yarn install +3. Start Development Server +Code example: +npm run dev +# or +yarn dev +4. Open `http://localhost:3000` in your browser +Initial Configuration +1. Update Site Configuration +Edit `akiradocs.config.json`: +Code example: +{ + "site": { + "title": "Your Docs", + "description": "Your documentation description" + } +} +2. Configure Translation (Optional) +Code example: +{ + "translation": { + "auto_translate": true, + "provider": "anthropic", + "targetLanguages": ["es", "fr", "de"] + } +} +------------- +[Document: docs/getting-started/features.json] +Title: AkiraDocs Features +A comprehensive overview of AkiraDocs' core features and capabilities. +Content Creation & Management +Notion-like Editor: Intuitive block-based interface with real-time preview +Markdown Support: Native Markdown and MDX compatibility +Custom Components: Create and reuse your own content blocks +Internationalization & Translation +Multi-Language Support: Maintain documentation in multiple languages +AI-Powered Translation: Automated, context-aware content translation +Translation Management: Built-in tools for managing localized content +Search & Discovery +AI-Powered Search: Natural language question answering with context awareness +SEO Optimization: Automated SEO tools and optimizations +Smart Indexing: Real-time search index updates +Build & Performance +Static Generation: Optimized build process with asset optimization +Developer Experience: Fast refresh and comprehensive debugging tools +Performance Focus: Built-in best practices for speed and efficiency +Enterprise Features (Coming Soon) +Security & Compliance: SSO, RBAC, and audit logging +Analytics & Insights: Usage tracking and documentation metrics +Team Collaboration: Enterprise-grade collaboration tools +Migration Support (Coming Soon) +Code example: +# Supported platforms for easy migration +✓ Nextra +✓ GitBook +✓ Docusaurus +✓ ReadTheDocs +------------- [Document: docs/content-management/creating-pages.json] -Creating and Organizing Pages +Title: Creating and Organizing Pages Learn how to create, structure, and organize your documentation pages in AkiraDocs. You can create markdown pages or just use the editor UI. Note in _contents folder, you will only see markdown content created by you. If you use Editor UI, the content will be saved in the compiled folder and will be automatically translated to other languages. Page Structure Basic Page Template @@ -984,7 +880,7 @@ Code example: } ------------- [Document: docs/api-reference/usage-guide.json] -API Documentation Guide +Title: API Documentation Guide Learn how to generate comprehensive API documentation using AkiraDocs. Quick Start Upload API Spec diff --git a/docs/scripts/compile.js b/docs/scripts/compile.js index 7b98520..acad923 100644 --- a/docs/scripts/compile.js +++ b/docs/scripts/compile.js @@ -9,6 +9,9 @@ async function convertMarkdownToBlocks(content) { const blocks = []; let currentBlock = []; let blockId = 1; + let skipNextLine = false; + let firstHeadingFound = false; + let title = ''; const lines = content.split('\n'); @@ -17,7 +20,11 @@ async function convertMarkdownToBlocks(content) { for (let i = 0; i < lines.length; i++) { const line = lines[i]; - // Handle list items + if (skipNextLine) { + skipNextLine = false; + continue; + } + if (line.trim().startsWith('-')) { if (currentBlock.length > 0) { blocks.push({ @@ -28,9 +35,9 @@ async function convertMarkdownToBlocks(content) { currentBlock = []; } - listItems.push(line.trim().substring(1).trim()); + const processedLine = line.trim().substring(1).trim().replace(/\*\*(.*?)\*\*/g, '$1'); + listItems.push(processedLine); - // Check if next line is not a list item or if this is the last line if (i === lines.length - 1 || !lines[i + 1].trim().startsWith('-')) { blocks.push({ id: String(blockId++), @@ -45,7 +52,6 @@ async function convertMarkdownToBlocks(content) { continue; } - // If we reach here and have pending list items, add them as a block if (listItems.length > 0) { blocks.push({ id: String(blockId++), @@ -58,7 +64,6 @@ async function convertMarkdownToBlocks(content) { listItems = []; } - // Handle code blocks if (line.startsWith('```')) { if (currentBlock.length > 0) { blocks.push({ @@ -90,8 +95,17 @@ async function convertMarkdownToBlocks(content) { continue; } - // Handle headings if (line.startsWith('#')) { + if (!firstHeadingFound) { + const match = line.match(/^#+\s*(.*)/); + if (match) { + title = match[1].trim(); + firstHeadingFound = true; + skipNextLine = true; + continue; + } + } + if (currentBlock.length > 0) { blocks.push({ id: String(blockId++), @@ -102,7 +116,7 @@ async function convertMarkdownToBlocks(content) { } const match = line.match(/^#+/); - if (!match) continue; // Skip if no match found + if (!match) continue; const level = match[0].length; blocks.push({ @@ -111,10 +125,13 @@ async function convertMarkdownToBlocks(content) { content: line.slice(level).trim(), metadata: { level } }); + + if (level === 1) { + skipNextLine = true; + } continue; } - // Handle callouts with > [!type] syntax if (line.trim().startsWith('> [!')) { if (currentBlock.length > 0) { blocks.push({ @@ -131,13 +148,11 @@ async function convertMarkdownToBlocks(content) { let calloutContent = []; i++; - // Collect content until we hit a line that doesn't start with > while (i < lines.length && lines[i].trim().startsWith('>')) { - // Remove the > prefix and any single leading space calloutContent.push(lines[i].trim().replace(/^>\s?/, '')); i++; } - i--; // Step back one line since we went too far + i--; blocks.push({ id: String(blockId++), @@ -152,12 +167,20 @@ async function convertMarkdownToBlocks(content) { continue; } - // Accumulate regular paragraph content - currentBlock.push(line); + if (line.trim()) { + const processedLine = line.replace(/\*\*(.*?)\*\*/g, '$1'); + currentBlock.push(processedLine); + } else if (currentBlock.length > 0) { + blocks.push({ + id: String(blockId++), + type: 'paragraph', + content: currentBlock.join('\n').trim() + }); + currentBlock = []; + } } - // Add any remaining content as a paragraph - if (currentBlock.length > 0) { + if (currentBlock.length > 0 && currentBlock.some(line => line.trim())) { blocks.push({ id: String(blockId++), type: 'paragraph', @@ -165,7 +188,7 @@ async function convertMarkdownToBlocks(content) { }); } - return blocks; + return { title, blocks }; } @@ -182,13 +205,11 @@ async function updateMetaFile(folderPath, newFile) { const fileName = path.basename(newFile, '.json'); const compiledContent = JSON.parse(await readFile(newFile, 'utf-8')); - // Calculate relative path from compiled directory const relativePath = path.relative( path.join(process.cwd(), 'compiled'), folderPath ); - // Only set title if the entry doesn't exist in meta if (!meta[fileName]) { const humanReadableFileName = fileName .split('_') @@ -199,7 +220,6 @@ async function updateMetaFile(folderPath, newFile) { path: path.join('/', relativePath, fileName) }; } else { - // Update only the path, preserve the existing title meta[fileName].path = path.join('/', relativePath, fileName); } @@ -208,17 +228,16 @@ async function updateMetaFile(folderPath, newFile) { async function compileMarkdownFiles() { try { - // Use path.join for the glob pattern const files = await glob(path.join('_contents', '**', '*.md'), { cwd: process.cwd() }); for (const file of files) { const content = await readFile(file, 'utf-8'); const { data: frontmatter, content: markdownContent } = matter(content); - const blocks = await convertMarkdownToBlocks(markdownContent); + const { title, blocks } = await convertMarkdownToBlocks(markdownContent); const compiledContent = { - title: frontmatter.title || '', + title: frontmatter.title || title || '', description: frontmatter.description || '', author: frontmatter.author || 'Anonymous', publishDate: frontmatter.publishDate || new Date().toISOString().split('T')[0], @@ -228,7 +247,6 @@ async function compileMarkdownFiles() { blocks }; - // Convert the path using path.join const compiledPath = file .replace(path.join('_contents'), path.join('compiled')) .replace('.md', '.json'); @@ -259,7 +277,6 @@ async function createMetaFilesForAllFolders() { const sectionPath = path.join(langPath, section); if (!existsSync(sectionPath)) continue; - // Initialize existingMeta and read existing meta file if it exists let existingMeta = {}; const metaPath = path.join(sectionPath, '_meta.json'); let existingDefaultRoute; @@ -274,7 +291,6 @@ async function createMetaFilesForAllFolders() { ignore: '**/_meta.json' }); - // Create nested meta structure using existing defaultRoute if available const meta = { defaultRoute: existingDefaultRoute || (section === 'docs' ? '/docs/introduction' : '/articles/welcome') }; @@ -285,7 +301,6 @@ async function createMetaFilesForAllFolders() { const content = JSON.parse(await readFile(filePath, 'utf-8')); const dirs = path.dirname(jsonFile).split('/').filter(d => d !== '.'); - // Convert file name to camelCase for the key const fileKey = fileName.replace(/-/g, ' ') .split(' ') .map((word, index) => { @@ -294,7 +309,6 @@ async function createMetaFilesForAllFolders() { }) .join(''); - // Create nested structure let current = meta; if (dirs.length > 0) { @@ -319,7 +333,6 @@ async function createMetaFilesForAllFolders() { } } - // Check if there's an existing entry and preserve its title const existingEntry = findExistingEntry(existingMeta, dirs, fileKey); const title = existingEntry?.title || content.title || fileName.split('_') .map(word => word.charAt(0).toUpperCase() + word.slice(1)) @@ -331,7 +344,6 @@ async function createMetaFilesForAllFolders() { }; } - // Write meta file const metaDataPath = path.join(sectionPath, '_meta.json'); await writeFile(metaDataPath, JSON.stringify(meta, null, 2)); console.log(`Created meta file: ${metaDataPath}`); @@ -343,11 +355,9 @@ async function createMetaFilesForAllFolders() { } } -// Helper function to find existing entry in nested meta structure function findExistingEntry(meta, dirs, fileKey) { let current = meta; - // Navigate through directories for (const dir of dirs) { const dirKey = dir.replace(/-/g, ' ') .split(' ') diff --git a/docs/scripts/generate-sitemap.mjs b/docs/scripts/generate-sitemap.mjs index 926f747..a45ed63 100644 --- a/docs/scripts/generate-sitemap.mjs +++ b/docs/scripts/generate-sitemap.mjs @@ -1,9 +1,16 @@ // Basic sitemap generator example -import { writeFileSync } from 'fs'; +import { writeFileSync, readFileSync } from 'fs'; import { globSync } from 'glob'; import path from 'path'; -const BASE_URL = 'https://your-domain.com'; // Replace with your actual domain +// Read config file +const config = JSON.parse(readFileSync('./akiradocs.config.json', 'utf8')); +let BASE_URL = config.url || ''; + +// Ensure BASE_URL has proper https:// or http:// prefix +if (!BASE_URL.startsWith('http://') && !BASE_URL.startsWith('https://')) { + BASE_URL = `https://${BASE_URL}`; +} const pages = globSync('compiled/**/*.json') .map(file => { diff --git a/docs/src/app/[locale]/[type]/[...slug]/page.tsx b/docs/src/app/[locale]/[type]/[...slug]/page.tsx index 15a5933..0a594c4 100644 --- a/docs/src/app/[locale]/[type]/[...slug]/page.tsx +++ b/docs/src/app/[locale]/[type]/[...slug]/page.tsx @@ -18,6 +18,7 @@ import { MainTitle, SubTitle } from '@/components/blocks/HeadingBlock' import { SEO } from '@/components/layout/SEO' import { NotFound } from '@/components/layout/NotFound' import { TextToSpeech } from '@/components/tts/TextToSpeech' +import { getAkiradocsConfig } from "@/lib/getAkiradocsConfig"; export const runtime = 'edge' @@ -36,7 +37,8 @@ export default function ContentPage({ params }: { params: Promise<{ locale: stri if (!post) { return } - + const akiradocsConfig = getAkiradocsConfig() + const config = getAkiradocsConfig() const headerConfig = getHeaderConfig(); const footerConfig = getFooterConfig(); const navigationItems = getContentNavigation({}, locale, type) @@ -76,7 +78,9 @@ export default function ContentPage({ params }: { params: Promise<{ locale: stri Edit )} - + {akiradocsConfig.features.textToSpeech && ( + + )} {post.title} {post.description} diff --git a/docs/src/components/aiSearch/AIResponse.tsx b/docs/src/components/aiSearch/AIResponse.tsx index e82e88a..ca46310 100644 --- a/docs/src/components/aiSearch/AIResponse.tsx +++ b/docs/src/components/aiSearch/AIResponse.tsx @@ -16,7 +16,6 @@ interface AIResponseProps { } export function AIResponse({ response, sources, onBack }: AIResponseProps) { - console.debug(sources) return (
View all articles → diff --git a/docs/src/components/blocks/ListBlock.tsx b/docs/src/components/blocks/ListBlock.tsx index 1e337d3..dd74009 100644 --- a/docs/src/components/blocks/ListBlock.tsx +++ b/docs/src/components/blocks/ListBlock.tsx @@ -177,6 +177,17 @@ export function List({ styles?.underline && 'underline' ); + // Add the processContent function + const processContent = (text: string) => { + return text.split(/(.*?<\/strong>)/).map((part, index) => { + if (part.startsWith('') && part.endsWith('')) { + const innerText = part.replace(/<\/?strong>/g, ''); + return {innerText}; + } + return part; + }); + }; + if (showEditingView) { return (
{items.map((item, index) => (
  • - {item} + {processContent(item)}
    • ))} diff --git a/docs/src/components/blocks/ParagraphBlock.tsx b/docs/src/components/blocks/ParagraphBlock.tsx index ce6b959..7f69d19 100644 --- a/docs/src/components/blocks/ParagraphBlock.tsx +++ b/docs/src/components/blocks/ParagraphBlock.tsx @@ -64,11 +64,20 @@ export function Paragraph({ ); } - // Non-editing mode remains the same + const processContent = (text: string) => { + return text.split(/(.*?<\/strong>)/).map((part, index) => { + if (part.startsWith('') && part.endsWith('')) { + const innerText = part.replace(/<\/?strong>/g, ''); + return {innerText}; + } + return part; + }); + }; + const content = typeof children === 'string' ? children.split('\n').map((line, i) => ( - {line} + {processContent(line)} {i < children.split('\n').length - 1 &&
    }     )) diff --git a/docs/src/components/editor/AddBlockButton.tsx b/docs/src/components/editor/AddBlockButton.tsx index e333681..b3dba5b 100644 --- a/docs/src/components/editor/AddBlockButton.tsx +++ b/docs/src/components/editor/AddBlockButton.tsx @@ -49,7 +49,6 @@ export const AddBlockButton = forwardRef< HTMLButtonElement, AddBlockButtonProps >(({ onAddBlock, onChangeType, mode, isActive, onOpenChange, type, open }, ref) => { - console.debug(isActive) const [searchTerm, setSearchTerm] = useState('') const searchInputRef = useRef(null) diff --git a/docs/src/components/layout/Footer.tsx b/docs/src/components/layout/Footer.tsx index 29fe03d..9275f89 100644 --- a/docs/src/components/layout/Footer.tsx +++ b/docs/src/components/layout/Footer.tsx @@ -47,10 +47,17 @@ export const Footer: React.FC = ({
    -
    + {/* Company Info - Left */} +
    © {currentYear} {companyName}. All rights reserved. - Made with by the Akiradocs team
    + + {/* Powered by - Center */} +
    + Powered by Akiradocs +
    + + {/* Social Links - Right */}
    {socialLinks.map((link, index) => ( diff --git a/docs/src/components/layout/Navigation.tsx b/docs/src/components/layout/Navigation.tsx index f332314..0d42511 100644 --- a/docs/src/components/layout/Navigation.tsx +++ b/docs/src/components/layout/Navigation.tsx @@ -13,10 +13,10 @@ import { ErrorBoundary } from 'react-error-boundary' import { getApiNavigation } from '@/lib/content'; import { useAnalytics } from '@/hooks/useAnalytics'; const buttonStyles = { - base: "w-full justify-start text-left font-normal rounded-lg transition-colors", - hover: "hover:bg-accent hover:text-accent-foreground", - active: "bg-accent/50 text-accent-foreground font-medium", - state: "data-[state=open]:bg-accent/50", + base: "w-full justify-start text-left font-normal rounded-lg transition-colors px-3 py-2", + hover: "hover:bg-accent/40 hover:text-accent-foreground", + active: "bg-accent text-accent-foreground font-medium", + state: "data-[state=open]:bg-accent/30", } function ErrorFallback({ error }: { error: Error }) { @@ -33,9 +33,9 @@ export function Navigation({ locale, items }: NavigationProps) { return ( -