No edit summary |
|||
Line 78: | Line 78: | ||
==Обновление документа== | ==Обновление документа== | ||
Чтобы обновить уже опубликованный документ для конкретного языка и конкретной версии Fedora, перейдите в каталог, где хранится локальная копия документа, и выполните команду '''publican install_book''' как будто установка выполняется впервые. Publican автоматически заменит старый документ новой версией. | |||
[[Category:LocalizationRussian]] | [[Category:LocalizationRussian]] | ||
[[Category:Страницы на русском]] | [[Category:Страницы на русском]] |
Revision as of 06:54, 29 July 2010
- Страницы на русском
Начиная с версии Publican 2.0, возможна автоматизированная публикация документов на сайте Fedora.
Требования
Чтобы получить доступ к функциям публикации документов, необходимо:
- вступить в группу docs-publishers;
- создать локальную копию книги, загрузив ее из GIT или SVN.
Подготовка
- Создайте локальную копию репозитория git сайта docs.fedoraproject.org:
git clone ssh://USERNAME@git.fedorahosted.org/git/docs/web.git
где USERNAME -- имя пользователя FAS.
- Перейдите в каталог с загруженным web.git и создайте копию файла homepage.tmp с именем homepage.cfg:
cp homepage.tmp homepage.cfg
- Отредактируйте файл homepage.cfg, добавив абсолютные пути к fedoradocs.db и каталогу public_html. Так, например, если вы загрузили web.git в каталог fedoradocs, файл homepage.cfg будет выглядеть примерно так:
# Config::Simple 4.59 # 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 LANGUAGE_CODES
где LANGUAGE_CODES — список кодов языков, разделенных запятыми. Для публикации документа на русском языке укажите ru-RU. - Перейдите в каталог publish и проверьте подкаталоги документов. В частности, убедитесь, что:
- в качестве продукта указана Fedora (обратите внимание на заглавную букву);
- версия верна;
- название документа верно. Обратите внимание на заглавные буквы и пробелы. Так, например, Foo Guide не эквивалентно foo-guide
- Установите документ на сайте Fedora:
publican install_book --site_config PATH --lang LANGUAGE_CODE
где PATH — путь к файлу конфигурации homepage.cfg в локальном каталоге сайта docs.fedoraproject.org на диске, а LANGUAGE_CODE — код языка. Для публикации документа на русском языке укажите ru-RU. Стоит отметить, что команду publican install_book можно выполнять только для одного языка. - Перейдите в каталог с локальной версией сайта и выполните следующее:
git add . git commit -m "DESCRIPTION_OF_YOUR_CHANGES" git push
Удаление документа
Для удаления документа из списка опубликованных для русского языка выполните следующее:
- Update your copy of the docs.fedoraproject.org website. In the directory where you keep your local copy of the site, run:
git pull
- Change to the directory where you keep a checked-out copy of the document that you want to remove, then run:
publican remove_book --site_config PATH_TO_SITE_CONFIG_FILE --lang LANGUAGE_CODE
where PATH_TO_SITE_CONFIG_FILE is the path to the homepage.cfg file in your local copy of the docs.fedoraproject.org website, and LANGUAGE_CODE is the language in which you are removing the document. Note that you can only run publican remove_book for one language at a time. - Перейдите в локальный каталог документа и выполните:
git add . git commit -m "DESCRIPTION_OF_YOUR_CHANGES" git push
- Publican can only remove the local files and directories on your system, not their record in Git. To remove the deleted files from your local Git repo, run:
for f in $(git ls-files --deleted); do git rm $f; done
Then push these changes to the remote repo:
git commit -m"rm unused files" git push
Обновление документа
Чтобы обновить уже опубликованный документ для конкретного языка и конкретной версии Fedora, перейдите в каталог, где хранится локальная копия документа, и выполните команду publican install_book как будто установка выполняется впервые. Publican автоматически заменит старый документ новой версией.