feat(docs): update mkdocs references
This commit is contained in:
parent
6ee2dab80d
commit
08188ebb10
|
|
@ -8,10 +8,10 @@ This guide covers all configuration options available in Readur through environm
|
|||
|
||||
- [Environment Variables](#environment-variables)
|
||||
- [Core Configuration](#core-configuration)
|
||||
- [File Storage & Upload](#file-storage--upload)
|
||||
- [File Storage & Upload](#file-storage-upload)
|
||||
- [Watch Folder Configuration](#watch-folder-configuration)
|
||||
- [OCR & Processing Settings](#ocr--processing-settings)
|
||||
- [Search & Performance](#search--performance)
|
||||
- [OCR & Processing Settings](#ocr-processing-settings)
|
||||
- [Search & Performance](#search-performance)
|
||||
- [Data Management](#data-management)
|
||||
- [Port Configuration](#port-configuration)
|
||||
- [Example Configurations](#example-configurations)
|
||||
|
|
|
|||
|
|
@ -427,7 +427,7 @@ docker run --read-only --tmpfs /tmp ...
|
|||
|
||||
## Next Steps
|
||||
|
||||
- Configure [monitoring and alerting](monitoring-usage)
|
||||
- Review [security best practices](security)
|
||||
- Configure [monitoring and alerting](health-monitoring-guide.md)
|
||||
- Review [security best practices](security-guide.md)
|
||||
- Set up [automated backups](#backup-strategy)
|
||||
- Explore [database guardrails](dev/DATABASE_GUARDRAILS.md)
|
||||
|
|
@ -90,7 +90,7 @@ Start here if you need to:
|
|||
1. [Set up sources](../sources-guide.md)
|
||||
2. [Configure watch folders](../WATCH_FOLDER.md)
|
||||
3. [Use the API](../api-reference.md)
|
||||
4. [Automate workflows](../api-reference.md#automation-examples)
|
||||
4. [Automate workflows](../api-reference.md#examples)
|
||||
|
||||
## Feature Highlights
|
||||
|
||||
|
|
|
|||
|
|
@ -259,7 +259,7 @@ docker system prune -a
|
|||
For production use:
|
||||
1. [Configure HTTPS](../self-hosting/reverse-proxy.md)
|
||||
2. [Set up backups](../self-hosting/backup.md)
|
||||
3. [Enable monitoring](../administration/monitoring.md)
|
||||
3. [Enable monitoring](../health-monitoring-guide.md)
|
||||
4. [Configure authentication](../self-hosting/authentication.md)
|
||||
|
||||
### Scaling
|
||||
|
|
@ -272,6 +272,6 @@ Handle more documents:
|
|||
## Related Documentation
|
||||
|
||||
- [Self-Hosting Guide](../self-hosting/index.md) - Complete deployment guide
|
||||
- [Docker Compose Reference](../reference/docker-compose.md) - All configuration options
|
||||
- [Configuration Reference](../configuration-reference.md) - All configuration options
|
||||
- [Container Architecture](../architecture.md) - How services interact
|
||||
- [Troubleshooting Guide](../troubleshooting.md) - Common issues and solutions
|
||||
|
|
@ -24,7 +24,7 @@ Direct installation on Linux servers:
|
|||
- **From source**: Build and install manually
|
||||
- **SystemD services**: Managed by system init
|
||||
|
||||
[Bare Metal Installation →](./bare-metal.md)
|
||||
[Bare Metal Installation →](../deployment.md)
|
||||
|
||||
### Cloud Platform Deployment
|
||||
|
||||
|
|
@ -35,7 +35,7 @@ Deploy on managed cloud services:
|
|||
- **Azure**: Virtual Machines, Database, Blob Storage
|
||||
- **DigitalOcean**: Droplets, Managed Database, Spaces
|
||||
|
||||
[Cloud Deployment Guide →](./cloud-deployment.md)
|
||||
[Cloud Deployment Guide →](../deployment.md)
|
||||
|
||||
## System Requirements
|
||||
|
||||
|
|
@ -92,7 +92,7 @@ docker-compose ps
|
|||
curl http://localhost:8000/health
|
||||
```
|
||||
|
||||
[Detailed Docker Guide →](./docker-setup.md)
|
||||
[Detailed Docker Guide →](../quickstart/docker.md)
|
||||
|
||||
### Method 2: Kubernetes (Container Orchestration)
|
||||
|
||||
|
|
@ -121,7 +121,7 @@ spec:
|
|||
- containerPort: 8000
|
||||
```
|
||||
|
||||
[Kubernetes Deployment →](./kubernetes.md)
|
||||
[Kubernetes Deployment →](../deployment.md#kubernetes)
|
||||
|
||||
### Method 3: Ansible Automation
|
||||
|
||||
|
|
@ -139,7 +139,7 @@ Automated deployment across multiple servers:
|
|||
postgres_version: "14"
|
||||
```
|
||||
|
||||
[Ansible Playbook →](./ansible.md)
|
||||
[Ansible Playbook →](../deployment.md)
|
||||
|
||||
## Configuration
|
||||
|
||||
|
|
@ -163,7 +163,7 @@ S3_ACCESS_KEY_ID=<your-key>
|
|||
S3_SECRET_ACCESS_KEY=<your-secret>
|
||||
```
|
||||
|
||||
[Complete Configuration Reference →](./configuration.md)
|
||||
[Complete Configuration Reference →](../configuration-reference.md)
|
||||
|
||||
### Storage Configuration
|
||||
|
||||
|
|
@ -306,7 +306,7 @@ docker-compose exec readur psql -U readur -d readur -c "SELECT COUNT(*) FROM doc
|
|||
- [ ] Regular security updates
|
||||
- [ ] Implement rate limiting
|
||||
|
||||
[Security Best Practices →](./security.md)
|
||||
[Security Best Practices →](../security-guide.md)
|
||||
|
||||
### SSL/TLS Configuration
|
||||
|
||||
|
|
@ -378,7 +378,7 @@ docker-compose exec readur alembic upgrade head
|
|||
docker-compose down && docker-compose up -d
|
||||
```
|
||||
|
||||
[Update Procedures →](./updates.md)
|
||||
[Update Procedures →](../migration-guide.md)
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
|
|
@ -415,7 +415,7 @@ psql $DATABASE_URL -c "SELECT 1"
|
|||
telnet postgres_host 5432
|
||||
```
|
||||
|
||||
[Complete Troubleshooting Guide →](./troubleshooting.md)
|
||||
[Complete Troubleshooting Guide →](../troubleshooting.md)
|
||||
|
||||
## Migration from Other Systems
|
||||
|
||||
|
|
@ -438,7 +438,7 @@ python migrate_mayan.py \
|
|||
--target-db postgresql://readur_db
|
||||
```
|
||||
|
||||
[Migration Guide →](./migration.md)
|
||||
[Migration Guide →](../migration-guide.md)
|
||||
|
||||
## Support and Resources
|
||||
|
||||
|
|
|
|||
|
|
@ -427,7 +427,7 @@ Readur supports both local and OIDC users in the same installation:
|
|||
- [🔌 API Reference](api-reference.md)
|
||||
REST API for automation and integration
|
||||
|
||||
- [🏗️ Developer Documentation](dev/)
|
||||
- [🏗️ Developer Documentation](dev/README.md)
|
||||
Architecture and development setup
|
||||
|
||||
- [🔍 OCR Optimization](dev/OCR_OPTIMIZATION_GUIDE.md)
|
||||
|
|
|
|||
Loading…
Reference in New Issue