Style update for README yaml code blocks.

README.md

@@ -14,54 +14,71 @@ If you are using Apache with PHP, I recommend using the `geerlingguy.php` role t
 
 Available variables are listed below, along with default values (see `defaults/main.yml`):
 
+```yaml
 apache_enablerepo: ""
+```
 
 The repository to use when installing Apache (only used on RHEL/CentOS systems). If you'd like later versions of Apache than are available in the OS's core repositories, use a repository like EPEL (which can be installed with the `geerlingguy.repo-epel` role).
 
+```yaml
 apache_listen_ip: "*"
 apache_listen_port: 80
 apache_listen_port_ssl: 443
+```
 
 The IP address and ports on which apache should be listening. Useful if you have another service (like a reverse proxy) listening on port 80 or 443 and need to change the defaults.
 
+```yaml
 apache_create_vhosts: true
 apache_vhosts_filename: "vhosts.conf"
 apache_vhosts_template: "vhosts.conf.j2"
+```
 
 If set to true, a vhosts file, managed by this role's variables (see below), will be created and placed in the Apache configuration folder. If set to false, you can place your own vhosts file into Apache's configuration folder and skip the convenient (but more basic) one added by this role. You can also override the template used and set a path to your own template, if you need to further customize the layout of your VirtualHosts.
 
+```yaml
 apache_remove_default_vhost: false
+```
 
 On Debian/Ubuntu, a default virtualhost is included in Apache's configuration. Set this to `true` to remove that default virtualhost configuration file.
 
+```yaml
 apache_global_vhost_settings: |
   DirectoryIndex index.php index.html
   # Add other global settings on subsequent lines.
+```
 
 You can add or override global Apache configuration settings in the role-provided vhosts file (assuming `apache_create_vhosts` is true) using this variable. By default it only sets the DirectoryIndex configuration.
 
+```yaml
 apache_vhosts:
   # Additional optional properties: 'serveradmin, serveralias, extra_parameters'.
   - servername: "local.dev"
     documentroot: "/var/www/html"
+```
 
 Add a set of properties per virtualhost, including `servername` (required), `documentroot` (required), `allow_override` (optional: defaults to the value of `apache_allow_override`), `options` (optional: defaults to the value of `apache_options`), `serveradmin` (optional), `serveralias` (optional) and `extra_parameters` (optional: you can add whatever additional configuration lines you'd like in here).
 
 Here's an example using `extra_parameters` to add a RewriteRule to redirect all requests to the `www.` site:
 
+```yaml
 - servername: "www.local.dev"
   serveralias: "local.dev"
   documentroot: "/var/www/html"
   extra_parameters: |
     RewriteCond %{HTTP_HOST} !^www\. [NC]
     RewriteRule ^(.*)$ http://www.%{HTTP_HOST}%{REQUEST_URI} [R=301,L]
+```
 
 The `|` denotes a multiline scalar block in YAML, so newlines are preserved in the resulting configuration file output.
 
+```yaml
 apache_vhosts_ssl: []
+```
 
 No SSL vhosts are configured by default, but you can add them using the same pattern as `apache_vhosts`, with a few additional directives, like the following example:
 
+```yaml
 apache_vhosts_ssl:
   - servername: "local.dev"
     documentroot: "/var/www/html"
@@ -71,48 +88,67 @@ No SSL vhosts are configured by default, but you can add them using the same pat
     extra_parameters: |
       RewriteCond %{HTTP_HOST} !^www\. [NC]
       RewriteRule ^(.*)$ http://www.%{HTTP_HOST}%{REQUEST_URI} [R=301,L]
+```
 
 Other SSL directives can be managed with other SSL-related role variables.
 
+```yaml
 apache_ssl_no_log: true
+```
 
 Whether to print SSL-related task output to the console when running the playbook.
 
+```yaml
 apache_ssl_protocol: "All -SSLv2 -SSLv3"
 apache_ssl_cipher_suite: "AES256+EECDH:AES256+EDH"
+```
 
 The SSL protocols and cipher suites that are used/allowed when clients make secure connections to your server. These are secure/sane defaults, but for maximum security, performand, and/or compatibility, you may need to adjust these settings.
 
+```yaml
 apache_allow_override: "All"
 apache_options: "-Indexes +FollowSymLinks"
+```
 
 The default values for the `AllowOverride` and `Options` directives for the `documentroot` directory of each vhost.  A vhost can overwrite these values by specifying `allow_override` or `options`.
 
+```yaml
 apache_mods_enabled:
   - rewrite
   - ssl
 apache_mods_disabled: []
+```
 
 Which Apache mods to enable or disable (these will be symlinked into the appropriate location). See the `mods-available` directory inside the apache configuration directory (`/etc/apache2/mods-available` on Debian/Ubuntu) for all the available mods.
 
+```yaml
 apache_packages:
   - [platform-specific]
+```
 
 The list of packages to be installed. This defaults to a set of platform-specific packages for RedHat or Debian-based systems (see `vars/RedHat.yml` and `vars/Debian.yml` for the default values).
 
+```yaml
 apache_state: started
+```
 
 Set initial Apache daemon state to be enforced when this role is run. This should generally remain `started`, but you can set it to `stopped` if you need to fix the Apache config during a playbook run or otherwise would not like Apache started at the time this role is run.
 
+```yaml
 apache_enabled: yes
+```
 
 Set the Apache service boot time status. This should generally remain `yes`, but you can set it to `no` if you need to run Ansible while leaving the service disabled.
 
+```yaml
 apache_packages_state: present
+```
 
 If you have enabled any additional repositories such as _ondrej/apache2_, [geerlingguy.repo-epel](https://github.com/geerlingguy/ansible-role-repo-epel), or [geerlingguy.repo-remi](https://github.com/geerlingguy/ansible-role-repo-remi), you may want an easy way to upgrade versions. You can set this to `latest` (combined with `apache_enablerepo` on RHEL) and can directly upgrade to a different Apache version from a different repo (instead of uninstalling and reinstalling Apache).
 
+```yaml
 apache_ignore_missing_ssl_certificate: true
+```
 
 If you would like to only create SSL vhosts when the vhost certificate is present (e.g. when using Let’s Encrypt), set `apache_ignore_missing_ssl_certificate` to `false`. When doing this, you might need to run your playbook more than once so all the vhosts are configured (if another part of the playbook generates the SSL certificates).
 
@@ -120,6 +156,7 @@ If you would like to only create SSL vhosts when the vhost certificate is presen
 
 If you require Basic Auth support, you can add it either through a custom template, or by adding `extra_parameters` to a VirtualHost configuration, like so:
 
+```yaml
     extra_parameters: |
       <Directory "/var/www/password-protected-directory">
         Require valid-user
@@ -127,13 +164,16 @@ If you require Basic Auth support, you can add it either through a custom templa
         AuthName "Please authenticate"
         AuthUserFile /var/www/password-protected-directory/.htpasswd
       </Directory>
+```
 
 To password protect everything within a VirtualHost directive, use the `Location` block instead of `Directory`:
 
+```
 <Location "/">
   Require valid-user
   ....
 </Location>
+```
 
 You would need to generate/upload your own `.htpasswd` file in your own playbook. There may be other roles that support this functionality in a more integrated way.
 
@@ -143,17 +183,21 @@ None.
 
 ## Example Playbook
 
+```yaml
 - hosts: webservers
   vars_files:
     - vars/main.yml
   roles:
     - { role: geerlingguy.apache }
+```
 
 *Inside `vars/main.yml`*:
 
+```yaml
 apache_listen_port: 8080
 apache_vhosts:
   - {servername: "example.com", documentroot: "/var/www/vhosts/example_com"}
+```
 
 ## License