Robert Cranston authored on 01/02/2022 04:19:14
| ... | ... |
@@ -2,11 +2,42 @@ |
| 2 | 2 |
|
| 3 | 3 |
An [Ansible][] [role][] for deploying custom [X][] session [`.desktop`][] file. |
| 4 | 4 |
|
| 5 |
+Adds a `/etc/X11/sessions/Xsession.desktop` file that is picked up by [X |
|
| 6 |
+display manager][]s and, if chosen, runs `/etc/X11/Xsession` (which probably |
|
| 7 |
+runs your `$HOME/.xsession`). |
|
| 8 |
+ |
|
| 5 | 9 |
[`ansible-role-xsession`]: https://git.rcrnstn.net/rcrnstn/ansible-role-xsession |
| 6 | 10 |
[Ansible]: https://docs.ansible.com/ansible |
| 7 | 11 |
[role]: https://docs.ansible.com/ansible/latest/user_guide/playbooks_reuse_roles.html |
| 8 | 12 |
[X]: https://en.wikipedia.org/wiki/X_Window_System |
| 9 | 13 |
[`.desktop`]: https://specifications.freedesktop.org/desktop-entry-spec/latest/index.html#introduction |
| 14 |
+[X display manager]: https://en.wikipedia.org/wiki/X_display_manager |
|
| 15 |
+ |
|
| 16 |
+## Usage |
|
| 17 |
+ |
|
| 18 |
+Example [`requirements.yml`][]: |
|
| 19 |
+ |
|
| 20 |
+```yaml |
|
| 21 |
+--- |
|
| 22 |
+ |
|
| 23 |
+roles: |
|
| 24 |
+ - name: 'xsession' |
|
| 25 |
+ src: 'https://git.rcrnstn.net/rcrnstn/ansible-role-xsession' |
|
| 26 |
+ scm: 'git' |
|
| 27 |
+``` |
|
| 28 |
+ |
|
| 29 |
+Example [playbook][]: |
|
| 30 |
+ |
|
| 31 |
+```yaml |
|
| 32 |
+--- |
|
| 33 |
+ |
|
| 34 |
+- hosts: 'all' |
|
| 35 |
+ roles: |
|
| 36 |
+ - role: 'xsession' |
|
| 37 |
+``` |
|
| 38 |
+ |
|
| 39 |
+[`requirements.yml`]: https://docs.ansible.com/ansible/latest/galaxy/user_guide.html#installing-multiple-roles-from-a-file |
|
| 40 |
+[playbook]: https://docs.ansible.com/ansible/latest/user_guide/playbooks.html |
|
| 10 | 41 |
|
| 11 | 42 |
## License |
| 12 | 43 |
|
Robert Cranston authored on 01/02/2022 02:04:44
| ... | ... |
@@ -7,3 +7,11 @@ An [Ansible][] [role][] for deploying custom [X][] session [`.desktop`][] file. |
| 7 | 7 |
[role]: https://docs.ansible.com/ansible/latest/user_guide/playbooks_reuse_roles.html |
| 8 | 8 |
[X]: https://en.wikipedia.org/wiki/X_Window_System |
| 9 | 9 |
[`.desktop`]: https://specifications.freedesktop.org/desktop-entry-spec/latest/index.html#introduction |
| 10 |
+ |
|
| 11 |
+## License |
|
| 12 |
+ |
|
| 13 |
+Licensed under the [ISC License][] unless otherwise noted, see the |
|
| 14 |
+[`LICENSE`][] file. |
|
| 15 |
+ |
|
| 16 |
+[ISC License]: https://choosealicense.com/licenses/isc/ |
|
| 17 |
+[`LICENSE`]: LICENSE |
Robert Cranston authored on 01/02/2022 02:04:43
| 1 | 1 |
new file mode 100644 |
| ... | ... |
@@ -0,0 +1,9 @@ |
| 1 |
+# [`ansible-role-xsession`][] |
|
| 2 |
+ |
|
| 3 |
+An [Ansible][] [role][] for deploying custom [X][] session [`.desktop`][] file. |
|
| 4 |
+ |
|
| 5 |
+[`ansible-role-xsession`]: https://git.rcrnstn.net/rcrnstn/ansible-role-xsession |
|
| 6 |
+[Ansible]: https://docs.ansible.com/ansible |
|
| 7 |
+[role]: https://docs.ansible.com/ansible/latest/user_guide/playbooks_reuse_roles.html |
|
| 8 |
+[X]: https://en.wikipedia.org/wiki/X_Window_System |
|
| 9 |
+[`.desktop`]: https://specifications.freedesktop.org/desktop-entry-spec/latest/index.html#introduction |
git.rcrnstn.net