부록 B. 자주 묻는 질문과 문제 해결¶
그림·설정¶
설정을 고쳤는데 그림이 그대로예요.
- 설정 파일을 저장했는지 확인합니다.
- 맞는 프로젝트를 다시 빌드했는지 확인합니다(설정 파일 이름의 config_ 뒤가 프로젝트 이름).
- 결과 폴더의 PNG를 다시 열어 봅니다. 그림 보기 창이 옛 그림을 붙잡고 있을 수 있습니다.
설정을 고쳤더니 빌드가 실패해요.
오류 메시지에 설정 파일의 줄 번호가 나옵니다. 대개 들여쓰기가 틀렸거나, : 뒤에 띄어쓰기가 없거나, 글자에 :·#가 있는데 따옴표를 빠뜨린 경우입니다(6장 "고칠 때 주의할 것"). 오류 메시지를 AI에게 보여 주며 고쳐 달라고 해도 됩니다.
두 패널의 글자 크기가 달라요.
그림 종류마다 기본값이 달라서 생기는 차이입니다. 패널 블록마다 같은 이름의 값(title_size 등)을 같은 숫자로 맞춥니다(6장 예).
저널이 다른 폭(예: 85 mm 한 단)을 요구해요. 그림은 지면 설정(스타일)의 폭에 맞춰 그려지므로, 그 저널의 폭·최소 글자 크기를 담은 지면 설정을 만들어 바꿔 끼우면 됩니다. Nature와 Science용 설정은 들어 있습니다(저널 규격으로 바꾸기). 다른 저널이면 그 규정으로 만들고, 규정의 출처와 확인 날짜를 함께 적습니다(설계 결정 0001). 그 뒤 인쇄 전 검사가 새 기준으로 다시 확인합니다.
인쇄 전 검사 경고를 꼭 고쳐야 하나요? 아니요. 오류는 반드시 고치고, 경고는 읽고 판단합니다. 의도한 디자인이면 그대로 둡니다(8장).
데이터¶
원본 데이터를 실수로 고쳤어요.
원본(raw_data/)은 저장소(GitHub)에 올라가지 않으므로 되돌리기 기능으로 복구되지 않습니다. 데이터를 보낸 분석 파이프라인이나 공동연구자에게 원본을 다시 받으세요. 다시 받은 파일이 원래 것과 같으면 지문이 같아서 그림이 "최신"으로 나옵니다. 다르면 "낡음"으로 나와 바로 알 수 있습니다(10장).
번들 검사에서 오류가 나요.
그림에 필요한 열이 표에 없다는 뜻입니다. 메시지에 어떤 열인지 나옵니다. 표(data.csv)는 고치지 말고, 메모가 표의 열 이름을 맞게 가리키는지 보거나 데이터를 다시 내보내 달라고 요청합니다(3장).
데이터가 바뀌었는데 어떤 그림을 다시 그려야 할지 모르겠어요. 💬 "낡은 그림이 있는지 확인해 줘." 낡은 그림과 그 이유가 나옵니다(10장).
빌드·환경¶
(VS Code를 쓸 때) Ctrl+Shift+B 목록에 새 프로젝트가 없어요.
프로젝트를 명령이나 AI로 만들었다면 목록에 자동으로 들어갑니다. 그래도 안 보이면 VS Code 창을 다시 불러옵니다(Ctrl+Shift+P → "Reload Window"). VS Code를 쓰지 않는다면 이 목록은 필요 없습니다.
Windows에서 빌드가 아무 메시지 없이 멈추거나 꺼져요.
그림을 그리는 프로그램이 필요한 파일(conda 환경의 Library/bin 안)을 찾지 못한 경우입니다. AI와 fa 명령(그리고 VS Code 빌드 버튼)은 이것을 자동으로 처리합니다. 분석 파일을 직접 실행할 때만 생기며, 직접 실행해야 한다면 먼저 conda activate fig-atlas로 환경을 켭니다.
빌드가 실패했는데 무슨 뜻인지 모르겠어요. 빌드 출력의 마지막 부분(어느 단계에서 멈췄는지)을 AI에게 보여 주며 "왜 실패했는지 설명하고 고쳐 줘"라고 합니다. 설정 문제면 설정을, 데이터 문제면 무엇이 필요한지 알려 줍니다.
AI¶
AI가 fig-atlas 도구를 모른다고 해요.
AI 도우미에 fig-atlas를 연결해야 합니다(한 번만). AI 에이전트 연결을 보세요. 연결하지 않은 AI도 규칙 파일(AGENTS.md)을 읽고 명령을 실행할 수는 있지만, 연결하면 미리보기와 그림 보기가 더 안전하고 편합니다.
AI가 미리보기 없이 바로 바꿨어요. 파일을 바꾸는 도구는 미리보기 단계가 기본입니다. 그래도 이런 일이 있으면 요청에 "바꾸기 전에 무엇이 바뀌는지 보여 줘"를 붙입니다. 이미 바뀐 것은 설정 파일의 변경으로 남아 있으니 되돌릴 수 있습니다(💬 "방금 바꾼 것을 되돌려 줘").
이전: 부록 A. 용어집 · 다음: 부록 C. 명령 한 장 요약