# Onoxsoft Documentation Site (VitePress)

VitePress-based documentation for Onoxsoft Panel. Turkish default, English stub.

## Local development

```bash
cd docs/
npm install
npm run dev   # http://localhost:5173/docs/
```

## Build

```bash
npm run build
# Output: docs/.vitepress/dist/
```

## Preview production build

```bash
npm run preview
# http://localhost:4173/docs/
```

## Deploy

The built site can be hosted on:
- GitHub Pages
- Cloudflare Pages
- Netlify
- The Onoxsoft Panel server itself (Apache vhost serving `.vitepress/dist/`)

### Apache vhost example

```apache
<VirtualHost *:443>
    ServerName docs.panel.yourdomain.com
    DocumentRoot /srv/panel/docs/.vitepress/dist
    <Directory /srv/panel/docs/.vitepress/dist>
        Options -Indexes
        AllowOverride All
        Require all granted
        FallbackResource /index.html
    </Directory>
</VirtualHost>
```

## Edit Content

All Turkish content is in `docs/tr/`. Edit the relevant `.md` file.
Sidebar navigation is in `docs/.vitepress/config.js`.

## Translate

Add English translations under `docs/en/` mirroring `docs/tr/`.
Update the `en` locale sidebar in `docs/.vitepress/config.js`.

## Custom Component

`ApiEndpointCard` is globally registered and works in any `.md` file:

```markdown
<ApiEndpointCard method="POST" path="/api/v1/accounts" description="Create account" />
```
