자료실

이 포털을 관리하는 방법

내용을 고치고 연구를 더해 나가는 방법. 어느 파일을 고치면 어디가 바뀌는지 정리했습니다.

이 포털을 관리하는 방법

김우진 · Regaining Trust in AI 연구 포털 · 2026-08-29 개정

2026-08-29 개정 안내 — 작업 방식이 바뀌었습니다.

이 포털은 원래 PC의 생성기(만들기.py + 내용.py)로 만들어 올리는 방식이었습니다. 이제는 서버에 있는 파일이 원본입니다. 내려받아 고치고 다시 올리면 그대로 반영됩니다. 연구실의 다른 포털들과 같은 방식입니다.

바뀐 이유는 생성기 키트가 본인 PC에만 있기 때문입니다. 서버를 전부 뒤졌지만 사본이 없습니다. 그래서 ① 연구실에서 도와드릴 수가 없고, ② PC를 잃으면 포털을 복구할 수 없습니다.

⚠️ 예전 키트의 만들기.py 는 이제 돌리지 마세요. 돌려서 올리면 서버의 최신 내용을 덮어씁니다. 키트는 지우지 마시고 참고용으로 보관만 해 두세요.

같은 폴더의 PDF 는 개정 전 판입니다. 내용이 다르니 이 웹 문서를 기준으로 하세요.


먼저 알아두실 것 — 주소가 둘, 폴더는 하나

https://aiforalab.com/p/kimwj2990/    ← 내 연구 공간 주소
https://aiforalab.com/trust-recovery/ ← 기존 주소 (그대로 살아 있음)
     │
    └── 둘 다 같은 곳을 가리킵니다
        /var/www/portals/kimwj2990/site/

한 번만 고치면 두 주소가 함께 바뀝니다. 논문이나 메일에 적어 둔 옛 주소도 그대로 삽니다. (/trust-recovery 는 서버에서 같은 폴더를 가리키도록 연결해 둔 것입니다.)

이제 이렇게 작업하십니다

서버의 site/  ──내려받기──▶  PC에서 수정  ──올리기──▶  두 주소 즉시 반영
     │
    └── 원본은 여기에 있습니다

딱 하나만 지키시면 됩니다 — 고치기 전에 반드시 서버에서 먼저 내려받으세요. PC에 오래된 사본을 두고 그걸 올리면 그동안의 수정이 사라집니다.


지금 들어 있는 것

주소파일내용
/p/kimwj2990/site/index.html홈 — 연구 카드 세 장 · 자료실 · 연구 도구
/p/kimwj2990/design/site/design/index.html연구 소개 — 연구 질문 · 선행연구 · 가설 · 방법
/p/kimwj2990/results/site/results/index.html결과와 해석 — 결과 · 디스커션
/p/kimwj2990/review/site/review/index.html논문 대응 — 보고 오류 세 건 · 심사의견과 대응 · 남은 결정
/p/kimwj2990/full/site/full/index.html나누기 전 원본 한 쪽 (그대로 보존)
/p/kimwj2990/figures/site/figures/그림 — 웹용 · 논문용 · 벡터 원본
—site/style.css모든 페이지가 함께 쓰는 디자인

논문: Regaining Trust in AI · 김효영 · 박대근 · 김우진 · 2×2 피험자 간 · N=120
현재 Journal of Behavioral Decision Making 심사 중 (Revise & Resubmit)

모든 페이지 본문 위아래에 ← 이전 · 홈 두 단추가 붙습니다.


기본 작업 순서

  1. WinSCP 로 접속해 고칠 파일을 내려받습니다.
  2. PC에서 고칩니다. (Claude Code 로 작업하신다면 내려받은 폴더를 작업 폴더로 열면 됩니다)
  3. 바뀐 파일만 덮어씌워 올립니다.
  4. 브라우저에서 Ctrl + F5 로 새로고침해 확인합니다.
프로토콜SFTP
호스트aiforalab.com
포트10022
아이디kimwj2990

두 주소 모두 자동으로 함께 바뀝니다.

PC에 항상 사본을 두세요. 서버에서 지운 파일은 복구되지 않습니다.


무엇을 어디서 고치나

고칠 것파일고칠 일
심사 대응review/index.html가장 자주
결과·디스커션results/index.html자주
연구 질문·가설·방법design/index.html가끔
홈 카드 · 표지 문구 · 소개index.html가끔
이름 · 이메일 · 사진index.html 아래쪽 「연구자」 절거의 없음
색·글꼴 등 겉모습style.css거의 없음

본문은 평범한 HTML 입니다. 고칠 부분을 브라우저 화면의 문구로 찾아 파일에서 같은 문구를 검색하면 바로 그 자리가 나옵니다.

예전에는 본문이 kimwj2990-sections.json 에 절 단위로 담겨 있었지만, 이제는 각 쪽의 HTML 안에 그대로 들어 있습니다. 절을 다른 쪽으로 옮기려면 그 절의 HTML 덩어리를 잘라 다른 파일에 붙여 넣으시면 됩니다.

심사 대응 갱신 — 가장 자주 하실 일

review/index.html 의 「심사의견과 대응」 과 「남은 결정」 이 심사 진행에 따라 계속 바뀝니다.

결정이 바뀌면 바꾼 날짜와 이유를 함께 남겨 두세요. 재제출 때 대응표를 쓸 재료가 됩니다.

새 페이지 만들기

site/ 안에 폴더를 만들면 그 순간 두 주소 모두에 생깁니다.

site/study2/index.html   →   https://aiforalab.com/p/kimwj2990/study2/
                             https://aiforalab.com/trust-recovery/study2/

폴더 이름은 영문 소문자·숫자·하이픈을 권합니다 (study2, pilot-2, logs).

가장 쉬운 방법은 기존 페이지를 복사해 쓰는 것입니다. results/index.html 을 내려받아 내용만 바꾸면 디자인이 그대로 따라옵니다. 새 페이지에서 스타일시트를 부르는 줄만 폴더 깊이에 맞춰 주세요.

site/study2/index.html       →  <link rel="stylesheet" href="../style.css">
site/docs/새폴더/index.html   →  <link rel="stylesheet" href="../../style.css">

홈에 카드 추가하기

새 페이지를 만들었으면 홈에서 연결해 주어야 보입니다. index.html 에서 <div class="grid"> 를 찾아, 그 안에 카드 한 장을 더 넣습니다.

<a class="card on" href="study2/">
  <span class="ci">🧪</span>
  <b>두 번째 연구</b>
  <span class="cl">한 줄 소개</span>
  <span class="cq">핵심 질문</span>
  <span class="cm">자세히 →</span>
</a>

바깥 사이트로 나가는 링크라면 「관련 자료」 절의 tile 모양을 쓰면 됩니다.

<a class="tile" href="https://…" target="_blank" rel="noopener">
  <span class="ti">📄</span><b>제목</b><small>한 줄 설명</small>
</a>

연구를 새 묶음으로 나누고 싶으면 <h3 class="gt">두 번째 연구</h3> 를 넣고 그 아래에 새 <div class="grid"> 를 두면 됩니다.


그림 다시 만들기

이 부분은 예전과 똑같습니다. 그림은 원래부터 직접 올리는 방식이었습니다.

  1. RStudio (https://middleton.o-r.kr/rstudio/) 에 kimwj2990 으로 접속
  2. trust_recovery_figures.R 을 올려 실행
  3. 나온 그림을 site/figures/ 에 같은 파일명으로 덮어쓰기

파일명을 그대로 쓰면 본문을 고치지 않아도 그림만 바뀝니다.

웹용(_web.png)과 논문용(_paper.png)을 함께 갱신하세요. 한쪽만 바꾸면 포털과 원고가 어긋납니다.


겉모습 바꾸기

style.css 한 파일이 모든 페이지의 겉모습을 정합니다. 색은 파일 위쪽의 변수 몇 줄만 바꾸면 전체가 따라 바뀝니다.

예전 문서의 THEME = 'latex' (water · cream 으로 바꾸는 것)은 생성기 기능이라 이제 쓰지 않습니다. 다른 인상으로 바꾸고 싶으시면 연구실에 말씀해 주세요.

프로필 사진 바꾸기

site/team/kimwj2990.jpg 를 새 사진으로 덮어씌워 올리면 됩니다. 정사각형 400×400px 이상을 권합니다.


조심하실 것

하지 마실 것이유
예전 키트의 만들기.py 돌려서 올리기서버의 최신 내용을 통째로 덮어씁니다
내려받지 않고 오래된 PC 사본을 올리기그 사이의 수정이 사라집니다
site/ 폴더 자체를 지우거나 이름 바꾸기두 주소가 함께 죽습니다
비밀번호·API 키를 site/ 에 두기웹에 그대로 노출됩니다. private/ 에 두세요
데이터 원본(개인정보 포함)을 site/ 에 올리기공개 영역입니다. 분석 결과만 올리세요

특히 — 실험 데이터. N=120 응답 원자료에 개인 식별 정보가 있다면 site/ 에 두지 마세요. private/ 에 두거나 연구 서버의 개인 폴더(RStudio·Jupyter 홈)에 두면 웹에 노출되지 않습니다.

참고로 지금 site/ 에 table1_final.R 과 trust_recovery_figures.R 두 분석 스크립트가 올라가 있어 누구나 내려받을 수 있는 상태입니다. 자격증명이나 데이터는 들어 있지 않지만, 공개를 원치 않으시면 연구실에 말씀해 주세요.


문제가 생기면

증상원인조치
화면이 안 바뀜브라우저 캐시Ctrl + F5
고쳤는데 되돌아감오래된 사본을 올렸거나 만들기.py 를 돌렸음서버에서 다시 내려받아 시작하세요
새 페이지 모양이 깨짐style.css 경로가 폴더 깊이와 안 맞음../ 개수를 확인하세요
새 페이지가 홈에 안 보임카드를 안 넣었음「홈에 카드 추가하기」 참고
한쪽 주소만 안 바뀜캐시 (구조상 불가능)두 주소 각각 Ctrl + F5
두 주소 모두 404연결이 끊어졌을 가능성연구실에 즉시 연락
403 오류새로 만든 폴더 권한연구실에 알려 주세요

한눈에

서버에서 내려받기 → PC에서 고치기 → 덮어씌워 올리기 → Ctrl+F5

원본이 있는 곳서버의 site/
가장 자주 고칠 곳review/index.html (심사 대응)
홈 · 카드index.html
겉모습style.css
그림RStudio 에서 만들어 figures/ 에 덮어쓰기
돌리지 말 것예전 키트의 만들기.py
반영즉시 · 두 주소 동시
R 작업https://middleton.o-r.kr/rstudio/
막히면연구실로 연락