만들면서 남긴 기록

제작 노트

작은 웹사이트를 만들고 고칠 때 필요한 확인 방법을 모았습니다. 글마다 해결할 질문이 다릅니다. 지금 막힌 부분부터 읽고, 예제와 예상 결과를 자신의 사이트에 대입해 보세요.

처음이라면, 파일 두 개로 시작하세요

정적 사이트 배포 전 검사는 일부러 넣은 오류 네 개를 고쳐 보는 실습입니다. 다운로드한 예제를 자신의 공개 폴더에도 적용할 수 있습니다. 파일을 검사하는 것과 실제 사이트가 정상인지는 왜 다른지도 확인합니다.

지금 하려는 일에 맞춰 읽기

처음부터 전부 읽을 필요는 없습니다. 글마다 입력, 확인할 결과, 다른 선택이 필요한 조건을 적었습니다. 아래 세 경로에서 현재 단계부터 시작하세요.

만든 사이트를 공개할 때

파일 → 실제 응답 → 화면 순서로 확인합니다. 한 단계의 성공이 다음 단계까지 보장하지는 않습니다.

  1. 배포 전 파일 검사 실습

    설명·대표 주소·링크·사이트맵을 읽는 Python 예제와 실패/수정 결과.

  2. 화면에는 있는데 HTML에는 없는 글

    정상 본문·빈 앱 영역·잘못 온 홈의 세 HTML을 비교합니다. 메뉴 글자만 찾는 검사의 오탐도 재현합니다.

  3. Cloudflare Pages의 URL과 404

    확장자 없는 주소, canonical, 리디렉션과 잘못된 홈 폴백을 구별합니다.

  4. 키보드·모바일·다크 모드 점검

    화면 안에 들어오지만 읽기 어려웠던 표를 고친 사례와 키보드 확인 절차입니다.

예상과 다르게 동작할 때

한 번에 모든 설정을 바꾸지 않고, 조건 하나를 바꿨을 때 달라지는 결과를 찾습니다.

  1. 로컬에서는 되는데 CI에서 깨지는 한글

    Java 컴파일 비교에 이어, 잘못 읽은 한글을 저장하면 바이트가 어떻게 달라지는지 실험합니다.

  2. AI로 만든 사이트의 배포 전 보안

    재시도 3회가 9회 호출로 늘어나는 모형과 오류별 중단 기준. 공개 파일·권한 검사도 구분합니다.

  3. AI Pacer: 같은 60%, 다른 네 조건

    작업시간이 달라도 같은 예산이 나오는 이유와 계산 결과의 한계를 확인합니다.

새로 만들거나 옮길 때

서비스를 고르기 전에 실행 방식과 데이터의 소유 위치부터 구분합니다.

  1. 혼자 만드는 프로젝트의 첫 공개 범위

    가상 목록 도구의 대소문자·한글·공백·줄 끝 규칙을 여섯 입력과 실행 코드로 고정합니다.

  2. Cloudflare·Supabase로 이전할 수 있을까?

    정적 파일, 서버, DB·계정·파일을 구분하고 인수인계와 복구 조건을 적습니다.

  3. 서비스 경계를 나눈 이유

    글 수정·게임 추가·가족 초대 변경의 책임표와 목록 동기화의 세 가지 선택을 비교합니다.

프로젝트에서 나온 설계 질문

이 목록에 싣는 글의 기준

저장소의 코드·운영 문서·운영자의 블로그 기록으로 근거를 확인할 수 있고, 다른 글과 구분되는 문제와 결론이 있을 때만 공개합니다. 준비 중인 기능이나 확인하지 못한 운영 정보는 완성된 사실처럼 적지 않습니다.

서비스의 최신 기능과 실행 방법은 각 서비스가 정본으로 관리합니다. 이곳의 제작 노트는 여러 프로젝트에 공통으로 적용한 설계 판단과 루트 허브가 직접 책임지는 내용을 기록합니다.

운영자의 티스토리 블로그에는 개발 오류와 일상의 기록이 있습니다. 이곳에서는 관련 경험을 선택해 새 예제와 점검 절차로 확장하며, 원문을 각 글에서 연결합니다.

프로젝트 목록 보기