Как положить документ в Кучу

Коротко

Более развёрнуто

Предупредить

Получить доступ к incoming. Для этого нужно написать письмо Разгребателю Кучи, в котором представиться, сообщить свой e-mail и выслать публичный ключ для rsync/ssh. В ответ вы получите уникальный идентификатор, от имени которого и будете помещать документы.

Помять

Запаковать документ в tar-архив. Структура архива простая:

• Имя_архива.tar (допустимо .tbz, .tgz, .tar.gz и .tar.bz2:)
• Необязательный_подкаталог (имя любое)
• Файл docinfo
• Файл License
• Обязательный_подкаталог (имя любое)
• * * *
• Всё, что угодно
• * * *

Положить

Настроить ssh так же, как это принято для помещения пакета в incoming Сизифа (семь строчек в .ssh/config, делается однократно:) и закачивать с помощью rsync файлы в подкаталог incoming/docs/.

Файл License может содержать какой угодно текст, главное, чтобы он был!

Файл docinfo содержит строго определённый текст. Это краткое описание документа, который вы кладёте в кучу. Самое трудное в нём — классифицировать документ. Можно воспользоваться шаблоном для изготовления файла docinfo и пояснениями к категориям и полям или даже интерактивной программой на Питоне.

Подробное объяснение технических деталей см. в разделе «Куча (репозиторий исходных документов)» ADT policy. Там приведены настройки ssh и пример команды rsync.