mirror of
https://github.com/ansible-collections/community.general.git
synced 2025-07-24 13:50:22 -07:00
Fixes more rST errors (#39042)
* removes include, avoids duplicate label rST warnings * reduces literal_block errors on playbooks_filters * addresses TOC errors * ref error on modules page * trying ref for list_of_database_modules
This commit is contained in:
parent
408e29cbd2
commit
64dcc7def0
7 changed files with 107 additions and 93 deletions
|
@ -108,5 +108,3 @@ The following topics will discuss how to develop and work with modules:
|
||||||
`irc.freenode.net <http://irc.freenode.net>`_
|
`irc.freenode.net <http://irc.freenode.net>`_
|
||||||
#ansible IRC chat channel
|
#ansible IRC chat channel
|
||||||
|
|
||||||
|
|
||||||
.. include:: ./developing_module_utilities.rst
|
|
||||||
|
|
|
@ -33,7 +33,7 @@ Although it's tempting to get straight into coding, there are a few things to be
|
||||||
Naming Convention
|
Naming Convention
|
||||||
`````````````````
|
`````````````````
|
||||||
|
|
||||||
As you may have noticed when looking under ``lib/ansible/modules/`` we support up to two directories deep (but no deeper), e.g. `databases/mysql`. This is used to group files on disk as well as group related modules into categories and topics the Module Index, for example: :doc:`../list_of_database_modules`.
|
As you may have noticed when looking under ``lib/ansible/modules/`` we support up to two directories deep (but no deeper), e.g. `databases/mysql`. This is used to group files on disk as well as group related modules into categories and topics the Module Index, for example: :ref:`list_of_database_modules`.
|
||||||
|
|
||||||
The directory name should represent the *product* or *OS* name, not the company name.
|
The directory name should represent the *product* or *OS* name, not the company name.
|
||||||
|
|
||||||
|
|
|
@ -66,7 +66,7 @@ Ansible releases a new major release of Ansible approximately every two months.
|
||||||
:caption: Ansible for Network Automation
|
:caption: Ansible for Network Automation
|
||||||
|
|
||||||
network/index
|
network/index
|
||||||
network/getting_started
|
network/getting_started/index
|
||||||
|
|
||||||
.. toctree::
|
.. toctree::
|
||||||
:maxdepth: 2
|
:maxdepth: 2
|
||||||
|
|
|
@ -22,8 +22,8 @@ This section covers the various types of plugins that are included with Ansible:
|
||||||
shell
|
shell
|
||||||
strategy
|
strategy
|
||||||
vars
|
vars
|
||||||
playbooks_filters
|
../user_guide/playbooks_filters
|
||||||
playbooks_tests
|
../user_guide/playbooks_tests
|
||||||
../user_guide/plugin_filtering_config
|
../user_guide/plugin_filtering_config
|
||||||
|
|
||||||
.. seealso::
|
.. seealso::
|
||||||
|
|
|
@ -6,13 +6,13 @@ Before we start exploring the main components of Ansible -- playbooks, configura
|
||||||
.. toctree::
|
.. toctree::
|
||||||
:maxdepth: 1
|
:maxdepth: 1
|
||||||
|
|
||||||
installation_guide/index
|
../installation_guide/index
|
||||||
../dev_guide/overview_architecture
|
../dev_guide/overview_architecture
|
||||||
intro_getting_started
|
intro_getting_started
|
||||||
intro_inventory
|
intro_inventory
|
||||||
intro_dynamic_inventory
|
intro_dynamic_inventory
|
||||||
intro_patterns
|
intro_patterns
|
||||||
intro_adhoc
|
intro_adhoc
|
||||||
intro_configuration
|
../installation_guide/intro_configuration
|
||||||
intro_bsd
|
intro_bsd
|
||||||
intro_windows
|
intro_windows
|
||||||
|
|
|
@ -7,7 +7,7 @@ Working With Modules
|
||||||
:maxdepth: 1
|
:maxdepth: 1
|
||||||
|
|
||||||
modules_intro
|
modules_intro
|
||||||
common_return_values
|
../reference_appendices/common_return_values
|
||||||
modules_support
|
modules_support
|
||||||
../modules/modules_by_category
|
../modules/modules_by_category
|
||||||
|
|
||||||
|
|
|
@ -384,14 +384,19 @@ Network CLI filters
|
||||||
To convert the output of a network device CLI command into structured JSON
|
To convert the output of a network device CLI command into structured JSON
|
||||||
output, use the ``parse_cli`` filter::
|
output, use the ``parse_cli`` filter::
|
||||||
|
|
||||||
|
.. code-block:: yaml
|
||||||
|
|
||||||
{{ output | parse_cli('path/to/spec') }}
|
{{ output | parse_cli('path/to/spec') }}
|
||||||
|
|
||||||
|
|
||||||
The ``parse_cli`` filter will load the spec file and pass the command output
|
The ``parse_cli`` filter will load the spec file and pass the command output
|
||||||
through it, returning JSON output. The YAML spec file defines how to parse the CLI output.
|
through it, returning JSON output. The YAML spec file defines how to parse the CLI output.
|
||||||
|
|
||||||
The spec file should be valid formatted YAML. It defines how to parse the CLI
|
The spec file should be valid formatted YAML. It defines how to parse the CLI
|
||||||
output and return JSON data. Below is an example of a valid spec file that
|
output and return JSON data. Below is an example of a valid spec file that
|
||||||
will parse the output from the ``show vlan`` command.::
|
will parse the output from the ``show vlan`` command.
|
||||||
|
|
||||||
|
.. code-block:: yaml
|
||||||
|
|
||||||
---
|
---
|
||||||
vars:
|
vars:
|
||||||
|
@ -408,12 +413,15 @@ will parse the output from the ``show vlan`` command.::
|
||||||
state_static:
|
state_static:
|
||||||
value: present
|
value: present
|
||||||
|
|
||||||
|
|
||||||
The spec file above will return a JSON data structure that is a list of hashes
|
The spec file above will return a JSON data structure that is a list of hashes
|
||||||
with the parsed VLAN information.
|
with the parsed VLAN information.
|
||||||
|
|
||||||
The same command could be parsed into a hash by using the key and values
|
The same command could be parsed into a hash by using the key and values
|
||||||
directives. Here is an example of how to parse the output into a hash
|
directives. Here is an example of how to parse the output into a hash
|
||||||
value using the same ``show vlan`` command.::
|
value using the same ``show vlan`` command.
|
||||||
|
|
||||||
|
.. code-block:: yaml
|
||||||
|
|
||||||
---
|
---
|
||||||
vars:
|
vars:
|
||||||
|
@ -432,9 +440,12 @@ value using the same ``show vlan`` command.::
|
||||||
state_static:
|
state_static:
|
||||||
value: present
|
value: present
|
||||||
|
|
||||||
|
|
||||||
Another common use case for parsing CLI commands is to break a large command
|
Another common use case for parsing CLI commands is to break a large command
|
||||||
into blocks that can be parsed. This can be done using the ``start_block`` and
|
into blocks that can be parsed. This can be done using the ``start_block`` and
|
||||||
``end_block`` directives to break the command into blocks that can be parsed.::
|
``end_block`` directives to break the command into blocks that can be parsed.
|
||||||
|
|
||||||
|
.. code-block:: yaml
|
||||||
|
|
||||||
---
|
---
|
||||||
vars:
|
vars:
|
||||||
|
@ -482,7 +493,9 @@ The spec file should be valid formatted YAML. It defines how to parse the XML
|
||||||
output and return JSON data.
|
output and return JSON data.
|
||||||
|
|
||||||
Below is an example of a valid spec file that
|
Below is an example of a valid spec file that
|
||||||
will parse the output from the ``show vlan | display xml`` command.::
|
will parse the output from the ``show vlan | display xml`` command.
|
||||||
|
|
||||||
|
.. code-block:: yaml
|
||||||
|
|
||||||
---
|
---
|
||||||
vars:
|
vars:
|
||||||
|
@ -503,12 +516,15 @@ will parse the output from the ``show vlan | display xml`` command.::
|
||||||
desc: description
|
desc: description
|
||||||
state: ".[@inactive='inactive']"
|
state: ".[@inactive='inactive']"
|
||||||
|
|
||||||
|
|
||||||
The spec file above will return a JSON data structure that is a list of hashes
|
The spec file above will return a JSON data structure that is a list of hashes
|
||||||
with the parsed VLAN information.
|
with the parsed VLAN information.
|
||||||
|
|
||||||
The same command could be parsed into a hash by using the key and values
|
The same command could be parsed into a hash by using the key and values
|
||||||
directives. Here is an example of how to parse the output into a hash
|
directives. Here is an example of how to parse the output into a hash
|
||||||
value using the same ``show vlan | display xml`` command.::
|
value using the same ``show vlan | display xml`` command.
|
||||||
|
|
||||||
|
.. code-block:: yaml
|
||||||
|
|
||||||
---
|
---
|
||||||
vars:
|
vars:
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue