Skip to Content

Changes for page XWikiTips

Last modified by Administrator on 2024/12/27 15:59
From version 8.1
edited by Administrator
on 2024/12/27 15:59
Change comment: There is no comment for this version
To version 4.1
edited by David De La Harpe Golden
on 2018/07/28 19:07
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.admin
1 +XWiki.david
Content
... ... @@ -1,23 +1,8 @@
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 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.
3 +Installation is straightforward on Debian, just following the relevant XWiki docs. The most involved part was setting up "short URLs" - losing the odd javatastic ##/xwiki/bin/view## url prefix - but again, no real issues there.
4 4  
5 5  
6 6  == Syntax Highlighting ==
7 7  
8 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 (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