확장 관리

설치

문서나 프로젝트에서 확장을 사용하려면 해당 확장을 프로젝트 또는 디렉터리에 추가해야 합니다. 전역 라이브러리에 설치하는 대신 Quarto 확장은 로컬에 저장되며, 사용되는 문서나 프로젝트와 같은 위치에 직접 놓입니다. 예를 들어 myblog라는 디렉터리에 프로젝트가 있다면 다음과 같이 확장을 추가할 수 있습니다.

Terminal

cd myblog
quarto add quarto-ext/fontawesome
quarto add quarto-ext/video

그러면 프로젝트 루트에 _extensions 폴더가 생성되고, 그 안에 fontawesome과 video 확장이 저장됩니다.

확장을 사용하기 위해 프로젝트가 반드시 필요한 것은 아닙니다. 프로젝트가 아닌 디렉터리에 확장을 추가하더라도, 해당 _extensions 폴더와 같은 위치에 있는 문서는 확장을 사용할 수 있습니다.

확장 신뢰

Quarto 확장은 문서를 렌더링할 때 코드를 실행할 수 있습니다. 따라서 확장 작성자를 신뢰하지 않는다면 해당 확장을 설치하거나 사용하지 않는 것을 권장합니다.

버전 관리

버전 관리를 사용한다면 _extensions 디렉터리를 다른 코드와 함께 저장소에 포함해야 합니다. 문서나 프로젝트에서 사용하는 확장은 소스 코드로 취급되어 장기적인 재현성을 보장합니다. 즉, 외부 패키지 매니저의 가용성이나 오래된 확장 버전 유지에 의존하지 않고도 현재와 미래에 문서를 안정적으로 렌더링할 수 있습니다.

저장소

위 예시의 확장은 quarto-ext GitHub 조직에서 배포되므로 quarto-ext 접두어를 사용했습니다. 확장은 어떤 GitHub 조직에서도 유사하게 배포할 수 있습니다. 예를 들어 다음 명령도 프로젝트에 확장을 추가하는 유효한 방법입니다.

Terminal

quarto add cooltools/lightbox
quarto add bigstateu/fancytweet

GitHub로 확장을 배포하는 것이 편리하지만, .zip 또는 .tar.gz 아카이브로 묶어 URL이나 로컬 파일로 배포하는 것도 가능합니다. 자세한 내용은 확장 배포 문서를 참고하세요.

업데이트

다음 명령으로 프로젝트에 구성된 확장을 나열하고 업데이트할 수 있습니다.

Terminal

quarto list extensions
quarto update quarto-ext/fontawesome

확장을 업데이트할 때는 현재 버전과 업데이트하려는 버전을 기준으로 확인 프롬프트가 표시됩니다.

제거

프로젝트에서 확장을 제거하려면 다음 명령을 사용합니다.

Terminal

quarto remove quarto-ext/fontawesome

extension-id 없이 quarto remove extension 명령을 실행하면 현재 존재하는 확장 목록이 표시되고, 제거할 확장을 선택할 수 있습니다.