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

[Romtek]

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

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

Код: Выделить всё

FreePascal.ru  Wiki:Перевод документации Free Pascal

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

[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]]]

[STAKANOV]

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

Вот страница официальной документации:
<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]

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

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]

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