natgillin/translations-raw huggingface dataset:
When you fill out the filename box, you have to include a relative path from where the. kilepr project file is stored to the file.
Під час заповнення поля Назва файла вам слід вказати відносний шлях з теки, у якій зберігається файл проекту. kilepr до вашого файла.
The Files and Projects View
Перегляд файла і проекту
The Files and Projects view is a button of the sidebar menu. From this view, you can see the structure of your project, its files, and the name of the. kilepr file that stores the project information. Adding, removing, or changing options in your project is done via the Files and Projects view.
Вікно перегляду Файл і проект можна відкрити за допомогою кнопки меню бічної панелі. У цьому вікні ви зможете переглянути структуру вашого проекту, файли, що містяться у проекті та назву файла. kilepr, у якому зберігається інформація щодо проекту. За допомогою вікна перегляду Файли та проекти виконуються дії з додавання, вилучення файлів та зміни параметрів вашого проекту.
Adding and Removing Files
Додавання і вилучення файлів
To add a file to your project, open any & tex; file, right click on its name in the Files and Projects view, and select Add to Project. If you have multiple projects open, a dialog box will ask you which project the file has to be added to.
Щоб додати файл до вашого проекту, відкрийте будь- який файл & tex;, наведіть вказівник миші на позначку його назви у вікні перегляду Файли і проекти, клацніть правою кнопкою миші і скористайтеся пунктом Додати до проекту. Якщо у редакторі відкрито декілька проектів, програма відкриє діалогове вікно за допомогою якого ви зможете вказати проект, до якого слід додати файл.
If you have multiple files to be added to a project, you can select the project from the Files and Projects view and right-click then select Add Files...; you will then be able to select your files in a dialog box.
Якщо вам потрібно додати до проекту декілька файлів, ви можете навести вказівник миші на пункт проекту у вікні перегляду Файли та проекти, клацнути правою кнопкою миші і скористатися пунктом контекстного меню Додати файли..., — програма відкриє діалогове вікно, за допомогою якого ви зможете обрати потрібні файли.
Adding a file to a project
Додавання файла до проекту
To remove a file from a project, right-click on it and select Remove File. This does not delete your file (and also does not close it), but only removes it from the list of files contained in the. kilepr extension.
Щоб вилучити файл з проекту, наведіть на його позначку вказівник миші, клацніть правою кнопкою і оберіть у контекстному меню пункт Вилучити файл. Вилучення файла з проекту не призведе до вилучення відповідного файла з диска (і не закриє вікна його редагування), — ця дія лише вилучить файл зі списку файлів, назви яких зберігаються у файлі з суфіксом. kilepr.
Project Options
Параметри проектів
& kile; has a few options related to your project that can be set. To change them, right-click on the title of your project and select Project Options, and you will have the option of changing:
У & kile; передбачено декілька параметрів вашого проекту, які ви можете встановити. Щоб змінити ці параметри, наведіть вказівник миші на позначку назви вашого проекту, клацніть правою кнопкою миші і оберіть у контекстному меню пункт Параметри проекту. Ви отримаєте доступ до зміни таких параметрів проекту:
The title of your project.
Назву вашого проекту.
The Master document.
Головний документ.
The Quickbuild command.
Команду швидкого збирання.
The & makeidx; options.
Параметри & makeidx;.
Archiving your Project
Архівування вашого проекту
& kile; allows you to easily backup your project by storing all its files into a single archive (often known as tarball). To archive your project right-click on its name in the Files and Projects view, or select Build Other Archive.
У & kile; передбачено можливість простого створення резервної копії вашого проекту шляхом архівування всіх його файлів у окремому архіві. Щоб виконати архівування вашого проекту наведіть вказівник миші на позначку його назви у вікні Файли і проект і клацніть правою кнопкою миші або скористайтеся пунктом меню Збирання Інше Архівувати.
By default, all files in a project are added to the archive. If you do not want to include a certain file in the archive, right-click on it in the Files and Projects view, and uncheck the Include in Archive option.
Типово, до архіву включаються всі файли проекту. Якщо ви не бажаєте включати певний файл до архіву, наведіть вказівник миші на його позначку у перегляді Файли і проект, клацніть правою кнопкою миші і зніміть позначку з пункту Додати в архів.
Archive commands are simple shell commands that are executed from the project folder (where the. kilepr file is located).
Команди архівування — це прості команди командної оболонки, які виконуються у теці проекту (теці, у якій зберігається файл. kilepr).
Closing a Project
Як закрити проект
To close a project, select the Files and Projects view from the vertical toolbar, right click on your project title, and then select Close. This will close your project, all the files associated with your project, and will also add the name of the project you just closed to Open Recent Project... in the Project menu.
Щоб закрити проект, відкрийте вікно Файли та проекти на бічній панелі, наведіть вказівник миші на позначку з назвою проекту, клацніть правою кнопкою миші і оберіть у контекстному меню пункт Закрити. Програма закриє ваш проект, всі пов’ язані з ним файли, а також додасть назву проекту, який ви щойно закрили, до списку підменю Відкрити недавній проект... меню Проект.
Document Encoding
Кодування документа
The & kile; editor allows you to read, convert and set the text to the encoding your document needs. This allows you to use non-standard letters and symbols; you can use, for example, accented characters for Italian or French. Selecting the encoding for your document can be done in three ways:
За допомогою редактора & kile; ви можете читати файли у різних кодуваннях, перетворювати кодування і встановлювати його. Таким чином, ви можете скористатися нестандартними літерами і символами. Ви, наприклад, зможете використовувати акцентовані літери італійської та французької, кирилицю тощо. Обрати кодування вашого документа можна у три способи:
One way to set the encoding is to use the Set encoding combo box, located at the bottom of the Open File sidebar view.
Одним зі способів визначення кодування є використання спадного списку Встановити кодування, розташованого у нижній частині бічної панелі Відкрити файл.
Another way is using the submenu Settings Configure Kile... Editor, where you can set the default character encoding for all files.
Іншим способом є використання сторінки Параметри Налаштувати Kile... Редактор. На цій сторінці ви можете вказати типове кодування символів для всіх файлів, з якими ви працюєте.
Set the default character encoding
Встановлення типового кодування символів
A third way to set the encoding for a document is to set the option when you use the wizard to create a new document.
Третім способом встановлення кодування є вибір кодування під час створення документа за допомогою майстра.
& latex; itself understands only ASCII, a very limited set of characters, so you could not use accented or special letters directly. To use accented letters, a special syntax was created: such as for example \\"e for ë. There is a package to help you with this, called inputenc, and is included in the preamble using \\usepackage[latin1]{inputenc}, where the optional argument is the encoding you would like to use (nowadays in most cases utf8x). This tells & latex; to translate all of the ë's you wrote to \\"e's before compiling. Please refer to the inputenc documents directly for more information on inputenc. Last but not least: remember to make sure that your file is actually encoded in the same encoding you told inputenc!
Сам & latex; розуміє лише ASCII, дуже обмежений набір символів, отже використовувати акцентовані та спеціальні символи напряму неможливо. Щоб ввести акцентовану літеру, слід скористатися особливою синтаксичною конструкцією: такою, як, наприклад,\\ "e для отримання літери ë. Існує пакунок, який допоможе вам вирішити цю проблему. Цей пакунок називається inputenc, його слід включити у преамбулі за допомогою команди\\ usepackage[ utf8] {inputenc}, необов’ язковим параметром якої є назва кодування, яким ви бажаєте скористатися (зараз здебільшого користуються кодуванням utf8x). Таким чином ви повідомите & latex; про те, що слід перетворити всі введені вами ë на\\" e перед збиранням документа. Будь ласка, ознайомтеся з документацією пакунка inputenc, щоб дізнатися більше про inputenc. Ну і, нарешті, не забудьте переконатися, що ваш файл справді має те саме кодування, про яке ви повідомили за допомогою рядка inputenc!
Choosing the source file's encoding
Вибір кодування файла джерела
This host of different character coding tables has been creating problems on many applications: for example, you cannot write a course of Turkish in French without losing one language's special characters. There is general agreement that, sooner or later, everybody will switch to Unicode. There are many implementations of Unicode, and UTF-8 is the most successful in & Linux;; & Windows; reg; relies instead on the more cumbersome and less flexible UCS-2. Some distributions, as RedHat, have already begun setting their default encoding to UTF-8, and therefore you may be very interested in using of the utf8x argument to the inputenc package.
Існування різних таблиць кодування створює проблеми у багатьох програмах: наприклад, ви, звичайно ж, не зможете писати одночасно українською і французькою без втрати спеціальних символів однієї з мов. Всі погоджуються з тим, що рано чи пізно відбудеться перехід на Unicode. Існує багато реалізацій Unicode: UTF- 8 найширше використовується у Linux; у Windowsreg; використовується складніший і менш гнучкий варіант UCS- 2. У деяких з дистрибутивів, зокрема RedHat, типовим кодуванням вже є UTF- 8, тому бажано використовувати параметр utf8x під час включення пакунка inputenc.
The & ucs; Package
Пакунок & ucs;
If you do n't have the & ucs; package installed, you can proceed as follows:
Якщо у вашій системі ще не встановлено пакунок & ucs;, ви можете його встановити, виконавши таку послідовність дій:
Get the & ucs; package from the home page of Unicode support for & latex;, by Dominique Unruh from the University of Karlsruhe.
Звантажте пакунок & ucs; з домашньої сторінки проекту Підтримка Unicode у & latex;, автора проекту Dominique Unruh з Університету Карлсруе.
To install it, unpack the downloaded file and place it in a folder listed in your $TEXINPUTS envirnoment variable. This can also be set inside kile.
Щоб встановити потрібні файли, розпакуйте звантажений архів до каталогу, який згадується у вашій змінній середовища $TEXINPUTS. Вказати значення цієї змінної можна напряму з kile.
If you are using XeLaTeX you can simply load the xltxtra package. It will load all required packages.
Якщо ви користуєтеся XeLaTeX, вам достатньо завантажити пакунок xltxtra. За допомогою цього пакунка буде завантажено всі інші потрібні пакунки.
& cjk; Support
Підтримка & cjk;
Adding support for ideographic languages is quite tricky. However, once you are done with it, it will work quite well. Other than installing packages, there is some extra configuration work to do.
Додавання підтримки ідеографічних мов є досить складною справою. Але після того, як ви виконаєте потрібні дії, все працюватиме як треба. Окрім встановлення відповідних пакунків, доведеться виконати і певну роботу з налаштування системи.
Your & Linux; distribution might already have a & cjk; (Chinese, Japanese, Korean) package ready for you, so you might be saved the hassle of manually installing everything. Do check before going forward!
У вашому дистрибутиві Linux, можливо, вже встановлено пакунок & cjk; (Chinese, Japanese, Korean), отже вам не доведеться нічого встановлювати вручну. Перевірте, чи встановлено цей пакунок, перш ніж виконувати будь- які з наведених нижче настанов!
There is the possibility of using the & ucs; package in order to write short snippets of & cjk; text, but that option is seriously limited as it does not handle, among other things, newlines. We will instead install the complete & cjk; -latex; package and make it work for both & latex; and & pdflatex;. A lot of this material has been inspired by Pai H. Chou's page about how to setup & pdflatex;.
Для створення коротких фрагментів ієрогліфічних текстів ви можете скористатися пакунком & ucs;, але цей варіант має серйозні обмеження, оскільки за його використання є неможливим розрив рядків. Ми розповімо як встановити повноцінний пакунок & cjk; - latex;, який працюватиме у & latex; і & pdflatex;. Більшість порад запозичено зі сторінки Pai H. Chou, присвяченої налаштуванню & pdflatex;.
Download the cjk; package. Copy its unpacked files to an appropriate subfolder of $TEXMF, just like you did with the & ucs; package before (see). The files will be unpacked in a CJK/ X_Y. Z folder, it is not important that you take them out, though it will probably be tidier for you to maintain.
Звантажте пакунок cjk;. Скопіюйте розпаковані файли до відповідної підтеки $TEXMF, подібно до копіювання файлів пакунка & ucs;, про яке ми розповідали раніше (див.). Файли буде розпаковано до теки CJK/ X_ Y. Z, їх не обов’ язково звідти виймати, зробіть все так, щоб вам зручніше було підтримувати відповідний пакунок у належному стані.
Now you have to download a font that supports all the & cjk; characters you need. You can choose any *. ttf file that covers them, but in this walkthrough we will use Cyberbit. Unzip the file and rename Cyberbit. ttf to cyberbit. ttf, since uppercase might confuse your system.
Тепер вам слід звантажити шрифт, у якому передбачено підтримку всіх потрібних вам символів & cjk;. Ви можете скористатися будь- яким файлом *. ttf, у якому є відповідні символи, але у нашому прикладі ми скористаємося шрифтом Cyberbit. Розпакуйте архів і перейменуйте файл Cyberbit. ttf на cyberbit. ttf, оскільки використання верхнього регістру може спричинити проблеми під час роботи.
Place cyberbit. ttf in a folder together with Unicode. sfd, and generate the *. tfm and *. enc files with the command $ttf2tfm cyberbit. ttf -w cyberbit@Unicode@. For some reasons, sometimes this does not produce the hundreds of files it should. Should that be your case, you can download both *. tfm and *. enc files.
Скопіюйте cyberbit. ttf до певної теки разом з файлом Unicode. sfd, а потім створіть файли *. tfm і *. enc за допомогою команди $ttf2tfm cyberbit. ttf - w cyberbit@ Unicode @. З певних причин іноді виконання цієї команди не створює, як це має бути, сотень файлів. Якщо так сталося, ви можете звантажити відповідні файли *. tfm і *. enc.
Place the *. tfm files in an appropriate folder, say $TEXMF / fonts/ tfm/ bitstream/ cyberbit/; the *. enc files may be installed in $TEXMF / pdftex/ enc/ cyberbit/.
Скопіюйте файли *. tfm до відповідної теки, наприклад, $TEXMF / fonts/ tfm/ bitstream/ cyberbit /; файли *. enc слід встановити до теки $TEXMF / pdftex/ enc/ cyberbit /.
Now we need a map file to connect the *. enc files to the font. Download cyberbit. map and install it in $TEXMF / pdftex/ config/.
Тепер нам потрібен файл карти (map), щоб пов’ язати файли *. enc з шрифтом. Звантажте файл cyberbit. map, а потім скопіюйте його до теки $TEXMF / pdftex/ config /.
Download another file, c70cyberbit. fd, and place it in an appropriate folder. You may choose, for example, $TEXMF / tex/ misc/.
Звантажте ще один файл, c70cyberbit. fd, і скопіюйте його до відповідної теки. Ви, наприклад, можете обрати теку $TEXMF / tex/ misc /.
The last file we have to generate is a & PostScript; Type 1 font, necessary to read & DVI; files generated with & latex;. Run the command $ttf2pfb cyberbit. ttf -o cyberbit. pfb, and copy the resulting cyberbit. pfb in a folder like $TEXMF / fonts/ type1/ cyberbit/.
Останнім з файлів, які нам слід створити є файл шрифту Type 1 & PostScript;, потрібний для читання файлів DVI, створених за допомогою & latex;. Виконайте команду $ttf2pfb cyberbit. ttf - o cyberbit. pfb і скопіюйте отриманий файл cyberbit. pfb до теки на зразок $TEXMF / fonts/ type1/ cyberbit /.
Let's now place cyberbit. ttf among the fonts where & latex; can find it. You could place it in a folder named $TEXMF / fonts/ truetype/.
Тепер давайте розташуємо cyberbit. ttf серед шрифтів так, щоб & latex; міг його знайти. Ви, наприклад, можете скопіювати цей файл до теки з назвою $TEXMF / fonts/ truetype /.
Check the configuration file you find at $TEXMF / web2c/ texmf. cnf, and make sure that the line mentioning TTFONTS is uncommented and points to the folder where you saved cyberbit. ttf.
Відкрийте файл налаштування, який ви знайдете за адресою $TEXMF / web2c/ texmf. cnf, і переконайтеся, що рядок зі словом TTFONTS не закоментовано і що у цьому рядку записано теку, куди ви скопіювали cyberbit. ttf.
To make it possible for & pdflatex; to use your & cjk; fonts, it is necessary that you add a line in configuration file $TEXMF / pdftex/ config/ pdftex. cfg. Add map +cyberbit. map in the file to complete the configuration for & pdflatex;.
Щоб уможливити використання & pdflatex; ваших шрифтів & cjk;, потрібно додати відповідний рядок до файла налаштувань $TEXMF / pdftex/ config/ pdftex. cfg. Допишіть у цей файл map +cyberbit. map, щоб завершити налаштування для & pdflatex;.
To configure & latex; so that you can produce & DVI; files with & cjk; characters, you have to add a line in file ttfonts. map. The file might be in a folder named $TEXMF / ttf2pk/, but you will probably have to look for it. Add the line cyberbit@Unicode@ cyberbit. ttf into it.
Щоб налаштувати & latex; так, щоб він міг створювати файли DVI з символами & cjk;, вам слід додати певний рядок до файла ttfonts. map. Цей файл має зберігатися у теці з назвою $TEXMF / ttf2pk /, але, якщо його там немає, ви можете пошукати деінде. Додайте рядок cyberbit@ Unicode @ cyberbit. ttf у цей файл.
Now, you only have to run texhash and the system should be ready.
Тепер вам достатньо виконати команду texhash — і система готова до роботи.
To test whether your configuration is correct, you can try to compile this test file.
Щоб перевірити чи правильно налаштовано систему, спробуйте скомпілювати цей тестовий файл.
& cjk; Troubleshooting
Настанови з усування проблем з & cjk;
There are many things that can go wrong when setting & cjk; support manually. If something seems not to work, the following checklist might help you.
Існує багато причин, з яких встановлення підтримки & cjk; вручну може не спрацювати. Якщо щось не працює, спробуйте перевірити систему за такими критеріями за наведеним нижче списком.
Obviously, since you run & latex; as a user and not as root, you must allow ordinary users to access the new files. Make sure all folders and files are accessible using the chmod command.
Очевидно, оскільки ви запускаєте & latex; від імені користувача, а не адміністратора (root), вам слід дозволити звичайним користувачам доступ до нових файлів. Забезпечте доступність всіх тек і файлів за допомогою команди chmod.
If & latex; writes a & DVI; without problems, but you cannot view it, it is almost certainly because of some problems in the automatic generation of *. pk fonts. They are supposed to be generated on the fly when viewing a & DVI; file, but this might fail for a number of reasons: double-check ttfonts. map for your custom line first. However, it might happen that your ttf2pk command, which is usually invoked by the & DVI; viewer, has been compiled without support for the kpathsea libraries. If this is the case, ttf2pk --version will make no mention of kpathsea. As support for these libraries is necessary, you might have to find a new package, or recompile FreeType 1 by yourself.
Якщо & latex; створює DVI без проблем, але переглянути файл ви не можете, ймовірно, причиною цього є певні проблеми зі створенням файлів шрифтів *. pk. Ці файли має бути створено на льоту під час спроби перегляду файла DVI, але спроба створення може зазнати невдачі з декількох причин: ретельно перевірте, чи наявний доданий вами рядок у ttfonts. map. Але, може так статися, що вашу програму ttf2pk, яку, зазвичай, викликає інструмент перегляду DVI, було зібрано без підтримки бібліотек kpathsea. Якщо це так, у виводі команди ttf2pk -- version не буде згадок про kpathsea. Оскільки підтримка відповідних бібліотек є необхідною, вам доведеться знайти новий пакунок або перезібрати FreeType 1 власноруч.
How do I input & cjk; in Unicode?
Як мені ввести ієрогліфи у Unicode?
There are a number of different input engines, and the choice can depend also on personal preference. The author uses Skim, a port to & kde; of the Scim engine. Refer to your distribution's documentation to learn how to install these programs. Configuration of such programs can be tricky too, in the case of Skim you will have to define an environment variable XMODIFIERS ="@im=SCIM "before starting X.
Існує багато різних рушіїв вводу, вибір рушія є справою смаку. Автор цього підручника користується Skim, портом рушія Scim для & kde;. Зверніться до документації з вашого дистрибутива, щоб дізнатися більше про те, як встановити ці програми. Налаштування програм може бути також непростою справою. У випадку Skim вам доведеться визначити змінну середовища XMODIFIERS = "@ im=SCIM" до запуску сервера X.
Scripting
Запис сценаріїв
Scripting in & kile;
Написання скриптів для & kile;
& kile; 's scripting feature allows for the execution of ECMAScript code. Scripts can be managed through the scripting panel in the sidebar.
У & kile; передбачено можливість виконання кодів ECMAScript. Керувати скриптами можна за допомогою підпанелі роботи зі скриптами, розташованої на бічній панелі.
API Reference
Довідка з програмного інтерфейсу
In this section we describe & kile; 's scripting programming interface.
У цьому розділі ми опишемо інтерфейс роботи зі скриптами & kile;.
Please note that the scripting API has not been finalized yet. The API described below might change in future versions of & kile;.
Будь ласка, зауважте, що програмний інтерфейс написання скриптів ще не узгоджено остаточно. Інтерфейс, описаний нижче може змінитися у наступних версіях & kile;.
First of all, & kile; 's script execution environment provides a global object called "kile", which owns the following methods:
Перш за все, у середовищі виконання скриптів & kile; передбачено загальний об’ єкт з назвою « kile », для якого передбачено такі методи:
Returns a KileTextDocument object which reflects the currently active text document. Returns null if no text document is active.
Повертає об’ єкт KileTextDocument, який відповідає поточному активному документу у вікні редактора. Повертає null, якщо активного документа немає.
(kile). getInputValue( caption, label)
(kile). getInputValue (заголовок, мітка)
Opens a dialog with the given caption and label. Returns the value that user has entered.
Відкриває діалогове вікно з вказаним заголовком і міткою. Повертає значення, введене користувачем.
Objects of the type KileTextDocument represent text documents in & kile;. They have the following properties:
Об’ єкти типу KileTextDocument відповідають текстовим документам у & kile;. Ці об’ єкти мають такі властивості:
Deletes the character that is located immediately before the current cursor position and moves the cursor one position backward in the text.
Вилучає символ, який було розташовано одразу перед поточною позицією курсора і пересуває курсор на одну позицію текстом.
Moves the cursor one position backward in the text.
Пересуває курсор на одну позицію назад текстом.
Moves the cursor one position forward in the text.
Пересуває курсор на одну позицію вперед текстом.
(KileTextDocument). insertText( text)
(KileTextDocument). insertText (текст)
Inserts the text contained in the variable text into the document at the current cursor location.
Вставляє текст, що міститься у змінній text до документа у поточну позицію курсора.
Inserts a bullet into the document at the current cursor position.
Вставляє у документ позначку на поточній позиції курсора.
Selects the first bullet located in the document immediately after the current cursor location.
Виділяє першу ж позначку, розташовану у документі після поточної позиції курсора.