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

Обсуждение вариантов переводов, организационных вопросов и других моментов...

Модератор: Модераторы

Сообщение Romtek » 24.07.2005 14:13:25

Насчёт подсветки синтаксиса никто не высказался, а жаль. :(

Есть ещё предложение: добавить ссылку на Вики-переводы документации под эмблемой сайта справа от ссылки FreePascal.ru:
Код: Выделить всё
FreePascal.ru  Wiki:Перевод документации Free Pascal

Так, по-моему, гораздо бОльшее количество людей заметит этот важный источник информации.
Аватара пользователя
Romtek
постоялец
 
Сообщения: 190
Зарегистрирован: 22.05.2005 12:29:35
Откуда: Рамат Ган

Сообщение SovNarKom » 24.08.2005 13:29:06

Внимание, вопрос!

Вот страница официальной документации:
<a href='http://community.freepascal.org:10000/docs-html/rtl/classes/index.html' target='_blank'>http://community.freepascal.org:10000/docs...sses/index.html</a>
Сверху там навигационная панель, так вот, как такое повторить в Вики,
ведь названия повторяются для разных модулей, т.е. такое не катит:
[Overview][[[Constants]]][[[Types]]][[[Classes]]][[[Procedures and functions]]][[[Variables]]]
SovNarKom
постоялец
 
Сообщения: 389
Зарегистрирован: 28.05.2005 10:37:39
Откуда: Воронеж [vrn] [36]

Сообщение STAKANOV » 16.09.2005 15:42:08

SovNarKom писал(а): Внимание, вопрос!

Вот страница официальной документации:
<a href='http://community.freepascal.org:10000/docs-html/rtl/classes/index.html' target='_blank'>http://community.freepascal.org:10000/docs...sses/index.html</a>
Сверху там навигационная панель, так вот, как такое повторить в Вики,
ведь названия повторяются для разных модулей, т.е. такое не катит:
[Overview][[[Constants]]][[[Types]]][[[Classes]]][[[Procedures and functions]]][[[Variables]]]

<a href='http://ru.wikipedia.org/wiki/%D0%92%D0%B8%D0%BA%D0%B8%D0%BF%D0%B5%D0%B4%D0%B8%D1%8F:%D0%92%D0%B8%D0%BA%D0%B8%D1%84%D0%B8%D0%BA%D0%B0%D1%82%D0%BE%D1%80' target='_blank'>читать здесь</a>
Аватара пользователя
STAKANOV
энтузиаст
 
Сообщения: 1069
Зарегистрирован: 14.05.2006 21:26:24
Откуда: Зеленоград

Сообщение STAKANOV » 16.09.2005 18:25:51

Предлагаю при переводе документации предерживаться некоторых принципов:

1)Идентификаторы страниц вида имя_модуля.элемент, где элемент это раздел, идентификатор типа, идентификатор константы, идентификатор процедуры и тп

Например
BaseUnix - краткое описание модуля BaseUnix
BaseUnix.Types - идентификатор(или правильней викификатор?) страницы содержащей описание типов модуля BaseUnix
BaseUnix.Constants - то же для констант
BaseUnix.Procdures - то же для процедур и функций
BaseUnix.ARG_MAX - страница с описание константы ARG_MAX

Как я понимаю не может быть одного и того же идентификатора у процедуры, типа или константы

2) Вверху страницы вставлять шаблон вида {{имя_модуля-navig}} содержащий элементы навигации

Пример baseunix-navig :
Код: Выделить всё
[[BaseUnix|[Обзор]]] [[BaseUnix.Constants|[Константы]]] [[BaseUnix.Types|[Типы]]] [[BaseUnix.Procedures|[Процедуры и функции]]]
Аватара пользователя
STAKANOV
энтузиаст
 
Сообщения: 1069
Зарегистрирован: 14.05.2006 21:26:24
Откуда: Зеленоград

Сообщение STAKANOV » 16.09.2005 22:28:16

Похоже я не очень удачную идею предложил - название страницы автоматом попадает в заголовок.... :(
Аватара пользователя
STAKANOV
энтузиаст
 
Сообщения: 1069
Зарегистрирован: 14.05.2006 21:26:24
Откуда: Зеленоград

Пред.

Вернуться в Переводы

Кто сейчас на конференции

Сейчас этот форум просматривают: нет зарегистрированных пользователей и гости: 4

Рейтинг@Mail.ru