mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
caecb2297f
* Feature. Add chapter 'Lists of dictionaries' * Fix copyright and licensing. * Add maintainers for docsite chapter 'Lists of dictionaries'. * Generate docs keep_keys and remove_keys * Update integration tests of keep_keys and remove_keys * Update docs helpers of keep_keys and remove_keys * Fix copyright and licensing. * Fix remove license from templates. Cleanup. * Add docs helper replace_keys * Update integration test filter_replace_keys * Generate and update: filter_guide-abstract_informations-lists_of_dictionaries-replace_keys.rst * Formatting improved. * Fix results Jinja quotation marks. * Update docs/docsite/helper/keep_keys/filter_guide-abstract_informations-lists_of_dictionaries-keep_keys.rst.j2 Co-authored-by: Felix Fontein <felix@fontein.de> * Update docs/docsite/helper/keep_keys/filter_guide-abstract_informations-lists_of_dictionaries-keep_keys.rst.j2 Co-authored-by: Felix Fontein <felix@fontein.de> * Fix references. * Updated helpers. * Fix licenses. Simplified templates. * Fix licenses. * Fix README. --------- Co-authored-by: Felix Fontein <felix@fontein.de>
61 lines
1.8 KiB
Markdown
61 lines
1.8 KiB
Markdown
<!--
|
|
Copyright (c) Ansible Project
|
|
GNU General Public License v3.0+ (see LICENSES/GPL-3.0-or-later.txt or https://www.gnu.org/licenses/gpl-3.0.txt)
|
|
SPDX-License-Identifier: GPL-3.0-or-later
|
|
-->
|
|
|
|
# Docs helper. Create RST file.
|
|
|
|
The playbook `playbook.yml` writes a RST file that can be used in
|
|
docs/docsite/rst. The usage of this helper is recommended but not
|
|
mandatory. You can stop reading here and update the RST file manually
|
|
if you don't want to use this helper.
|
|
|
|
## Run the playbook
|
|
|
|
If you want to generate the RST file by this helper fit the variables
|
|
in the playbook and the template to your needs. Then, run the play
|
|
|
|
```sh
|
|
shell> ansible-playbook playbook.yml
|
|
```
|
|
|
|
## Copy RST to docs/docsite/rst
|
|
|
|
Copy the RST file to `docs/docsite/rst` and remove it from this
|
|
directory.
|
|
|
|
## Update the checksums
|
|
|
|
Substitute the variables and run the below commands
|
|
|
|
```sh
|
|
shell> sha1sum {{ target_vars }} > {{ target_sha1 }}
|
|
shell> sha1sum {{ file_rst }} > {{ file_sha1 }}
|
|
```
|
|
|
|
## Playbook explained
|
|
|
|
The playbook includes the variable *tests* from the integration tests
|
|
and creates the RST file from the template. The playbook will
|
|
terminate if:
|
|
|
|
* The file with the variable *tests* was changed
|
|
* The RST file was changed
|
|
|
|
This means that this helper is probably not up to date.
|
|
|
|
### The file with the variable *tests* was changed
|
|
|
|
This means that somebody updated the integration tests. Review the
|
|
changes and update the template if needed. Update the checksum to pass
|
|
the integrity test. The playbook message provides you with the
|
|
command.
|
|
|
|
### The RST file was changed
|
|
|
|
This means that somebody updated the RST file manually. Review the
|
|
changes and update the template. Update the checksum to pass the
|
|
integrity test. The playbook message provides you with the
|
|
command. Make sure that the updated template will create identical RST
|
|
file. Only then apply your changes.
|