qusal/salt/fedora-xfce/README.md

# fedora-xfce

Fedora Xfce Template in Qubes OS.

## Table of Contents

*   [Description](#description)
*   [Installation](#installation)
*   [Usage](#usage)

## Description

Creates the Fedora Xfce template as well as a Disposable Template based on it.

## Installation

*   Top:

```sh
sudo qubesctl top.enable fedora-xfce
sudo qubesctl --targets=fedora-40-xfce state.apply
sudo qubesctl top.disable fedora-xfce
```

*   State:

<!-- pkg:begin:post-install -->

```sh
sudo qubesctl state.apply fedora-xfce.create
sudo qubesctl --skip-dom0 --targets=fedora-40-xfce state.apply fedora-xfce.install
```

<!-- pkg:end:post-install -->

## Usage

AppVMs and StandaloneVMs can be based on this template.
feat: build and sign RPM packages Passing files to Dom0 is always dangerous: - Passing a git repository is dangerous as it can have ignored modified files and signature verification will pass. - Passing an archive is troublesome for updates. - Passing an RPM package depends on the RPM verification to be correct, some times it is not. - Passing a RPM repository definition is less troublesome for the user, as it is a small file to verify the contents and update mechanism is via the package manager. Trust in RPM verification is still required. Many improvements were made to the build scripts: - requires-program: Single function to check if program is installed; - spec-get: Sort project names for the usage message; - spec-get: Only running commands that are necessary; - spec-get: Fix empty summary when readme has copyright header; - spec-gen: Fix grep warning of escaped symbol; - spec-build: Sign RPM and verify signature; - spec-build: Only lint the first SPEC for faster runtime; - yumrepo-gen: Generate a local yum repository with signed metadata; - qubesbuilder-gen: Generate a .qubesbuilder based on tracked projects; - release: Build, sign and push all RPMs to repository. Goal is to be able to build with qubes-builderv2 Qubes Executor. For: https://github.com/ben-grande/qusal/issues/37 2024-06-12 08:44:04 -04:00			`# fedora-xfce`
fix: separate template formula per flavor Default template flavor is Gnome, installing Xfce when requesting the template formula without flavor causes confusion. 2024-01-12 11:47:21 -05:00
			`Fedora Xfce Template in Qubes OS.`

			`## Table of Contents`

doc: lint markdown files Only way to have a unified markdown syntax is to enforce the wanted syntax by linting the files. Don't rely on the many markdown syntaxes, be consistent. 2024-07-04 11:10:11 -04:00			`* [Description](#description)`
			`* [Installation](#installation)`
			`* [Usage](#usage)`
fix: separate template formula per flavor Default template flavor is Gnome, installing Xfce when requesting the template formula without flavor causes confusion. 2024-01-12 11:47:21 -05:00
			`## Description`

			`Creates the Fedora Xfce template as well as a Disposable Template based on it.`

			`## Installation`

doc: lint markdown files Only way to have a unified markdown syntax is to enforce the wanted syntax by linting the files. Don't rely on the many markdown syntaxes, be consistent. 2024-07-04 11:10:11 -04:00			`* Top:`

fix: separate template formula per flavor Default template flavor is Gnome, installing Xfce when requesting the template formula without flavor causes confusion. 2024-01-12 11:47:21 -05:00			```sh
doc: prefix qubesctl with sudo Fixes: https://github.com/ben-grande/qusal/issues/20 2024-02-23 10:54:35 -05:00			`sudo qubesctl top.enable fedora-xfce`
feat: bump Fedora version 2024-06-12 09:00:59 -04:00			`sudo qubesctl --targets=fedora-40-xfce state.apply`
doc: prefix qubesctl with sudo Fixes: https://github.com/ben-grande/qusal/issues/20 2024-02-23 10:54:35 -05:00			`sudo qubesctl top.disable fedora-xfce`
fix: separate template formula per flavor Default template flavor is Gnome, installing Xfce when requesting the template formula without flavor causes confusion. 2024-01-12 11:47:21 -05:00			```

doc: lint markdown files Only way to have a unified markdown syntax is to enforce the wanted syntax by linting the files. Don't rely on the many markdown syntaxes, be consistent. 2024-07-04 11:10:11 -04:00			`* State:`

fix: separate template formula per flavor Default template flavor is Gnome, installing Xfce when requesting the template formula without flavor causes confusion. 2024-01-12 11:47:21 -05:00			`<!-- pkg:begin:post-install -->`
doc: lint markdown files Only way to have a unified markdown syntax is to enforce the wanted syntax by linting the files. Don't rely on the many markdown syntaxes, be consistent. 2024-07-04 11:10:11 -04:00
fix: separate template formula per flavor Default template flavor is Gnome, installing Xfce when requesting the template formula without flavor causes confusion. 2024-01-12 11:47:21 -05:00			```sh
doc: prefix qubesctl with sudo Fixes: https://github.com/ben-grande/qusal/issues/20 2024-02-23 10:54:35 -05:00			`sudo qubesctl state.apply fedora-xfce.create`
feat: bump Fedora version 2024-06-12 09:00:59 -04:00			`sudo qubesctl --skip-dom0 --targets=fedora-40-xfce state.apply fedora-xfce.install`
fix: separate template formula per flavor Default template flavor is Gnome, installing Xfce when requesting the template formula without flavor causes confusion. 2024-01-12 11:47:21 -05:00			```
doc: lint markdown files Only way to have a unified markdown syntax is to enforce the wanted syntax by linting the files. Don't rely on the many markdown syntaxes, be consistent. 2024-07-04 11:10:11 -04:00
fix: separate template formula per flavor Default template flavor is Gnome, installing Xfce when requesting the template formula without flavor causes confusion. 2024-01-12 11:47:21 -05:00			`<!-- pkg:end:post-install -->`

			`## Usage`

			`AppVMs and StandaloneVMs can be based on this template.`