Skip to content
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.

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

i18n(ko): initialize korean translation #2953

Open
wants to merge 2 commits into
base: v2
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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
3 changes: 3 additions & 0 deletions .github/labeler.yml
Original file line number Diff line number Diff line change
Expand Up @@ -17,3 +17,6 @@ i18n:

"i18n: zh-cn":
- src/content/docs/zh-cn/**/*

"i18n: ko":
- src/content/docs/ko/**/*
7 changes: 7 additions & 0 deletions astro.config.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -143,41 +143,47 @@ export default defineConfig({
label: 'Guides',
translations: {
'zh-CN': '指引',
'ko': '가이드',
},
collapsed: true,
items: [
{
label: 'Quick Start',
translations: {
'zh-CN': '快速开始',
'ko': '시작하기',
},
collapsed: true,
items: [
{
label: 'What is Tauri?',
translations: {
'zh-CN': '什么是 Tauri?',
'ko': 'Tauri가 무엇인가요?',
},
link: '/start/',
},
{
label: 'Prerequisites',
translations: {
'zh-CN': '前置条件',
'ko': '요구사항',
},
link: '/start/prerequisites/',
},
{
label: 'Create a Project',
translations: {
'zh-CN': '创建项目',
'ko': '프로젝트 생성하기',
},
link: '/start/create-project/',
},
{
label: 'Frontend Configuration',
translations: {
'zh-CN': '前端配置',
'ko': '프론트엔드 설정',
},
collapsed: true,
autogenerate: { directory: 'start/frontend' },
Expand All @@ -186,6 +192,7 @@ export default defineConfig({
label: 'Upgrade & Migrate',
translations: {
'zh-CN': '升级和迁移',
'ko': '업그레이드 & 마이그레이션',
},
collapsed: true,
autogenerate: { directory: 'start/migrate' },
Expand Down
4 changes: 4 additions & 0 deletions locales.json
Original file line number Diff line number Diff line change
Expand Up @@ -14,5 +14,9 @@
"zh-cn": {
"label": "简体中文",
"lang": "zh-cn"
},
"ko": {
"label": "한국어",
"lang": "ko"
}
}
61 changes: 61 additions & 0 deletions src/content/docs/ko/index.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
---
title: Tauri 2.0
description: 크로스 플랫폼 앱 제작 도구
i18nReady: true
editUrl: false
lastUpdated: false
template: splash
tableOfContents: false
prev: false
next: false
hero:
tagline: 작고, 빠르고, 안전한 크로스 플랫폼 앱 만들기
image:
file: ../../../assets/logo-outline.svg
actions:
- text: 시작하기
link: /ko/start/
icon: right-arrow
variant: primary
- text: Tauri 1.0 문서
link: https://v1.tauri.app
icon: external
variant: minimal
---

import { Card, CardGrid, LinkCard } from '@astrojs/starlight/components';
import Cta from '@fragments/cta.mdx';

<div class="hero-bg">
<div class="bg-logo"></div>
<div class="bg-grad"></div>
<div class="bg-grad-red"></div>
</div>

<div class="lp-cta-card">
<Card title="프로젝트 생성하기" icon="rocket">
<Cta />
</Card>
</div>

<CardGrid>
<Card title="프론트엔드 독립형" icon="rocket">
기존 웹 스택을 Tauri에 가져오거나 새로운 꿈같은 프로젝트를 시작해보세요.
Tauri는 어떤 프론트엔드 프레임워크도 지원하기 때문에 스택을 변경할 필요가 없습니다.
</Card>
<Card title="크로스 플랫폼" icon="rocket">
하나의 코드베이스로 Linux, macOS, Windows, Android 및 iOS 앱을 만들어보세요.
</Card>
<Card title="프로세스 간 커뮤니케이션(IPC)" icon="rocket">
JavaScript로 프론트엔드를, Rust로 앱 로직을 작성하고, Swift와 Kotlin으로 시스템에 깊게 연결하세요.
</Card>
<Card title="최고의 보안" icon="rocket">
Tauri 팀의 최우선 순위이자, 가장 큰 혁신을 이끌어내는 중심입니다.
</Card>
<Card title="최소한의 크기" icon="rocket">
OS의 네이티브 웹 렌더러를 사용하여, Tauri 앱의 크기는 최소 600KB로 줄일 수 있습니다.
</Card>
<Card title="Rust로 구동" icon="rocket">
성능과 보안을 중심에 둔 Rust는 차세대 앱을 위한 언어입니다.
</Card>
</CardGrid>
218 changes: 218 additions & 0 deletions src/content/docs/ko/start/create-project.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,218 @@
---
title: 프로젝트 생성하기
sidebar:
order: 3
---

import { Card, Steps } from '@astrojs/starlight/components';

import Cta from '@fragments/cta.mdx';

Tauri의 유연성 중 하나는 어떠한 프론트엔드 프레임워크에서든 작업이 가능하다는 것입니다. 공식적으로 지원하는 프레임워크 템플릿을 사용하여 새로운 Tauri 프로젝트를 만드는 것을 돕기 위해 우리는 [`create-tauri-app`](https://github.com/tauri-apps/create-tauri-app) 유틸리티를 만들었습니다.

`create-tauri-app`은 현재 vanilla (프레임워크 없는 HTML, CSS 및 JavaScript), [Vue.js](https://vuejs.org), [Svelte](https://svelte.dev), [React](https://reactjs.org/), [SolidJS](https://www.solidjs.com/), [Angular](https://angular.io/), [Preact](https://preactjs.com/), [Yew](https://yew.rs/), [Leptos](https://github.com/leptos-rs/leptos), 그리고 [Sycamore](https://sycamore-rs.netlify.app/) 템플릿을 포함합니다. 또한 [Awesome Tauri 레포지토리](https://github.com/tauri-apps/awesome-tauri)에서 커뮤니티 템플릿 및 프레임워크를 찾거나 추가할 수 있습니다.

{/* TODO: redirect to integrate to existing front-end project specific docs */}
또는, 기존 프로젝트에 [Tauri를 추가](#수동-설정-tauri-cli)하여 기존 코드베이스를 Tauri 앱으로 빠르게 변환할 수 있습니다.

## `create-tauri-app` 사용하기

`create-tauri-app`을 사용하여 프로젝트를 설정하려면 아래 명령어 중 하나를 프로젝트를 설정하고 싶은 폴더에서 실행하세요. 어떤 명령어를 사용할지 모르겠다면, Linux 및 macOS에서는 Bash 명령어를, Windows에서는 PowerShell 명령어를 사용하는 것을 권장합니다.

<Cta />

프롬프트에 따라 프로젝트 이름, 프론트엔드 언어, 패키지 관리자, 프론트엔드 프레임워크, 그리고 프론트엔드 프레임워크 옵션을 선택하세요.

:::tip[무엇을 선택해야 할지 모르겠나요?]

{/* TODO: redirect to integrate to existing front-end project specific docs */}
Vanilla 템플릿 (프레임워크 없는 HTML, CSS 및 JavaScript)을 사용하여 시작하는 것을 권장합니다. 나중에 프론트엔드 프레임워크를 통합할 수 있습니다.

- Choose which language to use for your frontend: `TypeScript / JavaScript`
- Choose your package manager: `pnpm`
- Choose your UI template: `Vanilla`
- Choose your UI flavor: `TypeScript`

:::

#### 새 프로젝트 만들기

<Steps>

1. 이름과 번들 식별자 (앱에 대한 고유 ID)를 선택하세요:
```
? Project name (tauri-app) ›
? Identifier (com.tauri-app.app) ›
```
2. 프론트엔드에서 사용할 언어를 먼저 선택하세요:
```
? Choose which language to use for your frontend ›
Rust (cargo)
TypeScript / JavaScript (pnpm, yarn, npm, bun)
.NET (dotnet)
```
3. (여러 개가 있는 경우) 패키지 관리자를 선택하세요:

**TypeScript / JavaScript**에 대한 옵션:

```
? Choose your package manager ›
pnpm
yarn
npm
bun
```

4. 프론트엔드 템플릿과 프론트엔드 프레임워크를 선택하세요 (여러 개가 있는 경우):

**Rust**에 대한 옵션:

```
? Choose your UI template ›
Vanilla
Yew
Leptos
Sycamore
```

**TypeScript / JavaScript**에 대한 옵션:

```
? Choose your UI template ›
Vanilla
Vue
Svelte
React
Solid
Angular
Preact

? Choose your UI flavor ›
TypeScript
JavaScript
```

**.NET**에 대한 옵션:

```
? Choose your UI template ›
Blazor (https://dotnet.microsoft.com/en-us/apps/aspnet/web-apps/blazor/)
```

</Steps>

완료되면 유틸리티는 템플릿이 생성되었음을 출력하고 구성된 패키지 관리자를 사용하여 템플릿을 실행하는 방법을 표시합니다. 시스템에서 누락된 종속성을 감지하면 패키지 목록을 인쇄하고 설치 방법을 묻는 메시지를 표시합니다.

{/* TODO: Can CTA offer to install the deps? */}

#### 개발 서버 실행하기

`create-tauri-app`이 완료되면 프로젝트 폴더로 이동하여 종속성을 설치한 후, [Tauri CLI](/ko/reference/cli/)를 사용하여 개발 서버를 시작할 수 있습니다:

import CommandTabs from '@components/CommandTabs.astro';

<CommandTabs
npm="cd tauri-app
npm install
npm run tauri dev"
yarn="cd tauri-app
yarn install
yarn tauri dev"
pnpm="cd tauri-app
pnpm install
pnpm tauri dev"
deno="cd tauri-app
deno install
deno task tauri dev"
cargo="cd tauri-app
cargo tauri dev"
/>

새 창이 열리며 앱이 실행될 것입니다.

**축하합니다!** 성공적으로 Tauri 앱을 만들었습니다! 🚀

## 수동 설정 (Tauri CLI)

이미 존재하는 프론트엔드가 있거나 직접 설정하는 것을 선호한다면, Tauri CLI를 사용하여 프로젝트의 백엔드를 별도로 초기화할 수 있습니다.

:::note
아래 예시는 새 프로젝트를 만드는 것을 가정합니다. 이미 프론트엔드를 설정한 경우, 첫 번째 단계를 건너뛸 수 있습니다.
:::

<Steps>

1. 프로젝트에 대한 새 디렉토리를 만들고 프론트엔드를 설정하세요. 기본 HTML, CSS 및 JavaScript, 또는 Next.js, Nuxt, Svelte, Yew, 또는 Leptos와 같은 프레임워크를 사용할 수 있습니다. 단지 브라우저에서 앱을 제공할 방법만 존재하면 됩니다. 예를 들어, 다음은 간단한 Vite 앱을 설정하는 방법입니다:

<CommandTabs
npm="mkdir tauri-app
cd tauri-app
npm create vite@latest ."
yarn="mkdir tauri-app
cd tauri-app
yarn create vite ."
pnpm="mkdir tauri-app
cd tauri-app
pnpm create vite ."
deno="mkdir tauri-app
cd tauri-app
deno run -A npm:create-vite ."
/>

2. 그런 다음, 원하는 패키지 관리자를 사용하여 Tauri CLI를 설치하세요. `cargo`를 사용하여 Tauri CLI를 설치하는 경우, 전역으로 설치해야 합니다.

<CommandTabs
npm="npm install -D @tauri-apps/cli@latest"
yarn="yarn add -D @tauri-apps/cli@latest"
pnpm="pnpm add -D @tauri-apps/cli@latest"
deno="deno add -D npm:@tauri-apps/cli@latest"
cargo='cargo install tauri-cli --version "^2.0.0" --locked'
/>

3. 프론트엔드 개발 서버의 URL을 결정하세요. 이는 Tauri가 콘텐츠를 로드하는 데 사용할 URL입니다. 예를 들어, Vite를 사용하는 경우, 기본 URL은 `http://localhost:5173`입니다.

4. 프로젝트 디렉토리에서 Tauri를 설정하세요:

<CommandTabs
npm="npx tauri init"
yarn="yarn tauri init"
pnpm="pnpm tauri init"
deno="deno task tauri init"
cargo="cargo tauri init"
/>

명령어를 실행하면 다음과 같은 프롬프트가 표시됩니다:

```sh frame=none
✔ What is your app name? tauri-app
✔ What should the window title be? tauri-app
✔ Where are your web assets located? ..
✔ What is the url of your dev server? http://localhost:5173
✔ What is your frontend dev command? pnpm run dev
✔ What is your frontend build command? pnpm run build
```

이는 필요한 Tauri 설정 파일이 포함된 `src-tauri` 디렉토리를 프로젝트에 생성합니다.

5. 개발 서버를 실행하여 Tauri 앱이 작동하는지 확인하세요:

<CommandTabs
npm="npx tauri dev"
yarn="yarn tauri dev"
pnpm="pnpm tauri dev"
deno="deno task tauri dev"
cargo="cargo tauri dev"
/>

이 명령어는 Rust 코드를 컴파일하고 웹 콘텐츠를 표시하는 창을 엽니다.

</Steps>

**축하합니다!** Tauri CLI를 사용하여 새로운 Tauri 프로젝트를 만들었습니다! 🚀

## 다음 단계

- [프론트엔드 프레임워크 추가 및 설정](/ko/start/frontend/)
- [Tauri CLI 레퍼런스](/ko/reference/cli/)
- [Tauri 앱 만드는 방법 알아보기](/ko/develop/)
- [Tauri 플러그인 확장 기능 알아보기](/ko/plugin/)
Loading
Loading