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

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

Оффлайн AZJIO [?]

  • VIP
  • *
  • Сообщений: 2738
  • Репутация: 1143
    • мой сайт
    • Награды
  • Версия 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

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

Оффлайн ЭйчЭйч [?]

  • Сообщений: 119
  • Репутация: -6
    • Награды
  • Версия AutoIt: 3.3.14.0
Re: Развитие русской справки
« Ответ #420, Отправлен: Март 20, 2019, 16:00:28 »
Прежде я писал скрипты на другой программе. И там были похожие проблемы со справкой. А именно:
1. Программа постоянно вела себя, как её хочется. На новой версии старые скрипты начинали отваливаться, либо выдавать неожиданные результаты.
2. Ну и проблема со справкой, естественно, так как она напрочь была устаревшая и написана так, что постоянно где-то всплывали недокументированные возможности и поведение.

Оба пункта меня в итоге задолбали. Так как написание скрипта превращается в муку и сводит с ума. В общем, я помучился немного с выбором и теперь сижу на AutoIt. Пока доволен, в частности тем, что могу сделать не просто скрипт в окне, а отдельное приложение.

Что касается справки, то я заметил аналогичную проблему - на форуме есть то, чего нет в справке, но будь там, избавило бы новичков от необходимости спрашивать, а гуру отвечать. Хороший пример справки - php.

Я предложил бы перевести справку на движок Wiki, который предоставит плюсы: перекрестные ссылки, ссылки по имени, свободу редакции и комментирования. Мне нравится Fandom. Я там редактор в нескольких Вики по играм. И что важно, некоторые статьи за короткое время преображались невероятно.

Онлайн joiner [?]

  • Расмус-бродяга
  • Локальный модератор
  • *
  • Сообщений: 2924
  • Репутация: 493
  • Пол: Мужской
    • Награды
  • Версия AutoIt: 3.3.12.0
Re: Развитие русской справки
« Ответ #421, Отправлен: Март 20, 2019, 16:17:07 »
ЭйчЭйч  [?]
Цитировать
то касается справки, то я заметил аналогичную проблему - на форуме есть то, чего нет в справке, но будь там, избавило бы новичков от необходимости спрашивать, а гуру отвечать
для этого есть оригинальная справка в установке. да, на английском. на форуме справка для старой версии языка. хотя, она тоже выручает хорошо
 новички, вроде тебя, ни старую ни новую читать не хотят. поэтому и задают вопросы по элементарным функциям. даже поиском по форуму ленятся пользоваться. ибо в почти 100%-х все вопросы уже обсуждались.
а вот наклепать новый постик это за здрасти.
кстати, есть еще официальный форум
Были времена, когда солнце было ярче, трава зеленее, а водка сорокоградуснее

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

Re: Развитие русской справки
« Ответ #421 Отправлен: Март 20, 2019, 16:17:07 »

Оффлайн ЭйчЭйч [?]

  • Сообщений: 119
  • Репутация: -6
    • Награды
  • Версия AutoIt: 3.3.14.0
Re: Развитие русской справки
« Ответ #422, Отправлен: Март 20, 2019, 18:07:04 »
ЭйчЭйч  [?]для этого есть оригинальная справка в установке. да, на английском. на форуме справка для старой версии языка. хотя, она тоже выручает хорошо
 новички, вроде тебя, ни старую ни новую читать не хотят. поэтому и задают вопросы по элементарным функциям. даже поиском по форуму ленятся пользоваться. ибо в почти 100%-х все вопросы уже обсуждались.
а вот наклепать новый постик это за здрасти.
кстати, есть еще официальный форум
Я администрировал форумы и группы. "Веселее" всего в соц. сетях, том же Вконтакте. Публикуешь информацию в нескольких местах, включая самое видном месте (блок "Сайты"), и мне всё равно писали люди и спрашивали: "Где сайт?". В общем сумме за деятельность модератора я перенес/объединил тем и сообщений просто тьму. Я ещё жив.

Принятая на форумах с некоторых пор схема "Одна тема на вопрос", совершенно ужасная - плодит сущности и, неожиданно, отбивает охоту использовать поиск, ибо в выдаче поиска черт ногу сломит. Кстати, о поиске, что он имеет ряд проблем, писали модераторы, признавали проблему, и, в частности, я сталкивался с этими проблемами. Если дословно, то кто-то подвел итог: "Уж лучше искать через поисковую систему." Надеюсь, что не ты или иной критик новичков. Ибо казус.

Также, нужно понимать, что человек на самом деле спрашивает, иначе можно сделать неверные выводы.
« Последнее редактирование: Март 21, 2019, 19:18:17 от ЭйчЭйч »

Оффлайн CreatoR [?]

  • Администратор
  • *
  • Сообщений: 8070
  • Репутация: 2311
  • Пол: Мужской
  • AutoIt is simple, subtle, elegant
    • CreatoR's Lab
    • Награды
  • Версия AutoIt: 3.3.14.0
Re: Развитие русской справки
« Ответ #423, Отправлен: Март 20, 2019, 18:29:20 »
Этот проект держится на чистом энтузиазме.

На счёт поиска - если следить за правилами (названия тем, корректность раздела и т.п), то в поиске можно найти то что нужно.
Да он не идеальный, но работает. Также сам иногда использую Google вот так:
Развитие русской справки site:autoit-script.ru
« Последнее редактирование: Март 20, 2019, 21:46:58 от SyDr, Причина: Убран оффтоп »


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


AutoIt is simple, subtle, elegant.


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


Мои работы

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

Re: Развитие русской справки
« Ответ #423 Отправлен: Март 20, 2019, 18:29:20 »

Оффлайн AZJIO [?]

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

  • Автор темы
  • Репутация: 1143
    • мой сайт
    • Награды
  • Версия AutoIt: 3.3.8.1
Re: Развитие русской справки
« Ответ #424, Отправлен: Март 20, 2019, 21:03:20 »
Казалось я многократно пересмотрел примеры и перечитал функции и элементарно захожу в StringInStr и вижу
Код: AutoIt [Выделить]
$sResult = StringInStr("Это строка", "ОКА")

$sResult должен быть $iPos, по крайней мере тип точно не строка.

ЭйчЭйч
Все всё знают, проблема только кто возьмётся. Вики позволяет экспортировать в CHM? Представь ты там трудился писал выверенные фразы, а кто-то зашёл и посчитал твои фразы неполными и заменил своим, тебе хочется кратко, а другой чел хочет подробно, и всё борьба на странице за право своей версии изложения, несмотря что допустим есть 1000 непереведённых страниц. А кто-то вообще зашёл и всё стёр. Проще иметь свою версию с возможностью всегда воспроизвести, то есть выложить файл.
Возьмись за WinAPI, поможешь сразу всем языкам программирования. Хоть оно и переведено в разных местах.

Оффлайн SyDr [?]

  • Локальный модератор
  • *
  • Сообщений: 650
  • Репутация: 157
  • Пол: Мужской
  • Сидра
    • Награды
  • Версия AutoIt: 3.3.12.0
Re: Развитие русской справки
« Ответ #425, Отправлен: Март 20, 2019, 21:57:02 »
Убрал из ваших сообщений перепалку/оффтоп, не несущий смысловой нагрузки к теме. Если вы считаете, что я убрал что-то важное, можете повторить (больше убирать не буду).


ЭйчЭйч  [?]
Цитировать
Я предложил бы перевести справку на движок Wiki, который предоставит плюсы: перекрестные ссылки, ссылки по имени, свободу редакции и комментирования. Мне нравится Fandom.
https://autoit.fandom.com/ru/wiki/AutoIt_%D0%B2%D0%B8%D0%BA%D0%B8


AZJIO  [?]
Цитировать
Вики позволяет экспортировать в CHM?
Есть экспорт в XML, который можно конвертировать во что угодно. Вся история правок сохраняется. Но для таких вещей лучше использовать системы контроля версий. Не говоря уже про то, что в Вики надо ещё и начальный импорт провести, иначе она никому не упала.

Оффлайн ЭйчЭйч [?]

  • Сообщений: 119
  • Репутация: -6
    • Награды
  • Версия AutoIt: 3.3.14.0
Re: Развитие русской справки
« Ответ #426, Отправлен: Март 20, 2019, 22:40:55 »
В той же английской справке, например, попадется какое-то специфичное слово, которое даже со знанием языка не поймешь. Взять для примера Windows. Читаю я инструкцию на английском и всё ясно, а где искать в русской ОС эти пункты - фиг знает. Ничто не мешает сделать инструкцию на русском не то что полной, а полнее, мы ж могем, а там уже проблемы англоязычных - переводить. Пускай мучаются.

AZJIO, да все возьмутся. Примерно: составить список задач, инструкцию, выдернуть шаблоны оформления, оформить все это в тему на форуме. Вон в браузерной игре соклановцы от школьников до дедов на bb-кодах невероятные вещи выдают, имея шаблоны, а тутошние тем более смогут.

Самый ад на самой известной русской, там информация может уже быть неверной, но будет висеть, потому что добавивший её просто главней. На игровых вандализма в принципе не было. Была одна статья, которую перелопатил какой-то чувак, что в ней осталось 5 строк, но я не особо переживал, объем информации остался прежний. Там все откатывается и настраивается.

Еще другие Wiki-подобные штуки для справок, но красивее по сравнению с Wiki. В частности, которые определяют приоритет статей, тот же "Вот эти статьи требуют перевода". Я как-то имел дело с такой, удобно. Одну точно можно найти, но, с тех пор, как я видел её последний раз, там в требованиях был Perl или Ruby... Помню, что обломался из-за этого.

AZJIO  [?]
Цитировать
Возьмись за WinAPI, поможешь сразу всем языкам программирования
Ок. Тем более что-то новое узнаю. В каком виде делать?



Добавлено: Март 20, 2019, 22:41:38
SyDr, я пробивал, только собирался тебя искать.
(нажмите для показа/скрытия)
« Последнее редактирование: Март 20, 2019, 23:21:30 от ЭйчЭйч »

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

Re: Развитие русской справки
« Ответ #426 Отправлен: Март 20, 2019, 22:40:55 »

Онлайн joiner [?]

  • Расмус-бродяга
  • Локальный модератор
  • *
  • Сообщений: 2924
  • Репутация: 493
  • Пол: Мужской
    • Награды
  • Версия AutoIt: 3.3.12.0
Re: Развитие русской справки
« Ответ #427, Отправлен: Март 20, 2019, 23:04:04 »
Реформатор на форуме с кучей идей. Забавно... Логика ломаная, амбиции...есть. Осталось дождаться коронной фразы, после которой он сдуется.
Дежавю, что то такое уже сюда приплывало

Оффлайн AZJIO [?]

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

  • Автор темы
  • Репутация: 1143
    • мой сайт
    • Награды
  • Версия AutoIt: 3.3.8.1
Re: Развитие русской справки
« Ответ #428, Отправлен: Март 21, 2019, 02:18:17 »
ЭйчЭйч
Для начала компилятор справки

Цитировать
AZJIO, да все возьмутся. Примерно: составить список задач, инструкцию, выдернуть шаблоны оформления, оформить все это в тему на форуме.
А кто будет составлять список задач? и всё остальное? Там чтобы начать нужно выучить кучу инфы. Я ранее выкладывал компиляторы, даже могу ещё раз выложить, но у меня сейчас другая тема и я если честно выложил бы если бы был уверен что не зря. Шаблоны справки должны быть исходники и компилятор. У них там свой компилятор английский и модернизировать его под русскую может месяц понадобиться, кто его знает, каждый день что-то там подправлять. Там же изменился компилятор, он теперь может вставить несколько примеров, а старая версия с которой я возился вставляет один экземпляр, там кода на целую программу. Если кратко прога анализирует файл исходник страницы, формирует HTML, экпортирует код в HTML, соединяет их, встраиваются всякие кнопки копирование/запуск, куча регулярок подкрашивает код в блоке синтаксиса, в блоке описания, внедряет в тексты ссылки, чтобы название функций, макросов и ключевых слов являлись ссылками на страницы описания. Там одни регулярки импортирования ссылок я фиг знает сколько времени делал, переделывал, добавлял, удалял, оптимизировал, кроме того генерируются страницы списки функций, макросов, ключевых слов, генерируется файл проекта, таблица TOC, список "Указатели". Ко всему этому ещё куча скриптов проверки орфогрфии, проверки регистра имён функций, проверка отступов в блоках синтаксиса. В общем это не будет работать моя версия и английская, нужно либо с нуля ковырять англискую или наоборот в мои скрипты встраивать поддержку их новых методов несколько скриптов на странице и их кнопки. Если переводить тексты ничего не делая, каким образом собирать? Если переводить HTML, то потом двойная работа переносить это в исходники. Если есть пару лет отпуска или на пенсии, то вполне можно взяться, а в перерывах между работой это тяжело осилить.
Цитировать
В каком виде делать?
Здесь нужна ваша настойчивость, читать тему смотреть компилятор мой и английский, принять решение.
Я например тут перевожу и тут помогаю.

Оффлайн ЭйчЭйч [?]

  • Сообщений: 119
  • Репутация: -6
    • Награды
  • Версия AutoIt: 3.3.14.0
Re: Развитие русской справки
« Ответ #429, Отправлен: Март 21, 2019, 13:29:02 »
AZJIO, то, что я назвал, по идее следует делать человеку, который в этом разбирается.

Как я понял с твоих слов и других статей. Chm формируется из HTML, вот его и разобрать на шаблоны.
(нажмите для показа/скрытия)
« Последнее редактирование: Март 21, 2019, 13:48:56 от ЭйчЭйч »

Оффлайн AZJIO [?]

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

  • Автор темы
  • Репутация: 1143
    • мой сайт
    • Награды
  • Версия AutoIt: 3.3.8.1
Re: Развитие русской справки
« Ответ #430, Отправлен: Март 21, 2019, 16:17:33 »
AZJIO, то, что я назвал, по идее следует делать человеку, который в этом разбирается.

Как я понял с твоих слов и других статей. Chm формируется из HTML, вот его и разобрать на шаблоны.
Там есть txt файлы. То есть если посмотреть компилятор, то станет понятно, что HTML файлов там в разы меньше чем txt, потому что HTML-файлы там некие отдельные статьи которые копируются в результирующую папку, а txt это шаблоны HTML-страниц функций, которые преобразуются в HTML в результирующей папке. Я вчера много лишнего понаписал, если начать с малого, то делаем так: ничего не меняя в компиляторе скачиваем исходники справки на англоязычном форуме, берём страницу txt WinAPI-функции копируем в папку в кучу где страницы UDF и переводим его содержимое. Обычно я 30-100 страниц перевожу, потом компилирую, но чтобы подогреть интерес свой и увидеть что всё получается, что всё работает, можно перевести одну страницу и компилировать, если видно что страница добавилась и переведена то "о чудо всё работает" и делаем тоже самое с остальными страницами, которых там 1000. Я примерно в месяц переводил до 100 страниц это можно видеть по дате выпуска на oszone.net и количеству переведённого, когда я делал дополнительный UDF, то есть писал с нуля шаблоны и примеры, конечно это дело было дольше. А лёгкие разделы мог 30 страниц в день, но надо учесть что и примеры надо переводить.
Может зря я пишу, я вроде в описании компилятора всё подробно расписал назначение папок, где какие клики делать чтобы получить результат и какие проги нужны, то есть одну прогу надо скачать собственно сам компилятор CHM, без которого не соберётся.
И ещё новые страницы WinAPI не прописаны в TOC и Index (Содержание и Указатели), в общем я бы скопировал все новые страницы и сгенерировал бы им TOC и Index и добавил бы файл TOC и Index, ну чтобы не по одному ручками и чтобы все они сразу появились в UDF, чтобы не юзать две справки. У меня кстати в Notepad++ есть подсветка кода для шаблонов txt.
Ещё я выкладывал скрипт, который переводил все страницы автоматом в QTranslate, после чего открываешь оба файла в Notepad++ оригинал и переведённый, Notepad++ позволяет 2 окна сделать, и из левого переведённого переносим в правое, это процеесс упрощает рутинную работу перевода каждой отдельной фразы ручками, хотя в QTranslate  есть просто хоткей на замену оригинала переводом, то есть выделил, нажал хоткей, вместо выделенного появился перевод, но это проблема в том что оригинал не видишь, если не уверен в правильности перевода то осознавать/контролировать тяжело, а когда слева и справа оба варианта то видно где подправить.
И примеры тоже надо скопировать в папку примеров, а то они не добавятся в страницы.
« Последнее редактирование: Март 21, 2019, 16:31:08 от AZJIO »

Оффлайн ROMEOinLOVE [?]

  • Новичок
  • *
  • Сообщений: 1
  • Репутация: 0
  • Пол: Мужской
    • Награды
  • Версия AutoIt: 3.3.14.0
Re: Развитие русской справки
« Ответ #431, Отправлен: Апрель 22, 2019, 13:32:22 »
Скиньте будьте добры AutoIt_Help_White_and_Black.7z (в шапке ссылки битые)

Онлайн joiner [?]

  • Расмус-бродяга
  • Локальный модератор
  • *
  • Сообщений: 2924
  • Репутация: 493
  • Пол: Мужской
    • Награды
  • Версия AutoIt: 3.3.12.0
Re: Развитие русской справки
« Ответ #432, Отправлен: Апрель 22, 2019, 21:02:01 »
ROMEOinLOVE
можно скачать с моего диска

Оффлайн xXx [?]

  • Осваивающий
  • **
  • Сообщений: 71
  • Репутация: 21
  • Пол: Мужской
    • Награды
  • Версия AutoIt: 3.3.x.x
Re: Развитие русской справки
« Ответ #433, Отправлен: Апрель 22, 2019, 22:53:32 »
... (в шапке ссылки битые)
Не совсем так.
Кликаешь ссылку, попадаешь на http://u.to/ (сервис сокращения ссылок) и ждешь 10 секунд.
Цитата: Перенаправление...
После окончания таймера произойдет автоматический переход по ссылке:..

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

Re: Развитие русской справки
« Ответ #433 Отправлен: Апрель 22, 2019, 22:53:32 »

 

Похожие темы

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

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

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