국가유산 보고서 파일명 정리

About

국내 인문학·고고학·문화유산 연구 현장에서는 보고서명, 발간기관, 발행연도, 겹낫표(`『 』`)를 조합한 관습적 인용 양식이 널리 쓰입니다.

하지만 국가유산 발굴조사보고서 PDF를 내려받다 보면 파일명이 `download.pdf`처럼 저장되어, 나중에 어느 기관의 어떤 보고서인지 다시 확인해야 하는 일이 자주 생깁니다.

**국가유산 보고서 파일명 정리**는 그런 연구자와 학생을 위한 Chrome 확장 프로그램입니다.

지원 사이트의 보고서 상세 페이지에서 발간기관, 발행연도, 보고서명, 허가번호, 조사 지역 등의 메타데이터를 추출하고, PDF 다운로드 시 다음과 같은 참고문헌식 파일명으로 자동 정리합니다.

`국가유산진흥원, 2024, 경주읍성Ⅲ.pdf`

또한 툴바 팝업에서 현재 보고 있는 보고서의 인용 표기, 예를 들어 `국가유산진흥원, 2024, 『경주읍성Ⅲ』`를 버튼 하나로 복사할 수 있습니다.

---

## 이런 분께 유용합니다

* 발굴조사보고서 PDF를 많이 내려받는 고고학·역사학·문화유산 분야 연구자
* 한국어 논문과 보고서의 참고문헌 목록을 정리해야 하는 대학원생·학부생
* `발간기관, 발행연도, 보고서명` 형식의 파일명을 일일이 고치느라 시간을 쓰고 있던 사용자
* 낫표와 겹낫표를 사용하는 국내 인문학 인용 관습에 맞춰 보고서명을 복사하고 싶은 사용자

---

## 핵심 기능

* **참고문헌식 파일명 자동 정리**  
  PDF 다운로드 시 페이지의 메타데이터를 바탕으로 `발간기관, 발행연도, 보고서명.pdf` 형식의 파일명을 제안합니다.

* **다중 첨부파일 순서번호 자동 부여**  
  같은 보고서에 여러 PDF가 첨부된 경우 `... 1.pdf`, `... 2.pdf`처럼 순서번호를 자동으로 붙입니다.

* **e-minwon 다중 첨부파일 ZIP 우회**  
  국가유산 협업포털(e-minwon.go.kr)에서 여러 첨부파일을 한꺼번에 받을 때 ZIP 파일로 묶이는 흐름을 우회하고, 가능한 경우 PDF를 하나씩 순차 다운로드합니다.

* **보고서 인용 표기 복사**  
  툴바 팝업의 **보고서 인용** 탭에서 `조사기관명, 발행연도, 『보고서명』` 형식을 바로 복사할 수 있습니다.

* **파일명 템플릿 사용자 설정**  
  보고서명, 첨부파일명, 발행연도, 발행기관, 허가번호, 유적명, 제출일, 조사 시도·시군구, 원본 파일명, 순서번호 등을 조합해 원하는 파일명 규칙을 만들 수 있습니다.

* **툴바 팝업 On/Off**  
  확장 프로그램 관리 페이지에 들어가지 않아도 툴바 팝업에서 기능을 즉시 켜고 끌 수 있습니다. 꺼져 있을 때는 아이콘에 `OFF` 배지가 표시됩니다.

---

## 현재 지원 사이트

* 국가유산포털 간행물: `heritage.go.kr`
* 국가유산 지식이음 발간자료: `portal.nrich.go.kr`
* 국가유산청 발굴조사보고서 검색/상세 페이지: `cha.go.kr`, `khs.go.kr`
* 국가유산 협업포털 발굴조사보고서 상세 페이지: `e-minwon.go.kr`

지원 사이트와 추출 규칙은 이후 버전에서 더 확장될 수 있습니다.

---

## 사용 전 안내

* 이 확장 프로그램은 모든 웹페이지에서 작동하는 범용 다운로드 이름 변경기가 아닙니다. 위 지원 사이트의 국가유산 보고서 페이지에 맞춰 제작되었습니다.
* e-minwon에서 첨부파일이 매우 많은 경우, 사용자의 다운로드 설정에 따라 각 PDF마다 저장 위치 확인 창이 뜰 수 있습니다.
* 원본 ZIP 파일이 필요한 경우 툴바 팝업에서 도구를 잠시 끄고 사이트 기본 다운로드를 사용하면 됩니다.
* 페이지 구조가 지원 사이트에서 변경되면 일부 메타데이터 추출이 제한될 수 있습니다.

---

## 개인정보 및 데이터 처리

* 별도의 외부 서버로 데이터를 전송하지 않습니다.
* 파일명 템플릿, 도구 켜짐/꺼짐 상태 등 사용자 설정은 Chrome storage에 저장됩니다.
* 현재 탭의 보고서 메타데이터는 파일명 변경과 인용 표기 생성을 위해 브라우저 내부에서 일시적으로 사용됩니다.
* 다운로드 권한은 PDF 파일명을 제안하고 e-minwon 다중 첨부파일 ZIP 다운로드를 우회하기 위해 사용됩니다.

---

## 권한 사용 사유

* `downloads`: 다운로드되는 PDF의 파일명을 참고문헌식으로 제안하고, e-minwon 다중 첨부파일 ZIP 흐름을 제어하기 위해 필요합니다.
* `storage`: 사용자가 설정한 파일명 템플릿과 도구 On/Off 상태를 저장하기 위해 필요합니다.
* 지원 사이트 host 권한: 보고서 상세 페이지에서 발간기관, 발행연도, 보고서명 등 파일명 생성에 필요한 메타데이터를 읽기 위해 필요합니다.

---

## 라이선스 및 소스 코드

이 확장 프로그램은 GNU General Public License v2.0 only 조건으로 배포됩니다.

소스 코드:
https://github.com/lzpxilfe/archreport