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

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

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

Оффлайн CreatoR [?]

  • Администратор
  • *
  • Сообщений: 7759
  • Репутация: 2274
  • Пол: Мужской
  • AutoIt is simple, subtle, elegant
    • CreatoR's Lab
    • Награды
  • Версия AutoIt: 3.3.10.2
Re: Развитие русской справки
« Ответ #30, Отправлен: Август 09, 2012, 17:29:46 »
Если придерживаться смыслу, то второй вариант.
[?] как то слишком коротко, могут и не понять.


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


AutoIt is simple, subtle, elegant.


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


Мои работы

Оффлайн AZJIO [?]

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

  • Автор темы
  • Репутация: 1136
    • мой сайт
    • Награды
  • Версия AutoIt: 3.3.8.1
Re: Развитие русской справки
« Ответ #31, Отправлен: Август 09, 2012, 19:37:07 »
Когда то долго не мог понять смысла [опциональный], а когда понял что не все параметры можно указывать, то тогда и понял что означает слово [опциональный]. Конечно, для новичка это полезно, но болшее время потом только мешает, поэтому я и предложил короткий вариант. В маске символ ? означает либо есть либо нет. Ну и само наличие непонятного символа заставит подумать в чём отличие параметров с этим символом от параметров без него. Думаю проблемы не будет.

Оффлайн CreatoR [?]

  • Администратор
  • *
  • Сообщений: 7759
  • Репутация: 2274
  • Пол: Мужской
  • AutoIt is simple, subtle, elegant
    • CreatoR's Lab
    • Награды
  • Версия AutoIt: 3.3.10.2
Re: Развитие русской справки
« Ответ #32, Отправлен: Август 09, 2012, 20:50:26 »
AZJIO
Если тебе было сложно понять с «[Опциональный]», то такому же новичку в двойне будет сложно понять что такое «[?]».

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

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

Re: Развитие русской справки
« Ответ #32 Отправлен: Август 09, 2012, 20:50:26 »

Оффлайн AZJIO [?]

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

  • Автор темы
  • Репутация: 1136
    • мой сайт
    • Награды
  • Версия AutoIt: 3.3.8.1
Re: Развитие русской справки
« Ответ #33, Отправлен: Август 09, 2012, 22:17:32 »
CreatoR
Я могу вернуть "[опционально]", это на 2 символа короче чем "[необязательный]". Жаль что мало кто отписывается, картина бы сложилась уверенной, как лучше большинству.
Принцип хороший отойти от магических символов.
« Последнее редактирование: Август 09, 2012, 23:16:30 от AZJIO »

Оффлайн Police [?]

  • Новичок
  • *
  • Сообщений: 27
  • Репутация: 3
  • Пол: Женский
    • Награды
Re: Развитие русской справки
« Ответ #34, Отправлен: Август 09, 2012, 22:53:21 »
А как насчёт вместо "опциональный" или "Не обязательный" так и писать - "параметр"?

Оффлайн AZJIO [?]

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

  • Автор темы
  • Репутация: 1136
    • мой сайт
    • Награды
  • Версия AutoIt: 3.3.8.1
Re: Развитие русской справки
« Ответ #35, Отправлен: Август 09, 2012, 23:01:30 »
CreatoR
Вот и наглядный пример  :) новичку без разницы что там написано, а когда поймёт, уже поздно будет, ведь главное назначение понять именно прочитав это слова, а не понять для чего оно там находится.

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

Оффлайн Police [?]

  • Новичок
  • *
  • Сообщений: 27
  • Репутация: 3
  • Пол: Женский
    • Награды
Re: Развитие русской справки
« Ответ #36, Отправлен: Август 09, 2012, 23:09:44 »
Цитировать
Если обязательный не указать скрипт выдаст ошибку.
Забыла об этом пункте.  :-[ Так бы и в правду была путаница.
Тогда лучше использовать "опциональный"...

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

Re: Развитие русской справки
« Ответ #36 Отправлен: Август 09, 2012, 23:09:44 »

Оффлайн CreatoR [?]

  • Администратор
  • *
  • Сообщений: 7759
  • Репутация: 2274
  • Пол: Мужской
  • AutoIt is simple, subtle, elegant
    • CreatoR's Lab
    • Награды
  • Версия AutoIt: 3.3.10.2
Re: Развитие русской справки
« Ответ #37, Отправлен: Август 09, 2012, 23:11:59 »
AZJIO  [?]
Цитировать
Я могу вернуть "[опционально]", это на 3 символа короче чем "[не обязательный]".
:blink:
А к чему такая погоня за минимальным числом символов?

Оффлайн AZJIO [?]

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

  • Автор темы
  • Репутация: 1136
    • мой сайт
    • Награды
  • Версия AutoIt: 3.3.8.1
Re: Развитие русской справки
« Ответ #38, Отправлен: Август 09, 2012, 23:18:17 »
CreatoR
Очень неудобно читать, строки, которые могли бы уместится на одной строке переносятся на другую. По ширине это слово занимает целую колонку.
Я поправил [необязательный] слитно, так что на два символа.

Оффлайн Kaster [?]

  • Бритва, Бритва Оккама
  • Глобальный модератор
  • *
  • Сообщений: 4020
  • Репутация: 622
  • Пол: Мужской
  • Мой Аватар, он лучший самый
    • Награды
  • Версия AutoIt: 3.3.14.0
Re: Развитие русской справки
« Ответ #39, Отправлен: Август 09, 2012, 23:26:59 »
опциональный, или необязательный. [?] абсолютно непонятно и ни в коем разе не дает понять природу параметра.

Оффлайн inververs [?]

  • AutoIt Гуру
  • *****
  • Сообщений: 1966
  • Репутация: 432
  • Пол: Мужской
    • Награды
  • Версия AutoIt: 3.3.12.0
Re: Развитие русской справки
« Ответ #40, Отправлен: Август 09, 2012, 23:34:57 »
Если справка для новичков, то и пишите "Этот параметр указывать не обязательно"  :)

Оффлайн AZJIO [?]

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

  • Автор темы
  • Репутация: 1136
    • мой сайт
    • Награды
  • Версия AutoIt: 3.3.8.1
Re: Развитие русской справки
« Ответ #41, Отправлен: Август 09, 2012, 23:43:48 »
inververs
 :)

Kaster
ок

CreatoR
Я не хочу, чтобы меня критиковали за навязанный мною вариант [необязательный], который мне самому не нравится. Скажите что поставить и сделаю.

Оффлайн CreatoR [?]

  • Администратор
  • *
  • Сообщений: 7759
  • Репутация: 2274
  • Пол: Мужской
  • AutoIt is simple, subtle, elegant
    • CreatoR's Lab
    • Награды
  • Версия AutoIt: 3.3.10.2
Re: Развитие русской справки
« Ответ #42, Отправлен: Август 09, 2012, 23:52:51 »
[Необязательный] однозначно.

Оффлайн gregaz [?]

  • AutoIt Гуру
  • *****
  • Сообщений: 1166
  • Репутация: 298
  • Пол: Мужской
    • Награды
Re: Развитие русской справки
« Ответ #43, Отправлен: Август 10, 2012, 08:27:54 »
По мне новичку лучше сразу привыкать к общепринятым понятиям :

Т.е:   Опционально


Добавлено: Август 10, 2012, 08:37:31
Не стоит стремиться перевести все слова.Так можно дойти до абсурда.

Если размер критичен,то можно даже    : (Опц.)
Новичок все равно поймет, если не с первого раза, так со второго.
С первого раза ему даже применение параметра : Необязательный будет не очень понятно
« Последнее редактирование: Август 10, 2012, 08:40:43 от gregaz, Причина: Объединение сообщений »
Самая большая проблема – её сформулировать. 

Оффлайн sngr [?]

  • AutoIt Гуру
  • *****
  • Сообщений: 816
  • Репутация: 345
    • Награды
  • Версия AutoIt: 3.3.8.1
Re: Развитие русской справки
« Ответ #44, Отправлен: Август 10, 2012, 08:57:56 »
+ за опционально.
AZJIO Возможно имеет смысл перенести темы с AutoIt3Wrapper, Obfuscator и Tidy в раздел Использование AutoIt, а то если не знать где они находяться, найти совершенно невозможно.





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

Re: Развитие русской справки
« Ответ #44 Отправлен: Август 10, 2012, 08:57:56 »

 

Похожие темы

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

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

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