Installing Everything You Need On Windows Vista
This is a step-by-step pictorial log of the installation of everything
you need to run LaTeX and l2h under MS Windows. It includes the
installation of LaTeX, Perl, ghostscript, not just l2h. (If you have
already installed one or more of these, just skip past these parts.)
The machine was an essentially virgin MS Windows Vista laptop. (I
normally run linux, not Windows.) However, I had already installed
Private Firewall and Microsoft Security Essentials on it for some
basic feeling of security.
The log below installs the "MiKTeX" version of LaTeX, not the TeX Live
one. For a pictorial log of how to install the TeX Live version, see
the Windows 7 installation log.
In the screen images that follow, the critical parts are marked in red.
Any further explanations follow the screen image in dark red just like
this text.
Install LaTeX
First is to go to the TeXlive download page to get LaTeX. (As you can
still see above, I found the page by googling "miktex". If the
"http://miktex.org/download" link has changed, you might want to try
the same.) I clicked the recommended download (red dot).
I got a "Do you want to save this file" window and clicked "Save File".
As you can see from the location bar, I tried to save to the desktop.
However, somehow I messed up. Anyway, I clicked "Save".
A download progress bar popped up, so I waited for it to finish.
After the download was done, there was no MiKTeX icon on the
desktop. However, there was a "Desktop" folder on the desktop!
I double-clicked it.
Yes, MiKTeX was inside. I dragged it out of the folder and dropped it
on the desktop. (In other words, I put the mouse over "Basic
MiKTeX...", pushed the left button down, and while keeping it down
dragged "Basic MiKTeX..." to an empty spot on the desktop. Then I
released the button.)
There it was on the Desktop where I wanted it. I double-clicked it
now.
That opened up this window. I clicked "I agree" to check-mark it and
then clicked "Next".
I choose to install for all users. (I believe in Windows 7 it may be
easier just to install for yourself.) Then I clicked "Next".
I clicked "Next".
Since I live in the USA, I changed the paper size to letter
instead of the European A4.
Then I clicked "Next".
I clicked "Start".
A download progress bar popped up, so I waited for it to finish.
During the process, Private Firewall showed up to ask whether to allow
the installation. There were a number of such instances. In each case,
I clicked "Allow" after glancing at what I was allowing. I will not show
these anymore. (There were also some warnings I could not show because
they disabled the PrintScreen button.)
After the download was done, the "Next" button became active. I
clicked it.
I clicked "Close". MiKTeX was installed. One down, three more to go.
Install Perl
Downloading Perl was next. First go to the right ActiveState web page.
I googled "perl for windows" to find the one in the location bar.
I clicked "Download Now".
I clicked "Download Active Perl for Windows".
There we go again.
"This time I am ready for your tricks!" I clicked the location bar.
I erased the second Desktop in C:\Users\dommelen\Desktop\Desktop and
then clicked "Save".
After download, there it was on the Desktop as it should.
I got a message "WARNING WARNING WARNING: Microsoft is not making any
additional money on this software!!!" message, as shown above. Since
I do not have any stock in Microsoft (as far as I know), I clicked
"Run" anyway.
I clicked "Next".
I clicked "I accept..." and then "Next".
You may want to exclude the documentation and examples here, to save
disk space and speed up the process. But I just clicked "Next".
Windows is going Green? I think I managed to save to a low-color bmp
format instead of gif. In any case, I clicked "Next".
I clicked "Install".
A download progress bar popped up, so I waited for it to finish.
I disabled showing release notes and then I clicked "Finish".
Two to go.
Install Ghostscript
I googled "ghostscript for windows" and got the location shown in the
location bar. (Actually, I did not expect this location. I did not
know that the one I had was obsolete.)
Do not click Download. Instead scroll down the page.
There, at the right hand side, is what you want, ghostscript
for Windows in exe form.
What else is new?
What else is new?
There is the ghostscript icon on the Desktop. I double-clicked it.
That produced this window. I clicked "Next".
I clicked "I agree".
I clicked "Install".
After the download, I deselected "Show Readme" and clicked "Finish".
L2h will be last.
Install l2h
Note that I changed my Firefox browser theme. Isn't that neat?
Go to the l2h web page (see the location bar) and click on
"Installation on Microsoft Windows".
We already did the first three installation mentioned on the page.
(Note that the ghostscript location shown is out of date.)
Click the desired l2h_MS.exe link. (The second is probably faster.)
The windows theme has changed too. But you know the drill.
I still select to save to the Desktop.
Back to the classical theme. It is less garish.
Double click the l2h_MS icon.
The l2h files get extracted.
A new folder l2h has been created. Note that you might want to get rid
of the MiKTeX, Perl, ghostscript, and l2h_MS icons now. Then click the
l2h folder.
The folder opens. Double-click "install_l2h".
After reading carefully, hit the Enter key. (That is
called the Return key on some keyboards.) Or if you want to be
explicit, hit the "y" key.
After reading carefully, hit Enter.
Hit Enter.
Hit Enter.
As it says, usually all you need to do is hit Enter on those queries.
(If you have more than one version of LaTeX, Perl, or ghostscript
installed, you may want to pay more attention, however.)
Hit Enter.
Hit Enter.
Hit Enter.
Hit Enter.
Hit Enter.
Hit Enter.
Hit Enter.
If you have some computer knowledge, it may be interesting to read
the messages. Otherwise, you guessed it.
You should see the "failed: error status 1" message.
Hit Enter.
It should say the installation is done. Hit Enter.
Hit Enter.
Test it out
Ckeck that your browser is starting up. Or if it is already started
up, that it has loaded the "How to get started" web page. (If not, go
into the "l2h" folder, then its "help-files" folder, and right-click
it to load it.) Read the warnings.
Then scroll down to the "Quick Start Guide." The images below will
show what you will see when you follow these instructions.
Double-click the "l2h" folder on the desktop. Or, if you kept its
earlier window open, go back there. Personally, I have this urge to
close open windows whenever I see them. I guess I date to a time of
less powerful computers.
In the opened l2h folder, right-click folder "example". Sorry I
cannot show the right-click menu you get that way. Select "Copy"
Do not "Cut" and do not drag the folder.
Right-click on the desktop and select "Paste" from the menu.
Do not "Paste Shortcut".
A copy of folder example will be put on the Desktop this way.
Double-click it to open it. (You can close the l2h folder now.)
There is the opened desktop "example" folder. Scroll down and
double-click "l2h_menu".
The l2h menu opens. It asks you to select an example. The first time, to
test your installation, choose one of the examples 1 though 4.
Here I selected example 2, by hitting the "2" key on the keyboard.
(Just hitting Enter will not work here.)
I hit Enter.
Hit "e", not Enter.
A new window with the Microsoft Notepad editor will open.
It will show you the example LaTeX source document number 2 that you
have selected. Read through it but do not change it before you have
tested your installation. Do not worry too much yet about details.
After looking at the source document, go back to the l2h menu window.
As it says, hit "l" (not "1"). Or just hit Enter.
MiKTeX will obtain any packages you need from the Internet. Here epsf
was missing. Note that you will also have to allow the download to
your firewall. That is why the entire thing can be somewhat slow.
(But this is a one-time thing. The downloaded package will be saved
so that it does not have to be downloaded again. So just be patient
this one time.)
Natbib.sty was also missing. I am somewhat surprised at that, because
natbib is a very common package. I would have tought MiKTeX would
have installed it by default. Package vmargin.sty was also missing
(not shown).
Your patience is rewarded. No problems. Now press "p" to create a
finished pdf document from the example. Or just hit Enter; p is the
default. (Note: If you selected example 3 or 4 instead of 2, you
would not have to do this step.)
After the menu returns, hit "P" (capital P, so hold Shift) to check
the finished document in pdf form.
Adobe Acrobat Reader will open. (I assume you have installed it for
your web browser. Otherwise, do.) Use the arrows, or the side bar,
to navigate. The document looks OK to me. An impressive scientific
study indeed!
Now see whether you can create a web-pages version of the document.
Hit "2", or just Enter.
Hit "w".
There are no existing web pages. Just hit "c" or just Enter.
Hit "c" or just Enter to proceed to the web page theme selection.
Here I took the default "B" for the white-blue appearence of the web
pages.
When I process my 1600 page book on Quantum Mechanics on my laptop, I
have screens like this for an hour. My more recent desktop computer
at work is a bit quicker, fortunately. So I tend to use that one.
Or process overnight or while I am away.
The web pages are done. It takes some experience to know what
messages from latex2html you can safely ignore. All that is shown
here can be ignored. Just hit Enter.
(Yes you can examine the web pages themselves to see if they are OK.
But for my book on quantum mechanics, that is not a realistic option.
It is 1600 pages in pdf form. The hundreds of web pages use almost
10,000 different gif images. If I could not trust that the version of
latex2html that comes with l2h is 100% reliable, I could not function.
A 99.99% reliability would mean that on average an error would indeed
occur.)
A reminder to hit Reload or refresh on your browser, in case an old
version of the web pages is already loaded. Since there is not, this
can be ignored. (To reload, click the curved blue arrow in the
location bar. Or right-click the web page and select Reload from the
menu. Or click in the location bar and hit Enter.) Hit Enter.
Hit "W", capital, to view the web pages.
Go to your browser window. Examine the created web pages. Use the
scroll bar and the buttons to do so. An impressive scientific study
indeed! Note that active links are much more accurate and quicker on
the web pages. Also, pictures look better at the default resolution.
(However, if you magnify the images, the pdf ones will typically
become better. Also, some pictures, like the Miata ones, have reduced
colors on the web pages because they are in gif format. However, this
can be fixed by enabling jpg generation in l2h. Do not worry about it
yet.)
For those who write in Greek or a nonWestern European
language: You will want to change to one of the examples 5 or 6
now. Exit the Notepad window first. Then double click the
"example" icon on the desktop, (not the one in the l2h folder), and
then find and delete the document source "index.tex". Since by
default, Windows hides the ".tex" part from you, and there are many
"index" files, you may want to go into the view menu to enable
details. Or right-click the likely candidates and select
"Properties". After you have found and deleted index.tex, press the
"-" (hyphen) key in the l2h menu. L2h will see that index.tex has
disappeared and offer you a choice of a new one. Select example 5 or
6. Use the "\" key in the l2h menu to re-enter Notepad. Read through
the brand-new section on "Internationalization". If you have a recent
version of Windows, (more recent than XP), you should be able to use
font "Times New Roman" for Greek and Cyrillic languages, or say
"SimSun" for Chinese. If in doubt, go into the Windows "Character
Map" program to search for the font that has the characters you need.
(Try "Start", "All Programs", "Accessories", "System Tools" to find
Character Map. Or search for "charmap".)
For everybody: Now go back to the Notepad window with the
example source. Make a small change. Like change the author's name
into your own. Save the file. To do so click on "File" in the top
left corner and select "Save". Or press Ctrl+s (i.e. press "s" while
holding down Ctrl.)
Go back to the l2h menu. Presumably you are still on page 2 of it,
so hit "1" or Enter to return to page 1. If you are already on page 1,
you could press "-" to refresh the menu, but that is not really needed.
As it says, press "l" or Enter again to process the change.
Press "p" again to remake the pdf. (The "p" is not needed for
examples 5 and 6, as it is not for 3 and 4.) Then, if you still have
Acrobat open, make sure it refreshes the document. Or close Acrobat
and press "P" again. Now check that the author name has indeed been
changed in the pdf.
Make another change. Until you get some experience, make changes one
at a time, saving and pressing the "l" menu key after each one. That
is to prevent you from potentially having to deal with more than one
error at a time. And to make it easier to undo any step that creates
an error.
If there is an error in processing, try hitting the "h" key for help.
See the intro_to_latex web page for
more information (press the "H" key). Have fun learning LaTeX!