Changes for page Start here if you're new
Last modified by Ryan C on 2025/06/28 04:59
From 22.1 to 21.1
Show context
Hide context
Summary
Details
-
Page properties
-
- Content
-
... ... @@ -12,17 +12,16 @@ 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**: 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 21 Show how a macro works without cluttering the page with raw syntax. 22 22 23 - 23 +```xwiki 24 24 == Gallery Macro == 25 - 26 26 {{example}} 27 27 {{gallery}} 28 28 [[image:photo1.jpg]] ... ... @@ -29,18 +29,33 @@ 29 29 [[image:photo2.jpg]] 30 30 {{/gallery}} 31 31 {{/example}} 31 +``` 32 32 33 +**Why it's good:** New users see both source and result without confusion. 33 33 34 - == Boilerplate Box ==35 +--- 35 35 37 +## 📝 2. **Editable Template Snippets** 38 + 39 +Use `{{example}}` to store reusable content that users can copy, paste, and modify. 40 + 41 +```xwiki 42 +== Boilerplate Box == 36 36 {{example}} 37 37 {{box cssClass="highlight"}} 38 38 Insert your highlighted content here. 39 39 {{/box}} 40 40 {{/example}} 48 +``` 41 41 42 - == Velocity Greeting ==50 +--- 43 43 52 +## 🎓 3. **Educational Tutorials (e.g., Velocity or Groovy)** 53 + 54 +Teach scripting with real, live code examples. 55 + 56 +```xwiki 57 +== Velocity Greeting == 44 44 {{example}} 45 45 {{velocity}} 46 46 #set($name = "Visitor") ... ... @@ -47,26 +47,45 @@ 47 47 Hello, $name! 48 48 {{/velocity}} 49 49 {{/example}} 64 +``` 50 50 66 +--- 51 51 52 - ==InfovsWarning==68 +## 🎯 4. **Comparing Macro Parameters** 53 53 70 +Demonstrate how different macro parameters change output—side-by-side. 71 + 72 +```xwiki 73 +== Info vs Warning == 54 54 {{example}} 55 -{{info}} 56 -This is an info box. 57 -{{/info}} 75 +{{info}}This is an info box.{{/info}} 58 58 59 -{{warning}} 60 -This is a warning box. 61 -{{/warning}} 77 +{{warning}}This is a warning box.{{/warning}} 62 62 {{/example}} 79 +``` 63 63 81 +--- 82 + 83 +## 🧩 5. **Interactive Data Blocks (TOC, Footnotes, etc.)** 84 + 85 +Visually show what happens when you use certain macros together. 86 + 87 +```xwiki 64 64 == Footnote Demo == 89 +{{example}} 90 +This claim needs a source{{footnote}}Here it is.{{/footnote}}. 91 +{{putFootnotes/}} 92 +{{/example}} 93 +``` 65 65 66 - footnote{{footnote}} a footnote source{{/footnote}}95 +--- 67 67 68 - ==GroovyLookup==97 +## 🧪 6. **Live Scripting Playgrounds** 69 69 99 +Embed small self-contained scripting playgrounds where users can view or modify dynamic output. 100 + 101 +```xwiki 102 +== Groovy Lookup == 70 70 {{example}} 71 71 {{groovy}} 72 72 def now = new Date() ... ... @@ -73,29 +73,61 @@ 73 73 println("Current time: " + now) 74 74 {{/groovy}} 75 75 {{/example}} 109 +``` 76 76 111 +--- 77 77 78 - ==ExpandableSummary==113 +## 📦 7. **Component/API Call Demos** 79 79 115 +Useful for devs exploring the API. 116 + 117 +```xwiki 118 +== Access Current User == 80 80 {{example}} 120 +{{velocity}} 121 +Current user: **$xcontext.user** 122 +{{/velocity}} 123 +{{/example}} 124 +``` 125 + 126 +--- 127 + 128 +## 📘 8. **Expandable Wiki Templates with Output** 129 + 130 +Pair `{{example}}` with `{{expandable}}` for full disclosure without visual clutter. 131 + 132 +```xwiki 133 +== Expandable Summary == 134 +{{example}} 81 81 {{expandable summary="🧠 Study Summary"}} 82 82 Key findings go here. 83 83 {{/expandable}} 84 84 {{/example}} 139 +``` 85 85 86 - == List Formatting ==141 +--- 87 87 143 +## 🔧 9. **Syntax Training: Bad vs Good** 144 + 145 +Side-by-side "Do this, not that" with toggles. 146 + 147 +```xwiki 148 +== List Formatting == 88 88 {{example}} 89 89 *Bad formatting* 90 - 91 91 * use - inconsistently 92 92 ** Good formatting: 93 -* Consistent bullet style 94 -* Indented items properly 153 + * Consistent bullet style 154 + * Indented items properly 95 95 {{/example}} 156 +``` 96 96 97 - == Python Code ==158 +--- 98 98 160 +## 💡 Bonus Tip: Combine `{{example}}` + `{{code}}` for Highlighted Snippets 161 + 162 +```xwiki 163 +== Python Code == 99 99 {{example}} 100 100 {{code language="python"}} 101 101 def greet(): ... ... @@ -102,21 +102,16 @@ 102 102 print("Hello World") 103 103 {{/code}} 104 104 {{/example}} 170 +``` 105 105 106 - == Audio Embedding ==172 +--- 107 107 108 -{{example}} 109 -{{html}} 110 -<audio controls> 111 - <source src="/bin/download/Sandbox/TestPage2/Anti-Black%20racial%20slur%20was%20found%20written%20on%20high%20school%20desk%20in%20Rockville.mp3" type="audio/mpeg"> 112 - Your browser does not support the audio element. 113 -</audio> 114 -{{/html}} 115 -{{/example}} 174 +Want me to generate a panel with these uses or make a macro gallery page pre-filled with them? 116 116 176 + 117 117 This page covers all the essential steps and tips you need to create great content in XWiki without any confusion. 118 118 119 -== == 179 +== == 120 120 121 121 == 📎 **Attachments and Images** == 122 122 ... ... @@ -364,12 +364,12 @@ 364 364 == Example Macro == 365 365 366 366 The example macro displays the output of a macro or script or anything that you like 367 - 368 368 == Expandable Macro == 369 369 370 370 The following example demonstrates how to present complex information cleanly using ` 371 371 372 372 {{example}} 432 + 373 373 {{expandable summary="Study: The Wilson Effect: The Increase in Heritability of IQ With Age"}} 374 374 **Source:** *Twin Research and Human Genetics (Cambridge University Press)* 375 375 **Date of Publication:** *2013* ... ... @@ -439,4 +439,4 @@ 439 439 {{/example}} 440 440 441 441 442 - 502 +