==================================================================

             qValue, Simple CGI utility for SSI technique
                        on Apache web server

==================================================================

1. Why Do We Made This One?

  qValue SSI  (SHTML) Ư  ϱ 
  ߵ  CGI Դϴ. qValue ν  ũ
   Ӱ   Ƿ     ɵ
  Ʈ   ֽϴ.

  qValue is developed for transfering a specified query to web pages
  which applied SSI technique (normally called SHTML). By using
  qValue, you develope more flexible web sites with less efforts.
  Inserting links and texts for dynamic effects in web pages is much
  easier with qValue.

2. Basic Usages

    SSI  SHTML  մϴ.

  <!--#exec cmd="/ABSOLUTE_SYSTEM_PATH/qValue.cgi QUERYNAME"-->
  ex) <!--#exec cmd="/home/www/cgi-bin/qValue.cgi name"-->

       ּ.

  +-[test.shtml]--------------------------------------------------
  | <!--#exec cmd="/..PATH../qValue.cgi name"-->Բ ֹϽ
  | ǰ <!--#exec cmd="/..PATH../qValue.cgi product"--> 
  | ֹȣ <!--#exec cmd="/..PATH../qValue.cgi orderno"-->
  | Դϴ.
  +---------------------------------------------------------------

  +-[Request #1]--------------------------------------------------
  | test.shtml?name=nobreak&product=DM21&orderno=5628
  +---------------------------------------------------------------

  +-[Result #1]---------------------------------------------------
  | nobreakԲ ֹϽ ǰ DM21  ֹȣ 5628 Դϴ.
  +---------------------------------------------------------------

  +-[Request #2]--------------------------------------------------
  | name=%B1%E8%BD%C2%BF%B5&product=%B7%CE%B9%CC%BF%C0&orderno=063
  +---------------------------------------------------------------

  +-[Result #2]---------------------------------------------------
  | ¿Բ ֹϽ ǰ ι̿  ֹȣ 063 Դϴ.
  +---------------------------------------------------------------

  Note) ڷ ־ ڿ URL Encoding Ͽ ϴ 
  ϴٸ, ǻ   Ͽ ٸ  ϴ.
  (SHTML  qValue.cgi  SHTML  virtual 
  include 쿡   Ӱ   ֽϴ. Advanced
  Usages  )

    o Ⱑ  쿣   ᵵ ϴ.
      ex) test.shtml?name=¿

    o  '+' ٲߴϴ.
      ex) test.shtml?name=++   # "  "

    o '&', '='   ڴ '%' + 16 ڵ ٲپ ϴ.
      ex) test.shtml?name=You%26Me   # "You&Me"

  Note) qValue  Query Cascading    ֵ
  SSI  'cmd' մϴ. 'virtual'    ,
  'cmd'  ýۻ  θ ؾ Կ ϼ.

  Note) SHTML   SHTML  (include )ϴ ͵
  ϸ Ե SHTML   ϰ ؼǾ մϴ.

3. Advanced Usages

  +-[/DocumentRoot/prefix/header.shtml]---------------------------
  | <html>
  | <head>
  | <title><!--#exec cmd="/..PATH../qValue.cgi title"--></title>
  | </head>
  | <body>
  +---------------------------------------------------------------

  +-[/DocumentRoot/prefix/tailer.shtml]---------------------------
  | <!--#config timefmt="%Y/%m/%d %H:%M:%S"-->
  | Last modified at <!--#echo var="LAST_MODIFIED"-->
  | </body>
  | </html>
  +---------------------------------------------------------------

  +-[document.shtml]----------------------------------------------
  | <!--#include virtual="/prefix/header.shtml?title=˻ "-->
  | 1: Metallica
  | 2: Ȧ
  | 3: Aerosmith
  | <!--#include virtual="/prefix/tailer.shtml"-->
  +---------------------------------------------------------------
  Note)   qValue.cgi  SHTML  SHTML 
  incude   Ư  (, '&') ϰ
  URL Encoding  ʾƵ ϴ.

  document.shtml °
  +-[Result]------------------------------------------------------
  | <html>
  | <head>
  | <title>˻ </title>
  | </head>
  | <body>
  | 1: Metallica
  | 2: Ȧ
  | 3: Aerosmith
  | Last modified at 1999/11/24 22:01:00
  | </body>
  | </html>
  +---------------------------------------------------------------

4. To enable CGI & SSI.

  Apache  (httpd.conf)   ã ּ 
  ϰ,  丮 Includes ɼ ߰մϴ.

  +-[httpd.conf]--------------------------------------------------
  | # To use CGI scripts:
  | AddHandler cgi-script .cgi
  |
  | # To use server-parsed HTML files
  | AddType text/html .shtml
  | AddHandler server-parsed .shtml
  |
  | <Directory "/SYSTEM_PATH">
  |   Options FollowSymLinks ExecCGI Includes
  | </Directory>
  +---------------------------------------------------------------

+-----------------------------------------------------+
+------------------ E     N     D --------------------+
+-----------------------------------------------------+
