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
|