0 Votes

Changes for page Start here if you're new

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

From version 27.1
edited by Ryan C
on 2025/05/14 15:40
Change comment: There is no comment for this version
To version 17.1
edited by Ryan C
on 2025/05/14 13:33
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -12,115 +12,9 @@
12 12  
13 13  == Getting Started with XWiki ==
14 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 -{{gallery}}
28 -[[image:photo1.jpg]]
29 -[[image:photo2.jpg]]
30 -{{/gallery}}
31 -{{/example}}
32 -
33 -
34 -== Boilerplate Box ==
35 -
36 -{{example}}
37 -{{box cssClass="highlight"}}
38 -Insert your highlighted content here.
39 -{{/box}}
40 -{{/example}}
41 -
42 -== Velocity Greeting ==
43 -
44 -{{example}}
45 -{{velocity}}
46 -#set($name = "Visitor")
47 -Hello, $name!
48 -{{/velocity}}
49 -{{/example}}
50 -
51 -
52 -== Info vs Warning ==
53 -
54 -{{example}}
55 -{{info}}
56 -This is an info box.
57 -{{/info}}
58 -
59 -{{warning}}
60 -This is a warning box.
61 -{{/warning}}
62 -{{/example}}
63 -
64 -== Footnote Demo ==
65 -{{example}}
66 -footnote{{footnote}} https://www.thewhitearchive.org/bin/view/Guides%20and%20Help/Start%20here%20if%20you're%20new/#edit{{/footnote}}
67 -
68 -{{putFootnotes/}}
69 -{{/example}}
70 -
71 -
72 -== Groovy Lookup ==
73 -
74 -{{example}}
75 -{{groovy}}
76 -def now = new Date()
77 -println("Current time: " + now)
78 -{{/groovy}}
79 -{{/example}}
80 -
81 -
82 -== Expandable Summary ==
83 -
84 -{{example}}
85 -{{expandable summary="🧠 Study Summary"}}
86 -Key findings go here.
87 -{{/expandable}}
88 -{{/example}}
89 -
90 -== List Formatting ==
91 -
92 -{{example}}
93 -*Bad formatting*
94 -
95 -* use - inconsistently
96 -** Good formatting:
97 -* Consistent bullet style
98 -* Indented items properly
99 -{{/example}}
100 -
101 -== Python Code ==
102 -
103 -{{example}}
104 -{{code language="python"}}
105 -def greet():
106 - print("Hello World")
107 -{{/code}}
108 -{{/example}}
109 -
110 -== Audio Embedding ==
111 -
112 -{{example}}
113 -{{html}}
114 -<audio controls>
115 - <source src="/bin/download/Sandbox/TestPage2/Anti-Black%20racial%20slur%20was%20found%20written%20on%20high%20school%20desk%20in%20Rockville.mp3" type="audio/mpeg">
116 - Your browser does not support the audio element.
117 -</audio>
118 -{{/html}}
119 -{{/example}}
120 -
121 121  This page covers all the essential steps and tips you need to create great content in XWiki without any confusion.
122 122  
123 -== ==
17 +== ==
124 124  
125 125  == 📎 **Attachments and Images** ==
126 126  
... ... @@ -219,7 +219,7 @@
219 219  
220 220  
221 221  
222 -*
116 +*
223 223  ** (((
224 224  === **Bold**: Surround text with double asterisks. ===
225 225  )))
... ... @@ -229,7 +229,7 @@
229 229  {{/code}}
230 230  
231 231  
232 -*
126 +*
233 233  ** (((
234 234  === **Italics**: Use double underscores. ===
235 235  )))
... ... @@ -239,7 +239,7 @@
239 239  {{/code}}
240 240  
241 241  
242 -*
136 +*
243 243  ** (((
244 244  === **Underline**: Enclose text with double tildes. ===
245 245  )))
... ... @@ -249,7 +249,7 @@
249 249  {{/code}}
250 250  
251 251  
252 -*
146 +*
253 253  ** (((
254 254  === **Unordered List**: Begin lines with asterisk (*) or hyphen (-). ===
255 255  )))
... ... @@ -260,7 +260,7 @@
260 260  {{/code}}
261 261  
262 262  
263 -*
157 +*
264 264  ** (((
265 265  === **Ordered List**: Start lines with a number followed by a period. ===
266 266  )))
... ... @@ -364,16 +364,12 @@
364 364  {{video url="https://www.youtube.com/watch?v=dQw4w9WgXcQ"/}}
365 365  {{/example}}
366 366  
367 -
368 -== Example Macro ==
369 -
370 -The example macro displays the output of a macro or script or anything that you like
371 -
372 372  == Expandable Macro ==
262 +The following example demonstrates how to present complex information cleanly using `{{expandable}}` and `{{example}}`.
373 373  
374 -The following example demonstrates how to present complex information cleanly using `
375 -
376 376  {{example}}
265 +
266 +
377 377  {{expandable summary="Study: The Wilson Effect: The Increase in Heritability of IQ With Age"}}
378 378  **Source:** *Twin Research and Human Genetics (Cambridge University Press)*
379 379  **Date of Publication:** *2013*
... ... @@ -440,7 +440,8 @@
440 440  [[Download Full Study>>attach:10.1017_thg.2013.54.pdf]]
441 441  {{/expandable}}
442 442  {{/expandable}}
443 -{{/example}}
444 444  
445 445  
446 -
335 +== See Also: ==
336 +
337 +[[Syntax Help official documentation for a full list of formatting options>>doc:XWiki.XWikiSyntax]]