Skip to Content
Last modified by chrisby on 2024/03/30 17:19
From version 4.4
edited by chrisby
on 2024/03/30 15:40
Change comment: There is no comment for this version
To version 3.7
edited by chrisby
on 2023/11/18 14:53
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,52 +1,54 @@
1 1  Here is a summary of the steps I took to configure this XWiki website via GUI. The configurations required for your XWiki website may vary depending on your needs. Being logged in as the admin user, the **Administration** page can be found here: Triple bar icon (upper right corner) > Administer Wiki. Here you can find the different options like **Look & Feel** or **Extensions**.
2 2  
3 -###### Delete non-required extensions
3 +### Measures
4 4  
5 +**Delete non-required extensions**
6 +
5 5  * Extensions > Extensions > In the selection menu, select "Installed Extensions" > Search for "Tour Application", "Help Application" and "Sandbox Application" and uninstall them
6 6  
7 -###### Upload Logo (displayed in the upper left corner of the website)
9 +**Upload Logo** (displayed in the upper left corner of the website)
8 8  
9 9  * Look & Feel > Themes > Color Theme > COLOR THEME > Customize > Logos > Choose an attachment > Browse > Upload and select > Safe & View
10 10  
11 -###### Add a tab bar below the website header
13 +**Add a tab bar below the website header**
12 12  
13 13  * Look & Feel > Menus > Add new entry > (create a menu, for example "Header Menu")
14 14  * Add links to each bullet point so that users who click on the tab are directed to the appropriate page.
15 15  * At the bottom of the Menu page: Menu Display Location = After the page header; Menu Visibility Scope = Global.
16 16  
17 -###### Adapt navigation panel items to your needs (the boxes at the edges like "Navigation" or "Recently Created")
19 +**Adapt navigation panel items to your needs** (the boxes at the edges like "Navigation" or "Recently Created")
18 18  
19 19  * Look & Feel > Panels > Panel List
20 20  
21 -###### Change browser tab title
23 +**Change browser tab title**
22 22  
23 23  * Look & Feel > Presentation > Header > Title > Remove the " - XWiki"
24 24  * Change favicon: Look & Feel > Themes > Skin > Customize > Edit > Logo > Choose Attachment > Browse > Select the image you want to have as a favicon. Make sure that the name of the image matches the names mentioned in the [documentation](http://sandbox.xwiki.org/xwiki/bin/view/FAQ/How+do+I+add+a+favicon+for+my+wiki). For example, svg files must be named "icons.xwiki.favicon.svg". > Upload and select image > Save & View
25 25  
26 -###### Enable justification in editor
28 +**Enable justification in editor**
27 27  
28 -* Editing > WYSIWYG Editor
30 +* Editing > WYSIWYG Editor >
29 29   * Default WYSIWYG Editor > CKEditor > Save (Note: There are two "Save" buttons on this page.)
30 30   * CKEditor > Disables Plugins > Open selection of disabled plugins > uncheck "justify" plugin > click on "Save" button **below**
31 31  
32 -###### Disable registration of new accounts
34 +**Disable registration of new accounts**
33 33  
34 34  * Users & Rights > Rights > XWikiAdminGroup > Add a check at "Register". Implicitly all other groups (including unregistered users) lose their right to register new accounts. See the [docs](https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/Access%20Rights/) for further details.
35 35  
36 -###### Allow comments feature for unregistered users
38 +**Allow comments feature for unregistered users**
37 37  
38 38  * Users & Rights > Rights > Remove the "Comment" check for each group. This implicitly allows all groups (including unregistered users) to use the comments feature.
39 39  
40 -###### Set up mailing
42 +**Set up mailing**
41 41  
42 42  * Mail > Mail Sending > Email address to send from > (enter the necessary fields to enable XWiki's mailing functionality)
43 43  * Users & Rights > Registration > User Email verification > Yes
44 44  
45 -###### Adapt the timezone
47 +**Adapt the timezone**
46 46  
47 47  * Content > Localization > Date/Time > Timezone
48 48  
49 -###### Use Markdown as page editing syntax
51 +**Use Markdown as page editing syntax**
50 50  
51 51  * Extensions > Extensions > Install CommonMark Markdown Syntax 1.2.
52 52  * Edit > Syntax > Disabled syntaxes
... ... @@ -58,52 +58,32 @@
58 58   * Go to the page to edit > Information > SYNTAX > click the "Edit" icon > select "CommonMark Markdown 1.2". > A "Syntax Conversion" popup appears - click "Yes" > click the "Confirm" icon. You should now be able to edit the page in Markdown.
59 59   * Sometimes manual adjustments are required after conversion, as it does not always work as desired.
60 60  
61 -###### Adapt the footer - Hide XWiki version and add copyright information.
63 +**Adapt the footer** - Hide XWiki version and add copyright information.
62 62  
63 63  * Look & Feel > Presentation > Footer > Here you can find the fields "Copyright" and "Version".
64 -* Since an empty "Version" field results in the current XWiki version being displayed, I left the "Copyright" field empty and entered the license in the "Version" field. Here are two examples when using Markdown syntax as described above:The contents of this website are available under the [CC0 1.0 Universal license](https://creativecommons.org/publicdomain/zero/1.0/deed.en); additional terms may apply.
66 +* Since an empty "Version" field results in the current XWiki version being displayed, I left the "Copyright" field empty and entered the license in the "Version" field. Here are two examples when using Markdown syntax as described above:
65 65  
66 -###### **Dark Theme**
68 +```
69 +The contents of this website are available under the [CC0 1.0 Universal license](https://creativecommons.org/publicdomain/zero/1.0/deed.en); additional terms may apply.
70 +The contents of this website are available under the [Attribution 4.0 International](https://creativecommons.org/licenses/by/4.0/); additional terms may apply.
71 +```
67 67  
68 -* Look & Feel > Themes > Color Theme
73 +**Dark Theme**
74 +
75 +* Look & Feel > Themes > Color Theme > COLOR_THEMES
69 69   * Manage Color Themes > "Darkly" Theme > Use this theme
70 70   * Customize > Advanced > Add the following code at the end and then "Save & View":
71 71  
72 - // Own customizations
73 - // .code span, // concerns code in 'code' macro
74 - #var-lessCode,
75 - #adminsearchmenu,
76 - .macro-parameter-field textarea,
77 - .form-control, // concerns credentials in login screen
78 - .xwikipaneltitle {
79 - color: white !important;
80 - }
81 -
82 - // Global search bar at the upper right has a white background by default, so the white default font would not make sense here.
83 - #headerglobalsearchinput {
84 - color: black !important;
85 - }
86 -
87 - // Removes white shadow from text in navigation menu
88 - .jstree-anchor {
89 - text-shadow: none !important;
90 - }
91 -
92 - h1, h2, h3, h4, h5, h6 { // All headings in pages
93 - color: orange !important;
94 - }
95 -
96 - #menu-horizontal-Menu-Header-Menu-WebHome a, // The menu below the Crispy Coding header with logo.
97 - .breadcrumb a { // breadcrumb links at the top of every page and in search results
98 - color: #0ce3ac !important;
99 - }
100 -
101 - strong, // all bold text in articles
102 - .search-text-highlight { // Highlight searched words in articles when using the global search bar in the upper right corner.
103 - color: #33ccff !important;
104 - }
105 -
106 - // When being in 'source' mode in editor.
107 - #cke_1_contents textarea {
108 - background-color: #333333 !important;
109 - }
79 +```CSS
80 +// Own customizations
81 +#var-lessCode,
82 +.macro-parameter-field textarea,
83 +.code span,
84 +.xwikipaneltitle {
85 + color: #ffffff !important;
86 +}
87 +
88 +h1, h2, h3, h4, h5, h6 {
89 + color: orange !important;
90 +}
91 +```