Обновление перевода документации OSGeo Live: различия между версиями

Версия от 03:36, 3 ноября 2015

О чём речь?

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

Пользовательская документация на диске распространяется под свободной лицензией (CC BY 3.0 и CC BY-SA 3.0), представлена в виде набора веб-страниц. В исходном виде документация OSGeo-Live представляет собой текстовые файлы с разметкой reStructuredText.

В 2012 г. в рамках подготовки к конференции "Открытые ГИС - 2012" документация была переведена на русский язык.

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

Схема работы

Файлы делятся на 2 типа: новые (которые ещё не были переведены) и устаревшие (которые надо поправить). Если колонка "рус. текст старый" пустая, то это новый файл, если не пустая - устаревший файл.
Выбрать (никем не занятые) файлы для перевода (где пусто в графе "кто делает").
Сообщить, что берёте такой-то файл, в специальной теме на форуме; скоро ваше имя появится в таблице (можно записаться и самостоятельно).
Скачать файл по ссылке в колонке "англ. текст новый" .
Если файл новый, то надо просто перевести его, оставив имя файла таким же.
Если файл устаревший, надо открыть ссылку в колонке "разница англ. текст старый/новый", там будет наглядно показана разница между текущей версией документа на англ. языке и старой его версией, которую переводили в 2012 г. Нужно скачать файл в колонке "рус. текст старый" и править его.
При переводе желательно соблюдать правила, перечисленные ниже.
Выложить переведённые файлы в той же теме на форуме или прислать в личном сообщении координатору.

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

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

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

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

Всего: 83 файла, в работе: 11, готово: 0, свободно: 72.

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

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

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

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

 
: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/

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

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

@@ Строка 77: / Строка 77: @@
 |
 | [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
-|----
+|----  style="background-color:Yellow"
 |R_overview.rst
 |http://gis-lab.info/docs/osgeo/update_2015/edits/R_overview.rst
 |[http://trac.osgeo.org/osgeo/changeset?new=12279@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2FR_overview.rst&amp;old=11984@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2FR_overview.rst link]
 |http://gis-lab.info/docs/osgeo/update_2015/ru/overview/R_overview.rst
-|
+| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=2 Максим Дубинин]
 |----
 |cartaro_overview.rst
@@ Строка 89: / Строка 89: @@
 |
 |
-|----
+|---- style="background-color:Yellow"
 |cesium_overview.rst
 |http://gis-lab.info/docs/osgeo/update_2015/new/cesium_overview.rst
 |
 |
-|
+| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=2 Максим Дубинин]
 |----
 |geomajas_overview.rst
@@ Строка 113: / Строка 113: @@
 |http://gis-lab.info/docs/osgeo/update_2015/ru/overview/geonetwork_overview.rst
 |
-|----
+|---- style="background-color:Yellow"
 |geonode_overview.rst
 |http://gis-lab.info/docs/osgeo/update_2015/new/geonode_overview.rst
 |
 |
-|
+| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=2 Максим Дубинин]
 |----
 |grass_overview.rst
@@ Строка 173: / Строка 173: @@
 |
 |
-|----
+|---- style="background-color:Yellow"
 |netcdf_dataset_overview.rst
 |http://gis-lab.info/docs/osgeo/update_2015/new/netcdf_dataset_overview.rst
 |
 |
-|
+| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=2 Максим Дубинин]
 |---- style="background-color:Yellow"
 |openlayers_overview.rst
@@ Строка 245: / Строка 245: @@
 |
 |
-|----
+|---- style="background-color:Yellow"
 |cesium_quickstart.rst
 |http://gis-lab.info/docs/osgeo/update_2015/new/cesium_quickstart.rst
 |
 |
-|
+| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=2 Максим Дубинин]
 |----
 |deegree_quickstart.rst

Обновление перевода документации OSGeo Live: различия между версиями

Версия от 03:36, 3 ноября 2015

Содержание

О чём речь?

Схема работы

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

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

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

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

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

Навигация

Обновление перевода документации OSGeo Live: различия между версиями

Версия от 03:36, 3 ноября 2015

О чём речь?

Схема работы

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

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

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

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

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

Навигация

Поиск