View source for Publishing a document with Publican/ru

{{autolang}}
{{Template:draft}} {{Template:Ru_RU/SideMenu}}

Начиная с версии '''Publican 2.0''', возможна автоматизированная публикация документов на сайте Fedora.
==Требования==
Чтобы получить доступ к возможностям публикации документов, необходимо:
* вступить в группу [https://admin.fedoraproject.org/accounts/group/view/docs-publishers docs-publishers];
* создать локальную копию книги, загрузив ее из GIT или SVN.

==Подготовка==
<!-- Use <ol> and <li> so we can embed <pre> inside -->
{{admon/warning|На сегодняшний день (июль 2010г.) известно о проблеме Publican, не позволяющей публиковать документы, если язык системы отличается от en-US. Если используется другой язык, начните другой сеанс, выбрав en-US в качестве языка интерфейса.}}


<ol><li>Создайте локальную копию репозитория git сайта docs.fedoraproject.org:
<pre>git clone ssh://ИМЯ@git.fedorahosted.org/git/docs/web.git</pre>
где '''''ИМЯ''''' &mdash; имя пользователя FAS.
{{admon/note | Большой объем загрузки | Загрузка всех файлов может занять некоторое время даже при наличии быстрого соединения.}}</li>
<li>Перейдите в каталог с загруженным '''web.git''' и создайте копию файла '''homepage.tmp''' с именем '''homepage.cfg''':
<pre>cp homepage.tmp homepage.cfg</pre></li>
<li>Отредактируйте файл '''homepage.cfg''', добавив абсолютные пути к '''fedoradocs.db''' и каталогу '''public_html'''. Так, например, если вы загрузили '''web.git''' в каталог '''fedoradocs''', файл homepage.cfg будет выглядеть примерно так:
<pre># 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</pre></li>
<li>Убедитесь, что вы используете последнюю версию Publican. Для этого в режиме root выполните:
<pre>yum update publican publican-fedora</pre>
</li></ol>

==Публикация документа==
{{admon/warning|Publican теперь поддерживает структуру каталогов и базу данных SQLite для управления сайтом и его содержимым. Не рекомендуется добавлять и удалять каталоги вручную как это делалось раньше.}}
{{admon/warning|Если вы хотите опубликовать черновик документа, следуйте инструкциям на странице [[Publishing draft documentation |подготовки черновой документации]].}}

<ol><li>Обновите локальную копию docs.fedoraproject.org:
<pre>git pull</pre></li>

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

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

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

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

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

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

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

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

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

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

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


[[Category:LocalizationRussian]]
[[Category:Страницы на русском]]