diff options
author | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
commit | e0c6872cf40896c7be36b11dcc744620f10adf1d (patch) | |
tree | 60335e10d2f4354b0674ec22d7b53f0f8abee672 /language/georgian/doc |
Initial commit
Diffstat (limited to 'language/georgian/doc')
-rw-r--r-- | language/georgian/doc/latex/georgian/georgianencodings-en.pdf | bin | 0 -> 2731277 bytes | |||
-rw-r--r-- | language/georgian/doc/latex/georgian/georgianencodings-ka.pdf | bin | 0 -> 2769455 bytes | |||
-rw-r--r-- | language/georgian/doc/latex/georgian/geotex-en.pdf | bin | 0 -> 217716 bytes | |||
-rw-r--r-- | language/georgian/doc/latex/georgian/geotex-en.tex | 189 | ||||
-rw-r--r-- | language/georgian/doc/latex/georgian/geotex-ka.pdf | bin | 0 -> 142187 bytes | |||
-rw-r--r-- | language/georgian/doc/latex/georgian/geotex-ka.tex | 169 |
6 files changed, 358 insertions, 0 deletions
diff --git a/language/georgian/doc/latex/georgian/georgianencodings-en.pdf b/language/georgian/doc/latex/georgian/georgianencodings-en.pdf Binary files differnew file mode 100644 index 0000000000..a5645f2cce --- /dev/null +++ b/language/georgian/doc/latex/georgian/georgianencodings-en.pdf diff --git a/language/georgian/doc/latex/georgian/georgianencodings-ka.pdf b/language/georgian/doc/latex/georgian/georgianencodings-ka.pdf Binary files differnew file mode 100644 index 0000000000..0950e369b8 --- /dev/null +++ b/language/georgian/doc/latex/georgian/georgianencodings-ka.pdf diff --git a/language/georgian/doc/latex/georgian/geotex-en.pdf b/language/georgian/doc/latex/georgian/geotex-en.pdf Binary files differnew file mode 100644 index 0000000000..7567e9dfcd --- /dev/null +++ b/language/georgian/doc/latex/georgian/geotex-en.pdf diff --git a/language/georgian/doc/latex/georgian/geotex-en.tex b/language/georgian/doc/latex/georgian/geotex-en.tex new file mode 100644 index 0000000000..f3b0198e1e --- /dev/null +++ b/language/georgian/doc/latex/georgian/geotex-en.tex @@ -0,0 +1,189 @@ +\documentclass[a4paper,9pt]{article} +\usepackage[T2A,T8K,T8M,T1]{fontenc} +\usepackage[utf8]{inputenc} +\usepackage{amsmath} +\usepackage[georgian,russian,english]{babel} +\usepackage[plainpages=false,bookmarksopen,pdfpagelabels,bookmarksnumbered,unicode=true,hyperindex=true,pagebackref=true]{hyperref} +\makeatletter +\newcommand{\venc}[1]{ +\renewcommand\verbatim@font{% +\usefont{#1}{cmtt}{m}{n}\relax\selectfont}% +} +\makeatother +\begin{document} + \sloppy + \title{{Geo}\TeX{}\--- Georgian Language in \TeX{}} + % repeat info for each author. + \author{Levan Shoshiashvili\\ + \small Dept. of Electronics and Electrical Engineering\\[-0.8ex] + \small Faculty of Natural Science\\[-0.8ex] + \small Ivane Javakhishvili Tbilisi State University,\\[-0.8ex] + \small I. Chavchavadze ave.N3 , Tbilisi, Georgia\\[-0.8ex] + \small \textsf{shoshia@hotmail.com}\\ + } + \date{10 May 2015} + %\netaddress{levan.shoshiashvili (at) tsu.ge} + %\personalURL{http://lshoshia.science.tsu.ge} + + \maketitle + \tableofcontents + \begin{abstract} + In this document use of Georgian language package for \TeX{}/\LaTeX{} + is described. + \end{abstract} + \section{Installation} + For package installation \TeX{} distribution must be installed. This can be + {MikTeX} or {TeXLive} Windows OS and TeXLive for Linux/Unix and MacOSX + systems. It is not necessary, but it is better to have + local \TeX{} directory. For Linux/Unix systems you can use + \verb|$HOME/texmf| + See your \TeX{} distribution documentation for more detailes. + \subsection{Using MikTeX} + \begin{itemize} + \item Install MikTeX \verb|http://miktex.org| . + \item Since April 2015 MikTex includes packages: "georgian-babel" and + "georgian". Install them Using MikTex package manager. + \end{itemize} + \subsection{Using TexLive} + \begin{itemize} + \item Create local \TeX{} directory. + \item Download GeoTeX \verb|http://tex.tsu.ge| and install it in local \TeX + \end{itemize} + \subsection{Automatic hyphenation} + Automatic hyphenation works. \verb| hyph-utf8| is already included in TexLive. + For MikTex download \verb| hyph-utf8| and install it in localtemf tree. + Copy 'languages.ini' file to MikTex's config directory. Do update formats + from MikTex's settings manager ('User' and 'Admin' modes ). + After this system must know about Georgian hyphenation. + \section{The First Steps} + After package installation user can write documents in Georgian. For this can + be used any + plain text editor, but there are \LaTeX{} suitable Integrated Developing + Environment (IDE) + Editors , such as + Texmaker \url{www.xm1math.net/texmaker}, TexStudio Texmaker + \url{http://texstudio.sourceforge.net}, TeXnicCenter + \url{http://www.texniccenter.org}, + WinEdt Texmaker \url{http://www.winedt.com}. + + Note, that Georgian input text must be in utf-8 encoding. + + There are three basic classes in \LaTeX{} : Article , Report , book. + Minimal document has a following form: + \begin{verbatim} + \documentclass[a4paper]{article} + \usepackage[T1,T2A,T8K,T8M]{fontenc} %use English, + %Russian, Georgian fonts + \usepackage[utf8]{inputenc} %Text Encoding + \usepackage[english,russian,georgian]{babel} %Document's + %language is Georgian + \begin{document} + Document text + \end{document} + \end{verbatim} + For languages based on Georgian script (Megruli,Laz,Chan,Svan), which use + umlauts and accents we can use \TeX functions. Fox example:\\ + { \Georgian + \'{ა} \.{ა} \H{ა} \`{ა} \"{ა} \^{ა} \d{ა} \~{ა} \u{ა} \={ა} \v{ა} \t{აბ} \\ + } + Because of Georgian script don't fit in one encoding, two encodings T8M and + T8K-Asomtavruli-Mkhedruli and Khucuri-Mkhedruli are + introduced\footnote{see . kaencodings.pdf for detailes}.If we turn on + \emph{\bfseries amsmath} package, + We can have following text: + {\Georgian + $\bar{\text{ა}} $, + $\overset{\text{ა}}{\text{ბ}} \text{უ}^{\text{ბ}}$.\\ + } + The \emph{{\bfseries babel }} package knows about Georgian and the most + therms are translated. \emph{{\bfseries babel }} loads T8K , and then T8M + encoding definition files. This means, that main encoding of the document will + be + T8M (Asomtavruli-Mkhedruli). If user needs to have basic encoding T8K + (Nusxkhuri-Mkhedruli), than in document's preamble must have + \begin{verbatim} + \usepackage[english,georgian]{babel} + \usepackage[T8M,T8K]{fontenc} + \end{verbatim} + In such document text can be in Nuskhuri-Mkhedruli script without any + additional + command and for Asomtavruli script user needs: + {\Georgian \mrglovani + \begin{verbatim} + \mrglovani + მაგალითად + {\mrglovani ასომთავრული ტექსტი ႠႱႭႫႧႠႥႰႳႪႨ } + \end{verbatim} + } + {which gives: \mrglovani ႠႱႭႫႧႠႥႰႳႪႨ } + \\ + If document's encoding is T8M, than before Nuskha-Khucuri script we need: + {\Georgian + \venc{T8K} + \begin{verbatim} + {\khucuri ხუცური ტექსტი ⴞⴓⴚⴓⴐⴈ ⴒⴄⴕⴑⴒⴈ} + \end{verbatim} + } + Which gives: {\Georgian \khucuri ⴞⴓⴚⴓⴐⴈ ⴒⴄⴕⴑⴒⴈ} + + This is necessary, because Nuskhuri and Asomtavruli are defined in different + encodings. + \section{Text indexing} + \TeX{} uses $makeidx$ and it works for Georgian scripts, but output + file is in \TeX's internal representation(in therms of macro commands) not in + utf-8 and hard + to read. For UNICODE texts is the best suited \emph{xindy} package and + works for + Georgian scripts, but it is not + available for \emph{MikTeX} distribution. But we can use + \emph{index} and \emph{idxlayout} packages to have nice output. + Add in the preamble: + {\Georgian + \begin{verbatim} + \usepackage{index} + \usepackage[columns=3,totoc=true]{idxlayout} + \newcommand{\Index}[1]{\index{#1}#1} + \makeindex + \renewindex{default}{idx}{ind}{საძიებელი} + \end{verbatim} + } + In this way we can index words in the document on following way + {\Georgian \verb|Index{სიტყვა}| }.To add index page in the document one can + use \verb|\printindex}| in place of desired output of index page. But this is not + enough. After indexing + document do: + \begin{verbatim} + makeindex.exe "filename".idx + \end{verbatim} + $filename.idx$ is created after Build command User can also pass the style file + (for example. $latex.ist$) + and after this we need to rebuild document again. + \section{Nomenclature (Definition of therms and symbols)} + Add in the preamble: + {\Georgian + \begin{verbatim} + \usepackage{nomencl} + \makenomenclature + \renewcommand\nomname{აღნიშვნები} + \end{verbatim} + } + After file compilation do + \begin{verbatim} + makeindex <filename>.nlo -s nomencl.ist -o <filename>.nls + \end{verbatim} + and rebuild file again. Of course there need to be \verb|\printnomenclature| in + the document, where you need nomenclature to be printed. + \section{Fonts} + T8M and T8K encoded fonts are based on: DejaVu fonts + \url{http://dejavu-fonts.org} + and other avialable Georgian free fonts and can be distributed freely. + \section{License Information} + This package may be distributed and/or modified under the + conditions of the LaTeX Project Public License, either version 1.3c + of this license or (at your option) any later version. + \section{Additional information} + For source of this document and other questions you might have to use + Georgian + in \LaTeX{} pleas visit Geo\TeX{} site + \url{http://tex.tsu.ge} +\end{document} diff --git a/language/georgian/doc/latex/georgian/geotex-ka.pdf b/language/georgian/doc/latex/georgian/geotex-ka.pdf Binary files differnew file mode 100644 index 0000000000..8fe6d874e5 --- /dev/null +++ b/language/georgian/doc/latex/georgian/geotex-ka.pdf diff --git a/language/georgian/doc/latex/georgian/geotex-ka.tex b/language/georgian/doc/latex/georgian/geotex-ka.tex new file mode 100644 index 0000000000..1de559b32f --- /dev/null +++ b/language/georgian/doc/latex/georgian/geotex-ka.tex @@ -0,0 +1,169 @@ +\documentclass[a4paper,9pt]{article} +\usepackage[T1,T2A,T8K,T8M]{fontenc} +\usepackage[utf8]{inputenc} +\usepackage{amsmath} +\usepackage[english,russian,georgian]{babel} +\usepackage{index} +\usepackage[plainpages=false,bookmarksopen,pdfpagelabels,bookmarksnumbered,unicode=true,hyperindex=true,pagebackref=true]{hyperref} +\begin{document} +\sloppy +\title{Geo\TeX{} ქართული ენა \TeX{} სისტემაში} +% repeat info for each author. +\author{ლევან შოშიაშვილი\\ +\small ელექტრული და ელექტრონული ინჟინერიის დეპარტამენტი\\[-0.8ex] +\small ზუსტ და საბუნებისმეტყველო მეცნიერებათა ფაკულტეტი\\[-0.8ex] +\small ივ. ჯავახიშვილის თბილისის სახ. უნივერსიტეტი,\\[-0.8ex] +\small ჭავჭავაძის გამზ.\textnumero3 , თბილისი, საქართველო\\[-0.8ex] +\small \textsf{shoshia@hotmail.com}\\ +} +\date{10 May 2015} +%\netaddress{levan.shoshiashvili (at) tsu.ge} +%\personalURL{http://lshoshia.science.tsu.ge} + +\maketitle +\tableofcontents +\begin{abstract} +ამ დოკუმენტში განხილულია ქართული ენის პაკეტის გამართვა და გამოყენება \TeX{} \LaTeX{} +სისტემისთვის +\end{abstract} +\section{გამართვა} +სანამ პაკეტს გავმართავთ საჭიროა რომ \TeX{} ბაზური პაკეტი მაინც უნდა იყოს გამართული მანქანაზე +და მუშაობდეს. ეს შეიძლება იყოს MikTeX ან TeXLive Windows ოპერატიული +სისტემისათვის ან + TeXLive Linux/Unix MacOSX სისტემებისთვის. ასევე სასურველია გვქონდეს ლოკალური \TeX{} + დირექტორია. Linux/Unix სისტემებისთვის ეს შეიძლება იყოს \verb|$HOME/texmf| ან თუ გსურთ + სისტემისთვის გამართვა იხ. თქვენი \TeX{} დისტრიბუტივის დოკუმენტაცია. + \subsection{MikTeX} +\begin{itemize} +\item გადმოიტვირთეთ და გამართეთ MikTeX \verb|http://miktex.org| . + \item 2015 აპრილიდან MikTex არის პაკეტები: "georgian-babel" და + "georgian". გამართეთ MikTex პაკეტმენეჯერის გამოყენებით. +\end{itemize} +%\item შეასრულეთ "Refresh FNDB" ოღონდ +%$$Start\rightarrow Program Files \rightarrow Miktex 2.9\rightarrow +%Maintenance Admin\rightarrow Settings$$ გამოყენებით + + \subsection{TexLive} +გადაიტვირთეთ და გამართეთ პაკეტრი \url{http://tex.tsu.ge} საიტიდან +ან ტეხ არქივის საიტიდან („georgian“ და „babel-georgian“) +\subsection{ავტომატური დამარცვლა და გადატანა} + TexLive ავტომატური დამრცვლა გადატანის პაკეტი ქართულის მხარდაჭერით + უკვე არის დისტრიბუტივში და გამართვა არ სჭირდება. + MikTeX სისტემისთვის გადაიტვირთეთ და გამართეთ +\verb| hyph-utf8|. MikTeX გამართულ დირექტორიაში მოძებნეთ და +გადააწერეთ language.ini ფაილი. + +ამის შემდეგ გააკეთეთ „Update formats“. MikTeX პარამეტრების მენეჯერიდან +(ადმინისტრატორ და მომხმარებლის მოდებში) +ან +კონსოლზე \verb|initexmf --dump|. + +ამის შემდეგ სისტემას უნდა შეეძლოს ქართულის ავტომატურად დამარცვლა და გადატანა. +\section{პირველი ნაბიჯები} +მას შემდეგ რაც პაკეტი გამართულია შესაძლებელია ქართულად დოკუმენტების შექმნა. +ამისთვის შეიძლება გამოიყენოთ ნებისმიერი ტექსტური რედაქტორი, მაგრამ არსებობენ +\TeX{} სისტემისთვის სპეციალური რედაქტორები: Texmaker \verb|www.xm1math.net/texmaker/|, TexStudio \verb|texstudio.sourceforge.net|, texniccenter \verb|http://www.texniccenter.org/|, +winedt \verb|http://www.winedt.com/|. \footnote{ეს დოკუმენტი დამზადებულია TexStudio ედიტორში.} +შესატანი ქართული ტექსტი უნდა იყოს უნიკოდ (utf-8) კოდირებაში. + +\LaTeX{} აქვს 3 ბაზური კლასი: Article (სტატია), Report (ანგარიში), book (წიგნი). +მინიმალურ დოკუმენტს აქვს შემდეგი სახე: +\begin{verbatim} +\documentclass[a4paper]{article} +\usepackage[T1,T2A,T8K,T8M]{fontenc} %ვიყენებთ ინგლისურ, + %რუსულ და ქართულ ფონტებს +\usepackage[utf8]{inputenc} %ტექსტის კოდირება +\usepackage[english,russian,georgian]{babel} %დოკუმენტის + %ძირითადი ენაა ქართული +\begin{document} +დოკუმენტის ტექსტი... +\end{document} +\end{verbatim} +ქართულ ანბანზე ბაზირებული სხვა სკრიპტებისთვის (მეგრულ,ლაზურ,ჭანური,სვანური) რომლებსაც სჭირდებათ უმლაუტები შესაძლებელია \TeX ფუნქციების გამოყენებით აქცენტების მიღება ქართულის შემთხვევაშიც. მაგალითად:\\ +\'{ა} \.{ა} \H{ა} \`{ა} \"{ა} \^{ა} \d{ა} \~{ა} \u{ა} \={ა} \v{ა} \t{აბ} \\ +ტეხის მოთხოვნებიდან გამომდინარე და იმის გამო რომ ქართული სრულად ვერ აისახება 1 ფონტში საჭირო შეიქმნა T8 კოდირების 2 ვარიანტი T8M და +T8K-ასომთავრული-მხედრული და ხუცური-მხედრული \footnote{დაწვრილებით ამ კოდირების შესახებ იხ. kaencodings.tex}.თუ ჩავრთავთ amsmat პაკეტის, +მაშIნ შეგვიძლია გვქონდეს შემდეგი სახის ტექსტი: $\bar{\text{ა}} $, +$\overset{\text{ა}}{\text{ბ}} \text{უ}^{\text{ბ}}$.\\ +ლატეხის \emph{{\bfseries babel }} პაკეტში დამატებულია ქართული ენა და თარგმნილია ტერმინები. \emph{{\bfseries babel }} ავტომატურად ტვირთავს ჯერ T8K , ხოლო შემდეგ T8M კოდირებას რაც ნიშნავს რომ დოკუმენტის ძირითადი კოდირება იქნება T8M (ასომთავრულ-მხედრული). თუ თქვენ გსურთ რომ ძირითადი კოდირება იყოს T8K მაშინ დოკუმენტის პრეამბულაში აძლევთ ბრძანებას +\begin{verbatim} +\usepackage[english,georgian]{babel} +\usepackage[T8M,T8K]{fontenc} +\end{verbatim} +ასეთ დოკუმენტში აიკრიფება მხედრულ-ხუცური ტექსტი გადართვის გარეშე, ხოლო ასომთავრული ტექსტის წინ საჭიროა +ბრძანება +{\mrglovani +\begin{verbatim} +\mrglovani +მაგალითად +{\mrglovani ასომთავრული ტექსტი } +\end{verbatim} +} +{რაც მოგვცემს: \mrglovani ႠႱႭႫႧႠႥႰႳႪႨ } +\\ +თუკი ძირითადი კოდირება არის T8M მაშინ ხუცური ტექსტის წინ საჭიროა + +\begin{verbatim} +{\khucuri ხუცური ტექსტი} +\end{verbatim} +რაც მოგვცემს: {\khucuri ⴞⴓⴚⴓⴐⴈ ⴒⴄⴕⴑⴒⴈ} + +ეს გამოწვეულია იმით რომ მიმდინარე კოდირება შეიძლება იყოს მხოლოდ ერთი და ხუცური და ასომთავრული (მრგლოვანი) განმარტებულია სხვადასხვა კოდირებებში. +\section{საძიებელი\--ტექსტის ინდექსირება} +\TeX{} ბაზური პაკეტი $makeidx$ მუშაობს ქართული ტქსტებისათვის, მაგრამ +გამოსავალი ფაილი არის ე.წ. ტეხის შენაგან წარმოდგენაში, ანუ მაკროსების ენაზე +და არა utf-8 ტექსტური ფაილი. უნიკოდ ტექსტებისთვის (და ქართულისთვისაც ცხადია) +იდეალურად მუშაობს ინდექსატორი xindy, რომელსაც აქვს დამატებული ქართულის +მხარდაჭერა. მაგრამ ეს პაკეტი არ არსებობს Wondows OS გავრცელებულ MikTeX + დისტრიბუტივში. მაგრამ აქაც შესაძლებელია ინდექსირების გამოყენება index პაკეტის + საშუალებით. + + დოკუმენტის პრეამბულაში ჩაამატეთ + \begin{verbatim} +\usepackage{index} +\usepackage[columns=3,totoc=true]{idxlayout} +\newcommand{\Index}[1]{\index{#1}#1} +\makeindex +\renewindex{default}{idx}{ind}{საძიებელი} + \end{verbatim} + ეს საშუალებას მოგვცემს გვქონდეს საძიებელი დოკუმენტში და ინდექსირებულ იქნას + საჭირო სიტყვები როგორც \verb|Index{სიტყვა}|. ხოლო საძიებლის დოკუმენტში ჩასამატებლად + ვიყენებთ ბრძანებას \verb|\printindex}| იმ ადგილას სადაც გვსურს საძიებლის ჩვენება. + + მაგრამ ეს არაა საკმარისი. მას შემდეგ რაც ინდექსატორი გააკეთებს ინდექსირებას(Build ბრძანება + TeXstudio შემთხვევაში) საძიებლის შესაქმნელად საჭიროა გაიცეს ბრძანება (კონსოლზე ან ვამატებთ TeXstudio ბრძანებებში) + \begin{verbatim} + makeindex.exe "failissaxeli".idx + \end{verbatim} + ეს $failissaxeli.idx$ უკვე შექმნილია Build ბრძანების შემდეგ. ასევე + შეიძლება ბრძანებაში მიეწოდოს ინდექსის სტილი (მაგ. $latex.ist$) +ამის შემდეგ კი საჭიროა კიდევ ერთხელ გავუშვათ ფაილი კომპილაციაზე. +\section{ნომენკლატურა (ტერმინების და სიმბოლოების განმარტება)} + დოკუმენტის პრეამბულაში ჩაამატეთ + \begin{verbatim} +\usepackage{nomencl} +\makenomenclature +\renewcommand\nomname{აღნიშვნები} + \end{verbatim} + ფაილის კომპილაციაზე გაშვების შემდეგ + \begin{verbatim} + makeindex <filename>.nlo -s nomencl.ist -o <filename>.nls + \end{verbatim} + და შემდეგ ისევ გაუშვით ფაილი კომპილაციაზე. ცხადია დოკუმენტში უნდა + იყოს ბრძანება \verb|\printnomenclature| სადაც გსურთ რომ აღნიშვნების ცხრილი + დაიბეჭდოს დოკუმენტში. + \section{ფონტები} + T8M და T8K კოდირების ფონტები ეფუძნება DejaVu ფონტებს + \url{http://dejavu-fonts.org} +და სხვა თავისუფლად გავრცელებად ქართულ ფონტებს. + \section{ლიცენზია} +პაკეტი ვრცელდება „LaTeX Project Public License, either version 1.3c“ +ან უფრო ახალი ვერსიის ლიცენზიით. +\section{დამატებითი ინფორმაცია} +\LaTeX{} სისტემა მრავალფეროვანი ფართოდ გამოყენებადი +სისტემაა როოგრც ტექნიკურ\--საბუნებისმეტყველო ასევე +ჰუმანიტარულ მეცნიერებებში. \LaTeX{} შესწავლის საუკეთესო +გზა მისი გამოყენებაა. ამ დოკუმენტის წყარო და სხვა \LaTeX{} +მაგალითები შეგიძლიათ იხილოთ Geo\TeX{} საიტზე +\url{http://tex.tsu.ge} +\end{document} |