Ver código fonte

added en-HK translation

Toby Chui 5 anos atrás
pai
commit
6ad9855d7a
6 arquivos alterados com 227 adições e 5 exclusões
  1. 2 2
      docs/index.html
  2. 16 0
      docs/lang/en-HK/0.md
  3. 90 0
      docs/lang/en-HK/1.md
  4. 74 0
      docs/lang/en-HK/2.md
  5. 38 0
      docs/lang/en-HK/3.md
  6. 7 3
      docs/reader.html

+ 2 - 2
docs/index.html

@@ -27,10 +27,10 @@
 			</thead>
 			<tbody>
 				<tr>
-					<td>en-US</td>
+					<td>en-HK</td>
 					<td>aCloud</td>
 					<td>Pending</td>
-					<td>-</td>
+					<td><a href="reader.html#en-HK">Open</a></td>
 				</tr>
 				<tr>
 					<td>zh-HK</td>

+ 16 - 0
docs/lang/en-HK/0.md

@@ -0,0 +1,16 @@
+["Welcome to ArOZ Online System!"]
+<img class="ts fluid image" src="img/banner.png"></img>
+
+<img src="https://img.shields.io/badge/Build-Community-brightgreen"> <img src="https://img.shields.io/badge/Device-Raspberry%20Pi%203B%2B%20%2F%204B-red"> <img src="https://img.shields.io/badge/香港制造-Hong%20Kong-blueviolet">
+
+# ArOZ Online System / aCloud
+This is a Cloud software system with Web Desktop Environment specially designed for Raspberry Pi SBC. You can use it to stream multimedia files, store data, perform simple office work / text processing, 3D printing files preview, Cloud Programming and more.
+
+## Community Users
+If you are a normal user, feel free to get one of our pre-build image for Raspberry with the link below.
+[Link](https://hkwtc.org/aroz_online/dist/)
+
+After your download has been finished, please proceed to the next page.
+
+## Developer
+If you are a developer and you are interested to build your own ArOZ Online WebApp, please skip to the development documentation sections.

+ 90 - 0
docs/lang/en-HK/1.md

@@ -0,0 +1,90 @@
+["Quick Start"]
+<img class="ts fluid image" src="img/quickstart.png">
+# Quick Start
+This quick start guide already assumed you have basic knowlege of using a computer, and this tutorial is written based on Windows Operating System.
+
+You will need the following hardwares to build yourself a ArOZ Cloud System.
+- Raspberry Pi (Recommended 3B+ or 4B)
+- WiFi USB dongle or ethernet cable in which the network gateway is in the same LAN as yours.
+- 16GB or above micro SD card
+- Power supply for the raspberry pi
+- Client devices (Smartphone, tablet PC or laptops, with WiFi function and / or able to access the same local area network with the pi)
+
+## Image Writing
+
+First, you will need Win32 Disk Imager and ArOZ Online System Image for Raspberry Pi.
+You can find them in the links below.
+[Win32 Disk Imager ](https://sourceforge.net/projects/win32diskimager/)
+[ArOZ Online System Images](https://hkwtc.org/aroz_online/dist/)
+
+After finish download and installing the image and software, you would see a new desktop icon appeared. Double click to start the Win32 Disk Imager.
+![](img/1/1.png)
+
+Next, select the "file open" button.
+![](img/1/2.png)
+
+Select the image file you just downloaded. In this case, the aCloud v1.0 image.
+![](img/1/3.png)
+
+Insert your micro SD card into your PC. If you have connected more than one external storage devices on your PC, you might need to change the path for the installation. In this example, the SD card is located on F:\ mount point.
+![](img/1/4.png)
+
+Finally, select "Write" to write the image file to SD card.
+![](img/1/5.png)
+
+## Hardware Preparation
+
+You can either choose WiFi AP or Ethernet with LAN access for your initiation network interface.
+
+First, insert the newly flashed SD card into your pi's SD card slot.
+<img class="ts fluid image" src="img/1/6.png">
+
+Connect your WiFi USB dongle to your Pi's USB port, or if you are using ethernet connection, plug in the ethernet cable into the Pi's RJ45 network connector.
+<img class="ts fluid image" src="img/1/7.png">
+
+### Setup with WiFi AP
+If you are using WiFi AP setup, open the WiFi discover interface on your devices and search for the following SSID and login with the following password.
+
+SSID: 
+<code> ArOZ Portable </code>
+Password:
+<code>arozportablesystem</code>
+
+After connected and turned off mobile data, open your default browser and enter <code>http://192.168.4.1/AOB/</code> into the URL bar. Following the on screen instructions to continue the account creation process.
+
+### Setup with Ethernet + Local Area Network
+
+If you are not using WiFi AP method for the setup process, you can use the ethernet + LAN method to setup ArOZ Online System. But first you need to know your Raspberry Pi's IP address. This can be achieved with the following methods.
+- Visit your DHCP server in which in most of the case, it would be your gateway router, and found the Raspberry Pi IP address under DHCP > Client options.
+- Use a IP scanner like Angry IP Scanner
+- Use imuslab [Web Scanner](http://lanips.imuslab.com/) for ArOZ Online System.
+- Use third party ArOZ Online System Scanner like [ alanyeung.co Finder](http://alanyeung.co/AOBRedirect/scan.html)
+
+The following tutorial will use the imuslab Web Scanner instead.
+
+Visit the Web Scanner with *Firefox or Chrome*. Make sure the starting part of the URL is  <code> http:// </code>  instead of  <code> https:// </code>. You should be able to see similar results as the following image indicating a ArOZ Online System devices has been discovered.
+![image](img/1/8.png)
+
+If the Web Scanner didn't return anything similar to the image below, try rebooting the raspberry pi, wait until the green light stop blinking and try again.
+![image](img/1/9.png)
+
+
+## Create new user
+
+Select "New User"
+![image](img/1/10.png)
+
+Enter username and password
+![image](img/1/11.png)
+
+Select "Add User"
+![image](img/1/12.png)
+
+Login with the account created just now.
+![image](img/1/13.png)
+
+You can continue to add a few more user accounts, or you can come back later and manage all the user accounts under the System Settings > User Tab.
+![image](img/1/14.png)
+
+If you see the index interface like the image below, that means you have successfully setup your own ArOZ Online System.
+![image](img/1/15.png)

+ 74 - 0
docs/lang/en-HK/2.md

@@ -0,0 +1,74 @@
+["Manual Installation"]
+<img class="ts fluid image" src="img/maninstall.png">
+
+# Manual Installation
+For those who are not using the Raspberry Pi SBC to deploy the ArOZ Online System, we do also support some of the other architectures. Including but not limited to
+- ARM64 (E.g. Orange PI Zero Plus)
+- x86_64 (With Intel or AMD CPU, running Debian 8 (deprecated), 9 or 10)
+- Windows (7 / 8.1 / 10 with WAMP / XMAPP, with some function limitation)
+
+However, manual installation is required for deploying the system on the platforms above. Here are the tutorial for the manual installation process.
+
+## Prerequisite
+You need the following apt packages for ArOZ Online deployment.
+- apache2
+- libapache2-mod-xsendfile
+- php libapache2-mod-php php-cli php-common php-mbstring php-gd php xml php-zip
+- php-mysql (Optional)
+- ffmpeg (Optional, please use libav-tools if you are still using Debian Jessie)
+- samba (Optional)
+
+You can use the following commands in terminal to install all of them.
+
+<code>sudo apt-get install -y apache2</code>
+<code>sudo apt-get install -y php libapache2-mod-php php-cli php-common php-mbstring php-gd php xml php-zip </code>
+<code>sudo apt-get install libapache2-mod-xsendfile</code>
+<code>sudo apt-get install php-mysql</code>
+<code>sudo apt-get install ffmpeg</code>
+<code>sudo apt-get install samba</code>
+
+
+If you are using Debian Buster or its forked distributions, you might want to run the following comamnds before installing all the packages listed above. You should run the following command with super user (su) permission.
+
+apt-get install sudo unzip net-tools ntfs-3g
+
+
+## Installing ArOZ Online System
+First, you need to modify the PHP upload file size limit. In most case, the config file can be found at
+ /etc/php/{php-version}/apache2/php.ini. Find and replace the following two lines.
+
+<code>upload_max_filesize = 2048M</code>
+<code>post_max_size = 2048M</code>
+
+  
+Add www-data into /etc/sudoers. 
+Tips: If your cloud system is deploying for public access, due to security reasons, you should modify the permission setting according to your own needs. If you are deploying under a NAT router or private network for PERSONAL USES, you can just use the command below.
+
+<code>www-data ALL=(ALL:ALL) NOPASSWD:ALL
+
+  
+Edit /etc/apache2/apache2.conf and add the following two lines at the bottom of the file.
+
+<code>XSendFile on</code>
+<code>XSendFilePath /media</code>
+
+  
+Create new folder at /media/storage1 and /media/storage2 for mounting external storages.
+
+<code>sudo mkdir /media/storage1 /media/storage2</code>
+
+  
+cd into /var/www/html/ ,use "wget" to download the ArOZ Online Distribution Pack. You can use the following commands to automate the process for you. Please remember to replace the <code>{dist-pack}</code> to the dist-pack name you are downloading.
+
+<code>cd /var/www/html/</code>
+<code>sudo wget {dist-pack}.zip</code>
+<code>sudo chmod 777 {dist-pack}.zip</code>
+<code>sudo unzip -o {dist-pack}.zip</code>
+<code>rm install.zip</code>
+<code>sudo mkdir -p "/etc/AOB"</code>
+<code>sudo chmod 777 -R "/etc/AOB"</code>
+<code>sudo chmod 777 -R ./AOB</code>
+<code>sudo chown -R www-data ./</code>
+
+  
+Open your default browser and visit [http://{device-IP}/AOB/](http://{device-IP}/AOB/) . Follow the on-screen tutorial to create your first user account on your ArOZ Online System.

+ 38 - 0
docs/lang/en-HK/3.md

@@ -0,0 +1,38 @@
+["External Storage Devices"]
+<img class="ts fluid image" src="img/extstorage.png">
+# External Storage Devices
+ArOZ Online Community Edition support two external storage devices by default.
+You can also modify the system to support more external storages up to the system maximum allowance.
+They are usually auto-mounted in the following locations:
+
+<code>/media/storage1</code> and <code>/media/storage2</code>
+
+The system only support NTFS formatted USB storage devices like *USB Drives*, *Portable Hard Disk* etc. You can also use SATA to USB adapter to convert a 2.5 inch or 3.5 inch SATA hard drive to your host device. But you should note that due to powering issue of the Raspberry Pi, you might encounter system stabilitiy issues due to underpower of the external storage devices. Unless you use a USB powered hub for the purposes, we usually recommend users to only use USB drives or Portable Solid State Drives for external storage purposes.
+
+## Tips for Brand New USB Drives
+If you just bought a new USB Drive for your cloud system, we recommend a full NTFS format before uses. This is due to many of the new USB Drives comes with a exFAT or FAT32 formats which ArOZ Online System  Auto Mounting Settings do not support. 
+
+You could use the Windows build in tool to format your USB drive to NTFS format as follow.
+![image](img/3/0.png)
+It is recommend not to select the "Quick Format" button if your USB drive contains encrypted partitions, your USB drive is 2nd handed or you have use it to install another Opertaion Systems 9aka Bootable USB Drive). 
+
+## Boot From Hard Disk
+Some advance users might choose to boot from external hard disk instead of the internal Micro SD card. Hence, the system drive will occupied the mount point for  <code> /dev/sda* </code> . To solve the error in auto mounting, you need to edit <code> /etc/fstab </code> and change the mounting devices as follow. Please edit <code> /etc/fstab </code> file and change the following two lines.
+
+<code>/dev/sda1 /media/storage1 ntfs defaults,nofail,noatime,x-systemd.device-timeout=1 0 0</code>
+<code>/dev/sdb1 /media/storage2 ntfs defaults,nofail,noatime,x-systemd.device-timeout=1 0 0</code>
+
+into the following
+<code>/dev/sdb1 /media/storage1 ntfs defaults,nofail,noatime,x-systemd.device-timeout=1 0 0</code>
+<code>/dev/sdc1 /media/storage2 ntfs defaults,nofail,noatime,x-systemd.device-timeout=1 0 0</code>
+
+## Adding More Devices
+In most case, you won't be using more than 2 external storage devices at the same time. However if you really need more than 2 mount points, you can create it by creating more folders in the media directory with the following commands. For example, this is the command for creating a 3rd mount point.
+<code>mkdir /media/storage3</code>
+Another example for creating the 4th mount point.
+<code>mkdir /media/storage4</code>
+And so on.
+
+Be aware that the manual created mount points will not be automatically mounted during the system startup. You might need to edit <code> /etc/fstab </code> according to your needs. You can find out more with the link below.
+ [Link](https://wiki.debian.org/fstab) 
+

+ 7 - 3
docs/reader.html

@@ -37,7 +37,7 @@ img{
 <div class="ts demo left sidebar" style="width:400px !important;">
     <div class="ts header">
         ArOZ Online System Documentation
-        <a class="sub header" href="index.html"><i class="reply icon"></i>Exit Reader</a>
+		<div id="lang" class="sub header" href="index.html"></div>
     </div>
     <div class="ts top attached tabbed menu">
     <a id="doclist" class="active item" onClick="toggleMode('doclist');"><i class="bookmark icon"></i></a>
@@ -46,12 +46,16 @@ img{
 	<div id="pageContent" class="ts active bottom attached tab segment">
 		
 	</div>
+	<div style="width:100%;" align="right">
+		<a href="index.html">Exit <i class="log out icon"></i></a>
+	</div>
+	
 </div>
 <div class="pusher">
 <br><br>
 <div class="ts container">
 <div class="ts segment">
-<div class="ts icon buttons" style="width:100% !important;">
+<div class="ts icon buttons">
     <button id="backbtn" class="ts button" onClick="lastPage();"><i class="arrow left icon"></i></button>
 	<button id="nextbtn" class="ts button" onClick="reloadAllDocs();"><i class="refresh icon"></i></button>
     <button id="nextbtn" class="ts button" onClick="nextPage();"><i class="arrow right icon"></i></button>
@@ -78,7 +82,7 @@ var baseFolder = "lang/" + lang + "/";
 var sidebarMode = "index"; //Either index or stars
 var staredPages = [];
 initLoad();
-
+$("#lang").text("Language: " + lang);
 //Check if there are stared pages. If yes, load them
 if (localStorage.getItem(lang) !== null) {
 	staredPages = JSON.parse(localStorage.getItem(lang));