Идеология и Agenda

Призыв

Добро пожаловать на страничку курса по LaTeX! Чувствуй себя как дома.

Нашёл на этой страничке ошибку? Нашёл какой-то ультраполезный ресурс? Придумал какое-то интересное задание для семинара? Есть конструктивная критика? Не молчи, напиши мне об этом на почту filfonul@gmail.com, в Telegram (@Ppilif) или Вконтакте.

Идеология курса

Курс идёт 8 недель. Работаем в XeLaTeX. Пробуем делать это в полуинтерактивном режиме. На парах часто будем пытаться заставить что-нибудь заработать на своих компах. Поэтому их лучше приносить с собой.

Agenda

  1. Обо всём и ни о чём! LaTeX большой и цельный. Немного мотивации. О разных движках (PdfTex, XeTeX и т.д.). Математика и картинки.
  2. Связка R + LaTeX — что может быть круче? Оформляем расчёты правильно. Попутно решаем проблему тысячелетия: что было раньше, курица или яйцо?
  3. Что такое юникод, немного подробнее про шрифты. Снова про таблицы. Немного рукоблудия: В LaTeX прямо из Exel и в LaTeX прямо из Wolfram. Безумно красивая графика в Tikz. Великая и могучая Geogebra.
  4. Оформление документа в целом. Преамбула для души. Продаём душу и вместе пишем письмо в Хогвартс.
  5. Делаем автоматический список литературы, углубляемся в преамбулу. Пишем свои собственные, свежие, команды. Слушаем скучные роскозни про ГОСТ.
  6. R + LaTeX. Как создать много одинаковых документов одним нажатием кнопки. История про киллера и деда мороза.
  7. Презентации в LaTeX — большая боль или чувство стиля? Оформляем код в пакете Minted. Немного смотрим на Atom. Немного говорим про Markdown.
  8. То, что нигде не рассказывают, а знать надо. За первый семинар изучаем командную строку и запускаем код считаться в своём собственном облаке. За второй семинар понимаем как работает git и заводим свой первый репозиторий.

Команда курса

Поддержкой курса занимается бравая команда из четырёх человек. Если у вас есть проблемы, вопросы, слава, деньги, женщины, пишите любому из них:

Филя Ульянкин Vk.com Telegram
Костя Рыбак Vk.com Telegram
Саша Тишин Vk.com Telegram
Ахмед Зарманбетов Vk.com  


Наши преамбулы

Логи семинаров 2019 (весна)

Посиделка 8: Всякие мелочи

Туториалы:

Посиделка 7: R+LaTeX продолжаем разговор! (28 марта)

Посиделка 6: Преамбула по ГОСТ, презентации

Посиделка 5: Библиография, свои личные команды

Посиделка 4: графика в LaTeX, преамбула для души (7 марта)

Посиделка 3: шрифты, документ в целом (28 февраля)

Посиделка 2: R+LaTeX (21 февраля)

Посиделка 1: обо всём и ни о чём, о математике (14 февраля)

Важно: если overleaf выдаёт ошибку, нажмите слева сверху кнопку menu и поменяйте там pdflatex на xelatex.

Логи семинаров 2018

Посиделка 7: Всякие мелочи (5 апреля)

Посиделка 6: R+LaTeX продолжаем разговор! (29 марта)

Посиделка 5: Презентации, R+LaTeX (начало) (22 марта)

Посиделка 4: Список литературы, преамбула по ГОСТ и для души (15 марта)

Посиделка 3: Оформление документа в целом, свои команды и макросы(1 марта)

Посиделка 2: Шрифты, картинки, таблицы, графика (22 февраля)

Посиделка 1: обо всём и ни о чём, о математике (15 февраля)

Доска околопочёта

Тут подборка годно сделанных домашек! Если вы хотите, чтобы ваша домашка оказалась здесь либо была отсюда удалена, напишите мне в личку.

Домашки за 2019 год

Домашки за 2018 год

Тексты заданий: Задание 1, Задание 2, Задание 3, Задание 4, Задание 5, Задание 6, Задание 7

Домашки за 2017 год

Тексты заданий: Задание 1, Задание 2, Задание 3, Задание 4, Задание 5, Задание 6

Книги и виньетки

Неплохие книги о LaTeX

Замечание ко всем книжкам! Следует использовать кодировку utf-8 для файлов. Если в книге есть строчка

\usepackage[cp1251]{inputenc}

то её нужно заменить на

\usepackage[utf8]{inputenc}

Полезные и не очень виньетки

Полезные ссылки

Свои вопросы по LaTeX лучше всего задать на tex.stackexchange.com

  • Онлайн редактор Overleaf

Другие курсы по LaTeX

Если очень лень ходить на пары, то можно посмотреть документы и презентации в LaTeX от ВШЭ. Это введение в LaTeX от Высшей Школы Экономики на русском языке.

Установка связки LaTeX-R-Rstudio

В течение курса мы будем использовать довольно большое количество различных программ. Основными будут LaTeX и R. Тут можно найти подробную инструкцию по их установке. LaTeX должен быть установлен у всех на компьютерах уже на первой неделе курса!

Раздел про установку писался с помощью СтRаницы пRо R Демешева Б.Б. На ней можно найти много дополнительной информации про R.

Windows

  • При установке целесообразно отключить антивирус.
  • Проверьте, что имя пользователя набрано английскими буквами. Если имя пользователя набрано кириллицей (например, “Иван”), то пользователя необходимо переименовать (например, “Ivan”). Из-за русских букв в имени пользователя будут возникать ошибки. Лучше сразу же их избежать.
  • То же самое относится к используемым папкам и именам файлов. Русских названий лучше избегать.
  • Установите Texlive. Имейте в виду, что это займёт довольно много времени. Иногда на Windows установка спустя несколько часов прерывается. Некоторые пробуют снова и снова и с пятой попытки у них всё удаётся, однако есть другой путь.

Вместо Texlive можно вполне установить конкурирующий дистрибутив Miktex. Фишка этого дистрибутива в том, что его можно поставить без пакетов. Все необходимые пакеты будут скачиваться к вам на компьютер при первом использовании. Установка займёт несколько минут. Обратите внимание, что плохой не LaTeX, а Windows. На других операционных системах таких сложностей не возникает.

Mac

Linux (Ubuntu)

  • Установите Texlive и Texstudio. Для этого нажмите Ctrl+Alt+T и пропишите в консоли

     sudo apt-get install texlive-full texstudio
    

Немного подождите. LaTeX на вашем компе. Вы восхитительны!

  • Установите R sudo apt-get install r-base
  • Установите RStudio
  • Примечания:
    • Если у вас имеются проблемы с установкой пакетов, то, скорее всего, вам не хватает “подгружателя”. Проблему, скорее всего, вылечат команды: sudo apt-get install gfortran и sudo apt-get install libcurl4-openssl-dev libssl-dev.
    • Если у вас возникли проблемы с установкой самого нового R в ubuntu 16.04 LTS, то прочтите туториал, который их решит.

Настройка XeLaTeX и сборка первого файла!

Чтобы собрать в LaTeX свой первый документ, нужно проделать следующие действия:

  • Этот пункт только дл windows: В опциях выбираем “Настроить Texstudio” и меняем во вкладке Editor кодировку c windows-1251 на utf-8.

  • Создайте новый файл, сохраните его в отдельную папку и скопируйте в него содержимое файла Hello, world.

  • Внимательно просмотрите то, что вы скопировали и нажмите на зелёную кнопочку с двумя стрелочками, которая запустит сборку нашего файла.

  • Попробуйте поэкспериментировать со сменой шрифтов! Найдите шрифт своей мечты! Если что-то не работает и google вам не помогает, то пишите мне куда угодно!

О разных дистрибутивах и редакторах.

Можно немножечко по-разному распространять одну и ту же программу. Её разные сборки называются дистрибутивами. Существует огромная куча разных дистрибутивов, распространяющих LaTeX. Тут собрана основная информация об основных дистрибутивах для любопытных.

Texlive

Texlive - это флагман среди дистрибутивов LaTeX. Распространяется группой свободных разработчиков TeX Users Group. Регулярно обновляется. Содержит в себе практически всё, что необходимо для работы. В том или ином виде может быть поставлен на любую из трёх основных операционных систем.

MikTeX

Дистрибутив поддерживается только в Windows. Является свободным программным обеспечением. Использует свою программу управления пакетами, которая умеет загружать не установленные, но указанные в документе пакеты. Тем не менее, лучше сразу установить все доступные пакеты, чтобы потом при компиляции не ждать, когда они загрузятся.

MacTeX

Дистрибутив для MacOS. В качестве основы в дистрибутиве используется TeX Live. Кроме системы пакетирования, ориентированной на мак, дистрибутив отличается от TeX Live тем, что с ним в комплекте идут несколько дополнительных программ.

Редакторы

Кроме самого дистрибутива для полноценной работы необходим текстовой редактор. В течение курса мы будем работать в Texstudio. Если вам нравится какой-то другой редактор, то вы можете работать в нём. В конце курса мы попробуем на вкус ультрановомодный Atom, который подходит для редактирования … всего.

Эй, ковбой! Ты уже установил оседлал LaTeX, у тебя всё работает и тебе уже сейчас не терпится устроить жаркое родео с Atom? Тогда вперёд в следующий раздел! Не промахнись, ковбой.

Установка Atom

Atom - это бесплатный открытый текстовый редактор, созданый ребятами с Github, на котором вы читаете эту страничку. Atom подходит для редактирования абсолютно всего. Единственное, что от вас требуется, установить парочку пакетов. Для начала посмотрите видео от создателей Atom. Для этого нажмите на картиночку ниже :)

git_video

Установка Atom и работа с ним

  • Скачайте Atom и установите его. Ничего нестандартного.
  • После запуска Atom откроется приветственный гайд. Его можно открыть при любом запуске через вкладку Help.
  • Пришло время научиться запускать LaTeX. Откроем в нём уже знакомый нам стартовый файл Hello, world.

Настройка LaTeX на Atom

  • Что мы видим? Во-первых, нет подсветки синтаксиса, как в Texmakere. Строки очень неудобно уходят за рамки экрана. И как вообще собирать pdf?

  • Тыкаем Install a Package. Находим пакет для подсветки кода language-latex. Выглядит симпатично. Жмём Install.

  • Как только закончится установка, открываем меню с настройками. Выбираем всё так, как хочет ваша душа. Отлично! У нашего кода появились красивости. Рекомендую поставить галочку у Soft Wrap, это решит проблему с пробиванием строками границы экрана. Точно также можно поставить галочку у Soft Wrap во вкладке Editor. Это решит проблему с пробиванием границы экрана для абсолютно всех программ, которые вы будете открывать в Atom, а не только для LaTeX. Там же можно переместить или вообще отключить подозрительную черту. Она используется в Atom как красная строка в школьных тетрадях. Вы сами ставите её где хотите, чтобы не писать код за её границей.

  • Находим пакет latex - самый главный пакет, который отвечает за компиляцию и связь с Texlive. Устанавливаем его. Переходим в настройки. В Engine выбираем в качестве движка xelatex. Ставим галочку под Enable Shell Escape.

Во вкладке Opener выбираем pdf-view. Видим несколько жизненно-важных сочетаний клавиш. ctrl-alt-b заставляет файл скомпилироваться, ctrl-alt-c удаляет всякий хлам. Если интересно, то читаем инструкцию.

  • Устанавливаем пакет pdf-view. Он позволяет открывать pdf прямо в Atom.
  • Во вкладке Themes можно подобрать тему по вкусу.

Все готово для запуска. Жмём ctrl-alt-b либо тыкаем наверху Packages, выбираем среди них LaTeX и жмём build.

  • На линукс все работает, на винде с вероятностью 0.5. Но это вообще меня не удивляет…

Настройка Markdown в Atom

  • Для настройки маркдаун надо установить пакеты markdown-pdf, который позволяет компилировать из маркдаунской разметки pdf-файл, markdown-preview-plus, который помогает делать предпросмотр markdown файла. В настройках ставим галочку у Use GitHub.com style, если очень хочется.
  • Создаём новый документ с расширением .md, открываем его в Atom. Жмём сверху Packages/Markdown preview/Toggle Preview. Справа открывается предпросмотр. Набираем что-нибудь и видим как это выглядит в итоговом файле.
  • Жмём Packages/Markdown to PDF/Convert. Получаем Pdfку.

Другие полезные пакеты

Atom очень гибкая штука, для которой существует довольно большое количество пакетов. Можно ставить их через менюшку, а можно через консоль, прописывая apm install packagename.

  • atom-beautify - подсветка для разных других языков программирования
  • file-icons - пакет благодаря которому появляются красивые иконки для разных файлов
  • minimap - классная штука, которая открывает карту документа около этого документа
  • language-knitr - подсветка для R+LaTeX
  • language-python - подсветка для питоновского кода

На сайте Atom можно посмотреть какие пакеты были популярны на этой неделе.

Благодарности и лицензия

Спасибо за помощь в создании этого курса Шилину Кириллу Юрьевичу, Демешеву Борису Борисовичу, Александру Тишину, Рыбаку Константину, Зарманбетову Ахмеду, Соловью Владу и Осипову Семёну!

Созданные для данного курса материалы распространяются по лицензии Do What The Fuck You Want To Public License (WTFPL)