Wiki source code of XWikiTips

Last modified by Administrator on 2024/12/27 15:59

version	line-number	content
3.1	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
7.1	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.
3.1	4
4.1	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/
5.1	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
6.1	13
	14	== Java Compatibility ==
	15
8.1	16	At time of writing (2024), XWiki LTS 16.x IS compatible with Java 17. Yay.
	17
	18	== XWiki and Underlining ==
	19
	20	Following upgrade to 16 you may find XWiki defaulting to Underlining links. This is for accessibility reasons. Setting a global default of no underlining is involved but possible, see
	21
	22	* https://forum.xwiki.org/t/16-3-how-to-change-default-link-underline-style/14543/7 - set global preferences object property (ui hidden by default, edit URL)
	23	* https://forum.xwiki.org/t/unable-to-change-default-underline-links-after-upgrade/15277/2 - add extra property to class if missing on upgrade