Issue 193 Formatting

translate/presentation-formatting/01.md

@@ -1,21 +1,37 @@
-THIS PAGE IS NOT COMPLETE
 
-In written communication, we often use things other than words and punctuation to communicate meaning. Sometimes we use the arrangement of the words on the page to communicate meaning. One way do this is with indentation. Translation teams will need to decide if they want to use indentation to communicate meaning and how they want to use it.
+In written communication, we often use things other than words and punctuation to communicate meaning. Sometimes we use the arrangement of the words to communicate meaning. One way we do this is with line breaks and indentation. When text is indented, it means that the line of text starts further to the right than the lines of text above and below it that are not indented. Translation teams will need to decide if they want to use line breaks and indentation to communicate meaning and how they want to use it.
 
-When text is indented, it means that the line of text starts further to the right than the lines of text above and below it that are not indented.
 
-The first line of each paragraph can be indented to show the beginning of a new paragraph. 
+### Verses or Paragraphs
 
->&nbsp;&nbsp;&nbsp;&nbsp;<sup>1</sup> In the beginning, God created the heavens and the earth. <sup>2</sup> The earth was without form and empty. Darkness was upon the surface of the deep. The Spirit of God was moving above the surface of the waters.  
->&nbsp;&nbsp;&nbsp;&nbsp;<sup>3</sup> God said, "Let there be light," and there was light. <sup>4</sup> God saw the light, that it was good. He divided the light from the darkness. <sup>5</sup> God called the light "day," and the darkness he called "night." This was evening and morning, the first day. (Genesis 1:1-5, ULB)
 
-Alternatively, or in addition to the indentation, a full line break can be used to separate paragraphs.
+Translation teams will need to decide whether to start each verse on a new line or to arrange the verses  in paragraphs.
+
+><sup>1</sup> In the beginning, God created the heavens and the earth.   
+><sup>2</sup> The earth was without form and empty. Darkness was upon the surface of the deep. The Spirit of God was moving above the surface of the waters.   
+><sup>3</sup> God said, "Let there be light," and there was light.  
+><sup>4</sup> God saw the light, that it was good. He divided the light from the darkness.  
+><sup>5</sup> God called the light "day," and the darkness he called "night." This was evening and morning, the first day. (Genesis 1:1-5, ULB)
+
+If teams decide to arrange the verses in paragraphs, they can use an empty line space to distinguish one paragraph from the next. 
 
 ><sup>1</sup> In the beginning, God created the heavens and the earth. <sup>2</sup> The earth was without form and empty. Darkness was upon the surface of the deep. The Spirit of God was moving above the surface of the waters.   
 >
 ><sup>3</sup> God said, "Let there be light," and there was light. <sup>4</sup> God saw the light, that it was good. He divided the light from the darkness. <sup>5</sup> God called the light "day," and the darkness he called "night." This was evening and morning, the first day. (Genesis 1:1-5, ULB)
 
-In poetry, phrases can be indented to show that they are the completion of a thought in a previous line or that they are to to be contrasted with or compared to a thought in a previous line. For example:
+Alternatively, or in addition to the line space, the first line of each paragraph can be indented.
+
+>&nbsp;&nbsp;&nbsp;&nbsp;<sup>1</sup> In the beginning, God created the heavens and the earth. <sup>2</sup> The earth was without form and empty. Darkness was upon the surface of the deep. The Spirit of God was moving above the surface of the waters.  
+>&nbsp;&nbsp;&nbsp;&nbsp;<sup>3</sup> God said, "Let there be light," and there was light. <sup>4</sup> God saw the light, that it was good. He divided the light from the darkness. <sup>5</sup> God called the light "day," and the darkness he called "night." This was evening and morning, the first day. (Genesis 1:1-5, ULB)
+
+
+### Poetry
+
+Poetry does not have to be formatted in a special way. It can be formatted in the same way that other kinds of writing are formatted.
+
+><sup>1</sup> Blessed is the man who does not walk in the advice of the wicked, or stand in the pathway with sinners, or sit in the assembly of mockers. <sup>2</sup> But his delight is in the law of Yahweh, and on his law he meditates day and night. (Psalm 1:1-2, ULB)
+
+However phrases can be written on a separate line and indented to show that they are the completion of a thought in a previous line or that they are to to be contrasted with or compared to a thought in a previous line. For example:
 
 ><sup>1</sup> Blessed is the man who does not walk in the advice of the wicked,  
 >&nbsp;&nbsp;&nbsp;&nbsp;or stand in the pathway with sinners,  
@@ -23,8 +39,12 @@ In poetry, phrases can be indented to show that they are the completion of a tho
 ><sup>2</sup> But his delight is in the law of Yahweh,  
 >&nbsp;&nbsp;&nbsp;&nbsp;and on his law he meditates day and night. (Psalm 1:1-2, ULB)
 
+### Complicated Lists
 
-In long or complicated lists, items in the list can be put on indented lines.
+Lists do not have to be formatted in a special way. They can be formatted in the same way that other kinds of information are formatted.
+><sup>5</sup>These are the names of the leaders who must fight with you: From the tribe of Reuben, Elizur son of Shedeur; <sup>6</sup>from the tribe of Simeon, Shelumiel son of Zurishaddai; <sup>7</sup>from the tribe of Judah, Nahshon son of Amminadab; (Numbers 1:5-7 ULB)
+
+However, in long or complicated lists, separate lines and indentation can be used to show which items belong to which lists.
 ><sup>5</sup>These are the names of the leaders who must fight with you:  
 >&nbsp;&nbsp;&nbsp;&nbsp;From the tribe of Reuben, Elizur son of Shedeur;   
 >&nbsp;&nbsp;&nbsp;&nbsp;<sup>6</sup>from the tribe of Simeon, Shelumiel son of Zurishaddai;