Вебмастерам

FSFE team, “Webmastering”, public translation into Russian from English More about this translation.

Statistics
Participants
Translate into Russian
Translation result
91% translated in draft. Almost done, let's finish it!

<?xml version="1.0" encoding="UTF-8" ?>
<html>
<head>
<title>Информация для вебмастеров – ЕФСПО</title>
</head>
<body>

<a href="/contribute/">Присоединяйтесь!</a>
<h1>Вебмастерам</h1>

Команда вебмастеров разрабатывает и поддерживает сайты ЕФСПО, начиная с <a href="/">fsfe.org</a> и заканчивая сайтами проектов и кампаний. Вебмастера – это добровольцы, которые улучшают внешний вид организации и совершенствуют техническую составляющую деятельности Фонда в Интернете.

<h2>Введение</h2>

Технологии и программы, которые используются в работе веб-страниц ЕФСПО, хорошо знакомы многим разработчикам и могут представлять интерес для тех, кто ещё только начинает знакомство с ними.

Переводчики и другие добровольцы в своей работе, скорее всего, затронут лишь:

<ul>
<li>
Файлы <a href="http://ru.wikipedia.org/wiki/XHTML">XHTML</a>, из которых генерируются веб-страницы.
</li>
<li>
Систему <a href="http://subversion.tigris.org/">Subversion</a>, с помощью которой можно посмотреть изменения, сделанные другими участниками.
</li>
<li>
Систему <a href="http://trac.edgewall.org/">Trac</a> – инструмент управления проектами и отслеживания ошибок в программном обеспечении.
</li>
</ul>

Те же, кто хочет помочь с поддержкой веб-сайтов, должны также знать

<ul>
<li>
<a href="http://www.perl.org/">Perl</a> – поддержка веб-страниц и написание сценариев для их создания.
</li>
<li>
<a href="http://www.apache.org/">Apache</a> – веб-сервер.
</li>
</ul>

<h2>Как устроены веб-страницы</h2>

Страницы сайта <var>fsfe.org</var> хранятся в виде набора XML файлов, из которых каждые десять минут веб-сервер автоматически создаёт HTML страницы. Таким образом, редактируются только XML файлы, а HTML страницы никогда напрямую не затрагиваются.

Название каждой страницы на fsfe.org состоит из <var>названиестраницы.язык.html</var>, где язык соответствует одному из сокращений названий языков по стандарту <a href="http://ru.wikipedia.org/wiki/ISO_639">ISO-639</a>, например, «en» – английский, «de» – немецкий. Названия исходных файлов состоят из <var>названиестраницы.язык.xhtml</var>.

На некоторых страницах, помимо фиксированного текста из XHTML файла, есть динамические вставки. Это значит, что при их создании веб-сервер берёт текст из нескольких XML файлов. Если в одном из этих файлов текст не переведён, то будет вставлен фрагмент оригинальной страницы на английском языке. Именно так на сайте возникают страницы с текстом на двух языках. Примеры страниц с динамическими вставками: <a href="/">домашняя страница</a>, <a href="/news/">страница новостей</a> и <a href="/events/">страница событий</a>.

<h2>Как получить доступ к веб-страницам?</h2>

Исходные файлы веб-страниц хранятся в <a href="https://trac.fsfe.org/fsfe-web/browse">репозитории</a>, размещённом на сервере ЕФСПО. Просмотреть содержимое репозитория можно через систему <a href="https://trac.fsfe.org/fsfe-web">Trac</a>.

Получить доступ к этим инструментам можно следующим образом:

<ul>
<li>

Если вы член <a href="http://fellowship.fsfe.org">Содружества ЕФСПО</a> у вас уже есть доступ для чтения, нужно лишь ввести логин и пароль.

Если вы хотите получить доступ для записи (к репозиторию или к вики системы Trac), напишите об этом по адресу <a href="mailto:system-hackers@fsfeurope.org">system-hackers@fsfeurope.org</a>.

</li>

<li>

Если вы не являетесь членом Содружества, вы можете <a
href="https://trac.fsfe.org/fsfe-web/register">зарегистрироваться</a> в качестве гостя. Таким образом вы получите доступ для чтения репозитория и в системе Trac (при вводе логина добавьте префикс <var>guest-</var>). Администратор репозитория получит автоматическое уведомление и активирует доступ для записи.

</li>
</ul>

<h3>Извлечение рабочих копий</h3>

В репозитории Subversion хранятся две базы данных для сайта ЕФСПО: <a href="https://trac.fsfe.org/fsfe-web/browser/trunk">SVN trunk</a> для главной версии сайта <a href="http://fsfe.org/">http://fsfe.org/</a> и <a href="https://trac.fsfe.org/fsfe-web/browser/branches/test">test branch</a> для тестовой версии сайта <a href="http://test.fsfe.org/">http://test.fsfe.org/</a>.

Для повседневной работы, например, добавления новостей и новых переводов (или даже для внесения небольших изменений в код веб-сайта), нужно извлекать SVN trunk:

svn --username <var>ВАШЕИМЯ</var> co https://svn.fsfe.org/fsfe-web/trunk

Большие изменения в коде сайта, включая отладку новых функций, которые могут нарушить его нормальную работу лучше предварительно испытывать на тестовой версии репозитория test branch:

svn --username <var>ВАШЕИМЯ</var> co https://svn.fsfe.org/fsfe-web/branches/test

Обратите внимание – чтобы извлечь весь репозиторий потребуется около 160 Мб дискового пространства. Если вы хотите работать над определённой частью сайта, можно извлечь только её. <a href="https://trac.fsfe.org/fsfe-web/browser">Просмотреть содержимое репозитория</a> и выбрать файлы для копирования можно через систему Trac.

<h2>Как работать с репозиторием?</h2>

После того, как нужные файлы извлечены, необходимо выполнять обновление

$ svn update

каждый раз перед тем, как приступить к работе.

Если вы хотите добавить в репозиторий новые файлы или каталоги, нужно выполнить

$ svn add название файла

Для того чтобы добавить файлы на сервер, будь то новый или изменённый файл, выполните

$ svn commit название файла

Откроется редактор, который у вас установлен по умолчанию, чтобы добавить примечание.

В системе Subversion должна быть включена <a href="http://svnbook.red-bean.com/en/1.5/svn.advanced.props.special.keywords.html">замена ключевых слов</a>. Поскольку некоторые ключевые слова используются в файлах <var>.xml</var> и <var>.xhtml</var> (например, <var>$</var><var>Author</var><var>$</var> – ключевое слово в нижним колонтитуле страницы), вы настроить автоматическую замену ключевых слов, добавив следующий текст в файл <var>~/.subversion/config</var>:

<pre>
enable-auto-props = yes

[auto-props]
*.xml = svn:keywords=Date Author Id Revision;svn:mime-type=text/xml;svn:eol-style=native
*.xhtml = svn:keywords=Date Author Id Revision;svn:mime-type=text/xhtml;svn:eol-style=native
</pre>

Если вы знакомы с программой CVS, вы легко разберётесь с SVN, так как основные команды совпадают. О различиях между CVS и SVN можно почитать на странице <a href="http://svnbook.red-bean.com/en/1.5svn.forcvs.html">Subversion для пользователей CVS</a>, а сравнение команд CVS и SVN представлено в <a href="http://svn.collab.net/repos/svn/trunk/doc/user/cvs-crossover-guide.html">Руководстве по переходу с CVS на SVN</a>.

Загрузить подробное руководство по SVN можно на странице <a href="http://svnbook.red-bean.com/">Subversion book</a> (ЕФСПО использует SVN версии 1.5).

<h2>Координация работ</h2>

Работа над страницами веб-сайта координируется через <a href="http://mail.fsfeurope.org/mailman/listinfo/web">список рассылки для веб-мастеров</a>.

Система <a href="https://trac.fsfe.org/fsfe-web">Trac</a> также предоставляет ряд инструментов для координации работ: браузер репозитория SVN, систему управления версиями и вики.

Более подробная информация о системе Trac опубликована в виде <a href="https://trac.fsfe.org/fsfe-web/wiki/TracGuide">Руководства</a> на странице вики.

Если вы хотите получать информацию обо всех изменениях в репозитории, подпишитесь на <a href="http://mail.fsfeurope.org/mailman/listinfo/web-cvs-notify">список рассылки уведомлений об изменениях</a>.

<h2>Доступ для записи и ответственность</h2>

Если у вас есть доступ для записи, подпишитесь на <a href="http://mail.fsfeurope.org/mailman/listinfo/web">список рассылки для веб-мастеров</a>.

Обратите внимание – все изменения, которые вы внесёте, станут видны автоматически. Поэтому просим вас при каждой загрузке новых или обновлённых файлов в репозиторий помнить, что:

<ul>
<li>

ЕФСПО несёт ответственность за содержание веб-страниц. Не публикуйте изменения, которые могут исказить значение текста, без одобрения <a href="/about/members.html">членов ассоциации ЕФСПО</a>. (Актуально только для оригинальных страниц на английском языке.)

</li>

<li>

Если вы помогаете ЕФСПО с переводом, старайтесь всегда отдавать текст на проверку при наличии такой возможности. Подпишитесь на <a href="http://mail.fsfeurope.org/mailman/listinfo/translators">список рассылки для переводчиков</a>, чтобы узнать, может ли кто-нибудь помочь вам. Желательно также всегда пользоваться автоматическими средствами проверки орфографии, например, <a href="http://aspell.net/">GNU aspell</a>,
ispell или любыми другими. Установите файл aspell и aspell-XX (где "XX" – двухбуквенный код языка) и выполните:

aspell -H -d language -c file.xhtml

где «language» – название словаря языка; <var>-d</var> – можно опустить, если региональный код системы UNIX совпадет с языком словаря.

</li>

<li>

Убедитесь, что все файлы в правильном формате XML. По умолчанию сервер SVN проверит синтаксис XML файлов с разрешением .xml и .xhtml extensions и отменит загрузку, если обнаружит ошибки. Также файлы можно самостоятельно проверить перед загрузкой одним из способов, перечисленных ниже.


С помощью сценария <var>/trunk/tools/validate.pl</var>. Он найдёт ошибки в разметке, которые могут вывести из строя автоматическое обновление страниц на сайте ЕФСПО. Если у вас сложилось впечатление, что процесс создания страниц нарушен, <a href="http://status.fsfe.org/">посмотрите журнал событий последней рабочей версии</a> на <a href="http://status.fsfe.org/">странице состояния веб-сервера</a>.

Для сценария <var>validate.pl</var> нужен модуль Perl XML::LibXML. Если он не установлен, можно проверить файлы через любую другую программу проверки правильности разметки XML. Например, можно использовать программу xmllint с доступом из командной строки, разработанную в рамках проекта <a href="http://xmlsoft.org/">libxml2</a>.

Если вы используете операционную систему Debian GNU/Linux, установите программу libxml2-utils и выполните команду:

xmllint --noout file.xhtml

где file – название файла, который вы хотите проверить. Если программа обнаружит ошибку, появится соответствующее сообщение.

</li>

<li>

Убедитесь, что кодировка файла совпадает с названием кодировки в его верхней части (там, где слово «encoding»). Например, если файл сохранён в кодировке «iso-8859-1» (latin-1), то в первой строке должно быть написано:

<?xml version="1.0" encoding="iso-8859-1" ?>

Другая допустимая кодировка – «UTF-8». Изменить кодировку файла можно с помощью стандартной программы iconv следующим образом (пример конвертации файла из «latin1» в «UTF-8»):

iconv -f LATIN1 -t UTF8 inputfile > outputfile

</li>
</ul>

При добавлении файлов в репозиторий обязательно координируйте свои действия с другими добровольцами, у которых тоже есть доступ для записи, чтобы добавления новых и обновлённых файлов были правильными. И, конечно же, проверяйте файлы перед тем, как загрузить их в репозиторий.

<h2>Дополнительная информация</h2>

Структура fsfe.org довольно сложна и скрыта от глаз простого пользователя из-за того, что на сайте есть страницы как для аудитории в масштабах всей Европы и мира, так и страницы с информацией для конкретных стран.

Если вы хотите не только переводить страницы, но и помогать на других направлениях, ознакомьтесь со <a href="Webpage-Structure.txt" target="_blank">структурой сайта</a>.

Или скачайте файл руководства <a href="/README.texi" target="_blank">«Вебмастерам ЕФСПО»</a> в формате <a href="http://www.texinfo.org" target="_blank">Texinfo</a>, который написал <a href="mailto:oberg@fsfeurope.org">Йонас Оберг</a>. Он также внедрил систему компиляции HTML страниц из XML файлов. В руководстве подробно разобран механизм работы веб-страниц.

</body>

<timestamp>$Date: 2010-01-26 16:32:06 +0000 (Tue, 26 Jan 2010) $ $Author: sstavra $</timestamp>
</html>

Download all in txt format

Original (English): Webmastering

you!

Вебмастерам

Like this translation? Share it or bookmark!

Feedback