Skip to Content

Wiki source code of XWikiTips

Version 7.1 by Administrator on 2021/01/17 01:36
Show last authors
1 [[XWiki>>https://www.xwiki.org]] is a powerful Java-based programmable wiki system, more of a hybrid wiki/cms. To be honest, in an ideal world I'd rather have continued to custom-implement my site in Lisp, but I had to balance that against time available, and after evaluating several options I ended up going with XWiki for now.
2
3 Installation is straightforward on Debian, just following the relevant XWiki docs. The most involved part was setting up [["short URLs">>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/ShortURLs/]] - losing the odd javatastic ##/xwiki/bin/view## url prefix. Note from time to time xwiki versions have introduced new url segments for special purposes (e.g. asyncrenderer), keep an eye on the path exclusions as documented upstream.
4
5
6 == Syntax Highlighting ==
7
8 XWiki apparently uses Pygments (via Jython) for syntax-highlighting in the ##~{~{code}}## macro, so the available languages are those supported by Pygments: http://pygments.org/docs/lexers/
9
10 == Breadcrumb tree menu ==
11
12 Is handled in hierarchy_macros.vm, if you want to change it to display more than 10 entries in the dropdown. https://forum.xwiki.org/t/increase-number-of-entries-in-breadcrumb/903/4
13
14 == Java Compatibility ==
15
16 At time of writing (2019), XWiki LTS [[is not yet compatible>>https://forum.xwiki.org/t/error-number-4001-in-4-error-while-evaluating-velocity-template-colorthemeinit-vm/4323/5]] with Java 11 / post- Java 8. It's straightforward to use Java 8 for now while Java 8 itself is still supported of course, just worth keeping an eye on.