Что нового

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

Автор
A

AZJIO

Меценат
Меценат
Сообщения
2,892
Репутация
1,196
Обновил AutoIt3.chm - добавил прыжок к макро в примерах. Раньше даже при переходе на вкладке указатель нужно было ещё искать в списке, теперь при прыжке из примера нужный макрос оказывается в верхней видимой строке. Использовал метку типа <a name="@YEAR">, а в функции ссылку типа macros.htm#@YEAR
Чтобы последняя строка поднималась к верху, добавил на страницу пустые строки. На владке "Указатель" переход к макро тоже используется общий список с точным прыжком.
Параметры по тексту выделены курсивом ~30шт. Исправления регистра в именах макросах ~ 15шт
 

ORiON

Новичок
Сообщения
3
Репутация
0
По-моему в CustomUDFs в "Файлы/каталоги" > "_Setting" перепутаны описания у ф-ий:
_Setting_MigrateIniToReg - Копирует данные из реестра в ini-файл
_Setting_MigrateRegToIni - Копирует данные из ini-файла в реестр
 
Автор
A

AZJIO

Меценат
Меценат
Сообщения
2,892
Репутация
1,196
ORiON
Поправил, перезалил.

Обновил AutoIt3.chm, теперь макро и функции, подсвеченные по тексту, тоже имеют ссылки.
Для прыжка к макро использовал вторую колонку, так как раньше если текст в ячейке выстраивалась в несколько строк, то первая строка скрывалась за верхнем краем, так как не была на одном уровне с именем макро в первой колонке, приходилось прокручивать.

Все функции, макро и ключевые слова в AutoIt3.chm обновлены в соответствии как это делает Tidy.
Примеры в разделах обучения теперь тоже иеют ссылки на функции, макро и ключевые слова.
 
Автор
A

AZJIO

Меценат
Меценат
Сообщения
2,892
Репутация
1,196
UDFs3.chm обновлён.
В разделе _GUICtrlTreeView_... переведены все примеры и в примерах удалена функция _GUICtrlTreeView_SetUnicodeFormat (как в справке 3.3.8.1), которая отключала Unicode и из-за этого в примерах квадратики в пунктах.
В примерах _GUICtrlHeader_... добавлена функция _GUICtrlHeader_SetUnicodeFormat, без которой в примерах на WinXP (Win7 незнаю) в заголовках абракадабра.
В примерах _GUICtrlMonthCal_... элементы MonthCal и Edit накладываются друг на друга, исправил.
В примерх _GUICtrlListView_... удалена функция _GUICtrlListView_SetUnicodeFormat, которая погоды не делала (странно что Unicode во всех разделах ведёт себя по разному).
Поправки в _GUICtrlTreeView_GetChildren и и примерах _GUICtrlTreeView_EditText, _GUICtrlTreeView_EndEdit
 

gora

Знающий
Сообщения
315
Репутация
19
AZJIO [?]
Предлагаю в теме изменить цвет строк типа "String" на почти чёрный, взамен блеклого синего, который практически сливается с фоном.

Поддерживаю!
Ибо сейчас это читать совсем плохо:
color.PNG
 

CreatoR

Must AutoIt!
Команда форума
Администратор
Сообщения
8,673
Репутация
2,486
gora [?]
Все уже привыкли к такому цвету, он такой же и в оригинале, т.ч изменение только будет путать.
 

gora

Знающий
Сообщения
315
Репутация
19
CreatoR [?]
Все уже привыкли к такому цвету, он такой же и в оригинале
Это не довод. Глаза то свои и их нужно беречь, а они пусть разглядывают свой оригинал, если им так нравится. ИМХО
 
Автор
A

AZJIO

Меценат
Меценат
Сообщения
2,892
Репутация
1,196
CreatoR
Я пользуюсь Black-темой, поэтому мне не слишком важно, но для White это недостаток, который нужно решать. Либо менять фон, либо цвет текста. При чём чтоб не напрягать пользователей в комплекте выложить тему для SciTE в том же стиле.
Почему выбрал такие цвета: ну текст является обычным текстом, как в блокноте, обезличенный, безцветный, то есть чёрный или почти чёрный. А текст просто вводимый чаще всего является незарегистрированными функциями, которые должен по цвету быть ближе к цвету функций UDF или нативных.
 

CreatoR

Must AutoIt!
Команда форума
Администратор
Сообщения
8,673
Репутация
2,486
gora [?]
Глаза то свои и их нужно беречь
Я не вижу причину по которой глаза портятся, если от них требуется фокусирование, то это только в пользу, глаза как мышцы, их нужно тренировать :reading_book:
 

gora

Знающий
Сообщения
315
Репутация
19
CreatoR [?]
глаза как мышцы, их нужно тренировать
Может попробовать на форуме поменять цвет текста на аналогичный тому, который сейчас обсуждаем (в качестве заботы о пользователях), пусть себе тренируются!? :smile:
Представляю себе их реакцию...
 
Автор
A

AZJIO

Меценат
Меценат
Сообщения
2,892
Репутация
1,196
1. Хочу добавить в функции раздела INI в примечаниях строку:
Если необходимо использовать ini в формате юникода, то предварительно создайте файл с помощью FileOpen с кодировкой "Unicode UTF16 Little Endian".

пример для проверки работы всех функций с этой кодировкой
Код:
#include <Array.au3>
$sPath_ini = @ScriptDir & '\file.ini'
$sText= _
'[Section]' & @CRLF & _
'Key=проверка' & @CRLF & _
'default=тест' & @CRLF & _
'skey=три' & @CRLF & _
'[Section2]' & @CRLF & _
'z=строка'

$hFile = FileOpen($sPath_ini, 32 + 2) ; 32 стабильно
FileWrite($hFile, $sText)
FileClose($hFile)

IniWrite($sPath_ini, "Section", "Key", "Это новое значение") ; проверка записи

$sRead = IniRead($sPath_ini, "Section", "Key", "Значение по умолчанию") ; проверка чтения
MsgBox(0, 'IniRead/IniWrite', $sRead)

$var = IniReadSection($sPath_ini, "Section") ; проверка чтения секции
_ArrayDisplay($var, 'IniReadSection')

$res = IniRenameSection($sPath_ini, "Section2", "MyNewSection") ; проверка переименования

$var = IniReadSectionNames($sPath_ini) ; проверка возврата имён секций
_ArrayDisplay($var, 'IniReadSectionNames/Rename')

IniDelete($sPath_ini, "Section", "Key") ; проверка удаления
$sRead = IniRead($sPath_ini, "Section", "Key", "Значение по умолчанию")
MsgBox(0, 'IniDelete', $sRead)

$sData = "Key=Value1" & @LF & "Key2=Value2" & @LF & "Key3=Value3"
IniWriteSection($sPath_ini, "Section1", $sData) ; проверка записи секции
$sRead = IniRead($sPath_ini, "Section1", "Key", "Значение по умолчанию")
MsgBox(0, 'IniWriteSection', $sRead)

2. Хочу в заголовке справки указать версию и дату сборки, например "Справка AutoIt, v3.3.6.1, сборка от 23.09.2012"
 

gora

Знающий
Сообщения
315
Репутация
19
AZJIO [?]
Если необходимо использовать ini в формате юникода, то предварительно создайте файл с помощью FileOpen с кодировкой "Unicode UTF16 Little Endian".
1 Я бы написал иначе:
"Если необходимо использовать ini файлы в Юникод формате, то эти файлы должны быть в кодировке UTF-16 (с BOM или без BOM), но не в кодировке UTF-8".
Собственно, как их пользователь создаст, скриптом или с помощью своего любимого редактора, не имеет значения.
Про факт, некорректной работы ini функций в кодировке UTF-8, следует упомянуть и на странице AutoIt3.chm::/html/intro/unicode.htm, где об этом ничего не сказано.

2 За.

3 Страница CustomUDFs.chm::/html/userappendix/Obfuscator.htm открывается в неправильной кодировке


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

4 Добавьте зеркала в шапку, не могу скачать с Вашего сайта. :(
 
Автор
A

AZJIO

Меценат
Меценат
Сообщения
2,892
Репутация
1,196
gora
то эти файлы должны быть в кодировке UTF-16
Я же проверил перед тем как это утверждать. Если в примере указать 64 вместо 32, то пример всё наглядно покажет. Кстати, по предложению на офсайте добавили только в функции IniWrite и IniWriteSection.

gora
3 Страница CustomUDFs.chm::/html/userappendix/Obfuscator.htm открывается в неправильной кодировке
Исправлено

Цвет темы поправил, SciTEUser.7z - соответствующий файл темы поместить в папку "C:\Documents and Settings\<имя пользователя>"
19 функций в AutoIt3.chm содержат таблицы с цветным заголовком

AutoIt3.7z 4.10.2012
UDFs3.7z 4.10.2012
Переведены все примеры и 7 функций в разделе _GUICtrlEdit_...
Переведено 61 функций 69 примеров раздела _GUICtrlMenu_...
Цвет текста сделал фиолетовым
 
Автор
A

AZJIO

Меценат
Меценат
Сообщения
2,892
Репутация
1,196
Необходимо проверить орфографию в справке по этим файлам. Здесь экспортированы целые разделы, например "описание функций" в текстовый файл. Задача открыть в Word и проверить орфографию. Я уже проверил, но есть слова в которых я сомневаюсь, например заменил "слэш" на "слеш", и есть другие слова типа "расшифровать", возможно надо "дешифровать". Проверку "грамматика" можно отключить, так как при экспорте только русских текстов грамматика выдаст много ложных срабатываний...
 
Автор
A

AZJIO

Меценат
Меценат
Сообщения
2,892
Репутация
1,196
CreatoR
Файлов 10. Всё автоматизировано, давно и исходники автоматизации есть в компиляторе. В файла ТОЛЬКО русский текст извлечённый регулярными выражениями. Орфографию проверяю обычно когда переведу целый раздел, обычно опечатки стабильно есть. Но дело не в этом, при каждой очередной проверке я натыкаюсь на одни и теже ошибки, типа: скриптёр, пинг, хост, офлайн, на которые проверка орфографии спотыкается чаще чем реальных ошибок. Может у нас есть специалисты русского языка, которые помогут решить спорные вопросы, и возможно кто-то захочет проверить грамматику (знаки препинания).

Вот список сомнительных слов
глючный
баг

прокси, Пинг хоста, пингуется, Хост в офлайне, онлайне, сокет, хостинг
булевые, булеану
обфусцирован
скриншот, скрин
хотфикс
валидный
клик
Эксплорер
Хоткей
файрволами
дебаггинга
Рандомная

нескомпилированном
символ неслова
при условии неперекрывания
незахватывающих
непробельный
с необработкой
в неклиентской
непозволяющие
нелитеральные

скриптёр, скриптинг
трее
радиокнопку, слайдер, чекбокс
беззнаковое
буквенно
флеш
оффлайн
пикселов
отрисована, отрисовка, отрисовывается
взависимости
кэш
Нетипизированный
отжатие кнопки
разжатие
алфавитно-числовой
сверхжадная, подмаски
Форумные имена
парсинг
бейсикоподобный
крашит
инфо
миллисек
намудренный
нативных
для избежания ошибок
флешка
зацикливать
задействовании
просмотрщиков
Пристыковывать
самосозданием
автоопределение, автоскрытие
мультистроковый, многостроковый

Разблокировывает, разблокируется, расшифрования, Раскомментируйте, разрегистрируем
перенаправляет, пересохранение, переинициализация
примонтированный

Для проверки грамматических ошибок сделал скрипт импорта целыми предложениями. Стоит ли выкладывать?
 
Автор
A

AZJIO

Меценат
Меценат
Сообщения
2,892
Репутация
1,196
Предлагаю добавить раздел типа такого : Link_UDF.
Хотя это начало, возможно придётся разделить его на отдельные страницы. Часто на форумах делают подборку книг, фильмов, а для программистов разные операции. Главное здесь строго упорядочить и удобно предоставить информацию. Можно сделать как раскрывающееся дерево, как в справке Иванова раздел FAQ или "Стили GUI", но поиск по свёрнутым разделам не работает, и нет кнопки "развернуть всё".
 
Верх