[BUG] Some code blocks in the installation instructions are not rendering

[sandeep-ps]

Describe the bug Some code blocks in the installation instructions on the Read The Docs page are not rendering.

To Reproduce Steps to reproduce the behavior:

1. Go to https://clowder-framework.readthedocs.io/en/latest/userguide/installing_clowder.html
2. Scroll down to https://clowder-framework.readthedocs.io/en/latest/userguide/installing_clowder.html#expose-docker- services-ports-to-clowder
3. See that the code blocks are missing (see screenshot below.)

Expected behavior All code blocks need to render correctly.

Screenshots

Desktop (please complete the following information):

• OS: MacOS
• Browser: Chrome
• Version: 98.0.4758.102 (Official Build) (x86_64)

Additional context Relevant RST file section: https://github.com/clowder-framework/clowder/blob/develop/doc/src/sphinx/userguide/installing_clowder.rst#expose-docker-services-ports-to-clowder

[KastanDay]

As far as I can tell, this is the only code block that is missing in the HTML render.

The offending block looks like:

.. code:: yml

   # this lets Clowder communicate with the necessary services
   # These services (Mongo, RabbitMQ, ElsticSearch) will be run 
   # via docker containers using the command line

   services:
     mongo:
       image: mongo:3.4
       ports:
         - 27017:27017
     rabbitmq:
       image: rabbitmq:management-alpine
       ports:
         - 5672:5672
         - 15672:15672
     elasticsearch:
       image: elasticsearch:2
       ports:
         - 9200:9200
         - 9300:9300

Possible causes:

• the code formatting is "yml" which appears to be supported, but could be the problem. We might want to switch from .. code:: yml to .. code:: yaml (or none or guess)
• The code has new lines and indents. We might want to switch from .. code:: yml to .. code-block:: yaml

I think the fix is: .. code:: yaml (simply spelling out 'yaml')

I will test locally, then submit a PR.

[sandeep-ps]

Good catch, @KastanDay!