형태소 분석 라이브러리 및 실행파일 설치 방법

1) KLT*.tar.gz

   압축을 풀면 KLT2008 라는 디렉토리에 관련 파일들이 설치됨.

    - KLT2008/EXE/
      . 사전(hdic/*.dic) 등 실행에 필요한 파일들이 있음
      . hdic/*.dic -- 실행하는데 필요한 형태소 분석 사전
      . hdic/KLT2000.ini -- 형태소 분석 옵션을 변경(vi 등 텍스트 에디터로 직접 editing)할 수 있음.

    - KLT2008/API/
      . 라이브러리 libindex.a를 링크하여 실행 파일을 만들 때 필요한 파일들
      . 라이브러리 링크에 필요한 예제 소스, makefile 등이 있음.

2) 주요 파일 설명

    - 라이브러리 파일
      API/libindex.a  -- Linux용
      API/KLT2000.DLL -- 윈도용

    - 실행 파일
      index, indexT -- Linux용
      index.exe, indexT.exe, indexWin.exe -- 윈도용

3) 실행 파일의 실행 방법

    - Linux용 실행 파일 index, indexT
    
      $ cd KLT2008/EXE
      $ index <입력파일명> <출력파일명>

      <실행 예>
      	$ index t1.txt t1.out
      	     --> 파일 t1.txt의 분석 결과를 t1.out에 출력
      	$ index -2 t1.txt t1.out
      	     --> 파일 t1.txt의 분석 결과를 t1.out에 출력(옵션 "-2"는 품사정보를 출력함)
      	$ index -2 t1.txt
      	     --> 파일 t1.txt에 대한 분석 결과를 화면(stdout)으로 출력
      	$ index -2
      	     --> 입력 문장을 직접 키보드에서 입력한 후 를 치면, 입력한 문장을 분석함.

      <참고 1> 2번째 인자로 출력 파일을 명시하지 않으면 stdout으로 출력됨.
      <참고 2> 옵션 "-2"만 주고 입출력 파일을 주지 않으면 stdin, stdout으로 입출력을 함!

    
    - 윈도용 indexWin.exe
      윈도용 인터페이스이므로 double click하여 실행할 수 있음.

    - 윈도용 index.exe, indexT.exe 등 기타 실행파일
      DOS창([시작]-[실행]-cmd로 dos창을 연 후에 dos창에서 "C> cd KLT2008/EXE"와 같이
      EXE 폴더로 이동한 후에 linux 실행 방식과 동일한 방법으로 실행.

4. 실행 파일(index.exe 등)을 직접 만드는 방법

   - Linux에서 실행파일 만들기
     . KLT2008/API/ 에서 아래와 같이 make를 실행
     . Makefile 혹은 xxx.mak 등 관련 makefile을 이용하여 실행파일을 만들면
       실행파일이 ../EXE/index 위치에 생성되도록 되어 있음.
     . 실행파일을 만들었으면 ../EXE/ 디렉토리로 이동하여 실행

        $ cd KLT2008/API
        $ make
          --> 실행파일 EXE/index를 생성함.
        $ cd ../EXE
        $ ./index -2 t1.txt

   - 윈도에서 실행파일 만들기
       만들고자 하는 실행파일에 대한 makefile을 참고하여 아래와 같이 실행파일을 만듬.
       1) 해당 makefile에 명시된 .c 파일들을 Project에 포함시킨 후
       2) index/header/ham-api.h라는 파일을 열어서 11번째 line의 comment를 아래와 같이 해제함.
          (일반 형태소 분석기용은 kma/header/ham-kma.h)
       	  #define WINDOWS_DLL
       3) KLT2000.lib을 link하여 build 하면 실행파일이 만들어짐.
       4) 이 실행파일을 EXE/index.exe 위치에 놓고 dos창에서 실행.

5. C++ 소스를 이용하여 라이브러리를 링크할 경우

   - C++ 용 예제 소스 .cpp(index/src/index.cpp, kma/src/kma.cpp 등)를 사용하여 실행파일을 생성.
   - 윈도에서 C++ 예제 소스를 사용할 때는 index.cpp 등 해당 .cpp 파일의 아래 문장을 수정.(VC++ 버전에 따라 다름)

     #include "../header/ham-ndx-CPP2.h"
   --->
     #include "../header/ham-ndx-CPP.h"

6. 구 버전 라이브러리 대신에 새 버전의 라이브러리를 사용할 때 주의할 점!

   - 구 버전 라이브러리를 이용하여 만든 실행 파일은 더 이상 사용할 수 없음.
     즉, 윈도용 .DLL만 교체해서는 제대로 작동하지 않음!
     그 이유는 형태소 분석 관련 자료구조의 일부가 변경되었기 때문임.

   - 따라서 실행파일을 다시 만들어야 하는데 어떻게 해야 하는지...
     header/*.h를 모두 새 버전에 있는 것으로 교체한 후에 실행파일을 다시 생성하거나,
     또는 header/runmode.h만 교체하여 실행파일을 다시 생성해도 됨.
     (즉, 라이브러리를 교체했으면 header/runmode.h도 교체하여 실행파일을 다시 만들어야 함)

<참고> 형태소 분석기를 사용하려면 반드시 아래 파일들이 있어야 함.
 
 1. 실행파일 -- index.exe(또는 indexT.exe, indexQ.exe)
   
 2. 사전파일 -- hdic/KLT2000.ini, hdic/*.dic
    <참고> hdic/*.* 는 반드시 실행파일이 있는 디렉토리에 있어야 하며,
     hdic을 다른 곳으로 이동하면 hdic/KLT2000.ini에서 경로를 지정할 수 있음. 

 3. 윈도용 형태소 분석기는 반드시 DOS창에서 실행하여야 함.

    2008년 1월 10일 국민대학교 컴퓨터학부 강승식 sskang AT cs.kookmin.ac.kr