From b3252d21861c94d081b192c6eed4bd9e4e77fab5 Mon Sep 17 00:00:00 2001
From: alex <alex@alexdeMacBook-Pro.local>
Date: Mon, 13 Mar 2023 17:43:06 +0800
Subject: [PATCH] =?UTF-8?q?=E7=BF=BB=E8=AF=91openKylin=E7=94=A8=E6=88=B7?=
 =?UTF-8?q?=E6=89=8B=E5=86=8C=E5=8E=9F=E7=90=86=E8=A7=A3=E6=9E=90.md?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .DS_Store                                     | Bin 0 -> 6148 bytes
 en/.DS_Store                                  | Bin 6148 -> 8196 bytes
 ...penKylin user manual principle analysis.md |  61 ++++++++++++++++++
 3 files changed, 61 insertions(+)
 create mode 100644 .DS_Store
 create mode 100755 en/Xiao Bai Course/OpenKylin user manual principle analysis.md

diff --git a/.DS_Store b/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..00617d29895525be72f045ff8e51b1d5ede96698
GIT binary patch
literal 6148
zcmeHKQA@)x5Kgw~I)>N>1$`^{I&jYE6kp1mf53`9IGL?2TC9z%-3E?A-{&9lkN9)M
zyCemN!$%Q!2g!HI-KDt?n&cQ`ygTyu7&94T1~f#D$^yaZg{G2rE(3C0!;6Fm`kVJ0
zh1&Ml0ry^F0gJs!^89uGN!o0_^HRC8vRXB&M%}n^9>l~+-E@?6-QhKkE`*4@LU+B(
zFqjO?jZ+b)ZWsqc84&sbxb&~W*cX$o7{z`fV;yBMYDR5fZcnGJ)?vG0?YBBv!<rtq
zK|ea^WLeGF+}S-jA3R1+v6v|~Igl-7O=AJCpvYv#&M=Ndd=F#vt@PK&+3e$`?k9JV
z2b(Se2#En=fEXYKmXQH{jTrT1OrCNk28e+l8Nl<wf`({o%oWO`13Fm(09IgH3g}o%
zV2q{F)|e{<3kX-CfGU*h5`(L7n76c_tua@q!Wq}a2iIRNiWe@w4(nUeopD<s^~3-%
zFwX$iz91&v|7Y;aEG+V+3w6W*G4Nj*;FX@!>q2(=ZvB=g-nACATWBcgm!kp#`rIP`
j26&EaNu#n`sDq!aF;|GI;Jge6q=$ecggRp27Z~^itFBLz

literal 0
HcmV?d00001

diff --git a/en/.DS_Store b/en/.DS_Store
index eb4723e0c570ddf8df46930c78002a71d6466e46..6eca08edac428bebacb1ea524ad1cd5378cba771 100644
GIT binary patch
delta 498
zcmZoMXmOBWU|?W$DortDU;r^WfEYvza8E20o2aMA$h$FMH}hr%jz7$c**Q2SHn1@A
zZsuW8X42+oh+xQMNMy)oP+)KZ(wRWo8OSSTC}JpPNKGm)E=bDBPXd~?YqASVp{7)I
zwUM!jfsTTqnQ5(#LbaiRiMft~g`r7pEhmSlvc7dte0EN5UVhKyJ1p|`y+C~gY)C0i
z&PmG8&tW92G$-9KI5|JJ0H_iM@EcyAnw#(90(Cz}=Ijok$@h;q0`=n82Go^8hOUAP
zbm!?1vZyS$C@&{JFCFM4#?7`o7n!*vxPfd}P|R%><oM1!nP0?nvOf<82QYX*k;<?+
Io@Wj-0OYl2=Kufz

delta 104
zcmZp1XfcprU|?W$DortDU=RQ@Ie-{Mvv5r;6q~50$jG)aU^g=(+h!gCWu}cKHy9VQ
qb8rYU162Tl05_0u1u5QG_?>w&zl<kHD+3e67?8;fo8x)rFarQ`77!T#

diff --git a/en/Xiao Bai Course/OpenKylin user manual principle analysis.md b/en/Xiao Bai Course/OpenKylin user manual principle analysis.md
new file mode 100755
index 0000000..475b5ef
--- /dev/null
+++ b/en/Xiao Bai Course/OpenKylin user manual principle analysis.md	
@@ -0,0 +1,61 @@
+
+ *[Xiaobai Course] Analysis of the principles of the openKylin User Manual, one trick to teach you how to customize! **
+
+The openKylin user manual is a manual that describes the functions and user interface of the openKylin operating system in detail, allowing users to understand how to use the software. By reading the openKylin user manual, you can get started and use the openKylin operating system faster and better. Today, I will take you to briefly understand the implementation principle of the openKylin user manual and how to customize the content of the user manual.
+
+![图片](https://www.openkylin.top/upload/202301/1673400351868967.png)
+
+1. Introduction to the realization principle of the user manual
+
+1.1 Introduction to QtWebkit The start, display, and jump of the user manual on the openKylin operating system are realized on the basis of QtWebkit. Let's briefly introduce QtWebkit. The QtWebkit module provides an engine for using web browser in qt, which makes it easy for us to use the content on the World Wide Web in qt applications, and the control of its web content can also be realized through native controls. QtWebKit provides tools for rendering Hypertext Markup Language (HTML), Extensible Hypertext Markup Language (XHTML), and Scalable Vector Graphics (SVG) documents, which are styled using Cascading Style Sheets (CSS) and written in JavaScript script.
+
+1.2 The user manual jump interface In order to facilitate the user to jump to the help document of the corresponding component, the user manual provides an interface, so that after other components call the interface to pass parameters, they can directly open the corresponding content of the user manual, and the component can be clicked on F1 and the menu - help option to make the call. DaemonIpcDbus::showGuideDaemonIpcDbus::showGuide provides a dbus interface, the component only needs to pass the corresponding parameters to call, and the manual will open the user manual according to the parameters and jump to the corresponding content.
+
+1.3 User Manual Operation Process The user manual jump interface is introduced above, and the following will focus on the general process of user manual operation.
+
+First, you need to instantiate QWebView, enable and disable some settings, and load the user manual webpage file.
+
+![图片](https://www.openkylin.top/upload/202301/1673400403559673.png)
+
+![图片](https://www.openkylin.top/upload/202301/1673400415449881.png)
+
+Secondly, send a signal when loading html, and pass the QObject object to JS, so that JS can call the public slots function of QObject.
+
+![图片](https://www.openkylin.top/upload/202301/1673400425220458.png)
+
+![图片](https://www.openkylin.top/upload/202301/1673400459129591.png)
+
+![图片](https://www.openkylin.top/upload/202301/1673400473845933.png)
+
+Thirdly, the web end calls the qt interface to obtain document information and directory structure, and dynamically generates the home page application. The js side calls the qt side function to obtain information:
+
+![图片](https://www.openkylin.top/upload/202301/1673400482997460.png)
+
+Finally, the qt side obtains the manual file structure, obtains the icon name and folder name of the homepage, and the corresponding document path:
+
+![图片](https://www.openkylin.top/upload/202301/1673400491336760.png)
+
+Through the obtained image name, document path, folder name; loading icon information, complete the loading of the home page application. The loading process of the homepage of the openKylin user manual is roughly as described above, but it also involves the rendering and display of Markdown files, the follow-up effect of directories and content; jumping at the directory level of the manual; automatically reading the update date of the document, etc., here I won't introduce them one by one.
+
+2. User manual content customization
+
+When you integrate new components in the system, you hope that after adding new components, the content of the corresponding component manual will be automatically added to the user manual and be able to jump; then here is an introduction to how to integrate your own manual content!
+
+2.1 Folder Structure
+
+![图片](https://www.openkylin.top/upload/202301/1673400502196692.png)
+
+ull Requ needs to contain a language folder and an icon; the folder name and the icon name are consistent, and will be used for home page icon display and user manual dbus interface call parameters.
+
+2.2 Markdown older Structure
+
+![图片](https://www.openkylin.top/upload/202301/1673400514730147.png)
+
+Here, the first-level title of the Markdown document will be used as the display name of the homepage application.
+
+2.3 Modify the Install File
+
+![图片](https://www.openkylin.top/upload/202301/1673400526886467.png)
+
+Put the prepared folder under the resource file of the user manual. When the user manual is loaded, it will be automatically read, loaded and displayed on the home page. Follow the above steps to complete the customization of the content of the user manual, and realize the simultaneous increase and decrease of the content of the system component manual! Have you learned it?
+
-- 
Gitee