Welcome to Project Template
This project serves as a template for creating new documentation sites. It’s designed as a starting point when using scripts/create-project.js
to create new projects.
About This Template
This template includes the following features:
- Multi-language support: Content creation in English and Japanese
- Version management: Simultaneous management of multiple versions (can be added as needed)
- Automatic sidebar: Auto-generated navigation based on content structure
- Shared UI components: Unified design system
- Responsive design: Compatible with all devices
Project Structure
src/content/docs/
├── en/ # English documentation
│ └── v1/ # Initial version
│ └── 01-guide/ # Guide section
└── ja/ # Japanese documentation
└── v1/
└── 01-guide/
Creating a New Project
To create a new project from this template:
# Create a new project
node scripts/create-project.js my-docs "My Documentation" "私のドキュメント"
# Create with more detailed options
node scripts/create-project.js api-docs "API Documentation" "API文書" --icon=code --tags=api,reference
Version Management
When you need a new version, use scripts/create-version.js
:
# Add a new version
node scripts/create-version.js my-docs v2
# Add in interactive mode
node scripts/create-version.js my-docs v2 --interactive
Adding Documents
To add individual document files, use scripts/create-document.js
:
# Basic usage
node scripts/create-document.js my-docs en v1 guide "New Guide"
# Interactive mode (recommended)
node scripts/create-document.js my-docs en v1 --interactive
Customization Points
For new projects, customize the following:
- Project configuration: Edit
src/config/project.config.json
- Display names: Update
displayName
anddisplayDescription
for each language - Content: Remove this template content and replace with project-specific content
- Categories: Adjust sidebar categories to match your project
Development Setup Steps
- Delete or update existing template content
- Create project-specific documentation
- Adjust configuration files to match your project
- Test with development server:
pnpm dev
- Test build:
pnpm build
Use this template as the foundation for your new documentation projects.