이 포털을 관리하는 방법

연구진이 직접 고치고 늘려 나가기 위한 안내 · 2026-08-22

먼저 알아두실 구조

이 포털은 국문과 영문 두 개의 사이트입니다.

https://aiforalab.com/p/leeyunho/        한국어
https://aiforalab.com/p/leeyunho/en/     English

두 사이트는 하나의 원본 파일에서 함께 만들어집니다. 한국어와 영어 문장이 같은 자리에 나란히 적혀 있고, 빌드를 한 번 돌리면 양쪽이 동시에 생성됩니다.

그래서 한쪽만 낡는 일이 구조적으로 일어나지 않습니다. 영문만 옛날 내용으로 남아 있는 흔한 사고를 막기 위한 설계입니다.

파일이 하는 일

작업 폴더는 portal/ 입니다.

파일	하는 일	고칠 일이 있나
`content.py`	사이트 문구·연구진·실적·자료실·도구 목록	자주
`topics.py`	연구 주제 6개의 본문	자주
`style.css`	화면 디자인	가끔
`build.py`	위 내용을 읽어 웹페이지를 만듦	거의 없음
`deploy.py`	만든 결과를 서버에 올림	거의 없음
`make_thumbs.py`	주제 썸네일 생성	새 주제 추가 시
`make_portraits.py`	인물 사진을 일러스트로 변환	새 구성원 추가 시
`make_video.py` · `assemble_video.py`	소개 영상 생성·편집	거의 없음

대부분의 수정은 content.py와 topics.py 두 파일 안에서 끝납니다.

기본 작업 순서

① 내용을 고친다        content.py 또는 topics.py
② 만든다              python portal/build.py
③ 확인한다            portal/index.html 을 브라우저로 열어 봄
④ 올린다              python portal/deploy.py

②와 ④는 한 줄로 붙여 쓰셔도 됩니다.

python portal/build.py && python portal/deploy.py

자주 하실 일

연구 실적에 새 논문 추가하기

content.py의 PUBS에서 해당 분야를 찾아 한 줄 넣습니다.

dict(y=2026, new=True, pmid='42518166',
     t='논문 제목을 그대로 적습니다',
     j='저널 이름'),

y 연도 · t 제목 · j 저널
pmid 를 넣으면 제목이 PubMed 링크로 바뀝니다 (doi 를 넣어도 됩니다)
new=True 를 넣으면 NEW 표시가 붙습니다. 지울 때는 그 부분만 빼면 됩니다

논문 제목과 저널명은 영어 그대로 두시면 됩니다. 국문·영문 사이트 모두 같은 표기를 씁니다.

연구진 추가·변경하기

content.py의 TEAM에 한 사람을 넣습니다.

dict(photo='abc.jpg', ini='김', role='Gil Dong Kim',
     email='abc@example.com',
     name={'ko': '김길동', 'en': 'Gil Dong Kim'}),

그다음 사진을 준비합니다.

원본 사진(증명사진이면 충분합니다)을 프로젝트 폴더에 abc.jpg 로 둡니다
make_portraits.py의 PEOPLE 목록에 한 줄 추가합니다
python portal/make_portraits.py 를 실행하면 다른 구성원과 같은 화풍의 일러스트로 바뀌어 portal/team/ 에 저장됩니다

사진이 아직 없으면 이름 첫 글자가 대신 표시됩니다. 나중에 사진을 넣으면 자동으로 바뀌므로, 사람을 먼저 올려두셔도 괜찮습니다.

연구 주제 내용 고치기

topics.py에서 해당 주제를 찾아 고칩니다. 각 주제는 다음으로 이루어져 있습니다.

항목	내용
`title` · `lead`	제목과 한 줄 요약
`question`	핵심 질문 (카드에도 표시됩니다)
`problem`	무엇이 문제인가 — 문단 목록
`approaches`	어떻게 접근하는가 — (제목, 설명) 쌍의 목록
`progress`	지금까지의 진전 — 넣으면 그 항목이 생기고 빼면 사라집니다
`why`	왜 중요한가 — 문단 목록

{'ko': ..., 'en': ...} 형태는 국문과 영문을 나란히 적는 자리입니다. 한쪽만 고치지 마세요.

문장 안에서 <b>강조할 말</b> 을 쓰면 굵게 표시됩니다.

새 연구 주제 추가하기

topics.py에 기존 주제 하나를 통째로 복사해 붙여넣고 내용을 바꿉니다
slug(주소에 쓰이는 영문 이름)와 accent(색상)를 새로 정합니다
make_thumbs.py의 SHOTS에 thumb-<slug> 항목을 추가하고 실행해 썸네일을 만듭니다
빌드하고 올립니다

글이 어색하게 잘릴 때

한국어는 줄바꿈이 잘못되면 끝에 두세 글자만 남아 보기 나빠집니다. 이 포털은 그런 일이 잘 생기지 않도록 만들어져 있지만, 그래도 어색한 자리가 보이면 문장을 한두 글자 늘리거나 줄이는 것이 가장 확실한 해결책입니다.

문서 추가하기

자료실 문서는 마크다운(.md) 파일입니다.

프로젝트 폴더에 .md 파일을 만듭니다 (국문·영문 각각)
python scripts/md2pdf.py 파일이름.md 로 PDF를 만듭니다
content.py의 DOCS에 한 줄 추가합니다
빌드하면 웹페이지와 PDF 내려받기 버튼이 함께 생깁니다

⚠️ 비밀번호나 API 키가 든 문서는 절대 DOCS에 넣지 마세요. 자료실은 누구나 볼 수 있습니다.

조심하실 것

하지 마실 것	이유
`portal/` 안의 `index.html`을 직접 고치기	다음 빌드에서 덮어써집니다. 반드시 `content.py`·`topics.py`를 고치세요
국문만 고치고 영문 그대로 두기	두 사이트가 어긋납니다. `{'ko':..., 'en':...}`는 항상 함께
비밀번호·API 키를 문서나 페이지에 쓰기	웹에 그대로 노출됩니다
서버에서 직접 파일 수정하기	다음 배포에서 사라집니다. PC에서 고치고 올리는 것이 원칙입니다

도움이 필요하면

화면이 안 바뀌면 → 브라우저에서 Ctrl + F5
빌드가 실패하면 → 대개 따옴표나 쉼표가 빠진 것입니다. 오류 메시지의 줄 번호를 보세요
그래도 막히면 → 연구실로 연락 주세요

한눈에

# 내용 수정 후
python portal/build.py && python portal/deploy.py

# 인물 사진 새로 만들기
python portal/make_portraits.py

# 주제 썸네일 새로 만들기
python portal/make_thumbs.py