... |
... |
@@ -12,6 +12,98 @@ |
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 |
+ |
|
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 |
+ |
|
61 |
+footnote |
|
62 |
+ |
|
63 |
+== Groovy Lookup == |
|
64 |
+{{example}} |
|
65 |
+{{groovy}} |
|
66 |
+def now = new Date() |
|
67 |
+println("Current time: " + now) |
|
68 |
+{{/groovy}} |
|
69 |
+{{/example}} |
|
70 |
+ |
|
71 |
+ |
|
72 |
+== Expandable Summary == |
|
73 |
+{{example}} |
|
74 |
+{{expandable summary="🧠 Study Summary"}} |
|
75 |
+Key findings go here. |
|
76 |
+{{/expandable}} |
|
77 |
+{{/example}} |
|
78 |
+ |
|
79 |
+== List Formatting == |
|
80 |
+{{example}} |
|
81 |
+*Bad formatting* |
|
82 |
+* use - inconsistently |
|
83 |
+** Good formatting: |
|
84 |
+ * Consistent bullet style |
|
85 |
+ * Indented items properly |
|
86 |
+{{/example}} |
|
87 |
+ |
|
88 |
+== Python Code == |
|
89 |
+{{example}} |
|
90 |
+{{code language="python"}} |
|
91 |
+def greet(): |
|
92 |
+ print("Hello World") |
|
93 |
+{{/code}} |
|
94 |
+{{/example}} |
|
95 |
+ |
|
96 |
+== Audio Embedding == |
|
97 |
+{{example}} |
|
98 |
+ |
|
99 |
+{{html}} |
|
100 |
+<audio controls> |
|
101 |
+ <source src="/bin/download/Sandbox/TestPage2/Anti-Black%20racial%20slur%20was%20found%20written%20on%20high%20school%20desk%20in%20Rockville.mp3" type="audio/mpeg"> |
|
102 |
+ Your browser does not support the audio element. |
|
103 |
+</audio> |
|
104 |
+{{/html}} |
|
105 |
+{{/example}} |
|
106 |
+ |
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 |
17 |
== == |
... |
... |
@@ -96,10 +96,6 @@ |
96 |
96 |
* **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. |
97 |
97 |
* **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. |
98 |
98 |
|
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. citeturn0search6 |
102 |
|
- |
103 |
103 |
== **Essential Formatting Options** == |
104 |
104 |
|
105 |
105 |
To ensure content is both engaging and accessible, utilize the following formatting techniques: |
... |
... |
@@ -200,15 +200,15 @@ |
200 |
200 |
|
201 |
201 |
Macros are powerful tools in XWiki that allow for dynamic content inclusion and advanced formatting. Here are ten notable macros to consider: |
202 |
202 |
|
203 |
|
-**Box Macro**: Encapsulates content within a styled box, useful for highlighting information. |
|
291 |
+== Embed Macro == |
204 |
204 |
|
205 |
|
-{{code}} |
206 |
|
-{{box}} |
207 |
|
-Your content here. |
208 |
|
-{{/box}} |
209 |
|
-{{/code}} |
|
293 |
+The Embed macro shows external content like YouTube videos. |
210 |
210 |
|
|
295 |
+{{example}} |
|
296 |
+{{embed url="https://www.youtube.com/watch?v=dQw4w9WgXcQ"/}} |
|
297 |
+{{/example}} |
211 |
211 |
|
|
299 |
+ |
212 |
212 |
=== **Info Macro**: Displays an informational message, often used for tips or notes. === |
213 |
213 |
|
214 |
214 |
{{code}} |
... |
... |
@@ -218,15 +218,16 @@ |
218 |
218 |
{{/code}} |
219 |
219 |
|
220 |
220 |
|
221 |
|
-=== **Warning Macro**: Highlights warnings or important notices. === |
|
309 |
+== Footnote Macro == |
222 |
222 |
|
223 |
|
-{{code}} |
224 |
|
-{{warning}} |
225 |
|
-Caution: Proceed with care. |
226 |
|
-{{/warning}} |
227 |
|
-{{/code}} |
|
311 |
+The Footnote macro adds footnotes to the page. |
228 |
228 |
|
|
313 |
+{{example}} |
|
314 |
+This is a statement{{footnote}}Source: Example Reference{{/footnote}}. |
|
315 |
+{{putFootnotes/}} |
|
316 |
+{{/example}} |
229 |
229 |
|
|
318 |
+ |
230 |
230 |
=== **Code Macro**: Renders code snippets with syntax highlighting. === |
231 |
231 |
|
232 |
232 |
{{code}} |
... |
... |
@@ -253,30 +253,91 @@ |
253 |
253 |
{{toc/}} |
254 |
254 |
{{/code}} |
255 |
255 |
|
|
345 |
+== Video Macro == |
256 |
256 |
|
257 |
|
-=== **Include Macro**: Embeds content from another page. === |
|
347 |
+The Video macro embeds videos. |
258 |
258 |
|
259 |
|
-{{code}} |
260 |
|
-{{include reference="PageName"/}} |
261 |
|
-{{/code}} |
|
349 |
+{{example}} |
|
350 |
+{{video url="https://www.youtube.com/watch?v=dQw4w9WgXcQ"/}} |
|
351 |
+{{/example}} |
262 |
262 |
|
263 |
263 |
|
264 |
|
-=== **Display Macro**: Displays the content of another document or an object property. === |
|
354 |
+== Example Macro == |
265 |
265 |
|
266 |
|
-{{code}} |
267 |
|
-{{display reference="PageName"/}} |
268 |
|
-{{/code}} |
|
356 |
+The example macro displays the output of a macro or script or anything that you like |
|
357 |
+== Expandable Macro == |
269 |
269 |
|
|
359 |
+The following example demonstrates how to present complex information cleanly using ` |
270 |
270 |
|
271 |
|
-=== **Velocity Macro**: Executes Velocity scripts for dynamic content generation. === |
|
361 |
+{{example}} |
272 |
272 |
|
273 |
|
-{{code}} |
274 |
|
-{{velocity}} |
275 |
|
-#set($greeting = "Hello, $user.name!") |
276 |
|
-$greeting |
277 |
|
-{{/velocity}} |
278 |
|
-{{/code}} |
|
363 |
+{{expandable summary="Study: The Wilson Effect: The Increase in Heritability of IQ With Age"}} |
|
364 |
+**Source:** *Twin Research and Human Genetics (Cambridge University Press)* |
|
365 |
+**Date of Publication:** *2013* |
|
366 |
+**Author(s):** *Thomas J. Bouchard Jr.* |
|
367 |
+**Title:** *"The Wilson Effect: The Increase in Heritability of IQ With Age"* |
|
368 |
+**DOI:** [10.1017/thg.2013.54](https://doi.org/10.1017/thg.2013.54) |
|
369 |
+**Subject Matter:** *Intelligence, Heritability, Developmental Psychology* |
279 |
279 |
|
280 |
|
-== See Also: == |
|
371 |
+{{expandable summary="📊 Key Statistics"}} |
|
372 |
+1. **General Observations:** |
|
373 |
+ - The study documents how the **heritability of IQ increases with age**, reaching an asymptote at **0.80 by adulthood**. |
|
374 |
+ - Analysis is based on **longitudinal twin and adoption studies**. |
281 |
281 |
|
282 |
|
-[[Syntax Help official documentation for a full list of formatting options>>doc:XWiki.XWikiSyntax]] |
|
376 |
+2. **Subgroup Analysis:** |
|
377 |
+ - Shared environmental influence on IQ **declines with age**, reaching **0.10 in adulthood**. |
|
378 |
+ - Monozygotic twins show **increasing genetic similarity in IQ over time**, while dizygotic twins become **less concordant**. |
|
379 |
+ |
|
380 |
+3. **Other Significant Data Points:** |
|
381 |
+ - Data from the **Louisville Longitudinal Twin Study and cross-national twin samples** support findings. |
|
382 |
+ - IQ stability over time is **influenced more by genetics than by shared environmental factors**. |
|
383 |
+{{/expandable}} |
|
384 |
+ |
|
385 |
+{{expandable summary="🔬 Findings"}} |
|
386 |
+1. **Primary Observations:** |
|
387 |
+ - Intelligence heritability **strengthens throughout development**, contrary to early environmental models. |
|
388 |
+ - Shared environmental effects **decrease by late adolescence**, emphasizing **genetic influence in adulthood**. |
|
389 |
+ |
|
390 |
+2. **Subgroup Trends:** |
|
391 |
+ - Studies from **Scotland, Netherlands, and the US** show **consistent patterns of increasing heritability with age**. |
|
392 |
+ - Findings hold across **varied socio-economic and educational backgrounds**. |
|
393 |
+ |
|
394 |
+3. **Specific Case Analysis:** |
|
395 |
+ - Longitudinal adoption studies show **declining impact of adoptive parental influence on IQ** as children age. |
|
396 |
+ - Cross-sectional twin data confirm **higher IQ correlations for monozygotic twins in adulthood**. |
|
397 |
+{{/expandable}} |
|
398 |
+ |
|
399 |
+{{expandable summary="📝 Critique & Observations"}} |
|
400 |
+1. **Strengths of the Study:** |
|
401 |
+ - **Robust dataset covering multiple twin and adoption studies over decades**. |
|
402 |
+ - **Clear, replicable trend** demonstrating the increasing role of genetics in intelligence. |
|
403 |
+ |
|
404 |
+2. **Limitations of the Study:** |
|
405 |
+ - Findings apply primarily to **Western industrialized nations**, limiting generalizability. |
|
406 |
+ - **Lack of neurobiological mechanisms** explaining how genes express their influence over time. |
|
407 |
+ |
|
408 |
+3. **Suggestions for Improvement:** |
|
409 |
+ - Future research should investigate **gene-environment interactions in cognitive aging**. |
|
410 |
+ - Examine **heritability trends in non-Western populations** to determine cross-cultural consistency. |
|
411 |
+{{/expandable}} |
|
412 |
+ |
|
413 |
+{{expandable summary="📌 Relevance to Subproject"}} |
|
414 |
+- Provides **strong evidence for the genetic basis of intelligence**. |
|
415 |
+- Highlights the **diminishing role of shared environment in cognitive development**. |
|
416 |
+- Supports research on **cognitive aging and heritability across the lifespan**. |
|
417 |
+{{/expandable}} |
|
418 |
+ |
|
419 |
+{{expandable summary="🔍 Suggestions for Further Exploration"}} |
|
420 |
+1. Investigate **neurogenetic pathways underlying IQ development**. |
|
421 |
+2. Examine **how education and socioeconomic factors interact with genetic IQ influences**. |
|
422 |
+3. Study **heritability trends in aging populations and cognitive decline**. |
|
423 |
+{{/expandable}} |
|
424 |
+ |
|
425 |
+{{expandable summary="📄 Download Full Study"}} |
|
426 |
+[[Download Full Study>>attach:10.1017_thg.2013.54.pdf]] |
|
427 |
+{{/expandable}} |
|
428 |
+{{/expandable}} |
|
429 |
+{{/example}} |
|
430 |
+ |
|
431 |
+ |
|
432 |
+ |