Коды @OSLang - пример страницы. Вопрос: в каком порядке расположить колонки и по какой колонке сортировать?
Развитие русской справки
- Автор темы AZJIO
- Дата начала
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
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
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
_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
- Сообщения
- 5,379
- Репутация
- 2,724
1. _WinAPI_GetCurrentProcess()
Возвращает псевдодескриптор текущего процесса, из которого вызвана функция.
2. Pen, это не карандаш, а перо. Карандаш - pencil.
3. _WinAPI_MAKELANGID() и _WinAPI_MAKELCID()
В примерах
Int($LCID) лишнее, достаточно просто $LCID.
4. _WinAPI_MAKELANGID()
Primary Language ID - идентификатор языка, а не первичный идентификатор языка.
SubLanguage ID - идентификатор разновидности языка, а не вторичный идентификатор языка.
5. "Устанавливает определяемое программой хук-процедуру в цепочку хуков."
Устанавливает определяемую программой процедуру-ловушку в цепочку ловушек.
6. string-ресурс - строковый ресурс или ресурс типа STRING.
7. _WinAPI_GetWindowPlacement()
Возвращает позицию и размеры окна в развернутом, свёрнутом и нормальном состояниях.
8. _WinAPI_GetWindow()
Возвращает дескриптор окна, которое связано заданным образом с указанным окном.
Возвращает псевдодескриптор текущего процесса, из которого вызвана функция.
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()
Возвращает дескриптор окна, которое связано заданным образом с указанным окном.
1. От оригинала тут не отклонялся, так как толком не понял что за дескриптор.
2. Я спрашивал пару месяцев назад как его обозвать, пишу в двух вариантах, так как встречал трактовку как "Карандаш" и как "перо", учитываю что по смыслу это одно и тоже и даже первое более понятнее тем что в Paint и Photoshop такой же по типу атрибутов интрумент называется карандаш.
3. Тут даже не знаю, может кому то знакомее будет 0419, чем 1049
4. Инфу брал тут, тем более на днях я читал подробности тут. И коментарии в параметрах более точно передают смысл который не вставить в короткую фразу описания, в принципе не противоречит смыслу.
5. Ловушку тоже сочетание в google часто используемое, но у меня не устоялся термин никакой.
7. Я не понимаю нормального состояния, есть @SW_RESTORE, который описывается как восстановленное состояние. Он конечно и есть нормальный.
8. Почему с образом, мне показалось я нормально передал смысл функции, понятным языком.
2. Я спрашивал пару месяцев назад как его обозвать, пишу в двух вариантах, так как встречал трактовку как "Карандаш" и как "перо", учитываю что по смыслу это одно и тоже и даже первое более понятнее тем что в Paint и Photoshop такой же по типу атрибутов интрумент называется карандаш.
3. Тут даже не знаю, может кому то знакомее будет 0419, чем 1049
4. Инфу брал тут, тем более на днях я читал подробности тут. И коментарии в параметрах более точно передают смысл который не вставить в короткую фразу описания, в принципе не противоречит смыслу.
5. Ловушку тоже сочетание в google часто используемое, но у меня не устоялся термин никакой.
7. Я не понимаю нормального состояния, есть @SW_RESTORE, который описывается как восстановленное состояние. Он конечно и есть нормальный.
8. Почему с образом, мне показалось я нормально передал смысл функции, понятным языком.
Обновил AutoIt3.chm
Заменил [опционально] на [опция], нормально? Просто это слово жирным шрифтом и занимает по ширине приличное место, а смысл практически не поменялся.
В функциях Opt поправки текста, значения в порядке возрастания, в том числе значения по умолчанию подсвечены жирным шрифтом.
FileCreateShortcut - поправки в параметрах.
Обновил UDFs3.chm (Замена текста [опционально] на [опция])
Обновил CustomUDFs.chm
Замена текста [опционально] на [опция]
FileOperations.au3 обновлён, и соответственно параметры в двух функциях
Заменил [опционально] на [опция], нормально? Просто это слово жирным шрифтом и занимает по ширине приличное место, а смысл практически не поменялся.
В функциях Opt поправки текста, значения в порядке возрастания, в том числе значения по умолчанию подсвечены жирным шрифтом.
FileCreateShortcut - поправки в параметрах.
Обновил UDFs3.chm (Замена текста [опционально] на [опция])
Обновил CustomUDFs.chm
Замена текста [опционально] на [опция]
FileOperations.au3 обновлён, и соответственно параметры в двух функциях
Опять мучает вопрос с правильным написанием текста [опционально]
Есть варианты
1. [?]
2. [необязательный]
3. [опция]
4. Ваше предложение
Мне больше нравится первый - [?]. Длинный текст мешает чтению, скользить вниз по параметрам и натыкаться на длинное слово и переводить взгляд влево. Достаточно один раз "догадаться" что этот символ означает (и это не трудно) и конечно же о назначении этого символа в параметрах можно упомянуть в описаниии функций. Слово [опция] и [опционально] совсем не интуитивно.
Есть варианты
1. [?]
2. [необязательный]
3. [опция]
4. Ваше предложение
Мне больше нравится первый - [?]. Длинный текст мешает чтению, скользить вниз по параметрам и натыкаться на длинное слово и переводить взгляд влево. Достаточно один раз "догадаться" что этот символ означает (и это не трудно) и конечно же о назначении этого символа в параметрах можно упомянуть в описаниии функций. Слово [опция] и [опционально] совсем не интуитивно.
Когда то долго не мог понять смысла [опциональный], а когда понял что не все параметры можно указывать, то тогда и понял что означает слово [опциональный]. Конечно, для новичка это полезно, но болшее время потом только мешает, поэтому я и предложил короткий вариант. В маске символ ? означает либо есть либо нет. Ну и само наличие непонятного символа заставит подумать в чём отличие параметров с этим символом от параметров без него. Думаю проблемы не будет.
- Сообщения
- 8,673
- Репутация
- 2,485
AZJIO
Если тебе было сложно понять с «[Опциональный]», то такому же новичку в двойне будет сложно понять что такое «[?]».
Поэтому я тебя очень прошу не используй «[?]», там должно быть слово эквивалентно [Optional] в Английском.
Если тебе было сложно понять с «[Опциональный]», то такому же новичку в двойне будет сложно понять что такое «[?]».
Поэтому я тебя очень прошу не используй «[?]», там должно быть слово эквивалентно [Optional] в Английском.
CreatoR
Вот и наглядный пример
новичку без разницы что там написано, а когда поймёт, уже поздно будет, ведь главное назначение понять именно прочитав это слова, а не понять для чего оно там находится.
Police
Это отличие обязательных параметров от необязательных. Если обязательный не указать скрипт выдаст ошибку. Обязательные не помечены, по умолчанию, а необязательные помечены словом [опциональный].
Вот и наглядный пример
новичку без разницы что там написано, а когда поймёт, уже поздно будет, ведь главное назначение понять именно прочитав это слова, а не понять для чего оно там находится.Police
Это отличие обязательных параметров от необязательных. Если обязательный не указать скрипт выдаст ошибку. Обязательные не помечены, по умолчанию, а необязательные помечены словом [опциональный].
