- 크롬확장프로그램이므로 크롬웹브라우저에서 사용됩니다.

- 번역은 Google AI Studio ( https://aistudio.google.com/prompts/new_chat ) 의 AI Model들을 사용합니다.

  이 Google AI Mdel들을 사용하기 위해서는 Google API Key들이 있어야합니다. 

  Google API Key들을 얻는 방법은 하단의 "(참고) 다중 구글 API Key 얻기"를 참조하십시요.

- 원본 웹페이지 화면에서 한글로 번역하고 대체하여 표시합니다.  (화면번역)

- 현재 화면의 웹페이지로부터 지정된 다음 페이지까지 페이지별 번역파일을 출력합니다. (Caching출력)

  또는 소설의 목록페이지가 존재하면 목록페이지가 표시된 상태로 화면 변경없이 출력합니다.

다운로드:

https://github.com/HawoonLee/SWTrans/releases 에서 가장 위에 있는 Latest 버젼 박스의

SWTrans.zip 클릭하여 다운로드.

다운로드 폴더에서 적당한 폴더로 SWTrans.zip 파일을 이동시킴. (예: D:\MyProg)

D:\MyProg에서 압축파일을 풀면 D:\MyProg\SWTrans 폴더가 생깁니다.

설치:

- 크롬웹브라우저 우상단 "확장 프로그램" 아이콘 클릭하고 팝업화면 하단의 "확장 프로그램 관리"

  클릭하면 확장프로그램 페이지가 표시됩니다.

  다른 방법으로는 크롬웹브라우저에서 chrome://extensions 주소로 웹페이지를 열면

  확장프로그램 페이지가 표시됩니다.

- 확장프로그램 페이지에서 우상단 "개발자 모드" 옆의 버튼을 On으로 클릭.

- 확장프로그램 페이지에서 좌상단 "압축해제된 확장 프로그램 로드" 를 클릭.

- D:\MyProg\SWTrans 폴더를 지정하고 하단의 "폴더 선택" 클릭.

- 확장프로그램 페이지의 전체확장프로그램에서 첫번째로 "소운번역기" 박스가 생긴 것을 확인.

- 확장프로그램 페이지를 닫고 크롬웹브라우저 우상단 "확장 프로그램" 아이콘 클릭.

- 팝업에서 소운번역기 라인 우측 핀을 클릭하면 파란색 핀으로 바뀌고 

  크롬웹브라우저 우상단에 "소" 자가 표시된 아이콘이 생깁니다.

업데이트:

  기존 사용자를 위한 최신버젼 업데이트 방법은 후미에 서술되어있습니다.

  현재 모델 상황은 최신 업데이트 게시물을 참조하십시요.

== API키 설정:

  확보한 API키들을 소운번역기에 입력, 저장해야 번역요청을 할 수 있습니다.

  소운번역기 팝업화면에서 "API key 설정" 줄을 클릭하면 키 입력줄이 12개가 나옵니다.

  빈 입력줄 위에서부터 아래로 입력키들을 복사-붙여넣기합니다.

  키 복사시 더블클릭 선택하지 말고 키줄 전체 끌어서 선택하시는 방식으로. (더블클릭시 중간 특수문자에서 끊김)

  모두 입력했으면 아래쪽 "저장" 버튼을 반드시 클릭.

  이후 "API key 설정" 줄을 클릭하여 입력줄 박스를 닫습니다.

  번역거부시 위에서부터 아래로 API Key를 대체해나가며 재번역 시도합니다.

== AI 설정:

- AI 설정 줄을 클릭하여 입력창을 전개.

- Model에는 사용할 수 있는 AI Model이 drop-down list로 표시됩니다.

  List중의 한 모델을 클릭하면 그 모델이 탑이되어 처음 사용 모델이 됩니다.

  기본 교체모델들 상황을 포함한 최신 모델 상황은 최신 업데이트 참조.

- 그외, Temperature, top-P, top-K는 특별한 사유가 없는한 그대로 두십시요.

- 변경사항이 있으면 저장버튼 클릭.

== 사용자 프롬프트 입력:

- 사용자 프롬프트 바를 클릭하여 사용자가 추가할 수 있는 프롬프트를 입력. (아래 예시와 같은) 

[올바른 번역 예시]

원문: 王林看着手中的飞剑，冷哼一声。

나쁜 번역: 왕린은 손에 있는 비행 검을 보고 차갑게 콧방귀를 뀌었다. (중국식 발음, 직역)

좋은 번역: 왕림은 수중의 비검을 바라보며 차갑게 흥, 하고 코웃음 쳤다. (한국식 독음, 무협 어조)

- 입력편집후 저장버튼 클릭.

== 용어집 입력:

- 용어집 바를 클릭하여 중문단어와 한글단어 쌍을 입력.

  (예: 검도제일선)

苏奕 -> 소혁

文灵雪 -> 문영설

茶锦 -> 다금

宁姒婳 -> 영사화

- 사용자가 보유한 용어집 파일이 있으면 위의 형식으로 바꾼후에 복사/붙여넣기 하십시요.

  입력후 저장버튼 클릭.

== 기능1 - 화면번역:

- 중문 웹소설사이트에서 보시고자하는 중문 웹소설페이지를 엽니다.

  예: 장생종사 https://www.69shuba.com/txt/47135/32459586

- 크롬웹브라우저 우상단에 "소" 자가 표시된 아이콘 클릭하여 팝업화면 표시.

- "번역시작" 버튼을 클릭하면 화면상의 중문(中文) 텍스트를 번역하여 화면상의 중문을 한글로 대체합니다.

- 화면 우하단의 "下一章"을 클릭하거나 우방향키로 다음 페이지를 불러오면 자동으로 번역됩니다.

== 기능2 - 번역페이지 파일출력 (Caching출력):

- 중문 웹소설사이트에서 보시고자하는 중문 웹소설페이지를 엽니다.

- 소운번역기 아이콘을 클릭하여 팝업화면 표시.

- "파일명 Prefix (소설이름)"에 파일명의 선두이름을 입력. (예:"장생종_")

- "파일명 시작Index (Chapter번호)"에 파일명 후미 시작번호를 입력.

  (예: 장생종 제181장이 열려있으면 181 입력)

- "출력 페이지수"에 화면표시된 페이지를 포함하여 번역, 출력할 다음 페이지 갯수 입력. 

- 팝업화면 하단의 "Caching출력" 버튼 클릭.

  페이지당 출력파일은 다운로드 폴더에 생깁니다.

  출력파일명은 "장생종_0181.txt", "장생종_0182.txt"와 같이 생깁니다.

- Caching출력 옵션 "페이지분할" 적용, 분할 크기 지정:

  분할크기를 K단위(글자수) 지정. Default값은 10K.

  적용사례 - "검래(剑来)"  https://www.69shuba.com/book/53884.htm

  한 chapter 크기가 50K가 이상.

  페이지 분할 없이 통짜로 번역시 번역거부가 발생.

  페이지 분할 적용하고 10K 크기로 번역.

  10K에서도 검수에서 "번역누락" 발생하면 분할크기를 줄여가며 재시도.

  보통의 경우에도 번역중단이 조기에 발생하는 경우.

  화면번역을 시도해보고 번역이 된다면 분할크기 2K, 1K로 줄여가며 출력시도해 보십시요.

- Caching출력 옵션 "목록페이지 참조":

  목록페이지를 연 상태에서 "목록페이지 참조" 체크온하고 Caching출력하면

  목록페이지를 참조하여 지정된 시작 장번호에서 지정된 범위의 장들의 번역파일 출력.

  목록페이지의 리스트 항목들에는 link text가 "第20章 来者不善" 와 같이 장번호가 나타나야합니다.

  장번호가 없는 link는 skip합니다.

  단, 검도제일선 1368장 처럼 장제목을 정식으로 달았는데 내용이 스토리가 아닌 작가의 잡담인 경우는

  제외시킬 수가 없습니다. 

  중간에 해당 장(章) 페이지의 link url을 fetch하는 작동이 실패하는 경우는 전체작업을 

  중단(abort)하고 검수파일을 출력합니다.

  69shuba.com 사이트의 소설 목록페이지에서만 출력확인.

- 전체출력 종료후 또는 번역거부시까지의 검수파일이 다운로드 폴더에 생깁니다.

  파일명 형식은 "검수_yyyymmdd_hh_mm.txt" 입니다.

- 검수파일에 표시된 번역문제가 있는 장(章)은 "페이지분할" 적용하고 분할크기를 줄여가며 재번역 시도하십시요.

== 제한:

- 범용(general purpose)번역기가 아닙니다. 중문웹소설을 번역하여 보시는 분들에 특화되어있습니다.

- 특정 중문웹소설사이트의 웹소설페이지에서만 테스트되었습니다.

=== (참고) 다중 구글 API Key 얻기 ===

- 구글AI서버의 번역거부를 회피하기 위한 가장 효과적인 방법은 다수의 구글 API키를 돌려가며 사용하는 것입니다. 번역거부시 다른 API키를 동원하여 계속 번역 요청하는 방식으로 번역을 지속시킵니다.

아래에 기술된 사항은 2025년 11월초 현재시점이며 사용자 실제 상황은 다를 수 있습니다.

1. 복수의 프로젝트 만들기:

(1) 구글 클라우드 콘솔 페이지 https://console.cloud.google.com/ 에 구글계정 gmail로 로그인.

    "Google Cloud" 팝업화면이 나오고 여기서 동의 체크하고 하단의 "동의및 계속하기" 클릭.

(2) "시작하기" 화면에서 "IAM및 관리자" 박스 클릭.

(3) "IAM및 관리자" 화면의 우하단 "리소스 관리" 클릭.

(4) "리소스 관리" 화면에서 상단의 "프로젝트 만들기" 클릭.

(5) "새 프로젝트" 화면에서 "프로젝트 이름"을 입력하고 하단의 "만들기" 클릭.

    (프로젝트 이름은 "proj01", "proj02"등과 같이 입력하는 방식으로) 

(6) (4),(5)단계를 반복하여 복수의 프로젝트 생성 (최대 12개).

2. 복수의 구글 API키 만들기:

- Google AI Studio 페이지 https://aistudio.google.com 접속,

  좌상단 "Chat prompt" 왼쪽 마크 클릭하면 메뉴바가 왼쪽편에 표시.

  메뉴바 하단에 "Get API key" 클릭.

- 우상단의 "API 키 만들기" 클릭.

- "새 키 만들기" 팝업 박스가 표시됨.

  "Import prject" 클릭.

- "프로젝트 가져오기" 팝업 박스가 표시됨.

  "Projects you may want to import" 줄 아래 "Select all" check.

  우변 "가져오기" 클릭.

- "새 키 만들기" 팝업 박스 하단에 프로젝트들이 표시.

  프로젝트 맨 위에거를 클릭.

  우하단 "키 만들기" 클릭.

- 화면 좌상단의 '키" 칸 아래 파란색 API Key 끝자락 네글자 클릭. (예: ...BF_0)

  "API키 세부정보" 팝업 박스가 표시.

  우하단 "키 복사" 클릭.

  클립보드에 복사된 API키를 메모장에 적당히 붙여넣기하고 저장.

(a)우상단 "API 키 만들기" 클릭.

   "새 키 만들기" 팝업 박스가 표시.

   "Select a Cloud Project" 우측 하방표시 클릭.

   표시된 프로젝트중 API키 할당되지 않은 것 클릭.

   우하단 "키 만들기" 클릭.

   "API키" 화면 표시.

   해당 프로젝트의 키를 클릭. (맨위 프로젝트의 좌측 파란색 API Key 끝자락 네글자)

   "API키 세부정보" 팝업 박스가 표시.

   우하단 "키 복사" 클릭.

   클립보드에 복사된 API키를 메모장에 적당히 붙여넣기하고 저장.

- 남은 프로젝트들에 대하여 위의 (a) 과정 반복.

  위에 "다중 API키를 입력하는 방법:"으로 소운번역기에서 사용.

=== 최신버젼 업데이트 방법 ===

- https://github.com/HawoonLee/SWTrans/releases 에서 가장 위에 있는 최신버젼 박스의 

  "SWTrans.zip"을 클릭하여 다운로드.

- 다운로드 폴더에서 설치 폴더로 SWTrans.zip 파일을 이동시킴. (예: D:\MyProg)

  기존파일이 있으면 덮어쓰기.

- D:\MyProg\SWTrans.zip 압축풀어서 D:\MyProg\SWTrans 폴더에 덮어쓰기.

- 크롬웹브라우저 우상단 "확장 프로그램" 아이콘 클릭.

  팝업화면 하단의 "확장프로그램 관리" 클릭하면 확장프로그램관리 페이지 뜸.

- 확장프로그램관리 화면의 소운번역기 박스 우하단 회오리모양 아이콘 (새로고침) 클릭하면 

  웹브라우저 화면 좌하단에 "새로고침완료" 알림이 뜸.

- 웹브라우저 화면 우상단 "소"자 아이콘 클릭하여 소운번역기 팝업화면을 표시.

  버젼 숫자 업그레이드된 것 확인. 

  API키 유지되고 있음을 확인. ("API key 설정" 줄을 클릭)

- 중문웹소설 https://www.69shuba.com/txt/48273/32028706 웹페이지 띄우고 소운번역기 팝업화면을 불러냅니다.

  "번역시작" 버튼을 클릭하여 화면 번역이 되는 것을 확인. (약간의 지연시간이 있음)

업데이트 내역:

  버젼 0.1.8  https://gall.dcinside.com/mgallery/board/view/?id=eastfantasy&no=39983

  버젼 0.1.9  https://gall.dcinside.com/mgallery/board/view/?id=eastfantasy&no=39074

  버젼 0.1.8  https://gall.dcinside.com/mgallery/board/view/?id=eastfantasy&no=37887

  버젼 0.1.7  https://gall.dcinside.com/mgallery/board/view/?id=eastfantasy&no=36881

  버젼 0.1.6  https://gall.dcinside.com/mgallery/board/view/?id=eastfantasy&no=35939

  버젼 0.1.5  https://gall.dcinside.com/mgallery/board/view/?id=eastfantasy&no=34760

  버젼 0.1.4  https://gall.dcinside.com/mgallery/board/view/?id=eastfantasy&no=33076

  버젼 0.1.3  https://gall.dcinside.com/mgallery/board/view/?id=eastfantasy&no=27299

  버젼 0.1.2  https://gall.dcinside.com/mgallery/board/view/?id=eastfantasy&no=24665

  버젼 0.1.1  https://gall.dcinside.com/mgallery/board/view/?id=eastfantasy&no=21829