编写CyberArticle宏

CyberArticle宏，就是一段自动化脚本，可以直接使用JavaScript或者VBScript。然后通过一个设置文件macro.ini，放在指定的目录下面，以便CyberArticle调用相应的自动化脚本。

请参考CyberArticle自动化脚本开发说明。

下面是一个例子：

;宏应用设置
[Common] 
;宏应用程序名
;可以在名称后面加上LCID值，指定相应的语言下的名称
AppName=CyberArticle Sample Macros
AppName_2052=CyberArticle样例宏 
;宏应用程序GUID。CyberArticle会把宏安装在My Bookks\macros\GUID\下面。同时CyberArticle也会通过这个GUID来判断是否是同一个宏
AppGUID={85868504-1923-45c3-9ABD-3C03678278E9} 
;宏类型。Normal：普通宏；Edit：用于编辑文章的宏。如果二者功能都有，可以全部写上，用逗号分割，例如AppType=Normal,Edit
AppType=Normal 
;宏版本。应该是一个有效的实数，例如1.0  1.1  1.22等等
AppVersion=1.0
;宏功能数量，1-xxx
MacroCount=2 


;第1个宏。Macro_xxx，从0开始
[Macro_0]
;宏功能名称，可以在后面加上LCID，指定语言
Caption=Remove Incorrect Books 
Caption_2052=删除无法打开的书籍 
;宏功能GUID。必须唯一
GUID={E36BFD46-F938-4c67-B3E5-733285D33D9D} 
;脚本文件名。相对于macro.ini路径
ScriptFileName=cyberarticle_remove_incorrect_books.js 

;第2个宏。
[Macro_1] 
Caption=Create Articles URL ShortCut 
Caption_2052=创建文章网址快捷方式 
GUID={6A0AC976-A267-4c72-8578-CC67E1D94A85} 
ScriptFileName=cyberarticle_create_nodes_shortcut.vbs 

;字符串。脚本可以通过ICAAutomationApp来获得字符串。通过在字符串名称后面添加LCID，可以获得不同语言下面的字符串。
;这部分内容为可选的。

[Strings] 
PromptRemoveBook=Do you want to remove the book: %1? 
PromptRemoveBook_2052=是否要删除书籍: %1？ 
PromptSelectDirToSaveShortcut=Please select a folder to save the shortcuts? 
PromptSelectDirToSaveShortcut_2052=请选择一个文件夹，用来保存快捷方式？ 

上面的内容，表示了一个macro.ini应该具有的一些内容。

找到CyberArticle个人数据保存目录，默认情况下在 我的文档\my books\macros\。

然后新建一个一个目录，以AppGUID的值命名。

然后把macro.ini文件，脚本文件，复制到这个目录。

 

启动CyberArticle，在宏菜单/工具栏上面，就可以看到相应的宏了。可以点及相应的菜单，来执行宏。

 

如果宏功能只有一个（MacroCount=1），则菜单上直接显示这一个宏的菜单。否则，会显示宏应用的名称，点击后会有下拉菜单。

 

直接macro.ini文件，脚本文件以及其它相关的文件，用zip格式压缩成一个文件。注意：macro.ini文件在压缩包内的位置，应该在根目录，而不是在某一个文件夹内。

 

压缩后，将扩展名修改成.camacro。双击这个文件，CyberArticle将会把这个宏安装（解压缩）到相应的位置。

您可以把这个camacro文件共享给其它用户。

 

LCID的值，可以参考CyberArticle安装目录下面的translations\Locale ID Chart.htm文件