home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / gutenburg / guten96d / pg / editing.gut < prev    next >
INI File  |  1995-05-27  |  17KB  |  361 lines
  1. [Last Updated: 22 August 1994]
  2.  
  3. This is the file "standard.gut" which contains many suggestions
  4. how to prepare an Etext for release by Project Gutenberg.
  5.  
  6. Remember:  these are only suggestions.  People send us files in
  7. a variety of formats, and we are most glad to a little work for
  8. the purpose of getting them into an easy to read onscreen form.
  9.  
  10. If you are interesting in editing, please ask for details on an
  11. extraordinary effort we are making to prepare Etexts in manners
  12. which will enhance both the readability and searchability of an
  13. Etext by the elimination of hyphenation and of widow/orphans on
  14. a line by line basis.  This takes a bit of work, but it results
  15. in and Etext much easier to read than the paper book from which
  16. it was taken.  Please ask for "editing.gut".
  17.  
  18. [editing.gut is currently appended to the bottom of this file.]
  19.  
  20. No indentations [anywhere other than inserted letters, poems, etc.].
  21. [Including none for contents, chapter headings, etc.]
  22.  
  23. No CAPITALIZATION of first word in a chapter, other than first letter.
  24.  
  25. Obviously, the first thing to do to make sure your chosen books
  26. are clear of copyright restrictions.  We will be happy to do an
  27. assortment of copyright searches and write clearance letters.
  28.  
  29. When you start preparing the Etext, after getting the copyright
  30. clearance finished:
  31.  
  32. Please preface the file with your name, address, phone, & email.
  33.  
  34. Each line of your book should end with a "hard return" = cr/lf.
  35. In DOS if you save as a DOS Text File, this is the default.
  36. On Macs, each line needs to end with "end of paragraph marker"
  37. In UNIX, each line needs to end with ^M.
  38.  
  39. This is VERY important in establishing the margination, as per
  40. the new editing policy mentioned above.
  41.  
  42. We try to average 65, with 55 to 75 being short and long
  43. other than for emergencies, which will extend to 51 to 79.
  44.  
  45.  
  46. You can look over any of the Project Gutenberg Etexts to see a
  47. series of examples of how this works.  You may notice how much
  48. easier it is to read the latest novels [such as Burroughs] due
  49. to the elimination of hyphenation, and the remargination of an
  50. assortment of lines that previous were split with words on the
  51. preceding or following lines that should have been on the same
  52. line. . .but were moved for the convenience of the publishers.
  53.  
  54.  
  55. The entire work should start with the title and end with
  56. "End of this Project Gutenberg Etext of Name of Book"
  57. Then three returns.
  58.  
  59. We would like page numbers at the left column
  60. for proofreading purposes.
  61.  
  62. Priorities go with the more important type headers.
  63. i.e. from end of Chapter to beginning of Part, use Part
  64.  
  65. Title and Part type headers--5 returns after 6 before
  66. Chapter headers--3 returns before first line.
  67. Chapter ends--4 returns before next chapter header.
  68. Wide paragraph separation--3 returns.
  69. Normal paragraph separation--2 returns.
  70. End of line----one return.
  71. (These are "hard" returns, not "soft" returns.)
  72.  
  73.  
  74. Don't worry if you can't do all this, or can't do it easily.
  75. We expect to have to spend about ten hours on each book from
  76. the time we start editing it until it is ready for releasing
  77. on the networks.  Adding the hard returns et. al. is an easy
  78. part of that process, so don't feel obliged.
  79.  
  80. Actually, in 1994 we will have to cut this to five hours, or
  81. your erstwhile editor will die under the strain.
  82.  
  83. Also, for those concerned about space. . .even if an average
  84. paragraph in your book is only 100 characters, the additions
  85. of the hard returns will only make the book a percent longer
  86. in the end.
  87.  
  88.  
  89.  
  90. We would like to receive these files in a PLAIN ASCII format
  91. and if compressed, please use ZIP if you can.  We could help
  92. you find it, if necessary.  We prefer not to use TAR and Z--
  93. but we will if necessary. . .we would prefer to receive just
  94. one large PLAIN ASCII file and ZIP it ourselves, rather than
  95. the various chapters, subdirectories, etc. with TAR.Z files.
  96.  
  97. Please name files with standard DOS filename.ext,
  98. that is eight character filname and three for extension.
  99.  
  100. ---------------------------------------------------------------------------
  101.  
  102. *General suggestions for the preparations of Project Gutenberg Etexts*
  103.  
  104. In more detail than what was presented above.
  105.  
  106. Editing policy for margination/widows/orphans is at bottom.
  107.  
  108. Your suggestions for rewrites of this file gratefully accepted.
  109.  
  110.  
  111. 0.  Please put your name, email, and other contact information
  112.     INSIDE THE FILES YOU SEND, AT THE TOP.  You may not believe
  113.     how often we get files and cannot contact the sender to get
  114.     details on the edition, etc.
  115.  
  116. 1.  Let us do the copyright clearance for you.
  117.  
  118. 2.  Remove vestigial traces of paper publishing.
  119.     A.  Page numbers [maybe the last thing to go, for reference]
  120.         [sometimes they are required, so we leave them in]
  121.     B.  Hyphens at the end of lines, unless true hyphenated word
  122.     C.  Widows and orphans [at page, paragraph, and line levels]
  123.     D.  Remove or mark typos. [but not intentional misspellings,
  124.         and leave in intentionally bad grammar]
  125.  
  126. Spacing:
  127.  
  128.     E.  Two spaces after each sentence [watch for ! or ? that do
  129.         NOT end sentences, then use only one space].
  130.     F.  One blank line after each paragraph. [two cr/lf returns]
  131.         [If you can't do this easily, just separate each para
  132.         with "**" to simlate the "hard returns"]
  133.     G.  Two blank lines after each section [wide paper breaks]
  134.     H.  Four blank lines after each chapter
  135.     I.  Three blank lines after chapter headers.
  136.     J.  Elipses [word. . .] have no spaces before or after ".'s"
  137.         unless they end a sentence with four [. . . .  ] then it
  138.         is a sentence ending. . .with two spaces. . . .  Next is
  139.         a new sentence.
  140.     K.  Dashes will be--dashes--with no extra spaces around them
  141.         [this has been discussed at great length and changed one
  142.         or two times already.  I have heard great argumentations
  143.         from both sides [_I_ preferred the spaces] but I finally
  144.         decided on not having them because more people wanted it
  145.         that way and because it looked more like the books [also
  146.         it saves a few spaces here and there in the files].
  147.  
  148.  
  149. 3.  Try for 99.9 to 99.99% accuracy.
  150.  
  151. 4.  Swap proofreading with others from the volunteers list, keep
  152.     your reading fresh. . .once you miss an error it is a likely
  153.     thing that you will miss it again.
  154.  
  155. 5.  Poems and indented quotations within paragraphs:
  156.     Please try to make this look as much like the book so it can
  157.     be determined by the reader whether this is a separate part,
  158.     part of the same paragraph or what.  Feel free to use indent
  159.     and blank lines to accomplish this.
  160.  
  161. 6.  Most people use "quotes" but those who are sticklers for
  162.     ``open'' and ``close'' quotes use these.  Gets hairy if you say:
  163.  
  164.     Harry said, ``'Twas the night before Christmas''
  165.     Harry said, "'Twas the night before Christmas"  is fine,
  166.     [not to mention that many keyboards and programs require
  167.     an extra ` to get one on the screen, so right now I have
  168.     to type ```` to get just `` on the screen.  When a doubt
  169.     occurs, just do what you think the average searcher goes
  170.     searching for.  Please include a note at the top of your
  171.     files indicating any of these you were unsure about.
  172.  
  173.  
  174. What we need most in proofreading are people to readjust those margins
  175. after the hyphens have been removed, and to adjust line lengths in the
  176. places where phrases, lines, and paragraphs have widows and orphans.
  177.  
  178. We try to average 65, with 55 to 75 being short and long
  179. other than for emergencies, which will extend to 51 to 79.
  180.  
  181. If this it NOT what you want to do, PLEASE don't let me force you into
  182. such a thing.  It is something I can do, and can probably teach others
  183. to do, but I STRONGLY prefer NOT to ask people to do slave labor.  The
  184. editing of this nature makes the Etexts much easier to read and search
  185. with nearly any program and computer, which is a major part of Project
  186. Gutenberg's goal. . .to get the books to EVERYONE.
  187.  
  188. I know that I have a particular talent for margination, that comes out
  189. without apparent effort sometimes, as you might notice in the message.
  190. That talent is probably the only reason I ever decided this editing is
  191. possible, but I CAN te