Warning, /graphics/kimagemapeditor/doc/index.docbook is written in an unsupported language. File is not indexed.

0001 <?xml version="1.0" ?>
0002 <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
0003   <!ENTITY kimagemapeditor "<application>KImageMapEditor</application>">
0004   <!ENTITY % addindex "IGNORE">
0005   <!ENTITY % English "INCLUDE"><!-- change language only here -->
0006 ]>
0007 
0008 <book id="kimagemapeditor" lang="&language;">
0009 
0010 <bookinfo>
0011 <title>The &kimagemapeditor; Handbook</title>
0012 
0013 <authorgroup>
0014 <author>
0015 <firstname>Jan</firstname>
0016 <othername></othername>
0017 <surname>Sch&auml;fer</surname>
0018 <affiliation>
0019 <address><email>j_schaef&#64;informatik&#46;uni-kl&#46;de</email></address>
0020 </affiliation>
0021 </author>
0022 
0023 <!-- TRANS:ROLES_OF_TRANSLATORS -->
0024 </authorgroup>
0025 
0026 <copyright>
0027 <year>2007</year>
0028 <holder>Jan Sch&auml;fer</holder>
0029 </copyright>
0030 
0031 <legalnotice>&FDLNotice;</legalnotice>
0032 
0033 <date>2011-08-22</date>
0034 <releaseinfo>3.9.0 (&kde; 4.7)</releaseinfo>
0035 
0036 <abstract>
0037 <para>
0038 &kimagemapeditor; is an &HTML; imagemap editor by &kde;.
0039 </para>
0040 </abstract>
0041 
0042 <keywordset>
0043 <keyword>KDE</keyword>
0044 <keyword>KImageMapEditor</keyword>
0045 <keyword>imagemap</keyword>
0046 <keyword>usemap</keyword>
0047 <keyword>html</keyword>
0048 </keywordset>
0049 
0050 </bookinfo>
0051 
0052 <chapter id="using">
0053 <title>Using &kimagemapeditor;</title>
0054 
0055 <para>
0056 &kimagemapeditor; is a &HTML; imagemap editor developed by the &kde; community.
0057 It allows you to create and modify &HTML; <ulink url="http://en.wikipedia.org/wiki/Imagemap">Imagemaps.</ulink>
0058 </para>
0059 
0060 <screenshot>
0061 <screeninfo>Here's a screenshot of &kimagemapeditor;</screeninfo>
0062         <mediaobject>
0063           <imageobject>
0064             <imagedata fileref="mainwindow.png" format="PNG"/>
0065           </imageobject>
0066           <textobject>
0067             <phrase>Screenshot</phrase>
0068           </textobject>
0069           <caption>
0070             <para>
0071               &kimagemapeditor; main window.
0072             </para>
0073           </caption>
0074         </mediaobject>
0075 </screenshot>
0076 
0077 <para>A common use case is a world map where each country is an imagemap. 
0078 By clicking on a country in the map you can open a link to the selected 
0079 country.</para>
0080 
0081 <para>Creating an imagemap requires the following steps:</para>
0082 
0083 <para>Load an image file (<filename class="extension">png</filename>, 
0084 <filename class="extension">jpg</filename>, <filename class="extension">gif</filename>) 
0085 or a &HTML; file from your disk or drag 
0086 it into the image area. Select an image in the <guilabel>Images</guilabel> docker.</para>
0087 
0088 <para>Add a imagemap using <menuchoice><guimenu>Map</guimenu><guimenuitem>New 
0089 Map</guimenuitem></menuchoice> from the menu and enter a map name.</para>
0090 
0091 <para>Now the <guimenu>Tools</guimenu> menu is enabled and you can 
0092 select the appropriate geometric shape like <guimenuitem>Circle</guimenuitem>, 
0093 <guimenuitem>Rectangle</guimenuitem>, <guimenuitem>Polygon</guimenuitem> or 
0094 <guimenuitem>Freehand Polygon</guimenuitem> and define a clickable area in 
0095 the image.</para>
0096 
0097 <para>The <guilabel>Area Tag Editor</guilabel> dialog is displayed. On the <guilabel>General</guilabel> 
0098 tab enter the attributes <guilabel>HREF</guilabel> (a link's target &URL;), <guilabel>Alt.Text</guilabel>, 
0099 <guilabel>Target</guilabel> and <guilabel>Title</guilabel>.</para> 
0100 
0101 <para>The <guilabel>Coordinates</guilabel> tab shows the geometric data of the shape. 
0102 Editing the value allows you to adjust size and position on the image as your changes 
0103 are immediately visible in the image. Size and position can be altered using the mouse 
0104 as well.</para>
0105 
0106 <!--para>JavaScript tab Enter name of funtions defined where? for actions</para-->
0107 
0108 <para>To open the <guilabel>Area Tag Editor</guilabel> dialog for an already defined 
0109 imagemap use <guimenuitem>Properties</guimenuitem> from the <guimenu>Edit</guimenu> 
0110 menu or the context menu of the region.</para>
0111 
0112 <para>Use <menuchoice><guimenu>Map</guimenu><guimenuitem>Show HTML</guimenuitem></menuchoice> 
0113 to view the generated &HTML; code of the map.</para>
0114 
0115 <para>Next open <menuchoice><guimenu>Image</guimenu><guimenuitem>Edit Usemap...</guimenuitem></menuchoice> 
0116 and enter the map name as usemap value. Save your work with <menuchoice><guimenu>File</guimenu>
0117 <guimenuitem>Save</guimenuitem></menuchoice>. Open the &HTML; file in &konqueror; to verify that 
0118 the imagemap is working as expected.</para>
0119 
0120 <!-- 
0121 Map-Preview is empty?
0122 
0123   Draft of Howto create an imagemap
0124   1) Load Image (png/jpg/gif) or html file
0125   2) Tools Circle Rectangle Polygon to define an area
0126   3) Area Tag Editor (Property from context menu) Link+AltTag+..., Coordinates, JavaScript
0127   4) Map->Show HTMl to view the html code of the map
0128 --> 
0129 <para>
0130     Configuration options of &kimagemapeditor; can be accessed by opening the configuration dialog with selecting <menuchoice> <guimenu>Settings</guimenu> <guimenuitem>Configure &kimagemapeditor;...</guimenuitem> </menuchoice> from the menu.
0131 </para>
0132 <screenshot>
0133 <screeninfo>Configuration dialog of &kimagemapeditor;</screeninfo>
0134         <mediaobject>
0135           <imageobject>
0136             <imagedata fileref="configure.png" format="PNG"/>
0137           </imageobject>
0138           <textobject>
0139             <phrase>Configuration dialog of &kimagemapeditor;</phrase>
0140           </textobject>
0141           <caption>
0142             <para>
0143               Configuration dialog of &kimagemapeditor;.
0144             </para>
0145           </caption>
0146         </mediaobject>
0147 </screenshot>
0148 </chapter>
0149 
0150 <chapter id="credits">
0151 <title>Credits and License</title>
0152 
0153 <para>
0154 &kimagemapeditor;
0155 </para>
0156 <para>
0157 Program copyright 2003-2007 Jan Sch&auml;fer <email>j_schaef&#64;informatik&#46;uni-kl&#46;de</email>
0158 </para>
0159 
0160 <para>
0161 Documentation copyright 2007 Jan Sch&auml;fer <email>j_schaef&#64;informatik&#46;uni-kl&#46;de</email>
0162 </para>
0163 
0164 <!-- TRANS:CREDIT_FOR_TRANSLATORS -->
0165 &underFDL;               <!-- FDL: do not remove -->
0166 
0167 &underGPL;               <!-- GPL License -->
0168 
0169 </chapter>
0170 
0171 
0172 &documentation.index;
0173 </book>
0174 
0175 <!--
0176 Local Variables:
0177 mode: sgml
0178 sgml-minimize-attributes:nil
0179 sgml-general-insert-case:lower
0180 sgml-indent-step:0
0181 sgml-indent-data:nil
0182 End:
0183 
0184 vim:tabstop=2:shiftwidth=2:expandtab 
0185 -->
0186