Сборка пакетов-расширений для TeXLive — различия между версиями

Материал из Rosalab Wiki
Перейти к: навигация, поиск
(+ note about .abf.yml)
(+ note about scripts folder)
 
(не показаны 3 промежуточные версии этого же участника)
Строка 39: Строка 39:
 
  BuildArch: noarch
 
  BuildArch: noarch
  
(если пакет является архитектурно-зависимым, то rpmbuild его не соберет с соответсующей ошибкой - тогда BuildArch надо убрать).
+
(если пакет является архитектурно-зависимым, то rpmbuild его не соберет с соответствующей ошибкой - тогда BuildArch надо убрать).
  
 
Всем texlive-пакетам необходимо прописать сборочную зависимость (BuildRequires) от {{Pkg|texlive-tlpkg}}. Этот же пакет
 
Всем texlive-пакетам необходимо прописать сборочную зависимость (BuildRequires) от {{Pkg|texlive-tlpkg}}. Этот же пакет
Строка 51: Строка 51:
 
секция '''%build''' отсутствует, а '''%install''' сводится к копированию директорий, содержащихся внутри архивов (за исключением директории {{File|tlpkg}}), в {{File| %{buildroot}%{_texmfdistdir} }} (которую надо предварительно создать):
 
секция '''%build''' отсутствует, а '''%install''' сводится к копированию директорий, содержащихся внутри архивов (за исключением директории {{File|tlpkg}}), в {{File| %{buildroot}%{_texmfdistdir} }} (которую надо предварительно создать):
  
s %install
+
%install
 
  mkdir -p %{buildroot}%{_texmfdistdir}
 
  mkdir -p %{buildroot}%{_texmfdistdir}
 
  cp -fpar fonts tex doc source %{buildroot}%{_texmfdistdir}
 
  cp -fpar fonts tex doc source %{buildroot}%{_texmfdistdir}
Строка 76: Строка 76:
 
== Пакеты со скриптами ==
 
== Пакеты со скриптами ==
 
Для некоторых модулей по ссылке http://ctan.altspu.ru/systems/texlive/tlnet/archive/
 
Для некоторых модулей по ссылке http://ctan.altspu.ru/systems/texlive/tlnet/archive/
доступен не только архив с исходным кодом, но и дополнительные пакеты под разные ОС и архитектуры.
+
доступен не только архив с исходным кодом, но и дополнительные пакеты под разные ОС и архитектуры. Для некоторых модулей таких пакетов нет, однако внутри архива с исходным кодом лежит папка {{File|scripts}}.
Для таких модулей помимо описанных выше дейтсвий надо произвести дополнительные манипуляции,
+
Для всех таких модулей помимо описанных выше действий надо произвести дополнительные манипуляции,
 
добавив файлы, присутсвующие в ОС-специфичных пакетах. Как правило, эти манипуляции
 
добавив файлы, присутсвующие в ОС-специфичных пакетах. Как правило, эти манипуляции
 
сводятся к созданию символьных ссылок на скрипты в местах, где в ОС располагаются файлы для запуска
 
сводятся к созданию символьных ссылок на скрипты в местах, где в ОС располагаются файлы для запуска
Строка 93: Строка 93:
 
  ...
 
  ...
  
Скачаем a2ping.x86_64-linux.tar.xz и заглянем внутрь - там помимо служебной директории tlpgk мы увидим директорию bin, внутри нее директорию x86_64-linux, а там - символьную ссылку a2ping:
+
Скачаем a2ping.x86_64-linux.tar.xz и заглянем внутрь - там помимо служебной директории {{File|tlpgk}} мы увидим директорию {{File|bin}}, внутри нее директорию {{File|x86_64-linux}}, а там - символьную ссылку {{File|a2ping}}:
  
 
<pre>
 
<pre>
$ tar xf a2ping.x86_64-linux.tar.xz.
+
$ tar xf a2ping.x86_64-linux.tar.xz
 
$ ls -l bin/x86_64-linux/
 
$ ls -l bin/x86_64-linux/
 
total 0
 
total 0
Строка 104: Строка 104:
 
Как видим, ссылается она на скрипт ../../texmf-dist/scripts/a2ping/a2ping.pl
 
Как видим, ссылается она на скрипт ../../texmf-dist/scripts/a2ping/a2ping.pl
  
Сам скрипт находится в архиве с исходным кодом (a2ping.tar.xz), в директории texmf-dist. При сборке пакета, мы должны положить содержимое texmf-dist в директорию. %{buildroot}%{_texmfdistdir}, а в директории %{buildroot}%{_bindir} создать соответсвующую символьную ссылку:
+
Сам скрипт находится в архиве с исходным кодом (a2ping.tar.xz), в директории {{File|texmf-dist}}. При сборке пакета, мы должны положить содержимое texmf-dist в директорию %{buildroot}%{_texmfdistdir}, а в директории %{buildroot}%{_bindir} создать соответсвующую символьную ссылку:
  
 
<pre>
 
<pre>

Текущая версия на 00:55, 20 декабря 2022

TeX - система компьютерной вёрстки, широко используемая по всему миру.

В Linux в настоящее время активно используется реализация от проекта texlive, которая включает в себя не просто основные инстурменты верстки, но и множество дополнений и расширений (дополнительных шрифтов, пакетов с поддержкой разлицных языков, шаблонов диссертаций и презентаций и так далее).

В РОСЕ каждое такое дополнение оформляется как отдельный RPM-пакет.

Рассмотрим процесс упаковки расширения с названием TEXPKG в пакет texlive-<TEXPKG>

Сначала проверяем, что страничка пакета доступна по адресу http://www.ctan.org/tex-archive/macros/latex/contrib/<TEXPKG>. Эта ссылка должна быть прописана в URL spec-файла. Со странички проекта берем Summary (не более 80 симполов), лицензию (тэг License) и описание (для секции %description). Если есть версия - берем ее со странички, если нет - используем в качестве версии дату, когда вы скачали исходники, в формате ГГГГММДД (например, 20191231).

Далее ищем в директории http://mirrors.ctan.org/systems/texlive/tlnet/archive/ файл <TEXPKG>.tar.xz. Там же могут находиться файлы <TEXPKG>.doc.tar.xz и <TEXPKG>.source.tar.xz - если есть, их тоже берем.

Их надо прописать в качестве Sources:

Source0:        http://mirrors.ctan.org/systems/texlive/tlnet/archive/<TEXPKG>.tar.xz
Source1:        http://mirrors.ctan.org/systems/texlive/tlnet/archive/<TEXPKG>.doc.tar.xz
Source2:        http://mirrors.ctan.org/systems/texlive/tlnet/archive/<TEXPKG>.source.tar.xz

Все эти файлы необходимо скачать и загрузить на http://file-store.rosalinux.ru/. Для аутентификации необходимо использовать те же логин и пароль, что и на ABF. Для каждого файла File Store сгенерирует хэш, который необходимо прописать в гите в файле .abf.yml, например как в https://abf.io/import/texlive-accents/blob/rosa2019.1/.abf.yml

Внутри ахивов обязательно есть папки tlpkg/tlpobj - в них лежат файлы с информацией о пакете. Если вдруг на страничке пакета не оказалось каких-то данных (версии, описания и тому подобного), то поищите их здесь. Здесь же могут быть прописаны зависимости пакета от других пакетов texlive (со словом depend) - из надо обязательно указать как Requires в spec-файле.

Например, если в tlpkg/tlpobj/<TEXPKG> есть запись

depend babel-belarusian

то в spec-файле должна присутсвовать соответсвующая зависимоcть

Requires: texlive-babel-belarusian

Значение тэга Group для пакетов texlive - всегда Publishing.

Как правило, пакеты являются арзитектурно-независимыми, поэтому надо дабавить в spec-файл запись

BuildArch: noarch

(если пакет является архитектурно-зависимым, то rpmbuild его не соберет с соответствующей ошибкой - тогда BuildArch надо убрать).

Всем texlive-пакетам необходимо прописать сборочную зависимость (BuildRequires) от texlive-tlpkg. Этот же пакет надо указать как предустановочную зависимость ("Requires(pre)"). В качестве пост-установочной зависимости post-скрипта ("Requires(post)") надо указать texlive-kpathsea.

Для большинства пакетов, секция %prep сводится к распаковке архивов, например:

%setup -c -a0 -a1 -a2

секция %build отсутствует, а %install сводится к копированию директорий, содержащихся внутри архивов (за исключением директории tlpkg), в  %{buildroot}%{_texmfdistdir} (которую надо предварительно создать):

%install
mkdir -p %{buildroot}%{_texmfdistdir}
cp -fpar fonts tex doc source %{buildroot}%{_texmfdistdir}

(проследите, чтобы скопированы были все директории из архивов, кроме tlpkg)

Эти же директории достаточно указать в секции %files, пометив sources и doc как документацию:

%files
%{_texmfdistdir}/tex/latex/<TEXPKG>
%{_texmfdistdir}/fonts/latex/<TEXPKG>
%doc %{_texmfdistdir}/source/latex/<TEXPKG>
%doc %{_texmfdistdir}/doc/latex/<TEXPKG>

Подготовив spec-файл и скачав архивы с исходным кодом, необходимо убедиться в возможности собрать пакет с помощью rpmbuild -bb. Если проблем нет - то собираем src.rpm (rpmbuild -bs) и создаем из него проект в своем репозитории на ABF.

Примеры texlive пакетов:

(смотрите ветку rosa2019.1)

Пакеты со скриптами

Для некоторых модулей по ссылке http://ctan.altspu.ru/systems/texlive/tlnet/archive/ доступен не только архив с исходным кодом, но и дополнительные пакеты под разные ОС и архитектуры. Для некоторых модулей таких пакетов нет, однако внутри архива с исходным кодом лежит папка scripts. Для всех таких модулей помимо описанных выше действий надо произвести дополнительные манипуляции, добавив файлы, присутсвующие в ОС-специфичных пакетах. Как правило, эти манипуляции сводятся к созданию символьных ссылок на скрипты в местах, где в ОС располагаются файлы для запуска (в случае Linux - в директории /bin или /usr/bin).

Например, для a2ping мы видим следующие файлы:

...
a2ping.tar.xz
a2ping.win32.tar.xz
a2ping.x86_64-cygwin.tar.xz
a2ping.x86_64-darwin.tar.xz
a2ping.x86_64-darwinlegacy.tar.xz
a2ping.x86_64-linux.tar.xz.
...

Скачаем a2ping.x86_64-linux.tar.xz и заглянем внутрь - там помимо служебной директории tlpgk мы увидим директорию bin, внутри нее директорию x86_64-linux, а там - символьную ссылку a2ping:

$ tar xf a2ping.x86_64-linux.tar.xz
$ ls -l bin/x86_64-linux/
total 0
lrwxrwxrwx 1 user users 41 Oct  4  2018 a2ping -> ../../texmf-dist/scripts/a2ping/a2ping.pl

Как видим, ссылается она на скрипт ../../texmf-dist/scripts/a2ping/a2ping.pl

Сам скрипт находится в архиве с исходным кодом (a2ping.tar.xz), в директории texmf-dist. При сборке пакета, мы должны положить содержимое texmf-dist в директорию %{buildroot}%{_texmfdistdir}, а в директории %{buildroot}%{_bindir} создать соответсвующую символьную ссылку:

mkdir -p %{buildroot}%{_texmfdistdir}
cp -fpar texmf-dist/* %{buildroot}%{_texmfdistdir}
mkdir -p %{buildroot}%{_bindir}
pushd %{buildroot}%{_bindir}
    ln -sf %{_texmfdistdir}/scripts/a2ping/a2ping.pl a2ping
popd

Пример: