基本用法
一、Java 开发人员版的命令
命令格式:mvn op:command -Dparam1=val1 -Dparam2=var2 ...
根据 Maven 特性,多个命令可以顺序执行 mvn op:command1 op:command2 ... -Dparam1=val1 -Dparam2=var2 ...
插件包括以下 goal:
- op:install - 安装并初始化网站/博客
- op:sass-compile - 编译 SASS
- op:generate - 生成静态网站
- op:build - 生成静态网站,与
generate
命令相同 - op:preview - 启动一个 Web 服务器,并监控站点文件变化,变化时自动重新生成
- op:deploy - 发布站点到指定的服务器或者本地目录
- op:clean - 清理站点模板缓存和临时文件
- op:new-page - 创建新页面
- op:new-post - 创建新文章
- op:sass-watch - 监控 SASS 文件,变化时自动重新编译
- op:wordpress-import - 从 WordPress 导入文章和页面
以上各个指令的参数请点击相应的链接,查看其 Maven 文档。
注意
- Goal
op:generate
等同于 Goalop:build
。 - Goal 的前缀
op
等同于opoopress
,该插件已经定义其goalPrefix
为op
,可以使用mvn op:install
,mvn op:generate
等替代原格式mvn opoopress:install
,mvn opoopress:generate
。
OpooPress 处理过程
我们将 OpooPress 的安装、构建、部署等过程分成以下几个阶段:
- 安装站点
- 功能: 安装站点
- Goal:
op:install
,op:clean
- 生成主题
- 功能: 生成主题
- Goal:
op:sass-compile
,op:sass-watch
,op:new-post
,op:new-page
,op:import
- 生成站点
- 功能: 生成站点
- Goal:
op:generate
,op:build
- 生成后
- 功能: 无
- Goal:
op:preview
,op:deply
阶段之间有一定的依赖关系,规则如下
- 当前阶段的
goal
在执行前会先执行上一阶段的功能
- 当前阶段的
功能
在执行前会先执行上一阶段的功能
示例:
op:preview
的依赖链为op:preview -> 生成站点 -> 生成主题 -> 安装站点
,执行的顺序是安装站点 -> 生成主题 -> 生成站点 -> 启动预览
。op:new-post
的依赖链为op:new-post -> 安装站点
,执行的顺序是安装站点 -> 创建新文章
。
按需执行
OpooPress 各阶段功能可以按需执行,例如执行 安装站点
时,OpooPress 会判断当前站点是否已经安装,未安装时才会真正执行操作。同样执行 生成站点
时也会先判断站点是否生成,是否在上次生成后源文件有变化等等,然后决定是否执行相应的操作。
二、非开发人员版的命令
命令格式通常是 op command [options]
,与开发人员版的命令格式唯一区别就是去掉了 mvn op:
前缀(例如 op preview
对应 mvn op:preview
),
其参数格式是一致的,都必须使用 -D
指定。
目前仅提供 Windows 版本,请参安装指南文档。
可用以下各 command
:
- install - 安装并初始化网站/博客
- sass-compile - 编译 SASS
- generate - 生成静态网站
- build - 生成静态网站,与
generate
命令相同 - preview - 启动一个 Web 服务器,并监控站点文件变化,变化时自动重新生成
- deploy - 发布站点到指定的服务器或者本地目录
- clean - 清理站点模板缓存和临时文件
- new-page - 创建新页面
- new-post - 创建新文章
- sass-watch - 监控 SASS 文件,变化时自动重新编译
- wordpress-import - 从 WordPress 导入文章和页面
示例:
- 初始化博客:
D:\opoopress-1.1.1>op init
- 预览博客:
D:\opoopress-1.1.1>op preview
- 发布博客:
D:\opoopress-1.1.1>op deploy