외부 리소스

개요

Shiny 인터랙티브 문서에서 참조될 수 있는 외부 리소스 파일에는 두 가지 유형이 있습니다.

1. R 코드에서 참조되는 파일(예: R 스크립트, 데이터셋, 구성 파일 등)

2. 웹 문서에서 참조되는 정적 자산(예: CSS 스타일시트, 이미지 등)

아래에서는 각 리소스 유형이 인터랙티브 문서에서 어떻게 처리되는지 설명합니다.

코드 리소스

R 코드에서 참조하는 파일은 주 .qmd 파일의 디렉터리(또는 하위 디렉터리) 안에 있는 어떤 파일이든 참조할 수 있습니다. 이는 다른 .qmd 파일이나 R 스크립트와 다르지 않습니다.

또한 R 코드를 실행해 생성된 파일(예: 코드 청크에서 생성된 그림)은 HTML 출력 파일 옆의 문서 _files 디렉터리에 자동으로 저장됩니다. 이 파일들은 별도의 처리가 필요하지 않습니다.

에셋 리소스

많은 인터랙티브 문서는 _files 디렉터리에 있는 생성된 HTML과 그림만으로 구성됩니다. 하지만 경우에 따라 정적 이미지, CSS 파일 또는 다른 자산을 문서에 추가하고 싶을 수도 있습니다.

이 경우 Shiny 서버에서 해당 파일을 찾을 수 있도록 다음과 같은 특별한 이름의 하위 디렉터리 중 하나에 파일을 두어야 합니다.

디렉터리	설명
images/	이미지 파일(예: PNG, JPEG 등)
css/	CSS 스타일시트
js/	JavaScript 스크립트
www/	기타 파일(예: 다운로드 가능한 데이터셋)

메인 .qmd 파일 디렉터리의 모든 파일을 웹 문서에서 참조할 수 없는 이유는, 그 중 많은 파일이 애플리케이션 소스 코드나 데이터이기 때문입니다. 이는 최종 사용자가 다운로드할 필요가 없을 수도 있습니다. 위 디렉터리로 참조 가능한 파일을 제한하면 어떤 파일이 다운로드 가능하고, 어떤 파일은 그렇지 않은지 제어할 수 있습니다.