Publishing a document with Publican/ru: Difference between revisions

Latest revision as of 20:12, 25 March 2014

Old page
This page has been marked as "old", and likely contains content that is irrelevant or incorrect. If you can, please update this page. This page will be deleted if action is not taken.

In other languages: English (en) русский (ru) [edit]

Переход по русской wiki

Состояние перевода

Правила оформления

wiki разметка

Словарь

Участники команды локализации Fedora

Как стать участником команды

Статья о Russian Fedora

План работы по переводу web-сайта Проекта Fedora

Список полезных категорий

Страницы на русском
- Категория «LocalizationRussian»
- Категория «Страницы_на_русском»

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

Требования

Чтобы получить доступ к возможностям публикации документов, необходимо:

вступить в группу docs-publishers;
создать локальную копию книги, загрузив ее из GIT или SVN.

Подготовка

На сегодняшний день (июль 2010г.) известно о проблеме Publican, не позволяющей публиковать документы, если язык системы отличается от en-US. Если используется другой язык, начните другой сеанс, выбрав en-US в качестве языка интерфейса.

Создайте локальную копию репозитория git сайта docs.fedoraproject.org:
```
git clone ssh://ИМЯ@git.fedorahosted.org/git/docs/web.git
```
где ИМЯ — имя пользователя 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
```

Публикация документа

Publican теперь поддерживает структуру каталогов и базу данных SQLite для управления сайтом и его содержимым. Не рекомендуется добавлять и удалять каталоги вручную как это делалось раньше.

Если вы хотите опубликовать черновик документа, следуйте инструкциям на странице подготовки черновой документации.

Обновите локальную копию docs.fedoraproject.org:
```
git pull
```
Перейдите в каталог с локальной версией документа, который надо опубликовать, и выполните:
```
publican build --embedtoc --publish --formats epub,html,html-single,pdf --langs ru-RU
```
Перейдите в каталог publish и проверьте подкаталоги документов. В частности, убедитесь, что:
- в качестве продукта указана Fedora (обратите внимание на заглавную букву);
- версия верна;
- название документа верно. Обратите внимание на заглавные буквы и пробелы. Так, например, Foo Guide не эквивалентно foo-guide
Установите документ на сайте Fedora:
```
publican install_book --site_config ПУТЬ --lang ru-RU
```
где ПУТЬ — путь к файлу конфигурации homepage.cfg в локальном каталоге сайта docs.fedoraproject.org на диске. Стоит отметить, что команду publican install_book можно выполнять только для одного языка.
Перейдите в каталог с локальной версией сайта и выполните следующее:
```
git add .
git commit -m "ОПИСАНИЕ_ИЗМЕНЕНИЙ"
git push
```

Удаление документа

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

Обновите локальную копию docs.fedoraproject.org. Перейдите в каталог с локальной копией сайта и выполните команду:
```
git pull
```
Перейдите в каталог с локальной версией документа, который надо удалить, и выполните:
```
publican remove_book --site_config ПУТЬ --lang ru-RU
```
где ПУТЬ — путь к файлу конфигурации homepage.cfg в каталоге локальной версии сайта docs.fedoraproject.org. Стоит отметить, что команду publican remove_book можно выполнять только для одного языка.
Перейдите в локальный каталог документа и выполните:
```
git add .
git commit -m "ОПИСАНИЕ_ИЗМЕНЕНИЙ"
git push
```
Publican может удалить файлы и каталоги только локально, а не в GIT. Чтобы удалить файлы из локального репозитория GIT, выполните команду
```
for f in $(git ls-files --deleted); do git rm $f; done 
```
После чего можно применить изменения удаленно:
```
git commit -m "Removing unused files"
git push
```
Соблюдайте исключительную осторожность при вызове команды "git rm", так как неверное использование может повредить структуру сайта документации. В случае сомнений попросите о помощи.

Обновление документа

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

@@ Line 1: / Line 1: @@
+{{old}}
 {{autolang}}
-{{Template:draft}}
+{{Template:Ru_RU/SideMenu}}
 Начиная с версии '''Publican 2.0''', возможна автоматизированная публикация документов на сайте Fedora.
 ==Требования==
-Чтобы получить доступ к функциям публикации документов, необходимо:
+Чтобы получить доступ к возможностям публикации документов, необходимо:
 * вступить в группу [https://admin.fedoraproject.org/accounts/group/view/docs-publishers docs-publishers];
 * создать локальную копию книги, загрузив ее из GIT или SVN.
@@ Line 10: / Line 11: @@
 ==Подготовка==
 <!-- Use <ol> and <li> so we can embed <pre> inside -->
-{{admon/warning|На сегодняшний день (июль 2010г.) известно о проблеме Publican, не позволяющей публиковать документы, если язык системы отличается от en-US. Если используется другой язык, перезапустите сеанс, выбрав en-US в качестве языка интерфейса.}}
+{{admon/warning|На сегодняшний день (июль 2010г.) известно о проблеме Publican, не позволяющей публиковать документы, если язык системы отличается от en-US. Если используется другой язык, начните другой сеанс, выбрав en-US в качестве языка интерфейса.}}
 <ol><li>Создайте локальную копию репозитория git сайта docs.fedoraproject.org:
-<pre>git clone ssh://USERNAME@git.fedorahosted.org/git/docs/web.git</pre>
+<pre>git clone ssh://ИМЯ@git.fedorahosted.org/git/docs/web.git</pre>
-Где '''''USERNAME''''' -- имя пользователя FAS.
+где '''''ИМЯ''''' &mdash; имя пользователя FAS.
 {{admon/note | Большой объем загрузки | Загрузка всех файлов может занять некоторое время даже при наличии быстрого соединения.}}</li>
-<li>Change into the directory into which you downloaded the '''web.git''' repo, and make a copy of '''homepage.tmp''' named '''homepage.cfg''':
+<li>Перейдите в каталог с загруженным '''web.git''' и создайте копию файла '''homepage.tmp''' с именем '''homepage.cfg''':
 <pre>cp homepage.tmp homepage.cfg</pre></li>
-<li>Edit the '''homepage.cfg''' file to provide the absolute paths to the '''fedoradocs.db''' file and the '''public_html''' directory. For example, if you downloaded the '''web.git''' repo to the '''fedoradocs''' subdirectory of your home directory, your homepage.cfg file might look like:
+<li>Отредактируйте файл '''homepage.cfg''', добавив абсолютные пути к '''fedoradocs.db''' и каталогу '''public_html'''. Так, например, если вы загрузили '''web.git''' в каталог '''fedoradocs''', файл homepage.cfg будет выглядеть примерно так:
 <pre># Config::Simple 4.59
 # Tue May 11 13:53:03 2010
@@ Line 25: / Line 26: @@
 db_file: /home/jsmith/fedoradocs/web/fedoradocs.db
 toc_path: /home/jsmith/fedoradocs/web/public_html</pre></li>
-<li>Make sure you have the latest version of Publican and the Fedora brand package. As root, run:
+<li>Убедитесь, что вы используете последнюю версию Publican. Для этого в режиме root выполните:
 <pre>yum update publican publican-fedora</pre>
 </li></ol>
 ==Публикация документа==
-{{admon/warning|Publican now controls the directory structure and the SQLite database that manages the site and its tables of contents. Do not add or remove directories from the directory tree manually as we did in the past.}}
+{{admon/warning|Publican теперь поддерживает структуру каталогов и базу данных SQLite для управления сайтом и его содержимым. Не рекомендуется добавлять и удалять каталоги вручную как это делалось раньше.}}
-{{admon/warning|If you are publishing draft documentation, be sure to follow the instructions described at [[Publishing draft documentation]] first.}}
+{{admon/warning|Если вы хотите опубликовать черновик документа, следуйте инструкциям на странице [[Publishing draft documentation |подготовки черновой документации]].}}
 <ol><li>Обновите локальную копию docs.fedoraproject.org:
 <pre>git pull</pre></li>
-<li>Change to the directory where you keep a checked-out copy of the document that you want to publish, then run:
+<li>Перейдите в каталог с локальной версией документа, который надо опубликовать, и выполните:
-<pre>publican build --embedtoc --publish --formats epub,html,html-single,pdf --langs LANGUAGE_CODES</pre>
+<pre>publican build --embedtoc --publish --formats epub,html,html-single,pdf --langs ru-RU</pre>
-where '''''LANGUAGE_CODES''''' is a comma-separated list of the languages in which you want to publish this document. </li>
+</li>
 <li>Перейдите в каталог '''publish''' и проверьте подкаталоги документов. В частности, убедитесь, что:
@@ Line 45: / Line 46: @@
 * название документа верно. Обратите внимание на заглавные буквы и пробелы. Так, например, '''Foo Guide''' не эквивалентно '''foo-guide'''</li>
-<li>Install the book to the Fedora website:
+<li>Установите документ на сайте Fedora:
-<pre>publican install_book --site_config PATH_TO_SITE_CONFIG_FILE --lang LANGUAGE_CODE</pre>
+<pre>publican install_book --site_config ПУТЬ --lang ru-RU</pre>
-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 publishing the document. Note that you can only run '''publican&nbsp;install_book''' for one language at a time.</li>
+где '''''ПУТЬ''''' &mdash; путь к файлу конфигурации '''homepage.cfg''' в локальном каталоге сайта docs.fedoraproject.org на диске. Стоит отметить, что команду '''publican&nbsp;install_book''' можно выполнять только для одного языка.</li>
-<li>Change to the directory in which you keep your local copy of the site and run:
+<li>Перейдите в каталог с локальной версией сайта и выполните следующее:
 <pre>git add .
-git commit -m "DESCRIPTION_OF_YOUR_CHANGES"
+git commit -m "ОПИСАНИЕ_ИЗМЕНЕНИЙ"
 git push</pre></li></ol>
@@ Line 57: / Line 58: @@
 Для удаления документа из списка опубликованных для русского языка выполните следующее:
-<ol><li>Update your copy of the docs.fedoraproject.org website. In the directory where you keep your local copy of the site, run:
+<ol><li>Обновите локальную копию docs.fedoraproject.org. Перейдите в каталог с локальной копией сайта и выполните команду:
 <pre>git pull</pre></li>
-<li>Change to the directory where you keep a checked-out copy of the document that you want to remove, then run:
+<li>Перейдите в каталог с локальной версией документа, который надо удалить, и выполните:
-<pre>publican remove_book --site_config PATH_TO_SITE_CONFIG_FILE --lang LANGUAGE_CODE</pre>
+<pre>publican remove_book --site_config ПУТЬ --lang ru-RU</pre>
-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&nbsp;remove_book''' for one language at a time.</li>
+где '''''ПУТЬ''''' &mdash; путь к файлу конфигурации '''homepage.cfg''' в каталоге локальной версии сайта docs.fedoraproject.org. Стоит отметить, что команду '''publican&nbsp;remove_book''' можно выполнять только для одного языка.</li>
 <li>Перейдите в локальный каталог документа и выполните:
 <pre>git add .
-git commit -m "DESCRIPTION_OF_YOUR_CHANGES"
+git commit -m "ОПИСАНИЕ_ИЗМЕНЕНИЙ"
 git push</pre></li>
-<li>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:
+<li>Publican может удалить файлы и каталоги только локально, а не в GIT. Чтобы удалить файлы из локального репозитория GIT, выполните команду
 <pre>for f in $(git ls-files --deleted); do git rm $f; done </pre>
-Then push these changes to the remote repo:
+После чего можно применить изменения удаленно:
-<pre>git commit -m"rm unused files"
+<pre>git commit -m "Removing unused files"
 git push</pre>
-{{admon/warning|A "git rm" command gone wrong can cause widespread damage to the documentation site. If you are not absolutely sure of what you are doing, ask for help.}}</li></ol>
+{{admon/warning|Соблюдайте исключительную осторожность при вызове команды "git rm", так как неверное использование может повредить структуру сайта документации. В случае сомнений попросите о помощи.}}</li></ol>
 ==Обновление документа==
-To update a document previously published in a particular language for a particular version of Fedora, change into the directory in which you keep a checked-out copy of the document, then run '''publican install_book''', as if you were installing it for the first time. Publican automatically replaces the old version with the new one.
+Чтобы обновить уже опубликованный документ для конкретного языка и конкретной версии Fedora, перейдите в каталог, где хранится локальная копия документа, и выполните команду '''publican install_book''' как будто установка выполняется впервые. Publican автоматически заменит старый документ новой версией.
 [[Category:LocalizationRussian]]
 [[Category:Страницы на русском]]

Search