지난번엔 Canada·Kazakhstan·Laticifer 탭 3개에 논문 29편을 채운 “첫 조각”이었다. 오늘은 검색창을 마저 달고, 대시보드를 국가별·주제별 탭 8개, 논문 97편으로 크게 늘렸다.
누구에게 도움이 될까: 처음엔 카테고리 몇 개로 시작했지만 자료가 계속 늘어나면서 “이 카테고리를 어떻게 쪼갤까”를 고민하는 사람, 그리고 논문 파일을 검색해서 채울 때 저자 국적·중복·오래된 문헌 같은 애매한 경우를 어떻게 판단할지 궁금한 사람에게.
Before — 탭 3개, 검색 기능 없음
지난 조각에서 카테고리 탭(Canada·Kazakhstan·Laticifer)과 카드 목록은 만들었지만, 검색창은 없었고 논문도 29편뿐이었다. “TKS Genes & Genome” 폴더처럼 국가가 섞인 채로 쌓여있는 자료도 아직 정리 전이었다.
어떻게 — 검색 붙이고, 카테고리를 쪼개며 채우기
1) 검색창 먼저 — 새 라이브러리 없이 검색을 어떻게 만들지 먼저 오픈소스를 찾아보고 비교했다. Pagefind(사이트 전체 검색)와 Fuse.js(오타 허용 검색) 둘 다 이 규모(논문 수백 편, 한 페이지 안 필터링)엔 과했다. 이미 탭 필터가 순수 자바스크립트로 되어 있어서, 검색창도 라이브러리 설치 없이 같은 방식으로 붙였다.
2) 웹 검색으로 논문 찾아 채우기 — Laticifer 6편 추가 PDF가 없는 상태에서 “식물의 Laticifer만 검색해줘”라는 요청을 받고, 학술 데이터베이스를 검색해 논문 6편을 새로 찾았다. 페이월에 걸려 자동으로는 못 받은 논문 4편은 오로라님이 직접 다운로드해주셨고, PDF를 열어 제목·저자가 실제로 맞는지 다시 확인했다.
3) 새 카테고리 만들기 — TTS, China, Germany, USA, Cultivation “TTS라는 새로운 대시보드를 만들어요” 같은 요청이 이어지면서, 폴더 하나 = 탭 하나 = 카테고리 하나 구조를 반복해서 늘렸다. 매번 같은 순서를 따랐다.
“TTS 논문을 어떤 형태로 보여줄까요?” → 기존 대시보드에 탭 추가 (기존 화면 안에 탭만 늘리는 쪽으로 방향부터 확인)
- 스키마(
config.ts)의 카테고리 목록에 이름 추가 papers.astro의 탭 배열에 같은 이름 추가- 폴더 속 PDF를 하나씩 열어 제목·저자·연도·저널 확인, 파일 하나 = 논문 파일 하나로 생성
- 로컬 화면에서 탭을 눌러 개수가 맞는지 실제로 확인
- 커밋 → 배포
이 순서로 TTS(14편), China(20편), Germany(처음 4편 → 이후 세 번에 걸쳐 12편까지), USA(11편), Cultivation(8편)을 채웠다.
4) 국가는 어떻게 판별했나 — 이름이 아니라 소속으로 “독일 그룹 논문을 찾아서 옮겨주세요” 요청을 받았을 때, 성이 독일어처럼 들려도(Panara, Lopez, Fantini 등) 실제 소속이 이탈리아·미국이면 제외했다. 반대로 저자 소속 주소에 “Germany”, “Julius Kühn-Institute”, “University of Münster” 같은 표기가 실제로 있는지 PDF 첫 페이지를 열어 하나하나 확인한 뒤에만 옮겼다.
막힘 → 해결
작업 중 폴더가 갑자기 반토막 났을 때
“TKS Genes & Genome” 폴더에서 독일 논문을 찾던 중, 다음 명령을 실행하니 폴더 파일 수가 31개에서 11개로 줄어 있었다. 알고 보니 오로라님이 같은 시간에 파일탐색기로 “TKS Genes & Genome_China” 폴더를 따로 만들어 중국 저자 논문을 옮기고 계셨던 것 — 삭제가 아니라 동시 작업이었다. find로 옮겨진 파일들을 다시 찾아 상황을 확인하고, 겹치지 않게 작업을 이어갔다.
파일명에 특수문자가 있으면 PDF를 못 여는 문제
“rubber‐related”처럼 일반 하이픈이 아닌 특수 하이픈이 파일명에 섞인 PDF 몇 개는 텍스트 추출 도구가 계속 빈 결과를 냈다. 파일을 임시로 영문 이름(tmp_fan.pdf)으로 복사한 뒤에는 정상적으로 열렸다 — 인코딩 문제였다.
같은 논문이 폴더 두 곳에 있을 때
“TTS 논문 중 빠진 것 있으면 올려주세요” 요청에 새 파일을 열어보니, 파일명만 다르고(Uteulin 2023 gene review.pdf vs Kuluev 2023 Molecular Genetic Research.pdf) 내용은 완전히 같은 파일이었다. md5sum으로 두 파일을 비교해 완전히 같은 해시임을 확인하고, 중복 등록을 막았다. Boguspaev NMR 논문, Puskas 논문, Kaiser 2026 논문에서도 같은 방식으로 중복을 걸렀다.
저자 목록이 PDF 추출 중 깨졌을 때 Mutalkhanov 2021 논문의 저자 줄에서 1저자(M. Mutalkhanov)가 통째로 빠진 채 대시보드에 올라간 적이 있었다. 오로라님이 “첫번째 줄에 있는 저자들을 추가해달라”고 짚어주셔서, PDF 첫 페이지를 이미지로 직접 렌더링해 저자 순서를 눈으로 다시 확인하고 바로잡았다.
하나의 논문, 두 개의 카테고리 딜레마 Cultivation 탭을 만들 때, Eggert 2018·Kreuzberger 2016·King-Smith 2025(재배 밀도) 세 논문은 이미 각각 Germany·USA 탭에 올라가 있었다. 지금 구조는 논문 한 편에 카테고리 하나만 붙을 수 있어서, 그대로 둘지 옮길지 오로라님께 먼저 확인부터 하고 진행했다.
DOI 없는 옛날 논문
1941년에 나온 Bondarenko & Tarakanov 논문은 온라인에서 정확한 링크를 못 찾아 추측으로 채우지 않고 일단 빼뒀다. 오로라님이 직접 찾은 링크(heritage.jscc.ru)를 알려주신 뒤에야 등록했다.
After — 결과
대시보드가 탭 3개·29편에서 탭 8개(Canada·China·Germany·Kazakhstan·USA·Cultivation·Laticifer·TTS)·논문 97편으로 늘었다. 국가 탭은 알파벳순으로, 그 뒤에 주제 탭(Cultivation·Laticifer·TTS)이 오도록 순서도 정리했다. 검색창에 저자 이름을 치면 카테고리 필터와 같이 작동하는 것도 확인했다.
배운 것 / 재사용 자산
카테고리를 새로 늘릴 때 이 다섯 단계를 그대로 반복하면 된다.
- 스키마와 탭 배열, 두 곳에 카테고리 이름을 추가한다.
- 폴더 속 파일을 열어 정보를 확인하되, 저자 국적처럼 판단이 필요한 항목은 파일명이 아니라 실제 소속 주소를 본다.
- 새로 채우기 전에
md5sum으로 기존 파일과 겹치는지 먼저 확인한다. - 링크(DOI)가 안 보이면 추측하지 않고, 못 찾으면 사용자에게 솔직히 알리고 기다린다.
- 로컬 화면에서 탭을 눌러 개수가 맞는지 실제로 검증한 다음에만 커밋·배포한다.
느낀 점
하루 만에 대시보드가 세 배 넘게 커졌다. 카테고리가 늘어날수록 “이게 정말 같은 논문인가”, “이 저자가 정말 이 나라 소속인가” 같은 판단이 계속 필요했는데, 매번 직접 열어서 확인하는 습관이 결국 제일 빠른 길이었다.