0 Votes

Changes for page Start here if you're new

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

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

Summary

Details

Page properties
Content
... ... @@ -12,9 +12,115 @@
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 +
15 15  This page covers all the essential steps and tips you need to create great content in XWiki without any confusion.
16 16  
17 -== ==
123 +== ==
18 18  
19 19  == 📎 **Attachments and Images** ==
20 20  
... ... @@ -258,11 +258,16 @@
258 258  {{video url="https://www.youtube.com/watch?v=dQw4w9WgXcQ"/}}
259 259  {{/example}}
260 260  
367 +
368 +== Example Macro ==
369 +
370 +The example macro displays the output of a macro or script or anything that you like
371 +
261 261  == Expandable Macro ==
262 262  
263 263  The following example demonstrates how to present complex information cleanly using `
264 264  
265 -{{expandable summary="The Wilson Effect"}}
376 +{{example}}
266 266  {{expandable summary="Study: The Wilson Effect: The Increase in Heritability of IQ With Age"}}
267 267  **Source:** *Twin Research and Human Genetics (Cambridge University Press)*
268 268  **Date of Publication:** *2013*
... ... @@ -329,4 +329,7 @@
329 329  [[Download Full Study>>attach:10.1017_thg.2013.54.pdf]]
330 330  {{/expandable}}
331 331  {{/expandable}}
332 -{{/expandable}}
443 +{{/example}}
444 +
445 +
446 +