Tellsanguis
aba46f671c
- Add language switcher to navbar for bilingual site (FR/EN) - Remove intro page, use presentation as entry point - Add example pages to all documentation categories - Configure categories with generated-index for page listings - Update footer and homepage links to reference presentation - Enhance configuration with best practices: - Add metadata and SEO keywords - Enable RSS/Atom feeds for blog - Configure sitemap generation - Add syntax highlighting for YAML, HCL, Docker - Enable Mermaid diagram support - Configure table of contents settings - Respect user color scheme preferences - Add last update metadata to docs - Fix deprecated onBrokenMarkdownLinks configuration - Create bilingual example pages with practical code examples - Update all i18n translations for consistency This update brings the site in line with Docusaurus 3.x best practices and provides a solid foundation for documentation growth.
60 lines
986 B
Markdown
60 lines
986 B
Markdown
---
|
|
sidebar_position: 2
|
|
---
|
|
|
|
# Example
|
|
|
|
This is an example page in the Current Homelab category.
|
|
|
|
## Description
|
|
|
|
This page demonstrates how to document a service or configuration of the current homelab.
|
|
|
|
## Docker Compose Configuration
|
|
|
|
Example service configuration:
|
|
|
|
```yaml
|
|
version: '3.8'
|
|
|
|
services:
|
|
example-service:
|
|
image: nginx:latest
|
|
container_name: example
|
|
ports:
|
|
- "8080:80"
|
|
volumes:
|
|
- ./config:/etc/nginx/conf.d
|
|
restart: unless-stopped
|
|
```
|
|
|
|
## Ansible Playbook
|
|
|
|
Deployment example with Ansible:
|
|
|
|
```yaml
|
|
---
|
|
- name: Deploy example service
|
|
hosts: homelab
|
|
become: yes
|
|
|
|
tasks:
|
|
- name: Copy docker-compose file
|
|
copy:
|
|
src: docker-compose.yml
|
|
dest: /opt/example/docker-compose.yml
|
|
|
|
- name: Start the service
|
|
command: docker-compose up -d
|
|
args:
|
|
chdir: /opt/example
|
|
```
|
|
|
|
## Maintenance
|
|
|
|
Important maintenance points:
|
|
|
|
- Regular backups
|
|
- Docker image updates
|
|
- Log monitoring
|
|
- Restore testing
|