Что нового

Развитие русской справки

Автор
A

AZJIO

Меценат
Меценат
Сообщения
2,874
Репутация
1,194
Коды @OSLang - пример страницы. Вопрос: в каком порядке расположить колонки и по какой колонке сортировать?
 

ynbIpb

Скриптер
Сообщения
399
Репутация
110
Оставить сортировку как есть, а русский и английский вывести вначало, как самые используемые.
:scratch:
 

CreatoR

Must AutoIt!
Команда форума
Администратор
Сообщения
8,671
Репутация
2,481
AZJIO
Небольшая ошибка в InetRead:

Функция возвращает бинарные данные. Используйте функцию The BinaryToString(), если их необходимо преобразовать в строку.

И ещё, в userfunctions.htm в разделе IniString описание и возвращаемое значение у Read и Delete одинаковое.
 
Автор
A

AZJIO

Меценат
Меценат
Сообщения
2,874
Репутация
1,194
AutoIt3.chm - обновил.
OSLangCodes - таблица теперь содержит 184 языка вместо 126, все на русском языке, сортированы по первой колонке HEX-значений, русский и англ. подсвечены и добавлена колонка сокращений типа ru-RU. Теги языков читаются так: de-AT : language-region : Немецкий, используемый в Австрии.
Перевёл несколько примеров в AutoIt3\Examples\GUI\Advanced

ascii -символы. Теперь содержит символы в кодировке Win1251, тем более что при работе функции Chr будут выводится именно эти символы, а не те что в англ. кодовой странице.

clsid - папки на русском языке

FAQ и LimitsDefaults немного скорректировал, учитывая что в новой справке в FAQ сделано в виде таблицы (15 пункт). Кстати, я думал не добавить ли туда ограничения для целых чисел -9223372036854775807 до 9223372036854775807.
Переведён урок winzip и notepad.

CreatoR
Исправил, перезалил

ynbIpb
Сделал вроде даже лучше - подсветил эти 2 строки и они практически в начале списка в видимой области.

Если кому интересно - на днях перезалил справку общий комплект заменив скрины, особенно это заметно для темы Black, в которой использовал Black-тему Windows7
 
Автор
A

AZJIO

Меценат
Меценат
Сообщения
2,874
Репутация
1,194
UDFs3.7z - добавлено 23 функции _WinAPI_...
_WinAPI_CreateSolidBrush
_WinAPI_EnableWindow
_WinAPI_FindExecutable
_WinAPI_FrameRect
_WinAPI_GetCurrentProcess
_WinAPI_GetCurrentProcessID
_WinAPI_GetCurrentThread
_WinAPI_GetCurrentThreadId
_WinAPI_GetDC
_WinAPI_GetXYFromPoint
_WinAPI_IsWindow
_WinAPI_IsWindowVisible
_WinAPI_LineTo
_WinAPI_LoadString
_WinAPI_MAKELANGID
_WinAPI_MAKELCID
_WinAPI_PointFromRect
_WinAPI_PtInRect
_WinAPI_RectIsEmpty
_WinAPI_ReleaseDC
_WinAPI_SetSysColors
_WinAPI_SetTextColor
_WinAPI_SubLangId
Примерно половине из указанных сделаны примеры, которые отсутствуют в оригинальной справке.
 

Yashied

Модератор
Команда форума
Глобальный модератор
Сообщения
5,379
Репутация
2,724
1. _WinAPI_GetCurrentProcess()

Возвращает псевдодескриптор текущего процесса, из которого вызвана функция.

2. Pen, это не карандаш, а перо. Карандаш - pencil.

3. _WinAPI_MAKELANGID() и _WinAPI_MAKELCID()

В примерах

Код:
MsgBox(0, 'Сообщение', Hex(Int($LCID), 4) & @LF & $LCID)


Int($LCID) лишнее, достаточно просто $LCID.

4. _WinAPI_MAKELANGID()

Primary Language ID - идентификатор языка, а не первичный идентификатор языка.
SubLanguage ID - идентификатор разновидности языка, а не вторичный идентификатор языка.

5. "Устанавливает определяемое программой хук-процедуру в цепочку хуков."

Устанавливает определяемую программой процедуру-ловушку в цепочку ловушек.

6. string-ресурс - строковый ресурс или ресурс типа STRING.

7. _WinAPI_GetWindowPlacement()

Возвращает позицию и размеры окна в развернутом, свёрнутом и нормальном состояниях.

8. _WinAPI_GetWindow()

Возвращает дескриптор окна, которое связано заданным образом с указанным окном.
 
Автор
A

AZJIO

Меценат
Меценат
Сообщения
2,874
Репутация
1,194
1. От оригинала тут не отклонялся, так как толком не понял что за дескриптор.
2. Я спрашивал пару месяцев назад как его обозвать, пишу в двух вариантах, так как встречал трактовку как "Карандаш" и как "перо", учитываю что по смыслу это одно и тоже и даже первое более понятнее тем что в Paint и Photoshop такой же по типу атрибутов интрумент называется карандаш.
3. Тут даже не знаю, может кому то знакомее будет 0419, чем 1049
4. Инфу брал тут, тем более на днях я читал подробности тут. И коментарии в параметрах более точно передают смысл который не вставить в короткую фразу описания, в принципе не противоречит смыслу.
5. Ловушку тоже сочетание в google часто используемое, но у меня не устоялся термин никакой.
7. Я не понимаю нормального состояния, есть @SW_RESTORE, который описывается как восстановленное состояние. Он конечно и есть нормальный.
8. Почему с образом, мне показалось я нормально передал смысл функции, понятным языком.
 

Yashied

Модератор
Команда форума
Глобальный модератор
Сообщения
5,379
Репутация
2,724
1. В оригинале ошибка.
3. Я имел ввиду Hex($LCID, 4).
 
Автор
A

AZJIO

Меценат
Меценат
Сообщения
2,874
Репутация
1,194
Обновил AutoIt3.chm
Заменил [опционально] на [опция], нормально? Просто это слово жирным шрифтом и занимает по ширине приличное место, а смысл практически не поменялся.
В функциях Opt поправки текста, значения в порядке возрастания, в том числе значения по умолчанию подсвечены жирным шрифтом.
FileCreateShortcut - поправки в параметрах.

Обновил UDFs3.chm (Замена текста [опционально] на [опция])
Обновил CustomUDFs.chm
Замена текста [опционально] на [опция]
FileOperations.au3 обновлён, и соответственно параметры в двух функциях
 
Автор
A

AZJIO

Меценат
Меценат
Сообщения
2,874
Репутация
1,194
Опять мучает вопрос с правильным написанием текста [опционально]
Есть варианты
1. [?]
2. [необязательный]
3. [опция]
4. Ваше предложение

Мне больше нравится первый - [?]. Длинный текст мешает чтению, скользить вниз по параметрам и натыкаться на длинное слово и переводить взгляд влево. Достаточно один раз "догадаться" что этот символ означает (и это не трудно) и конечно же о назначении этого символа в параметрах можно упомянуть в описаниии функций. Слово [опция] и [опционально] совсем не интуитивно.
 

CreatoR

Must AutoIt!
Команда форума
Администратор
Сообщения
8,671
Репутация
2,481
Если придерживаться смыслу, то второй вариант.
[?] как то слишком коротко, могут и не понять.
 
Автор
A

AZJIO

Меценат
Меценат
Сообщения
2,874
Репутация
1,194
Когда то долго не мог понять смысла [опциональный], а когда понял что не все параметры можно указывать, то тогда и понял что означает слово [опциональный]. Конечно, для новичка это полезно, но болшее время потом только мешает, поэтому я и предложил короткий вариант. В маске символ ? означает либо есть либо нет. Ну и само наличие непонятного символа заставит подумать в чём отличие параметров с этим символом от параметров без него. Думаю проблемы не будет.
 

CreatoR

Must AutoIt!
Команда форума
Администратор
Сообщения
8,671
Репутация
2,481
AZJIO
Если тебе было сложно понять с «[Опциональный]», то такому же новичку в двойне будет сложно понять что такое «[?]».

Поэтому я тебя очень прошу не используй «[?]», там должно быть слово эквивалентно [Optional] в Английском.
 
Автор
A

AZJIO

Меценат
Меценат
Сообщения
2,874
Репутация
1,194
CreatoR
Я могу вернуть "[опционально]", это на 2 символа короче чем "[необязательный]". Жаль что мало кто отписывается, картина бы сложилась уверенной, как лучше большинству.
Принцип хороший отойти от магических символов.
 

Police

Новичок
Сообщения
27
Репутация
3
А как насчёт вместо "опциональный" или "Не обязательный" так и писать - "параметр"?
 
Автор
A

AZJIO

Меценат
Меценат
Сообщения
2,874
Репутация
1,194
CreatoR
Вот и наглядный пример :smile: новичку без разницы что там написано, а когда поймёт, уже поздно будет, ведь главное назначение понять именно прочитав это слова, а не понять для чего оно там находится.

Police
Это отличие обязательных параметров от необязательных. Если обязательный не указать скрипт выдаст ошибку. Обязательные не помечены, по умолчанию, а необязательные помечены словом [опциональный].
 

Police

Новичок
Сообщения
27
Репутация
3
Если обязательный не указать скрипт выдаст ошибку.
Забыла об этом пункте. :-[ Так бы и в правду была путаница.
Тогда лучше использовать "опциональный"...
 

CreatoR

Must AutoIt!
Команда форума
Администратор
Сообщения
8,671
Репутация
2,481
AZJIO [?]
Я могу вернуть "[опционально]", это на 3 символа короче чем "[не обязательный]".
:blink:
А к чему такая погоня за минимальным числом символов?
 
Автор
A

AZJIO

Меценат
Меценат
Сообщения
2,874
Репутация
1,194
CreatoR
Очень неудобно читать, строки, которые могли бы уместится на одной строке переносятся на другую. По ширине это слово занимает целую колонку.
Я поправил [необязательный] слитно, так что на два символа.
 

kaster

Мой Аватар, он лучший самый
Команда форума
Глобальный модератор
Сообщения
4,020
Репутация
626
опциональный, или необязательный. [?] абсолютно непонятно и ни в коем разе не дает понять природу параметра.
 
Верх