正在查看旧版本。 查看 当前版本.

与当前比较 查看页面历史记录

« 前一个 版本 10 下一个 »

这里记录配置Confluence的过程。通过右上角的按钮进入Confluence的站点管理页面，后继除了空间独有的设置项外，其他大部分的通用选项都从这里进行配置。

配置站点标题和基本URL

这里注意一点，站点的基本URL对登录影响很大，如果不从基本URL进行登录，那么Confluence会提示基本URL不匹配并要求更新基本URL。比如，虽然从https://midlane.top/confluence/和https://www.midlane.top/confluence/都可以访问到本网站，但这俩对应不同的基本URL。实际需要根据情况配置基本URL，再从基本URL进行登录。基本URL不影响访问用户，访客只需要IP地址解析正确，可以从任何URL访问Confluence页面。

配置时间格式

Confluence默认的时间格式是12小时制，这里改成24小时制，修改“格式和国际化设置->时间格式”，将默认的H:mm a 改成HH:mm即可。

配置全局样式表

这里修改的是全局的页面样式，主要调整默认的字体和大小，以及优化等宽字体、也就是行内代码的显示风格，格式参考思源笔记，修改“外观->样式表”，在全局样式表中增加以下内容：

/* 调整字体和大小，优化中文显示效果 */
.wiki-content {
	font-family: "Helvetica Neue", "Luxi Sans", "DejaVu Sans", "Hiragino Sans GB", "Microsoft Yahei", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Noto Color Emoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols";
	font-variant-ligatures: no-common-ligatures !important;
	font-size: 16px;
	text-rendering: optimizeLegibility !important;
}

/* 优化等宽字体，也就是行内代码的显示效果 */
code {
    padding: 1px 5px 1px 5px; 
    font-family: Consolas, Menlo, Monaco, Lucida Console, Liberation Mono, DejaVu Sans Mono, Bitstream Vera Sans Mono, Courier New, monospace, serif;
    background-color: #eeeeee;
}

除了全局样式表，Confluence中的每个空间也可以单独设置样式，方法是在“空间管理->外观->样式表”中进行修改，修改方法类似。

禁用右侧目录随页面滚动

Confluence可以通过分栏，并在右侧插入目录宏的方式实现右侧目录显示功能，但坑爹的是这个目录是随页面滚动的，而我们在浏览时一般都需要目录固定以便随时跳转，这里通过全局样式表实现目录固定功能，参考上一节，在全局样式表中新增以下内容：

/* 固定右侧目录，使之不随页面滚动 */
div.cell.aside>.innerCell>.toc-macro {
	position:fixed;
	top:100px;
	height: 75%;
	overflow-y:scroll !important;
	overscroll-behavior: contain !important;
}
/* 不显示目录的滚动条 */
.toc-macro::-webkit-scrollbar {display:none}

禁用保护管理员事务

Confluence默认对管理员相关的功能启用了管理员事务保护，也就是管理员即使已经登录了，在操作管理员相关功能时，也需要再次登录一次，如果要禁用的话，在“用户&安全→安全配置”中，去掉默认勾选的保护管理员事务即可。

修改synchrony最大堆内存

synchrony是Confluence用协同编辑的功能，默认堆内存为2G，这里可以修改成1G，或是禁用掉。

参考：

https://confluence.atlassian.com/doc/configuring-synchrony-858772125.html
https://confluence.atlassian.com/doc/recognized-system-properties-190430.html
https://confluence.atlassian.com/doc/configuring-system-properties-168002854.html

编辑/opt/atlassian/confluence/bin/setenv.sh文件，未尾增加如下内容：

重启服务，修改效果可以从“站点管理→协同编辑”进行查看，如下：

如果没有协同编辑需求，那么可以把这个功能关掉，这样在编辑页面还会出现预览选项，可以先预览再发布。

自定义HTML

Confluence最强大的定制功能是自定义HTML，用户可以通过自定义HTML为Confluence中的每个页面都添加HTML代码，从而实现源码级定制。

自定义HTML可以插入到页面的三个位置中：

  • HEAD尾部
  • BODY头部
  • BODY尾部

实际使用中，HEAD尾部一般插入JavaScript代码和CSS引用，BODY尾部一般插入自定义的HTML元素。下面讲解如果通过自定义HTML为页面增加更加丰富的定制功能。

使用JavaScript

参考：https://confluence.atlassian.com/confkb/how-to-use-javascript-in-confluence-313458839.html

这里需要注意的是，Confluence自带了JQuery，这就为操作页面元素提供了巨大的便利。虽然可以在HEAD尾部通过<script>标签引入标准的JQuery库，但强烈推荐使用Confluence内置的JQuery，否则可能出现意想不到的问题，比如本站在尝试引入标准JQuery库和Bootstrap之后，出现过空间目录不显示内容的情况。

Confluence的JQuery通过AJS.$的方式来使用，以下是一个示例：

AJS.$('div.foo');

如果想要通过AJS来执行代码，比如函数，那么必须将代码放到toInit函数中执行，这样就可以保证代码一定是在AJS被初始化之后再调用，如下：

AJS.toInit(function(){
	console.log("hello");
});

为Confluence导航栏添加自定义链接

参考：https://confluence.atlassian.com/confkb/how-do-i-add-links-to-confluence-5-x-s-top-global-header-navigation-bar-358908020.html

这里在导航栏上添加一个“空间目录”链接以直达空间目录列表，并将原来的“空间”下拉列表删除，方法如下，在HEAD尾部增加以下代码：

<script>
    AJS.toInit(function(){
        AJS.$('.aui-header-primary .aui-nav').append('<li><a href="https://www.midlane.top/confluence/spacedirectory/view.action" class=" aui-nav-imagelink">空间目录</a></li>');
        AJS.$('.aui-header-primary .aui-nav li').first().css("display", "none");
    });
</script>

























  • 无标签