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 31.1
edited by Ryan C
on 2025/05/14 15:48
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -14,26 +14,33 @@
14 14  
15 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 16  
17 ----
17 +----
18 18  
19 -## 🧪 1. **Macro Showcase: Source-to-Output Toggle**
19 +## 🧪 1. **Macro Showcase: Source-to-Output Toggle**##
20 20  
21 -Show how a macro works without cluttering the page with raw syntax.
21 +In this section we will go over many of the common macros used. The source code is how you use the macro editing in Wiki mode. If you are doing standard WYSIWYG edit mode (the default mode you get when you click edit instead of the dropdown), you can call most of these macros by simply typing /thecommand
22 22  
23 23  
24 -== Gallery Macro ==
24 +== Gallery Macro `/gallery` ==
25 25  
26 26  {{example}}
27 -
28 28  {{gallery}}
29 -[[image:photo1.jpg]]
28 +[[1747262485678-297.png]]
30 30  [[image:photo2.jpg]]
31 31  {{/gallery}}
32 -
33 33  {{/example}}
34 34  
33 +Alternatively 
34 +\\
35 35  
36 +{{example}}
37 +{{carousel/}}
38 +
39 +
40 +{{/example}}
41 +
36 36  == Boilerplate Box ==
43 +
37 37  {{example}}
38 38  {{box cssClass="highlight"}}
39 39  Insert your highlighted content here.
... ... @@ -41,6 +41,7 @@
41 41  {{/example}}
42 42  
43 43  == Velocity Greeting ==
51 +
44 44  {{example}}
45 45  {{velocity}}
46 46  #set($name = "Visitor")
... ... @@ -50,19 +50,28 @@
50 50  
51 51  
52 52  == Info vs Warning ==
61 +
53 53  {{example}}
54 -{{info}}This is an info box.{{/info}}
63 +{{info}}
64 +This is an info box.
65 +{{/info}}
55 55  
56 -{{warning}}This is a warning box.{{/warning}}
67 +{{warning}}
68 +This is a warning box.
69 +{{/warning}}
57 57  {{/example}}
58 58  
59 59  == Footnote Demo ==
73 +
60 60  {{example}}
61 -This claim needs a source{{footnote}}Here it is.{{/footnote}}.
75 +footnote{{footnote}} https://www.thewhitearchive.org/bin/view/Guides%20and%20Help/Start%20here%20if%20you're%20new/#edit{{/footnote}}
76 +
62 62  {{putFootnotes/}}
63 63  {{/example}}
64 64  
80 +
65 65  == Groovy Lookup ==
82 +
66 66  {{example}}
67 67  {{groovy}}
68 68  def now = new Date()
... ... @@ -71,15 +71,8 @@
71 71  {{/example}}
72 72  
73 73  
74 -== Access Current User ==
75 -{{example}}
76 -{{velocity}}
77 -Current user: **$xcontext.user**
78 -{{/velocity}}
79 -{{/example}}
80 -
81 -
82 82  == Expandable Summary ==
92 +
83 83  {{example}}
84 84  {{expandable summary="🧠 Study Summary"}}
85 85  Key findings go here.
... ... @@ -87,15 +87,18 @@
87 87  {{/example}}
88 88  
89 89  == List Formatting ==
100 +
90 90  {{example}}
91 91  *Bad formatting*
103 +
92 92  * use - inconsistently
93 93  ** Good formatting:
94 - * Consistent bullet style
95 - * Indented items properly
106 +* Consistent bullet style
107 +* Indented items properly
96 96  {{/example}}
97 97  
98 98  == Python Code ==
111 +
99 99  {{example}}
100 100  {{code language="python"}}
101 101  def greet():
... ... @@ -104,6 +104,7 @@
104 104  {{/example}}
105 105  
106 106  == Audio Embedding ==
120 +
107 107  {{example}}
108 108  {{html}}
109 109  <audio controls>
... ... @@ -112,10 +112,10 @@
112 112  </audio>
113 113  {{/html}}
114 114  {{/example}}
115 -
129 +
116 116  This page covers all the essential steps and tips you need to create great content in XWiki without any confusion.
117 117  
118 -== ==
132 +== ==
119 119  
120 120  == 📎 **Attachments and Images** ==
121 121  
... ... @@ -134,6 +134,8 @@
134 134  1. Upload or select the image.
135 135  1. Choose the **Thumbnail option** to create a clickable enlargable preview automatically.
136 136  
151 +[[image:1747262485678-297.png||data-xwiki-image-style="thumbnail-clickable" width="200"]]
152 +
137 137  ----
138 138  
139 139  == ⚡ **Using the / Macro Shortcut** ==
... ... @@ -363,12 +363,12 @@
363 363  == Example Macro ==
364 364  
365 365  The example macro displays the output of a macro or script or anything that you like
382 +
366 366  == Expandable Macro ==
367 367  
368 368  The following example demonstrates how to present complex information cleanly using `
369 369  
370 370  {{example}}
371 -
372 372  {{expandable summary="Study: The Wilson Effect: The Increase in Heritability of IQ With Age"}}
373 373  **Source:** *Twin Research and Human Genetics (Cambridge University Press)*
374 374  **Date of Publication:** *2013*
... ... @@ -438,4 +438,4 @@
438 438  {{/example}}
439 439  
440 440  
441 -
457 +
1747262485678-297.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.AdminAngriff
Size
... ... @@ -1,0 +1,1 @@
1 +1.6 MB
Content