Skip menu

Присоединяйтесь!

Вебмастерам

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

Введение

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

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

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

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

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

Название каждой страницы на fsfe.org состоит из названиестраницы.язык.html, где язык соответствует одному из сокращённых названий языков по стандарту ISO-639, например, «en» – английский, «de» – немецкий. Названия исходных файлов состоят из названиестраницы.язык.xhtml.

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

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

Исходные файлы веб-страниц хранятся в репозитории, размещённом на сервере ЕФСПО. Просмотреть содержимое репозитория можно через систему Trac.

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

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

В репозитории Subversion есть две основных ветви текстов для сайта ЕФСПО: ветвь trunk для главной версии сайта http://fsfe.org/ и ветвь test для тестовой версии сайта http://test.fsfe.org/.

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

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

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

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

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

Как работать с репозиторием?

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

$ svn update

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

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

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

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

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

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

В системе Subversion замена ключевых слов должна включаться явным образом для каждого файла. Поскольку некоторые ключевые слова используются в файлах .xml и .xhtml (например, $Author$ – ключевое слово в нижнем колонтитуле страницы), вы можете настроить автоматическую замену ключевых слов, добавив следующий текст в файл ~/.subversion/config: 

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

Если вы знакомы с программой CVS, вы легко разберётесь с SVN, так как основные команды очень похожи. О различиях между CVS и SVN можно почитать на странице Subversion для пользователей CVS, а сравнение команд CVS и SVN представлено в Руководстве по переходу с CVS на SVN.

Загрузить подробное руководство по SVN можно на странице Subversion book (ЕФСПО использует SVN версии 1.5).

Координация работ

Работа над страницами сайта координируется через список рассылки для вебмастеров.

Система Trac также предоставляет ряд инструментов для координации работ: браузер репозитория SVN, систему отслеживания задач и вики.

Более подробная информация о системе Trac опубликована в виде Руководства на странице вики.

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

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

Если у вас есть доступ для записи, подпишитесь на список рассылки для вебмастеров.

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

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

Дополнительная информация

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

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

Или скачайте файл руководства «Вебмастерам ЕФСПО» в формате Texinfo, который написал Йонас Оберг. Он также внедрил систему компиляции страниц HTML из файлов XML. В руководстве подробно разобран механизм работы веб-страниц.

To top