Add datetime ignore nls mask demo (#66)

* add PostGIS installation docs

* TOC number changed & version content updated

* change release notes & release date

* add xml function feature & fixed 16-17 feature

* add datetime_ignore_nls_mask demo

* release notes & contributor list updating

Author: balinorLiang

CN/antora.yml

@@ -1,7 +1,7 @@
 name: ivorysql-doc
 title: IvorySQL
-version: v3.1
-start_page: v3.1/welcome.adoc
+version: v3.2
+start_page: v3.2/welcome.adoc
 asciidoc:
   attributes:
     source-language: asciidoc@

CN/modules/ROOT/nav.adoc

@@ -1,27 +1,29 @@
-* xref:v3.1/welcome.adoc[欢迎]
-* xref:v3.1/1.adoc[发行说明]
-* xref:v3.1/2.adoc[关于IvorySQL]
+* xref:v3.2/welcome.adoc[欢迎]
+* xref:v3.2/1.adoc[发行说明]
+* xref:v3.2/2.adoc[关于IvorySQL]
 * IvorySQL入门
-** xref:v3.1/3.adoc[快速开始]
-** xref:v3.1/4.adoc[日常监控]
-** xref:v3.1/5.adoc[日常维护]
+** xref:v3.2/3.adoc[快速开始]
+** xref:v3.2/4.adoc[日常监控]
+** xref:v3.2/5.adoc[日常维护]
 * IvorySQL高级
-** xref:v3.1/6.adoc[安装指南]
-** xref:v3.1/7.adoc[集群搭建]
-** xref:v3.1/8.adoc[开发者指南]
-** xref:v3.1/9.adoc[运维管理指南]
-** xref:v3.1/10.adoc[迁移指南]
+** xref:v3.2/6.adoc[安装指南]
+** xref:v3.2/7.adoc[集群搭建]
+** xref:v3.2/8.adoc[开发者指南]
+** xref:v3.2/9.adoc[运维管理指南]
+** xref:v3.2/10.adoc[迁移指南]
+* IvorySQL生态
+** xref:v3.2/11.adoc[PostGIS]
 * 功能列表
-** xref:v3.1/11.adoc[1、框架设计]
-** xref:v3.1/12.adoc[2、GUC框架]
-** xref:v3.1/13.adoc[3、大小写转换]
-** xref:v3.1/14.adoc[4、双模式设计]
-** xref:v3.1/15.adoc[5、兼容Oracle like]
-** xref:v3.1/16.adoc[6、兼容Oracle匿名块]
-** xref:v3.1/17.adoc[7、兼容Oracle函数与存储过程]
-** xref:v3.1/18.adoc[8、内置数据类型与内置函数]
-** xref:v3.1/19.adoc[9、新增Oracle兼容模式的端口与IP]
-* xref:v3.1/20.adoc[社区贡献指南]
-* xref:v3.1/21.adoc[工具参考]
-* xref:v3.1/22.adoc[FAQ]
-
+** xref:v3.2/14.adoc[1、框架设计]
+** xref:v3.2/15.adoc[2、GUC框架]
+** xref:v3.2/16.adoc[3、大小写转换]
+** xref:v3.2/17.adoc[4、双模式设计]
+** xref:v3.2/18.adoc[5、兼容Oracle like]
+** xref:v3.2/19.adoc[6、兼容Oracle匿名块]
+** xref:v3.2/20.adoc[7、兼容Oracle函数与存储过程]
+** xref:v3.2/21.adoc[8、内置数据类型与内置函数]
+** xref:v3.2/22.adoc[9、新增Oracle兼容模式的端口与IP]
+** xref:v3.2/26.adoc[10、XML函数]
+* xref:v3.2/23.adoc[社区贡献指南]
+* xref:v3.2/24.adoc[工具参考]
+* xref:v3.2/25.adoc[FAQ]

CN/modules/ROOT/pages/v3.1/1.adoc

@@ -0,0 +1,70 @@
+:sectnums:
+:sectnumlevels: 5
+
+
+== 版本概览
+
+[**发行日期：2024年4月11日**]
+
+
+IvorySQL 3.2基于PostgreSQL 16.2，引入了Oracle XML函数兼容性功能，同时修复了多个问题。更多信息请参考 https://docs.ivorysql.org/[文档网站] 。
+
+== 增强功能
+
+- Oracle XML函数兼容性
+
++
+
+该功能整合了对各种Oracle XML函数的兼容性，包括APPENDCHILDXML、DELETEXML、EXISTSNODE、EXTRACT(XML)、EXTRACTVALUE、INSERTCHILDXMLAFTER、INSERTCHILDXMLBEFORE、INSERTCHILDXML、INSERTXMLAFTER、INSERTXMLBEFORE、UPDATEXML，有关该功能的更多细节，请查看 https://github.com/IvorySQL/IvorySQL/issues/587[#587]
+
+- PostgreSQL 16.2 的增强功能
+
+1. 确保CREATE DATABASE的持久性
+2. 确保pgoutput逻辑复制插件正确传输列的默认值
+3. 在使用之前重新验证订阅的连接字符串
+4. 当新客户端在不响应服务器的密码挑战时断开连接时，返回正确的状态代码
+5. 在PL/pgSQL中支持具有SQL标准体的CREATE FUNCTION/CREATE PROCEDURE的SQL命令
+
++
+
+更多细节, 请参阅 https://www.postgresql.org/docs/release/16.2/[PostgreSQL发布说明].
+
+
+== 问题修复
+
+    - 解决了文档构建失败的问题: https://github.com/IvorySQL/IvorySQL/issues/645[#645]
+	- 消除了构建警告: https://github.com/IvorySQL/IvorySQL/issues/649[#649]
+	- 修正了 to_date 函数的参数问题: https://github.com/IvorySQL/IvorySQL/issues/592[#592]
+	- 修复了在创建函数时的标签问题: https://github.com/IvorySQL/IvorySQL/issues/624[#624]
+
+== 源代码
+
+IvorySQL主要包含2个代码仓库:
+
+* IvorySQL数据库源码: https://github.com/IvorySQL/IvorySQL
+* IvorySQL官方网站: https://github.com/IvorySQL/Ivory-www
+
+== 贡献人员
+以下个人（按姓氏排序）作为补丁作者、提交者、审查者、测试者或问题报告者为此版本做出了贡献。
+
+- Cary Huang
+- David Zhang
+- Grant Zhou
+- Leo X.M. Zeng
+- 付贝
+- 高雪玉
+- 郭新源
+- 黄迎
+- 贾楠
+- 矫顺田
+- 李永昊
+- 梁翔宇
+- 刘政
+- 吕新杰
+- 牛世继
+- 任娇
+- 阮秀华
+- 尚雷
+- 王丽
+- 王守波
+- 严少安

CN/modules/ROOT/pages/v3.1/13.adoc

@@ -0,0 +1,117 @@
+
+:sectnums:
+:sectnumlevels: 5
+
+= PostGIS
+
+== 概述
+IvorySQL原生100%兼容PostgreSQL,因此，PostGIS可以完美适配IvorySQL。
+
+== 安装
+根据开发环境，用户可从 https://postgis.net/documentation/getting_started/#installing-postgis[PostGIS安装] 页面选择适合自己的方式进行安装PostGIS安装。
+
+=== 源码安装
+除PostGIS社区提供的安装方式以外，IvorySQL社区也提供了源码安装方式，源码安装环境为 CentOS 7.9(x86_64)。
+
+[NOTE]
+请确保环境中已安装了**IvorySQL3.0及以上版本**
+
+** 安装依赖
+```
+yum install -y gcc gcc-c++ libtiff libtiff-devel.x86_64 libcurl-devel.x86_64 libtool libxml2-devel redhat-rpm-config clang llvm geos311 automake protobuf-c-devel
+```
+
+** 安装SQLITE
+```
+$ wget https://www.sqlite.org/2022/sqlite-autoconf-3400000.tar.gz
+$ tar -xvf sqlite-autoconf-3400000.tar.gz
+$ cd sqlite-autoconf-3400000
+$ sed -n '1i\#define SQLITE_ENABLE_COLUMN_METADATA 1' sqlite3.c
+$ ./configure --prefix=/usr/local/sqlite
+$ make && make install
+$ rm usr/bin/sqlite3 && ln -s /usr/local/sqlite/bin/sqlite3 /usr/bin/sqlite3
+$ sqlite3 -version
+$ export PKG_CONFIG_PATH=/usr/local/sqlite/lib/pkgconfig:$PKG_CONFIG_PATH
+```
+
+** 安装PROJ
+```
+$ wget https://download.osgeo.org/proj/proj-8.2.1.tar.gz
+$ tar -xvf proj-8.2.1.tar.gz
+$ cd proj-8.2.1
+$ ./configure --prefix=/usr/local/proj-8.2.1
+$ make && make install
+```
+
+** 安装 GDAL
+```
+$ wget https://github.com/OSGeo/gdal/releases/download/v3.4.3/gdal-3.4.3.tar.gz
+$ tar -xvf gdal-3.4.3.tar.gz
+$ cd gdal-3.4.3
+$ sh autogen.sh
+$ ./configure --prefix=/usr/local/gdal-3.4.3 --with-proj=/usr/local/proj-8.2.1
+$ make && make install
+```
+
+** 安装 GEOS
+```
+$ wget https://download.osgeo.org/geos/geos-3.9.2.tar.bz2
+$ tar -xvf geos-3.9.2.tar.bz2
+$ cd geos-3.9.2
+$ ./configure --prefix=/usr/local/geos-3.9.2
+$ make && make install
+```
+
+** 安装 Protobuf
+```
+$ wget https://plug-neomirror.rcac.purdue.edu/adelie/source/archive/protobuf-3.20.1/protobuf-3.20.1.tar.gz
+$ tar -xvf protobuf-3.20.1.tar.gz
+$ cd protobuf-3.20.1
+$ sh autogen.sh
+$ ./configure  --prefix=/usr/local/protobuf-3.20.1
+$ make && make install
+$ export PROTOBUF_HOME=/usr/local/protobuf-3.20.1
+$ export PATH=$PROTOBUF_HOME/bin:$PATH
+$ export PKG_CONFIG_PATH=$PROTOBUF_HOME/lib/pkgconfig:$PKG_CONFIG_PATH
+```
+
+** 安装 Protobuf-c
+```
+$ wget --no-check-certificate https://sources.buildroot.net/protobuf-c/protobuf-c-1.4.1.tar.gz
+$ tar -xvf protobuf-c-1.4.1.tar.gz
+$ cd protobuf-c-1.4.1
+$ ./configure --prefix=/usr/local/protobuf-c-1.4.1
+$ make && make install
+$ export PROTOBUFC_HOME=/usr/local/protobuf-c-1.4.1
+$ export PATH=$PROTOBUF_HOME/bin:$PROTOBUFC_HOME/bin:$PATH
+$ export PKG_CONFIG_PATH=$PROTOBUFC_HOME/lib:$PKG_CONFIG_PATH
+```
+
+** 安装 PostGIS
+```
+$ wget https://download.osgeo.org/postgis/source/postgis-3.4.0.tar.gz
+$ tar -xvf postgis-3.4.0.tar.gz
+$ cd postgis-3.4.0
+$ sh autogen.sh
+$ ./configure  --with-geosconfig=/usr/local/geos-3.9.2/bin/geos-config --with-projdir=/usr/local/proj-8.2.1 --with-gdalconfig=/usr/local/gdal-3.4.3/bin/gdal-config --with-protobufdir=/usr/local/protobuf-c-1.4.1 --with-pgconfig=/usr/local/ivorysql/ivorysql-3/bin/pg_config
+$ make && make install
+```
+[TIP]
+如出现PGXS报错, 请根据环境中IvorySQL安装路径, 修改--with-pgconfig的参数值。
+
+== 创建Extension并确认PostGIS版本
+
+psql 连接到数据库，执行如下命令：
+```
+ivorysql=# CREATE extension postgis;
+CREATE EXTENSION
+
+ivorysql=# SELECT * FROM pg_available_extensions WHERE name = 'postgis';
+  name   | default_version | installed_version |                          comment
+---------+-----------------+-------------------+------------------------------------------------------------
+ postgis | 3.4.0           | 3.4.0             | PostGIS geometry and geography spatial types and functions
+(1 row)
+```
+
+== 使用
+关于PostGIS的使用，请参阅 https://postgis.net/docs/manual-3.4[PostGIS3.4官方文档]