... |
... |
@@ -2,8 +2,10 @@ |
2 |
2 |
|
3 |
3 |
---- |
4 |
4 |
|
5 |
|
-== == |
|
5 |
+== Getting Started with XWiki == |
6 |
6 |
|
|
7 |
+This page covers all the essential steps and tips you need to create great content in XWiki without any confusion. |
|
8 |
+ |
7 |
7 |
== 📖 Table of Contents: == |
8 |
8 |
|
9 |
9 |
{{toc/}} |
... |
... |
@@ -10,119 +10,6 @@ |
10 |
10 |
|
11 |
11 |
---- |
12 |
12 |
|
13 |
|
-== Getting Started with XWiki == |
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 |
|
- |
66 |
|
-{{example}} |
67 |
|
-footnote{{footnote}} https://www.thewhitearchive.org/bin/view/Guides%20and%20Help/Start%20here%20if%20you're%20new/#edit{{/footnote}} |
68 |
|
- |
69 |
|
-{{putFootnotes/}} |
70 |
|
-{{/example}} |
71 |
|
- |
72 |
|
- |
73 |
|
-== Groovy Lookup == |
74 |
|
- |
75 |
|
-{{example}} |
76 |
|
-{{groovy}} |
77 |
|
-def now = new Date() |
78 |
|
-println("Current time: " + now) |
79 |
|
-{{/groovy}} |
80 |
|
-{{/example}} |
81 |
|
- |
82 |
|
- |
83 |
|
-== Expandable Summary == |
84 |
|
- |
85 |
|
-{{example}} |
86 |
|
-{{expandable summary="🧠 Study Summary"}} |
87 |
|
-Key findings go here. |
88 |
|
-{{/expandable}} |
89 |
|
-{{/example}} |
90 |
|
- |
91 |
|
-== List Formatting == |
92 |
|
- |
93 |
|
-{{example}} |
94 |
|
-*Bad formatting* |
95 |
|
- |
96 |
|
-* use - inconsistently |
97 |
|
-** Good formatting: |
98 |
|
-* Consistent bullet style |
99 |
|
-* Indented items properly |
100 |
|
-{{/example}} |
101 |
|
- |
102 |
|
-== Python Code == |
103 |
|
- |
104 |
|
-{{example}} |
105 |
|
-{{code language="python"}} |
106 |
|
-def greet(): |
107 |
|
- print("Hello World") |
108 |
|
-{{/code}} |
109 |
|
-{{/example}} |
110 |
|
- |
111 |
|
-== Audio Embedding == |
112 |
|
- |
113 |
|
-{{example}} |
114 |
|
-{{html}} |
115 |
|
-<audio controls> |
116 |
|
- <source src="/bin/download/Sandbox/TestPage2/Anti-Black%20racial%20slur%20was%20found%20written%20on%20high%20school%20desk%20in%20Rockville.mp3" type="audio/mpeg"> |
117 |
|
- Your browser does not support the audio element. |
118 |
|
-</audio> |
119 |
|
-{{/html}} |
120 |
|
-{{/example}} |
121 |
|
- |
122 |
|
-This page covers all the essential steps and tips you need to create great content in XWiki without any confusion. |
123 |
|
- |
124 |
|
-== == |
125 |
|
- |
126 |
126 |
== 📎 **Attachments and Images** == |
127 |
127 |
|
128 |
128 |
You can easily upload files and images directly from the WYSIWYG editor: |
... |
... |
@@ -140,8 +140,6 @@ |
140 |
140 |
1. Upload or select the image. |
141 |
141 |
1. Choose the **Thumbnail option** to create a clickable enlargable preview automatically. |
142 |
142 |
|
143 |
|
-[[image:1747262485678-297.png||data-xwiki-image-style="thumbnail-clickable" width="200"]] |
144 |
|
- |
145 |
145 |
---- |
146 |
146 |
|
147 |
147 |
== ⚡ **Using the / Macro Shortcut** == |
... |
... |
@@ -205,6 +205,10 @@ |
205 |
205 |
* **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. |
206 |
206 |
* **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. |
207 |
207 |
|
|
95 |
+=== **Switching Between Syntaxes** === |
|
96 |
+ |
|
97 |
+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 |
|
98 |
+ |
208 |
208 |
== **Essential Formatting Options** == |
209 |
209 |
|
210 |
210 |
To ensure content is both engaging and accessible, utilize the following formatting techniques: |
... |
... |
@@ -221,8 +221,7 @@ |
221 |
221 |
=== **Text Formatting** === |
222 |
222 |
|
223 |
223 |
|
224 |
|
- |
225 |
|
-* |
|
115 |
+* |
226 |
226 |
** ((( |
227 |
227 |
=== **Bold**: Surround text with double asterisks. === |
228 |
228 |
))) |
... |
... |
@@ -231,8 +231,7 @@ |
231 |
231 |
**bold text** |
232 |
232 |
{{/code}} |
233 |
233 |
|
234 |
|
- |
235 |
|
-* |
|
124 |
+* |
236 |
236 |
** ((( |
237 |
237 |
=== **Italics**: Use double underscores. === |
238 |
238 |
))) |
... |
... |
@@ -241,8 +241,7 @@ |
241 |
241 |
__italic text__ |
242 |
242 |
{{/code}} |
243 |
243 |
|
244 |
|
- |
245 |
|
-* |
|
133 |
+* |
246 |
246 |
** ((( |
247 |
247 |
=== **Underline**: Enclose text with double tildes. === |
248 |
248 |
))) |
... |
... |
@@ -251,8 +251,10 @@ |
251 |
251 |
~~underlined text~~ |
252 |
252 |
{{/code}} |
253 |
253 |
|
254 |
|
- |
255 |
255 |
* |
|
143 |
+* |
|
144 |
+ |
|
145 |
+* |
256 |
256 |
** ((( |
257 |
257 |
=== **Unordered List**: Begin lines with asterisk (*) or hyphen (-). === |
258 |
258 |
))) |
... |
... |
@@ -262,8 +262,7 @@ |
262 |
262 |
* Item 2 |
263 |
263 |
{{/code}} |
264 |
264 |
|
265 |
|
- |
266 |
|
-* |
|
155 |
+* |
267 |
267 |
** ((( |
268 |
268 |
=== **Ordered List**: Start lines with a number followed by a period. === |
269 |
269 |
))) |
... |
... |
@@ -273,11 +273,15 @@ |
273 |
273 |
2. Second item |
274 |
274 |
{{/code}} |
275 |
275 |
|
|
165 |
+* ((( |
|
166 |
+=== === |
|
167 |
+))) |
|
168 |
+* ((( |
|
169 |
+=== **Links** === |
|
170 |
+))) |
276 |
276 |
|
277 |
|
-== **Links** == |
278 |
278 |
|
279 |
279 |
|
280 |
|
- |
281 |
281 |
==== **Internal Link**: Use square brackets with the page name. ==== |
282 |
282 |
|
283 |
283 |
{{code}} |
... |
... |
@@ -284,15 +284,16 @@ |
284 |
284 |
[[PageName]] |
285 |
285 |
{{/code}} |
286 |
286 |
|
287 |
|
- |
288 |
|
- |
|
180 |
+* |
|
181 |
+** ((( |
289 |
289 |
==== **External Link**: Provide the URL directly. ==== |
|
183 |
+))) |
290 |
290 |
|
291 |
291 |
{{code}} |
292 |
292 |
[https://www.example.com] |
293 |
293 |
{{/code}} |
294 |
294 |
|
295 |
|
-((( |
|
189 |
+* ((( |
296 |
296 |
=== **Images** === |
297 |
297 |
))) |
298 |
298 |
|
... |
... |
@@ -305,17 +305,17 @@ |
305 |
305 |
|
306 |
306 |
Macros are powerful tools in XWiki that allow for dynamic content inclusion and advanced formatting. Here are ten notable macros to consider: |
307 |
307 |
|
308 |
|
-== Embed Macro == |
|
202 |
+1. **Box Macro**: Encapsulates content within a styled box, useful for highlighting information. |
309 |
309 |
|
310 |
|
-The Embed macro shows external content like YouTube videos. |
|
204 |
+{{code}} |
|
205 |
+{{box}} |
|
206 |
+Your content here. |
|
207 |
+{{/box}} |
|
208 |
+{{/code}} |
311 |
311 |
|
312 |
|
-{{example}} |
313 |
|
-{{embed url="https://www.youtube.com/watch?v=dQw4w9WgXcQ"/}} |
314 |
|
-{{/example}} |
315 |
315 |
|
|
211 |
+=== **Info Macro**: Displays an informational message, often used for tips or notes. === |
316 |
316 |
|
317 |
|
-=== **Info Macro**: Displays an informational message, often used for tips or notes. === |
318 |
|
- |
319 |
319 |
{{code}} |
320 |
320 |
{{info}} |
321 |
321 |
This is an informational note. |
... |
... |
@@ -323,18 +323,17 @@ |
323 |
323 |
{{/code}} |
324 |
324 |
|
325 |
325 |
|
326 |
|
-== Footnote Macro == |
|
220 |
+=== **Warning Macro**: Highlights warnings or important notices. === |
327 |
327 |
|
328 |
|
-The Footnote macro adds footnotes to the page. |
|
222 |
+{{code}} |
|
223 |
+{{warning}} |
|
224 |
+Caution: Proceed with care. |
|
225 |
+{{/warning}} |
|
226 |
+{{/code}} |
329 |
329 |
|
330 |
|
-{{example}} |
331 |
|
-This is a statement{{footnote}}Source: Example Reference{{/footnote}}. |
332 |
|
-{{putFootnotes/}} |
333 |
|
-{{/example}} |
334 |
334 |
|
|
229 |
+=== **Code Macro**: Renders code snippets with syntax highlighting. === |
335 |
335 |
|
336 |
|
-=== **Code Macro**: Renders code snippets with syntax highlighting. === |
337 |
|
- |
338 |
338 |
{{code}} |
339 |
339 |
{{code language="python"}} |
340 |
340 |
def hello_world(): |
... |
... |
@@ -343,7 +343,7 @@ |
343 |
343 |
{{/code}} |
344 |
344 |
|
345 |
345 |
|
346 |
|
-=== **Gallery Macro**: Creates an image gallery from attached images. === |
|
239 |
+=== **Gallery Macro**: Creates an image gallery from attached images. === |
347 |
347 |
|
348 |
348 |
{{code}} |
349 |
349 |
{{gallery}} |
... |
... |
@@ -359,91 +359,28 @@ |
359 |
359 |
{{toc/}} |
360 |
360 |
{{/code}} |
361 |
361 |
|
362 |
|
-== Video Macro == |
363 |
363 |
|
364 |
|
-The Video macro embeds videos. |
|
256 |
+=== **Include Macro**: Embeds content from another page. === |
365 |
365 |
|
366 |
|
-{{example}} |
367 |
|
-{{video url="https://www.youtube.com/watch?v=dQw4w9WgXcQ"/}} |
368 |
|
-{{/example}} |
|
258 |
+{{code}} |
|
259 |
+{{include reference="PageName"/}} |
|
260 |
+{{/code}} |
369 |
369 |
|
370 |
370 |
|
371 |
|
-== Example Macro == |
|
263 |
+=== **Display Macro**: Displays the content of another document or an object property. === |
372 |
372 |
|
373 |
|
-The example macro displays the output of a macro or script or anything that you like |
|
265 |
+{{code}} |
|
266 |
+{{display reference="PageName"/}} |
|
267 |
+{{/code}} |
374 |
374 |
|
375 |
|
-== Expandable Macro == |
376 |
376 |
|
377 |
|
-The following example demonstrates how to present complex information cleanly using ` |
|
270 |
+=== **Velocity Macro**: Executes Velocity scripts for dynamic content generation. === |
378 |
378 |
|
379 |
|
-{{example}} |
380 |
|
-{{expandable summary="Study: The Wilson Effect: The Increase in Heritability of IQ With Age"}} |
381 |
|
-**Source:** *Twin Research and Human Genetics (Cambridge University Press)* |
382 |
|
-**Date of Publication:** *2013* |
383 |
|
-**Author(s):** *Thomas J. Bouchard Jr.* |
384 |
|
-**Title:** *"The Wilson Effect: The Increase in Heritability of IQ With Age"* |
385 |
|
-**DOI:** [10.1017/thg.2013.54](https://doi.org/10.1017/thg.2013.54) |
386 |
|
-**Subject Matter:** *Intelligence, Heritability, Developmental Psychology* |
|
272 |
+{{code}} |
|
273 |
+{{velocity}} |
|
274 |
+#set($greeting = "Hello, $user.name!") |
|
275 |
+$greeting |
|
276 |
+{{/velocity}} |
|
277 |
+{{/code}} |
387 |
387 |
|
388 |
|
-{{expandable summary="📊 Key Statistics"}} |
389 |
|
-1. **General Observations:** |
390 |
|
- - The study documents how the **heritability of IQ increases with age**, reaching an asymptote at **0.80 by adulthood**. |
391 |
|
- - Analysis is based on **longitudinal twin and adoption studies**. |
392 |
|
- |
393 |
|
-2. **Subgroup Analysis:** |
394 |
|
- - Shared environmental influence on IQ **declines with age**, reaching **0.10 in adulthood**. |
395 |
|
- - Monozygotic twins show **increasing genetic similarity in IQ over time**, while dizygotic twins become **less concordant**. |
396 |
|
- |
397 |
|
-3. **Other Significant Data Points:** |
398 |
|
- - Data from the **Louisville Longitudinal Twin Study and cross-national twin samples** support findings. |
399 |
|
- - IQ stability over time is **influenced more by genetics than by shared environmental factors**. |
400 |
|
-{{/expandable}} |
401 |
|
- |
402 |
|
-{{expandable summary="🔬 Findings"}} |
403 |
|
-1. **Primary Observations:** |
404 |
|
- - Intelligence heritability **strengthens throughout development**, contrary to early environmental models. |
405 |
|
- - Shared environmental effects **decrease by late adolescence**, emphasizing **genetic influence in adulthood**. |
406 |
|
- |
407 |
|
-2. **Subgroup Trends:** |
408 |
|
- - Studies from **Scotland, Netherlands, and the US** show **consistent patterns of increasing heritability with age**. |
409 |
|
- - Findings hold across **varied socio-economic and educational backgrounds**. |
410 |
|
- |
411 |
|
-3. **Specific Case Analysis:** |
412 |
|
- - Longitudinal adoption studies show **declining impact of adoptive parental influence on IQ** as children age. |
413 |
|
- - Cross-sectional twin data confirm **higher IQ correlations for monozygotic twins in adulthood**. |
414 |
|
-{{/expandable}} |
415 |
|
- |
416 |
|
-{{expandable summary="📝 Critique & Observations"}} |
417 |
|
-1. **Strengths of the Study:** |
418 |
|
- - **Robust dataset covering multiple twin and adoption studies over decades**. |
419 |
|
- - **Clear, replicable trend** demonstrating the increasing role of genetics in intelligence. |
420 |
|
- |
421 |
|
-2. **Limitations of the Study:** |
422 |
|
- - Findings apply primarily to **Western industrialized nations**, limiting generalizability. |
423 |
|
- - **Lack of neurobiological mechanisms** explaining how genes express their influence over time. |
424 |
|
- |
425 |
|
-3. **Suggestions for Improvement:** |
426 |
|
- - Future research should investigate **gene-environment interactions in cognitive aging**. |
427 |
|
- - Examine **heritability trends in non-Western populations** to determine cross-cultural consistency. |
428 |
|
-{{/expandable}} |
429 |
|
- |
430 |
|
-{{expandable summary="📌 Relevance to Subproject"}} |
431 |
|
-- Provides **strong evidence for the genetic basis of intelligence**. |
432 |
|
-- Highlights the **diminishing role of shared environment in cognitive development**. |
433 |
|
-- Supports research on **cognitive aging and heritability across the lifespan**. |
434 |
|
-{{/expandable}} |
435 |
|
- |
436 |
|
-{{expandable summary="🔍 Suggestions for Further Exploration"}} |
437 |
|
-1. Investigate **neurogenetic pathways underlying IQ development**. |
438 |
|
-2. Examine **how education and socioeconomic factors interact with genetic IQ influences**. |
439 |
|
-3. Study **heritability trends in aging populations and cognitive decline**. |
440 |
|
-{{/expandable}} |
441 |
|
- |
442 |
|
-{{expandable summary="📄 Download Full Study"}} |
443 |
|
-[[Download Full Study>>attach:10.1017_thg.2013.54.pdf]] |
444 |
|
-{{/expandable}} |
445 |
|
-{{/expandable}} |
446 |
|
-{{/example}} |
447 |
|
- |
448 |
|
- |
449 |
449 |
|