블루보드 1.0 사용설명서 - blueboard vesion 1.0

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

    블루보드 version 1.0

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

    제  품  명: 블루보드 Blue Board

    제  작  사: 이지나라(주)

    프로그래머: 이정세

    사용  환경: Linux, Unix

    문  의  처: http://easynara.co.kr

                http://blueboard.co.kr

                help@easynara.co.kr

                tel: 02-362-2627

                fax: 02-362-2628

    블루보드는 이지나라(주)의 제품입니다.

    블루보드는 이지나라(주)의 동의없이 소스를 수정할 수 없습니다.

    블루보드는 개인 홈페이지 또는 비영리 목적의 홈페이지에 한하여 무료로 배포되

    고 있으며, 영리 목적의 홈페이지에서는 사용할 수 없습니다.

    블루보드는 한국, 일본, 미국 등의 저작권에 관한 법률, 국제법, 국제조약, 국제

    적인 저작권 협정에 의해 보호를 받고 있습니다.

    

  

    ---------------------

 1. 블루보드 특징 및 기능

    ---------------------

    블루보드는 기존에 나와있는 게시판들의 단점을 보완하고, 장점을 수용하여 제작

    한 웹게시판으로, 하나의 프로그램으로 다양한 종류의 게시판으로 활용할 수 있

    으며, 모양새를 자유롭게 변형할 수 있는 기능은 물론 사용자의 흥미를 유발시키

    는 다채로운 기능을 포함하고 있습니다.

    1) 프로그램 하나로 무한대에 가까운 게시판을 생성하고, 사용할 수 있습니다.

    2) 순차파일구조(ASCII File)가 아닌 바이너리파일구조(Binary File)로 제작된

       자체 DB를 사용하므로써, 게시물 수에 상관없이 동일한 처리시간을 유지합니

       다. (평균 CPU 처리시간 0.02 ~ 0.04초)

    3) 스킨(Skin)이라 불리우는 기능을 이용하여, 하나의 게시판을 전혀 색다른 형

       태, 또는 색다른 기능을 제공하는 게시판으로 변경할 수 있습니다. (게시판,

       자료실, 방명록, 낙서장, 토론실, 투표함, 공지사항, 홈자랑 등등)

    4) 사용자가 글을 남길 때 자신과 비슷한 얼굴 이미지를 선택할 수 있는 얼굴선

       택 기능.

    5) 특정 문자를 귀여운 그림으로 교체시켜주는 스마일리 기능.

    6) 본문에 포함된 URL을 자동으로 링크시켜주는 오토링크 기능.

    7) 특정 단어가 포함된 내용의 글은 저장되지 못하도록 하는 불량단어차단 기능.

    8) 거의 모든 화면 제어와 기능 제어는 관리자모드에서 할 수 있도록 제작되었으

       며, 복잡한 설정메뉴로 가득한 관리자모드를 DHTML을 사용, 그룹별로 정리해

       보다 쉽고 편리하게 이용할 수 있도록 디자인 하였습니다.

    9) 통계프로그램이 내장되어 있어, 총접속수 뿐 아니라, 날짜별 접속수, 시간별

       접속통계, 요일별 통계, OS별 통계, 브라우저별 통계를 확인할 수 있습니다.

       또한 한 사람에 의해 접속수가 늘어나는 중복 문제를 해결함으로써 보다 정확

       한 접속수를 얻을 수 있도록 하였습니다.

    -------------------------

 2. 설치전 확인해야 하는 것들

    -------------------------

    1) 서버에 펄 인터프리터가 설치되어 있는가?

    

    블루보드는 펄(Perl) 인터프리터가 설치된 서버에서만 실행됩니다.

    그러므로 블루보드를 설치하기 전, 설치할 서버에 펄 인터프리터가 설치되어 있

    는지를 먼저 확인하셔야 합니다. 만일 펄 인터프리터가 설치되어 있지 않다면,

    블루보드를 설치한다 하여도 실행시킬 수가 없습니다.

    2) 특정 디렉토리에서만 CGI가 실행되는가?

    펄 인터프리터가 설치되어 있다면, 그 다음으로 CGI 실행 디렉토리를 확인하여야

    합니다. 모든 디렉토리에서 CGI가 작동하는지, 아니면 특정 디렉토리(CGI-BIN 같

    은)에서만 작동하는지를 말이죠. 특정 디렉토리에서만 CGI가 작동되는 것을

    CGIWRAP이라 부르는데, 이러한 환경에서는 설치방법은 다소 복잡해 집니다.

    (설치방법은 4. 설치방법을 참조)

    3) 펄경로는 무엇인가?

    펄(Perl)로 제작된 CGI는 소스 상단에 펄 인터프리터가 설치된 경로를 적어주어

    야만 실행이 가능해 집니다. 블루보드 역시 예외는 아니여서 dbmake.cgi,

    buboard.cgi, buadmin.cgi 이 3개 파일의 첫번째 라인에 펄 경로를 적어줘야만

    합니다.

    배포되는 블루보드는 펄경로가 #!/usr/bin/perl로 적혀 있습니다만 모든 서버가

    이 경로는 사용하는 것은 아닙니다.

    위의 3가지 항목에 대해서는 블루보드를 설치할 서버의 관리자에게 문의를 하시

    면 답을 얻을 수 있습니다.

    --------

 3. 설치방법

    --------

    1) CGIWRAP이 아닌 서버 (모든 디렉토리에서 CGI 실행이 가능한 환경)

    블루보드는 아래와 같은 디렉토리 구조를 가지고 있습니다.

    bluebod -+- lib

    (777)    +- image

             +- help

             +- skin

             +- db ( 자동으로 생성됨 )

    블루보드 메인 디렉토리(bluebod)에는 dbmake.cgi, buboard.cgi, buadmin.cgi,

    system.cgi 4개의 파일이 들어 있습니다.

    블루보드를 설치할 서버에 임의의 디렉토리를 만든 뒤, 블루보드 관련파일을 모

    두 복사합니다.

    서버가 리눅스 또는 유닉스일 경우에는 블루보드가 설치된 디렉토리의 퍼미션을

    777로 변경하여야 합니다. (일부 서버에서는 777이 아닌 755로 변경하여만 제대

    로 동작할 수 있습니다)

    실행파일인 buboard.cgi, buadmin.cgi, dbmake.cgi의 퍼미션을 755로 변경합니

    다.

    실행파일인 buboard.cgi, buadmin.cgi, dbmake.cgi의 첫라인에 펄경로를 적어줍

    니다.

    2) CGIWRAP인 서버 (특정 디렉토리에서만 CGI가 실행되는 환경)

    CGIWRAP은 CGI-BIN 같은 특정 디렉토리에서만 CGI가 구동되는 환경을 의미합니

    다. 이러한 CGIWRAP 환경에서는 실행파일과 나머지 파일들을 서로 달리 설치하여

    야 합니다.

    home -- httpd --+- cgi-bin (CGI가 실행되는 특정 디렉토리)

                    +- html --- bluedata -+- lib

                                (777)     +- image

                                          +- help

                                          +- skin

                                          +- db (자동으로 생성됨)

    (위 디렉토리 구조는 하나의 예제입니다)

    dbmake.cgi, buboard.cgi, buadmin.cgi, system.cgi 4개의 파일은 CGI가 실행되

    는 특정 디렉토리에 복사를 합니다.

    나머지 lib, image, help, skin 디렉토리와 파일은 메인 디렉토리(html)에 임의

    의 디렉토리를 만들고 복사를 합니다.

    그리고나서, system.cgi의 내용을 일부 수정하여야 합니다.

    my $SYSTEM_URL  = ".";

    my $SYSTEM_PATH = ".";

    system.cgi에는 위와 같은 문장이 있습니다. 이곳에 데이터 파일의 경로를 자세

    히 적어주워야만 합니다.

    $SYSTEM_URL에는 메인 디렉토리를 기준으로 블루보드 관련파일이 있는 디렉토리

    를, $SYSTEM_PATH에는 루트 디렉토리를 기준으로 블루보드 관련파일이 있는 디렉

    토리를 기술하여 주면 됩니다. 위 디렉토리 구조를 예를 들면 아래와 같이 기술

    하여 줍니다.

    my $SYSTEM_URL  = "/bluedata";

    my $SYSTEM_PATH = "/home/httpd/html/bluedata";

    서버가 리눅스 또는 유닉스일 경우에는 블루보드 데이터가 설치된 디렉토리의 퍼

    미션을 777로 변경하여야 합니다.

    실행파일인 buboard.cgi, buadmin.cgi, dbmake.cgi의 퍼미션을 755로 변경합니

    다.

    실행파일인 buboard.cgi, buadmin.cgi, dbmake.cgi의 첫라인에 펄경로를 적어줍

    니다.

    

    -----------

 4. DB 생성하기

    -----------

    블루보드는 buboard.cgi 실행만으로 모든 기능을 수행하게 됩니다.

    웹브라우저의 URL(주소)창에 블루보드가 설치된 URL과 파일명을 입력합니다.

    예) http://easynara.co.kr/cgi/bluebod에 블루보드가 설치되어 있다면,

        http://easynara.co.kr/cgi/bluebod/buboard.cgi 라고 입력합니다.

    위와 같이 입력하면 DB생성기 접근암호를 물어오는데, 초기 암호는 easynara입니

    다. 암호를 입력하고 들어가면, DB를 관리하는 화면으로 넘어갑니다.

    이 화면에서는 DB생성기 접근암호를 변경하거나, 만들어진 DB를 관리하거나, 새

    로운 DB를 생성할 수 있습니다.

    DB생성 버튼을 클릭하면, DB생성메뉴가 나옵니다.

    만들고자 하는 DB명과 관리자모드 비밀번호를 입력하면, 새로운 DB가 생성됩니

    다.

    -----------

 5. DB 접근하기

    -----------

    생성된 DB에 접근하기 위해서는 웹브라우저의 URL(주소)창에 블루보드가 설치된

    URL과 buboard.cgi, 그리고 DB명을 입력해야 합니다.

    예) http://easynara.co.kr/cgi/bluebod에 블루보드가 설치되어 있고, 접근할

        DB명이 test라면, http://easynara.co.kr/cgi/bluebod/buboard.cgi?db=test

        라고 입력합니다. html 파일에 링크시킬 경우에도 위와 같은 형태로 링크를

        시키면 됩니다.

    ----------

 6. 관리자모드

    ----------

    각 DB에는 관리자모드라고 하는 설정화면이 포함되어 있습니다.

    관리자모드에서는 게시판의 모양새, 기능 등을 제어할 수 있는 환경을 제공합니

    다. 관리자모드로 들어가기 위해서는 접근한 DB 화면에 있는 admin 버튼을 클릭

    하거나, buadmin.cgi를 DB명과 함께 웹브라우저의 URL(주소)창에 입력하면 됩니

    다.

    예) http://easynara.co.kr/cgi/bluebod에 블루보드가 설치되어 있고, 접근할

        DB명이 test라면, http://easynara.co.kr/cgi/bluebod/buadmin.cgi?db=test

        라고 입력합니다.

    주의) 블루보드의 관리자모드는 익스플로러 5.0에 최적화 되어 있습니다.

          때문에 익스플로러 4.0 ~ 5.0 외에서는 관리자모드의 모든 기능을 제대로

          사용하지 못할 수도 있습니다.

    -------------------

 8. 관리자모드 메뉴설명

    -------------------

    관리자이름:

      게시판 관리자의 이름을 적습니다.

    이메일:

      게시판 관리자의 이메일을 적습니다.

    홈페이지:

      게시판이 설치된 홈페이지의 URL(주소)를 적습니다.

    복귀페이지:

      게시판의 홈버튼을 클릭했을 때, 링크될 페이지를 적습니다.

      복귀페이지를 적지 않으면, 게시판에 홈버튼이 출력되지 않습니다.

    새암호:

      관리자모드 접근암호를 변경합니다.

    

    암호확인:

      관리자모드 접근암호 변경시 새로운 암호를 재확인합니다.

    샌드메일경로:

      메일발송시 사용되는 샌드메일의 경로.

      이것은 서버관리자에게 문의를 하면 됩니다.

    글작성시 관리자에게 메일발송: (아직 지원안함)

      사용자가 게시판에 글을 작성했을 경우, 관리자에게 그 내용을 메일로 전송.

    글작성시 원본글 작성자에게 메일발송: (아직 지원안함)

      사용자가 답장글을 작성했을 경우, 그 원본글 작성자에게 그 내용을 메일로 전

      송.

    윈도우 제목:

      웹브라우저의 타이틀 창에 출력되는 제목.

    게시판 제목:

      게시판 상단에 출력되는 제목.

      제목그림이 지정되어 있으면 출력되지 않음.

    제목그림:

      게시판 상단에 출력되는 그림.

      그림이 있는 URL을 정확히 입력해야 함.

    배경그림:

      게시판 배경에 출력되는그림.

      그림이 있는 URL을 정확히 입력해야 함.

    기본색상:

      게시판의 기본 글자색와 배경색을 설정.

    기본글꼴:

      게시판의 기본 글꼴과 크기를 설정.

      글꼴은 '굴림', 사이즈는 '9'나 '10'이 적당합니다.

    테이블 폭:

      게시판 테이블 폭을 설정.

      픽셀단위나 퍼센트(%) 단위로 설정.

    테이블 정렬:

      게시판 테이블의 정렬위치를 설정.

    링크장식:

      링크된 글자에 커서를 대었을 때, 밑줄이 생기도록 할 것인지의 여부를 설정.

      단, 넷스케이프에서는 지원안됨.

    링크색상:

      link - 링크된 글자의 색상을 설정.

      alink - 페이지를 열고 있는 링크 색상을 설정.

      hover - 커서를 대었을 때, 변하는 색상을 설정. (익스플로러 전용)

    스마일리기능:

      본문 입력시 특정한 단어를 귀여운 얼굴로 자동교체해 주는 기능의 사용여부를

      설정.

    얼굴선택기능:

      본문 입력시 사용자의 얼굴을 선택할 수 있는 기능의 사용여부를 설정.

    HTML문서기능:

      본문 입력시 HTML로 작성된 문서의 입력도 가능하게 할 것인지의 여부를 설정.

    자동링크기능:

      본문 입력시 URL이 있을 경우 자동으로 링크를 시키는 기능의 사용여부를 설정.

      링크타겟 - 자동링크된 글자를 클릭했을 경우 타켓지정.

    불량단어차단:

      본문 입력시 특정단어가 들어간 글은 저장시키지 않는 기능의 사용여부를 설정.

    불량단어목록:

      불량단어 차단기능에 사용할 불량단어 목록을 작성.

      단어는 한 줄에 하나씩 적음.

    공지사항:

      게시판에 대한 간단한 공지사항을 적음.

      공지사항은 게시판의 제목 바로 아래에 출력됨.

    Html Head:

      게시판 상단에 출력할 Html이나 글자를 적음.

    Html Tail:

      게시판 하단에 출력할 Html이나 글자를 적음.

    Page당 글수:

      한 페이지당 출력할 게시물 개수를 설정.

    본문아래목록:

      본문 보여주기 화면 아래에 목록을 몇개까지 보여줄지를 결정.

      0 이면 목록을 표시하지 않음.

    이름출력길이:

      긴 이름이 사용된 글에 한하여 길이를 짤라 출력함.

      0 이면 짤림없이 원본대로 출력됨.

      단위는 byte 임.

    제목출력길이:

      긴 제목이 사용된 글에 한하여 길이를 짤라 출력함.

      0 이면 짤림없이 원본대로 출력됨.

      단위는 byte 임.

    본문출력길이:

      긴 본문이 사용된 글에 한하여 길이를 짤라 출력함.

      0 이면 짤림없이 원본대로 출력됨.

      단위는 byte 임.

    목록버튼위치:

      목록화면에 출력되는 버튼의 위치를 설정.

    본문버튼위치:

      본문보기 화면에 출력되는 버튼의 위치를 설정.

    본문엔터처리:

      본문에 포함된 엔터(<br>)를 원본대로 보여줄지, 스페이지로 변경하여

      보여줄지를 결정.

    화면표시:

      오늘 작성된 글 표시, Page 이동메뉴 표시, 파일 아이콘 표시, 제목앞 그림표

      시, 검색메뉴 표시등을 on/off 함.

    테이블설정:

      게시판 테이블을 세부적으로 조정.

      이부분은 가급적 모두 0으로 해 놓는 것이 좋음.

    필수입력항목:

      반드시 입력해야 하는 항목을 설정.

    기본본문:

      사용자가 글쓰기를 할 경우, 본문에 미리 출력되는 문장을 설정.

    색상종류:

      목록화면의 색상을 홀짝으로 보여줄지, 그라데이션으로 보여줄지 설정.

    배경색-1, 배경색-2:

      색상종류가 '홀짝'일 경우, 배경색-1은 홀수번의 색, 배경색-2는 짝수번의 색

      이 됨. 색상종류가 '그라데이션'일 경우, 배경색-1은 첫번째 칸의 색,

      배경색-2는 두번째 칸의 색이 됨.