Викиверситет

Программирование Викиданных/LaTeX и kaobook

< Программирование Викиданных

LaTeX и kaobook: становимся авторами книги

Факультет компьютерных технологий
Иконка программы Pywikibot

Программирование Викиданных

Главы (2021):

Алгоритм работы (для авторов):

LaTeX

править

Вы сообщили преподавателю свой логин на GitHub и вас добавили в команду редакторов проекта wd_book.

  1. Установите на свой компьютер LaTeX.
  2. Скачайте себе рабочую версию GitHub проекта wd_book.
  3. Если вы хотите, чтобы в этой версии книги среди авторов было ваше имя, то откройте файл проекта ./ru/wd_book_ru.tex и напишите свои имя и фамилию в строке, начинающейся со слов "\author" в алфавитном порядке, но после фамилии "Крижановский". Преподаватель идёт первый в списке. Имя нужно ввести два раза: для отображения на второй и третьей странице PDF-файла. Если не хотите, то можете не указывать своё имя. Во введении будет указано, что в книге использованы материалы, разработанные вместе со студентами ПетрГУ в рамках курса Интернет-математика.
  4. Посмотрите описание дизайна книги Tufte, разработанного Эдвард Тафти. Такой дизайн будет у русской версии нашего учебника «Программирование Викиданных для школьников и студентов».

Ваш рабочий файл

править
  1. Найдите в папке проекта wd_book/ru/chapter свой файл. Он называется также, как и исследуемый вами объект на английском языке.

Называние главы

править
  1. В своём файле в строке \chapter{Название главы} напишите название своей главы. Названия должны соответствовать сути статьи, интриговать и привлекать читателя.
  2. Во второй строке (\label{ch:chapter-title}) вместо chapter-title укажите метку, чтобы можно было ссылаться на эту главу. Можете использовать название своего объекта на английском языке.
  3. Для называния главы вы можете использовать то название, которое было придумано студентами ранее при создании LaTeX-версии статьи на сайте Authorea. Конечно, с учётом того материала, который вы добавили или добавите в статью.
  4. Ссылка на статью на сайте Authorea находится в вашей вики-статье в разделе "Ссылки".

Введение (аннотация) для главы

править
  1. Напишите в своём файле LaTeX аннотацию к тому тексту, который есть на вашей странице в Викиверситете. См. w:Википедия:Преамбула.
  2. В качестве аннотации вы также можете использовать аннотацию своей статьи в Authorea, написанную предыдущими студентами. С учётом нового материала, добавленного вами в статью Викиверситета.

Процедура загрузки нового материала на GitHub

править
  w.wiki/4THm

Процедура совместной работы с проектами на GitHub такова:

  1. Если есть обновления на ГитХаб, забрать их, то есть вы должны работать с актуальной версией.
  2. Написать новый текст или внести изменения в старый текст.
  3. Убедиться, что ваш новый текст компилируется без ошибок.
  4. Проверить, что новых записей на GitHub'е не появилось, тогда загрузить свои изменения на GitHub. Если же данные были обновлены другим участником проекта, то перейти к первому шагу.

kaobook

править

Для английской версии мы будем использовать шаблон fmarotta / kaobook. К следующему занятию каждый читает одну главу из книги main_with_bibtex.pdf и рассказывает другим в виде небольшого доклада. Распределяем главы:

  • Крижановский Андрей Анатольевич — введение,
  • Максименко Леонид Михайлович — 2. Class Options, Commands and Environments (какие пакеты есть и зачем они нужны)
  • Савинов Евгений Дмитриевич — 3. Margin Stuff (это самое интересное в этом шаблоне)
  • Хомякова Ольга Владимировна — 4. Figures and Tables (эти особенности мы постараемся максимально использовать)
  • Паренченков Евгений Олегович — 5. References (думаем, на какую литературу было бы уместно сослаться в своих текстах)
  • Зинченко Татьяна Алексеевна — 6. Page Design (незаметное, но важное).
  • Федоренко Екатерина Алексеевна — 7. Mathematics and Boxes (придумайте, можем ли мы использовать эти математические излишества для оформления своих статей?)
  • Коробкова Елена Юрьевна — A (не kaobook). Рассказать о конструкциях \wdq, \wdqName, \wdProperty, \num{}, \wwiki, \ruwiki. Показать примеры использования этих конструкций на примере своей главы в книге. См. Статья в LaTeX на русском#Оформление и исходный текст нашей книги в LaTeX.
  • ? — B (не kaobook). Рассказывать не надо. Надо перенести недостающие конструкции из русского в английский LaTeX (см. предыдущий пункт). Уже есть \wdq, \wdqName в файле styles/packages.sty. Показать как их (перенесённые конструкции) использовать в своей главе (то есть включить в свою главу эти конструкции и показать, что получается).

Желательно не читать, а рассказывать. Можно будет сделать sharing своего экрана, показывать PDF-файл и рассказывать.

Дополнительное задание: n:User:AKA MBG/newstask — написать новость по научной тематике в Русских Викиновостях.

Источник — https://ru.wikiversity.org/w/index.php?title=Программирование_Викиданных/LaTeX_и_kaobook&oldid=157539