### Install MCSkinn via Microsoft Store
Source: https://github.com/inkore-net/documentation/blob/main/data/docs/mcskinn/02.
Instructions to install MCSkinn directly from the Microsoft Store. This is the recommended method due to the unavailability of the iNKORE Hub.
```html
```
--------------------------------
### Install iNKORE.UI.WPF.Modern Package
Source: https://github.com/inkore-net/documentation/blob/main/data/docs/ui-wpf-modern/02.
Instructions for installing the iNKORE.UI.WPF.Modern and iNKORE.UI.WPF packages via the NuGet Package Manager in Visual Studio.
```C#
Install-Package iNKORE.UI.WPF.Modern
Install-Package iNKORE.UI.WPF
```
--------------------------------
### Download iNKORE Hub
Source: https://github.com/inkore-net/documentation/blob/main/data/docs/mcskinn/02.
Provides a link to download the iNKORE Hub, which was previously used for installing MCSkinn. Users are advised to use the Microsoft Store if the Hub is unavailable.
```html
[Download iNKORE Hub](https://inkore.net/hub-windows)
```
--------------------------------
### Project Configuration for .NET Framework
Source: https://github.com/inkore-net/documentation/blob/main/data/docs/ui-wpf-modern/02.
Ensures the target framework is .NET Framework 4.6.2 or higher for compatibility with iNKORE.UI.WPF.Modern.
```XML
net462
```
--------------------------------
### File Structure Example
Source: https://github.com/inkore-net/documentation/blob/main/CONTRIBUTING.en-US.md
Illustrates the recommended directory structure for organizing resource files, including a `.unused` directory for original uncompressed files.
```plaintext
launcher-home/
├── .unused/
│ ├── launcher-home.png
├── launcher-home.jpg
├── index.en-US.mdx
├── ...
```
--------------------------------
### Project Configuration for .NET Core
Source: https://github.com/inkore-net/documentation/blob/main/data/docs/ui-wpf-modern/02.
Ensures the target framework is .NET 6.0 or higher and sets the Target OS Version for theme syncing. Recommended Target OS Version is '10.0.18362.0' or higher.
```XML
net6.010.0.18362.0
```
--------------------------------
### Resource File Compression Example
Source: https://github.com/inkore-net/documentation/blob/main/CONTRIBUTING.zh-CN.md
Shows the recommended directory structure for managing image assets, including a `.unused` folder for original, uncompressed files, to comply with size limitations.
```plaintext
launcher-home/
├── .unused/
│ ├── launcher-home.png
├── launcher-home.jpg
├── index.en-US.mdx
├── ...
```
--------------------------------
### Date and Time Formatting Examples
Source: https://github.com/inkore-net/documentation/blob/main/CONTRIBUTING.en-US.md
Demonstrates correct and incorrect formatting for dates and times, emphasizing the use of MM/dd/yyyy for short dates and 24-hour clock for time.
```md
Avoid writing like this:
```md
2024.5.2 4:08 | 2nd May 2024 | 2024年5月2日下午4点8分
我买了34个苹果(是红的)和1只鸡【不知道是公鸡 / 还是 / 母鸡】。
```
Instead, write like this for better readability:
```md
05/02/2024 16:08 | May 2nd, 2024 | 5 月 2 日 2024 年,16:08
我买了 34 个苹果 (是红的) 和 1 只鸡 [不知道是公鸡/还是/母鸡]。
```
```
--------------------------------
### Apply Modern Window Style and Backdrop
Source: https://github.com/inkore-net/documentation/blob/main/data/docs/ui-wpf-modern/02.
This snippet demonstrates how to apply a modern style to the main window and set a system backdrop type using attached properties in `MainWindow.xaml`. It requires adding the modern UI namespace.
```xml
```
--------------------------------
### Basic Frame Navigation Example
Source: https://github.com/inkore-net/documentation/blob/main/data/docs/ui-wpf-modern/03. components/08. navigation/
Demonstrates setting up a Frame control in XAML and handling button clicks to navigate between Page1 and Page2 instances using the Navigate(object) method.
```xml
```
```csharp
Page1 Page_1 = new Page1();
Page2 Page_2 = new Page2();
private void Button_NavigateToPage1_Click(object sender, RoutedEventArgs e)
{
Frame_Main.Navigate(Page_1);
}
private void Button_NavigateToPage2_Click(object sender, RoutedEventArgs e)
{
Frame_Main.Navigate(Page_2);
}
```
--------------------------------
### Markdown and MDX Best Practices
Source: https://github.com/inkore-net/documentation/blob/main/CONTRIBUTING.zh-CN.md
Recommendations for writing content using Markdown and MDX, including using headings, emphasis, code formatting, and Docusaurus admonitions.
```APIDOC
Content Writing:
Structure: Use Markdown headings (H1-H3).
Emphasis: Use `*italic*`, `**bold**`, and `` `code` ``.
Admonitions: Utilize Docusaurus admonitions (e.g., `:::note ... :::`).
Language Specifics (Chinese):
- Add spaces between Chinese characters and English/numbers/symbols.
- Use half-width parentheses and brackets, with spaces around them.
- Example:
Correct: `2024 年 5 月 2 日,我买了 34 个苹果 (是红的) 和 1 只鸡 [不知道是公鸡/还是/母鸡]。`
Incorrect: `2024年5月2日,我买了34个苹果(是红的)和1只鸡【不知道是公鸡 / 还是 / 母鸡】。`
```
--------------------------------
### Create and Show a Basic Window
Source: https://github.com/inkore-net/documentation/blob/main/data/docs/ui-wpf-modern/03. components/04. dialogs/
Demonstrates how to create a new window instance and display it using the Show() method. This is a fundamental step for managing multiple windows in a WPF application.
```csharp
var myWindow = new MyWindow();
myWindow.Show();
```
--------------------------------
### Date and Time Formatting Examples
Source: https://github.com/inkore-net/documentation/blob/main/CONTRIBUTING.zh-CN.md
Provides examples of correct and incorrect date and time formatting, emphasizing the use of MM/dd/yyyy for short dates, specific formats for long dates, and 24-hour time.
```plaintext
例如,避免这样写:
```
2024.5.2 4:08 | 2nd May 2024 | 2024年5月2日下午4点8分
我买了34个苹果(是红的)和1只鸡【不知道是公鸡 / 还是 / 母鸡】。
```
相反,为了更好的可读性,请这样写:
```
05/02/2024 16:08 | May 2nd, 2024 | 5 月 2 日 2024 年,16:08
我买了 34 个苹果 (是红的) 和 1 只鸡 [不知道是公鸡/还是/母鸡]。
```
```
--------------------------------
### MCSkinn 首次启动配置
Source: https://github.com/inkore-net/documentation/blob/main/data/docs/mcskinn/02.
首次启动 MCSkinn 时,系统会提示您选择一个用于存放皮肤的目录。选择“是”并指定您的皮肤文件夹。
```text
如果您在这台计算机上是第一次使用 MCSkinn,您将看到以下消息:

是时候添加您的皮肤目录了!点击 **是**,然后选择您准备好的文件夹。
```
--------------------------------
### iNKORE Hub 下载链接
Source: https://github.com/inkore-net/documentation/blob/main/data/docs/mcskinn/02.
如果您想安装 iNKORE Hub 以便管理 MCSkinn,请使用此链接下载。如果已安装,请跳过此步骤。
```html
[下载 **iNKORE Hub**](https://inkore.net/hub-windows)
```
--------------------------------
### Namespace Declaration for Modern UI
Source: https://github.com/inkore-net/documentation/blob/main/data/docs/ui-wpf-modern/02.
This snippet shows the namespace declaration required to use the modern UI components from the Inkore library in WPF applications.
```ini
xmlns:ui="http://schemas.inkore.net/lib/ui/wpf/modern"
```
--------------------------------
### Painting Tools Overview
Source: https://github.com/inkore-net/documentation/blob/main/data/docs/mcskinn/03. overview/03.
Details the functionality of various painting tools, including basic, adjustment, and additional tools.
```APIDOC
Basic Tools:
- Move Tool (Camera Tool, View Tool, Pan Tool): Moves the view. Mouse button behavior varies by viewport mode.
- Draw Tool: Draws pixel blocks. Allows adjusting brush size. Options: Incremental (affects pixel multiple times per click), Brush shape.
- Eraser Tool: Erases drawn content. Allows adjusting brush size.
- Dropper Tool: Picks a color at cursor position. Shift + Click sets background color, otherwise foreground color.
Adjustment Tools:
- Dodge/Burn Tool: Adjusts brightness of colors. Controls intensity via Threshold and brush size.
- Lighten/Darken Tool: Adjusts saturation of colors. Controls intensity via Threshold and brush size.
Additional Tools:
- Fill Bucket: Fills connected areas with a new color. Threshold parameter (0-255) controls color tolerance.
- Noise Tool: Adjusts saturation of colors. Holdness parameter controls noise opacity.
- Stamp Tool: Samples an area and pastes pixels to another position. Shift + Click enters sample mode; otherwise, it's paint mode.
```
--------------------------------
### 从 Microsoft Store 安装 MCSkinn
Source: https://github.com/inkore-net/documentation/blob/main/data/docs/mcskinn/02.
由于 iNKORE Hub 当前不可用,请直接从 Microsoft Store 安装 MCSkinn。点击提供的链接即可开始下载。
```html
```
--------------------------------
### 添加皮肤目录
Source: https://github.com/inkore-net/documentation/blob/main/data/docs/mcskinn/03. overview/02.
在 MCSkinn 中添加一个皮肤目录作为皮肤库的根目录。用户可以通过点击 '+' 按钮并选择文件夹来添加。
```zh
在左侧的 **皮肤目录导航** 区域点击 **+** 按钮,然后会弹出浏览对话框,选择您的文件夹并按 Enter 键,现在您可以在列表的末尾看到这个文件夹。
```
--------------------------------
### Markdown Heading Structure Example
Source: https://github.com/inkore-net/documentation/blob/main/CONTRIBUTING.en-US.md
Demonstrates the correct hierarchical structure for headings in Markdown content, contrasting an incorrect nested list format with the preferred sequential heading format for clarity and proper rendering.
```markdown
## Step 1: Download and Install
### Install iNKORE Hub
You can quickly and conveniently install our product using iNKORE Hub. If you haven't installed iNKORE Hub on your computer yet, click the button below.
```
--------------------------------
### Add Theme Resources to App.xaml
Source: https://github.com/inkore-net/documentation/blob/main/data/docs/ui-wpf-modern/02.
This snippet shows how to add modern theme resources by merging `ThemeResources` and `XamlControlsResources` into the application's resource dictionary in `App.xaml`. It requires adding a specific namespace declaration.
```xml
```
--------------------------------
### 皮肤目录管理操作
Source: https://github.com/inkore-net/documentation/blob/main/data/docs/mcskinn/03. overview/02.
描述了对皮肤目录进行重命名、移动、删除以及添加多个目录的注意事项。强调了不应将目录放在程序安装文件夹中。
```zh
您可以随时重命名或移动此目录。但您需要稍后在 MCSkinn 中删除旧目录并添加新目录。
您可以创建多个目录,如果需要的话。但您需要逐个将它们添加到 MCSkinn 中。
您可以将任何文件放入此目录,但 MCSkinn 将仅加载 PNG 文件,这意味着最好不要放入任何不是 Minecraft 皮肤的 PNG 文件 (如果这样做,MCSkinn 在加载时可能会出现卡顿和其他未知问题) 。
小心,不要将任何皮肤目录放在程序安装文件夹中。一旦应用程序更新,所有内容都将被清除!
```
--------------------------------
### Basic TabControl Example
Source: https://github.com/inkore-net/documentation/blob/main/data/docs/ui-wpf-modern/03. components/08. navigation/
Demonstrates the creation of a simple TabControl with three TabItems, each containing basic text content. This is a fundamental example for understanding TabControl structure.
```xml
```
--------------------------------
### Basic Button Usage
Source: https://github.com/inkore-net/documentation/blob/main/data/docs/ui-wpf-modern/03. components/01. basic-input/
Demonstrates the fundamental usage of a Button control, including setting its content and handling the Click event.
```xml
```
```csharp
private void Button_Click(object sender, RoutedEventArgs e)
{
// Do something when the button is clicked!
}
```
--------------------------------
### MDX Admonition Usage
Source: https://github.com/inkore-net/documentation/blob/main/CONTRIBUTING.zh-CN.md
Highlights the use of Admonitions, an MDX feature provided by Docusaurus, for presenting information clearly and comfortably within documentation content.
```markdown
我们鼓励您在正确的地方使用**告示 (Admonitions)** (一种由 Docusaurus 提供的 MDX 特性),以提供清晰舒适的外观。您可以转到 [admonitions](https://docusaurus.io/zh-CN/docs/markdown-features/admonitions) 来了解更多.
```
--------------------------------
### System Settings Synchronization (.NET vs .NET Framework)
Source: https://github.com/inkore-net/documentation/blob/main/data/docs/ui-wpf-modern/04. features/01. theming/05.
Explains the requirements and implications of synchronizing with system settings for .NET and .NET Framework applications. Highlights platform targeting and dependency differences.
```zh
此库默认与系统的这几个设置保持同步:Theme scheme,accent color,自动隐藏滚动条。其中 自动隐藏滚动条 需要 win11,其他的至少要 win10。.net framework 应用无需任何处理即可保持同步;对于 .net 应用,需要将目标平台设置为 10.0.18362.0 以上才可以使用此功能。请注意,将目标平台设置为 10.0.18362.0 以上会导致你的应用生成目录下多出两个 dll(约 25mb)的依赖(删掉后程序无法启动);而将目标平台设置为 7.0 不会有这两个 dll,但是 1. 同步功能无法运作,2. 项目错误列表中会出现一个警告,这个警告是无害的,忽略即可。<这里说明多出来的两个 dll 是微软 .net 的设计缺陷,因为要和 winrt 交互,撇清关系,我们不背这个锅> 另外即使满足自动同步的条件,你也可以手动指定这些设置。
```
```en
This library is designed to keep in sync with the theme settings of the system. This greatly improves the user experience, as the app will look more native and consistent with the system.
Requirements:
- Theme scheme, accent color: Windows 10 or higher
- Auto-hiding scrollbars: Windows 11 or higher
For .NET Framework applications, no special handling is required.
For .NET applications, the target platform must be set to 10.0.18362.0 or higher to use this feature. Targeting a platform above 10.0.18362.0 will result in two additional DLL dependencies (approx. 25MB) in your application's output directory; the program will not start if these are deleted.
Targeting platform 7.0 will not include these DLLs, but the synchronization feature will not work, and a harmless warning will appear in the project error list.
```
--------------------------------
### Incorrect Markdown Heading Structure
Source: https://github.com/inkore-net/documentation/blob/main/CONTRIBUTING.zh-CN.md
Illustrates an incorrect method of using nested numbering for headings in Markdown, which does not produce the desired hierarchical structure for documentation.
```markdown
```md
1. 下载和安装
1.1 安装 iNKORE Hub
您可以通过使用 iNKORE Hub 快速便捷地安装我们的产品。如果您的计算机上尚未安装 iNKORE Hub,请单击下面的按钮...
安装完 iNKORE Hub 后,您的开始菜单中应该会有一个类似这样的快捷方式。
1.2 打开 iNKORE Hub 并下载 MCSkinn
在开始菜单的程序中点击 "iNKORE Hub"。初始化后,点击左侧面板中的"产品"选
如果弹出任何错误消息,您应该检查您的网络连接、防病毒软件和系统环境。如果这些方法都无效,请联系支持 (studios@inkore.net) ,我们很乐意帮助。
2. 开始使用 MCSkinn
2.1 准备工作
在使用 MCSkinn 之前,您需要一个代表您皮肤库的目录。它可以是空的,也可以填充有您的个人皮肤...
```
```
--------------------------------
### 联系支持
Source: https://github.com/inkore-net/documentation/blob/main/data/docs/mcskinn/02.
如果在安装或使用 MCSkinn 过程中遇到任何问题,可以通过此电子邮件地址联系支持团队寻求帮助。
```email
studios@inkore.net
```
--------------------------------
### Basic NavigationView Example
Source: https://github.com/inkore-net/documentation/blob/main/data/docs/ui-wpf-modern/03. components/08. navigation/
Demonstrates the fundamental structure of a NavigationView with menu items and a content area. It showcases how to define navigation links with icons.
```xml
```