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`

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

			`## Description`

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

			`## Installation`

			`- Top:`
			```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			```

			`- State:`
			`<!-- pkg:begin:post-install -->`
			```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			```
			`<!-- pkg:end:post-install -->`

			`## Usage`

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