Ещё раз о русской справке :)

SyDr
Теперь понял . Ну да крупный шрифт это перебор. Я взял из новой справки самое лучшее - верхнюю строку и оранжевый цвет.

AZJIO [?]

Новый стиль справки на пробу

Нажмите, чтобы раскрыть...

Мне понравилось.

1) Пример отображается без AutoIt подсветки - как обычный текст. Это так и должно быть ?
2) Не очень видно. Может лучше исправить ?:

AZJIO сказал(а):

Новый стиль справки на пробу...

Нажмите, чтобы раскрыть...

Супер, только "оранжевые" слова лучше сделать кеглем на 1-2 пункта побольше.

P.S

Вообще, этот стиль изначально (совсем недавно) появился в MSDN.

Нашел ошибку перевода для функции MsgBox (флаги):

4096 System modal (dialog has an icon)
переведено как:
4096 Системная, поверх всех окон (System modal)

Обновил справку (10 МБ). Теперь новый стиль внедрил в справку сделав все поправки, так, что у меня претензий нет, всё что хотел, сделал.

Подробнее:
1. В css не указывал размер шрифта, что позволяет равномерно увеличивать шрифт с помощью кнопки "Шрифт" на панели инструментов (при нажатии кнопки "Шрифт" 5 раз увеличивается шрифт, потом сбрасывается в минимум и снова по кругу). На офсайте этот момент упустили.
2. Название функции вернул как было, размер=+1, цвет синий, добавлен класс в css
3. Описание функции, шрифт small (по умолчанию для текста x-small), добавлен класс в css
4. Синтаксис на жёлтом фоне - убрал засечки
5. Для оранжевых текстов подправил класс
6. Заменил "Описание макросов" на "Макросы", "Описание ключевых выражений" на "Ключевые слова/выражения"
7. Заменил "Замечания" на "Примечания"
8. В разделе "Макросы" к макросам применил стиль как в SciTE
9. Установил размер окна справки при первом запуске 1024х768
10. Неподсвеченый код по тексту сделал подсвеченным
и другие поправки...

Zaramot
Исправил.

asdf8

Нашел ошибку перевода

Нажмите, чтобы раскрыть...

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

AZJIO

AZJIO [?]

когда правильный перевод не передаёт какой либо полезной информации

Нажмите, чтобы раскрыть...

не переведено, что у заголовка окна сообщения появляется иконка.

В последнем варианте я использовал шрифт Segoe UI, который сделал мелким шрифт в описании и жирный шрифт слишком жирным. Если этот шрифт напрягает то могу перекомпилировать сейчас, иначе до следующей версии. Верну как было - Verdana для некоторых текстов.

CreatoR
Чтоб пересечений не было, хотел бы перевести в разделе "Описание GUI" и "Обучение --> Регулярные выражения.

AZJIO, нормальное отображение прозрачности зависит не от винды, а от версии ИЕ. В шестой оно фиговенько работает.

Обновил AutoIt_SRC_compile.7z
В GUI добавлены галочки для отключения подсвечивания переменных и макросов в тексте (по умолчанию включено).

Обновил справку (10 МБ).
1. Восстановил шрифт Verdana
2. Подсвечивание переменных и макросов в тексте
3. Переведено 67 примеров
4. Вcе PNG имеющие прозрачность конвертированы в GIF (html-поправлены)

SyDr
В справке часто упоминается выражение "вещественное число", честно говоря заставляет искать в гугле, что же это за такое число, как я понял в справке применяется для "чисел с плавающей точкой", кстати, фраза тоже не очень интуитивная, при этом разные понятия, так как вещественное включает в себя целые числа, а с плавающей точкой заведомо только дробные числа. Чтоб было понятно для человека закончившего школу можно использовать термин "десятичная дробь" или "десятичная дробь с плавающей точкой" чтоб понятно было и привыкалось к фразе "с плавающей точкой".

AZJIO
"Число с плавающей точкой/запятой" - наилучший вариант. Интуитивно понятного определения не существует (что весьма естесственно - в реальной жизни этому понятию нет аналога). В идеале, когда человек открывает справку и знакомится с AutoIt, он уже должен иметь какие-то, самые общие представления, о программировании вообще. Не вижу необходимости пытаться заменить одно понятие другим (писать слово дробь нельзя - это ведь не дробь, так? Так же и со словом десятичная).

SyDr

писать слово дробь нельзя - это ведь не дробь, так? Так же и со словом десятичная

Нажмите, чтобы раскрыть...

Тогда надо как то разграничить понятия, например для функции IsFloat в данном контексте имеется ввиду десятичная дробь а не форма записи 1.5e3

На счёт онлайн версии - делается просто:
1. Извлекается файлы справки AutoIt3.chm и UDFs3.chm в отдельные каталоги. Каталог "UDFs3\html\libfunctions" переместить в папку "AutoIt3\html"
2. Две строки удалить по всем файлам автоматически
3. Содержимое каталога "AutoIt3\html" скопировать на сервер в папку AutoIt3 или DOC.

вот скрипт

Перезалил справку и компилятор по ссылкам выше, обновления затронули только файл AutoIt3.chm (1.4 МБ). Переведены примеры Tray и другие.
Оставшиеся непереведённые примеры:

ConsoleRead
FtpSetProxy
GuiCtrlCreateGraphic
GUICtrlRegisterListViewSort
GuiCtrlSetGraphic
GUIStartGroup
ObjCreate
ObjEvent
ObjGet
ObjName
Static
StdinWrite
с префиксом TCP
с префиксом UDP
WinGetCaretPos

Нажмите, чтобы раскрыть...

http://autoit-script.ru/autoit3_docs/keywords.htm
вот тут все ссылки имеют обратный слеш вместо обычного, и поэтому ведут в никуда. в других ссылках пока не замечал


Добавлено:

Сообщение автоматически объединено: 23 Дек 2011

мои скудные пять копеек
http://autoit-script.ru/autoit3_docs/keywords/Dim.htm

Уникальной возможностью AutoIt является возможность копировать массивы:

Нажмите, чтобы раскрыть...

я понимаю, что именно эта фраза и в английском переводе, но эта возможность не уникальна для autoit. я могу привести как минимум один ЯП, где есть точно такая же возможность. копирование стека без предварительного объявления - python.

http://autoit-script.ru/autoit3_docs/keywords/For.htm

Цикл For завершает свою работу, когда значение variable становится большим, чем значение stop.

Нажмите, чтобы раскрыть...

опять же, так написано в английской версии, но эта фраза истинна, только если step > 0. поэтому лучше если сразу оговорить оба случая

Цикл For завершает свою работу, когда значение variable становится большим, чем значение stop если step > 0, или когда значение variable становится меньшим, чем значение stop если step < 0

Нажмите, чтобы раскрыть...

и еще, вот тут

start > stop и step > 0, или
start < stop и step отрицательно

Нажмите, чтобы раскрыть...

как-то нелогично, что одно условие с применением мат. символа, другое словесно. по мне, элегантнее если в одном стиле

start > stop и step > 0, или
start < stop и step < 0

Нажмите, чтобы раскрыть...

start > stop и step положительно, или
start < stop и step отрицательно

Нажмите, чтобы раскрыть...

это из тех, что приглянулись.

вот еще набросал

http://autoit-script.ru/autoit3_docs/introduction.htm
"крипты" вместо "скрипты"

"Совместимость с Windows 2000 / XP / 2003 / Vista / 2008 " - может добавить Windows 7 в список?

A staggering amount of string handling functions - Ошеломляющее количество функций для обработки строк

All the mouse and keyboard routines are highly configurable both in terms of simulation "speed" and functionality - Все функции для работы с мышью и клавиатурой являются в крайней степени настраиваемыми с точки зрения скорости выполнения и функциональности

You can expect to move, hide, show, resize, activate, close and pretty much do what you want with windows. Windows can be referenced by title, text on the window, size, position, class and even internal Win32 API handles - Вы можете делать с окнами практически все, что захотите - двигать, делать видимыми и невидимыми, менять размер, активировать, закрывать. К окну можно обратиться по заголовку, тексту в нем, размеру, расположению, классу и даже по внутреннему идентификатору в Win32 API.

Directly get information on and interact with edit boxes, check boxes, list boxes, combos, buttons, status bars without the risk of keystrokes getting lost. Even work with controls in windows that aren't active! - Напрямую получать информацию и взаимодействовать/управлять с [все те термины, которые в дальнейшем используются в справке для вышеназванных элементов], без риска "потерять" какие либо нажатия клавиш. У вас даже есть возможность работать с элементами управления/контролами (смотря, что используется в справке в дальнейшем) в неактивных окнах

И еще, предлагаю избавиться от чрезмерного употребления троеточий, особенно в середине предложений.

http://autoit-script.ru/autoit3_docs/faq.htm
Previous versions of AutoIt were fine for what they were designed for - writing simple scripts to help with software installations. Over time people began using it for general and complicated scripting tasks. The old syntax and structure made this possible but very very difficult and cumbersome. The decision was made to make AutoIt more suitable for general automation tasks and to achieve that a more standard and basic-like language was made. This also means that if you already know a scripting language you will pick AutoIt v3 up easily. - Предыдущие версии AutoIt хорошо справлялись с задачами, для которых они были предназначены - создание простых скриптов упрощающих установку программ. Но со временем, люди начали использовать его для более общих и сложных задач. Старый синтаксис и структура языка не исключали такой возможности, хотя это давалось с трудом и скрипты были громоздкими. Было принято решение сделать AutoIt более подходящим для общих задач автоматизации. Для достижения этой цели был создан новый более стандартизированный бейсикоподобный язык программирования. Это означает, что если вы уже знакомы с какими-либо скриптовыми языками программирования, то вы, скорее всего, с легкостью освоите AutoIt v3.

No. In fact in many instances it's much easier than previous versions as you don't have to try and force the language to do something it was never designed to do. It also uses a familiar BASIC-like language, and BASIC is known for being...well...basic - Нет. На самом деле, в большинстве случаев это даже легче, чем в старых версиях - вам не надо будет пытаться насильно использовать язык для задач, для которых он никогда не был предназначен. Так же, новая версия языка использует знакомый бейсикоподобный синтаксис, а BASIC бла бла бла [последнюю часть, думаю лучше не переводить, там обыгрывается название языка на английском языке]

The vast majority of old AutoIt scripts were focused around software installation and clicking "Next" a lot in dialog boxes. Most of these scripts can be converted to v3 simply by adding a couple of brackets here and there. Here is an example of such a script in v2 and v3 (simulating a software installation with a few dialogs that have a Next button and a Finish button) - Подавляющее большинство старых AutoIt скриптов были сосредоточены на установке программного обеспечения/программ и нажатия на кнопку "Далее/Next" в большом количестве разного рода диалоговых окон. Основная часть этих скриптов могут быть конвертированы в версию 3 языка простым добавлением нескольких скобок в том или ином месте. Ниже пример такого скрипта в версиях 2 и 3 (эмуляция установки программы с несколькими диалоговыми окнами с кнопками "Дальше/Next" и "Завершить/Finish")

Now, that wasn't so bad! As all "strings" are enclosed in quotes you no longer have to wrestle with problems caused by leading and trailing spaces in text. There is also fantastic support for many text editors so that when you are writing v3 scripts you can have syntax highlighting which makes everything much easier. - Не так уж и сложно, не правда ли? Так как все "строки" теперь заключаются в кавычки, то больше нет необходимости мучаться с предшествующими и последующими пробелами в тексте. Теперь, так же, существует поддержка подсветки синтаксиса для большого количества текстовых редакторов при написании скриптов на версии 3, что делает этот процесс еще проще.

The first thing you should ask yourself is "Do I need to convert my script?". v2.64 will continue to be downloadable and supported so don't update all your scripts just for the sake of it - well not unless you want to - Первое, что вы должны спросить себя - Действительно ли я хочу конвертировать свои скрипты? Версия v2.64 будет поддерживаться и далее и возможность скачивать ее сохранится и в будущем. Поэтому, ради своих же скриптов (еще вариант ради работоспособности), не обновляйте их, до тех пор, пока сами этого не захотите.

There is a section in the Help file that shows how the commands in v2 and v3 are related - click here to see the page. - В файле справки есть секция описывающая как связаны аналогичные функции в версиях 2 и 3. Кликните здесь, чтобы открыть эту страницы.

One of the AutoIt v3 authors has written a utility to automatically convert v2 scripts to v3. Conversion is pretty good unless your code is a rats-nest of gotos You can find the converter in the "Extras" directory (Start \ AutoIt v3 \ Extras - or look in the directory that you installed AutoIt v3). - Один из авторов AutoIt v3 написал утилиту для автоматической конвертации скриптов из версии 2 в 3, которая работает хорошо, если только ваш скрипт не утопает в большом количестве переходов goto. Вы можете найти конвертер в папе "Extras" (Пуск - AutoIt v3 - Extras, либо ищите в папке, куда был установлен AutoIt).

Gone. It's evil. No, you can't ask why - it just is. It's like that lump of rock they find in the microwave at the end of the film Time Bandits - Нету, пропала, как сказал Дейкстра goto - источник зла и спагетти-кода. И даже не спрашивайте почему. Дальше шутка, для узкого круга людей смотревших фильм Time bandits, и по мне в переводе не нуждается

AutoIt v3 features most of the common "loops" in use today and with these Goto is no longer required. Look up While, Do, For, ExitLoop, ContinueLoop and Functions for the modern way of doing things And while you are looking at help file sections check out these on loops, conditional statements and functions. I promise you, once you have got the hang of such things you will be able to script in virtually any other language within a couple of minutes. - AutoIt v3 имеет в наличии большинство широко распространенных операторов цикла, что избавляет от необходимости использовать GOTO. Посмотрите в справочнике на While, Do, For, ExitLoop, ContinueLoop и раздел для функций, если хотите делать такие вещи правильно. Пока вы смотрите разделы справки, обратите так же внимание на эти разделы по циклам, условным операторам и функциям. Я вам обещаю, если вы освоите эти понятия и приемы вы будете в состоянии создавать скрипты практически на любом другом языке программирования через пару минут изучения Довольно смелое утверждение, однако

Just to get you started, the most basic use of Goto in version 2.64 was an infinite loop like: - Для начала взгляните на скрипт ниже, который демонстрирует использование оператора GOTO в версии v2.64 для получения бесконечного цикла:

A simple v3 version of that is a While loop that is always "true". – Аналогичный скрипт в версии 3 реализуется с использованием While-цикла, проверка условия которого всегда дает истину.

If you wanted to run something like a DOS "Dir" command then you must run it though the command interpreter (command.com or cmd.exe depending on your OS). The @Comspec macro contains the correct location of this file. You should use the RunWait() function as it waits for the DOS program to finish before continuing with the next line of the script. Here is an example of running the DOS Dir command on the C: drive: (effectively running the command command.com /c Dir C:\ ) – Если вы хотите использовать DOS-команды наподобие “DIR”, тогда вы должны запустить ее в командном интерпретаторе (command.com или cmd.exe, в зависимости от вашей ОС). Макро @ComSpec содержит правильное расположение этого файла. Вам следует использовать функцию RunWait(), так как она ждет пока DOS-команда завершит свое действие прежде чем переходит к следующей строке. Ниже вы найдете скрипт, который выполняет команду “DIR” для папки “С:”

Only a few file extensions are usually "runable" - these are .exe, .bat, .com, .pif. Other file types like .txt and .msi are actually executed with another program. When you double click on a "myfile.msi" file what actually happens in the background is that "msiexec.exe myfile.msi" is executed. So to run a .msi file from AutoIt you would do: - Лишь некоторые расширения файлов, как правило, относятся к “запускаемым”. Например .exe, .bat, .com, .pif. Остальные, такие, как .txt или .msi, запускается посредством других программ. Когда вы делает двойной клик по файлу “myfile.msi”, незаметно для вас в фоне выполняется команда “msiexec.exe myfile.msi”. Поэтому для запуска .msi файлов из AutoIt вам следует сделать как в скрипте ниже:

Or, run the command "start" which will automatically work out how to execute the file for you: - Или выполните команду “start”, который автоматически определит как именно нужно запустить тот или иной файл

Or, use the ShellExecuteWait function which will automatically work out how to execute the file for you: - Еще один вариант - использовать функцию ShellExecuteWait, которая так же автоматически определит нужный способ запуска файла.

If you want to use double-quotes inside a string then you must "double them up". So for every one quote you want you should use two. For example if you wanted to set a variable to the string: A word in "this" sentence has quotes around it! You would do: - Если вы хотите использовать двойные кавычки внутри строки, то вам следует удвоить их кол-во, то есть для каждой двойной кавычки используйте две. Например, если вы хотите переменной присвоить строку: Вот “это” слово в предложении обрамлено кавычками!, то вам надо сделать следующее:

or use single quotes instead: - либо использовать одинарные кавычки:

There is a detailed description here. - Более детальную информацию вы можете найти тут

If you have a variable called $msg and you want to print in inside a MsgBox then this will NOT work: - Если у вас есть переменная с именем $msg и вы хотите вывести его в MsgBox, то следующая конструкция не сработает.

It will actually print My variable is $msg . What you need to do is tell AutoIt to join the string and the variable together using the & operator: - Фактически это выведит на экран My variable is $msg. Вам же следует указать интерпретатору, что необходимо соединить строку и переменную вместе посредством оператора &:

Advanced: If you have many variables to add into a string then you may find the StringFormat() function useful. For example, if I wanted to insert $var1 to $var5 into a string then it may be easier to do: - Дополнение: Если у вас много переенных для объедения в строку, использование функции StringFormat() может оказаться крайне полезным для вас. К примеру, если вы хотите объединить все переменные от $var1 до $var5, то можно использовать следующую конструкцию:

If you are sending the contents of a variable then be mindful that if it contains special send characters like ! ^ + {SPACE} then these will be translated into special keystrokes - rarely what is wanted. To overcome this use the RAW mode of Send() that does not translate special keys: - Если вы используете функцию Send для отправки содержимого переменной, имейте в виду, что если эта переменная содержит специальные символы, такие как ! ^ + {SPACE}, то при отправке они будут переведены в специальные сочетания клавиш. А это врядли то, что вам нужно. Для предотвращения подобных случаев используйте отправку каждого символа “как он есть” - с определенным ключом, как в коде ниже:

Generally a return value is used to indicate the success of a function. But, if a function is already returning something ( like WinGetText() ) then we need to have a way of working out if the function was successful, so we set @error instead.: - Как правило, возвращаемое значение служит индикатором успешного выполнения функции. Но, если функция возвращает значение при любом исходе (например функция WinGetText() ), необходим способ выяснить успешность выполнения. В таких случаях, выставляется макро @error.

Ah, an easy one. If you want to make your script exit when you press a certain key combination then use the HotKeySet() function to make a user function run when the desired key is pressed. This user function should just contain the Exit keyword.
Here some code that will cause the script to exit when CTRL+ALT+x is pressed: - Если вы хотите завершить скрипт по нажатию определенной комбинации клавиш, используйте функцию HotKeySet(), которая запускает функцию определенную пользователем при нажатии желаемой комбинации. Эта пользоавтельская функция должна содержать ключевое слово Exit.
Ниже приведен код, который завершает скрипт при нажатии на комбинацию CTRL+ALT+x:

You need to run the full compiler program (rather than just right-clicking a script and selecting compile). This page describes the compiler in detail. - Вам надо запустить программу компиляции скриптов (а не просто выбрать “Компиляция/Compile” при клике правой кнопкой мыши на файл скрипта). Этот раздел справки описывает работу компилятора более детательно.

Use the _Singleton() function. See the User Defined Functions documentation for more information on _Singleton() and how to use it. - Используйте функцию _Singleton(). Посмотрите раздел справки по пользовательским функциям (UDF) для более детальной информации по работе функции _Singleton() и способов ее применения.

Here are details of the current technical limits of AutoIt. Please note that some of the limits are theoretical and you may run into performance or memory related problems before you reach the actual limit. - Ниже вы найдите текущие технические ограничения налагаемые на AutoIt. Имейте в виду, что некоторые ограничения сугубо теоретические и вы скорее достигнете пределы производительности или операционной памяти, прежде чем сработает ограничение.

Maximum length of a single script line: 4,095 - Максимальная длина одной строки скрипта

Maximum string length: 2,147,483,647 characters - Максимальная длина строквой переменной
Number range (floating point): 1.7E–308 to 1.7E+308 with 15-digit precision - Диапазон действительных чисел (точность до 15 знаков после запятой)

Number range (integers): 64-bit signed integer - Диапазон целых чисел (64битный целый знаковый тип)

Hexadecimal numbers: 32-bit signed integer (0x80000000 to 0x7FFFFFFF) - Диапазон шестнадцатиричных числел: 32-битный целый знаковый тип
Arrays: A maximum of 64 dimensions and/or a total of 16 million elements - Массивы: максимальное кол-во измерений - 64 и/или общее кол-во элементов 16 млн.

Maximum depth of recursive function calls: 5100 levels - Максимальный уровень вложенности рекурсии - 5100
Maximum number of variables in use at one time: No limit - Максимальное кол-во одновременно используемых переменных Одновременно используемый или в одном скрипте?

Maximum number of user defined functions: No limit - Максимальное кол-во пользовательских функций

Maximum number of GUI windows: No limit - Максимальное кол-во GUI окон
Maximum number of GUI controls: 65532 - Максимальное колв-во элементов управления окон

This should be the Open button that enable you to open the Examples in the Help file.
This issue is that the hhctrl.ocx isn't properly registered or corrupted.
Try registering it by doing "regsvr32 hhctrl.ocx" from the command prompt or check if the file is still valid. - Это должна была быть кнопка “Открыть/Open”, которая открывает примеры из справки в окне редактора. Такого рода ошибка возникает, когда библиотека hhctrl.ocx неправильно зарегистрирована в системе или файл который ее содержит испорчен.

Промежуточный варианты:
AutoIt3.7z (1.5 МБ)
AutoIt3B.7z (1.5 МБ) - Black
Helpfile.7z (56.0 КБ) - файлы подмены примеров

Оставшиеся 2 файла в разделе "Описание Gui", на половину "Регулярные выражения", 10 поправок в примерах, поправки по функциям.

Kaster
Там же файлы хоть в исходниках, хоть в самом chm можно вытащить, потом намного проще, скопировать файл, а не вычитывать тексты по кускам.

AZJIO
мне было лень заморачиваться с chm на маке. куда проще просто тут накидать.

AZJIO
Файлы залиты без расширения?

gora [?]

Файлы залиты без расширения?

Нажмите, чтобы раскрыть...

Это rghost так уже пару дней глючит, иногда убирая расширение при скачивании.

а в этой теме можно сделать шапку со сслыками на последнюю версию файлов?