0 Votes

Changes for page Start here if you're new

Last modified by Ryan C on 2025/06/28 04:59

From version 10.1
edited by Ryan C
on 2025/03/16 01:21
Change comment: There is no comment for this version
To version 16.1
edited by Ryan C
on 2025/05/14 13:30
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -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:ξˆ†
... ... @@ -113,7 +113,7 @@
113 113  
114 114  
115 115  
116 -*
116 +*
117 117  ** (((
118 118  === **Bold**: Surround text with double asterisks. ===
119 119  )))
... ... @@ -123,7 +123,7 @@
123 123  {{/code}}
124 124  
125 125  
126 -*
126 +*
127 127  ** (((
128 128  === **Italics**: Use double underscores. ===
129 129  )))
... ... @@ -133,7 +133,7 @@
133 133  {{/code}}
134 134  
135 135  
136 -*
136 +*
137 137  ** (((
138 138  === **Underline**: Enclose text with double tildes. ===
139 139  )))
... ... @@ -143,7 +143,7 @@
143 143  {{/code}}
144 144  
145 145  
146 -*
146 +*
147 147  ** (((
148 148  === **Unordered List**: Begin lines with asterisk (*) or hyphen (-). ===
149 149  )))
... ... @@ -154,7 +154,7 @@
154 154  {{/code}}
155 155  
156 156  
157 -*
157 +*
158 158  ** (((
159 159  === **Ordered List**: Start lines with a number followed by a period. ===
160 160  )))
... ... @@ -169,22 +169,21 @@
169 169  
170 170  
171 171  
172 -==== ** Internal Link**: Use square brackets with the page name. ====
172 +==== **Internal Link**: Use square brackets with the page name. ====
173 173  
174 174  {{code}}
175 175  [[PageName]]
176 176  {{/code}}
177 177  
178 -*
179 -** (((
178 +
179 +
180 180  ==== **External Link**: Provide the URL directly. ====
181 -)))
182 182  
183 183  {{code}}
184 184  [https://www.example.com]
185 185  {{/code}}
186 186  
187 -* (((
186 +(((
188 188  === **Images** ===
189 189  )))
190 190  
... ... @@ -197,15 +197,15 @@
197 197  
198 198  Macros are powerful tools in XWiki that allow for dynamic content inclusion and advanced formatting. Here are ten notable macros to consider:ξˆ†
199 199  
200 -**Box Macro**: Encapsulates content within a styled box, useful for highlighting information.
199 +== Embed Macro ==
201 201  
202 -{{code}}
203 -{{box}}
204 -Your content here.
205 -{{/box}}
206 -{{/code}}
201 +The Embed macro shows external content like YouTube videos.
207 207  
203 +{{example}}
204 +{{embed url="https://www.youtube.com/watch?v=dQw4w9WgXcQ"/}}
205 +{{/example}}
208 208  
207 +
209 209  === **Info Macro**: Displays an informational message, often used for tips or notes. ===
210 210  
211 211  {{code}}
... ... @@ -215,15 +215,16 @@
215 215  {{/code}}
216 216  
217 217  
218 -=== **Warning Macro**: Highlights warnings or important notices. ===
217 +== Footnote Macro ==
219 219  
220 -{{code}}
221 -{{warning}}
222 -Caution: Proceed with care.
223 -{{/warning}}
224 -{{/code}}
219 +The Footnote macro adds footnotes to the page.
225 225  
221 +{{example}}
222 +This is a statement{{footnote}}Source: Example Reference{{/footnote}}.
223 +{{putFootnotes/}}
224 +{{/example}}
226 226  
226 +
227 227  === **Code Macro**: Renders code snippets with syntax highlighting. ===
228 228  
229 229  {{code}}
... ... @@ -250,28 +250,62 @@
250 250  {{toc/}}
251 251  {{/code}}
252 252  
253 +== Video Macro ==
253 253  
254 -=== **Include Macro**: Embeds content from another page. ===
255 +The Video macro embeds videos.
255 255  
256 -{{code}}
257 -{{include reference="PageName"/}}
258 -{{/code}}
257 +{{example}}
258 +{{video url="https://www.youtube.com/watch?v=dQw4w9WgXcQ"/}}
259 +{{/example}}
259 259  
261 +== Expandable Macro ==
262 +The following example demonstrates how to present complex information cleanly using `{{expandable}}` and `{{example}}`.
260 260  
261 -=== **Display Macro**: Displays the content of another document or an object property. ===
264 +{{example}}
265 +
266 +
267 +{{expandable summary="🧠 Study: Survey of Expert Opinion on Intelligence"}}
268 +**Source:** *Intelligence (Elsevier)*
269 +**Date:** *2019*
270 +**Authors:** *Heiner Rindermann, David Becker, Thomas R. Coyle*
271 +**DOI:** [10.1016/j.intell.2019.101406](https://doi.org/10.1016/j.intell.2019.101406)
272 +**Subject:** *Psychology, Intelligence Research*
262 262  
263 -{{code}}
264 -{{display reference="PageName"/}}
265 -{{/code}}
274 +{{expandable summary="πŸ“Š Key Statistics"}}
275 +- Survey of **102 intelligence experts**
276 +- **90% from Western countries**, **83% male**
277 +- **54% left-liberal**, **24% conservative**
278 +- **50/50 split** on genetic vs environmental causes of Black-White IQ gap
279 +{{/expandable}}
266 266  
281 +{{expandable summary="πŸ”¬ Findings"}}
282 +- Support for **g-factor theory**
283 +- Agreement on **heritability of intelligence**
284 +- Political lean: left = environmental, right = genetic causes
285 +{{/expandable}}
267 267  
268 -=== **Velocity Macro**: Executes Velocity scripts for dynamic content generation. ===
287 +{{expandable summary="πŸ“ Critique"}}
288 +- Largest expert survey on intelligence
289 +- **Western-only sample**, possible **self-selection bias**
290 +{{/expandable}}
269 269  
270 -{{code}}
271 -{{velocity}}
272 -#set($greeting = "Hello, $user.name!")
273 -$greeting
274 -{{/velocity}}
275 -{{/code}}
292 +{{expandable summary="πŸ“Œ Relevance"}}
293 +- Shows **ideological divide** in science
294 +- Highlights **media vs expert disconnect**
295 +{{/expandable}}
276 276  
277 -
297 +{{expandable summary="πŸ” Explore More"}}
298 +- Global surveys on intelligence beliefs
299 +- Media analysis follow-up studies
300 +{{/expandable}}
301 +
302 +{{expandable summary="πŸ“„ Download"}}
303 +[[Download Study>>attach:10.1016_j.intell.2019.101406.pdf]]
304 +{{/expandable}}
305 +{{/expandable}}
306 +{{/example}}
307 +
308 +
309 +== See Also: ==
310 +
311 +[[Syntax Help official documentation for a full list of formatting options>>doc:XWiki.XWikiSyntax]]