Перевод документации OSGeo Live

Проект по переводу документации OSGeo-Live — координационная страница.

О чём речь?

OSGeo-Live — LiveCD на базе Linux с большим набором открытых/свободных ГИС (в т.ч. веб), открытых геоданных и документацией. Используется в основном в образовательных или демонстрационных целях.

Пользовательская документация на диске распространяется под свободной лицензией (CC BY 3.0 и CC BY-SA 3.0), представлена в виде набора веб-страниц. К настоящему времени документация полностью или частично переведена с английского на 9 других языков включая испанский, французский, немецкий, китайский).

Цель проекта — перевод документации OSGeo-Live на русский язык. Такой перевод был бы полезен для популяризации открытых ГИС среди русскоязычных пользователей, ну или хотя бы просто для присутствия русского языка в ещё одном открытом проекте. Кстати, имена отважных переводчиков могут быть (при их желании, естественно) увековечены в специальном файлике translators.csv на диске в следующем релизе OSGeo-Live.

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

С чем имеем дело

В исходном виде документация OSGeo-Live представляет собой текстовые файлы с разметкой reStructuredText в кодировках ASCII и UTF-8, которые затем конвертируются в html-страницы.

Пример разметки reStructuredText:

`OSGeo-Live <http://live.osgeo.org>`_ is a self-contained bootable DVD, USB thumb drive or Virtual
Machine based on `Xubuntu <http://www.xubuntu.org/>`_, that allows you to try a wide variety of open
source geospatial software without installing anything. It is composed
entirely of free software, allowing it to be freely distributed, duplicated
and passed around.

.. image:: ../images/screenshots/800x600/osgeolive_menu.png
  :scale: 70 %
  :alt: boot select
  :align: right

It provides pre-configured applications for a range of geospatial use cases,
including storage, publishing, viewing, analysis and manipulation of data. It
also contains sample datasets and documentation.

To try out the applications, simply:

#. Insert DVD or USB thumb drive in computer or virtual machine.
#. Reboot computer. (verify boot device order if necessary)
#. Press "Enter" to startup & login.
#. Select and run applications from the "Geospatial" menu.

Последняя (свежая) версия документации лежит здесь. Документы разбиты на тематические разделы: обзоры ПО (overview), "быстрые старты" для ПО (quickstart), стандарты (standards), "служебные" и информационные файлы — всего 141 rst-файл (60 rst-файлов в "обзорах", 61 в "быстрых стартах", 12 в "стандартах", 8 "служебных") и 1 txt-файл с приветствием при входе в систему. Для перевода были оставлены только значимые файлы (всего 15469 строк), весь текст перекодирован в UTF-8.

Схема работы

Что нужно?

Для участия в проекте понадобится:

• регистрация на форуме;
• текстовый редактор (желательно с нормальной поддержкой юникода), например Notepad++ для Windows;
• периодический выход в Интернет.

Как переводим?

Главные правила

Главная мысль состоит в том, чтобы переводить собственно текст, не трогая по возможности разметку документа. Для этого нужно соблюдать несколько несложных правил:

• НЕ переводятся имена файлов;
• оставляем пустые строки и строки, содержащие только знаки пунктуации, как есть;
• ВСЕ отступы в тексте должны сохраняться;
• НЕ переносим строки в списках;
• в тексте не трогаем знак нижнего подчеркивания (_), "звёздочку" (*), двойную "звёздочку" (**), обратный апостроф (`), двойной обратный апостроф (``), двойное двоеточие (::), двойной обратный слеш (\\);
• НЕ переводится текст, заключённый между двумя знаками вертикальной черты (|текст|);
• НЕ переводятся строки, в которых есть слова с двумя двоеточиями (:текст:) типа

 
:scale: 80

, кроме строк с ":alt:", которые представляют собой подписи к рисункам:

 
:alt: Web services framework of OGC geoprocessing standards

• в строках, которые начинаются с двух точек (..), не переводится текст до двойных двоеточий, например,

"image" здесь

.. image:: ../../images/screenshots/800x600/saga_fullextent.png

или "tip" здесь

.. tip:: Open the file with a Desktop GIS like QGIS. And have a look.

• также НЕ переводятся: ссылки на рисунки (".. image::", ".. figure::"), ссылки на другие документы (:doc: и т.п.).

Повторяющиеся фрагменты

В текстах (особенно в разделе "Overview") имеются стандартные повторяющиеся фрагменты, например:

   
**Website:** http://mapproxy.org/

**Licence:** `Apache Software License 2.0 <http://www.apache.org/licenses/LICENSE-2.0.html>`_

**Software Version:** 1.4.0

**Supported Platforms:** Linux, Mac, Windows

**Support:** http://mapproxy.org/support.html

**Documentation:** <../../mapproxy/index.html>`_

Такие части надо переводить единообразно:

Quickstart	Начало работы
Quickstart documentation	Введение
Details	Дополнительная информация
Core features	Базовые функции
Version	Версия
Website	Веб-сайт
Licence	Лицензия
Software Version	Версия ПО
Supported Platforms	Поддерживаемые платформы
Support	Поддержка
Documentation	Документация
API Interfaces	Интерфейсы API
Commercial Support	Коммерческая поддержка
Community Support	Поддержка сообщества
Community Website	Сайт сообщества
Programing language support	Поддержка языков программирования
Developers	Разработчики
What Next?	Что дальше?
Implemented Standards	Реализованные стандарты

В текстах упоминается много лицензий (часто одна и та же по-разному), где-то со ссылкой на её официальный текст, где-то без. Логично было бы писать их аббревиатуру без расшифровки и давать таки ссылку на лицензию. Ниже в таблице дан перечень лицензий со ссылками.

Предложение по названиям лицензий:

Исходно	Меняем на:	Ссылка
AGPL	AGPL	http://www.fsf.org/news/agplv3-pr
Apache License, Version 2.0	Apache, версия 2.0	http://www.apache.org/licenses/LICENSE-2.0
BSD / BSD License / New BSD License / Simplified BSD license	BSD	http://ru.wikipedia.org/wiki/BSD_License
CeCILL	CeCILL	http://www.cecill.info/licences.en.html
custom	собственная	ссылка указана в тексте, оставляем её
GNU General Public License (GPL) version 2	GPL версия 2	http://www.gnu.org/licenses/gpl-2.0.html
GNU General Public License (GPL) version 3	GPL версия 3	http://www.gnu.org/licenses/gpl.html
GPL	GPL	http://www.gnu.org/licenses/gpl.html
GNU Lesser General Public License (LGPL) (version 2, 2.1, 3.0)	LGPL	http://www.gnu.org/copyleft/lesser.html
MIT / MIT License / MIT x/11	MIT	http://opensource.org/licenses/mit-license.php
MIT based license / MIT-style license	основанная на MIT	ссылка указана в тексте, оставляем её
X/MIT style Open Source license	в стиле X/MIT	ссылка указана в тексте, оставляем её
MPLv1.1	MPL версия 1.1	http://www.mozilla.org/MPL/1.1/

Найденные ошибки

Если вы нашли фактическую (смысловую) ошибку в исходных текстах -- просьба отметить это на специальной странице в вики.

Пожелание: русский текст желательно оставлять в кодировке UTF-8!

Действия

1. Скачиваете zip-архив с доками.
2. Выбираете (никем не занятые) файлы для перевода.
3. Сообщаете о желании перевести что-то в специальной теме на форуме; ваше имя появится в таблице на координационной странице напротив выбранных файлов (можно добавиться и самостоятельно).
4. Переводите (желательно соблюдать правила, перечисленные выше).
5. Выкладываете переведённые файлы в той же теме на форуме или присылаете в личном сообщении координатору.
6. При желании повторяете действия 2-6.

NOTE: сдать выполненные переводы желательно НЕ ПОЗДНЕЕ 1 ноября! Это связано с подготовкой к конференции "Открытые ГИС - 2012".

На заметку

Для проверки reST-разметки можно использовать онлайн-редактор http://rst.ninjs.org/

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

   System Message: ERROR/3 (<string>, line 61); backlink
   Unknown interpreted text role "kbd".

На такие ошибки (типа "System Message:") не надо обращать внимание.

Обновляемая онлайн-версия

Онлайн-версия переведённой документации лежит здесь. Будет обновляться по мере перевода.

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

Жёлтым цветом отмечены файлы, находящиеся в переводе (занятые), красным цветом — переведённые файлы, зелёным — переведённые и отредактированные.

Всего: 142 файла, в работе: 17, переведено: 125, готово: 118, свободно: 0.

Файл	Переводчик
contact.rst	amuriy
copyright.rst	amuriy
disclaimer.rst	amuriy
download.rst	amuriy
index.rst	amuriy
presentation.rst	amuriy
sponsors_osgeo.rst	amuriy
sponsors.rst	amuriy
welcome_message.txt	amuriy
overview/52nSOS_overview.rst	Максим Дубинин
overview/52nWPS_overview.rst	Максим Дубинин
overview/52nWSS_overview.rst	Максим Дубинин
overview/atlasstyler_overview.rst	Максим Дубинин
overview/deegree_overview.rst	Максим Дубинин
overview/eoxserver_overview.rst	bolotoved
overview/gdal_overview.rst	bolotoved
overview/geokettle_overview.rst	bolotoved
overview/geomajas_overview.rst	bolotoved
overview/geomoose_overview.rst	bolotoved
overview/geonetwork_overview.rst	ergo
overview/geopublisher_overview.rst	Ariki
overview/geoserver_overview.rst	Ariki
overview/geos_overview.rst	Ariki
overview/geotools_overview.rst	Bishop
overview/gmt_overview.rst	amuriy
overview/gpsdrive_overview.rst	ergo
overview/gpsprune_overview.rst	ergo
overview/grass_overview.rst	amuriy
overview/gvsig_overview.rst	amuriy
overview/kosmo_overview.rst	amuriy
overview/liblas_overview.rst	ergo
overview/mapbender_overview.rst	Bishop
overview/mapfish_overview.rst	Denis Rykov
overview/mapguide_overview.rst	Ariki
overview/mapnik_overview.rst	Ariki
overview/mapproxy_overview.rst	yellow_sky
overview/mapserver_overview.rst	Ariki
overview/maptiler_overview.rst	Ariki
overview/mapwindow_overview.rst	Ariki
overview/marble_overview.rst	yellow_sky
overview/mb-system_overview.rst	amuriy
overview/metacrs_overview.rst	ergo
overview/naturalearth_overview.rst	amuriy
overview/nc_dataset_overview.rst	amuriy
overview/opencpn_overview.rst	amuriy
overview/openjump_overview.rst	amuriy
overview/openlayers_overview.rst	paleogis
overview/osgearth_overview.rst	voltron
overview/osm_dataset_overview.rst	Aleksandr Dezhin
overview/osm_overview.rst	Aleksandr Dezhin
overview/ossim_overview.rst	voltron
overview/otb_overview.rst	voltron
overview/overview.rst	amuriy
overview/pgrouting_overview.rst	Aleksandr Dezhin
overview/postgis_overview.rst	Aleksandr Dezhin
overview/pycsw_overview.rst	voltron
overview/qgis_mapserver_overview.rst	yellow_sky
overview/qgis_overview.rst	voltron
overview/rasdaman_overview.rst	ergo
overview/R_overview.rst	amuriy
overview/saga_overview.rst	darsvid
overview/sahana_overview.rst	ergo
overview/spatialite_overview.rst	voltron
overview/tinyows_overview.rst	Denis Rykov
overview/udig_overview.rst	Bishop
overview/ushahidi_overview.rst	Denis Rykov
overview/viking_overview.rst	Denis Rykov
overview/zoo-project_overview.rst	Bishop
overview/zygrib_overview.rst	ergo
quickstart/52nSOS_quickstart.rst	Максим Дубинин
quickstart/52nWPS_quickstart.rst	Максим Дубинин
quickstart/52nWSS_quickstart.rst	Максим Дубинин
quickstart/atlasstyler_quickstart.rst	Andrey Syrokomskiy
quickstart/deegree_quickstart.rst	Максим Дубинин
quickstart/eoxserver_quickstart.rst	Geo-U-Piter
quickstart/gdal_quickstart.rst	amuriy
quickstart/geokettle_quickstart.rst	Geo-U-Piter
quickstart/geomajas_quickstart.rst	ergo
quickstart/geomoose_quickstart.rst	Geo-U-Piter
quickstart/geonetwork_quickstart.rst	ergo
quickstart/geopublisher_quickstart.rst	Andrey Syrokomskiy
quickstart/geoserver_quickstart.rst	grozhentsov
quickstart/gmt_quickstart.rst	amuriy
quickstart/gpsdrive_quickstart.rst	ergo
quickstart/gpsprune_quickstart.rst	ergo
quickstart/grass_quickstart.rst	amuriy
quickstart/gvsig_quickstart.rst	HasT
quickstart/internationalisation_quickstart.rst	amuriy
quickstart/kosmo_quickstart.rst	amuriy
quickstart/liblas_quickstart.rst	ergo
quickstart/mapbender_quickstart.rst	Bishop
quickstart/mapfish_quickstart.rst	Denis Rykov
quickstart/mapguide_quickstart.rst	Denis Rykov
quickstart/mapnik_quickstart.rst	Denis Rykov
quickstart/mapproxy_quickstart.rst	yellow_sky
quickstart/mapserver_quickstart.rst	Denis Rykov
quickstart/maptiler_quickstart.rst	Denis Rykov
quickstart/mapwindow_quickstart.rst	Bishop
quickstart/marble_quickstart.rst	yellow_sky
quickstart/mb-system_quickstart.rst	amuriy
quickstart/opencpn_quickstart.rst	amuriy
quickstart/openjump_quickstart.rst	amuriy
quickstart/openlayers_quickstart.rst	Denis Rykov
quickstart/osgearth_quickstart.rst	voltron
quickstart/osgeolive_install_quickstart.rst	Andrey Syrokomskiy
quickstart/osgeolive_quickstart.rst	Andrey Syrokomskiy
quickstart/osm_quickstart.rst	novia
quickstart/ossim_quickstart.rst	voltron
quickstart/otb_quickstart.rst	voltron
quickstart/pgrouting_quickstart.rst	Denis Rykov
quickstart/postgis_quickstart.rst	amuriy
quickstart/pycsw_quickstart.rst	voltron
quickstart/qgis_mapserver_quickstart.rst	yellow_sky
quickstart/qgis_quickstart.rst	voltron
quickstart/quickstart.rst	Andrey Syrokomskiy
quickstart/rasdaman_quickstart.rst	ergo
quickstart/R_quickstart.rst	Максим Дубинин
quickstart/saga_quickstart.rst	darsvid
quickstart/sahana_quickstart.rst	ergo
quickstart/spatialite_quickstart.rst	voltron
quickstart/tinyows_quickstart.rst	Denis Rykov
quickstart/udig_quickstart.rst	Bishop
quickstart/usb_quickstart.rst	amuriy
quickstart/ushahidi_quickstart.rst	Denis Rykov
quickstart/viking_quickstart.rst	Pavel
quickstart/virtualbox_quickstart.rst	Pavel
quickstart/virtualization_quickstart.rst	Pavel
quickstart/vmware_quickstart.rst	Pavel
quickstart/zoo-project_quickstart.rst	Bishop
quickstart/zygrib_quickstart.rst	ergo
standards/csw_overview.rst	Geo-U-Piter
standards/fe_overview.rst	Geo-U-Piter
standards/gml_overview.rst	Denis Rykov
standards/kml_overview.rst	kuzkok
standards/sensorml_overview.rst	Bishop
standards/sld_overview.rst	Denis Rykov
standards/sos_overview.rst	Bishop
standards/standards.rst	amuriy
standards/wcs_overview.rst	kuzkok
standards/wfs_overview.rst	kuzkok
standards/wms_overview.rst	kuzkok
standards/wps_overview.rst	kuzkok