0 Votes

Changes for page Start here if you're new

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

From version 23.1
edited by Ryan C
on 2025/05/14 15:33
Change comment: There is no comment for this version
To version 7.1
edited by Ryan C
on 2025/03/16 01:16
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -2,121 +2,20 @@
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 -{{toc/}}
11 +* [[Editing with the WYSIWYG Editor>>https://chatgpt.com/c/67d66d62-3244-800a-8974-570f38118948#editing-pages]]
12 +* [[Inserting Attachments and Images>>https://chatgpt.com/c/67d66d62-3244-800a-8974-570f38118948#attachments]]
13 +* [[Using the / Macro Shortcut>>https://chatgpt.com/c/67d66d62-3244-800a-8974-570f38118948#macros]]
14 +* [[Basic Formatting and Links>>https://chatgpt.com/c/67d66d62-3244-800a-8974-570f38118948#formatting]]
15 +* [[Useful Tips>>https://chatgpt.com/c/67d66d62-3244-800a-8974-570f38118948#tips]]
10 10  
11 11  ----
12 12  
13 -== Getting Started with XWiki ==
14 -
15 -The example macro in XWiki is an underrated powerhouse—great for *teaching*, *showcasing macros*, *hiding complex markup*, and *letting users play with source-output pairs*. Here are some **highly effective and interesting uses**:
16 -
17 ----
18 -
19 -## 🧪 1. **Macro Showcase: Source-to-Output Toggle**
20 -
21 -Show how a macro works without cluttering the page with raw syntax.
22 -
23 -
24 -== Gallery Macro ==
25 -
26 -{{example}}
27 -
28 -{{gallery}}
29 -[[image:photo1.jpg]]
30 -[[image:photo2.jpg]]
31 -{{/gallery}}
32 -
33 -{{/example}}
34 -
35 -
36 -== Boilerplate Box ==
37 -{{example}}
38 -{{box cssClass="highlight"}}
39 -Insert your highlighted content here.
40 -{{/box}}
41 -{{/example}}
42 -
43 -== Velocity Greeting ==
44 -{{example}}
45 -{{velocity}}
46 -#set($name = "Visitor")
47 -Hello, $name!
48 -{{/velocity}}
49 -{{/example}}
50 -
51 -
52 -== Info vs Warning ==
53 -{{example}}
54 -{{info}}This is an info box.{{/info}}
55 -
56 -{{warning}}This is a warning box.{{/warning}}
57 -{{/example}}
58 -
59 -== Footnote Demo ==
60 -{{example}}
61 -This claim needs a source{{footnote}}Here it is.{{/footnote}}.
62 -{{putFootnotes/}}
63 -{{/example}}
64 -
65 -== Groovy Lookup ==
66 -{{example}}
67 -{{groovy}}
68 -def now = new Date()
69 -println("Current time: " + now)
70 -{{/groovy}}
71 -{{/example}}
72 -
73 -
74 -== Access Current User ==
75 -{{example}}
76 -{{velocity}}
77 -Current user: **$xcontext.user**
78 -{{/velocity}}
79 -{{/example}}
80 -
81 -
82 -== Expandable Summary ==
83 -{{example}}
84 -{{expandable summary="🧠 Study Summary"}}
85 -Key findings go here.
86 -{{/expandable}}
87 -{{/example}}
88 -
89 -== List Formatting ==
90 -{{example}}
91 -*Bad formatting*
92 -* use - inconsistently
93 -** Good formatting:
94 - * Consistent bullet style
95 - * Indented items properly
96 -{{/example}}
97 -
98 -== Python Code ==
99 -{{example}}
100 -{{code language="python"}}
101 -def greet():
102 - print("Hello World")
103 -{{/code}}
104 -{{/example}}
105 -
106 -== Audio Embedding ==
107 -{{example}}
108 -{{html}}
109 -<audio controls>
110 - <source src="/bin/download/Sandbox/TestPage2/Anti-Black%20racial%20slur%20was%20found%20written%20on%20high%20school%20desk%20in%20Rockville.mp3" type="audio/mpeg">
111 - Your browser does not support the audio element.
112 -</audio>
113 -{{/html}}
114 -{{/example}}
115 -
116 -This page covers all the essential steps and tips you need to create great content in XWiki without any confusion.
117 -
118 -== ==
119 -
120 120  == 📎 **Attachments and Images** ==
121 121  
122 122  You can easily upload files and images directly from the WYSIWYG editor:
... ... @@ -153,7 +153,7 @@
153 153  
154 154  ----
155 155  
156 -== ✏️** Basic Formatting and Links (Quick Guide)** ==
55 +== ✏️** Basic Formatting and Links (Quick Guide)** ==
157 157  
158 158  * **Bold text**: Select text, click the **Bold** button or press Ctrl + B.
159 159  * **Italic text**: Select text, click "Italic" in the toolbar or use Ctrl+I.
... ... @@ -197,6 +197,10 @@
197 197  * **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.
198 198  * **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.
199 199  
99 +=== **Switching Between Syntaxes** ===
100 +
101 +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
102 +
200 200  == **Essential Formatting Options** ==
201 201  
202 202  To ensure content is both engaging and accessible, utilize the following formatting techniques:
... ... @@ -213,7 +213,6 @@
213 213  === **Text Formatting** ===
214 214  
215 215  
216 -
217 217  *
218 218  ** (((
219 219  === **Bold**: Surround text with double asterisks. ===
... ... @@ -223,7 +223,6 @@
223 223  **bold text**
224 224  {{/code}}
225 225  
226 -
227 227  *
228 228  ** (((
229 229  === **Italics**: Use double underscores. ===
... ... @@ -233,7 +233,6 @@
233 233  __italic text__
234 234  {{/code}}
235 235  
236 -
237 237  *
238 238  ** (((
239 239  === **Underline**: Enclose text with double tildes. ===
... ... @@ -243,6 +243,8 @@
243 243  ~~underlined text~~
244 244  {{/code}}
245 245  
146 +*
147 +*
246 246  
247 247  *
248 248  ** (((
... ... @@ -254,7 +254,6 @@
254 254  * Item 2
255 255  {{/code}}
256 256  
257 -
258 258  *
259 259  ** (((
260 260  === **Ordered List**: Start lines with a number followed by a period. ===
... ... @@ -265,11 +265,15 @@
265 265  2. Second item
266 266  {{/code}}
267 267  
169 +* (((
170 +=== ===
171 +)))
172 +* (((
173 +=== **Links** ===
174 +)))
268 268  
269 -== **Links** ==
270 270  
271 271  
272 -
273 273  ==== **Internal Link**: Use square brackets with the page name. ====
274 274  
275 275  {{code}}
... ... @@ -276,15 +276,16 @@
276 276  [[PageName]]
277 277  {{/code}}
278 278  
279 -
280 -
184 +*
185 +** (((
281 281  ==== **External Link**: Provide the URL directly. ====
187 +)))
282 282  
283 283  {{code}}
284 284  [https://www.example.com]
285 285  {{/code}}
286 286  
287 -(((
193 +* (((
288 288  === **Images** ===
289 289  )))
290 290  
... ... @@ -297,17 +297,17 @@
297 297  
298 298  Macros are powerful tools in XWiki that allow for dynamic content inclusion and advanced formatting. Here are ten notable macros to consider:
299 299  
300 -== Embed Macro ==
206 +1. **Box Macro**: Encapsulates content within a styled box, useful for highlighting information.
301 301  
302 -The Embed macro shows external content like YouTube videos.
208 +{{code}}
209 +{{box}}
210 +Your content here.
211 +{{/box}}
212 +{{/code}}
303 303  
304 -{{example}}
305 -{{embed url="https://www.youtube.com/watch?v=dQw4w9WgXcQ"/}}
306 -{{/example}}
307 307  
215 +=== **Info Macro**: Displays an informational message, often used for tips or notes. ===
308 308  
309 -=== **Info Macro**: Displays an informational message, often used for tips or notes. ===
310 -
311 311  {{code}}
312 312  {{info}}
313 313  This is an informational note.
... ... @@ -315,18 +315,17 @@
315 315  {{/code}}
316 316  
317 317  
318 -== Footnote Macro ==
224 +=== **Warning Macro**: Highlights warnings or important notices. ===
319 319  
320 -The Footnote macro adds footnotes to the page.
226 +{{code}}
227 +{{warning}}
228 +Caution: Proceed with care.
229 +{{/warning}}
230 +{{/code}}
321 321  
322 -{{example}}
323 -This is a statement{{footnote}}Source: Example Reference{{/footnote}}.
324 -{{putFootnotes/}}
325 -{{/example}}
326 326  
233 +=== **Code Macro**: Renders code snippets with syntax highlighting. ===
327 327  
328 -=== **Code Macro**: Renders code snippets with syntax highlighting. ===
329 -
330 330  {{code}}
331 331  {{code language="python"}}
332 332  def hello_world():
... ... @@ -335,7 +335,7 @@
335 335  {{/code}}
336 336  
337 337  
338 -=== **Gallery Macro**: Creates an image gallery from attached images. ===
243 +=== **Gallery Macro**: Creates an image gallery from attached images. ===
339 339  
340 340  {{code}}
341 341  {{gallery}}
... ... @@ -351,91 +351,28 @@
351 351  {{toc/}}
352 352  {{/code}}
353 353  
354 -== Video Macro ==
355 355  
356 -The Video macro embeds videos.
260 +=== **Include Macro**: Embeds content from another page. ===
357 357  
358 -{{example}}
359 -{{video url="https://www.youtube.com/watch?v=dQw4w9WgXcQ"/}}
360 -{{/example}}
262 +{{code}}
263 +{{include reference="PageName"/}}
264 +{{/code}}
361 361  
362 362  
363 -== Example Macro ==
267 +=== **Display Macro**: Displays the content of another document or an object property. ===
364 364  
365 -The example macro displays the output of a macro or script or anything that you like
366 -== Expandable Macro ==
269 +{{code}}
270 +{{display reference="PageName"/}}
271 +{{/code}}
367 367  
368 -The following example demonstrates how to present complex information cleanly using `
369 369  
370 -{{example}}
274 +=== **Velocity Macro**: Executes Velocity scripts for dynamic content generation. ===
371 371  
372 -{{expandable summary="Study: The Wilson Effect: The Increase in Heritability of IQ With Age"}}
373 -**Source:** *Twin Research and Human Genetics (Cambridge University Press)*
374 -**Date of Publication:** *2013*
375 -**Author(s):** *Thomas J. Bouchard Jr.*
376 -**Title:** *"The Wilson Effect: The Increase in Heritability of IQ With Age"*
377 -**DOI:** [10.1017/thg.2013.54](https://doi.org/10.1017/thg.2013.54)
378 -**Subject Matter:** *Intelligence, Heritability, Developmental Psychology*
276 +{{code}}
277 +{{velocity}}
278 +#set($greeting = "Hello, $user.name!")
279 +$greeting
280 +{{/velocity}}
281 +{{/code}}
379 379  
380 -{{expandable summary="📊 Key Statistics"}}
381 -1. **General Observations:**
382 - - The study documents how the **heritability of IQ increases with age**, reaching an asymptote at **0.80 by adulthood**.
383 - - Analysis is based on **longitudinal twin and adoption studies**.
384 -
385 -2. **Subgroup Analysis:**
386 - - Shared environmental influence on IQ **declines with age**, reaching **0.10 in adulthood**.
387 - - Monozygotic twins show **increasing genetic similarity in IQ over time**, while dizygotic twins become **less concordant**.
388 -
389 -3. **Other Significant Data Points:**
390 - - Data from the **Louisville Longitudinal Twin Study and cross-national twin samples** support findings.
391 - - IQ stability over time is **influenced more by genetics than by shared environmental factors**.
392 -{{/expandable}}
393 -
394 -{{expandable summary="🔬 Findings"}}
395 -1. **Primary Observations:**
396 - - Intelligence heritability **strengthens throughout development**, contrary to early environmental models.
397 - - Shared environmental effects **decrease by late adolescence**, emphasizing **genetic influence in adulthood**.
398 -
399 -2. **Subgroup Trends:**
400 - - Studies from **Scotland, Netherlands, and the US** show **consistent patterns of increasing heritability with age**.
401 - - Findings hold across **varied socio-economic and educational backgrounds**.
402 -
403 -3. **Specific Case Analysis:**
404 - - Longitudinal adoption studies show **declining impact of adoptive parental influence on IQ** as children age.
405 - - Cross-sectional twin data confirm **higher IQ correlations for monozygotic twins in adulthood**.
406 -{{/expandable}}
407 -
408 -{{expandable summary="📝 Critique & Observations"}}
409 -1. **Strengths of the Study:**
410 - - **Robust dataset covering multiple twin and adoption studies over decades**.
411 - - **Clear, replicable trend** demonstrating the increasing role of genetics in intelligence.
412 -
413 -2. **Limitations of the Study:**
414 - - Findings apply primarily to **Western industrialized nations**, limiting generalizability.
415 - - **Lack of neurobiological mechanisms** explaining how genes express their influence over time.
416 -
417 -3. **Suggestions for Improvement:**
418 - - Future research should investigate **gene-environment interactions in cognitive aging**.
419 - - Examine **heritability trends in non-Western populations** to determine cross-cultural consistency.
420 -{{/expandable}}
421 -
422 -{{expandable summary="📌 Relevance to Subproject"}}
423 -- Provides **strong evidence for the genetic basis of intelligence**.
424 -- Highlights the **diminishing role of shared environment in cognitive development**.
425 -- Supports research on **cognitive aging and heritability across the lifespan**.
426 -{{/expandable}}
427 -
428 -{{expandable summary="🔍 Suggestions for Further Exploration"}}
429 -1. Investigate **neurogenetic pathways underlying IQ development**.
430 -2. Examine **how education and socioeconomic factors interact with genetic IQ influences**.
431 -3. Study **heritability trends in aging populations and cognitive decline**.
432 -{{/expandable}}
433 -
434 -{{expandable summary="📄 Download Full Study"}}
435 -[[Download Full Study>>attach:10.1017_thg.2013.54.pdf]]
436 -{{/expandable}}
437 -{{/expandable}}
438 -{{/example}}
439 -
440 -
441 -
283 +