Тэги

Тэги .hts-формата

• #nav - линейки навигации
• #iurl - иконизированая фотография
• #gallery - создание фотогалереи
• [- ссылка на сайт с картинкой-скриншотом.|]
  
  

  ,
• #forum - подключение топика форума.

Приветствуются вопросы по описанию не описанных тегов и вопросов типа "а вот как сделано то-то и то-то на такой-то странице".

Урок №1.

Вводная. Что такое .hts?

На Авиабазе для удобства быстрого создания/редактирования, упрощения программирования и единообразия страниц все страницы изначально пишутся в специальном, .hts формате.

Это специальный язык разметки, адаптированный для создания страниц, обладающих множеством перекрёстных ссылок и единообразным дизайном.

Каждому .hts файлу соответствует одноимённый .phtm файл на языке PHP, который собственно и отображается браузером при просмотре через Internet. Язык PHP знать не обязательно, т.к. непосредственно .phtml файлы Авиабазы вручную не редактируются.

.hts представляют из себя простые текстовые файлы, размеченные с помощью специальных последовательностей символов, как правило, начинающихся с символа # в начале строки. При любом изменении .hts файла вручную через FTP или через Web-интерфейс при следующей загрузке автоматически пересоздаётся (перекомпилируется) соответствующий .phtml файл.

Редактирование/создание страниц.

Для редактирования файлов .hts служит специальный файл http://airbase.ru/admin/edit.phtml. Можно просто запустить эту ссылку и ввести в выданной строке адрес редактируемой страницы, без имени домейна, начиная с символа '/': /alpha/rus/s/su/27/. Если страница уже существует, то она вызовется на редактирование, если её ещё нет, то она будет создана. Если имя файла index.hts/index.phtml (в большинстве случаев) то имя файла указывать не нужно. Если оно отличается от вышеуказанного (скажем, rus.phtml/rus.hts), то надо указать его явно: /rus.hts - заглавная страница.

Расширение редактируемого файла .hts от .phtml не отличается. Всё равно на редактирование будет вызван файл .hts. Если расширение не .hts и не .phtml, то считается именем каталога. Т.е. в случае ввода /alpha/rus/s/su/27/index.htm реально будет вызван на редактирование файл /alpha/rus/s/su/27/index.htm/index.hts. Будьте внимательны!

Можно вызывать edit.phtm с параметром &script=/script_path/script_name.hts с теми же особенностями, как ввод через строку редактирования: http://airbase.ru/admin/edit.phtml?script=/alpha/rus/s/su/27/. Это особенно удобно при перекомпиляции старых страниц, ещё не имеющих строки "редактировать страницу" внизу. Достаточно вписать после uka.ru строку /admin/edit.phtml?scritpt= Впрочем, перекомпиляция старых страниц имеет целый рад особенностей, так что лучше этим не заниматься, не имея некоторого опыта. Об этом я расскажу подробно позднее.

Новые страницы можно создавать просто введя их адрес в строке браузера. Предположим, что у нас нет страницы /alpha/rus/s/su/33/kub/. Просто пишем http://airbase.ru/alpha/rus/s/su/33/kub/ и получаем окно по созданию новой страницы.

Тут тоже есть ряд тонкостей в плане - куда размещать. Пока я не подготовлю соответствующее описание, лучше просто спрашивать

Наконец можно внизу каждой новой страницы нажать ссылочку "Редактировать страницу" и edit.phtml будет вызван автоматически. Это - основной способ.

При изменении страниц рекомендуется заполнять отдельное окошко с описанием изменения, чтобы оно выводилось на заглавной странице.

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

Формат .hts изнутри. Тэги.

Как я уже упоминал, .hts - это обычный текст с дополнительной разметкой, так называемыми тэгами.

Обычно тэги стоят в начале строки, начинаются с символа # и после них стоит пробел.

Вот простейший пример (минимальный набор тэгов):

#head Заголовок страницы
#maked Дата создания
#copyr Автор страницы


#t Собственно текст страницы
#t Обычный текст или HTML или HTS

#t А вот это - список:
#l
#i Первая строка списка
#i Вторая строка списка
#/l
Список закрыт

Что мы имеем:

Тэг #head - это заголовочный тэг страницы. Имеет четыре параметра, разделяемых вертикальной палкой: |

Первый аргумент - заголовок страницы, отображаемый в шапке окна браузера. То, что вставится в HTML в виде <title>...</title>

Второй аргумент - Крупный текст (первая строчка) заголовка страницы. Скажем, текст "Су-27" на странице о Су-27.

Третий и четвёртый аргумент - соответственно вторая и третья строчка заголовка. В примере с Су-27 это "истребитель завоевания..." и "ОКБ П.О.Сухого", соответственно.

Любой аргумент может отсутствовать. Если отсутствуют последние два - они не отображаются. Если отсутствует один из первых двух, то он заменяется вторым. Конечные вертикальные палки можно не писать. Т.е. в простейшем случае можно писать только #head Су-27. В предельном случае пишется всё: #head Истребитель завоевания господства в воздухе Су-27|Су-27|истребитель завоевания господства в воздухе|ОКБ П.О.Сухого.

Традиционно в заголовке страницы первая строка - название самолёта, вторая - тип, третья - разработчик. Подобного подхода желательно пользоваться и в других случаях.

После #head обязательно должен стоять пробел!

#maked - дата создания в формате dd.mm.yyyy. Заметьте - не дата последнего редактирования! В виду того, что сейчас этот тэг добавляется автоматически, его нужно менять очень редко.

После #maked обязательно должен стоять пробел!

#copyr - Автор страницы. Обычно просто ник - позывной на Авиабазе.

После #copyr обязательно должен стоять пробел!

Текст самой страницы.

Текст, располагающийся тут, как это принято в HTML форматируется автоматически. Все переводы строк заменяются пробелами, более одного пробела подряд просто отбрасывается. Если требуется организовать принудительный перевод строки или новый абзац для этого существуют специальные тэги:

#t - тэг начала нового абзаца. После #t обязательно должен стоять пробел!

#p - пустая строка, вертикальный отступ. Обычно служит для разделения абзацев. После #p обязательно должен стоять пробел

#l - начало списка. Параметров не требуется. Должен стоять одним на всю строку.

#i - пункт списка. Всё, что идёт до # в начале строки, т.е. до следующего тэга считается одной строкой - одним пунктом списка.

#/l - завершение списка. Как и #l должен стоять одним в строке.

Эксперименты.

Для экспериментов существует страница /test - можете делать там всё, что угодно, но не забывайте ставить галочку "Не записывать лог"!!! А то будет засоряться заглавная страница Авиабазы

Урок №2

Ждите продолжения

А все вопросы в специальном топике форума разработчиков