|
Справка для утилиты TCIMG
|
|
| Andrey_A | Дата: Среда, 28.08.2013, 21:56 | Сообщение № 1 |
Генералиссимус
На сайте с: 26.01.2012
Город: Сочи, Хоста
Сообщений: 7191
Награды: 143
Репутация: 125
Аверин Андрей
|
TCIMG HELP
Группа TCIMG в Telegram
В теме будет обсуждаться справка к утилите TCIMG
Каждый желающий может улучшить, подправить, сообщить об ошибки, внести свой вклад в развитие справки.
В версии 20.08.2013 [2.8] beta 20 добавлен параметр crhelp, который позволяет создавать файлы справки TCIMG
Для тех, кого заинтересует и готов помочь в развитии:
1. Скачать последнюю версию утилиты TCIMG. Это важно, т.к. сопутствующие для справки файлы будут изменяться
2. Скачать и скопировать в корень утилиты последнюю версию сопутствующих файлов по постоянной ссылке TCIMGHELP.ZIP
или это сделает сама утилита...
3. При запуске кнопки
Создание файлов справки для TCIMG
Доступно только для пользователей
создадутся в папке TCIMGHELP соответствующие файлы
_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/
Каждый может подправить информацию, заметив те или иные недостатки и отправить их для обсуждения
3 основных файла - это
- TCIMG.tch - для создания com_...htm все описания команд и параметров берутся именно из него (секция [Parameters]).
- остальная информация берётся из TCIMG.txt
- TCIMG.hhc - файл структуры справки
|
| |
| |
| Andrey_A | Дата: Среда, 28.08.2013, 22:16 | Сообщение № 2 |
Генералиссимус
На сайте с: 26.01.2012
Город: Сочи, Хоста
Сообщений: 7191
Награды: 143
Репутация: 125
Аверин Андрей
|
От себя добавлю:
Наконец-то дошли руки до справки. Если честно, глядя на всё проделанное в утилите, думал что не получится привести к единому парсингу команд. И поэтому долгое время даже не брался за справку, ведь кому охота 200-300 html страниц делать вручную. И вот наконец написан код по созданию справки.
Пока добавлено 8 команд, но с остальными я думаю, не будет проблем. На днях они войдут в новый файл TCIMG.tch
Идёт "причёсывание" каждой команды. Конечно возможны любые ошибки в описании, так что кто готов внимательно во всё это дело вникнуть, то добро пожаловать))) Главное начало положено. С чем всех и поздравляю!
|
| |
| |
| Metchnik | Дата: Четверг, 29.08.2013, 20:18 | Сообщение № 3 |
Майор
На сайте с: 25.01.2013
Город: Самара
Сообщений: 87
|
Поздравляю с выходом другой версии, столь желаемой, справки. Мне понравились первые шаги в этом направлении.
Некоторые неточности и ошибки подправил в файлах и выслал в личку.
Кроме этого хотелось бы следующее:
1. Увеличить шрифт в примерах.
2. В примерах сделать команды (кроме текущей) кликабельными, с возможностью перехода на страницу команды.
3. Вместо пустого листа "Команды" создать список (ссылок) всех команд в алфавитном порядке.
4. Тоже самое с параметрами утилиты.
|
| |
| |
| Andrey_A | Дата: Пятница, 30.08.2013, 12:20 | Сообщение № 4 |
Генералиссимус
На сайте с: 26.01.2012
Город: Сочи, Хоста
Сообщений: 7191
Награды: 143
Репутация: 125
Аверин Андрей
|
Цитата (Metchnik) Некоторые неточности и ошибки подправил в файлах и выслал в личку.
Спасибо, большинство поправок будет или уже внесено.
Цитата (Metchnik) Кроме этого хотелось бы следующее:
Всё записано, кое-что уже реализовано, когда будут добавлены все команды будет очевиднее.
Что касается параметров отдельным списком - это оставлю на десерт )
Вот 2-я версия. Остальное в течении 3-4 дней
TCIMGHELP_2v.chm.zip
|
| |
| |
| Metchnik | Дата: Пятница, 30.08.2013, 15:19 | Сообщение № 5 |
Майор
На сайте с: 25.01.2013
Город: Самара
Сообщений: 87
|
Цитата (Andrey_A) Вот 2-я версия. Остальное в течении 3-4 дней
О... таки движется! 
В разделе "Файл конфигурации" внесены не все секции.
Список всех команд появился, кликабельность. В примерах тоже. Вобщем получается оч. хорошо!
|
| |
| |
| Andrey_A | Дата: Понедельник, 02.09.2013, 01:21 | Сообщение № 6 |
Генералиссимус
На сайте с: 26.01.2012
Город: Сочи, Хоста
Сообщений: 7191
Награды: 143
Репутация: 125
Аверин Андрей
|
Вот 3-я версия
+ Добавлены команды, пока 50, осталось всего 140)))
+ Исправлены различные ошибки...
+ оптимизирован код, который создаёт справку... TCIMG пока не выкладываю
Спасибо всем, кто сообщил об ошибках и пожеланиях в личку, в аську... Постепенно всё реализуется...
TCIMGHELP_3v.chm.zip
|
| |
| |
| asmadeus | Дата: Вторник, 03.09.2013, 19:02 | Сообщение № 7 |
|
|
Дополнения №3 - вместо Hotkey страница с regexp второй раз
|
| |
| |
| Andrey_A | Дата: Четверг, 12.09.2013, 02:26 | Сообщение № 8 |
Генералиссимус
На сайте с: 26.01.2012
Город: Сочи, Хоста
Сообщений: 7191
Награды: 143
Репутация: 125
Аверин Андрей
|
Цитата (asmadeus) Дополнения №3 - вместо Hotkey страница с regexp второй раз
Исправлено.
Так получилось, что работа над справкой затянулась... более того пришлось всё делать заново после потери данных из-за местного смерча, потопа и потери компа, большинство информации восстановлено, работа продолжается.
Справка на 95% готова.
Вот и первый релиз №1
Далее причёсывание и исправление ошибок...
|
| |
| |
| Metchnik | Дата: Четверг, 12.09.2013, 03:46 | Сообщение № 9 |
Майор
На сайте с: 25.01.2013
Город: Самара
Сообщений: 87
|
Цитата (Andrey_A) более того пришлось всё делать заново
Да...уж... хорошо, что не бросил.
Что касается релиза - виден огромный объём работы. 
Ряд найденных ошибок:
- ссылки в описании параметров не всегда правильные, видимо совпадение имён команд с текстом...
- не все пока дополнения.
- в описании параметров есть название в верхнем регистре... надо подправить.
- 32 64 подсвечиваются не всегда, где надо...
|
| |
| |
| Andrey_A | Дата: Пятница, 13.09.2013, 22:24 | Сообщение № 10 |
Генералиссимус
На сайте с: 26.01.2012
Город: Сочи, Хоста
Сообщений: 7191
Награды: 143
Репутация: 125
Аверин Андрей
|
Цитата (Metchnik) Ряд найденных ошибок:
Часть исправлено.
Наконец-то подходит работа к финишу. Очень было интересно столкнуться с автоматизацией html. Код утилиты, который будет выложен позже делает всю справку сам:
- более 200 html
- более 5000 ссылок в справке и легко перейти к командам, параметрам, параметрам, дополнениям
- уникальная подсветка почти везде, где это возможно
- и мн.др.
---
В планах создание тёмной справки... и оттачивание текста.
А вот и релиз R3
Спасибо всем кто активно и подпольно участвует...
|
| |
| |
| Andrey_A | Дата: Вторник, 17.09.2013, 12:22 | Сообщение № 11 |
Генералиссимус
На сайте с: 26.01.2012
Город: Сочи, Хоста
Сообщений: 7191
Награды: 143
Репутация: 125
Аверин Андрей
|
Финиш оказался немного длиннее 
Исправлено, добавлено, протестировано...
Не окончательный, но уже стабильный вариант релиз справки R8
|
| |
| |
| Andrey_A | Дата: Четверг, 19.09.2013, 16:20 | Сообщение № 12 |
Генералиссимус
На сайте с: 26.01.2012
Город: Сочи, Хоста
Сообщений: 7191
Награды: 143
Репутация: 125
Аверин Андрей
|
Всё справка готова!
Вернее:
- код Autoit для справки
- стили сss
- оптимизирован код html
- компиляция справки через hhc.exe
- поиск по справке: по словам, по разделам
- внесены все команды, параметры, дополнения
Работа продлилась несколько недель, но оно того стоило!
релиз R11
Осталось проверить более 2000 примеров, добавить недостающие и как только это будет сделано,
будет выпущена TCIMG 3.0 с новой справкой. 
|
| |
| |
| shveicar | Дата: Суббота, 21.09.2013, 02:22 | Сообщение № 13 |
|
|
Да.. работа проделана огромная, - но думаю она того стоит.
Теперь в утилите есть профессиональная справка.
Спасибо.
|
| |
| |
| Andrey_A | Дата: Вторник, 24.09.2013, 04:58 | Сообщение № 14 |
Генералиссимус
На сайте с: 26.01.2012
Город: Сочи, Хоста
Сообщений: 7191
Награды: 143
Репутация: 125
Аверин Андрей
|
При подготовке финальной версии TCIMG 3.0 оптимизировалась и команда справки
Скачать Доступно только для пользователей
теперь не надо что-то специально скачивать, вставлять, отдельно компилировать. Утилита всё это делает сама. В справке откройте страницу команды chelp там всё описано.
Так же всё готово к переводу на другие языки...
Файлы для редактирования отмечены звёздочкой, те, кто что-то заметит не то, или есть желание что-то внести, смело может их править и высылать. Если изменения по делу, то будет всё это вставлено, а имя героя внесено на вечно на первую страницу справки )))
Кстати часть инструкции шапки темы убрал, они уже не актуальны.
|
| |
| |
| GGG8 | Дата: Суббота, 05.10.2013, 23:32 | Сообщение № 15 |
Подполковник
На сайте с: 28.02.2012
Город: Владимир
Сообщений: 114
|
Andrey_A, спасибо за справку. Теперь стало проще тестировать и понимать принцип составление сложных команд.
Хотелось бы в справке описание пользовательских команд утилиты tm_, pm_
|
| |
| |
