<-
Apache > HTTP Server > Documentation > Version 2.0 > Modules

Apache Модуль mod_imap

Description: сторона сервера imagemap обработка
Status: основа
Module Identifier: imap_module
Source File: mod_imap.c

резюме

эти процессы модуля .map файлы, таким образом заменяя функциональные возможности imagemap программа CGI. Любой справочник или тип документа, формируемый, чтобы использовать тренера imap-file (использующий также AddHandler или SetHandler ) будет обработан этим модулем.

следующая директива активизирует файлы, заканчивающиеся .map как imagemap файлы:

AddHandler imap-file map

отметить, что следующее все еще поддерживается:

AddType application/x-httpd-imap map

однако, мы пробуем постепенно вывести "волшебные типы MIME", таким образом мы осуждаем этот метод.

директивы

темы

top

New Features

imagemap модуль добавляет некоторые новые особенности, которые не были возможны с предварительно распределенными imagemap программами.

top

Imagemap File

линии в imagemap файлах могут иметь один из нескольких форматов:

directive value [ x , y ...]
directive value " Menu text " [ x , y ...]
directive value x , y ... " Menu text "

директива - один из base , default , poly , circle , rect , или point . ценность - абсолютный или относительный URL, или одна из специальных упомянутых ниже ценностей. Координаты x , y пары, отделенные whitespace. Указанный текст используется как текст связи, если imagemap меню произведено. Линии, начинающиеся '#' - комментарии.

Imagemap File Directives

есть шесть директив, позволенных в imagemap файле. Директивы могут войти в любой заказ, но обработаны в заказе, которым они найдены в imagemap файле.

base директива

имеет эффект <base href=" value "> . неабсолютные URL файла карты взяты относительно этой ценности. base директива отвергает ImapBase как установлено в a .htaccess файл или в файлах конфигурации сервера. В отсутствии ImapBase директива конфигурации, base неплатежи к http://server_name/ .

base_uri является синонимичным с base . отметить, что тянущийся разрез на URL существенен.

default директива
предпринятое действие, если данные координаты не соответствуют ни одному из poly , circle или rect директивы, и есть нет point директивы. Неплатежи к nocontent в отсутствии ImapDefault урегулирование конфигурации, вызывая кодекс статуса 204 No Content быть возвращенным. Клиент должен держать ту же самую страницу показанной.
poly директива
берет триста - сто пунктов, и повинуется, если отобранные координаты пользователя находятся в пределах многоугольника, определенного этими пунктами.
circle
берет координаты центра круга и пункта на круге. Повинуется, если отобранный пункт пользователя - с кругом.
rect директива
берет координаты двух противостоящих углов прямоугольника. Повиновавшийся, если отобранный пункт - в пределах этого прямоугольника.
point директива
берет единственный пункт. Директиве пункта, самой близкой к отобранному пункту пользователя повинуются, если никакие другие директивы не удовлетворены. Отметьте это default не будет сопровождаться если a point директива является существующей, и действительные координаты даются.

Values

ценности для каждой из директив могут любое следующее:

URL

URL может быть относительный или абсолютный URL. Относительные URL могут содержать '..' синтаксис и будут решены относительно base ценность.

base непосредственно не будет решенный согласно текущей ценности. Утверждение base mailto: будет работать должным образом, все же.

map
эквивалентный URL imagemap файла непосредственно. Никакие координаты не посылают с этим, таким образом меню не будет произведено если ImapMenu собирается none .
menu
синонимичный с map .
referer
эквивалентный URL обратившегося документа. Неплатежи к http://servername/ если нет Referer: удар головой присутствовал.
nocontent
посылает кодекс статуса 204 No Content , говоря клиенту держать ту же самую показанную страницу. Действительный для всех кроме base .
error
терпит неудачу с a 500 Server Error . действительный для всех кроме base , но вид глупых для чего - нибудь, но default .

Coordinates

0,0 200,200
координата состоит из x и a y ценность, отделенная запятой. Координаты отделены друг от друга whitespace. Чтобы приспосабливать путь, Рысь обращается с imagemaps, должен пользователь выбирать координату 0,0 , это - как будто никакая координата не была отобрана.

Quoted Text

" Menu Text "

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

<a href="http://foo.com/"> Menu text </a>

если никакой указанный текст не будет присутствовать, то название связи будет использоваться как текст:

<a href="http://foo.com/">http://foo.com</a>

если Вы хотите использовать двойные кавычки в пределах этого текста, Вы должны написать им как &quot; .

top

Example Mapfile

#Comments are printed in a 'formatted' or 'semiformatted' menu.
#And can contain html tags. <hr>
base referer
poly map "Could I have a menu, please?" 0,0 0,10 10,10 10,0
rect .. 0,0 77,27 "the directory of the referer"
circle http://www.inetnebr.com/lincoln/feedback/ 195,0 305,27
rect another_file "in same directory as referer" 306,0 419,27
point http://www.zyzzyva.com/ 100,100
point http://www.tripod.com/ 200,200
rect mailto:nate@tripod.com 100,150 200,0 "Bugs?"

top

Referencing your mapfile

HTML example

<a href="/maps/imagemap1.map">
<img ismap src="/images/imagemap1.gif">
</a>

XHTML example

<a href="/maps/imagemap1.map">
<img ismap="ismap" src="/images/imagemap1.gif" />
</a>

top

ImapBase Directive

Description: неплатеж base для imagemap файлов
Syntax: ImapBase map|referer| URL
Default: ImapBase http://servername/
Context: сервер config, действительный хозяин, справочник, .htaccess
Override: индексы
Status: основа
Module: mod_imap

ImapBase директива устанавливает неплатеж base используемый в imagemap файлах. Его ценность отвергнута a base директива в пределах imagemap файла. Если не подарок, base неплатежи к http:// servername / .

см. также

top

ImapDefault Directive

Description: действие по умолчанию, когда imagemap называют с координатами, которые явно не нанесены на карту
Syntax: ImapDefault error|nocontent|map|referer| URL
Default: ImapDefault nocontent
Context: сервер config, действительный хозяин, справочник, .htaccess
Override: индексы
Status: основа
Module: mod_imap

ImapDefault директива устанавливает неплатеж default используемый в imagemap файлах. Его ценность отвергнута a default директива в пределах imagemap файла. Если не подарок, default действие nocontent , что означает это a 204 No Content посылается клиенту. В этом случае, клиент должен продолжить показывать оригинальную страницу.

top

ImapMenu Directive

Description: действие, если никакие координаты не даются, называя imagemap
Syntax: ImapMenu none|formatted|semiformatted|unformatted
Context: сервер config, действительный хозяин, справочник, .htaccess
Override: индексы
Status: основа
Module: mod_imap

ImapMenu директива определяет предпринятое действие, если imagemap файл называют без действительных координат.

none
Если ImapMenu none , никакое меню не произведено, и default действие выполнено.
formatted
A formatted меню - самое простое меню. Комментарии в imagemap файле игнорируются. Уровень один удар головой напечатан, затем hrule, тогда связи каждый на отдельной линии. Меню имеет последовательный, простой взгляд близко к тому из директивного внесения в список.
semiformatted
в semiformatted меню, комментарии напечатаны, где они происходят в imagemap файле. Чистые линии превращены в перерывы HTML. Никакой удар головой или hrule не напечатаны, но иначе меню - то же самое как a formatted меню.
unformatted
комментарии напечатаны, сводят линии на нет, игнорируются. Ничто не напечатано, что не появляется в imagemap файле. Все перерывы и удары головой должны быть включены как комментарии в imagemap файле. Это дает Вам большинство гибкости по появлению ваших меню, но требует, чтобы Вы рассмотрели ваши файлы карты как HTML вместо обычного текста.