An open API service indexing awesome lists of open source software.

https://github.com/projectpotos/ansible-role-potos_libreoffice

Role to Install LibreOffice, fonts and templates.
https://github.com/projectpotos/ansible-role-potos_libreoffice

ansible ansible-role fonts libreoffice potos templates

Last synced: 3 months ago
JSON representation

Role to Install LibreOffice, fonts and templates.

Awesome Lists containing this project

README

        

# Ansible Role - potos_libreoffice

Install and configure LibreOffice.

[![Test](https://github.com/projectpotos/ansible-role-potos_libreoffice/actions/workflows/test.yml/badge.svg)](https://github.com/projectpotos/ansible-role-potos_libreoffice/actions/workflows/test.yml)

## Example Playbook

As this role is tested via Molecule one can use [that playbook](./molecule/default/converge.yml) as a starting point:

```yaml
---

- name: Converge
hosts: all
gather_facts: yes

tasks:
- name: Run role
ansible.builtin.include_role:
name: ansible-role-potos_libreoffice
vars:
potos_libreoffice_templates:
- url: "https://extensions.libreoffice.org/assets/downloads/1011/1677853134/CV-deux-colonnes-sobre-v2.ott"
- name: squares.ott
url: "https://extensions.libreoffice.org/assets/downloads/z/1cm-paper.ott"
destination_directory: sales
- src: templates/free_printable_gift_certificate_template.ott
potos_libreoffice_fonts:
- name: fonts-open-sans
- url: "https://github.com/adobe-fonts/source-sans/raw/release/TTF/SourceSans3-Regular.ttf"
family: source-sans
- src: EA Sports Covers SC 1.5.ttf
family: my_fonts
potos_libreoffice_palettes:
- name: dracula.soc
url: "https://raw.githubusercontent.com/dracula/libreoffice/master/dracula.soc"
- src: palettes/example.soc
```

## Role Variables

The default variables are defined in [defaults/main.yml](./defaults/main.yml):

```yaml
---

# List fonts that you want to install. These include:
# - packages containing the fonts. (`name`)
# - URL that refer to a font file with the tff extension. (`url`)
# - File that refer to a font file with the tff extension. (`src`)
#
# Explanation of items in the list:
# Either specify `name` or specify `url`.
# name: (optional) The name of the package to install
# url: (optional) The URL to the font, a `ttf` file.
# src: (optional) The path to the font, a `ttf` file.
# family: (optional when `url` is specified) A name to store the fonts in.
# potos_libreoffice_fonts:
# - name: adobe-source-sans-pro-fonts
# - url: https://github.com/adobe-fonts/source-sans/blob/release/TTF/SourceSans3-Regular.ttf
# family: source-sans
# - src: EA Sports Covers SC 1.5.ttf
# family: my_fonts
potos_libreoffice_fonts: []

# List of templates that you want to install.
#
# Explanation of items in the list:
# url: (required) The URL to the template.
# name: (optional) The name to call the file.
# destination_directory: (optional) The directory to put the file in. This is relative to the path where LibreOffice expects templates to be.
#
# potos_libreoffice_templates:
# - url: "https://extensions.libreoffice.org/assets/downloads/1011/1677853134/CV-deux-colonnes-sobre-v2.ott"
# - name: squares.ott
# url: "https://extensions.libreoffice.org/assets/downloads/z/1cm-paper.ott"
# destination_directory: sales
potos_libreoffice_templates: []
```

Another option is to use `ansible-doc` to read the argument specification:

```sh
`ansible-doc --type role -r . main ansible-role-potos_libreoffice`
```

## Requirements

N/A

## License

See [LICENSE](./LICENSE)

## Author Information

[Project Potos](https://github.com/projectpotos)