프로젝트 소개

# astro-umami > [Astro 통합](https://docs.astro.build/en/guides/integrations-guide/)으로 웹사이트에 [Umami Analytics](https://umami.is/)을 추가합니다. [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/yeskunall/astro-umami) [![Greptile: The War on Bugs](https://www.greptile.com/badge.svg)](https://www.greptile.com/?ref=yeskunall/astro-umami) [![E2E tests](https://github.com/yeskunall/astro-umami/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/yeskunall/astro-umami/actions/workflows/test.yml) [![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/yeskunall/astro-umami/blob/main/license) [![npm version](https://badge.fury.io/js/@yeskunall%2Fastro-umami.svg)](https://badge.fury.io/js/@yeskunall%2Fastro-umami) ![monthly downloads](https://img.shields.io/npm/dm/@yeskunall%2Fastro-umami.svg?logo=npm) ## 주요 기능 - [View Transitions](https://docs.astro.build/en/guides/view-transitions/) 사용 여부를 자동으로 감지하고 [`data-astro-rerun`](https://docs.astro.build/en/guides/view-transitions/#data-astro-rerun) 속성을 추가합니다 - 개발 중 이벤트 및 페이지뷰를 비활성화합니다 - [`astro-analytics`](https://github.com/Destiner/astro-analytics)와 달리 모든 [설정](https://docs.umami.is/docs/tracker-configuration) 옵션을 지원합니다 - 모든 설정 옵션에 대한 인라인 문서화를 제공합니다 ([TypeScript](https://github.com/yeskunall/astro-umami/blob/main/packages/astro-umami/src/index.ts#L7) 기반) - (_선택 사항_) 추적 스크립트를 [Partytown](https://partytown.qwik.dev/)으로 제공 (v0.0.5 이상) - **적극적으로 유지 관리됨** - **의존성 없음** ## 사용법 ### 설치 프로젝트 디렉토리에서 다음을 실행하고 메시지에 따라 진행하세요: ```sh pnpm astro add @yeskunall/astro-umami@0.0.9 ``` 이렇게 하면 Astro 구성에 필요한 변경 사항을 자동으로 설치하고 적용합니다. ### 수동 설치 1. 필수 종속성 설치 ```sh pnpm add @yeskunall/astro-umami@0.0.9 ``` 2. Astro 구성에 통합 추가: ```diff + import umami from "@yeskunall/astro-umami"; export default defineConfig({ integrations: [ + umami({ id: "94db1cb1-74f4-4a40-ad6c-962362670409" }), ], }); ``` ###### 모든 설정 가능한 옵션은 [인터페이스](https://github.com/yeskunall/astro-umami/blob/main/packages/astro-umami/src/index.ts#L7)를 참조하세요.