Liferay7.0自定义主题

Liferay官网：https://www.liferay.com
Liferay开发：https://dev.liferay.com/
注：平台为Mac，Windows的操作忽略，请参见其他教程

1. 环境搭建

(1) Eclipse

官网下载 Eclipse完整包，开始尝试过下载Eclipse Installer，但安装失败。

(2) java jdk

使用的jdk1.8，ORACLE官网下载，选择Mac OS X，下载并安装。在Terminal中查看java -version，由于之前使用的是1.7，此处需要修改java home 路径：

[1] vim ~/.bash_profile
[2] 点击i，修改到正确路径
[3] 按ESC，然后按 :wq
[4] source ~/.bash_profile 让配置文件在修改后立即生效（若无效可重启电脑）

(3) Liferay插件

下载Liferay的Eclipse插件，完成后不需要解压。进入Eclipse，Help -> Install New Software -> Work with 后面的Add按钮 -> Location 后的Archive按钮 ->选择下载的包

2. 创建Liferay工程

(1)创建Liferay Workspace

在Eclipse中选择 File -> New -> Other ->输入 Liferay WorkspaceProject ，弹出框选Yes。

(2) 新建bundle

在Terminal中通过cd .. 以及cd 文件夹名称 进入workspace的根目录。./gradlew initBundle 自动下载bundle。

此时，运行Eclipse中的Server，Liferay可以跑起来了。

3. 安装Liferay Theme

参考官方教程Themes Generator一章，

(1) 安装Node.Js

可通过命令node -v查看，出现版本信息表示已安装

(2) 安装npm环境

电脑上已有略过，详细方法参见官方教程

(3) 安装全局Yeoman 和 gulp

官方提供方法npm install -g yo gulp，显示错误信息Please try running this command again as root/Administrator. 所以，需要在命令前加sudo，用管理员模式，需输入密码。sudo npm install -g yo gulp

(4) 安装Themes Generator

输入命令 sodu npm install -g generator-liferay-theme

(5) 安装Themes Generator

4. 运行Liferay Theme

运行yo liferay-theme

(1) 输入theme名称

(2) 输入theme ID

使用默认ID，可直接回车

(3) 输入Liferay 版本

(4) 输入Server地址

(5) 输入URL，默认为localhost:8080

此处注意，可能出现 Local host name unkown error，需设置HostName，如图。

(6) 输入gulp deploy

将路径切换到新建的theme下，输入后会同步到liferay中的可选主题中。

5. 自定义Liferay Theme

注：所有的修改，需在src中进行，需与build中镜像，即相同名称override

(1) css修改

找到src -> css -> _custom.css文件，需要自定义的css样式写入该文件中即可

(2) freemarker文件修改

将build文件夹中的templates文件夹拷贝到src下，修改对应文件即可

(3)编译代码并运行工程

输入gulp deploy 可编译，在运行eclipse中的工程就能看到自定义修改后的变化

6. 部署及如何删除Liferay Theme

liferay工程的根目录 -> bundles -> osgi -> war
此处可以看到以主题名称命名的war包。实际上，主题在编译的时候是打成这样的war包在java中使用的。所以，在部署时，只需拷入war包即可。同样，为删除主题，可以直接将对应war包删除。

---

注意：在运行eclipse过程中，可能会出现端口被占用的情况。
(1) 输入ps -e | grep java 查找出tomcat进程id
66192 ?? 5:13.86 /Library/Java/Java…
(2) 输入kill -9 66192 杀掉进程