我们正在更新文档,预计2019年9月15日全面开放!

1. 介绍与开始

1.1. 简介

金色站点是面向市场提供快速建立WEB站点的平台。金色站点的终旨是快速响应,随需应变!在这里,我们的产品将提供尽可能少的开发和维护成本以在当今信息和技术社会里,让使用金色站点的每一位客户都能在“时间就是金钱”的互联网之中脱颖而出!

使用金色站点平台的产品具有以下突出特点:

1) 所有100%页面和文字可在后台修改和即刻生效,无需重新部署和重启系统和软件!

2)一般添加和修改功能和页面,也无需重新部署和重启系统和软件。

3)页面(甚至处理器代码)存储于数据库,集群部署,一处更改,处处更改。

4)创建任意数据表后,无需开发编写增删改查功能,系统自带动态SQL查询设计器和数据操作工具。

5)结合GoldData金色数据,将软件和数据融合到一起,给网站添加无限魅力!

6)金色数据基于Java/Groovy语言开发,安全和高效!

7) 支持在线实时添加和修改i18n信息和文字,支持任意多国语言

1.2. 下载和安装

当前软件版本:1.0.1

下载地址: 1.0.1 最新版

下载金色站点软件后,可通过解压文件查看到软件文件。文件目录大致如下:

bin/        //脚本目录
   db_upgrade.bat          //数据库升级
   db_upgrade.sh
   goldadmin_passwd.bat   //重置管理员密码脚本
   goldadmin_passwd.sh
   setclasspath.bat
   setclasspath.sh
   setenv.bat
   setup.bat            //安装或创建项目脚本
   setup.sh
   theme_change.bat     //更改项目皮肤脚本
   theme_change.sh
   theme_make.bat       //制作皮肤脚本
   theme_make.sh
   theme_zip.bat         //打包皮肤脚本
   theme_zip.sh
src/               //创建项目所在路径
themes/            //操作皮肤所在路径
libs/
    templates/
    install-guide.jar
    theme.groovy
README.md    //说明文件

1.3. 运行环境

本软件需要JRE1.8及以上运行环境,JRE软件可以从 Java官网 下载。

本软件基于Java语言,所以可运行在Windows、Linux、Mac等操作系统上。

目前金色站点的数据库是基于MySQL数据库,所以你还需要准备一台可连接的MySQL数据库。如果你还没有,那么可到MySQL官网下载 : MySQL官网

当前版本软件使用gradle3.5 作为构建工具,因此你还需要从 Gradle官网下载

当前版本软件是在grails3.3.2开发,因此你还需要从 Grails官网下载

具体Java以及MySQL下载和安装,可以看咐录。

1.4. 创建您的项目

首先进入bin目录,双击运行setup.bat文件,启动安装程序,可以看到安装画面如下:

setup.bat

首先,选择安装语言,默认中文,按回车键就可以进行下一项。

然后提示输入项目名称,项目名称,请使用英文字母或数字来命名。然后再是站点名称,即项目网站名称。

接下来,则需要你配制GoldSite数据库连接,如下图所示:

setup_step2

如果MySQL连接成功,但数据库不存在时,则会询问是否创建,如果输入 'y',则会创建数据库。如下图所示:

setup_step3

接下来,需要配制项目默认使用的服务端口号,以及超级管理员密码。如下图所示:

setup_step4

在这一步过后,将会在项目的src路径下创建相应的项目。并将数据库脚本导入到数据库当中。如下图所示:

setup_step5

最后会询问是否设置皮肤,可以选择否跳过,待到之后运行bin/theme_change.bat进行替换。

至此金色站点创建项目程序已经结束。

1.5. 运行项目

进入$GOLDSITE_HOME 下的src目录,可以看到新创建的项目,进入项目,我们可以看到这是一个grails程序。如下图所示:

run1

然后,打开命令行,输入grails run-app,即可启动程序。

run2

打开浏览器访问http://localhost:8080/,访问项目站点首页,如下图所示:

run3

以及打开浏览器访问http://localhost:8080/mana,访问项目后台,如下图所示:

run4

1.6. 皮肤管理

1.6.1. 制作皮肤

进入$GOLDSITE_HOME/bin/下,打开命令行,运行theme_make.bat 命令,如下所示:

theme_make.bat <static files location>

示例如下:

make1

如上图所示,需输入语言,以及MySQL连接参数。然后将会在$GOLDSITE_HOME/themes/下创建皮肤项目black。如下图所示:

make2

然后我们就可以开始制作皮肤了。制作皮肤大概有下面这几步:

1.把用作布局的html页面放入$GOLDSITE_HOME/themes/black/grails-app/views/themes/black/layouts

2.再把其它的html页面则放入$GOLDSITE_HOME/themes/black/grails-app/views/themes/black/tpls

3.在$GOLDSITE_HOME/themes/black/grails-app/views/themes/black/目录下,打开命令行,运行groovy html2gsp.groovy 。这一步将会把html文件变为gsp文件。

4.编辑布局下的gsp文件。比如gsp文件中的body目录下的有共通用的内容保留,将不通用的内容使用<g:layoutBody/>替换。

5.编辑tpls下的gsp文件。比如将gsp文件head中的meta,及link,style,script删除,但加上<meta name="layout" content="<layout name>">,并将body元素下的共通部分去掉。与布局下的gsp文件形成完整的内容。

6.在目录$GOLDSITE_HOME/themes/black/下打开命令行,运行grails run-app,然后打开首页查看页面显示是否正确。

1.6.2. 打包皮肤

进入$GOLDSITE_HOME/bin/下,打开命令行,运行theme_zip.bat 命令,如下所示:

theme_zip.bat <the name of one theme project>

运行之后,将会在$GOLDSITE_HOME/themes/下,生成一个zip文件。

示例如下:

zip1
zip2

1.6.3. 上传皮肤到Github

要将创建皮肤 上传到github,共享给他人使用。 需要以下几个步骤,如下所示:

1.需要将皮肤zip文件解压,然后使用`git init`来初始化仓库。

2.使用git add . 以及git commit -m "create theme <name>"提交代码到仓库中。

3.登录Github.com,创建仓库。

4.在项目下运行git remote add origin <github repository url above>,添加远程仓库

5.运行git push -u origin master 命令,将项目推送到github.com网站上。

1.6.4. 切换皮肤

要切换皮肤,或者安装新皮肤到项目里, 需要以下几个步骤,如下所示:

1.进入$GOLDSITE_HOME/bin下,打开命令行,运行theme_change.bat,如下图所示:

themechange1

在上图中,我们需要切换皮肤的项目完整路径。另外还会询问是否删除项目中原有皮肤。如果不需要原有皮肤,选择删除即可。

2.接下来,程序需要你选择皮肤地址。这个皮肤地址,可以是本地或者网络zip文件,也可以是本地文件夹,也可以是github皮肤项目地址,如下图所示:

themechange2

3.如果是网络地址,则还需要你输入皮肤名称。

4.接下来,将会把皮肤文件导入到项目各目录下。完成皮肤切换。

1.7. 后台登录

在之前创建的项目里 创建您的项目 ,运行之后,登录后台 'http://localhost:8080/mana', 输入超级管理员帐号"admin",以及安装时所设置的密码,以及验证码进行登录。如果前述输入正确,则进入主页。如下图所示:

home1
如果登录时,勾选了“自动登录”选项,则下次打开地址时,将不用再进行登录,会自动进入主页。这个功能请不要再公共机器上使用。

1.8. 退出登录

主界面右上角,点击您的用户名,将弹出菜单,里面有个"退出"按扭。点击它后,将会退出登录!如下图所示:

logout

1.9. 许可证

金色站点平台,可以不用购买许可证免费使用临时许可证。当然也非常感激您去官网 https://goldsite.100shouhou.com 上购买许可证。

在这里我们将介绍申请临时许可证的步骤和用法。如下所示:

1.打开地址 https://goldsite.100shouhou.com/price ,然后点击“获取临时许可证”,如下图所示:

license1

这时将进入许可证获取页面。如果此时未登录,则会提示先登录。如下图所示:

license2

那么,你将需要登录。如果已经登录,则输入验证码,即可获取临时许可证。如下图所示:

license3

当你已经购买了许可证时,请到主界面注册许可证。

有关许可证的操作,都需要你使用超级管理员帐号"admin"才能操作。

1.9.1. 注册许可证

主界面右上角,选择“帮助”,将弹出菜单。

license4

选择其中的“注册”,将弹出注册许可证对话框。如下图所示:

license5

请将代码,以及密钥,然后点击“好”进行注册。如果代码以及密钥输入正确,那么将提示注册成功!底部状态栏许可证无效字样的提示将消失。

1.9.2. 注销许可证

当你想在另外一台机器上安装金色站点,并且想将许可证转移过去,那么你可能需要从当前机器上注销该许可证,特别是你购买的许可证只允许一台机器使用的情况下。注销许可证很简单。

主界面右上角,选择“帮助”,将弹出菜单。

license4

选择“注销本机许可证”,将会弹出“确认注销许可证”提示。选择“好”即会注销。