playbooks.d(7) "/etc/bashtard/playbooks.d"
; SPDX-FileCopyrightText: 2023 Patrick Spek
; SPDX-License-Identifier: AGPL-3.0-or-later
# NAME
bashtard - A Bash-based configuration management utility
# INTRODUCTION
*bashtard* playbooks are, in essence, no more than directories with a small
number of required files. The files you must include in any playbook are:
- description.txt
- playbook.bash
The filename are case sensitive, and the extensions are required.
# HIERARCHY
# description.txt
This is a small text file which contains a small description of the playbook,
usually only a single sentence. This description is shown in the usage output of
*bashtard*.
# playbook.bash
The _playbook.bash_ file is a regular Bash script. It must contain 3 specific
functions, which are called by *bashtard* when the appropriate subcommand is
invoked. These functions are _playbook\_add()_, _playbook\_sync()_, and
_playbook\_del()_. How you define these functions is up to you.
# SEE ALSO
- _bashtard(3)_ -- Variables and functions exposed by Bashtard