第零章：为什么选择PinkShell？
PinkShell是由Exquisite开发的面向对象的Shell和编程语言，具有Shell和编译两种独立模式，本文档是编译模式的教程。
PinkShell的一些特点：
- 跨平台：Pink OS、Windows、Liunx、Mac OS等操作系统都能兼容PinkShell。
- 系统支持：Pink OS自带PinkShell环境，此系统的GUI程序和系统软件都是使用PinkShell开发的。
- 运行效率高：PinkShell的峰值运行效率仅次于C语言。
- 快速部署：PinkShell可以直接生成可执行文件，如C语言一样便捷。
第一章：环境配置
此文档假设以下条件：
| 操作系统版本 | Pink OS 17.7.0 |
| PinkShell版本 | 8.2.0 |
| PinkShell位置 | /system/system pack/shell |
| 程序位置 | /bin |
PinkShell文件的后缀名是.sh，在/bin创建一个名为Hello.sh，然后使用文本编辑器打开。
第二章：基础声明
如果这个文件是编译模式的程序，需要在开头加入这样的声明：
$ mode compile ;否则会以Shell模式运行。
第三章：数据类型
PinkShell严格区分数据类型，使用错误的数据类型会报错或出现逻辑错误。
整数
| 类型 | 范围 |
|---|---|
auto_int | 无限 |
short_int | -32768~32767 |
long_int | 小于-32,768或大于32,767 |
浮点数
| 类型 | 范围 |
|---|---|
auto_float | 无限 |
short_float | 2.3E-308~1.7E+308 |
long_float | 小于2.3E-308或大于1.7E+308 |
字符串
| 类型 | 范围 |
|---|---|
auto_str | 无限 |
short_str | 0字节~1024字节 |
long_str | 大于1024字节 |
第四章：函数
函数区分数据类型，通常是auto_int。
创建和调用函数的语法如下：
defined function <数据类型> <创建的函数名字> (<参数1>,<参数2>...) do
<代码块> ；
end
调用的函数名字(<参数1>,<参数2>...) ;PinkShell需要有一个main函数作为程序入口，不需要额外调用，大概是这样
defined function auto_int main() do
<代码块> ;
end第五章：输出
output类中的echo函数可以输出数据，语法如下：
output.echo (<参数>) ;完整的Hello world程序是这样的：
$ mode compile ;
defined function auto_int main() do
output.echo ("Hello world!\n") ;
end第六章：变量
变量也区分数据类型，语法如下：
<数据类型> <变量名> -> <值>以下是一个示例，用于连接字符串：
$ mode compile ;
defined function auto_int main() do
auto_str a -> "Hello" ;
auto_str b -> "World" ;
output.echo (a + b + "\n") ;
end第七章：输入
input函数可以获取键盘在终端输入的信息，可以传达到变量，语法如下：
input (<参数(通常是空的)>) ;以下是一个示例，用于获取你的名字：
$ mode compile ;
defined function auto_int main() do
auto_str name -> input () ;
output.echo ("你好，" + name + "\n") ;
end第八章：判断
if...elseif...else语句用来进行条件判断，语法如下：
if (<条件>) then
<代码块> ;
elseif (<条件>) then
<代码块> ;
else then
<代码块> ;
end第九章：循环
while语句可以循环执行一个代码块，在没有break的情况不会停止，语法如下：
while do
<代码块> ;
end如果需要达到某种条件跳过循环的情况，可以使用break语句配合判断来实现：
while do
if (<条件>) then
break ;
else then
<代码块> ;
end
end第十章：库
PinkShell拥有各种好用的库，如与系统通信的system库，简便制作GUI程序的iris库，数学计算的math库，管理服务器的web库…
导入一个库很简单，只需要在开头加入这样的声明：
$ import "<库名称>" ;第十一章：部署可执行文件
通常情况下，编译的时候会把二进制代码存储在内存中，然后直接运行。
如果要生成一个可执行文件，只需要在开头加入这样的声明：
$ generate "<生成位置>" ;生成位置可以是相对位置，也可以是绝对位置，比如在程序的同目录下生成就是这样：
$ generate "/bin" ;第十二章：实战
要求：制作一个实时时钟显示在屏幕（视野）的左上角。
思路：调用system库循环获取时间，在使用iris库显示出来。
代码：
$ mode compile ;
$ generate "/bin" ;
$ import "system" ;
$ import "iris" ;
defined function auto_int main() do
iris.add.window (name -> "clock", title -> "clock", location -> "above-lift", height -> 14, width -> 60, units -> "px") ; //创建一个窗口，位置在左上角，高5px，宽60px
iris.clock.background_transparency (True) ; //更改窗口背景的透明度为透明
iris.clock.add.text (color -> "#FFFFFF", size -> 14, units -> "px") ; //创建一个文本，颜色白色，大小14px
while do
auto_int second -> system.time.second() ; //获取秒
auto_int minute -> system.time.minute() ; //获取分钟
auto_int hour -> system.time.hour() ; //获取小时
auto_str time -> hour + ":" + minute + ":" + second ; //将以上三种变量整合到一个字符串
iris.clock.text.content (time) ; //文本变成time变量的内容
end
end