feat: add new ubuntu guide

Author: Chronostasys

README.md

@@ -11,6 +11,9 @@
 此项目目前处于早期开发阶段，不建议用于生产环境。  
 [项目地址](https://github.com/Pivot-Studio/pivot-lang)  
 
+## 安装
+见https://lang.pivotstudio.cn/tutorial/installation.html
+
 ## 文档地址
 https://lang.pivotstudio.cn  
 

book/src/tutorial/basicproject.md

@@ -24,13 +24,13 @@ entry指定了该项目的入口文件，即编译器将从该文件开始编译
 {{#include example/main.pi}}
 ```
 源文件的后缀名必须为`.pi`。  
-在示例中，我们声明了一个外部函数`printi64ln`，该函数用于打印一个i64类型的值并换行。此源代码编译后执行会输出`666`。  
-> 重要：`printi64ln`函数是目前pl runtime中的一个测试用内置函数，内置函数在未来将有别的引入方法，并且此方法可能会在未来移除
+在示例中，我们调用了一个系统库重的函数`printi64ln`，该函数用于打印一个i64类型的值并换行。此源代码编译后执行会输出`666`。  
+> 重要：`printi64ln`函数是目前pl runtime中的一个测试用内置函数，此函数可能会在未来移除
 
 ## 编译
 如果你已经安装了`plc`，那么你可以在项目根目录下执行`plc main.pi`命令来编译该项目。此指令会生成一个名叫`out.plb`的文件，还有一些中间文件  
 
-> 如果你配置了镜头编译环境，还会生成一个叫做`out.plb.out`的文件，该文件是一个可执行文件，可以直接运行
+> 如果你配置了静态编译环境，还会生成一个叫做`out`的文件，该文件是一个可执行文件，可以直接运行
 > 而如果你只有jit环境，该文件不会生成，并且编译命令会输出一个clang报错和两行warning，这是正常现象
 
 ## jit运行

book/src/tutorial/example/Kagari.toml

@@ -1 +1,2 @@
 entry = "main.pi"
+project = "main"

book/src/tutorial/example/main.pi

@@ -1,6 +1,6 @@
+use std::io;
 fn main() i64 {
-    printi64ln(666);
+    io::printi64ln(666);
     return 0;
 }
 
-fn printi64ln(i: i64) void;

book/src/tutorial/installation.md

@@ -29,9 +29,23 @@ Pivot Lang存在两种不同的编译方案：
 TODO
 
 ## Linux
-目前我们对Ubuntu 20.04 LTS 和 Ubuntu 22.04 LTS提供了预编译的pivot lang编译器，你可以在我们的[release页面](https://github.com/Pivot-Studio/pivot-lang/releases)进行下载。编译器也许也能在别的发行版上运行，但是我们并没有测试过。
-
-在release中，`plc`程序是编译器可执行文件，下载后请将它添加到`PATH`环境变量中，之后即可运行`plc -h`进行验证。
+目前我们对Ubuntu 20.04 LTS 和 Ubuntu 22.04 LTS提供了apt包。  
+首先你需要添加我们的apt源的gpg key：
+```bash
+wget -O -  https://apt.lang.pivotstudio.cn/public.key | sudo apt-key add -
+```
+然后添加我们的apt源：
+```bash
+sudo add-apt-repository "deb [arch=amd64] https://apt.lang.pivotstudio.cn/repo focal main"
+sudo add-apt-repository "deb [arch=amd64] https://apt.lang.pivotstudio.cn/repo jammy main"
+```
+最后安装pivot lang编译器：
+```bash
+sudo apt install pivot-lang
+```
+你可以运行`plc`来检查是否安装成功。  
+
+请重启当前bash或者运行`source ~/.bashrc`来使环境变量生效。如果想安装`AOT`功能，请手动下载clang-14，下载方式见https://apt.llvm.org/
 
 
 
@@ -40,6 +54,6 @@ TODO
 
 在release中，`plc`程序是编译器可执行文件，下载后请将它添加到`PATH`环境变量中，之后即可运行`plc -h`进行验证。
 
-
+TODO mac文档已过期
 ## Docker
 TODO

deb/DEBIAN/postinst

@@ -1,10 +1,17 @@
+GREEN='\033[0;32m'
+NC='\033[0m'
+
 if [ "$1" = configure ]; then
     echo "export KAGARI_LIB_ROOT=/pl/planglib" >> ~/.bashrc
     echo "export PL_ROOT=/pl" >> ~/.bashrc
+    echo -e "${GREEN}"
+    echo "-------------------------------------------------------------------"
     echo "Successfully installed pivot-lang compiler with JIT feature!"
     echo "the pivot-lang compiler is now available as 'plc' command"
     echo "**jit feature does not support debug**"
     echo "you may need to restart your shell to load environment variables"
     echo "to install aot feature, please install clang-14 manually"
     echo "see https://apt.llvm.org/ for more details"
+    echo "-------------------------------------------------------------------"
+    echo -e "${NC}"
 fi