Skip to content

feat(demo): refine Korean copy and localized og cards #10

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
puleugo merged 1 commit into from
Mar 10, 2026
Merged

feat(demo): refine Korean copy and localized og cards #10

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions docs/ko/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,9 @@

# docxly 문서

`docxly`는 DOCX와 HWPX 생성을 애플리케이션 내부에 직접 내장하기 위한 Rust/WASM 문서 생성 엔진입니다.
`docxly`는 애플리케이션 안에서 DOCX와 HWPX를 직접 만들 수 있게 해주는 Rust/WASM 기반 문서 생성 엔진입니다.

Pandoc이 범용 문서 변환기라면, `docxly`는 Node 서비스, 브라우저 워크플로, 제품 UI 안에 직접 들어가는 라이브러리 경로에 초점을 맞춥니다.
Pandoc이 다양한 형식 사이를 변환하는 범용 도구라면, `docxly`는 Node 서비스, 브라우저 워크플로, 제품 UI에 바로 넣어 쓸 수 있는 라이브러리 경험에 초점을 둡니다.

## 시작하기

Expand All @@ -17,16 +17,16 @@ Pandoc이 범용 문서 변환기라면, `docxly`는 Node 서비스, 브라우

## 핵심 수치

- 현재 summary benchmark 기준 `docxly`는 `80 ms cold / 2 ms steady`
- 현재 요약 벤치마크 기준 `docxly`는 `80 ms cold / 2 ms steady`
- 같은 코퍼스에서 Pandoc은 `284 ms cold / 210 ms steady`
- steady 기준으로 `105x` 빠른 수치가 측정됨
- 반복 실행 구간에서는 `105x` 빠른 수치가 측정됐습니다.

## 언제 docxly를 선택해야 하나

- 문서 생성을 별도 CLI 프로세스가 아니라 애플리케이션 내부 라이브러리로 붙이고 싶을 때
- 문서 생성을 별도 CLI 프로세스가 아니라 애플리케이션 내부 기능으로 넣고 싶을 때
- Node와 브라우저에서 같은 Rust 코어를 재사용하고 싶을 때
- DOCX뿐 아니라 HWPX까지 같은 저장소와 API 흐름으로 확장하고 싶을 때
- 테스트 가능한 결정적 출력과 fixture 기반 검증이 필요할 때
- 예측 가능한 출력과 fixture 기반 검증 체계가 필요할 때

## 바로 가기

Expand Down
22 changes: 11 additions & 11 deletions docs/ko/benchmark.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,31 +2,31 @@

## 요약

`docxly`는 Pandoc의 대체 CLI가 아니라, 앱 내부에 문서 생성을 임베드하기 위한 라이브러리 경로를 제공합니다.
`docxly`는 Pandoc을 대체하는 또 하나의 CLI가 아니라, 애플리케이션 안에 문서 생성을 직접 넣기 위한 라이브러리입니다.

- `docxly`: embeddable generation engine
- `Pandoc`: general-purpose converter
- `docxly`: 제품 안에 넣어 쓰는 문서 생성 엔진
- `Pandoc`: 다양한 포맷 변환에 강한 범용 변환기

## 현재 summary benchmark
## 현재 요약 벤치마크

- `docxly`: `80 ms cold / 2 ms steady`
- `Pandoc`: `284 ms cold / 210 ms steady`
- steady median 기준 `105x`
- 반복 실행 기준 `105x`

측정 조건:
측정 환경은 다음과 같습니다.

- 환경: `darwin 25.2.0 / arm64`
- Node: `v23.7.0`
- Pandoc: `3.9`
- 기준: complex DOCX benchmark corpus
- 기준: 복잡한 DOCX 벤치마크 코퍼스

## 해석

- cold start는 초기화 비용을 포함합니다.
- `docxly`: WASM initialization 포함
- `Pandoc`: process startup 포함
- steady median은 warm-up 이후 반복 생성 비용을 의미합니다.
- 이 수치는 브라우저 실측이 아니라 offline Node benchmark입니다.
- steady median은 warm-up 이후 반복 생성 비용을 뜻합니다.
- 이 수치는 브라우저 실측이 아니라 오프라인 Node 벤치마크 결과입니다.

## 언제 Pandoc이 더 적합한가

Expand All @@ -36,7 +36,7 @@

## 언제 docxly가 더 적합한가

- 앱 내부에 직접 문서 생성 기능을 붙여야 할 때
- 앱 안에 문서 생성 기능을 직접 넣어야 할 때
- Node와 브라우저에서 같은 코어를 재사용해야 할 때
- HWPX까지 같은 제품 흐름 안에서 다뤄야 할 때
- HWPX까지 같은 제품 흐름 안에서 함께 다뤄야 할 때
- 별도 프로세스 의존성 없이 라이브러리 형태로 배포하고 싶을 때
Loading