-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathREADME
244 lines (175 loc) · 8.95 KB
/
README
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
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
FOR USERS
Applicability
We assume that you have a Linux/Unix computer system or the equivalent
software running under windows, and that you want to work from the source
files. If you want to modify the text, you need the source files. An
individual user of .html or .pdf does not need to have the source files,
nor use a Linux/UNIX. Though the .html, .ps and .pdf certainly can be
generated from the sources.
If you do not have such facilities, or requirements, you may want to
download liechtml.tar.gz instead for html (htm) for all volumes. If you only
need postscript (.ps) or .pdf you may download the individual volumes from
the corresponding volume web pages. Continue if you want to work with the
sources.
MS Windows users note that the popular WinZip utility is said to be able
to process the .tar and .tar.gz of which we speak below. Use that instead
of the Linux/UNIX based instructions in this document to unzip the
single liechtml.tar.gz, and the individual *.ps.gz for each volume. We
doubt that it is reasible to modify the sources on other than a Linux or
Unix sustem.
This document describes:
1)How to generate source files for all volumes from liectiny.tar or
liecsrc.tar
2)How to make html (make html)
3)How to make everything else (make all)
ps - postscript
pdf - adobe portable document format
LaTex - for publishing a printed book
ascii - plain text
Organization
The top level archive file will un-tar (unpack) into a root directory and
subdirectories for each of the volumes: DC, AC, Semi, Digital, Ref, Exper.
Each of these will initially contain a tar.gz file corresponding to each
volume. The top level directory contains a Makefile target which unzips and
untars the tar.gz's in all five individual volume subdirectories. However,
you must untar the top level .tar file manually. Suppose that you have
downloaded liectiny.tar. Untar it as follows in a direcctory of your
choosing (lessons used here):
mkdir lessons
mv liectiny.tar lessons/
cd lessons
tar xvf liectiny.tar
make untarliectinytar
The "tar xvf" command above will give you Makefile, index.htm, various
supporting files and the directories: DC, AC, Semi, Digital, Ref, Exper,
containing one each of the corresponding tar.gz files. The subdirectory
Devel with all files, requiring no further work, will also be present. While
you could sucessively cd to the individual subdirectories, unzip and untar
the tar.gz's, the top level Makefile will do this as described below for
liectiny or liecsrc. Check that you have one tar.gz file in each of the
above five subdirectories, and that Makefile is present in your top
level directory
Then execute "make untarliectinytar" as above to fill the five
subdirectories with the source files corresponding to the individual
tar.gz's. Verify that DC, AC, Semi, Digital, Ref, and Exper are full of
files.
If you are using liectiny.tar, the mogrify command from the ImageMagic
package must be available on your system to regenerate the .png images
from .eps images and .eps from .jpg and some .png images. Else, you
need to use the much larger liecsrc.tar instead of liectiny.tar.
If you have downloaded the larger liecsrc.tar file, untar as follows in a
suitable directory:
mkdir lessons
mv liecsrc.tar lessons/
cd lessons
tar xvf liecsrc.tar
make untarliecsrctar
Check for the top level Makefile, and that subdirectories: DC, AC, Semi, Digital,
Ref, and Exper have one tar.gz each. Then make "untarliecsrctar" should
fill these subdirectories with numerous files.
You can now build your target files of choice: "html" or "all" for most
users. If you started with liecsrc.tar, you shoud have everything you need.
If you started with liectiny.tar you will need the mogrify command from the
ImageMagick package.
Makefile targets
A makefile is included for building the various formats of this document.
Choose a target for use with the make command to generae the file most
appriopriate to you application.
html :
The 'html' option puts together all the pieces necessary to create HTML
output for each volume of the book. However, you need to make the .eps and
.png images first, if starting with liectiny. It is the default option. The end user
wanting a local copy of the volumes in html use this. To produce the html
for a local copy from liecsrc, execute the following commands from the top
level directory (lessons in example above):
make html
If using liectiny as a starting point, make the images first:
make eps
make png
make html
all :
The 'all' option generates HTML and compressed .ps, and .pdf output for all
volumes, and also updates all archive files. The intent of this option is
for web content providers to be able to simply type 'make all' after
uploading the latest source code and have it produce ALL the files necessary
for users to download. If starting from liecsrc, use this command from the
top level directory:
make all
If starting with liectiny, use the tinyinstall target below instead of all.
tinyinstall :
The 'tinyinstall' option installs all necessary files from the untarred
'liectiny.tar' archive file. See untarliectiny above for unzipping and
untarring the 'liectiny.tar' archive files in the volume directories prior
to this. Note that the mogrify command from the ImageMagick package must be
available on your system to regenerate the .png images from .eps images and
.eps from .jpg and some .png images. Else, you need to use the liecsrc.tar
instead of liectiny.tar.
make tinyinstall
If you want to make a web site which allows the user to download the
liectiny.tar, liecsrc.tar and liechtml.tar as from the top level "Lessons in
Electricity" page, then continue to the next section and make the three
tartets liectiny, liecsrc, and liechtml so that those .tar's will be
generated. Or, if you wish to modify any file, continue to "FOR
CONTRIBUTORS"
FOR CONTRIBUTORS
Don't read this unless you are going to modify or edit the source files
after they have been installed. The liectiny, liecsrc, and liechtml targets
create new liectiny.tar and liecsrc.tar archives rspectively.
liectiny :
The 'liectiny' option archives the bare minimum set of files
necessary to reconstruct the entire book. Image files, while
duplicated in the directories as both .eps and .jpg formats for
HTML and TeX/LaTeX/DVI output, respectively, are archived here
only in their raw source (native) formats: that is, .eps for all
schematics, .eps for tables and equations, .jpg for artwork, and
.jpg for photographs. This .tar file is about 9 Mbyte.
Use this command to create a new liectiny.tar:
make liectiny
liecsrc :
The 'liecsrc' option archives all source files necessary to reconstruct the
entire book. This is about 80 Mbytes Use this command to create a new
liecsrc.tar:
make liecsrc
liechtml :
The 'liechtml' option pieces together only those files necessary for all
volumes of the book to be viewable in HTML format. No source code is
included (only HTML code) and only JPEG and PNG image formats. Designed for
the non-contributing reader who just wants a browsable copy on their own
machine.
png :
The 'png' option creates PNG versions of all illustrations, graphs, and
equations from their respective EPS source files. You migh use this if
you modify the source .eps images to generate the corresponding .png's
required by html. Before running "make html" on
liecdtiny, run a "make png" Requires 20 minutes on a 500 Mhz P5.
eps :
The 'eps' option creates Encapsulated PostScript (EPS) versions
of all photographic images and artwork images from their
respective JPG source files. If you add or modify .jpg photo's or .png
screen cpature shots, you migh use this. Before running "make html" on
liecdtiny, run a "make eps" Requires a few minutes on a 500 Mhz P5.
More notes:
Each of the six individual volume subdirectories contains a Makefile,
which can generate the above for a single volume. Examine the Makefiles
to determine the names of the targets, or look at the top level
Makefile for clues. Note that tartets in these individual volume
subdirectory Makefiles are used by the top level Makefile.
Any of Tony Kuphaldt's development notes and tutorial are available in the
Devel subdirectory. This shows how to wite or modify source .sml.
The "untarliecsrc" make target will unzip and untar the tar.gz residing in
each of the individual subdirectories after executing tar xvf liecsrc.tar,
which procuces these subdirectories and files. The subdirectories include
AC, DC, Semi, Digital, REf, Exper
The "untarliectiny" make target will unzip and untar the tar.gz residing in
each of the individual subdirectories after executing tar xvf liectiny.tar,
which procuces these subdirectories and files. The subdirectories include
Missing files
The following executable files, which can be downloaded from links on the
top level index.htm page are not included in the tarball as they are third
party, not developed by the authors. If you want the download links on your
copy to work, you need these.
sed.exe
spice
spice.exe
dpmi32vm.ovl
32rtm.exe