Migrate guides/debug to next (tauri-apps#1676)

* copy en files over -> mdx

* update to v2

added imnages on src/assets/img

* Delete debug.mdx

* update sidebar

* Update application.mdx

* Revert "update sidebar"

This reverts commit 266c15a.

* Revert "Delete debug.mdx"

This reverts commit 3deb758.

* add redirects

for all existing locales in v1 just in case

* link card in list without description

* add fr version

* update fr link

* add it version

* add ko version

* add zh-CN version

* move `debug.mdx` -> `debug/index.mdx`

* Update vs-code.mdx

* add slash to sidebar, this is not strictly necessary

* card grid

* move descriptions to parent pages

fix labels
add i18n index.mdx pages

* fix typo

* add missing i18n prefix

* fix braces

* update redirects to avoid 404 in disabled locales

* Add i18n redirect helper

* Move italian page

* fix link

---------

Co-authored-by: Lorenzo Lewis <[email protected]>

astro.config.mjs

@@ -141,7 +141,7 @@ export default defineConfig({
 						},
 						{
 							label: 'Debug',
-							link: 'guides/debug',
+							link: 'guides/debug/',
 						},
 						{
 							label: 'Test',
@@ -228,21 +228,35 @@ export default defineConfig({
 		'/blog/2023/06/15/tauri-board-elections-and-governance-updates':
 			'/blog/tauri-board-elections-and-governance-updates',
 		'about/intro': 'about/philosophy',
+		// v1 /guides/debugging -> /guides/debug
+		...i18nRedirect('/v1/guides/debugging/application', '/guides/debug/application'),
+		...i18nRedirect('/v1/guides/debugging/vs-code', '/guides/debug/vs-code'),
+		...i18nRedirect('/v1/guides/debugging/clion', '/guides/debug/clion'),
 		// v1 /guides/development -> /guides/develop
-		'/v1/guides/development/development-cycle': '/guides/develop/development-cycle',
-		'/v1/guides/development/updating-dependencies': '/guides/develop/updating-dependencies',
-		// i18n fr
-		'/fr/v1/guides/development/development-cycle/': '/fr/guides/develop/development-cycle/',
-		'/fr/v1/guides/development/updating-dependencies/': '/fr/guides/develop/updating-dependencies/',
-		// i18n ko
-		'/ko/v1/guides/development/development-cycle/': '/ko/guides/develop/development-cycle/',
-		'/ko/v1/guides/development/updating-dependencies/': '/ko/guides/develop/updating-dependencies/',
-		// i18n zh-cn
-		'/zh-cn/v1/guides/development/development-cycle/': '/zh-cn/guides/develop/development-cycle/',
-		'/zh-cn/v1/guides/development/updating-dependencies/':
-			'/zh-cn/guides/develop/updating-dependencies/',
-		// i18n it
-		'/it/v1/guides/development/development-cycle/': '/it/guides/develop/development-cycle/',
-		'/it/v1/guides/development/updating-dependencies/': '/it/guides/develop/updating-dependencies/',
+		...i18nRedirect(
+			'/v1/guides/development/development-cycle',
+			'/guides/develop/development-cycle'
+		),
+		...i18nRedirect(
+			'/v1/guides/development/updating-dependencies',
+			'/guides/develop/updating-dependencies'
+		),
+		// Decommissioned locales
+		'/ko/[...slug]': '/[...slug]',
+		'/it/[...slug]': '/[...slug]',
 	},
 });
+
+// Generates a redirect for each locale.
+function i18nRedirect(from, to) {
+	const routes = {};
+	Object.keys(locales).map((locale) =>
+		locale === 'root'
+			? (routes[from] = to)
+			: (routes[`/${locale}/${from.replaceAll(/^\/*/g, '')}`] = `/${locale}/${to.replaceAll(
+					/^\/*/g,
+					''
+			  )}`)
+	);
+	return routes;
+}

src/content/docs/_it/guides/debug/vs-code.mdx

@@ -0,0 +1,85 @@
+---
+title: Debug in VS Code
+description: Suggerimenti e trucchi per il flusso di lavoro di debug
+---
+
+## Prerequisiti
+
+Installa l'estensione [`vscode-lldb`][].
+
+## Configura launch.json
+
+Crea un file `.vscode/launch.json` e incolla il contenuto JSON sottostante in esso:
+
+```json title=".vscode/launch.json"
+{
+  // Use IntelliSense to learn about possible attributes.
+  // Hover to view descriptions of existing attributes.
+  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "type": "lldb",
+      "request": "launch",
+      "name": "Tauri Development Debug",
+      "cargo": {
+        "args": [
+          "build",
+          "--manifest-path=./src-tauri/Cargo.toml",
+          "--no-default-features"
+        ]
+      },
+      // task for the `beforeDevCommand` if used, must be configured in `.vscode/tasks.json`
+      "preLaunchTask": "ui:dev"
+    },
+    {
+      "type": "lldb",
+      "request": "launch",
+      "name": "Tauri Production Debug",
+      "cargo": {
+        "args": ["build", "--release", "--manifest-path=./src-tauri/Cargo.toml"]
+      },
+      // task for the `beforeBuildCommand` if used, must be configured in `.vscode/tasks.json`
+      "preLaunchTask": "ui:build"
+    }
+  ]
+}
+```
+
+Questo utilizza `cargo` direttamente per costruire l'applicazione Rust e caricarlo sia in modalità di sviluppo che di produzione.
+
+Nota che non utilizza il Tauri CLI, quindi le esclusive funzioni CLI non vengono eseguite. Gli script `beforeDevCommand` e `beforeBuildCommand` devono essere eseguiti in anticipo o configurati come task nel campo `preLaunchTask`. Di seguito trovate come esempio il file `.vscode/tasks.json` che ha due task, uno per un `beforeDevCommand` che genera un server di sviluppo e uno per `beforeBuildCommand`:
+
+```json title=".vscode/tasks.json"
+{
+  // See https://go.microsoft.com/fwlink/?LinkId=733558
+  // for the documentation about the tasks.json format
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "ui:dev",
+      "type": "shell",
+      // `dev` keeps running in the background
+      // ideally you should also configure a `problemMatcher`
+      // see https://code.visualstudio.com/docs/editor/tasks#_can-a-background-task-be-used-as-a-prelaunchtask-in-launchjson
+      "isBackground": true,
+      // change this to your `beforeDevCommand`:
+      "command": "yarn",
+      "args": ["dev"]
+    },
+    {
+      "label": "ui:build",
+      "type": "shell",
+      // change this to your `beforeBuildCommand`:
+      "command": "yarn",
+      "args": ["build"]
+    }
+  ]
+}
+```
+
+Ora puoi impostare breakpoint in `src-tauri/src/main.rs` o in qualsiasi altro file Rust e iniziare il processo di debug premendo `F5`.
+
+[`vscode-lldb`]: https://marketplace.visualstudio.com/items?itemName=vadimcn.vscode-lldb
+
+[Core Process of your Tauri app]: ../../references/architecture/process-model.md#the-core-process

src/content/docs/_ko/guides/debug/application.mdx

@@ -0,0 +1,109 @@
+---
+title: 애플리케이션 디버깅
+description: 디버깅 작업 흐름을 위한 팁과 요령
+---
+
+import CommandTabs from '@components/CommandTabs.astro';
+
+Tauri의 모든 움직이는 부분에는 디버깅이 필요한 문제가 발생할 수 있습니다. 오류 상세 정보가 출력되는 위치가 많이 있어, Tauri에는 디버깅 프로세스를 보다 간단하게 만드는 몇 가지 도구가 포함되어 있습니다.
+
+## Rust 콘솔
+
+오류를 찾는 첫 번째 장소는 Rust 콘솔입니다. 터미널에 `tauri dev`를 실행합니다. 다음 코드를 사용하여 Rust 파일 내 해당 콘솔에 무언가를 인쇄할 수 있습니다:
+
+```rust
+println!("Message from Rust: {}", msg);
+```
+
+때로는, Rust 코드에 오류가 있을 수 있고, Rust 컴파일러는 많은 정보를 제공할 수 있습니다. 예를 들어, `tauri dev`가 충돌하는 경우, Linux 및 macOS에서 다음과 같이 다시 실행할 수 있습니다:
+
+```shell
+RUST_BACKTRACE=1 tauri dev
+```
+
+혹은 윈도우에선 아래와 같습니다.
+
+```shell
+set RUST_BACKTRACE=1
+tauri dev
+```
+
+이 명령은 세분화된 추적 스택을 제공해줍니다. 일반적으로, Rust 컴파일러는 다음과 같은 문제에 대한 자세한 정보를 제공하여 도움을 줍니다.
+
+```
+error[E0425]: cannot find value `sun` in this scope
+  --> src/main.rs:11:5
+   |
+11 |     sun += i.to_string().parse::<u64>().unwrap();
+   |     ^^^ help: a local variable with a similar name exists: `sum`
+
+error: aborting due to previous error
+
+For more information about this error, try `rustc --explain E0425`.
+```
+
+## WebView 콘솔
+
+WebView에서 우클릭한 후, `요소 검사`를 선택합니다. 이렇게 하면 익숙한 Chrome 또는 Firefox 개발 도구와 유사한 웹 검사기가 열립니다. Linux 및 Windows에서는 `Ctrl + Shift + i` 단축키를 사용하고 macOS에서는 `Command + Option + i` 단축키를 사용하여 속성을 열 수도 있습니다.
+
+검사기 창은 플랫폼에 따라 다르며 Linux의 webkit2gtk WebInspector, macOS의 Safari 검사기 창 및 Windows의 Microsoft Edge DevTools를 렌더링합니다.
+
+### 프로그래밍으로 Devtools 열기
+
+[`Window::open_devtools`][] 및 [`Window::close_devtools`][] 기능을 사용하여 검사기 창을 제어할 수 있습니다.
+
+```rust
+use tauri::Manager;
+tauri::Builder::default()
+  .setup(|app| {
+    #[cfg(debug_assertions)] // 디버그 빌드에만 이 코드를 포함
+    {
+      let window = app.get_window("main").unwrap();
+      window.open_devtools();
+      window.close_devtools();
+    }
+    Ok(())
+  });
+```
+
+### 프로덕션에서 요소 검사 사용하기
+
+기본적으로, 요소 검사는 Cargo 기능으로 활성화하지 않는 한 개발 및 디버그 빌드에서만 활성화됩니다.
+
+#### 디버그 빌드 생성하기
+
+디버그 빌드를 생성하기 위해선 `tauri build --debug` 명령을 실행해야 합니다.
+
+<CommandTabs
+	npm="npm run tauri build -- --debug"
+	yarn="yarn tauri build --debug"
+	pnpm="pnpm tauri build --debug"
+  cargo="cargo tauri build --debug"
+/>
+
+일반 빌드 및 개발 프로세스와 마찬가지로 빌드는 이 명령을 처음 실행할 때 약간의 시간이 걸리지만 후속 실행에서는 훨씬 더 빠릅니다. 최종 번들 앱에는 개발 콘솔이 활성화되어 있으며 `src-tauri/target/debug/bundle`에 배치됩니다.
+
+터미널에서 빌드된 앱을 실행하여 Rust 컴파일러 노트(오류가 있는 경우) 또는 `println` 메시지를 제공할 수도 있습니다. `src-tauri/target/(release|debug)/[app name]` 파일을 찾아 콘솔에서 직접 실행하거나 파일 시스템에서 실행 파일 자체를 두 번 클릭합니다(참고: 콘솔은 이 방법으로 오류를 종료합니다).
+
+#### Devtools 기능 활성화
+
+:::주의
+
+이 devtools는 macOS에서 비공개 API입니다. MacOS에서 비공개 API를 사용하면 애플리케이션이 App Store에 승인되지 않습니다.
+
+:::
+
+프로덕션 빌드에서 devtools를 활성화하려면 `src-tauri/Cargo.toml` 파일에서 `devtools` Cargo 기능을 활성화해야 합니다.
+
+```toml
+[dependencies]
+tauri = { version = "...", features = ["...", "devtools"] }
+```
+
+## 핵심 프로세스 디버깅
+
+핵심 프로세스는 Rust로 구동되므로 GDB 또는 LLDB를 사용하여 디버깅할 수 있습니다. [VS Code에서 디버깅][] 가이드에 따라 LLDB VS Code 확장을 사용하여 Tauri 애플리케이션의 핵심 프로세스를 디버깅하는 방법을 알아볼 수 있습니다.
+
+[VS Code에서 디버깅]: /ko/guides/debug/vs-code
+[`Window::open_devtools`]: https://docs.rs/tauri/1/tauri/window/struct.Window.html#method.open_devtools
+[`Window::close_devtools`]: https://docs.rs/tauri/1/tauri/window/struct.Window.html#method.close_devtools

src/content/docs/_ko/guides/debug/vs-code.mdx

@@ -0,0 +1,87 @@
+---
+title: VS Code 디버깅
+description: 디버깅 작업 흐름을 위한 팁과 요령
+---
+
+This guide will walk you through setting up VS Code for debugging the [Core Process of your Tauri app].
+
+## 사전 요구 사항
+
+[`vscode-lldb`][] 확장을 설치합니다.
+
+## launch.json 설정
+
+`.vscode/launch.json` 파일을 생성하고 아래 JSON 내용을 복사해서 붙여 넣습니다:
+
+```json title=".vscode/launch.json"
+{
+  // Use IntelliSense to learn about possible attributes.
+  // Hover to view descriptions of existing attributes.
+  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "type": "lldb",
+      "request": "launch",
+      "name": "Tauri Development Debug",
+      "cargo": {
+        "args": [
+          "build",
+          "--manifest-path=./src-tauri/Cargo.toml",
+          "--no-default-features"
+        ]
+      },
+      // task for the `beforeDevCommand` if used, must be configured in `.vscode/tasks.json`
+      "preLaunchTask": "ui:dev"
+    },
+    {
+      "type": "lldb",
+      "request": "launch",
+      "name": "Tauri Production Debug",
+      "cargo": {
+        "args": ["build", "--release", "--manifest-path=./src-tauri/Cargo.toml"]
+      },
+      // task for the `beforeBuildCommand` if used, must be configured in `.vscode/tasks.json`
+      "preLaunchTask": "ui:build"
+    }
+  ]
+}
+```
+
+이는 Rust 애플리케이션을 개발, 프로덕션 모드 모두에서 로드하기 위해 `cargo`를 직접 사용해 빌드합니다.
+
+Tauri CLI를 사용하지 않으므로 전용 CLI 기능이 실행되지 않습니다. `beforeDevCommand`와 `beforeBuildCommand` 스크립트는 미리 실행하거나 `preLaunchTask` 필드에서 작업으로 구성해야 합니다. 다음은 개발 서버를 생성하는 `beforeDevCommand`와 `beforeBuildCommand` 두 가지 작업이 있는 `.vscode/tasks.json` 파일의 예입니다:
+
+```json title=".vscode/tasks.json"
+{
+  // See https://go.microsoft.com/fwlink/?LinkId=733558
+  // for the documentation about the tasks.json format
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "ui:dev",
+      "type": "shell",
+      // `dev` keeps running in the background
+      // ideally you should also configure a `problemMatcher`
+      // see https://code.visualstudio.com/docs/editor/tasks#_can-a-background-task-be-used-as-a-prelaunchtask-in-launchjson
+      "isBackground": true,
+      // change this to your `beforeDevCommand`:
+      "command": "yarn",
+      "args": ["dev"]
+    },
+    {
+      "label": "ui:build",
+      "type": "shell",
+      // change this to your `beforeBuildCommand`:
+      "command": "yarn",
+      "args": ["build"]
+    }
+  ]
+}
+```
+
+이제, `src-tauri/src/main.rs` 혹은 다른 Rust 파일에 중단점을 설정하고 `F5`를 눌러 디버깅을 시작할 수 있습니다.
+
+[`vscode-lldb`]: https://marketplace.visualstudio.com/items?itemName=vadimcn.vscode-lldb
+
+[Core Process of your Tauri app]: ../../references/architecture/process-model.md#the-core-process