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äfer</surname> 0018 <affiliation> 0019 <address><email>j_schaef@informatik.uni-kl.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ä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äfer <email>j_schaef@informatik.uni-kl.de</email> 0158 </para> 0159 0160 <para> 0161 Documentation copyright 2007 Jan Schäfer <email>j_schaef@informatik.uni-kl.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