Дополнение №31


Дополнение к командам, использующих подключение шаблонов из файлов .tcg



Файлы .tcg - специальные файлы, в секциях которых можно прописывать шаблоны с различной информацией и подключать их в командах...

В файлах могут использоваться:

1. Секции в квадратных скобках (как у стандартного ini файла).
Пример записи:

[Section]
InfoLine1
InfoLine2
InfoLine3
...
InfoLineN




2. Секции в фигурных скобках.
Используется для передачи специальных шаблонов.
Пример записи:

{Section}
InfoLine1
InfoLine2
InfoLine3
...
InfoLineN




3. Использование в файле(ах) секций с квадратными и фигурными скобками.
Для получение точного содержимого секций рекомендуется завершать информацию секции "пустым" именем с используемыми скобками [---] или {---} :
Пример записи:

[Section]
InfoLine1
InfoLine2
InfoLine3
...
InfoLineN
[---]
{Section}
InfoLine1
InfoLine2
InfoLine3
...
InfoLineN
{---}




4. Подключение нескольких файлов .tcg.
• Те файлы .tcg, которые входят в состав утилиты (их содержимое) автоматически включаются
• В TCIMG.ini (TCIMGU.ini) в секции [Setting] в ключе TCG можно подключить другие (пользовательские) .tcg файлы: прописывается либо полный путь, либо имя файла, который находится в папке с утилитой или в папке ...\Files\Tcg\
• Файлы разделяются /
Пример записи:

TCG=User1.tcg/User2.tcg




5. Использование содержимого секций.
• Если необходимо получить содержимое секции с квадратными скобками, то в параметре tcg<> и других прописывается имя секции без скобок:
Пример записи:

tcg<NameSection>
butfrom<@NameSection>
TCGINFO<@NameSection>

• Если необходимо получить содержимое секции с фигурными скобками, то в параметре tcg<> и других прописывается имя секции с фигурными скобками:
Пример записи:

tcg<{NameSection}>
butfrom<@{NameSection}>
TCGINFO<@{NameSection}>




6. Комментарии.
• Комментарии могут быть в любом месте, кроме имени секции.
• Синтаксис: пробел;;пробел комментарий
• Комментарии НЕ МОГУТ НАХОДИТСЯ после имени секции!!!
• При считывании секции все комментарии удаляются.
Пример записи:

 ;; пример запуска с различными параметрами и методами через команду start
[tm_StartPrograms]
start=%PROGRAMFILES%\Windows~~NT\Accessories\wordpad.exe ;; запуск wordpad.exe
start=%COMMANDER_PATH%\Programs\Players\VLC\vlc.exe||&&wait ;; ожидать закрытия программы
pause=5000 ;; пауза перед вызовом следующей команды
start=%%COMMANDER_PATH%%\Test.bat||&&hide ;; запустить батник, скрыть окно




7. Приоритет считывания секций.
• Если есть одинаковые имена секций, то считывается содержимое первой.
• Приоритет №1 имеют файлы прописанные в TCIMG.ini в секции [TCG]
• Приоритет №2 имеют файлы прописанные в TCIMG.ini в секции [Setting] в ключе TCG
• Приоритет №3 имеют файлы входящие в состав утилиты, см. ниже



8. Теги.
• Тег ##center## заменяется в командах текущим текстом.



9. Редактирование шаблона.
• После имени секции через разделитель | могут быть прописаны параметры Parameters, позволяющие редактировать шаблон.
• Parameters - это один или серия параметров таких же как и в Дополнении №15, в которых убран тег formt<>.
• При Parameters=0 секция возвращается "как есть", без удаления пустых строк.

Пример записи:

tcg<NameSection|Parameters>




10. Временное добавление информации (шаблонов) из файла(ов).
• Для добавления информации используется команда tcgup
• Добавить информацию можно из одного или нескольких файлов.
• Добавить информацию можно в начало или в конец содержимого всех заданных tcg файлов.
• Добавленная информация сохраняется до завершения работы утилиты.



Рекомендуется:
• Имена секций во всех файлах .tcg не должны повторяться.
• Структурировать информацию: распределять секции по темам в отдельные файлы:
  (как это сделано в файлах, входящих в состав TCIMG)
   TCIMG.tcg - файл tm_ , pm_ , sm_ , am_ команд
   MENU.tcg - файл шаблонов меню
   HTML.tcg - файл шаблонов html
   BUTTON.tcg - файл шаблонов кнопок Total Commander (автор Jury Abel')
   SHAPED.tcg - файл шаблонов секций с фигурными скобками
   MISC.tcg - файл для различных шаблонов
   AllMenu.tcg - файл шаблона редактируемого меню (автор Jury Abel')


© Аверин Андрей для Total Commander Image  Averin-And@yandex.ru