本人经过一段时间的研究,终于成功在confluence里面成功使用了markdown,以及markdown内latex公式。
2022年6月,Confluence 7.6。
效果
左边编辑界面,右边显示界面。
配置markdown
最初的想法是在atlassian marketeplace里面找个插件。然而,免费插件只有一个,就是:markdown macro
到这个商店页面之后,右上角换成【Server】,之后点【Versions】标签页,右边就会出现【Resources】,就可以下载历史版本的jar包了。下载之后,可以直接放到自己的confluence里面安装(管理员账号登录,之后右上角【设置】下拉菜单【管理应用】)
结果挺坑爹的我发现他会报错。。最后找啊找啊是【com.atlassian.migration.app】 找不到。反正就是奇奇怪怪的bug。于是我只好找到了他们家的开源地址,之后克隆掉,自己强行删掉这个依赖。。这个发布在 Confluence_no_migration,发布的jar包可以在我这个代码库右侧的release找到。求star啊
之后就能用了。插入宏 - markdown 。
配置latex公式
最开始我也是打算用atlassian marketplace里面的免费插件。我找到了这个mathjax。
但是实现的效果是每次插入公式都需要插入一个 mathjax宏。这样的话,markdown中的公式就不能直接显示了。导入之类的会很麻烦。
后来我想了一下,这个mathjax。。也是开源的哎。。要不然我们也。。。
后来浅学了一下js,发现只需要在 head 标签里面调用一下就好了。照猫画虎,我们以管理员账户打开confluence,之后点右上角【设置】-【一般配置】,左边找到【自定义HTML】,点一下【编辑】,之后再第一个框也就是【HEAD尾部】写:
<script type="text/javascript" async
src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/MathJax.js?config=TeX-MML-AM_CHTML" async>
</script>
<script type="text/x-mathjax-config">
MathJax.Hub.Config({
extensions: ["tex2jax.js"],
jax: ["input/TeX", "output/HTML-CSS"],
tex2jax: {
inlineMath: [ ['$','$'], ["\\(","\\)"] ],
displayMath: [ ['$$','$$'], ["\\[","\\]"] ],
processEscapes: true
},
"HTML-CSS": { availableFonts: ["TeX"] },
});
</script>
就可以了。
后记:我看用confluence的兄弟不多啊,我想在不付费的情况下实现confluence上面的markdown和latex公式甚至需要自学js以及confluence plugin开发(中间产生了很多次直接去淘宝付钱解决一切的念头,但是毕竟穷学生所以没)。。。。兄弟们来点个赞惺惺相惜一下吧。。捂脸。。。