Installing Everything You Need On Ubuntu 13.04

This is a step-by-step pictorial log of the installation of everything you need to run LaTeX and l2h under Ubuntu 13.04. It includes the installation of Ubuntu 13.04 itself partially, then LaTeX, Perl, ghostscript, and then l2h. (If you have already installed one or more of these, just skip past these parts.)

I installed Ubuntu 13.04 from scratch for this pictorial log, downloading it first from Windows 7, then installing it along side Windows 7 as an alternate operating system.

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.








Go to the Ubuntu site and find the appropriate download page for your computer (see the location bar above.)

WARNING: If you have a recent Windows computer, (say a Windows 8 one), do not follow the Ubuntu installation as pictured here. In particular, as it says in the picture above, you will need the 64 bit version. Click the drop-down bar to do so.

However, I have a fairly old Windows 7 machine. So I left it simply at 32 bit, and clicked the "Ubuntu 13.04" button.






This window showed up, telling me that the download was about to start.






Sure enough, I got this pop-up window. I first selected "Save File". (I would rather not have to download again if something goes wrong with burning the disk.) Then I clicked "OK".






That produced the above dialog, asking me where to save the file. I clicked "Desktop" in the side bar to get it to save to the Desktop (see the top bar). Then I clicked save.






Alarm! I got a "Thank you screen" OK, but no download window showed up. So I repeated the previous steps a few more times.

Finally I got smart enough to go into the Firefox "Tools" menu and click "Downloads". As you see, the downloads were being performed OK. The Download window itself did not show up for some reason. I immediately cancelled three of the four download processes. One copy is more than enough.






Wait until the download is finished. Afterwards you should be able to find the complete Ubuntu iso on your desktop. Right-click it.






That should bring up some menu, like the one above, giving you some way to "burn" the iso to a DVD. Select it. (I used the top menu choice.)






As it says, put a blank DVD in the CD/DVD drive. After it accepted it, I clicked the green arrow. It made the DVD and ejected it.




Now it is time to start installing Ubuntu. Unfortunately, I cannot show pictures of that. So I will just give a brief description. I put the DVD back into the DVD drive. Then from the Windows start menu, I used "Shutdown".

After the computer shut down, I restarted it. Ubuntu should now load. If it does, go to the next paragraph. If it does not, you need to enable "booting from the CD/DVD". Restart the computer and watch the screen for a message about a key to press. Typically, the key is F2 or F12. Press it before Windows begins to start up. You have only a couple of seconds or so after the key is shown. The key should bring up some menus (your mouse might not work on them, keyboard time.) Search through the menus for something like "boot sequence". Modify it so that the CD/DVD drive is before the primary hard disk. Save the settings. Restart the computer. If the change was done right, you should now see lots of activity on the DVD drive and Ubuntu should come up.

You will be given a choice between "Try Ubuntu" and "Install Ubuntu". I selected "Install Ubuntu". It told me it requires over 5.3 Gigabyte of available disk space and an Internet connection. My computer had them.

The tricky part about installing Ubuntu is creating space on the hard disk. You will end up at a menu, one of the options is "Erase everything on the disk". Do not select that option. Not if you might still want to use Windows, at least. I also have Ubuntu 12.04 LTS installed, and I was given an option to either replace 12.04, or upgrade it to 13.04. But I wanted to keep 12.04 also as is, thanks. So I selected the "Other" menu option.

Warning: This is not something for the unexperienced. Since there was no free space on the primary disk for Ubuntu 13.04, I had to make some. I decided to reduce the size of the Ubuntu 12.04 "partition" of the disk. So I selected that partition, clicked "Change" and reduced its size by 80 Gb (80 G is 80000 M, 4 zeros). It took about 15 minutes (of no apparent action) on my computer to reduce the size. But it did give 80 Gb of free space when done. I selected the free space, clicked +, reduced the size to 70 Gb to have 10 Gb left, and selected mount point "/" from the drop-down box. Then I clicked the remaining 10 Gb free space, and used all of it as mount point "Swap". After that I let Ubuntu proceed the install.

After the install was done, Ubuntu asked to remove the DVD from the drive and hit Enter. I did. Ubuntu restarted, this time from the hard disk instead of the DVD. I logged in with the username and password I had selected during installation.

Now I could take pictures again.









Install LaTeX and Related Stuff








There is the Ubuntu 13.04 desktop. Click the "Software Center" icon in the vertical task bar.








In the search box, type "synaptic". Synaptic Package Manager should show up in the list. Click its "Install" button.






You need to reenter your password and click "Authenticate". From now on, I will no longer show these authenticate screens.






Close Software Center and click the "Synaptic" icon on the desktop as shown. Password time again.






Synaptic opens. Click "Reload", just to be sure. (Actually, I forgot.) Then click "Search".






In the opened windows, type in "texlive" for the search string, then click "Search".






Oops, I forgot to take the picture of this at first. That is why the button in front of "texlive" is green. It will be white for you. Right-click it and select "Mark for Installation". You will get a checkmark in the button.






Click "Search" again in Synaptic and in the opened window type in "ghostscript", then click "Search" there.






Ghostscript was already installed, as seen from the green button. So that is OK.






Click "Search" again in Synaptic and in the opened window type in "perl", then click "Search" there.






Perl too was already installed.






Click "Search" again in Synaptic and in the opened window type in "pdftk", then click "Search" there.






Pdftk was not installed, so I right-clicked its button and selected "Mark for installation."






That opened up this window, telling me that some other stuff had to be installed as well. Click "Mark".






Click "Search" again in Synaptic and in the opened window type in "pdftops", then click "Search" there.






Pdftops turned out to be part of the "Poppler Utilities" that were already installed.






Search for "netpbm" and mark it for installation too. (Sorry, I forgot to take a picture of the search window.)






Click "Search" again in Synaptic and in the opened window type in "tcsh", then click "Search" there.






Tcsh was not installed, so I right-clicked its button and selected "Mark for installation."






(I had to fake the check mark in tcsh here. Took the picture before marking. Make sure there is a check mark. L2h will not even start without tcsh.) Now click "Apply".






Click "Apply" again in the window that comes up.






You get a download progress window now. Do nothing.






Click the "Close" button when it appears.







Internationalization

Note: If you write in English, or in a Western European language other than Greek, you can close Synaptic now and skip to the next section, "Installing l2h".

Those that write in nonlatin languages, however, will need to install some more stuff with Synaptic. Stay in this section.








Click "Search" again in Synaptic and in the opened window type in "xetex", then click "Search" there.






Right-click the texlive-xetex button and select "Mark for installation."






Click "Search" again in Synaptic and in the opened window type in "libertine", then click "Search" there.






Right-click the fonts-linuxlibertine button and select "Mark for installation."






You also need to mark "texlive-latex-extra" for installation. As you see in the Quick Search box, I searched for makecmds. (Sorry, I forgot to take a picture of the search window. Actually, I did this stuff later, when XeLaTeX complained it did not have etoolbox and makecmds. Make sure there is a check mark in the button, unlike it shows above.)






Finally, you need gnome-font-manager. As you see, I searched for "gnome-fon".






As before, click "Apply" in Synaptic. After things have installed, you can exit Synaptic.

The remaining images in this section show how you can install external fonts that may have characters you cannot find in linux. For example, you can install MS Windows fonts this way. However, the examples that I install here are not Microsoft fonts. They are "TITUS Cyberbit Basic" and "Bitstream Cyberbit". These fonts are special in that they cover a very wide range of characters in many languages. (TITUS has no Chinese, Japanese, or Korean characters, but Bitstream does). You should be able to find them available for private use on the web if you want them.

If you do not want to install external fonts at this time, you can go on to the next section, "Installing l2h", now.








First you need to find the just-installed Font Manager. Click the Ubuntu "Lens" icon.






Then type in Font Manager until its icon appears. Double-click the icon to open up Font Manager.






You probably will find the fonts on the Internet stored in some zip file. My fonts were in zip files called "cyberbit_nopost.zip" and "tituscbz_nopost.zip". I put these zip files on my desktop. Then I double-clicked "cyberbit_nopost.zip" to open it up. Then I "dragged" the font out of the zip and dropped it on a "try it" folder I had on the desktop. (In other words, I put the mouse over "Cyberbit.ttf", pushed the left button down, and while keeping it down dragged "Cyberbit.ttf" to "try it".) You might instead just drag "Cyberbit.ttf" to an empty spot on your desktop, of course.






The same for tituscbz.ttf. WARNING: If the file name is in uppercase, like TITUSCBZ.TTF, you need to change it to lowercase. To do so, right-click it inside "try it", or on the desktop, wherever you put it, and select "Rename".






Now go to the Font Manager window. Right-click the encircled Font Management button and select "Install Font".






In the opened file selection window, browse to the Desktop, then "try it", or wherever you put the fonts. Select the first one and then click "OK".






After Font Manager has installed the font, click "Reload Now". Repeat for the second font.







Installing l2h








In the quick launch bar, click the Firefox icon.






Go to the l2h web page http://www.eng.famu.fsu.edu/~dommelen/l2h or http://www.dommelen.net/l2h. See the location bar. Click "Installation on linux".






Read the warnings. Check that your system meets the requirements. Then click one of the l2h_deb6-32.zip links.






I selected to use Archive Manager and clicked "OK".






I dragged folder l2h out of the opened Archive Manager and put it on the desktop. (In other words, I put the mouse over the "l2h" folder, pushed the left button down, and while keeping it down dragged "l2h" to a point on the desktop. Then I released the button.) Finally, I first closed Archive Manager and then double-clicked the l2h folder on the desktop.






In the opened l2h folder, I double-clicked "install-l2h".






That opened a terminal window. In it, I typed "cd Desktop/l2h/ and hit Enter. (The Enter key is called Return on some keyboards.) (If you put the l2h folder somewhere else than on the Desktop, change the above command correspondingly.)






Seeing no complaints about the cd command, I typed "./install" and hit Enter. Do not forget the point.






After some meditation, the above screen comes up. After reading carefully, hit the Enter key. Or if you want to be explicit, hit the "y" key.






After reading carefully, hit Enter.






Hit Enter.






Hit Enter.






If you have some computer knowledge, it may be interesting to read the messages. Otherwise just hit Enter.






You should see the "failed: error status 1" message. Hit Enter.






It should say the installation is done. Hit Enter.






Close the installation terminal window.







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 l2h folder, right-click the "example" folder. From the pop-up window, 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".






This opens up the l2h menu terminal. 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 4, by hitting the "4" key on the keyboard. (Just hitting Enter will not work here.)






Hitting "y" here can do little harm, so I did.






Hit "e", not Enter.






A new window with the "gedit" editor will open. It will show you the example LaTeX source document number 4 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.






No problems, so hit "P" (capital P, so hold Shift) to check the finished document in pdf form. (Note: If you selected example 1 or 2 instead of 4, you will first need to hit the "p", lowercase, key before you can use "P".)






Evince will open to show the finished 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. (The hyperref warning would be a major warning if it occurred for the pdf version. But the web pages do not use hyperref.) 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 gedit 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 the operating system may hide 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 gedit. Read through the brand-new section on "Internationalization". You should be able to use font "Linux Libertine O" that you installed earlier for Greek and Cyrillic languages. Try "WenQuanYi Micro Hei" for say Chinese. Or use the "Bitstream Cyberbit" if you installed it. If in doubt, go into Font Manager to search for the font that has the characters you need.

Now go back to the gedit 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 to the l2h menu and press "l" again to process the change. Press "P" again to check that the name has indeed been changed

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!