diff --git a/README.md b/README.md index e40541a..9cd8085 100644 --- a/README.md +++ b/README.md @@ -6,4 +6,4 @@ ## 文档目录结构 -[中文文档](zh-cn/doc/JCNC开发者文档.md) \ No newline at end of file +[中文文档](zh-cn/doc/JCNC项目开发流程/JCNC开发者文档/JCNC开发者文档.md) \ No newline at end of file diff --git a/zh-cn/doc/JCNC开发者文档.md b/zh-cn/doc/JCNC开发者文档.md deleted file mode 100644 index 7ae3030..0000000 --- a/zh-cn/doc/JCNC开发者文档.md +++ /dev/null @@ -1,18 +0,0 @@ -# JCNC开发者文档 - -本目录是JCNC开发者文档的中文目录。目录内容包括: - -### 新手指南 - -[第一次接触开源项目?](第一次接触开源项目.md) - -[Git常用命令](Git常用命令.md) - -[JCNC项目开发流程](JCNC项目开发流程/JCNC项目开发流程/JCNC项目开发流程.md) - -### 项目文档 - -[JNotepad文档](https://gitee.com/jcnc-org/JNotepad/blob/release-v1.1.13/README.md) - - -### 欢迎补充和修复文档! diff --git a/zh-cn/doc/Git常用命令.md b/zh-cn/doc/JCNC项目开发流程/Git常用命令/Git常用命令.md similarity index 100% rename from zh-cn/doc/Git常用命令.md rename to zh-cn/doc/JCNC项目开发流程/Git常用命令/Git常用命令.md diff --git a/zh-cn/doc/JCNC项目开发流程/JCNC开发者文档/JCNC开发者文档.md b/zh-cn/doc/JCNC项目开发流程/JCNC开发者文档/JCNC开发者文档.md new file mode 100644 index 0000000..0a85da6 --- /dev/null +++ b/zh-cn/doc/JCNC项目开发流程/JCNC开发者文档/JCNC开发者文档.md @@ -0,0 +1,20 @@ +# JCNC开发者文档 + +本目录是JCNC开发者文档的中文目录。目录内容包括: + +## 新手指南 + +[第一次接触开源项目?](../第一次接触开源项目/第一次接触开源项目.md) + +[Git常用命令](../Git常用命令/Git常用命令.md) + +## 项目文档 + +[JNotepad开发者文档](../JNotepad项目文档/JNotepad开发者文档.md) + +[JCNC项目开发流程](../JCNC项目开发流程/JCNC项目开发流程.md) + +[JNotepad文档](https://gitee.com/jcnc-org/JNotepad/blob/release-v1.1.13/README.md) + + +## 欢迎补充和修复文档! diff --git a/zh-cn/doc/JCNC项目开发流程/JNotepad项目文档/JNotepad开发者文档.md b/zh-cn/doc/JCNC项目开发流程/JNotepad项目文档/JNotepad开发者文档.md new file mode 100644 index 0000000..3340afb --- /dev/null +++ b/zh-cn/doc/JCNC项目开发流程/JNotepad项目文档/JNotepad开发者文档.md @@ -0,0 +1,15 @@ +# JNotepad 开发者文档 +欢迎使用 JNotepad 开发者文档。借助这些文档,您可以了解如何使用、开发和打包[JNotepad](https://gitee.com/jcnc-org/JNotepad) 。 + +## 新手指南 +如果您是首次接触 JavaFX,并希望开始编写代码,请从[构建首个 JavaFX 应用](../构建首个JavaFX应用/构建首个JavaFX应用.md)教程开始。 + +此外,请通过查看下面的其他资源或社区来学习 JNotepad 开发: + +- [JavaFX 官网](https://openjfx.io/) +- [JavaFX API](https://openjfx.io/javadoc/21/) +- [QQ 交流群](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=x3QF-jrJAKTiwu8kV5-giBk2ow66Kzyr&authKey=qNqrQauD7Ra4fXH%2Ftu4ylHXCyrf2EOYj9oMYOmFjlzYmrgDL8Yd0m2qhrQQEBL25&noverify=0&group_code=386279455) + +## 基础知识 + +- [JavaFX基础知识](https://openjfx.io/) \ No newline at end of file diff --git a/zh-cn/doc/JCNC项目开发流程/JNotepad项目文档/JNotepad项目文档.md b/zh-cn/doc/JCNC项目开发流程/JNotepad项目文档/JNotepad项目文档.md deleted file mode 100644 index 50134c0..0000000 --- a/zh-cn/doc/JCNC项目开发流程/JNotepad项目文档/JNotepad项目文档.md +++ /dev/null @@ -1,11 +0,0 @@ -# 开发者指南 - -欢迎使用 JNotepad 开发者指南。借助这些文档,您可以了解如何使用和开发 JNotepad 。 - -如果您是首次接触 JavaFX,并希望开始编写代码,请从[构建首个 JavaFx 应用](../构建首个JavaFx应用.md)教程开始。 - -此外,请通过查看下面的其他资源来学习 JavaFX 开发: - -- [JavaFX官网](https://openjfx.io/) -- [JavaFX API](https://openjfx.io/javadoc/21/) - diff --git a/zh-cn/doc/JCNC项目开发流程/JavaFX基础知识/JavaFX基础知识.md b/zh-cn/doc/JCNC项目开发流程/JavaFX基础知识/JavaFX基础知识.md new file mode 100644 index 0000000..36e9679 --- /dev/null +++ b/zh-cn/doc/JCNC项目开发流程/JavaFX基础知识/JavaFX基础知识.md @@ -0,0 +1,28 @@ +# JavaFX基础知识 + +JavaFX是Java平台上的一个框架,用于创建跨平台、富客户端应用程序。它提供了丰富的UI控件、布局管理器、事件处理机制、动画效果、图形渲染等功能,使得开发者可以轻松地构建出各种漂亮的用户界面,并实现复杂的交互逻辑。 + +JavaFX 组织架构图: +![img.png](img.png) +1. 场景(Scene)和节点(Node) + JavaFX应用程序由一个或多个场景组成,每个场景包含了多个节点。节点可以是控件(如按钮、文本框等)或图形元素(如矩形、圆形等)。场景和节点的概念使得JavaFX应用程序的用户界面可以被分为多个层次,从而更加灵活地进行布局和设计。 + +JavaFX应用的程序基本结构: +![img_1.png](img_1.png) +2. FXML + JavaFX应用程序使用FXML文件来描述用户界面。FXML是一种基于XML的标记语言,它定义了用户界面的结构和外观,以及与之相关联的Java控制器。FXML使得界面设计和代码编写可以分别进行,从而使得开发者可以更好地组织和管理代码。 + +3. 布局管理器(Layout Manager) + JavaFX提供了多种布局管理器,例如VBox、HBox、BorderPane等。这些布局管理器可以帮助开发者轻松地实现不同的布局需求,例如垂直、水平、边框式布局等。布局管理器还支持各种对齐方式和填充方式,使得用户界面可以更加美观和规范。 + +4. 动画(Animation) + JavaFX支持动画效果,可以使用Timeline类和KeyFrame类实现。Timeline类用于定义一组关键帧,每个关键帧包含了一个节点属性和其对应的值。KeyFrame类用于定义某个时间点上的节点属性值,从而形成动画效果。JavaFX的动画效果可以使得用户界面变得更加生动和有趣。 + +5. 事件处理(Event Handling) + JavaFX支持事件处理机制,事件可以是用户输入的鼠标点击、键盘按键等,也可以是系统事件(如窗口大小改变)。JavaFX使用事件处理程序(Event Handler)来响应事件。当事件发生时,相应的事件处理程序会被自动调用,从而可以进行一些操作或响应用户输入。 + +6. UI控件(UI Controls) + JavaFX提供了丰富的UI控件,例如Button、TextField、Label、ComboBox等。这些控件可以大大简化开发者的工作量,使得开发者可以更快地实现各种功能。UI控件还支持样式和主题,使得用户界面可以更加美观和协调。 + +7. 图形渲染和3D图形处理(Graphics Rendering and 3D Graphics) + JavaFX支持图形渲染和3D图形处理,可以创建出各种令人赏心悦目的效果。JavaFX的图形渲染可以使用Canvas类和GraphicsContext类实现,而3D图形处理则可以使用JavaFX的3D API来完成。 diff --git a/zh-cn/doc/JCNC项目开发流程/JavaFX基础知识/img.png b/zh-cn/doc/JCNC项目开发流程/JavaFX基础知识/img.png new file mode 100644 index 0000000..167958c Binary files /dev/null and b/zh-cn/doc/JCNC项目开发流程/JavaFX基础知识/img.png differ diff --git a/zh-cn/doc/JCNC项目开发流程/JavaFX基础知识/img_1.png b/zh-cn/doc/JCNC项目开发流程/JavaFX基础知识/img_1.png new file mode 100644 index 0000000..4638504 Binary files /dev/null and b/zh-cn/doc/JCNC项目开发流程/JavaFX基础知识/img_1.png differ diff --git a/zh-cn/doc/JCNC项目开发流程/构建和打包/构建和打包.md b/zh-cn/doc/JCNC项目开发流程/构建和打包/构建和打包.md new file mode 100644 index 0000000..6d8f628 --- /dev/null +++ b/zh-cn/doc/JCNC项目开发流程/构建和打包/构建和打包.md @@ -0,0 +1 @@ +# 构建和打包 \ No newline at end of file diff --git a/zh-cn/doc/JCNC项目开发流程/构建首个JavaFx应用.md b/zh-cn/doc/JCNC项目开发流程/构建首个JavaFX应用/构建首个JavaFX应用.md similarity index 92% rename from zh-cn/doc/JCNC项目开发流程/构建首个JavaFx应用.md rename to zh-cn/doc/JCNC项目开发流程/构建首个JavaFX应用/构建首个JavaFX应用.md index 8385704..16efbb8 100644 --- a/zh-cn/doc/JCNC项目开发流程/构建首个JavaFx应用.md +++ b/zh-cn/doc/JCNC项目开发流程/构建首个JavaFX应用/构建首个JavaFX应用.md @@ -1,5 +1,4 @@ -# 序言 - +# 构建首个JavaFX应用 构建首个JavaFX应用的文档编写可以分为以下几个步骤。这个示例将创建一个简单的JavaFX应用程序,展示一个包含 "Hello, JNotepad!" 文本的窗口。 示例JavaFX应用开发环境: @@ -34,17 +33,17 @@ 在您的IDE中,创建一个新的JavaFX项目: 1. 打开IDE并选择创建一个新的JavaFX项目。 - ![img.png](JNotepad项目文档/img.png) + ![img.png](../JNotepad项目文档/img.png) 2. 配置项目名称和存储位置。 - ![img_1.png](JNotepad项目文档/img_1.png) + ![img_1.png](../JNotepad项目文档/img_1.png) 3. 点击下一步。 - ![img_2.png](JNotepad项目文档/img_2.png) + ![img_2.png](../JNotepad项目文档/img_2.png) 4. 点击创建 - ![img_3.png](JNotepad项目文档/img_3.png) + ![img_3.png](../JNotepad项目文档/img_3.png) 5. 删除初始化代码 - ![img_4.png](JNotepad项目文档/img_4.png) + ![img_4.png](../JNotepad项目文档/img_4.png) 6. 新建项目完毕 - ![img_7.png](JNotepad项目文档/img_7.png) + ![img_7.png](../JNotepad项目文档/img_7.png) # 步骤3:编写JavaFX应用程序代码 @@ -174,13 +173,13 @@ pom.xml: # 步骤4:运行应用程序 在IDE中,右键文本编辑区,选择运行(Run)或者调试(Debug)您的JavaFX应用程序。这将启动JavaFX应用程序,并显示一个窗口,其中包含 "Hello, JavaFX!" 文本。 -![img_6.png](JNotepad项目文档/img_6.png) -![img_8.png](JNotepad项目文档/img_8.png) +![img_6.png](../JNotepad项目文档/img_6.png) +![img_8.png](../JNotepad项目文档/img_8.png) # 步骤5:构建和打包 目前为止您的JavaFX应用程序编写完成,您可以构建它并打包到目标平台分发。 - [构建和打包(构建中...)]() + [构建和打包(构建中...)](../构建和打包/构建和打包.md) # 总结 完成以上步骤后,您就成功构建了一个简单的JavaFX应用程序。您可以根据项目的需求进行扩展和改进,添加更多的UI元素和功能。希望这份文档可以帮助您入门JavaFX应用程序的开发。 diff --git a/zh-cn/doc/第一次接触开源项目.md b/zh-cn/doc/JCNC项目开发流程/第一次接触开源项目/第一次接触开源项目.md similarity index 98% rename from zh-cn/doc/第一次接触开源项目.md rename to zh-cn/doc/JCNC项目开发流程/第一次接触开源项目/第一次接触开源项目.md index 21ab155..4e53a96 100644 --- a/zh-cn/doc/第一次接触开源项目.md +++ b/zh-cn/doc/JCNC项目开发流程/第一次接触开源项目/第一次接触开源项目.md @@ -15,7 +15,7 @@ * 提交: 提交是对代码所做更改的快照,它包含有关更改内容的说明。 * 拉取请求(Pull Request): 这是将您的更改合并到主代码库的方式,维护者和其他贡献者可以审查并提供反馈。 - [Git常见命令](Git常用命令.md) + [Git常见命令](../Git常用命令/Git常用命令.md) ## 3. 选择一个适合的开源项目