# Daily Saying KR

Insert a random Korean saying into your current note in Obsidian.

## Features

- Insert a random Korean saying from the command palette
- Replace the `{{daily-saying-kr}}` template placeholder automatically
- Work fully offline with a local saying dataset
- Support both desktop and mobile Obsidian

## Usage

Run **Insert random daily saying** from the command palette.

You can also use the template placeholder below:

```md
{{daily-saying-kr}}
```

When a note containing the placeholder is opened, the plugin automatically replaces it with a random saying.

## Installation

Until the plugin is available in the Obsidian Community directory, you can install it manually from a GitHub release.

1. Create `.obsidian/plugins/daily-saying-kr/` inside your vault.
2. Download `main.js` and `manifest.json` from the latest release.
3. Place both files in that directory.
4. Enable **Daily Saying KR** in Obsidian's Community plugins settings.

## Development

```bash
npm install
npm run dev
```

Set the local vault path before starting development:

```bash
export OBSIDIAN_VAULT_PATH="$HOME/Documents/Obsidian/Main"
```

`npm run dev` stays active in watch mode.

- It builds the plugin once and then waits for changes.
- When files under `src/` change, it rebuilds automatically.
- After a successful build, it copies `main.js`, `manifest.json`, and `versions.json` into `.obsidian/plugins/daily-saying-kr/` in the configured vault.

```text
Deployed daily-saying-kr to:
  /Users/john/Documents/Obsidian/Main/.obsidian/plugins/daily-saying-kr
[watch] build finished, watching for changes...
```

This state is expected. Press `Ctrl + C` to stop the watcher.

> Obsidian does not automatically reload plugins after build artifacts change. Reload Obsidian or re-enable the plugin to test updated code.

## Release build

```bash
npm run build
```

Release artifacts are generated at the repository root:

- `main.js`
- `manifest.json`
- `versions.json`

For Obsidian releases, attach `main.js`, `manifest.json`, and `styles.css` if the plugin uses one.

## Author

Rando209

## License

MIT

---

# Daily Saying KR 한국어 안내

매일 하나씩 읽을 수 있는 한국어 한 줄 문구를 Markdown으로 삽입하는 Obsidian 플러그인입니다.

## 소개

이 플러그인은 로컬 문구 데이터셋에서 무작위 문구를 골라 현재 문서에 삽입합니다. 외부 API를 호출하지 않으므로 오프라인에서도 동작합니다.

## 주요 기능

- 명령 팔레트에서 무작위 한국어 문구 삽입
- 템플릿 플레이스홀더 `{{daily-saying-kr}}` 자동 치환
- 외부 API 없이 로컬 데이터만 사용

## 사용법

명령 팔레트에서 **Insert random daily saying** 명령을 실행할 수 있습니다.

템플릿에서는 아래 플레이스홀더를 사용할 수 있습니다.

```md
{{daily-saying-kr}}
```

플레이스홀더가 포함된 문서를 열면 플러그인이 자동으로 무작위 문구로 바꿉니다.

## 설치

Obsidian 커뮤니티 플러그인 등록 전에는 GitHub Release에서 `main.js`와 `manifest.json`을 내려받아 수동 설치할 수 있습니다.

1. vault의 `.obsidian/plugins/daily-saying-kr/` 디렉터리를 만듭니다.
2. 릴리스 자산의 `main.js`, `manifest.json`을 해당 디렉터리에 넣습니다.
3. Obsidian 설정에서 커뮤니티 플러그인을 활성화한 뒤 **Daily Saying KR**를 켭니다.

## 개발 환경

```bash
npm install
npm run dev
```

개발용 vault 경로는 셸 환경변수로 미리 지정합니다.

```bash
export OBSIDIAN_VAULT_PATH="$HOME/Documents/Obsidian/Main"
```

`npm run dev`는 개발 감시 모드로 실행됩니다.

- 처음 한 번 빌드한 뒤 대기 상태를 유지합니다.
- `src/` 아래 파일이 바뀌면 자동으로 다시 빌드합니다.
- 빌드에 성공할 때마다 지정한 vault의 `.obsidian/plugins/daily-saying-kr/` 아래로 `main.js`, `manifest.json`, `versions.json`을 자동 복사합니다.

```text
Deployed daily-saying-kr to:
  /Users/john/Documents/Obsidian/Main/.obsidian/plugins/daily-saying-kr
[watch] build finished, watching for changes...
```

위 상태는 정상입니다. 파일 변경을 기다리는 중이며, 개발을 마칠 때는 터미널에서 `Ctrl + C`로 종료합니다.

> Obsidian은 빌드 결과가 바뀌어도 플러그인을 자동으로 다시 로드하지 않습니다. 새 코드를 확인하려면 Obsidian을 다시 로드하거나 플러그인을 다시 활성화해야 합니다.

## 배포용 빌드

```bash
npm run build
```

배포용 산출물은 저장소 루트의 `main.js`, `manifest.json`, `versions.json`입니다. Obsidian 커뮤니티 플러그인 릴리스에서는 버전 태그와 동일한 릴리스에 `manifest.json`, `main.js`, 선택적으로 `styles.css`를 첨부해야 합니다.

## 작성자

Rando209

## 라이선스

MIT