随时笔记：
| 问题 | 解决办法 |
|---|---|
| 安装报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 | <localehandler class="org.opencms.i18n.CmsDefaultLocaleHandler"/>修改为：<localehandler class="org.opencms.i18n.CmsSingleTreeLocaleHandler"/> |
| 2，编辑配置文件 opencms-importexport.xml | <linksubstitutionhandler>org.opencms.staticexport.CmsDefaultLinkSubstitutionHandler</linksubstitutionhandler>修改为：<linksubstitutionhandler>org.opencms.staticexport.CmsLocalePrefixLinkSubstitutionHandler</linksubstitutionhandler> |
| 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 | <cms:navigation>标签中增加属性：locale="${cms.locale}" |
| 9，link到其他的场所（Linking to other locales） | 在JSP文件中可以使用 <cms:link>标签创建链接到具体特定的语言页面，可以增加参数 parameter __locale={target locale}来指定连接到哪种语言的页面，比如想连接到英语主页，那么link标签内容：/home/?__locale=en |
相关链接：
opencms文档及API问地址：http://documentation.opencms.org/
