Автор Тема: Развитие русской справки  (Прочитано 188091 раз)

0 Пользователей и 1 Гость просматривают эту тему.

Оффлайн AZJIO [?]

  • VIP
  • *
  • Сообщений: 2706
  • Репутация: 1136
    • мой сайт
    • Награды
  • Версия AutoIt: 3.3.8.1
Эта тема является продолжением темы Ещё раз о русской справке :), которая теперь закрыта и является архивной.

Онлайн справка находится тут (или чёрная тут).



Ссылки на файлы справки:

Полный комплект справки, зеркало 2014.07.09
(нажмите для показа/скрытия)

Промежуточные обновления (без перепаковки с помощью htm2chm и только стиль white)
AutoIt3.chm 2014.07.08
UDFs3.chm 2014.06.03
CustomUDFs.chm 2014.07.08
(нажмите для показа/скрытия)

Дополнительно
CHMtoOnLine.7z 2013.07.13 - для создания онлайн справки
AutoIt_SRC_compile 2014.01.14 - компилятор AutoIt3.chm, UDFs3.chm, AutoIt.chm
CustomUDFs_compile 2014.01.14 - компилятор справки CustomUDFs.chm

Вариант перепаковки справки в EXE-инсталятор от gora (описание в посте ниже). Перепаковывать данный инсталятор можно открыв в архиваторе 7-zip.

Требуется перевод следующих разделов UDF:
(нажмите для показа/скрытия)

Список _WinAPI_... функций (48) для которых нет примеров.
(нажмите для показа/скрытия)
« Последнее редактирование: Июнь 05, 2015, 15:34:45 от CreatoR »

Русское сообщество AutoIt

Развитие русской справки
« Ответ #15 Отправлен: Май 17, 2012, 23:51:27 »

Оффлайн AZJIO [?]

  • VIP
  • *
  • Сообщений: 2706

  • Автор темы
  • Репутация: 1136
    • мой сайт
    • Награды
  • Версия AutoIt: 3.3.8.1
Re: Развитие русской справки
« Ответ #15, Отправлен: Июнь 20, 2012, 22:26:14 »
britanec74
Исправлено. И обновлено WM_MENUSELECT, WM_NOTIFY

UDFs3.chm 2012.06.25 - обновлено, добавлено 40 функций
(нажмите для показа/скрытия)
« Последнее редактирование: Июнь 25, 2012, 16:12:40 от AZJIO »

Оффлайн AZJIO [?]

  • VIP
  • *
  • Сообщений: 2706

  • Автор темы
  • Репутация: 1136
    • мой сайт
    • Награды
  • Версия AutoIt: 3.3.8.1
Re: Развитие русской справки
« Ответ #16, Отправлен: Июнь 25, 2012, 16:10:42 »
Обновлён UDFs3.chm
Раздел _ClipBoard переведён почти весь, без одной функции (_ClipBoard_GetSequenceNumber). Переведены примеры в разделах Misc, _ClipBoard, Math, File.

Оффлайн AZJIO [?]

  • VIP
  • *
  • Сообщений: 2706

  • Автор темы
  • Репутация: 1136
    • мой сайт
    • Награды
  • Версия AutoIt: 3.3.8.1
Re: Развитие русской справки
« Ответ #17, Отправлен: Июнь 29, 2012, 21:04:19 »
Поправил несколько текстов в StringFormat для лёгкости восприятия и некоторые даже по смыслу были не точными (не обновлял пока).
Не могу понять перевод
Цитировать
Blank | Prefix the output value with a blank if the output value is signed and positive; the blank is ignored if both the blank and + flags appear.
Сначала переводил как "Пусто" или отсутсвие флага. Если посмотреть в википедии там в такой же таблице указан "пробел". Но при тесте фраза "blank is ignored if both the blank and + flags" не соответствует, так как если в используются оба пробел и "+", то это не воспринимается как последовательность.
Код: AutoIt [Выделить]
MsgBox(4096, 'Сообщение', StringFormat("%+ 8d", 255))
MsgBox(4096, 'Сообщение', StringFormat("% +8d", 255))


текущий перевод
(нажмите для показа/скрытия)
« Последнее редактирование: Июнь 29, 2012, 21:13:32 от AZJIO »

Русское сообщество AutoIt

Re: Развитие русской справки
« Ответ #17 Отправлен: Июнь 29, 2012, 21:04:19 »

Оффлайн AZJIO [?]

  • VIP
  • *
  • Сообщений: 2706

  • Автор темы
  • Репутация: 1136
    • мой сайт
    • Награды
  • Версия AutoIt: 3.3.8.1
Re: Развитие русской справки
« Ответ #18, Отправлен: Июль 02, 2012, 17:12:40 »
AutoIt3.chm - обновлено StringFormat, и имена функций в заголовке не содержит пробела в конце, если выделять двойным кликом.

UDFs3.chm - имена функций в заголовке не содержит пробела, переведены ещё 44 примера, итого первые 60 примеров, кроме сложных с WM_NOTIFY, которые недопереведены.

в функции
_GUICtrlListView_GetFocusedGroup
_GUICtrlListView_GetGroupCount
_GUICtrlListView_GetGroupInfoByIndex
добавлена проверка
Код: AutoIt [Выделить]
If @OSVersion = "WIN_XP" Then

напоминающая что для WinXP функции не работают, избавляя от траты времени на поиск проблем.

CustomUDFs.chm - добавлено UDF_Standards - описание создания UDF по стандарту
« Последнее редактирование: Июль 03, 2012, 01:27:13 от AZJIO »

Оффлайн AZJIO [?]

  • VIP
  • *
  • Сообщений: 2706

  • Автор темы
  • Репутация: 1136
    • мой сайт
    • Награды
  • Версия AutoIt: 3.3.8.1
Re: Развитие русской справки
« Ответ #19, Отправлен: Июль 04, 2012, 13:28:56 »
2012.07.10
Обновил полный комплект справки.
Обновил компиляторы справки.
« Последнее редактирование: Июль 10, 2012, 13:02:33 от AZJIO, Причина: Объединение сообщений »

Оффлайн AZJIO [?]

  • VIP
  • *
  • Сообщений: 2706

  • Автор темы
  • Репутация: 1136
    • мой сайт
    • Награды
  • Версия AutoIt: 3.3.8.1
Re: Развитие русской справки
« Ответ #20, Отправлен: Июль 21, 2012, 07:30:53 »
Коды @OSLang - пример страницы. Вопрос: в каком порядке расположить колонки и по какой колонке сортировать?

Оффлайн ynbIpb [?]

  • Скриптер
  • ****
  • Сообщений: 392
  • Репутация: 108
  • Пол: Мужской
    • Награды
Re: Развитие русской справки
« Ответ #21, Отправлен: Июль 21, 2012, 12:04:17 »
Оставить сортировку как есть, а русский и английский вывести вначало, как самые используемые.
 :think:

Русское сообщество AutoIt

Re: Развитие русской справки
« Ответ #21 Отправлен: Июль 21, 2012, 12:04:17 »

Онлайн CreatoR [?]

  • Администратор
  • *
  • Сообщений: 7771
  • Репутация: 2276
  • Пол: Мужской
  • AutoIt is simple, subtle, elegant
    • CreatoR's Lab
    • Награды
  • Версия AutoIt: 3.3.10.2
Re: Развитие русской справки
« Ответ #22, Отправлен: Июль 21, 2012, 21:07:31 »
AZJIO
Небольшая ошибка в InetRead:

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

И ещё, в userfunctions.htm в разделе IniString описание и возвращаемое значение у Read и Delete одинаковое.
« Последнее редактирование: Июль 21, 2012, 21:12:54 от CreatoR »


Правила, Поиск, Супер тема


AutoIt is simple, subtle, elegant.


«Не оказываю тех. поддержку через ПМ/ICQ, и по электронной почте - для этого есть форум. (C)»
«Законы Мэрфи неоспоримы!»


Мои работы

Оффлайн AZJIO [?]

  • VIP
  • *
  • Сообщений: 2706

  • Автор темы
  • Репутация: 1136
    • мой сайт
    • Награды
  • Версия AutoIt: 3.3.8.1
Re: Развитие русской справки
« Ответ #23, Отправлен: Июль 21, 2012, 23:09:54 »
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
« Последнее редактирование: Июль 22, 2012, 12:08:00 от AZJIO »

Оффлайн AZJIO [?]

  • VIP
  • *
  • Сообщений: 2706

  • Автор темы
  • Репутация: 1136
    • мой сайт
    • Награды
  • Версия AutoIt: 3.3.8.1
Re: Развитие русской справки
« Ответ #24, Отправлен: Июль 30, 2012, 09:26:33 »
UDFs3.7z - добавлено 23 функции _WinAPI_...
(нажмите для показа/скрытия)
Примерно половине из указанных сделаны примеры, которые отсутствуют в оригинальной справке.

Оффлайн Yashied [?]

  • AutoIt MVP
  • Глобальный модератор
  • *
  • Сообщений: 5349
  • Репутация: 2687
  • Пол: Мужской
    • Награды
  • Версия AutoIt: 3.3.x.x
Re: Развитие русской справки
« Ответ #25, Отправлен: Июль 30, 2012, 12:57:08 »
1. _WinAPI_GetCurrentProcess()

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

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

3. _WinAPI_MAKELANGID() и _WinAPI_MAKELCID()

В примерах

Код: AutoIt [Выделить]
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()

Возвращает дескриптор окна, которое связано заданным образом с указанным окном.
« Последнее редактирование: Июль 30, 2012, 13:26:30 от Yashied »


Думай, прежде чем говорить.

Оффлайн AZJIO [?]

  • VIP
  • *
  • Сообщений: 2706

  • Автор темы
  • Репутация: 1136
    • мой сайт
    • Награды
  • Версия AutoIt: 3.3.8.1
Re: Развитие русской справки
« Ответ #26, Отправлен: Июль 30, 2012, 14:55:29 »
1. От оригинала тут не отклонялся, так как толком не понял что за дескриптор.
2. Я спрашивал пару месяцев назад как его обозвать, пишу в двух вариантах, так как встречал трактовку как "Карандаш" и как "перо", учитываю что по смыслу это одно и тоже и даже первое более понятнее тем что в Paint и Photoshop такой же по типу атрибутов интрумент называется карандаш.
3. Тут даже не знаю, может кому то знакомее будет 0419, чем 1049
4. Инфу брал тут, тем более на днях я читал подробности тут. И коментарии в параметрах более точно передают смысл который не вставить в короткую фразу описания, в принципе не противоречит смыслу.
5. Ловушку тоже сочетание в google часто используемое, но у меня не устоялся термин никакой.
7. Я не понимаю нормального состояния, есть @SW_RESTORE, который описывается как восстановленное состояние. Он конечно и есть нормальный.
8. Почему с образом, мне показалось я нормально передал смысл функции, понятным языком.
« Последнее редактирование: Июль 30, 2012, 15:00:46 от AZJIO »

Оффлайн Yashied [?]

  • AutoIt MVP
  • Глобальный модератор
  • *
  • Сообщений: 5349
  • Репутация: 2687
  • Пол: Мужской
    • Награды
  • Версия AutoIt: 3.3.x.x
Re: Развитие русской справки
« Ответ #27, Отправлен: Июль 30, 2012, 15:38:44 »
1. В оригинале ошибка.
3. Я имел ввиду Hex($LCID, 4).

Оффлайн AZJIO [?]

  • VIP
  • *
  • Сообщений: 2706

  • Автор темы
  • Репутация: 1136
    • мой сайт
    • Награды
  • Версия AutoIt: 3.3.8.1
Re: Развитие русской справки
« Ответ #28, Отправлен: Август 06, 2012, 15:12:23 »
Обновил AutoIt3.chm
Заменил [опционально] на [опция], нормально? Просто это слово жирным шрифтом и занимает по ширине приличное место, а смысл практически не поменялся.
В функциях Opt поправки текста, значения в порядке возрастания, в том числе значения по умолчанию подсвечены жирным шрифтом.
FileCreateShortcut - поправки в параметрах.

Обновил UDFs3.chm (Замена текста [опционально] на [опция])
Обновил CustomUDFs.chm
Замена текста [опционально] на [опция]
FileOperations.au3 обновлён, и соответственно параметры в двух функциях
« Последнее редактирование: Август 09, 2012, 12:17:10 от AZJIO »

Оффлайн AZJIO [?]

  • VIP
  • *
  • Сообщений: 2706

  • Автор темы
  • Репутация: 1136
    • мой сайт
    • Награды
  • Версия AutoIt: 3.3.8.1
Re: Развитие русской справки
« Ответ #29, Отправлен: Август 09, 2012, 13:33:48 »
Опять мучает вопрос с правильным написанием текста [опционально]
Есть варианты
1. [?]
2. [необязательный]
3. [опция]
4. Ваше предложение

Мне больше нравится первый - [?]. Длинный текст мешает чтению, скользить вниз по параметрам и натыкаться на длинное слово и переводить взгляд влево. Достаточно один раз "догадаться" что этот символ означает (и это не трудно) и конечно же о назначении этого символа в параметрах можно упомянуть в описаниии функций. Слово [опция] и [опционально] совсем не интуитивно.
« Последнее редактирование: Август 09, 2012, 23:16:10 от AZJIO »

Русское сообщество AutoIt

Re: Развитие русской справки
« Ответ #29 Отправлен: Август 09, 2012, 13:33:48 »

 

Похожие темы

  Тема / Автор Ответов Последний ответ
20 Ответов
15374 Просмотров
Последний ответ Март 23, 2010, 10:47:44
от Loopback
0 Ответов
3758 Просмотров
Последний ответ Март 19, 2010, 14:07:48
от Kaster
2 Ответов
6297 Просмотров
Последний ответ Май 04, 2010, 09:32:39
от AZJIO
 Закреплено  Ещё раз о русской справке :)

Автор SyDr « 1 2 ... 16 17 » Общение

248 Ответов
103812 Просмотров
Последний ответ Май 18, 2012, 00:27:17
от CreatoR
1 Ответов
6244 Просмотров
Последний ответ Октябрь 11, 2010, 14:48:23
от Yashied
15 Ответов
8571 Просмотров
Последний ответ Январь 05, 2012, 14:30:06
от CreatoR
14 Ответов
7049 Просмотров
Последний ответ Январь 24, 2012, 01:20:11
от CreatoR
6 Ответов
5123 Просмотров
Последний ответ Август 21, 2013, 09:54:55
от Yuriy
2 Ответов
5419 Просмотров
Последний ответ Январь 07, 2014, 08:58:10
от madmasles
0 Ответов
3475 Просмотров
Последний ответ Февраль 04, 2014, 08:54:42
от madmasles