... |
... |
@@ -2,8 +2,10 @@ |
2 |
2 |
|
3 |
3 |
---- |
4 |
4 |
|
5 |
|
-== == |
|
5 |
+== Getting Started with XWiki == |
6 |
6 |
|
|
7 |
+This page covers all the essential steps and tips you need to create great content in XWiki without any confusion. |
|
8 |
+ |
7 |
7 |
== π Table of Contents: == |
8 |
8 |
|
9 |
9 |
{{toc/}} |
... |
... |
@@ -10,12 +10,6 @@ |
10 |
10 |
|
11 |
11 |
---- |
12 |
12 |
|
13 |
|
-== Getting Started with XWiki == |
14 |
|
- |
15 |
|
-This page covers all the essential steps and tips you need to create great content in XWiki without any confusion. |
16 |
|
- |
17 |
|
-== == |
18 |
|
- |
19 |
19 |
== π **Attachments and Images** == |
20 |
20 |
|
21 |
21 |
You can easily upload files and images directly from the WYSIWYG editor: |
... |
... |
@@ -96,6 +96,10 @@ |
96 |
96 |
* **Wiki Editor**: This mode enables direct editing using XWikiβs markup syntax. Itβs suitable for users comfortable with wiki syntax and those requiring precise control over the content structure.ξ |
97 |
97 |
* **Inline Form Editing**: Used primarily for pages containing structured data or custom applications, this mode presents editable fields directly within the page view, streamlining data entry and updates.ξ |
98 |
98 |
|
|
95 |
+=== **Switching Between Syntaxes** === |
|
96 |
+ |
|
97 |
+XWiki supports multiple syntaxes, including XWiki 2.1, MediaWiki, and others. While itβs possible to switch a pageβs syntax, exercise caution, as certain syntaxes may not fully support WYSIWYG editing. For instance, changing a page to MediaWiki syntax might limit the availability of the WYSIWYG editor. ξciteξturn0search6ξξ |
|
98 |
+ |
99 |
99 |
== **Essential Formatting Options** == |
100 |
100 |
|
101 |
101 |
To ensure content is both engaging and accessible, utilize the following formatting techniques:ξ |
... |
... |
@@ -113,7 +113,6 @@ |
113 |
113 |
|
114 |
114 |
|
115 |
115 |
|
116 |
|
-* |
117 |
117 |
** ((( |
118 |
118 |
=== **Bold**: Surround text with double asterisks. === |
119 |
119 |
))) |
... |
... |
@@ -123,7 +123,6 @@ |
123 |
123 |
{{/code}} |
124 |
124 |
|
125 |
125 |
|
126 |
|
-* |
127 |
127 |
** ((( |
128 |
128 |
=== **Italics**: Use double underscores. === |
129 |
129 |
))) |
... |
... |
@@ -133,7 +133,6 @@ |
133 |
133 |
{{/code}} |
134 |
134 |
|
135 |
135 |
|
136 |
|
-* |
137 |
137 |
** ((( |
138 |
138 |
=== **Underline**: Enclose text with double tildes. === |
139 |
139 |
))) |
... |
... |
@@ -143,7 +143,6 @@ |
143 |
143 |
{{/code}} |
144 |
144 |
|
145 |
145 |
|
146 |
|
-* |
147 |
147 |
** ((( |
148 |
148 |
=== **Unordered List**: Begin lines with asterisk (*) or hyphen (-). === |
149 |
149 |
))) |
... |
... |
@@ -154,7 +154,6 @@ |
154 |
154 |
{{/code}} |
155 |
155 |
|
156 |
156 |
|
157 |
|
-* |
158 |
158 |
** ((( |
159 |
159 |
=== **Ordered List**: Start lines with a number followed by a period. === |
160 |
160 |
))) |
... |
... |
@@ -167,8 +167,6 @@ |
167 |
167 |
|
168 |
168 |
== **Links** == |
169 |
169 |
|
170 |
|
- |
171 |
|
- |
172 |
172 |
==== **Internal Link**: Use square brackets with the page name. ==== |
173 |
173 |
|
174 |
174 |
{{code}} |
... |
... |
@@ -175,15 +175,16 @@ |
175 |
175 |
[[PageName]] |
176 |
176 |
{{/code}} |
177 |
177 |
|
178 |
|
- |
179 |
|
- |
|
171 |
+* |
|
172 |
+** ((( |
180 |
180 |
==== **External Link**: Provide the URL directly. ==== |
|
174 |
+))) |
181 |
181 |
|
182 |
182 |
{{code}} |
183 |
183 |
[https://www.example.com] |
184 |
184 |
{{/code}} |
185 |
185 |
|
186 |
|
-((( |
|
180 |
+* ((( |
187 |
187 |
=== **Images** === |
188 |
188 |
))) |
189 |
189 |
|
... |
... |
@@ -196,15 +196,15 @@ |
196 |
196 |
|
197 |
197 |
Macros are powerful tools in XWiki that allow for dynamic content inclusion and advanced formatting. Here are ten notable macros to consider:ξ |
198 |
198 |
|
199 |
|
-== Embed Macro == |
|
193 |
+**Box Macro**: Encapsulates content within a styled box, useful for highlighting information. |
200 |
200 |
|
201 |
|
-The Embed macro shows external content like YouTube videos. |
|
195 |
+{{code}} |
|
196 |
+{{box}} |
|
197 |
+Your content here. |
|
198 |
+{{/box}} |
|
199 |
+{{/code}} |
202 |
202 |
|
203 |
|
-{{example}} |
204 |
|
-{{embed url="https://www.youtube.com/watch?v=dQw4w9WgXcQ"/}} |
205 |
|
-{{/example}} |
206 |
206 |
|
207 |
|
- |
208 |
208 |
=== **Info Macro**: Displays an informational message, often used for tips or notes. === |
209 |
209 |
|
210 |
210 |
{{code}} |
... |
... |
@@ -214,16 +214,15 @@ |
214 |
214 |
{{/code}} |
215 |
215 |
|
216 |
216 |
|
217 |
|
-== Footnote Macro == |
|
211 |
+=== **Warning Macro**: Highlights warnings or important notices. === |
218 |
218 |
|
219 |
|
-The Footnote macro adds footnotes to the page. |
|
213 |
+{{code}} |
|
214 |
+{{warning}} |
|
215 |
+Caution: Proceed with care. |
|
216 |
+{{/warning}} |
|
217 |
+{{/code}} |
220 |
220 |
|
221 |
|
-{{example}} |
222 |
|
-This is a statement{{footnote}}Source: Example Reference{{/footnote}}. |
223 |
|
-{{putFootnotes/}} |
224 |
|
-{{/example}} |
225 |
225 |
|
226 |
|
- |
227 |
227 |
=== **Code Macro**: Renders code snippets with syntax highlighting. === |
228 |
228 |
|
229 |
229 |
{{code}} |
... |
... |
@@ -250,60 +250,28 @@ |
250 |
250 |
{{toc/}} |
251 |
251 |
{{/code}} |
252 |
252 |
|
253 |
|
-== Video Macro == |
254 |
254 |
|
255 |
|
-The Video macro embeds videos. |
|
247 |
+=== **Include Macro**: Embeds content from another page. === |
256 |
256 |
|
257 |
|
-{{example}} |
258 |
|
-{{video url="https://www.youtube.com/watch?v=dQw4w9WgXcQ"/}} |
259 |
|
-{{/example}} |
|
249 |
+{{code}} |
|
250 |
+{{include reference="PageName"/}} |
|
251 |
+{{/code}} |
260 |
260 |
|
261 |
|
-== Expandable Macro == |
262 |
|
-The following example demonstrates how to present complex information cleanly using `{{expandable}}` and `{{example}}`. |
263 |
263 |
|
264 |
|
-{{example}} |
265 |
|
-{{expandable summary="π§ Study: Survey of Expert Opinion on Intelligence"}} |
266 |
|
-**Source:** *Intelligence (Elsevier)* |
267 |
|
-**Date:** *2019* |
268 |
|
-**Authors:** *Heiner Rindermann, David Becker, Thomas R. Coyle* |
269 |
|
-**DOI:** [10.1016/j.intell.2019.101406](https://doi.org/10.1016/j.intell.2019.101406) |
270 |
|
-**Subject:** *Psychology, Intelligence Research* |
|
254 |
+=== **Display Macro**: Displays the content of another document or an object property. === |
271 |
271 |
|
272 |
|
-{{expandable summary="π Key Statistics"}} |
273 |
|
-- Survey of **102 intelligence experts** |
274 |
|
-- **90% from Western countries**, **83% male** |
275 |
|
-- **54% left-liberal**, **24% conservative** |
276 |
|
-- **50/50 split** on genetic vs environmental causes of Black-White IQ gap |
277 |
|
-{{/expandable}} |
|
256 |
+{{code}} |
|
257 |
+{{display reference="PageName"/}} |
|
258 |
+{{/code}} |
278 |
278 |
|
279 |
|
-{{expandable summary="π¬ Findings"}} |
280 |
|
-- Support for **g-factor theory** |
281 |
|
-- Agreement on **heritability of intelligence** |
282 |
|
-- Political lean: left = environmental, right = genetic causes |
283 |
|
-{{/expandable}} |
284 |
284 |
|
285 |
|
-{{expandable summary="π Critique"}} |
286 |
|
-- Largest expert survey on intelligence |
287 |
|
-- **Western-only sample**, possible **self-selection bias** |
288 |
|
-{{/expandable}} |
|
261 |
+=== **Velocity Macro**: Executes Velocity scripts for dynamic content generation. === |
289 |
289 |
|
290 |
|
-{{expandable summary="π Relevance"}} |
291 |
|
-- Shows **ideological divide** in science |
292 |
|
-- Highlights **media vs expert disconnect** |
293 |
|
-{{/expandable}} |
|
263 |
+{{code}} |
|
264 |
+{{velocity}} |
|
265 |
+#set($greeting = "Hello, $user.name!") |
|
266 |
+$greeting |
|
267 |
+{{/velocity}} |
|
268 |
+{{/code}} |
294 |
294 |
|
295 |
|
-{{expandable summary="π Explore More"}} |
296 |
|
-- Global surveys on intelligence beliefs |
297 |
|
-- Media analysis follow-up studies |
298 |
|
-{{/expandable}} |
299 |
|
- |
300 |
|
-{{expandable summary="π Download"}} |
301 |
|
-[[Download Study>>attach:10.1016_j.intell.2019.101406.pdf]] |
302 |
|
-{{/expandable}} |
303 |
|
-{{/expandable}} |
304 |
|
-{{/example}} |
305 |
|
- |
306 |
|
- |
307 |
|
-== See Also: == |
308 |
|
- |
309 |
|
-[[Syntax Help official documentation for a full list of formatting options>>doc:XWiki.XWikiSyntax]] |
|
270 |
+ |