File name: README.TXT (12,222 bytes) Text file viewer v1.2
 WEL(Web Effector Language) Interpreter version 1.0 for Linux
 Copyright (c) 1999/2000/2001/2002 by Wesoft Corp. All rights reserved.
-------------------------------------------------------------------------------

          "웹 프로그래밍이나 문서화 등의 작업을 쉽고 편하고 빠르게!!"

    이것이 웰(Wel)의 모토(motto)이며 이상입니다.  새로이 배포되는 Wel은  버전
  1.0 으로 V0.9.2의 많은 버그를 교정하였고 다수의 함수 추가 및 최적화되었으며
  문제가 많았던 초기 버전에 비하면 상당히 안정화된 버전입니다.

 0. 웰(Wel) V0.9.2 및 하위 버전을 설치한 사용자를 위하여

     Wel V0.9.2 및 하위 버전을 사용하고 계셨다면  그때와 같은 방법으로 설치를
   하시면 됩니다.   단, calc나 기타 Wel에 의해서 실행되는 프로그램으로 인하여
   wel이 실행 중이라면 이들을 모두 중지한 후에 설치를 하셔야 합니다.
   ps -ax|more 하셔서 wel이란 명칭을 발견하시면 꼭 종료시켜 주세요.
     웰(Wel) V1.0 이 설치되고 나면  과거의 도움말 및 예제 프로그램이 있는 Wel
   디렉토리명은 "wel.org.수치" 형식으로 남게 되는데 가능하면 삭제를 하십시요.

   혹시 Wesoft 사이트에서 Wel 프로그램을 다운 받아서 사용하고 있거나 또는
   프로그래밍 하실 때 #!/bin/wel -html 과 같이 -html 옵션을 사용하셨다면
   에러가 발생하실 것입니다.  이것은 초기 버전에서 옵션으로 사용하였으나
   HTML 헤더를 자동으로 출력하게 되어 제거된 기능입니다. Wel V1.0 을 설치
   하신후에 해당 프로그램들이 웹 상에서 에러가 발생한다면 해당 파일이 있는
   디렉토리에서 아래와 같이 입력하여 파일의 내용을 변경하여 주십시요.

   # tsr -s '#!/bin/wel -html' -r '#!/bin/wel' *.wel


 1. 웰(Wel)의 설치

     웰(Wel) V1.0 은 linux가 설치된 PC에서만 사용 가능합니다.
     다운을 받으신 다음에 root권한으로 아래와 같이 실행하세요

      # tar -zxvf wel-1.0-rh6.tgz
        (또는 tar -zxf wel-1.0-rh5.tgz 또는 tar -zxf wel-1.0-rh7.tgz)

      # cd wel-1.0
      # ./welsetup


 2. 웰(Wel) 언어의 시작

     설치가 끝난 후 wel을 입력하시고 엔터를 치시면 사용법이 출력될 것입니다.
   이것이 Wel의 해석기(interpreter)이며 에디터로 프로그램을 작성하신 후, 사용
   설명처럼 실행하시면 됩니다. 또는 스크립트를 실행할 때 처럼 원시 프로그램의
   첫줄에 "#!/bin/wel"이라 하신후 실행 허가모드를 설정하고 바로 실행하셔도 됩
   니다.  설치된 Wel의 에러 메시지는 한글로 출력됩니다.


 3. 웰(Wel)의 도움말

     C 언어를 아시는 분은 Wel을 쉽게 이해 하실 수 있을 것이며 모르시는 분도
   체계적인 도움말을 통하여 쉽게 배우실 수 있을 것입니다.  도움말 내에는 각
   함수별 상세 설명과 Wel 문법의 체계가 정리되어 있습니다.  도움말을 보시려
   면 어디에서나 welhelp 라 명령을 입력하시면 됩니다.  한글 버전으로 문서가
   작성되어졌기 때문에  X window를 사용하시거나 터미널 상에서 한글을 입출력
   할 수 있다면 쉽게 Wel을 습득하실 수 있을 것입니다.
     설치된 디렉토리를 보시면  welhelp.hwp 라는 파일이 있을 것입니다.  웰의
   도움말을 HWP 파일로 편집한 것으로 인쇄하시어 보시면  많은 도움이 되실 것
   입니다.  또한 설치 디렉토리 아래의 wwwhelp.tgz 파일은 HTML로 작성된 웰의
   도움말을 압축한 것이며 그 내용을 웹 홈으로 복사하여 웹 브라우저로 학습을
   하셔도 됩니다. 웰 V1.0에 마지막으로 추가된 기능중의 하나가 온라인 실시간
   도움말이며 이 기능도 wwwhelp.tgz에 포함되어 있습니다. 이것은 웹 프로그램
   작성시 에러가 발생하면  해당 에러의 원인 및 해당 함수에서 발생될 수 있는
   에러의 종류와 예제를 참고할 수 있으며  보다 빠르게 원인 분석 및 디버깅을
   할 수 있는 환경을 제공합니다.

   ※ 웰 도움말을 설치한 후에  예제 데이터베이스를  설치하지 않으면  mSQL과
      MySQL 데이터베이스에 대한 도움말을 보실때 대부분 에러가 발생합니다.
      이것은 각 데이터베이스 종류별로 예제 데이터베이스의 테이블에서 자료를
      얻어와서  도움말의 예제를 표시하기 때문이며  웰을 설치하신 후  아래와
      같이 명령을 주시면 각각 welhelp라는 데이터베이스와 addr이라는 테이블을
      생성할 것이며 데이터베이스 관련 도움말이 정상적으로 보여질 것입니다.

     (1) MySQL 도움말 예제 설치

         # /wel 디렉토리/help/database/mysql/mysqlSampleCreate

     (2) mSQL 도움말 예제 설치

         # /wel 디렉토리/help/database/msql/msqlSampleCreate


 4. 웰(Wel)의 예제

    Wel을 쉽게 배우도록 하기 위하여 설치 디렉토리 아래 sample 이라는 디렉토
  리에 각종 예제 파일을 넣어 두었습니다.  그것을 참고하여  Wel을 학습하시면
  많은 도움이 될 것입니다.


 5. 웰(Wel)의 데이터 베이스 연동

    현재 버전의 Wel은  mSQL과 MySQL database와 연동이 되도록 프로그램 되어
  있습니다.  mSQL이나 MySQL을 설치하지 않았다면 이 부분들은 실습해 보실 수
  없습니다.  웹 프로그램을 작성하시고 또한  자료 관리를 하시려면  mSQL이나
  MySQL을 설치하셔야 합니다.(mSQL과 MySQL의 버전이 Wel 도움말에 표시된 것과
  다를 경우에도 해당 데이터베이스를 사용하지 못할 수도 있습니다)


 6. 웰(Wel)을 위한 웹서버 환경

   (1) 웹 상에서 Wel을 실행하시려면 아파치 서버의 환경파일 중에서 srm.conf의
       165번째(다를 수도 있음) 라인을 아래와 같이 변경해 주세요(최근 버전의
       웹 서버인 경우는 httpd.conf 파일에서 아래의 내용을 찾으십시요)

         # To use CGI scripts:
         AddHandler cgi-script .cgi

       이것을 아래와 같이 수정하세요

         # To use CGI scripts:
         AddHandler cgi-script .cgi .wel   <--- ".wel" 을 추가 하세요

   (2) index.wel이란 파일을 index 파일로 인식되도록 하려면 srm.conf의 25번째
       (다를 수도 있음) 라인을 아래와 같이 변경해 주세요(최근 버전의 웹 서버
       인 경우는 httpd.conf 파일에서 아래의 내용을 찾으십시요)

         DirectoryIndex index.html index.htm index.shtml index.cgi

       이것을 아래와 같이 수정하세요

         DirectoryIndex index.html index.htm index.shtml index.cgi index.wel


 7. /etc/wel.passwd의 설명 및 변경

      자세한 것은 /etc/wel.passwd의 선두에 설명된 주석을 참고하시기 바라며
    여기에서는 각 변수의 역할 및 설정에 관하여 말씀 드리겠습니다.
    (웹 서버의 루트 디렉토리가 /home/httpd가 아닌 경우는 (5)번 항목을 반드시
     참고 하시기 바랍니다)

   (1) @welftp와 @welftp_dir은 /wel/sample/html/welftp를 CGI디렉토리에 복사하여
       사용하실때 클라이언트에 전달되는 쿠키를 암호화 또는 복호화 하는 목적으로
       사용합니다. 만일 welftp를 /home/httpd/cgi-test/welftp와 같은 위치에 설치
       하셨다면 @welftp_dir="/home/httpd/cgi-test/welftp"로 변경하셔야 합니다.

   (2) cgipasswd, @cgipasswd, @cgipasswd_dir은 visit, biff 등과 같은 CGI 프로
       그램에서 사용자 검증을 하기 위한 것입니다.  이것을 변경하지 않고 visit
       와 같은 프로그램을 사용하신다면  다른 곳에서 암호를 "test" 로 입력하여
       실행 결과를 볼 수 있을 것입니다.  가능하다면 cgipasswd의 내용과 복호화
       키인 @cgipasswd는 변경하여 주시고 CGI 디렉토리가 /home/httpd/cgi-pub와
       같다면 @cgipasswd_dir="/home/httpd/cgi-pub"로 변경하여 주세요.

   (3) adminpasswd, @adminpasswd, @adminpasswd_dir은 웰 게시판(welboard)에서
       관리자 암호로 사용되는 것입니다.  초기 암호는 "test"이며 웰 게시판을
       사용하시게 되면 바꿔 주시기 바랍니다.  @adminpasswd_dir의 값이 웰 게시판
       이 설치된 디렉토리와 다르다면 그 값을 변경하여 주세요

   (4) cgipasswd와 adminpasswd를 변경하는 방법

       0) cgipasswd에 관련된 것을 변경하는 방법을 설명드리겠습니다.

       1) 일단 본인이 희망하는 복호화 키를 먼저 설정합니다.  예를 들어
          cgipasswd의 복호화 키를 "i&you"로 하신다면  @cgipasswd="i&you"로
          하십시요.

       2) 프롬프트상에서 calc를 실행하여 아래와 같이 암호문자열을 얻어 옵니다.
          (희망하시는 암호가 "helpme"라고 가정합니다)

          # calc
          Calculator V0.2 Copyright (c) 1999 by Wesoft Corp. (It's a wel)

          -- 계산식이나 한 줄로된 Wel언어 문장을 입력할 수 있습니다 -----

          계산식: encode("helpme", encodekey(), "i&you")
          계산결과: 6ttUSO5qyjSEt41L3TzKF

          #

          위에서 얻어진 암호 문자열 "6ttUSO5qyjSEt41L3TzKF"로 /etc/wel.passwd를
          변경 합니다.

          cgipasswd="6ttUSO5qyjSEt41L3TzKF"

       3) 변경하셨으면 확인을 해 보겠습니다.
          ( @cgipasswd_dir이 @cgipasswd_dir="/home/httpd/cgi-bin" 라 가정함 )

          # cd /home/httpd/cgi-bin
          # calc
             .
             .
             .
          계산식: decode(cgipasswd, "", "@cgipasswd")
          계산결과: helpme

          # cd ..
          # calc
             .
             .
             .
          계산식: decode(cgipasswd, "", "@cgipasswd")
          계산결과: O드j

          #

       4) 해당 디렉토리에서 해독된 암호가 "helpme"라 출력이 되고 cd .. 을 하여
          다른 디렉토리에서는 다른 문자열로 출력되거나 깨어지면 정상적으로
          변경을 하신것입니다.

   (5) RedHat v7.x 처럼 웹 서버의 root directory가 /home/httpd 디렉토리외의
       다른 곳일 경우 암호 처리에 문제가 발생합니다.  이것은 암호 해독이 가
       능한 디렉토리를 /home/httpd 이하의 해당 디렉토리로 /etc/wel.passwd에
       설정되어 있기 때문이며 아래와 같이 root 아이디로 작업하시면 됩니다.
         참고로 RedHat v7.x 호환의 리눅스 배포판인 경우 웹 서버의 root 디렉
       토리가 /var/www로 변경되었으며, 이 디렉토리로 설정하는 예를 아래에서
       설명합니다.

       # cd /etc
       # emacs wel.passwd
             .
             .
             .
        @welftp_dir="/home/httpd/cgi-bin/welftp";

         (여기에서 /home/httpd/cgi-bin/welftp를 /var/www/cgi-bin/welftp로 변경)
             .
             .
             .
        @cgipasswd_dir="/home/httpd"

         (여기에서 /home/httpd를 /var/www로 변경후 저장한다)

       # rm -f wel.passwd~

       ※ 만일 웹 서버의 루트 디렉토리가 설정한 것과 일치하지 않을 때는 각종
          CGI 프로그램에서 암호 해독을 위한 해독키가 @cgipasswd인 경우 모든
          암호가 해독이 되지 않아서 프로그램이 정상적으로 실행되지 않습니다.


 8. 웰(Wel)의 설치 내용

    /wel/help ------------------> 도움말 디렉토리(도움말은 welhelp 명령을 입력)
    /wel/welhelp ---------------> HTML 도움말 디렉토리

    /wel/sample/wel ------------> Wel 언어 예제 프로그램 모음 (weldir 설명 포함)
    /wel/sample/form -----------> form macro에 관한 예제 프로그램
    /wel/sample/html -----------> 웹 프로그래밍을 위한 예제 모음
    /wel/sample/html/biff ------> email 수신 알림 프로그램
    /wel/sample/html/game ------> 가위 바위 보 게임
    /wel/sample/html/test ------> 간단한 Web 프로그램 예제
    /wel/sample/html/visit -----> 방문자 기록 및 통계 프로그램
    /wel/sample/html/welftp ----> 웹으로 개인 계정의 파일 보기, upload, download
    /wel/sample/html/welmail ---> email 발송 예제 프로그램
    /wel/sample/html/whois -----> whois service(IP,domain name에 대한 정보 얻기)

    /bin/wel -------------> Wel 언어 해석기(interpreter)
    /bin/form ------------> form macro를 실습할 수 있는 실행 파일
    /bin/tfc -------------> Text file 변환 utility(UNIX를 DOS로, DOS를 UNIX로)
    /bin/tsr -------------> 원시 프로그램의 내용을 수정할때 사용하는 utility

    /bin/calc ------------> 계산기 Wel 원시 프로그램
    /bin/fcrypt ----------> 암호화/복호화 Wel 원시 프로그램
    /bin/fdump -----------> file 내용을 dos의 debug.exe처럼 dump
    /bin/welcal ----------> 만년달력 출력 프로그램
    /bin/welcal2 ---------> 만년달력 출력 프로그램#2(색상 출력)
    /bin/welconv ---------> Wel V0.5.1b 이하의 원시 프로그램 변환기
    /bin/weldir ----------> 설명과 함께 파일 목록 보기 Wel 원시 프로그램
    /bin/welhelp ---------> Wel의 도움말 보기 프로그램
    /bin/weltime ---------> 시간 출력 프로그램

    /etc/wel.passwd ------> 웰의 암호 및 초기 변수 설정 파일

   ※ /wel/sample 에서 weldir 이라 입력해 보세요, 파일의 설명이 출력됩니다.
      어떤 파일에 대하여 설명을 추가 하시려면,

        weldir -c 파일명 "설명"

      이렇게 하시면 그 파일에 대한 설명을 추가하거나 변경하실 수 있습니다.

   ※ 어디에서나 calc 라 입력해 보세요, 간단한 Wel언어를 실습하실 수 있습니다.

   ※ welcal2라 입력해 보세요, 만년달력이 칼라로 출력될 것 입니다.


9. 사용 규약 (License)

    (1) 본 소프트웨어에 대한 저작권과 지적 소유권은 Wesoft가 가지고 있으며,
        이 권리는 대한민국의 저작권법과 국제 저작권 조약에 의하여 보호됩니다.

    (2) 현재 버전의 Wel 언어 해석기 사용 기간에 제한이 없으며 제작자의 동의없이
        본 소프트웨어를 상용 소프트웨어에 삽입하여 판매할 수 없습니다.

    (3) 본 소프트웨어는 개인이나 단체가 학습을 목적으로 자유로이 사용할 수
        있으며 사용함에 있어 겪을 수 있는 물적, 정신적 불이익에 대하여 Wesoft는
        배상의 의무가 없습니다.

-------------------------------------------------------------------------------
                                                                 2002년 9월 1일
--<< end >>--                                                            Wesoft
File name: README.TXT (12,222 bytes) Wesoft Corp. ⓒ 2001 All rights reserved.