Wiki source code of XWiki

Version 26.1 by Milad Afshar-Jahanshahi on 2025/06/27 13:09

version	line-number	content
5.1	1	(% class="wikigeneratedid" %)
	2	[[image:XWiki-logo-color.png\|\|alt="Grafana Icon Logo PNG vector in SVG, PDF, AI, CDR format" data-xwiki-image-style-alignment="end" height="52" width="190"]]
	3
	4	{{toc/}}
	5
18.1	6	= Introduction =
15.2	7
5.1	8	XWiki is an open-source platform for creating, managing, and collaborating on structured and unstructured content. It functions as a powerful wiki engine with advanced features like version control, rights management, scripting, and extensible applications. XWiki enables users to build knowledge bases, documentation platforms, or collaborative intranets, all within a customizable and web-based environment.
	9
	10	[[Vendor Page>>https://www.xwiki.org/xwiki/bin/view/Main/WebHome]]
	11
12.1	12	There are several useful resources available to get started with XWiki:
5.1	13
	14	[[XWiki Documentation>>https://www.xwiki.org/xwiki/bin/view/Documentation/]]
	15
	16	[[XWikiTutorials>>https://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/GettingStarted/]]
	17
18.1	18	= Accessing XWiki =
5.1	19
18.1	20	== Preconditions in DevOps portal to access XWiki ==
5.1	21
22.2	22	1. A XWiki license must be assigned to the user
	23	1. XWiki must be added to the tool list of the project
5.1	24
24.2	25	After completing the preconditions, a project in XWiki, which is part of the DevOps-as-a-Service toolchain, can be accessed via the DevOps Portal or directly through a URL.
5.1	26
18.1	27	== Via DevOps Portal ==
5.1	28
22.3	29	Go to the DevOps Portal Homepage and click on the link //Project Wiki// in the XWiki tile:
5.1	30
24.2	31	[[image:Untitled.png\|\|alt="XWiki-Tile" data-xwiki-image-style-border="true"]]
5.1	32
26.1	33	(% class="box warningmessage" %)
	34	(((
	35	⚠ Note
	36	If you are still unable to access your project in XWiki, it may be because you are logged in with an old session that still uses outdated permissions. To resolve this issue, please log out and then log in again:
	37	\\[[image:Untitled2.png\|\|height="185" width="825"]]
	38	)))
	39
18.1	40	== Via Direct URL ==
5.1	41
22.3	42	You can also access XWiki directly using the following link format:
22.7	43	[[https:~~/~~/<customer~>.devops.t-systems.net/xwiki/wiki/<pkey~>/view>>https://<customer>.devops.t-systems.net/xwiki/wiki/<pkey>/view]] where <customer> is the id of your DevOps-as-a-Service instance and <pkey> is the project key in lowercase letters.
5.1	44
24.2	45	If you are not already logged in to another tool in the toolchain or the DevOps portal, then you have to login using your configured SSO credentials.
	46
5.1	47	(% class="box warningmessage" %)
	48	(((
	49	⚠ Note
25.1	50	Access to the main wiki at [[https:~~/~~/<customer~>.devops.t-systems.net/xwiki>>https://<customer>.devops.t-systems.net/xwiki]] is forbidden due to security restrictions and therefore this page cannot be viewed.
11.1	51
9.2	52	)))
5.1	53
	54	= Users, Projects and Roles =
	55
22.10	56	* Projects, users and their roles in projects are managed in the DevOps Portal, the corresponding functions in XWiki are disabled (UI and API)
5.1	57
	58	(% class="box warningmessage" %)
	59	(((
	60	⚠ Note
	61	Projects in the DevOps portal are mapped to corresponding subwikis in XWiki
	62	)))
	63
23.1	64	* When XWiki is added as a tool to an existing or new project, a corresponding subwiki is automatically created. Users assigned to the project in the DevOps Portal are then added to the subwiki with the roles defined in the configuration :
5.1	65	** Role mapping: (((
23.1	66	(% class="active" %)\|=(% style="width: 237px;" %)Project Role in DevOps Portal\|=(% style="width: 704px;" %)Permissions in XWiki
	67	\|(% style="width:237px" %)Admin\|(% style="width:704px" %)View, comment, edit, and delete pages
	68	\|(% style="width:237px" %)Master\|(% colspan="1" style="width:704px" %)Can view, comment, and edit pages, but cannot delete content
	69	\|(% style="width:237px" %)Developer\|(% colspan="1" style="width:704px" %)Similar to Master
	70	\|(% style="width:237px" %)Viewer\|(% style="width:704px" %)Read-only access. Can only view content, no edits or comments allowed
5.1	71
	72	A detailed description of the XWiki role model can be found [[here>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/Access%20Rights/Permission%20types/]]
	73	)))
	74
23.2	75	= Main Features =
5.1	76
24.1	77	Inside DevOps-as-a-Service, XWiki is mainly used for writing specifications and documentations. See below for a list of the main features of XWiki.
23.2	78
5.1	79	== Collaborative Content Editing ==
	80
	81	* WYSIWYG and wiki syntax editors
	82	* Version control and history tracking
	83	* Inline and structured content editing
	84	* Commenting and annotations
	85
	86	== Advanced Page & Document Management ==
	87
	88	* Hierarchical page structure (nested pages)
	89	* Templates for creating structured documents
	90	* Tags, categories, and metadata support
	91	* File attachments and preview
	92
	93	== Powerful Search and Navigation ==
	94
	95	* Full-text search (Solr-based)
	96	* Faceted search filters
	97	* Page index, breadcrumbs, and navigation panels
	98
	99	== Macros and Widgets ==
	100
	101	* Built-in and custom macros (charts, galleries, diagrams)
	102	* Embedding of rich media (videos, iframes, etc.)
	103	* Markdown and LaTeX support
	104
	105

Wiki source code of XWiki

DevOps-as-a-Service