미리보기 사용하기

개요

Reporch IDE에는 실행 중인 웹 서버를 여는 웹 Preview와 Explorer의 파일을 형식에 맞게 표시하는 파일 미리보기가 있습니다.

• 웹 Preview: 개발 서버가 연 포트를 IDE 내부 URL로 표시
• 이미지: 이미지 자체와 크기·형식 확인
• PDF: 문서 페이지 미리보기
• 오디오·비디오: 브라우저 플레이어로 재생
• 폰트: 글꼴 샘플 확인
• 스프레드시트: 지원되는 시트 데이터를 표 형태로 확인

시작하기 전에

• 웹 Preview라면 워크스페이스 터미널과 개발 서버 명령을 준비합니다.
• 파일 미리보기라면 대상 파일이 완전히 저장됐는지 확인합니다.
• 외부 공유 전에 Preview URL과 파일의 접근 범위를 확인합니다.

실행 단계

파일 미리보기 열기

Explorer에서 지원되는 파일을 선택하고 미리보기 동작을 사용합니다. 편집할 수 없는 바이너리 파일은 코드 편집기 대신 전용 미리보기 탭으로 열립니다. 외부에서 열기나 다운로드를 사용할 때는 파일이 공개 가능한 내용인지 확인하세요.

예상 결과

• 웹 서버가 연 포트의 페이지가 IDE Preview 탭에 표시됩니다.
• 저장한 소스 변경이 새로고침 또는 Hot Reload 후 반영됩니다.
• 지원되는 이미지, PDF, 미디어, 폰트와 스프레드시트가 전용 미리보기로 열립니다.

문제 해결

• Preview가 감지되지 않음: 서버 프로세스가 종료되지 않았는지와 실제로 포트를 열었는지 터미널에서 확인하세요.
• 빈 화면이 표시됨: 서버가 localhost에만 제한되지 않았는지, 앱의 기본 경로가 맞는지 확인하세요.
• 지원되지 않는 파일 형식: 원본을 다운로드하거나 텍스트 변환본을 만들어 확인하세요.
• 이미지·PDF 로드 실패: 파일이 완전히 저장됐는지, 크기가 너무 크거나 손상되지 않았는지 확인하세요.
• 변경이 반영되지 않음: 파일 저장 상태와 개발 서버의 Hot Reload 로그를 확인하고 Preview를 새로고침하세요.

관련 문서

• 터미널 사용하기
• 편집기 사용하기
• 배포 시작하기