TkMapedit 2.1 Hand Book

TkMapedit is a clickable map configuration file editor for CERN/ NCSA httpd,Netscape NetSite, and Client Side Map.
Here is a current version of

Table of Contents

  1. REQUIREMENTS
  2. FUNCTIONS
  3. INSTALL
  4. WINDOW OVERVIEW
  5. MENUS
  6. CANVAS
  7. CONFIGURATION
  8. FAQ

REQUIREMENTS:

FUNCTIONS

tkmapedit allows the user to:

INSTALL:

  1. extract tkmapedit distribution as following:
    % gzcat tkmapedit-2.1.tar.gz | tar xvf -
    and enter tkmapedit directory:
    % cd tkmapedit-2.1
  2. run install script as following:
    % wish4.1 install.tcl
    or
    % wish4.0 install.tcl
  3. the install script will display following window:
    then, fill out forms as following:
    1. "directory" forms:

      bin dir:
      Lets you enter a directory path where execution file will be installed.
      lib dir:
      Lets you enter a directory path where library and icon files will be installed. tkmapedit-2.1 use following path hierarchy:
      $libdir/lib  - tcl library files
             /icon - icon (xbm and ppm formats)
      resource dir:
      Lets you enter a directory path where resource file will be installed. the resource file is used for configuration. for more detail, see configuration section.
    2. "doc URL" form:

      Lets you enter a URL of documentation for tkmapedit2.1. default URL is
      http://www.ifnet.or.jp/~translator/tools/TkMapedit/
      This is a official URL for tkmapedit. But this means you have to access the INTERNET when you want to view a help message. I think this is *NOT* good for some peoples using DialUp-PPP connection. Don't worry! you've already everything for tkmapedit. *This* document is one. So you can enter as following:
      file:/Where/You/Extract/tkmapedit-2.1/doc/index.html
    3. "path hierarchy" forms:

      Lets your enter your http server's path hierarchy for HTML docs. This is for Util menu.
      server top dir:
      If URL which associated with some object on canvas takes "http://Server/path/..." form, and you wish to edit its file entry, tkmapedit will substitute contents of this form for "http://Server/", and launch your editor.
      public html dir:
      If URL contains "~YourLoginName", tkmapedit will substitute "$HOME/ContantsOfThisForm". "public_html" is used in many site.
      welcome file name:
      If URL is any directory path, then tkmapedit will add contents of this form to the URL. Many site use "index.html". but some site use "welcome.html". for more detail, please ask your web master, or your admin.
    4. default map format form:

      choices default map format.
    5. WWW Utils forms:

      WWW Viewer:
      choices your WWW browser which tkmapedit will launch.
      WWW Editor:
      choices your HTML editor which tkmapedit will launch.
      you can use another browser and/or editor. see configuration section.
    6. Icon forms:

      Try this default setting, install, execute tkmapedit, iconic it, and move mouse cursor to tkmapedit icon;-)
    Next, you must compile and install tkmapedit.

    Firstly, click "Compile" button. Actually, tkmapedit doesn't need any compiler. but some file needs rewriting to reflect your settings. So installer itself do this. the installer will rewrite some tcl files, and generate minimum resource file. Secondly, click "install" button. the installer will copy tkmapedit files. Then instlation done! click "Dismiss" button. Now, you can execute tkmapedit as following:
           % tkmped2 &
    or
           % tkmped2 YourMapFileName&

WINDOW OVERVIEW

Here is a main window of tkmapedit.

MENUS

This menu bar provides following menus.
File Menu
provides following menu item.
  1. New
    Clear canvas. and initialize all.
  2. load Mapfile...
    Produces the FileSelectionBox that lets you select a map file and its format to load.
  3. load Imagefile...
    Produces FileSelectionBox that lets you select a image file to load.
  4. Save mapfile
    Save map data to current map file. If current map file name is empty, tkmapedit will produces the FileSelectionBox.
  5. save mapfile As...
    Produces FileSelectionBox that lets you select a map file name and map format to save.
  6. save imageFile as...
    Produces FileSelectionBox that lets you select a image file name and its format to save.
  7. Print...
    Produces following print dialog:

    This print dialog provide following function.
    select target
    Lets you select a target, PS file or PS Printer.
    lpr command
    Lets you enter a lpr command line. tkmapedit refer "PRINTER" environment variable.
    file name
    Lets you enter a PS filename. FileSelectionBox is available.
    page layouts
    Lets you choice page layouts.
    Print button
    generates PS Data, and send it to printer OR save as a file.
    Dismiss button
    closes Print dialog.
  8. Exit
    exits tkmapedit.
Edit Menu
provides following menu items.
  1. Delete
    deletes selected object on the canvas.
  2. Cut
    cuts selected object on the canvas and save it to cut buffer.
  3. cOpy
    copy selected object to cut buffer.
  4. Paste
    pasts a contents of cut buffer to the canvas.
  5. Fore item
    puts the selected object to top of them.
  6. Back item
    puts the selected object to bottom of them.
  7. Raise image
  8. Lower image
View
provides following menu items.
  1. Fill
    selects set/unset fill mode.
provides following menu items.
  1. editor
    selects "launch editor" mode. In this mode, If you click any object on the canvas, then tkmapedit will launch a editor to edit the file which associated the object by URL.
  2. viewer
    select "launch viewer" mode. In this mode, If you click any object on the canvas, then tkmapedit will launch a WWW browser to browse the URL which associated the object.
  3. clear
    clear any launch mode.
Help
provides following menu items.
  1. About
    display version and patch level.
  2. Handbook
    display this documents using your web browser.

CANVAS

url and alt forms
Lets you enter URL and/or ALT attribute which will be associated to the selected item.
select button
enters "select mode". In this mode, you can select any item on the canvas.
circle, rectangle, polygon, and point button
draw each item.
IMPORTANT
point object is only supported in CERN/NCSA format. this means you can not save this object using NetSite or ClientSideMap format.
ALT attribute is only supported in ClientSideMap format.

File Selection Box


File Selection Box for tkmapedit is almost same as OSF Motif's one, except "Format" menu button. Format menu button lets you select file format.

CONFIGURATION

Tkmapedit is supports user configuration using X resource file. Following is the resource list (summary).
Resource for Tkmapedit
Resource NameMeans Default (alternative..)
*viewerExecWWW browserexec netscape -remote openURL(%U)
("send surfit {cleate_window %U}")
*editorExecHTML editorexec emacsclient %F
("send tkHTML {OpenFile %F}")
*printDistinationDefault targetprinter (or file)
*printFileNameDefault filenamenil
*printColorModeDefault modemono (or gray, color)
*printSizepaper sizea4 (or letter, figure, legal)
*ovalURLAnchorposition of URL for oval object when printing.nw (or n,ne,e,es,s,sw,w,c)
*rectangleURLAnchorposition of URL for rectangle object.nw
*polygonURLAnchorposition of URL for polygon object.nw
*pointURLAnchorposition of URL for point object.n
*defaultURLAnchorposition of default URLnw
*Canvas.itemColorcolor of objectblack
*Canvas.itemWidthwidth of object1
*Canvas.drawingColorcolor when editinggreen
*Canvas.drawingWidthwidth when editing1
*Canvas.fillColorcolor for fill modeblack
*Canvas.selectColorcolor when selectedred
*Canvas.selectWidthwidth when selected3
*Canvas.handleColorcolor for handlesred
*Canvas.stipplestipple for objectgray25
*Canvas.selectStipplestipple when selectedgray50
*Canvas.backgroundbackground for canvaswhite
For more detail, see tk online manual.

FAQ

This section of this document is under construction. Please report me any question and/or answer. Let's create this section together!

Takeshi Taguchi
Office:<taguchi@aic.co.jp>
HOME:<translator@grape.ifnet.or.jp>

Last modified: Mon Jan 8 15:19:55 1996 File Browser Button File Browser Button File Browser Button File Browser Button File Browser Button install buttons Icon form WWW Utils form default map format form path hierarchy form document URL form target directories form File Menu Button Edit Menu Button View Menu Button Help Menu Button Util Menu Button menu bar NeXT Step like title bar by I18N bowman window manager. Dissmiss Print Orientation etc... Browse... File Name: Print Command: Print to: