mirror of
https://github.com/kevinveenbirkenbach/computer-playbook.git
synced 2025-08-29 15:06:26 +02:00
Cleaning up of gen roles
This commit is contained in:
26
roles/dev-locales/README.md
Normal file
26
roles/dev-locales/README.md
Normal file
@@ -0,0 +1,26 @@
|
||||
# Locales
|
||||
|
||||
This Ansible role manages the system locale configuration by deploying `locale.gen` and `locale.conf`, then generating the requested locales.
|
||||
|
||||
## Description
|
||||
|
||||
- Copies your `locale.gen` template to `/etc/locale.gen`
|
||||
- Copies your `locale.conf` template to `/etc/locale.conf`
|
||||
- Runs `locale-gen` to generate and activate configured locales
|
||||
|
||||
## Overview
|
||||
|
||||
1. **Template deployment**
|
||||
- `locale.gen`: uncomment or specify the locales you need
|
||||
- `locale.conf`: sets `LANG` and `LANGUAGE` environment variables
|
||||
2. **Locale generation**
|
||||
- Executes the `locale-gen` command (requires privilege escalation)
|
||||
3. **Idempotency**
|
||||
- Templates are only reapplied if changed
|
||||
- `locale-gen` only re-runs when the template changes
|
||||
|
||||
## Features
|
||||
|
||||
* Full control over uncommented locales in `locale.gen`
|
||||
* Simple override via templates in your role directory
|
||||
* Works on any system supporting `locale-gen`
|
Reference in New Issue
Block a user