your username пре 6 година
родитељ
комит
3f30977946

+ 3 - 2
docs/lang/zh-HK/0.md

@@ -3,14 +3,15 @@
 
 <img src="https://img.shields.io/badge/組建-社群版本-brightgreen"> <img src="https://img.shields.io/badge/裝置-Raspberry%20Pi%203B%2B%20%2F%204B-red"> <img src="https://img.shields.io/badge/香港制造-Hong%20Kong-blueviolet">
 
-# ArOZ Online系統 / 雲端A
+# ArOZ Online / 雲端A
 這是一個特別設計給 Raspberry Pi 開發板專用的,並帶有網頁桌面的雲端系統。你可以使用它來進行雲端影音串流、資料儲存、文書及文字處理、3D打印檔案預覽、雲端編程界面等。
 
 ## 下載映像檔
 如果你是一般使用者,你可以使用以下連結來取得已壓縮好的 Raspberry Pi 映像檔:
+
 [傳送門](https://hkwtc.org/aroz_online/dist/)
 
 下載完後可按左上方的下一頁按鈕以繼續安裝教學。
 
 ## 開發人員說明
-如果你是開發人員而且對開發 ArOZ 在線應用程式感興趣,請直接翻到開發人員說明一項
+如果你是開發人員而且對開發 ArOZ 在線應用程式感興趣,請直接翻到開發人員說明。

+ 7 - 4
docs/lang/zh-HK/1.md

@@ -2,6 +2,7 @@
 <img class="ts fluid image" src="img/quickstart.png">
 # 快速入門
 此入門說明書是已假設你已經擁有使用電腦的基本知識。此教學是基於 Windows 作業系統設計。
+
 你需要以下硬件以架設一個 ArOZ 系統雲端
 - Raspberry Pi (建議 3B+ 或 4B)
 - WiFi USB 手指 或 能連接區域網絡的網絡線及接頭
@@ -9,7 +10,6 @@
 - 電源供應 (Raspberry Pi 用)
 - 客戶端裝置(手機、平板或電腦,需要有 WiFi 連接功能 / 跟 Raspberry Pi 位於同一區域網內)
 
-
 ## 寫入映像檔到 SD 卡
 
 首先,你需要下載 Win32 Disk Imager 及 ArOZ Online系統 Raspberry Pi 用映像檔。下載後請按屏幕上的步驟進行安裝。
@@ -51,10 +51,13 @@
 ### 使用 WiFi AP 連接
 如果你是使用 WiFi AP 設定,請打開電腦或手機之 WiFi 掃描器,並連接至以下 SSID
 
+```
 SSID: 
-<code> ArOZ Portable </code>
-密碼:
-<code>arozportablesystem</code>
+ArOZ Portable
+
+Password:
+arozportablesystem
+```
 
 打開瀏覽器並進入 <code>http://192.168.4.1</code>。你即可看到 ArOZ 系統啟動器的界面。
 

+ 6 - 0
docs/lang/zh-HK/10.md

@@ -0,0 +1,6 @@
+["Default Viewer Modules"]
+# Default Viewer Modules
+ArOZ Online System provides a few default viewer modules for simpler file formats. The system currently support opening .pdf, .gcode and .stl file by default using the build in viewer tools come with the system. Hence, even if you remove all WebApp modules, you can still browse these types of files.
+
+Here is an example of the build in default viewer modules.
+![](img/10/0.png)

+ 81 - 0
docs/lang/zh-HK/11.md

@@ -0,0 +1,81 @@
+["MyHost and File Explorer"]
+![](img/11/0.png)
+# MyHost and File Explorer
+ArOZ Online System provides two main way to manage files and drives on the host devices. They are the "MyHost" tool included in the Desktop Module and the "File Explorer" included in the ArOZ Online System Core. In this page, we will introduce you to the two file / drive manager and how to use them to manage your files on the Host Device.
+
+
+## MyHost
+MyHost is a disk management tool included in the Desktop Module. It shows all the local disk and *remote disk* information on the ArOZ Online System. 
+
+*Remote Disk function is only available on the Full Version or aCloudX edition* 
+
+### Local Disk Management
+You can see all the disk mounted on your local file system through the myHost > Host Devices tab. 
+
+If you are hosting on a Linux device like the Raspberry Pi, you would see the drives denoted by the mount points.
+
+![](img/11/5.png)
+
+Or if you are deploying the ArOZ Online System on a Windows based device, you will see the drives are denoted by its drive letter.
+
+![](img/11/1.png)
+
+If you are using the Full Version of aCloud or aCloudX Edition, you will see the following tab by clicking "Network Drives" tab. Through this interface, you can access network location with tokens generated beforehand.
+
+![](img/11/3.png)
+
+### Media Discovery
+MyHost also provide basic media discovery interface for finding files or documents through out the internal storage spaces. 
+
+![](img/11/4.png)
+
+### Read Only File Viewer
+ArOZ Online System by default do not allow access out of the ArOZ Online Root (AOR). Hence, for all the files outside of AOR, it is either read-only nor not readable. The MyHost provide an interface for listing files in different directory but do not allow starting or browsing their contents.
+
+![](img/11/2.png)
+
+## File Explorer
+File Explorer is the most important service in the ArOZ Online System. It provides file system bridging function to the underlaying Linux file system, allow users to open, copy, move, and create files and folders. 
+
+Here is an example of the File Explorer interface under VDI mode.
+
+![](img/11/6.png)
+
+### UMFilename - Upload Manager File Naming Methods
+Some filename uploaded to the ArOZ Online System contains wierd, unsupported characters. This might cause by many different reasons like OS upgrade, opening ArOZ Online with a computer that use different lanuages or file copy and paste from a Linux PC to a Windows PC. To solve this issue, we used a new naming method called "umfilename" and "hexfoldername" method. As their name suggest, it is very simple to understand.
+
+<table class="ts table">
+<thead>
+<tr>
+<th>File Naming Method</th>
+<th>Encode Method</th>
+<th>Represent Color</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>Default (UTF-8)</td>
+<td>None</td>
+<td>White</td>
+</tr>
+<tr>
+<td>UM-Filename</td>
+<td>"inith" + bin2hex({original_filename}) + "." + {original_ext}</td>
+<td>Blue</td>
+</tr>
+<tr>
+<td>HEX-Foldername</td>
+<td>bin2hex({original_foldername})</td>
+<td>Green</td>
+</tr>
+</tbody>
+</table>
+
+However in the ArOZ Online File Explorer, all the filenames and foldername will be shown in "human readable format". Hence, color code is used to seperate between different encoded names. Here is an example with hexfoldername and umfilename.
+
+![](img/11/8.png)
+
+### More Functions
+File Explorer also provide more functions other than file operations. For example, zip and download, file properties viewing and **Default Opening Module** for a particular file extension. More about **Default Opening Module** will be documented in the Developer sections.
+
+![](img/11/9.png)

+ 3 - 3
docs/lang/zh-HK/6.md

@@ -1,6 +1,6 @@
 ["系統要求"]
 # 系統要求
-ArOZ Online的系統要求十分低。 在絕大部份情況下,系統只需要<500MB的存儲空間和<150MB的RAM。 以下是可用作ArOZ Online的置列表。
+ArOZ Online對系統要求十分低。 在大部份情況下,系統只需要<500MB的存儲空間和<150MB的RAM。 以下是可用作ArOZ Online的置列表。
 
 ### 伺服器端(硬件)
 
@@ -10,7 +10,7 @@ ArOZ Online的系統要求十分低。 在絕大部份情況下,系統只需
 #### 建議要求:
 
 2.2GHz或更快的 x86 / x64 中央處理器, 4GB RAM and 64GB 存儲空間
-(己於Raspbian on Raspberry Pi Zero W, Pi 3B+,  己安裝Intel x86 和 x64 處理器的Debian Jessie系統)
+(己於Raspbian on Raspberry Pi Zero W, Pi 3B+,  己安裝Intel x86 和 x64 處理器的Debian Jessie系統中測試)
 ### 伺服器端(軟件)
 
 Raspbian scratch / Debian Jessie / Debian Stretch 系統與 Apache 網頁伺服器及PHP 5.0或更高(建議 PHP 7.2), wpa_supplicant, net-tools, Python 3.4 (或更高)
@@ -18,7 +18,7 @@ Raspbian scratch / Debian Jessie / Debian Stretch 系統與 Apache 網頁伺服
 可選: apache mod_XSendFile, php_gd, libav (ffmpeg), samba
 
 ### 客戶端
-任何可以運行Chrome / Firefox / Safari的裝置(Android 8.0 Webview,Firefox和Chrome,MacOS High Sierra上的Safari,Windows 7,8.1,10上的Chrome,Firefox,Edge(部分支援)己通過測試證實可兼容
+任何可以運行Chrome / Firefox / Safari的裝置(Android 8.0 Webview,Firefox和Chrome,MacOS High Sierra上的Safari,Windows 7,8.1,10上的Chrome,Firefox,Edge(部分支援)己通過測試)
 
 
 ### 網絡要求

+ 6 - 5
docs/lang/zh-HK/7.md

@@ -1,4 +1,5 @@
 ["系統架構"]
+# System Structure
 ArOZ Online是採用全模塊化設計的系統。本系統同時預載了一系列用於核心功能的模組或腳本,詳細資訊如下表所示。
 
 <table class="ts table">
@@ -40,9 +41,9 @@ ArOZ Online是採用全模塊化設計的系統。本系統同時預載了一系
 </tbody>
 </table>
 
-腳本位於一個名為"Web Module"資料夾中。 而腳本將為整個系統提供服務。 用戶可以使用程式管理或上載功能去安裝任何的WebApp,類似於智能手機上的Play Store或Apple Store,安裝的軟件也可以通過程式管理輕鬆刪除。
+腳本位於一個名為"Web Module"資料夾內並為系統提供不同類型的功能。 用戶可以使用程式管理或上載功能去安裝任何類型的的WebApp,本功能類似於智能手機上的Play Store或Apple Store功能,而所安裝的軟件亦可以通過程式管理輕鬆刪除。
 
-ArOZ Online 的系統內核是建於多層的微服務之上,而ArOZ Online系統的主要元件如下。
+ArOZ Online 的內核是建於多層的微服務之上,而ArOZ Online系統的主要元件如下。
 
 AOauth (including auth.php / login.php etc) + 用戶隔離 (/functions/user/userIsolation.php)
 SystemAOB (AOB 意指 ArOZ Online Base), 部份功能包括: AOR/SystemAOB/functions/
@@ -51,7 +52,7 @@ SystemAOB (AOB 意指 ArOZ Online Base), 部份功能包括: AOR/SystemAOB/funct
 通用型之輸入輸出控制器 (./GPIO)
 系統資訊 (./info)
 WebApp 列表 (./list_menu)
-WebApp 商店 (non-official, ./package_manager)
+WebApp 商店 (非官方, ./package_manager)
 個人化設定 (./personalization)
 電源控制 (./power)
 SMB 設定 (./samba_config)
@@ -61,8 +62,8 @@ SMB 設定 (./samba_config)
 用戶隔離系統 (./user)
 WiFi 管理 (./wifi)
 上傳系統
-以下為所有子系統的視覺化構圖
+以下為子系統的視覺化構圖
 
 ![](img/7/0.png)
 
-上述所有功能己包含於ArOZ Online準系統中。 本系統可用於物聯網,遠程3D打印機服務器等。
+所有功能己包含於ArOZ Online準系統中。 本系統可用於物聯網,遠程3D打印機服務器等。

+ 35 - 0
docs/lang/zh-HK/8.md

@@ -0,0 +1,35 @@
+["Web Desktop Interface"]
+# Web Desktop Interface
+Web Desktop Interface, aka Virtual Desktop Mode (VDI Mode), is a mode that allow users to use ArOZ Online Cloud System using a OS-Like desktop interface on their web browser. VDI mode support all basics Desktop operations including create shortcuts, window drag-drop, maximize, hide and close, opening files and folders and more.
+
+VDI mode is powered by Float-Window system. It combines multiple WebApps and system services in ArOZ Online barebone into one easy to use interface which looks like a Desktop Interface. Hence, its name “Virtual Desktop Interface”.
+
+In VDI mode, Function Bar provide Float Window management functions and navigations to different tools and utilities on the user interface. List Menu provide a quick way to launch WebApps from a list and Device Mounting Manager shows the current mounted external storage devices like USB drives and HDD. Float Windows system in VDI mode allows multiple WebApps to be opened in one browser tab by initializing WebApps in iframes, which also provide a sandbox function for javascripts. The maximum number of Float Windows that can be opened in VDI mode is limited to 50 Windows. This value might increase in the future after the mainstream browsers support iframe multithreading.
+
+The name of the corrisponding elements on the VDI mode is shown in the diagram below.
+
+![](img/8/0.png)
+
+## Preview
+This is a typical Web Desktop Interface for a normal user. You can see the shortcuts on the left upper corner and a few files on the center of the desktop. Background is changable via right-click menu.
+
+![](img/8/2.png)
+
+And the functions of the Float Windows system is shown as follows.
+
+![](img/8/1.png)
+
+The following image shows the 3 basic modules, Audio, Video and Photo module, running on Virtual Desktop Mode.
+![](img/8/3.png)
+
+## Basic Functions
+The Virtual Desktop Mode provides simple functions for performing many different operations. Including new folder or files, download from URL and background changing functions. The following image shows the beta-phrase desktop right-click menu.
+
+![](img/8/4.png)
+
+Other than desktop based function, the Desktop Mode also support some simple file operations including remove file, move files or rename. However, it is still recommended to use the File Explorer for more complex operations as File Explorer supports asynchronize file operations compare to desktop's synchronize file operation which might freeze when handling large files on Raspberry Pi.
+
+![](img/8/5.png)
+
+
+

+ 50 - 0
docs/lang/zh-HK/9.md

@@ -0,0 +1,50 @@
+["PWA-Mode"]
+# Progressive Web Apps Mode
+PWA mode for an ArOZ Online WebApp is not compulsory but it is recommended.
+
+PWA Mode allow ArOZ Online WebApps to be launched on a mobile devices that support PWAs and allow quick startup of the ArOZ Online WebApp services. Here is an example of the File Explorer launched in PWA mode.
+
+![](img/9/0.png)
+
+## Support PWA Mode
+To support PWA Mode, you will need some extra lines of code and a file named <code> manifest.json</code> according to [Google's defination](https://developers.google.com/web/fundamentals/web-app-manifest/).
+
+In simple words, you will need to add this line in the head section of your WebApp
+
+```
+<link rel="manifest" href="manifest.json">
+```
+
+Here is an example <code> manifest.json</code> for ArOZ Online Audio module.
+
+```
+{
+  "name": "ArOZ Audio",
+  "short_name": "AudioA",
+  "icons": [{
+    "src": "img/pwa/128.png",
+      "sizes": "128x128",
+      "type": "image/png"
+    },{
+      "src": "img/pwa/192.png",
+      "sizes": "192x192",
+      "type": "image/png"
+    }, {
+      "src": "img/pwa/256.png",
+      "sizes": "256x256",
+      "type": "image/png"
+    }, {
+      "src": "img/pwa/512.png",
+      "sizes": "512x512",
+      "type": "image/png"
+    }],
+  "start_url": "index.php?mode=pwa",
+  "display": "standalone",
+  "scope": "./",
+  "background_color": "#f7f7f7",
+  "theme_color": "#4286f4"
+}
+```
+And here are the image files included in the img/pwa/ directory.
+
+![](img/9/1.png)