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. *
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
|
