... |
... |
@@ -2,10 +2,8 @@ |
2 |
2 |
|
3 |
3 |
---- |
4 |
4 |
|
5 |
|
-== Getting Started with XWiki == |
|
5 |
+== == |
6 |
6 |
|
7 |
|
-This page covers all the essential steps and tips you need to create great content in XWiki without any confusion. |
8 |
|
- |
9 |
9 |
== π Table of Contents: == |
10 |
10 |
|
11 |
11 |
{{toc/}} |
... |
... |
@@ -12,6 +12,12 @@ |
12 |
12 |
|
13 |
13 |
---- |
14 |
14 |
|
|
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 |
+ |
15 |
15 |
== π **Attachments and Images** == |
16 |
16 |
|
17 |
17 |
You can easily upload files and images directly from the WYSIWYG editor: |
... |
... |
@@ -92,10 +92,6 @@ |
92 |
92 |
* **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.ξ |
93 |
93 |
* **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.ξ |
94 |
94 |
|
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:ξ |
... |
... |
@@ -112,7 +112,8 @@ |
112 |
112 |
=== **Text Formatting** === |
113 |
113 |
|
114 |
114 |
|
115 |
|
-* |
|
115 |
+ |
|
116 |
+* |
116 |
116 |
** ((( |
117 |
117 |
=== **Bold**: Surround text with double asterisks. === |
118 |
118 |
))) |
... |
... |
@@ -121,7 +121,8 @@ |
121 |
121 |
**bold text** |
122 |
122 |
{{/code}} |
123 |
123 |
|
124 |
|
-* |
|
125 |
+ |
|
126 |
+* |
125 |
125 |
** ((( |
126 |
126 |
=== **Italics**: Use double underscores. === |
127 |
127 |
))) |
... |
... |
@@ -130,7 +130,8 @@ |
130 |
130 |
__italic text__ |
131 |
131 |
{{/code}} |
132 |
132 |
|
133 |
|
-* |
|
135 |
+ |
|
136 |
+* |
134 |
134 |
** ((( |
135 |
135 |
=== **Underline**: Enclose text with double tildes. === |
136 |
136 |
))) |
... |
... |
@@ -139,10 +139,8 @@ |
139 |
139 |
~~underlined text~~ |
140 |
140 |
{{/code}} |
141 |
141 |
|
142 |
|
-* |
143 |
|
-* |
144 |
144 |
|
145 |
|
-* |
|
146 |
+* |
146 |
146 |
** ((( |
147 |
147 |
=== **Unordered List**: Begin lines with asterisk (*) or hyphen (-). === |
148 |
148 |
))) |
... |
... |
@@ -152,7 +152,8 @@ |
152 |
152 |
* Item 2 |
153 |
153 |
{{/code}} |
154 |
154 |
|
155 |
|
-* |
|
156 |
+ |
|
157 |
+* |
156 |
156 |
** ((( |
157 |
157 |
=== **Ordered List**: Start lines with a number followed by a period. === |
158 |
158 |
))) |
... |
... |
@@ -162,15 +162,11 @@ |
162 |
162 |
2. Second item |
163 |
163 |
{{/code}} |
164 |
164 |
|
165 |
|
-* ((( |
166 |
|
-=== === |
167 |
|
-))) |
168 |
|
-* ((( |
169 |
|
-=== **Links** === |
170 |
|
-))) |
171 |
171 |
|
|
168 |
+== **Links** == |
172 |
172 |
|
173 |
173 |
|
|
171 |
+ |
174 |
174 |
==== **Internal Link**: Use square brackets with the page name. ==== |
175 |
175 |
|
176 |
176 |
{{code}} |
... |
... |
@@ -177,16 +177,15 @@ |
177 |
177 |
[[PageName]] |
178 |
178 |
{{/code}} |
179 |
179 |
|
180 |
|
-* |
181 |
|
-** ((( |
|
178 |
+ |
|
179 |
+ |
182 |
182 |
==== **External Link**: Provide the URL directly. ==== |
183 |
|
-))) |
184 |
184 |
|
185 |
185 |
{{code}} |
186 |
186 |
[https://www.example.com] |
187 |
187 |
{{/code}} |
188 |
188 |
|
189 |
|
-* ((( |
|
186 |
+((( |
190 |
190 |
=== **Images** === |
191 |
191 |
))) |
192 |
192 |
|
... |
... |
@@ -199,17 +199,17 @@ |
199 |
199 |
|
200 |
200 |
Macros are powerful tools in XWiki that allow for dynamic content inclusion and advanced formatting. Here are ten notable macros to consider:ξ |
201 |
201 |
|
202 |
|
-1. **Box Macro**: Encapsulates content within a styled box, useful for highlighting information.ξ |
|
199 |
+== Embed Macro == |
203 |
203 |
|
204 |
|
-{{code}} |
205 |
|
-{{box}} |
206 |
|
-Your content here. |
207 |
|
-{{/box}} |
208 |
|
-{{/code}} |
|
201 |
+The Embed macro shows external content like YouTube videos. |
209 |
209 |
|
|
203 |
+{{example}} |
|
204 |
+{{embed url="https://www.youtube.com/watch?v=dQw4w9WgXcQ"/}} |
|
205 |
+{{/example}} |
210 |
210 |
|
211 |
|
-=== **Info Macro**: Displays an informational message, often used for tips or notes.ξ === |
212 |
212 |
|
|
208 |
+=== **Info Macro**: Displays an informational message, often used for tips or notes. === |
|
209 |
+ |
213 |
213 |
{{code}} |
214 |
214 |
{{info}} |
215 |
215 |
This is an informational note. |
... |
... |
@@ -217,17 +217,18 @@ |
217 |
217 |
{{/code}} |
218 |
218 |
|
219 |
219 |
|
220 |
|
-=== **Warning Macro**: Highlights warnings or important notices.ξ === |
|
217 |
+== Footnote Macro == |
221 |
221 |
|
222 |
|
-{{code}} |
223 |
|
-{{warning}} |
224 |
|
-Caution: Proceed with care. |
225 |
|
-{{/warning}} |
226 |
|
-{{/code}} |
|
219 |
+The Footnote macro adds footnotes to the page. |
227 |
227 |
|
|
221 |
+{{example}} |
|
222 |
+This is a statement{{footnote}}Source: Example Reference{{/footnote}}. |
|
223 |
+{{putFootnotes/}} |
|
224 |
+{{/example}} |
228 |
228 |
|
229 |
|
-=== **Code Macro**: Renders code snippets with syntax highlighting.ξ === |
230 |
230 |
|
|
227 |
+=== **Code Macro**: Renders code snippets with syntax highlighting. === |
|
228 |
+ |
231 |
231 |
{{code}} |
232 |
232 |
{{code language="python"}} |
233 |
233 |
def hello_world(): |
... |
... |
@@ -236,7 +236,7 @@ |
236 |
236 |
{{/code}} |
237 |
237 |
|
238 |
238 |
|
239 |
|
-=== **Gallery Macro**: Creates an image gallery from attached images.ξ === |
|
237 |
+=== **Gallery Macro**: Creates an image gallery from attached images. === |
240 |
240 |
|
241 |
241 |
{{code}} |
242 |
242 |
{{gallery}} |
... |
... |
@@ -252,28 +252,60 @@ |
252 |
252 |
{{toc/}} |
253 |
253 |
{{/code}} |
254 |
254 |
|
|
253 |
+== Video Macro == |
255 |
255 |
|
256 |
|
-=== **Include Macro**: Embeds content from another page. === |
|
255 |
+The Video macro embeds videos. |
257 |
257 |
|
258 |
|
-{{code}} |
259 |
|
-{{include reference="PageName"/}} |
260 |
|
-{{/code}} |
|
257 |
+{{example}} |
|
258 |
+{{video url="https://www.youtube.com/watch?v=dQw4w9WgXcQ"/}} |
|
259 |
+{{/example}} |
261 |
261 |
|
|
261 |
+== Expandable Macro == |
|
262 |
+The following example demonstrates how to present complex information cleanly using `{{expandable}}` and `{{example}}`. |
262 |
262 |
|
263 |
|
-=== **Display Macro**: Displays the content of another document or an object property. === |
|
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* |
264 |
264 |
|
265 |
|
-{{code}} |
266 |
|
-{{display reference="PageName"/}} |
267 |
|
-{{/code}} |
|
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}} |
268 |
268 |
|
|
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}} |
269 |
269 |
|
270 |
|
-=== **Velocity Macro**: Executes Velocity scripts for dynamic content generation. === |
|
285 |
+{{expandable summary="π Critique"}} |
|
286 |
+- Largest expert survey on intelligence |
|
287 |
+- **Western-only sample**, possible **self-selection bias** |
|
288 |
+{{/expandable}} |
271 |
271 |
|
272 |
|
-{{code}} |
273 |
|
-{{velocity}} |
274 |
|
-#set($greeting = "Hello, $user.name!") |
275 |
|
-$greeting |
276 |
|
-{{/velocity}} |
277 |
|
-{{/code}} |
|
290 |
+{{expandable summary="π Relevance"}} |
|
291 |
+- Shows **ideological divide** in science |
|
292 |
+- Highlights **media vs expert disconnect** |
|
293 |
+{{/expandable}} |
278 |
278 |
|
279 |
|
- |
|
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]] |