По всем
Стиль ссылок теперь без подчёркивания, а для темы Black изменён и цвет
Ссылки на функции отключены для функций переходящих сами на себя.
AutoIt3.chm
Поправки в функциях File..., IniReadSectionNames, IniRead, StringRegExp.au3, "Элементы управления", Макросы
Обновлены некоторые скрины до Win8
UDFs3.chm
Добавлены ссылки на функции в тексте
_IE... - переведено 30 примеров и 14 функций
WinAPI - правка в 6 примерах, 2 описания переведено
CustomUDFs.chm
_FindTrayToolbarWindow - не отображалась в дереве справки
Добавлена UDF - MemFont (6 функций)
Добавлена UDF - GUIFinder (6 функций)
Добавлены ссылки в примерах для перехода между пользовательскими функциями.
В разделе "Регулярные выражения 2" раскрыты сокращения
В примеры добавлены ссылки на UDF
1. Файлы из каталога "Examples\Helpfile" скопировать в "C:\Program Files\AutoIt3\Examples\Helpfile" с заменой оригинальных. Это нужно для того, чтобы примеры использовались модифицированные и переведённые. Так как файлы справки CHM используют их при нажатии кнопки "Открыть".
2. Содержимое Include скопируйте в папку "AutoIt3\Include", чтобы примеры из CustomUDFs.chm были работоспособными.
3. Файлы справки *.chm скопировать в каталог "C:\Program Files\AutoIt3", заменив оригинальные файлы справки. Для любителей чёрного стиля использовать *.chm из каталога "- Black style help file -"
Структура комплекта сделана в соответствии с оригиналом, что позволяет открывать/запускать примеры (Examples) даже не заменяя оригинальную справку.
Нужно ли заменять справочные файлы версии 3.3.8.1? Да рекомендуется, но сначала сделайте копии англоязычных файлов справки, чтобы заглядывать в них в случае сомнений.
В 2009 г. состоялось моё (AZJIO) первое знакомство с AutoIt v3.3.0.0. На тот момент уже существовала русская справка (версии v3.2.5.4), автором которой является Валерий Викторович Иванов. В конце 2010 года уровень знаний достиг понимания несоответствия русской справки с нововведениями существующей на тот момент версии 3.3.6.1. При обсуждении обновления перевода справки выяснилось, что автор существующей на тот момент русской справки не дал добро на редактирование своей справки или использование её как основы для продолжения работы над переводом другими активными участниками форума AutoIt. Когда я подключился к работе над справкой ведущим был SyDr, и на тот момент было переведено примерно половина нативных функций (в AutoIt3.chm), а функции UDF не переведены совсем (кстати, даже переведённую на тот момент половину я многократно переписывал в последствии). Я сразу перевёл строковые функции, потом раздел GUI. Не хотелось ожидать компиляции, поэтому я спросил у SyDr имеющиеся у него скрипты компилирования и начал сам выкладывать CHM-файлы, взяв инициативу на себя.
Справка активно переводилась мной с конца 2010 по конец 2013 г. За это время полностью были переведены нативные функции (AutoIt3.chm), и наиболее популярные функции UDF (UDFs3.chm) и выполнен переход справки с версии 3.3.6.1 на версию 3.3.8.1. Во время перевода gora постоянно находил орфографические ошибки, поэтому был написан скрипт, который экспортирует русский текст в отдельный файл, что позволило легко проверить орфографические ошибки и исправить их все (их было много). Кстати, благодаря ему было также исправлено много смысловых ошибок, мы общались через ICQ. Redline перевёл раздел SQLite и раздел _Date (на тот момент только популярные 17 функций были переведены мной в _Date). В последствии в SQLite мной были переведены ещё 2 функции при переходе на 3.3.8.1 и исправлены орфографические ошибки и сделана ревизия примеров. RUVATA перевёл раздел Excel, мне пришлось исправить множество орфографических ошибок в нём и заменить слово колесия на коллекция.
Страница "Лицензия" перевёл at
Страница "Описание Obj/COM" перевёл hunterxxx
В процессе работы над справкой находилось множество ошибок в оригинальной англоязычной справке. Чтобы разруливать эту ситуацию и сделать перевод ближе к оригиналу я стал отписывать все найденные недочёты на официальном форуме AutoIt.
На официальном форуме было найдено много интересных UDF, и я решил сделать дополнение к справке в виде CustomUDFs.chm. Это не перевод какой либо справки, это с нуля созданная мной справка и на данный момент содержит 346 функций и 26 статей. В раздел "Обучения" добавлены уроки регулярных выражений от Redline. В последствии я сделал ещё 6 своих заметок по регулярным выражениям.
В процессе работы над справкой модернизировались и скрипты обработки страниц. Была добавлена подсветка элементов кода в описании функций. Макросы, функции, переменные отображаются в описании тем же цветом, что и в коде примеров. Это позволило легко различать специальные элементы кода в описании. В синтаксическом блоке также добавлена подсветка. Числовые параметры подсвечены, а значения по умолчанию подсвечены особым цветом. В примерах элементы кода (функции, ключевые слова, операторы, макросы) являются ссылками на свои описания. Так что легко можно кликнув перейти на страницу непонятной функции, а боковой кнопкой мыши или клавишей BackSpace или кнопкой "Назад" на панели инструментов возвратится к просматриваемому прежде примеру. В описании функций подсвеченные элементы кода также являются ссылками. Исключением являются только те элементы, страницы которых в данный момент просматриваются. Был написан скрипт, которым проверил, чтобы все упоминания функций, макросов, ключевых слов соответствовали регистру букв. Был написан скрипт, которым проверил синтаксис и отступы в синтаксическом блоке. С помощью регулярных выражений были получены значения для таблицы языков в приложении.
Расширенный набор символов (ANSI) сделан для русского языка (в приложении).
В описании функции Number добавлено правило преобразования.
В процессе работы над справкой полностью модернизирован стиль в CSS-файлах. Сделаны два основных стиля справки. Добавлена возможность иметь внешний style.css, который определяет вид всех страниц справки.
1. Выделив (двойным кликом мыши) имя функции, ключевого слова или макроса в редакторе SciTE, с помощью горячей клавиши можно открыть справку на странице описания этой функции
2. Активно используйте вкладку "Поиск", особенно для новичков, когда названия функций ещё не известны, но будут найдены страницы, в которых встречается искомый текст.
3. Вкладка "Указатель" полезна для ввода названий известных функций.
4. Можно настроить AutoIt таким образом, чтобы при клике в справке примеры скриптов будут выполнятся, а не отрываться в редакторе. Нужно в реестре для операции "Open" указать исполнение, а вместо "Run" добавить "Edit" для открытия в редакторе.
5. Добавьте на вкладку "Избранное" часто используемые страницы, например "Операторы", хотя на сегодняшний день найти её легче, чем в предыдущей справке.
6. Для открытия справки используйте файл AutoIt.chm, который добавит в дерево справки три раздела из AutoIt3.chm, UDFs3.chm и CustomUDFs.chm.
Возможно это будет важно в последствии. Вы можете продолжать модернизацию справки, добавляя информацию о проделанной вами работы на эту страницу, но не исключая информацию размещённую здесь.
На время написания этих строк текущая версия AutoIt v3.3.12.0. Обновление перевода требует большого труда и чтобы взятся за него нужно быть готовым. Из обновлений стоит отметить появление новых функций: #pragma, Null, тернарный оператор, Volatile, FileReadToArray, StringReverse, FuncName, IsFunc. Обновлённые в UDF: _Array (поддержка двумерных массивов и ещё 6 функций), _Crypt_GenRandom (есть переименованные), _DebugCOMError, _FileListToArrayRec, _GUIToolTip_Deactivate (ToolTip обновлён), _IEErrorHandlerDeRegister, _IEErrorHandlerRegister, _Excel (очень много изменений), _GDIPlus (многие из которых вы найдёте в CustomUDFs.chm), _Word (переименование, добавление).
Переведено на русский язык
Автор перевода AZJIO
07.2014