====== AutoTorrentRG Manual ======
AutoTorrentRG는 아래와 같이 여섯개의 세부 설정을 가지고 있습니다.
* 헤더 설정 (connector)
* 접속 설정 (access)
* 로그인 설정 (login)
* 크롤러 설정 (crawler)
* 필터 설정 (filter)
* 다운로더 설정 (downloader)
이 설정들은 모두 ini 확장자를 가진 텍스트 파일로 저장됩니다. 아무 텍스트 편집기로 직접 편집해도 되고, GUI버전을 사용할 경우 '설정' 대화 상자를 이용하여 편집을 할 수 있습니다. 표에서 굵은 글씨로 표기된 항목은 GUI에서 사용자가 "고급 설정 열기"를 체크하지 않아도 편집 가능합니다.
===== 헤더 설정 (connector) =====
이 설정은 AutoTorrentRG가 서버에 보내는 request header를 꾸며주는 역할을 합니다. Firefox v17.0을 기본으로 하여 만들었으며 특별한 이유가 없는 한 변경할 필요는 없습니다. 기본값은 다음과 같습니다.
^변수^기본값 ^설명^
|user-agent|"Mozilla/5.0 (Windows NT 6.2; rv:17.0) Gecko/17.0 Firefox/17.0"|ini 파일의 주석 처리를 방지하기 위해 큰따옴표로 감쌉니다.|
|accept|text/html,application/xhtml+xml,application/xml| |
|accept-language|"ko-kr,ko;q=0.8,en-us;q=0.5,en;q=0.3"|user-agent와 마찬가지로 큰따옴표로 감쌉니다.|
|accept-encoding|gzip, deflate| |
|connection|keep-alive| |
|verbose|n| |
===== 접속 설정 (access) =====
기본적으로 웹에 접속하기 위한 정보를 기록하고 있습니다. 이 또한 토렌트알지의 주소 및 사이트 체계가 변경되지 않는 한 특별히 손볼 필요가 없습니다. 웹브라우저를 통해 토렌트알지의 각 게시판을 직접 접속해 보면 쉽게 이 값들을 이해할 수 있습니다.
^변수^기본값 ^설명^
|board_base_url |http://www.torrentrg.com/bbs/board.php|게시판의 기본 주소입니다. |
|article_base_url |http://www.torrentrg.com/bbs/board.php|각 게시물들의 기본 주소입니다. |
|attach_base_url |http://www.torrentrg.com/bbs/download.php|첨부 파일의 기본 주소입니다. |
|table_var |bo_table|각 게시판을 구분하는 변수의 이름입니다. |
|**table_vals**| |대상 게시판들의 이름입니다. 여러 게시판을 공백으로 구분하여 입력할 수 있습니다.|
|page_var |page|게시판 페이지를 구분하는 변수의 이름입니다. |
|article_id_var |wr_id|게시물을 구분하는 ID를 위한 변수의 이릅입니다. |
|attach_var |no|첨부파일을 구분하기 위한 변수의 이름입니다. |
|attach_val_reg |javascript:file_download\('./download.php\?.+no=([0-9]+)|첨부된 파일 중 토런트 파일을 골라내기 위한 정규 표현식입니다. 캡쳐 안의 값은 토런트 파일을 알아내는 데 필요한 숫자입니다.|
|**wait_sec**|5|하나의 접속을 수행한 후 대기하는 시간입니다. 최소값은 5초입니다.|
===== 로그인 설정 (login) =====
토렌트알지는 로그인이 필요없지만, 때때로 로그인이 필요한 경우가 있습니다. 이 경우 AutoTorrentRG는 웹브라우저와 마찬가지로 로그인을 할 수 있습니다.
^변수^기본값 ^설명^
|do_login|y|로그인 과정을 수행할지를 정합니다. 'y/n/1/0/t/f' 등을 사용할 수 있습니다.|
|id_var|mb_id|아이디를 위한 폼 변수 이름입니다.|
|**id_val**| |아이디를 입력합니다.|
|pw_var|mb_password|비밀번호를 위한 폼 변수 이름입니다.|
|**pw_val**| |비밀번호를 입력합니다. 특별한 암호 처리가 되지 않습니다.|
|url|http://www.torrentrg.com/bbs/login_check.php|로그인을 위한 주소입니다.|
|base_form|url=http%3A%2F%2Fwww.torrentrg.com%252F|로그인을 위해 POST 방식으로 값을 전달합니다. 아이디와 비밀번호 이외의 값은 미리 이곳에 정의합니다.|
|success_token|location.replace('http://www.torrentrg.com/')|로그인이 성공할 경우 서버에서 송신하는 메시지를 정의합니다. 메시지 일부만 적어도 되지만, 반드시 로그인이 성공했을 때만 보이는 메시지를 적어야 합니다.|
===== 크롤러 설정 (crawler) =====
각 게시판에 접근하여 지정한 범위의 게시판의 제목을 수집하는 것을 프로그램은 '크롤링(crawling)'이라고 하며 이것을 수행하는 모듈을 '크롤러'라고 부릅니다.
^변수^기본값 ^설명^
|**min_page**|1|크롤링할 페이지 최소값입니다.|
|**max_page**|9|크롤링할 페이지 최대값입니다.|
|**incremental_fetch**|y|새 게시물만 수집합니다. 갱신된 내역만을 크롤링합니다. 한 번 이상 실행해야 동작합니다.|
|stamp_file|.\Settings\default.stamp|마지막으로 크롤링된 게시물이 무엇인지 기록하는 파일입니다.|
|reg_exp|(.+?)|게시판에서 게시물 제목만을 수집하기 위한 정규식입니다. 첫번째 캡쳐는 게시물의 ID이고, 두번째 캡쳐는 게시물의 제목입니다. 매직 워드인 %table_var%는 검색할 때 table_var의 값으로 치환됩니다.|
|success_token|