Thursday, February 12, 2015

[Kile] Error arising from \usepackage[latin]{babel}

C: 4th February 2015M, We / 14 Rabiulakhir 1436H, Ra. [Ubuntu 14.04]
P: 12th February 2015M, Th / 22 Rabiulakhir 1436H, Kh. [Ubuntu 14.04]
U:


Assalamualaikum warahmatullah.

The error is shown in Step 6.

There are three parts to this post:
- Part A: Backtracking:
- Part B: How to solve:
- Part C: For the curious minds:

This post was written while i was using Kile version 2.1.3 (see Pic 3) on Ubuntu 14.04.



Part A: Backtracking:

Replicating roughly what i did before running into the problem.

1. Assuming you already have Kile installed, run Kile. See Pic 1.

That is how Kile looks once loaded, see Pic 2.

Pic 1 - Starting Kile.


Pic 2 - Kile, loaded and empty.


Pic 3 - The About Kile dialogue box. Kile version.


2. Create a new *.tex file.

From the menu bar, click File > New. See Pic 4.

In the New File - Kile dialogue box, select:
i - Document Type: LaTeX Document
ii - Template: Empty File
iii - Click the OK button.
See Pic 5.

That is how a new *.tex file looks once created, see Pic 6.

Pic 4 - Creating a new *.tex file. Menu bar.


Pic 5 - Creating a new *.tex file. The New File - Kile dialogue box.


Pic 6 - A newly created *.tex file.


3. Copy the "complete example code" from here:
http://tex.stackexchange.com/a/226367

... and paste it into the newly created *.tex file.


4. Save the *.tex file.

From the menu bar, click File > Save As... . See Pic 7.

In the Save File - Kile dialogue box:
i - Give the *.tex file a location (Places), and
ii - a Name.
iii - Then click the Save button.
See Pic 8.

If you try to build the code without saving it first, Kile will prompt you to save the *.tex file:
[PDFLaTeX] Please save the untitled document first.
... and a Save File - Kile dialogue box will appear. See Pic 9.

Pic 7 - Saving the *.tex file for the first time. Menu bar.



Pic 8 - Saving the *.tex file for the first time. The Save File - Kile dialogue box.


Pic 9 - Prompt arising from building before the first save.


5. Build using your preferred engine. I used PDFLaTeX.

From the menu bar, click Build > Compile > PDFLaTeX. See Pic 10.

Pic 10 - Building the code using PDFLaTeX.


6. The following will take place:
i - this error will appear in the Log and Messages window, see Pic 11:
/usr/share/texlive/texmf-dist/tex/generic/babel/babel.sty:329:Package babel Error: You haven't specified a language option ...ry to proceed from here, type x to quit.}

ii - the babel.sty file will appear. See Pic 12.

iii - these will appear in the Output window: (you'll need to do some scrolling to find them)

(a) See Pic 13.
! Package babel Error: Unknown option `latin'. Either you misspelled it
(babel)                or the language definition file latin.ldf was not found.

(b) See Pic 14.
! Package babel Error: You haven't specified a language option.

The Log and Messages window and Output window are at the bottom of the Kile window. See Pic 6.

Pic 11 - Kile. Log and Messages.


Pic 12 - Kile. babel.sty.


Pic 13 - Kile. Output. (a)


Pic 14 - Kile. Output. (b)


7. The errors in Step 6 stems from this line of code in the *.tex file:
\usepackage[latin]{babel}

There is nothing wrong with this code. It's just that a required LaTeX package is missing.


8. I'm not sure if Kile:
- has an auto-update-after-installing-packages-while-Kile-is-running feature, or
- has an update-after-installing-packages-while-Kile-is-running button, or
- needs to be closed before installing any packages.

From the old days of using Windows *ahem*, i chose to terminate Kile before proceeding to Part B.



Part B: How to solve:

9. Run Ubuntu Software Center. See Pic 15.

That is how Ubuntu Software Center looks once loaded, see Pic 16.

Pic 15 - Starting Ubuntu Software Center.


Pic 16 - The Ubuntu Software Center.


Pic 17 - The About Ubuntu Software Center dialogue box. Ubuntu Software Center version.


10. Finding the package.

In the search field, type-in:
latex babel latin

The filtered packages will be auto-listed. See Pic 18.

Pic 18 - Ubuntu Software Center. Searching for the package.


11. Installing the package.

i - Select the package named, see Pic 18:
TeX Live: Other European languages
texlive-lang-european

ii - Either:

(a) - Click the More Info button to read the package description, then click the Install button. See Pic 19. Or,

(b) - Click the Install button to install straight-away. See Pic 18.


iii - The Authenticate dialogue box will appear. Key-in your Password, then click the Authenticate button. See Pic 20.

That is how your package looks once installed. See Pic 21.

Now Ubuntu Software Center can be closed.

Pic 19 - Ubuntu Software Center. The package description. Before installing.


Pic 20 - The Authenticate dialogue box.


Pic 21 - Ubuntu Software Center. The package description. After installing.


12. Run Kile. See Step 1.

I don't know how yours is setup. Mine loads the last document(s) that were open before Kile was closed.

If it doesn't load the code you saved in Step 4, from the menu bar, click File > Open Recent > then find your file in the list of recent files.

If your file is not in the list of recent files, from the menu bar, click File > Open... . In the Open Files - Kile dialogue box, locate your file then click the Open button.


13. Like in Step 5, build the code.

The error should be gone by now. See Pic 22.

Pic 22 - No more errors.



Part C: For the curious minds:

(a) The screenshot of the produced PDF, with the Step 7 code present (code was uncommented), is shown in Pic 23.

The screenshot of the produced PDF, with the Step 7 code absent (code was commented), is shown in Pic 24.


(b) The same document can be built using the XeLaTeX engine and the polyglossia package:

i - comment the Step 7 code. See Pic 25.

ii - add these lines in the preamble, see Pic 25:
(credit: http://tex.stackexchange.com/a/67962)
\usepackage{polyglossia}
\setmainlanguage{latin}

iii - then build the code using XeLaTeX. See Pic 26.

The screenshot of the produced PDF is shown in Pic 27.


Screenshots in Pic 23, Pic 24, and Pic 27:
- were taken at 60% zoom,
- shows the first page of the PDF, which is the table of contents (ToC).

Pic 23 - Screenshot of the produced PDF, with the Step 7 code present (code uncommented).


Pic 24 - Screenshot of the produced PDF, with the Step 7 code absent (code commented).


Pic 25 - Setting-up the code.


Pic 26 - Building the code using XeLaTeX.


Pic 27 - Screenshot of the produced PDF, with the code in Pic 25 present.



Alhamdulillah.