ctanify - Интернет в облаке

ПРОГРАММА:

ИМЯ

ctanify - Готовит пакет для загрузки в CTAN

СИНТАКСИС

станицировать [--pkgname=string] [--[нет]автоматический] [--tdsonly=спецификация файла ...] [--[нет]объединять]
[--[нет]пропускать] [--tdsdir=имя_директории ...] [--текс=макрос_pkg] [--[нет]смешивать] спецификация файла[=имя_директории]
...

станицировать [--Помогите]

станицировать [--версия]

ОПИСАНИЕ

отанковать предназначен для разработчиков, у которых есть пакет LaTeX, который они хотят распространять
через Комплексную сеть архивов TeX (CTAN). Учитывая список имен файлов, отанковать
создает архив (архив) .tar.gz file) с файлами, расположенными в предпочтительной структуре CTAN.
Архив также содержит ZIP-архив (.zip) файл с копиями всех файлов, выложенных в
стандартная структура каталогов TeX (TDS), которая облегчает включение пакета в
дистрибутив TeX Live.

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

отанковать принимает следующие параметры командной строки:

-h, --Помогите
Вывести основную информацию об использовании и выйти.

-V, --версия
Результат отанковатьномер версии и выйти.

-p string, --pkgname=string
Укажите явно имя пакета. Как обычно, отанковать использует базовое имя первого
.ins or .сти файл, указанный как имя пакета. Имя пакета формирует базовое имя
тарбола, который отанковать производит.

--noauto
Не добавляйте файлы в архив автоматически. Как обычно, отанковать автоматически
включает все файлы, упомянутые в .ins .

-t спецификация файла, --tdsonly=спецификация файла
Укажите подмножество файлов, названных в командной строке, для включения только в TDS
ZIP-файл, а не в каталоге пакета CTAN. Подстановочные знаки разрешены (в кавычках, если
необходимо), и --tdsonly можно использовать несколько раз в одной командной строке.

В командной строке должно быть указано хотя бы одно имя файла. отанковать автоматически размещает
файлы в дереве TDS на основе их расширения, но это можно изменить, указав
явно целевой каталог TDS, используя форму спецификация файла=имя_директории. Подстановочные знаки разрешены
для спецификации файла (если необходимо, укажите в кавычках).

ДОПОЛНИТЕЛЬНЫЕ ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

Следующие опции вряд ли понадобятся при обычном использовании. Они предоставляются
для особых обстоятельств, которые могут возникнуть.

-d имя_директории, --tdsdir=имя_директории
Вместо того, чтобы создавать архив для CTAN, просто создайте дерево TDS пакета с корнем
каталог имя_директории.

-T макрос_pkg, --текс=макрос_pkg
Убедитесь, что файлы, упаковываемые для CTAN, нацелены на пакет макросов TeX, отличный от
Латекс. Некоторые общие примеры макрос_pkg являются «универсальными», «простыми» и «контекстными».

-ноу, --no-unixify
Сохраняйте текстовые файлы без изменений вместо преобразования их символа конца строки в Unix
формат (одиночный символ перевода строки без символа возврата каретки), хотя
CTAN предпочитает получать все файлы с символами конца строки формата Unix.

-нок, --без пропуска
Форс-мажор отанковать для включения таких файлов, как скрытые файлы Unix, файлы резервных копий Emacs и
файлы метаданных управления версиями, которые CTAN не любит получать.

-m, - ошибочно
Переименуйте каталоги, содержащие один файл, в «разное». (Например, переименовать
«tex / latex / mypackage / mypackage.sty» на «tex / latex / misc / mypackage.sty».) Это было
обычная практика в прошлом, но сейчас настоятельно не рекомендуется.

ДИАГНОСТИКИ

"Не удалось скопировать имя файла (Нет такие файл or каталог) "
Это сообщение обычно вызвано .ins файл, который генерирует имя файла но это
еще не пройдено текс or латекс на самом деле производить имя файла. отанковать приносит
не запускается автоматически текс or латекс; это должно быть сделано пользователем вручную. Видеть
«ПЕЩЕРЫ» для получения дополнительной информации.

"Изменено имя файла в использование Юникс линия окончания (использование --no-unixify в предотвращать это)"
Для единообразия CTAN хранит все текстовые файлы с окончаниями строк в стиле Unix (один
символ перевода строки без символа возврата каретки). Чтобы помочь в этом усилии,
отанковать автоматически заменяет окончания строк в стиле, отличном от Unix. Предыдущее просто
сообщение уведомляет пользователя о том, что он не должен беспокоиться, чтобы увидеть другой размер для
имя файла в архиве по сравнению с оригиналом имя файла на диске (который отанковать никогда
изменяет). Если есть веская причина сохранить исходные окончания строк (и там
редко), --no-unixify вариант можно использовать для предотвращения отанковать от изменения любого
файлы при их хранении в архиве.

"Без учета имя файла (использование --без пропуска в сила включение) "
отанковать обычно игнорирует файлы - даже если явно указано в команде
строка - которую CTAN предпочитает не получать. К ним относятся файлы, имена которых начинаются с
"."(Скрытые файлы Unix), заканчиваются на"~"(Автоматические резервные копии Emacs), или которые происходят из
CVS or .svn каталог (файлы метаданных управления версиями). Если есть веская причина
отправлять такие файлы в CTAN (а бывает редко), --без пропуска вариант может быть использован для
предотвращать отанковать от их игнорирования.

"CTAN предпочитает иметь только документацию в формате PDF (re: имя файла)"
Из-за популярности формата PDF CTAN хочет иметь как можно больше документации.
по возможности распространяется в формате PDF. В предыдущем сообщении пользователю предлагается заменить любой
Документация PostScript или DVI с PDF, если возможно. (отанковать по-прежнему будет включать
Документация PostScript и DVI в архиве; предыдущее сообщение - просто
вежливая просьба.)

"Не включая имя файла in домен TDS дерево (неизвестно расширение)"
отанковать размещает файлы в дереве TDS на основе таблицы расширений файлов. Для
например, все .сти файлы помещаются в текс / латекс / имя-пакета. Если отанковать не
знаю куда положить файл он никуда его не кладет. См. Последний абзац
"OPTIONS" для объяснения того, как явно указать целевое местоположение файла в
дерево TDS. Для распространенных расширений файлов, которые отсутствуют в отанковать's
таблица, рассмотрите также возможность уведомления отанковатьавтора по адресу, указанному ниже под
«АВТОР».

ПРИМЕРЫ

Ассоциация Общий Кейсы
Обычно все, что нужно, - это сказать отанковать имя .ins файл (или .сти если
пакет не использует DocStrip) и готовую документацию, если таковая имеется:

$ ctanify mypackage.ins mypackage.pdf README

490347 mypackage.tar.gz

1771 мой пакет / README
15453 mypackage / mypackage.dtx
1957 г., mypackage / mypackage.ins
277683 mypackage / mypackage.pdf
246935 mypackage.tds.zip

1771 документ / латекс / mypackage / README
277683 документ / latex / mypackage / mypackage.pdf
15453 источник / латекс / mypackage / mypackage.dtx
1957 источник / latex / mypackage / mypackage.ins
1725 текс / латекс / mypackage / mypackage.sty

отанковать выводит размер в байтах результирующего тарбола, каждого файла в нем и каждого
файл внутри содержащегося ZIP-файла. Обратите внимание на то, как в предыдущем примере отанковать
автоматически выполняет все следующие операции:

· включая мой пакет.dtx (найдено путем синтаксического анализа мой пакет.insв обоих мой пакет
каталог и ZIP-файл,

· включая мойпакет.сти (найдено путем синтаксического анализа мой пакет.ins) в ZIP-файле, но, поскольку
это сгенерированный файл, а не в мой пакет каталог и

· Размещение всех файлов в соответствующих каталогах TDS (документация, исходный код, основной
package) в ZIP-файле.

Подумайте, что потребуется, чтобы вручную создать эквивалент мой пакет.tar.gz .
отанковать определенно более простая и быстрая альтернатива.

Фильтр Применение
отанковать предполагает, что файлы PostScript являются документацией и поэтому хранит их в
документ / латекс / имя-пакета / в дереве TDS в ZIP-файле. Предположим, однако, что
Пакет LaTeX использует набор файлов PostScript для управления Dvipsвывод. В этом случае,
отанковать нужно указать, чтобы они включали эти файлы PostScript в каталог пакета, а не
каталог документации.

$ ctanify mypackage.ins "mypackage * .ps = tex / latex / mypackage"

Используйте ctanify онлайн с помощью сервисов onworks.net