Optimized libreoffice role

group_vars/all/07_applications.yml

@@ -235,6 +235,10 @@ defaults_applications:
     css_enabled:                  "{{css_enabled_default}}"                       # Enables\Disables Global CSS Style
     landingpage_iframe_enabled:   "{{landingpage_iframe_enabled_default}}"        # Enables\Disables the possibility to embed this on landing page via iframe
 
+  ## Libre Office
+  libreoffice:
+    flavor:                       "fresh"                                         # Libre Office flavor, fresh for new, still for stable
+
   ## Listmonk
   listmonk:
     users:

roles/pc-libreoffice/README.md

@@ -1,39 +1,24 @@
-# PC-LibreOffice Role
+# LibreOffice for Personal Computers
 
-## Overview
+## Description
-This README is for the `pc-libreoffice` role, part of the `cymais` repository. This role focuses on installing LibreOffice, a powerful and free office suite, along with necessary fonts and language packages.
 
-## Role Contents
+This role installs LibreOffice on Arch Linux systems using the Pacman package manager. In addition, it installs the Liberation fonts (ttf-liberation) and language packs corresponding to your chosen LibreOffice flavor. LibreOffice is a powerful and free office suite that provides a comprehensive set of tools for document processing, spreadsheets, presentations, and more.
-The `main.yml` file under the `pc-libreoffice` role includes tasks for installing LibreOffice and its components:
 
-1. **Install LibreOffice**:
+Learn more about LibreOffice on the [official website](https://www.libreoffice.org).
-   - Uses the `community.general.pacman` module to install:
-     - `ttf-liberation`: A font package that includes Liberation fonts, often used in LibreOffice documents.
-     - `libreoffice-still`: The stable version of the LibreOffice suite.
 
-2. **Install LibreOffice Language Packages**:
+## Purpose
-   - Installs various language packs for LibreOffice, allowing for multi-language support. The languages to be installed are determined by the `{{libreoffice_languages}}` variable.
 
-## Dependencies
+The purpose of this role is to automate the installation and configuration of LibreOffice along with its language support on personal computers. This ensures that users have a consistent and fully functional office suite environment across their systems.
-This role depends on:
-- **hunspell**: Ensures that Hunspell, a spell checker used by LibreOffice for many languages, is installed.
 
-## Purpose and Usage
+## Features
-The `pc-libreoffice` role is ideal for users who need a comprehensive, free office suite for personal or professional use. It's particularly useful for setting up a new system or ensuring that all necessary office software is present and properly configured.
 
-## Prerequisites
+- **Automated Installation:** Installs LibreOffice along with Liberation fonts and additional language packages using Pacman.
-- **Ansible**: Must be installed to use this role.
+- **Customizable Flavor:** Supports installation of different LibreOffice flavors by dynamically setting the package name.
-- **Arch Linux-based System**: The role uses the `pacman` package manager, making it suitable for Arch Linux or similar distributions.
+- **Language Support:** Iterates through a list of desired language packages to ensure comprehensive localization.
+- **Seamless Integration:** Designed to work within a larger system setup environment, integrating with dependencies such as Hunspell for spell checking.
 
-## Running the Role
+## Credits
-To use this role:
-1. Clone the `cymais` repository.
-2. Navigate to the `roles/pc-libreoffice` directory.
-3. Define the `libreoffice_languages` variable with the desired language codes.
-4. Run the role using Ansible, ensuring you have the necessary permissions for software installation.
 
-## Customization
+Developed and maintained by **Kevin Veen-Birkenbach**.  
-You can customize this role by adjusting the `libreoffice_languages` variable to include the language packs you need, or by adding additional LibreOffice-related packages as required.
+Learn more at [www.veen.world](https://www.veen.world)  
-
+License: [CyMaIS NonCommercial License (CNCL)](https://s.veen.world/cncl)
-## Support and Contributions
-For support, feedback, or contributions, such as adding more functionality or enhancing the existing setup, please open an issue or submit a pull request in the `cymais` repository. Contributions that improve the LibreOffice setup and user experience are highly welcomed.

roles/pc-libreoffice/meta/main.yml

@@ -1,2 +1,22 @@
+---
+galaxy_info:
+  author: "Kevin Veen-Birkenbach"
+  description: "Installs LibreOffice along with Liberation fonts and language packages on Arch Linux systems for a complete office suite experience."
+  license: "CyMaIS NonCommercial License (CNCL)"
+  license_url: "https://s.veen.world/cncl"
+  company: |
+    Kevin Veen-Birkenbach
+    Consulting & Coaching Solutions
+    https://www.veen.world
+  min_ansible_version: "2.9"
+  platforms:
+    - name: Archlinux
+      versions:
+        - rolling
+  galaxy_tags:
+    - libreoffice
+    - office-suite
+    - archlinux
+    - automation
 dependencies:
-- hunspell
+  - hunspell

roles/pc-libreoffice/tasks/main.yml

@@ -2,11 +2,11 @@
   community.general.pacman:
     name:
       - ttf-liberation
-      - libreoffice-fresh
+      - "libreoffice-{{ applications.libreoffice.flavor }}"
     state: present
 
 - name: install libreoffice language packages
   community.general.pacman:
-    name: "libreoffice-fresh-{{ item }}"
+    name: "libreoffice-{{ applications.libreoffice.flavor }}-{{ item }}"
     state: present
   loop: "{{libreoffice_languages}}"