Publishing a document with Publican/ru

Начиная с версии Publican 2.0, возможна автоматизированная публикация документов на сайте Fedora.

Требования
Чтобы получить доступ к возможностям публикации документов, необходимо:
 * вступить в группу docs-publishers;
 * создать локальную копию книги, загрузив ее из GIT или SVN.

Подготовка
Создайте локальную копию репозитория git сайта docs.fedoraproject.org: git clone ssh://ИМЯ@git.fedorahosted.org/git/docs/web.git где ИМЯ &mdash; имя пользователя FAS.  Перейдите в каталог с загруженным web.git и создайте копию файла homepage.tmp с именем homepage.cfg: cp homepage.tmp homepage.cfg  Отредактируйте файл homepage.cfg, добавив абсолютные пути к fedoradocs.db и каталогу public_html. Так, например, если вы загрузили web.git в каталог fedoradocs, файл homepage.cfg будет выглядеть примерно так:
 * 1) Config::Simple 4.59
 * 2) Tue May 11 13:53:03 2010

db_file: /home/jsmith/fedoradocs/web/fedoradocs.db toc_path: /home/jsmith/fedoradocs/web/public_html  Убедитесь, что вы используете последнюю версию Publican. Для этого в режиме root выполните: yum update publican publican-fedora 

Публикация документа
Обновите локальную копию docs.fedoraproject.org: git pull 

Перейдите в каталог с локальной версией документа, который надо опубликовать, и выполните: publican build --embedtoc --publish --formats epub,html,html-single,pdf --langs ru-RU 

Перейдите в каталог publish и проверьте подкаталоги документов. В частности, убедитесь, что:
 * в качестве продукта указана Fedora (обратите внимание на заглавную букву);
 * версия верна;
 * название документа верно. Обратите внимание на заглавные буквы и пробелы. Так, например, Foo Guide не эквивалентно foo-guide</li>

Установите документ на сайте Fedora: publican install_book --site_config ПУТЬ --lang ru-RU где ПУТЬ &mdash; путь к файлу конфигурации homepage.cfg в локальном каталоге сайта docs.fedoraproject.org на диске. Стоит отметить, что команду publican install_book можно выполнять только для одного языка.</li>

Перейдите в каталог с локальной версией сайта и выполните следующее: git add. git commit -m "ОПИСАНИЕ_ИЗМЕНЕНИЙ" git push </li></ol>

Удаление документа
Для удаления документа из списка опубликованных для русского языка выполните следующее:

Обновите локальную копию docs.fedoraproject.org. Перейдите в каталог с локальной копией сайта и выполните команду: git pull </li>

Перейдите в каталог с локальной версией документа, который надо удалить, и выполните: publican remove_book --site_config ПУТЬ --lang ru-RU

где ПУТЬ &mdash; путь к файлу конфигурации homepage.cfg в каталоге локальной версии сайта docs.fedoraproject.org. Стоит отметить, что команду publican remove_book можно выполнять только для одного языка.</li>

Перейдите в локальный каталог документа и выполните: git add. git commit -m "ОПИСАНИЕ_ИЗМЕНЕНИЙ" git push </li>

Publican может удалить файлы и каталоги только локально, а не в GIT. Чтобы удалить файлы из локального репозитория GIT, выполните команду for f in $(git ls-files --deleted); do git rm $f; done После чего можно применить изменения удаленно: git commit -m "Removing unused files" git push </li></ol>

Обновление документа
Чтобы обновить уже опубликованный документ для конкретного языка и конкретной версии Fedora, перейдите в каталог, где хранится локальная копия документа, и выполните команду publican install_book как будто установка выполняется впервые. Publican автоматически заменит старый документ новой версией.