0 Votes

Changes for page Start here if you're new

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

From version 28.1
edited by Ryan C
on 2025/05/14 15:42
Change comment: There is no comment for this version
To version 8.1
edited by Ryan C
on 2025/03/16 01:18
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -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. citeturn0search6
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  
1747262485678-297.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.AdminAngriff
Size
... ... @@ -1,1 +1,0 @@
1 -1.6 MB
Content