OpenCms操作小记

随时笔记：

问题	解决办法
安装报java.lang.OutOfMemoryError: Java heap space 错误	修改TOMCAT_HOME/bin/catalina.bat，在“echo "Using CATALINA_BASE: $CATALINA_BASE"”上面加入以下行： set JAVA_OPTS=%JAVA_OPTS% -server -Xms800m -Xmx800m -XX:MaxNewSize=256m
执行报java.lang.OutOfMemoryError: PermGen space错误	修改TOMCAT_HOME/bin/catalina.sh在# OS specific support. $var must be set to either true or false.上面加入以下行：JAVA_OPTS="-server -XX:PermSize=64M -XX:MaxPermSize=128M"
新建控件	小火箭》模块管理》新建模块》进入新建的模块》增加资源类型》system目录下，模块文件夹的对应模块，编辑schema》demo目录建立function，编辑jsp文件》编辑页面添加控件。
list	本身已提供list功能，也可以增加新的显示样式，新建模块，自定义样式。
从10.0.1版本升级到10.5.0版本	网站提供升级包以及升级手顺。
国际化语言对应	1，修改系统配置文件。2，有几种方式可以实现，可以分别建立独立的子网站，也可以先建立一种语言的子网站，别的站点进行Siblings copy。3，一个网站，每个网页使用多语言。
其他操作	10.5.0版本探索中。
10.5.0版本重要新特点	1，关注网站本地化。2，可以把一个网页从一个语言子站copy到另一个，包括网页上的控件。3，不同语言可以通过环境对应关系连接同一个网页。4，消息包的翻译。5，支持本地化的属性。6，数据视图部件（widget）API允许本地集成外部资产在内容编辑器。7，支持使用外部资产通过EL函数。8，通过隐藏所有OpenCms添加标记增强页面编辑器在线预览以便HTML调试。9， Demo模板由于新选项和功能大大增强。
search功能添加	1，/.content/路径下面建立search 控件。2，对控件进行编辑，可参考apollo-demo中的控件设置。3，新建search页面（/search/index.html）,编辑页面，把新建的search控件放到search页面中。4，修改/.content/.config文件，detail pages页签中添加Detail page（新建的search页面），类型设定为：function@Search page。
网站描述设定	sitemap》属性》Advanced》SEO options中Description中可以设定网站描述，设定后在百度等搜索结果里将会有显示网站描述。

一个站点，多种语言实现方法：

步骤	具体操作
1，编辑配置文件 opencms-system.xml	修改为：
2，编辑配置文件 opencms-importexport.xml	org.opencms.staticexport.CmsDefaultLinkSubstitutionHandler修改为：org.opencms.staticexport.CmsLocalePrefixLinkSubstitutionHandler
3，修改网站属性	Site Management》Site details》Edit site》添加参数localizationMode=singleTree
4，翻译内容	把对应的各语言页面翻译成对应的国家语言
5，翻译页面标题和导航栏属性	编辑content/config文件，增加其他语言的（Sitemap editor》Sitemap view》Advanced》Sitemap configuration），增加Title_de, Title_fr, NavText_de ,NavText_fr等属性，需要选择"Prefer folder"选项。
6，修改站点属性	itemap editor》Properties》设定步骤5添加的属性值。
7，修改formatter：/system/modules/org.opencms.apollo/formatters/navigation-head.jsp	${cms.title}修改为：${cms.titleLocale[cms.locale]}
8，修改formatter：/system/modules/org.opencms.apollo/elements/nav-main.jsp，/system/modules/org.opencms.apollo/elements/nav-breadcrumb.jsp	标签中增加属性：locale="${cms.locale}"
9，link到其他的场所（Linking to other locales）	在JSP文件中可以使用 标签创建链接到具体特定的语言页面，可以增加参数 parameter __locale={target locale}来指定连接到哪种语言的页面，比如想连接到英语主页，那么link标签内容：/home/?__locale=en

---

相关链接：

opencms文档及API问地址：http://documentation.opencms.org/