:shipit: Ядро для верстки билетов к экзаменам в LaTeX
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
provision
.gitignore обновляет .gitignore Jan 16, 2018
LICENSE обновляет ридми Oct 10, 2017
README.md добавляет шилды в readme May 20, 2018
core.tex добавляет новое целевое устройство [microprint] Jan 14, 2018
custom.tex добавляет макрос суммы для рядов Mar 6, 2018
init.sh правит косяк с генерацией заглушек билетов Jan 16, 2018
packages.tex добавляет упущенный пакет латеха Nov 16, 2017
structs.tex добавляет автосброс нумерации уравнений при новой секции Nov 15, 2017
trello.js улучшает скрипт импорта в Trello May 20, 2018

README.md

GitHub issues GitHub license

Ядро для вёрстки билетов к экзаменам в LaTeX

Обратная совместимость не гарантируется, поэтому если какой-то проект использует более старую версию, то лучше её и использовать

Инструкция по применению

Допустим, что предстоит экзамен по вычислительной математике. Нужно:

  1. создать директорию для нового проекта (например ~/Uni/calc)

  2. поместить в неё файл со списком билетов (например tickets.txt), где каждый билет начинается с новой строки (+ пустая строка в конце файла)

  3. клонировать в эту директорию само ядро с помощью git clone https://github.com/taxnuke/collocore.git

  4. для инициализации проекта выполнить ./collocore/init.sh <путь к списку билетов>

  5. для перегонки билетов в карточки списка Trello выполнить ./collocore/trello.js --file <путь к списку билетов> --key <ключ_API_Trello> --token <токен_API_Trello> --list <ID_списка_Trello> [-n] (ключ -n для автоматической нумерации карточек)

Устройство collocore, назначение директорий, файлы подключения библиотек и тд.

Файл Роль
core.tex самый главный файл, совершает все импорты и вызовы
packages.tex подключает всякие зависимости, окружения LaTeX
custom.tex для кастомных макросов, логики ядра и блоков текста
structs.tex форматы нумерации и всё, что определяет структуру документа
provision "провизия" для автоматической генерации новых проектов
init.sh скрипт создания нового проекта для использования с collocore
trello.js скрипт создания карточек для билетов в Trello

Конфигурирование

Чтобы всё работало, у проекта, который это ядро использует, должен быть файл config.tex. Примерное содержание данного файла:

config.tex

В примере выше указаны 8 билетов, они автоматически подтянутся из дирекотрии src/tickets по соответствующим именам файлов, а также конфигурация, в которой нужно рендерить проект, в текущей версии поддерживаются Apple Watch, лист формата А4, средний экран телефона, режим отладки с большим полем для аннотаций, и микропечать.

Почему "Collocore"?

Потому что изначально было создано для подготовки к однотипным коллоквиумам по высшей математике.