title: Sphinx RTD Theme and New Lines
body: <p>I have written a library in python 3 and am now in the process of documenting the class, its methods, constants, etc.</p>
  
  <p>I am having a subtle formatting issue with constants that are lists or dicts. My organization has taken the position that lists and dicts should be written in the following format for readability...</p>
  
  <pre><code>my_list = [
      'One',
      'Two',
      'Three',
  ]
  
  my_dict = {
      'One': 1,
      'Two': 2,
      'Three': 3,
  }
  </code></pre>
  
  <p>In my class I have some constants that are lists, for example:</p>
  
  <pre><code>STD_LIST = [
      'item1',
      'item2',
      'item3',
  ]
  </code></pre>
  
  <p>and I've copied this list and all other class constants up into the class docstring and written a paragraph explaining each's significance. If I want the html documents to have this nice formatting I am using the vertical bar ("|") to force new lines. </p>
  
  <p>Here is my restructuredText:</p>
  
  <pre><code>|     **STD_LIST = [**
  |         **'item1',**
  |         **'item2',**
  |         **'item3',**
  |     **]**
  
          This list is very important. Please do not modify it unless you know
          what you are doing. Best not to touch it ever!
  
          .. warning:: Don't touch :py:const:`STD_LIST` unless you know what \
          you are doing.
  </code></pre>
  
  <p>But then the following happens:<a href="https://i.stack.imgur.com/JYugt.png" rel="nofollow noreferrer"><img src="https://i.stack.imgur.com/JYugt.png" alt="enter image description here"></a></p>
  
  <p>The problem here is, like I said subtle, but I'm sort of a perfectionist. When a normal constant is documented the description is indented. When the vertical bars are used it disrupts this indentation. (Compare with image below)
  <a href="https://i.stack.imgur.com/GJDiu.png" rel="nofollow noreferrer"><img src="https://i.stack.imgur.com/GJDiu.png" alt="Normally how documented constants look with correct indentation"></a></p>
  
  <p>I have found that if I remove the blank line between the constant declaration and the description this makes the description continue on the last line of the list. If I then add a vertical bar at the first line of the description it corrects this problem entirely but then causes issues with the next constant down below by not adding a blank line between them.</p>
  
  <p>Does anyone know how to achieve consistency with reST and Sphinx in a case like this? I think also being able to force a newline between constants in this docstring would also be an adequate work-around.</p>