summaryrefslogtreecommitdiffstats
path: root/doc/html/PSandPDF/process.txt
blob: a034a6fc1a50bc1c20626fda95dfe3e1b92afce0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148

========================================================================
Process for Creating PDF/PS Versions of HDF5 docs from HTML Source Files
========================================================================

                                              Last modified: 19 Nov 1999

The PDF/PS versions of the HDF5 docs are created from scratch at each 
release from the primary version of the documentation which is 
maintained in HTML.  (Assuming, of course, that we continue to produce 
PDF/PS versions.)


1  Using MS Word (Framemaker might work even better, but I have not 
   tried it yet), open a master file that will serve as the repository 
   for gathering the document set.  This file will contain all of the 
   documents to be converted to PDF/PS.

2  Start the file off with the DocSet frontmatter.

3  Open each HTML file and copy it, placing it in proper order, into the 
   repository file.

   3a Insert Glossary.  (For R1.2, it was appended to UG and to RM.
      Alternatively, it could be inserted as a separate document.)

   3b Insert Copyright page after each title page, including after 
      DocSet title page.

4  Adjust the Styles so that type faces and font sizes are appropriate.
   (I used 10 pt New Times Roman with 9 and 10 pt supplementary fonts
   in Release 1.2.  I am considering Garamond or New Century Schoolbook
   for the next release.)

5  Create a trial PDF to make sure all of the images have been imported.

   4a Print the compiled document, selecting "Print to file".

   4b Change the .prn suffix on the output file to .ps.

   4c Convert that PostScript file to PDF with Distiller.

6  Scan the output PDF file for images.  (A visual test of the compiled 
   MS Word file online is insufficient as an image's presence on the 
   screen does not guarantee its presence in the PDF file.)

7  If any images are missing, open the appropriate HTML file in Internet
   Explorer (Netscape at the time of R1.2, did not provide this 'copy' 
   capability), right click on the image, select copy, select the 
   offending image or its placeholder in the MS Word file, and paste
   the image in.

8  Repeat 4 and 5, with variations on 6, as necessary.

9  Add headers, footers, and page numbers in the consolidated file.
   (NCSA and UIUC on inside of facing footers with page numbers on the 
   outside, release # and doc title place holder on outside of facing 
   headers.  "Different first page" so that title page can be header 
   and footer free.  

10 Once you are sure that
   -- all of the images are securely showing up in the PDF and
   -- all of the styles are as you want them,
   separate the consolidated file into separate files for each document 
   and for the DocSet frontmatter.

11 Add section break at the title page and the first page of text for 
   each document.

12 Set page numbering and finalize headers and footers (h/f).

   12a Unset "Different first page" on text section h/f.

   12b Set text section page numbering to start at 1.

   12c Set frontmatter page numbering to start at i.  (R1.2 did not
       set page numbering in frontmatter.)

13 Reset headers and footers for each document (from the initial generic 
   setting).

14 Check hyperlinks.

   14a Where reasonable (e.g., not appropriate to leave as internal link 
       for user instalation), set link as external with full DNS address.

   14b Remove internal links; reword as necessary, giving user sufficient
       clues to find info in printed docs.  (The links themselves do not
       survive the Word->PDF translation, so removing a link is generally
       as simple as removing the color/underline properties.)

15 Check and adjust pagination throughout.

   15a Each chapter (and, in some cases, major sections) begins on an 
       odd page.

   15b Watch for widows and orphans, examples and sections that start
       embarrassingly close to the bottom of the page, etc.

   15c Add enough blank pages (with no h/f) so that each document is
       printed with one completely blank sheet of paper at the back.

16 Insert a TOC into each document as appropriate.  (R1.2 went 3 or 4 
   levels deep, depending on the document.) 

17 Change Tutorial "Indes of Examples" to point to directory of Tutorial 
   examples (instead of individual links).  Keep list?

18 Do a visual scan of all docs to ensure that "everything is as it 
   should be."  (Something has probably been left out of this process 
   description!)

19 Create PDFs of each document and the DocSet frontmatter.  
   (See above.)

20 Do a visual scan of all PDFs to ensure that "everything is as it
   should be." 

21 Create a consolidated DocSet file for those who want a single file 
   containing all of the doucuments.

22 Correct errors and repeat steps as necessary.  ;>

23 Create distributable PS files by printing the PDFs "to a file"
   from Adobe Acrobat Exchange.  (This results in mush smaller PS 
   files than those generated in the above MS Word -> PS process.)

24 Post and distribute PS and PDF copies of
   -- each document and
   -- the consolidated set.




  * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  * Copyright by the Board of Trustees of the University of Illinois.         *
  * All rights reserved.                                                      *
  *                                                                           *
  * This file is part of HDF5.  The full HDF5 copyright notice, including     *
  * terms governing use, modification, and redistribution, is contained in    *
  * the files COPYING and Copyright.html.  COPYING can be found at the root   *
  * of the source code distribution tree; Copyright.html can be found at the  *
  * root level of an installed copy of the electronic HDF5 document set and   *
  * is linked from the top-level documents page.  It can also be found at     *
  * http://hdf.ncsa.uiuc.edu/HDF5/doc/Copyright.html.  If you do not have     *
  * access to either file, you may request a copy from hdfhelp@ncsa.uiuc.edu. *
  * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *