Skip to content
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
8 changes: 4 additions & 4 deletions CONTRIBUTING.en-US.md
Original file line number Diff line number Diff line change
Expand Up @@ -101,7 +101,7 @@ launcher-home/

### Space between latin and other characters

For some language-specified documents (e.g. Chinese), it's essential to use spaces between [Chinese] and [English/letters/numbers/minor-symbols].
For some language-specified documents (e.g. Chinese), it's essential to use spaces between [Chinese] and [English/letters/numbers/minor-symbols].

### Always use English symbols (with exceptions)

Expand All @@ -113,15 +113,15 @@ For short date, please use `MM/dd/yyyy` format (e.g `05/02/2024`). for long date

For time, always follow `HH:mm` or `HH:mm:ss` rule (e.g. `16:20`, `08:06:45`). **The military time** (24-hour clock) will always be used.

The rules above applies to all documents and all locales, no matter what language the document is.
The rules above applies to all documents and all locales, no matter what language the document is.

### Example

For example, avoid writing like this:

```md
2024.5.2 4:08 | 2nd May 2024 | 2024年5月2日下午4点8分
我买了34个苹果是红的和1只鸡【不知道是公鸡 / 还是 / 母鸡】。
我买了34个苹果 (是红的) 和1只鸡【不知道是公鸡 / 还是 / 母鸡】。
```

Instead, write like this for better readability:
Expand All @@ -135,7 +135,7 @@ Instead, write like this for better readability:

This guide aims to provide a clear and comprehensive overview of the document structure for (potential) contributors like you. It covers naming conventions, file structure, and specific rules for writing documents.

If you have any questions, you can submit an issue on Github, join our community, or contact us directly via [email](mailto://notyoojun@outlook.com). If there's anything unclear in this article, feel free to tell us or submit a Pull Request. We greatly appreciate your valuable work, which makes the documentation center better!
If you have any questions, you can submit an issue on GitHub, join our community, or contact us directly via [email](mailto://notyoojun@outlook.com). If there's anything unclear in this article, feel free to tell us or submit a Pull Request. We greatly appreciate your valuable work, which makes the documentation center better!

<br/>

Expand Down
22 changes: 11 additions & 11 deletions CONTRIBUTING.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,13 +22,13 @@

每篇文章都有其指定的文件夹,由一个两位数的数字表示 + "." (如果你想手动排序),一个 # 号加空格,再加上 kebab 格式的 slug ~~以及烤肉串盒中的蛞蝓~~组成。举个例子,一篇关于按钮设计的文章会嵌套在文件夹中,如下所示:`02.# button-design`。在列举控件和 API 的时候,我们更倾向于让其根据字母自动排序,就可以写:`# button-design`。

- **文章元数据和内容文件**:在这些文件夹中,`index.meta.yml` 包含以 YAML 格式跨语言共享的元数据。在名为`index.{language_code}.mdx`,每个都包含特定于该语言的前 Front matter 数据。
- **文章元数据和内容文件**:在这些文件夹中,`index.meta.yml` 包含以 YAML 格式跨语言共享的元数据。在名为`index.{language_code}.mdx`,每个都包含特定于该语言的前 Front matter 数据。

关于 Font matter 的更多信息,请参见: [markdown-features#front-matter](https://docusaurus.io/zh-CN/docs/markdown-features#front-matter) 和 [plugin-content-docs#markdown-front-matter](https://docusaurus.io/zh-CN/docs/api/plugins/@docusaurus/plugin-content-docs#markdown-front-matter)。

示例:`index.en-US.mdx`,`index.zh-CN.mdx`

- **图像命名**:文章中的图片应当和 **index.{语言代号}.mdx** 存在同一目录内,并且以简短的 kebab 形式命名,比如 `create-a-new-project.png`。对于屏幕截图和其他较小的图片,请使用 PNG 格式,对于较大的图片,请使用 JPG 或 JPEG 格式。
- **图像命名**:文章中的图片应当和 **index.{语言代号}.mdx** 存在同一目录内,并且以简短的 kebab 形式命名,比如 `create-a-new-project.png`。对于屏幕截图和其他较小的图片,请使用 PNG 格式,对于较大的图片,请使用 JPG 或 JPEG 格式。

示例:`create-new-project.png`,`mountain-view.jpg`

Expand All @@ -40,7 +40,7 @@

MDX 的强大功能可以将内容与其独特功能相结合。使用 Markdown 清晰地重建您的想法,并使用 Markdown 格式强调重要元素,以引导读者更加层次分明地了解信息。

我们鼓励您在正确的地方使用**告示 (Admonitions)** (一种由 Docusaurus 提供的 MDX 特性,以提供清晰舒适的外观。您可以转到 [admonitions](https://docusaurus.io/zh-CN/docs/markdown-features/admonitions) 来了解更多.
我们鼓励您在正确的地方使用**告示 (Admonitions)** (一种由 Docusaurus 提供的 MDX 特性) ,以提供清晰舒适的外观。您可以转到 [admonitions](https://docusaurus.io/zh-CN/docs/markdown-features/admonitions) 来了解更多.

请记住,请为步骤和其他方案使用正确的标题结构。例如,这看起来不太好:

Expand Down Expand Up @@ -121,7 +121,7 @@ launcher-home/

```
2024.5.2 4:08 | 2nd May 2024 | 2024年5月2日下午4点8分
我买了34个苹果是红的和1只鸡【不知道是公鸡 / 还是 / 母鸡】。
我买了34个苹果 (是红的) 和1只鸡【不知道是公鸡 / 还是 / 母鸡】。
```

相反,为了更好的可读性,请这样写:
Expand All @@ -135,7 +135,7 @@ launcher-home/

本指南旨在为 (潜在) 贡献者 (比如正在看这篇文章的你) 提供清晰而全面的文档结构概述。它涵盖了命名方式、文件架构以及编写文档的特定规则。

如果您有任何问题,可以在 Github issues 中~~开票~~提交问题,加入我们的社区,或通过[电子邮件](mailto://notyoojun@outlook.com)直接联系我们。如果有文章有哪里没讲清楚,也可以直接提交 Pull Request。我们非常感谢您的重要工作,这会使文档中心变得更好!
如果您有任何问题,可以在 GitHub issues 中~~开票~~提交问题,加入我们的社区,或通过[电子邮件](mailto://notyoojun@outlook.com)直接联系我们。如果有文章有哪里没讲清楚,也可以直接提交 Pull Request。我们非常感谢您的重要工作,这会使文档中心变得更好!

<br/>

Expand All @@ -155,17 +155,17 @@ launcher-home/
> 如果是文章:02.# article-name
> 前面的数字是显示在侧边栏的序号,接下来有.作为分隔符。
>
> 如果这个文件夹是分类里面有其他文章,那个就在点后面加空格并写分类的slug采用kebab命名格式
> 分类文件夹下应该有_category_.json,_category_.en-US.json,等,他们包含了这一分组的元数据。对于不同语言公用的元数据比如此分类是否默认展开,就会在_category_.json中;对于语言特定的元数据比如显示名称,描述,就在_category_.{语言代码}.json中。
> 如果这个文件夹是分类 (里面有其他文章) ,那个就在点后面加空格并写分类的slug (采用kebab命名格式)
> 分类文件夹下应该有_category_.json,_category_.en-US.json,等,他们包含了这一分组的元数据。对于不同语言公用的元数据 (比如此分类是否默认展开) ,就会在_category_.json中;对于语言特定的元数据 (比如显示名称,描述) ,就在_category_.{语言代码}.json中。
> 这个文件中可以写的内容请详见:https://docusaurus.io/zh-CN/docs/sidebar/autogenerated#category-item-metadata
>
> 如果这个文件夹是单个文章,那么文件名在序号和点之后应该有一个#号,并且#和slug之间有空格。对于单个文章的文件夹,里面应该有index.meta.yml单篇文章共用元数据,和内容index.{语言代号}.mdx如index.en-US.mdx和index.zh-CN.mdx。对于不同语言公用的元数据,就会在index.meta.yml中以yaml格式存储;队医单个语言特定的元数据,则存储在index.{语言代号}.mdx的front matter中。关于元数据请参见:https://docusaurus.io/zh-CN/docs/markdown-features#front-matter 和 https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-content-docs#markdown-front-matter。
> 如果这个文件夹是单个文章,那么文件名在序号和点之后应该有一个#号,并且#和slug之间有空格。对于单个文章的文件夹,里面应该有index.meta.yml (单篇文章共用元数据) ,和内容index.{语言代号}.mdx (如index.en-US.mdx和index.zh-CN.mdx) 。对于不同语言公用的元数据,就会在index.meta.yml中以yaml格式存储;对于单个语言特定的元数据,则存储在index.{语言代号}.mdx的front matter中。关于元数据请参见:https://docusaurus.io/zh-CN/docs/markdown-features#front-matter 和 https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-content-docs#markdown-front-matter。
> 文章中的图片应当和index.{..}.mdx存在同一目录内,并且以简短的kebab形式命名,比如 create-a-new-project.png。对于屏幕截图和其他较小的图片,请使用png格式,对于较大的图片,请使用jpg格式。
>
> 文章内采用mdx格式进行编写,建议积极使用MDX的特殊功能,如告示https://docusaurus.io/zh-CN/docs/markdown-features/admonitions
> 文章内采用mdx格式进行编写,建议积极使用MDX的特殊功能,如告示 (https://docusaurus.io/zh-CN/docs/markdown-features/admonitions)
> 请严格按照markdown的1-3级标题规划文章结构,并在合适的位置使用****,``,**,等markdown格式,这样能让读者更好地分清重点。
>
> 在编写中文文章时,请一定要注意在 [中文] 和 [英文/字母/数字/半角符号] 中使用空格。所有括号请使用半角符号,并在括号的外侧各添加一个空格。斜线可以不加空格
> 比如错误示范:2024年5月2日,我买了34个苹果是红的和1只鸡【不知道是公鸡 / 还是 / 母鸡】。
> 在编写中文文章时,请一定要注意在 [中文] 和 [英文/字母/数字/半角符号] 中使用空格。所有括号请使用半角符号,并在括号的外侧各添加一个空格。 (斜线可以不加空格)
> 比如错误示范:2024年5月2日,我买了34个苹果 (是红的) 和1只鸡【不知道是公鸡 / 还是 / 母鸡】。
> 正确示范:2024 年 5 月 2 日,我买了 34 个苹果 (是红的) 和 1 只鸡 [不知道是公鸡/还是/母鸡]。
> ```
Original file line number Diff line number Diff line change
Expand Up @@ -11,9 +11,9 @@ New link: https://github.com/iNKORE-NET

{/* truncate */}

This transition will affect all the existing links or references to our organization on Github. We recommend updating your bookmarks and favorites to reflect the new name.
This transition will affect all the existing links or references to our organization on GitHub. We recommend updating your bookmarks and favorites to reflect the new name.

We believe this change will enhance our online visibility and make it easier for people to engage with us on Github. We look forward to continuing to share our projects and collaborate with others in the open-source community under our new name.
We believe this change will enhance our online visibility and make it easier for people to engage with us on GitHub. We look forward to continuing to share our projects and collaborate with others in the open-source community under our new name.

Best regards,
NotYoojun.! from iNKORE Studios
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,9 +11,9 @@ tags: [工作室, 名称, 用户名, 社交, 公告]

{/* truncate */}

此转换将影响 Github 上对我们组织的所有现有链接或引用。我们建议您更新书签和收藏夹以反映新名称。
此转换将影响 GitHub 上对我们组织的所有现有链接或引用。我们建议您更新书签和收藏夹以反映新名称。

我们相信这一变化将提高我们的在线知名度,并使人们更容易在 Github 上与我们互动。我们期待继续分享我们的项目,并以我们的新名称与开源社区中的其他人合作。
我们相信这一变化将提高我们的在线知名度,并使人们更容易在 GitHub 上与我们互动。我们期待继续分享我们的项目,并以我们的新名称与开源社区中的其他人合作。

此致敬意
NotYoojun.! 来自 iNKORE Studios
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -37,13 +37,13 @@ https://github.com/iNKORE-NET/UI.WPF.Modern

### Background

I remember when I just started our studio's first desktop application, I decided to use WPF for development, but the interface that Microsoft made for WPF... it's really hard to judge. After several hours, I found a project called ModernWpf on Github. The controls in it are all in the style of Windows 10, and at this time Windows 11 has been released, so I was thinking, is there a control library in the style of Windows 11? Later I found a branch repository of ModernWpf, and the controls in it are in the style of Windows 11.
I remember when I just started our studio's first desktop application, I decided to use WPF for development, but the interface that Microsoft made for WPF... it's really hard to judge. After several hours, I found a project called ModernWpf on GitHub. The controls in it are all in the style of Windows 10, and at this time Windows 11 has been released, so I was thinking, is there a control library in the style of Windows 11? Later I found a branch repository of ModernWpf, and the controls in it are in the style of Windows 11.

The author of this fork is one of the main characters in this incident, let's just call him Whatwhat. I looked at the license of this library, it was (and is) the MIT license, so I forked this library and started my control library journey. Before I started my control library, I also tried to connect with the original author Whatwhat, to begin with he wanted me to join his ModernWpf project. Whatwhat's idea is "porting UWP", while my idea is "creating WPF", so we fell out.

After that, I started my control library journey, I named this library iUWM, the purpose of this library is to make it easier for WPF developers to use Windows 11 style controls. I added a lot of my own ideas to this library, such as control styles, control behaviors, etc., for example, I gave users the ability to completely control the window title bar height and buttons, which Whatwhat thought should not exist.

At first, I wrote this library mainly for myself and the studio's projects, so I casually made the repository public on Github, but I didn't expect this repository to be discovered quickly, and now it has a considerable number of stars and usage. I am very happy and proud. However, Whatwhat does not buy it, he thought that this library is his fork library, and I should continue to use the name of ModernWpf instead of iUWM.
At first, I wrote this library mainly for myself and the studio's projects, so I casually made the repository public on GitHub, but I didn't expect this repository to be discovered quickly, and now it has a considerable number of stars and usage. I am very happy and proud. However, Whatwhat does not buy it, he thought that this library is his fork library, and I should continue to use the name of ModernWpf instead of iUWM.

:::info My judgments

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ tags: ["开源", "利益", "回顾与反思", "社区", "iNKORE.UI.WPF.Modern"]

:::note

**极限省流版 (表达并不准确也不够中立,有时间和心情的话最好看下文):** 开放源代码社区里,我们借鉴了别人的代码 (根据 MIT 许可证完全合法合理吗,除了我们疏忽未将原作者名字进行标注) 做了个衍生作品,我们做得比原作者好(用的人比原作多,收藏数量是原作的十多倍),原作者急眼了,到处去群里爆我们阴阳我们。虽然我们没有按照许可证要求标明原作者,但是我们在事情发生之后第一时间找到了原作者,可是他变本加厉,继续阴阳...
**极限省流版 (表达并不准确也不够中立,有时间和心情的话最好看下文):** 开放源代码社区里,我们借鉴了别人的代码 (根据 MIT 许可证完全合法合理,除了我们疏忽未将原作者名字进行标注) 做了个衍生作品,我们做得比原作者好(用的人比原作多,收藏数量是原作的十多倍),原作者急眼了,到处去群里爆我们阴阳我们。虽然我们没有按照许可证要求标明原作者,但是我们在事情发生之后第一时间找到了原作者,可是他变本加厉,继续阴阳...

:::

Expand Down Expand Up @@ -53,13 +53,13 @@ https://github.com/iNKORE-NET/UI.WPF.Modern

### 前情提要

我记得当时我才开始我们工作室的第一个桌面应用,决定使用 WPF 来开发,但是微软给 WPF 做的界面啊...真是一言难尽。几番摸索,在 Github 上找到了一个名为 ModernWpf 的项目。它里面的控件都是 Windows 10 风格的,正好此时 Windows 11 已经发布了,我就在想,有没有一个控件库是 Windows 11 风格的呢?于是我就找到了 ModernWpf 的一个分支仓库,这个里面的控件库就是 Windows 11 风格的。
我记得当时我才开始我们工作室的第一个桌面应用,决定使用 WPF 来开发,但是微软给 WPF 做的界面啊...真是一言难尽。几番摸索,在 GitHub 上找到了一个名为 ModernWpf 的项目。它里面的控件都是 Windows 10 风格的,正好此时 Windows 11 已经发布了,我就在想,有没有一个控件库是 Windows 11 风格的呢?于是我就找到了 ModernWpf 的一个分支仓库,这个里面的控件库就是 Windows 11 风格的。

这个控件库的作者就是这次事件的主要人物之一,我就称他为 Whatwhat 吧。我看了下这个库的许可证,是 MIT 许可证,我就 fork 了这个库,然后开始了我的控件库之旅。在做自己的控件库之前也和原作者 Whatwhat 交流过,他首先想让我加入他的 ModernWpf 项目。Whatwhat 的想法是 "移植 UWP",而我的想法是 "创造 WPF",于是就谈崩了。

在此之后,我就开始了我的控件库之旅,我将这个库命名为 iUWM,这个库的目的是为了让 WPF 开发者能够更加方便地使用 Windows 11 风格的控件。我在这个库里面加入了很多自己的想法,比如说控件的样式,控件的行为等等,比如,我赋予了用户完全掌控窗口标题栏高度和按钮的能力,这些在 Whatwhat 的眼里是不应该有的。

刚开始我编写此库主要是为了自己和工作室的项目,也就随手把仓库公开在 Github 上,没想到这个仓库很快被人发现,现在已经相当数量的 star 和使用量了。我很开心,也很自豪,但是 Whatwhat 对此并不买账,他认为我这个库是他的分支库,我应该继续使用 ModernWpf 的名字,而不是 iUWM。
刚开始我编写此库主要是为了自己和工作室的项目,也就随手把仓库公开在 GitHub 上,没想到这个仓库很快被人发现,现在已经相当数量的 star 和使用量了。我很开心,也很自豪,但是 Whatwhat 对此并不买账,他认为我这个库是他的分支库,我应该继续使用 ModernWpf 的名字,而不是 iUWM。

:::info 我的评判

Expand Down
Loading