이 블로그의 글은 대개 오류 하나를 붙잡고 원인과 해결을 따라갑니다. 그 오류를 재현 환경에서 직접 일으켜 보고, 해결한 뒤의 출력까지 같은 환경에서 받아 본 다음에 글을 씁니다. 이 페이지에는 그 과정을 실제 순서대로 적었습니다.
재현 환경
명령은 Debian 13 리눅스 서버에서 실행합니다. CPU 8코어, 메모리 15GB에 GPU가 없는 환경입니다. 그래서 GPU가 있어야만 하는 작업이나 Windows에서만 생기는 문제, 유료 API 키나 로그인 없이는 끝까지 갈 수 없는 주제는 고르지 않습니다. 끝까지 실행해서 해결된 출력을 보여 줄 수 있어야 글이 되기 때문입니다.
글마다 작업 폴더를 새로 만들고, 필요한 파이썬 패키지는 그 폴더 안의 가상 환경(venv)에만 설치합니다. 관리자 권한(sudo)은 cron 동작처럼 계정 설정을 건드려야 재현되는 경우에만 쓰고, 그때는 실습용 계정을 따로 만들어 그 계정 안에서 확인합니다. 본문의 실행 환경 표에는 OS 이름, 도구와 라이브러리 버전, 실행한 날짜를 실행 출력에 나온 값 그대로 적습니다.
오류를 먼저 일으키고, 해결은 출력으로 확인합니다
실행은 세 단계로 나눕니다. 먼저 문제를 재현해 실제 오류 메시지를 화면에 띄우고, 다음에 해결 방법을 적용해 성공한 출력을 받습니다. 마지막 단계에서는 다른 해결 방법이나 옵션을 돌려 보고 차이를 비교합니다. 해결 단계에서 성공 출력이 나오지 않은 주제는 글로 쓰지 않고 보류합니다.
각 단계는 실제 터미널 창에서 실행하며, 그동안 터미널에 찍힌 내용을 기록으로 남깁니다. 본문의 출력 블록은 이 기록에서 옮기고, 실행이 끝난 그 터미널 창을 캡처해 출력 블록 곁에 붙입니다. 출력과 캡처가 같은 실행에서 나온 셈이고, 캡처 설명에는 찍은 날짜와 시각, 실행 환경을 적습니다. 캡처 파일은 블로그 미디어 라이브러리에 올린 원본을 그대로 씁니다.
버전, 사용 한도, 요금처럼 시간이 지나면 바뀌는 정보는 공식 문서와 공식 저장소, 릴리스 노트에서 찾아 링크를 답니다.
공개 전 검사와 공개 뒤의 수정
원고를 쓰고 나면 본문을 실행 기록과 맞춰 봅니다. 터미널 기록에 찍힌 출력 줄이 본문 코드 블록에 글자 그대로 들어 있는지는 스크립트로 대조하고, 돌려 보지 않은 명령을 돌린 것처럼 쓴 문장이나 근거를 대지 못하는 수치와 주장은 본문에서 덜어냅니다.
공개를 예약한 원고는 공개되기 전에 자동 검사를 한 번 더 받습니다. 실행 환경 표와 실제 오류 메시지가 담긴 코드 블록이 있어야 하고, 캡처는 3장 이상이어야 하며, 그 파일이 블로그 미디어 라이브러리에 실제로 있는지까지 대조합니다. 외부 출처 링크가 3개보다 적어도 막힙니다. 해결 출력 없이 안 됐다는 보고로 끝나는 원고 역시 이 단계를 넘지 못합니다.
문체도 같은 단계에서 검사합니다. 합니다체가 아닌 문장이 많으면 막히고, 관용적인 맺음말과 연결어가 일정 빈도를 넘거나 목록·굵은 글씨·소제목이 문단에 비해 많아지면 경고가 붙습니다. 블록 구성이 이미 공개한 글과 지나치게 닮아도 표시됩니다. 작업용 폴더 경로나 스크립트 파일 이름 같은 내부 기록이 본문에 남은 원고는 공개 단계로 넘어가지 않습니다. 이미 공개한 글도 같은 검사기로 다시 돌려, 경고가 붙은 곳은 해당 문장을 고쳐 씁니다.
막힌 원고에는 걸린 이유가 남고, 고친 뒤 처음부터 다시 검사를 받습니다. 공개 시각이 하루 안으로 다가왔는데 검사를 넘지 못하면 공개를 하루 미룹니다. 이미 공개한 글의 문장을 고칠 때는 명령, 출력, 수치, 링크가 원래 글과 같은지 대조하고, 제목과 구성, 오류 출력 블록, 문체를 보는 형식 검사를 통과한 본문만 반영합니다.
공개한 글을 고치기 전에는 그때의 본문을 먼저 보관하고, 무엇을 왜 바꿨는지 변경 기록에 남깁니다. 본문이 바뀌면 글의 수정 시각도 함께 갱신됩니다. 글 위의 수정일은 처음 공개하고 하루가 지난 뒤에 고친 글에만 표시됩니다.
명령이 적힌 대로 동작하지 않거나 설명이 틀린 곳을 보시면 연락처로 알려 주세요. 확인한 뒤 본문에 반영하겠습니다.
광고와 제휴
이 블로그에는 광고와 제휴 링크가 있을 수 있습니다. 제휴 링크가 들어간 글은 글 첫머리에 제휴 링크라는 점과 그 링크로 구매하면 수수료를 받는다는 점을 먼저 밝히며, 이 표시가 빠진 원고는 자동 검사에서 막힙니다. 광고나 제휴 여부가 글의 평가를 바꾸지 않도록 하며, 자세한 내용은 저작권 및 면책과 개인정보처리방침에 적어 두었습니다.