필요한 것이 화면인지 파일 내용인지 정합니다
코드 검토 화면을 보관하려는 일과 프로그램이 읽을 CSV 파일을 받는 일은 다릅니다. 파일처럼 보이는 페이지에서 브라우저 저장을 했다고 원본 데이터만 저장됐다고 단정하지 마세요.
작업 메모에 필요한 파일의 경로와 용도를 적습니다. 문서에 보여 줄 화면이 필요한지, 다른 도구에 입력할 텍스트가 필요한지 구별하면 저장 결과를 검사할 기준이 생깁니다.
Raw는 파일의 내용만 보는 경로입니다
GitHub 공식 문서는 파일을 연 뒤 오른쪽 위의 Raw를 누르면 별도 스타일 없이 파일 원문을 볼 수 있다고 안내합니다. 파일 원문을 복사하거나 내려받는 기능도 제공됩니다.
저장소 이름과 파일 경로를 먼저 확인하고 Raw로 이동하세요. 보기 편한 웹페이지의 메뉴와 줄 번호가 필요한 작업인지, 데이터 자체만 필요한 작업인지에 따라 목적이 다릅니다.
확장자보다 실제 내용의 첫 줄을 봅니다
내려받은 파일이 기대한 형식인지 텍스트 편집기에서 확인합니다. CSV를 기대했는데 HTML 문서 선언이나 웹페이지 태그가 나온다면 받은 내용부터 다시 대조해야 합니다.
확장자를 .csv로 바꾸는 것만으로 HTML이 CSV로 변환되지는 않습니다. 반대로 텍스트가 보인다고 데이터가 원하는 버전이나 의미까지 맞는 것은 아니므로 경로도 함께 확인합니다.
| 받은 내용 | 확인할 부분 | 다음 판단 |
|---|---|---|
| CSV 텍스트 | 첫 줄·열 구분·경로 | 목적에 맞는 버전인지 대조 |
| HTML 페이지 | 문서 태그·페이지 제목 | 원본 파일을 받은 것인지 재확인 |
| 오류 안내 | 오류 문구 | 자료로 사용하지 않고 상태 기록 |
가상의 notes.csv를 읽기 전용으로 비교합니다
가상의 저장소에 첫 줄이 title,status인 notes.csv가 있다고 합시다. 파일을 받아 편집기로 열었을 때 첫 줄과 열 구분을 확인하고, 웹의 같은 파일 내용과 비교합니다. 실제 외부 데이터셋을 내려받은 결과가 아닌 연습입니다.
브라우저 페이지를 저장해 HTML을 받았다면 그 파일을 실행하거나 확장자만 바꾸지 않습니다. 파일 내용이 필요한 작업이었다는 점을 다시 확인한 뒤 올바른 파일 보기에서 필요한 자료를 받습니다.
나중에 바뀔 수 있는 경로에는 버전 메모를 붙입니다
같은 저장소와 파일 경로도 선택한 브랜치나 커밋에 따라 내용이 다를 수 있습니다. 다시 대조할 필요가 있다면 어느 버전을 보았는지와 확인 날짜를 함께 적습니다.
공유할 때는 받은 파일만 보내기보다 원래 저장소의 파일 링크와 사용한 버전을 남기세요. 이미 정해진 배포 파일이 필요한 상황이라면 릴리스 자산과 저장소 안 파일을 혼동하지 않는지도 확인합니다.
내용 확인과 실행은 다른 단계입니다
파일 내용을 읽는 작업에 설치나 코드 실행이 반드시 필요한 것은 아닙니다. 이 예시는 텍스트를 열어 형식과 출처를 확인하는 데서 끝납니다.
빈 파일, 접근 오류 문서, 기대와 다른 내용이라면 그 관찰을 남기고 작업을 멈춥니다. 파일 이름만 맞췄다는 이유로 후속 도구에 넣으면 원인을 더 늦게 발견할 수 있습니다.
직접 적용해 보기: 웹페이지와 파일 원문
가상의 notes.csv와 저장한 HTML을 첫 줄부터 구별합니다.
- 01
필요한 파일 경로와 용도를 적습니다.
- 02
파일 내용과 받은 텍스트를 대조합니다.
- 03
같은 버전을 다시 찾을 출처를 남깁니다.
남길 결과물
원문 파일인지 확인한 뒤 사용할 수 있는 자료 메모입니다.
여기서 자주 놓치는 점
HTML의 확장자만 바꿔 CSV 입력으로 사용하지 않습니다.
편집팀이 구성한 설명용 예시입니다. 실제 이용 후기나 측정 결과가 아닙니다.
