0 Votes

Changes for page Start here if you're new

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

From version 26.1
edited by Ryan C
on 2025/05/14 15:38
Change comment: There is no comment for this version
To version 10.1
edited by Ryan C
on 2025/03/16 01:21
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,117 +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 -footnote{{footnote}} https://www.thewhitearchive.org/bin/view/Guides%20and%20Help/Start%20here%20if%20you're%20new/#edit{{/footnote}}
67 -
68 -{{putFootnotes/}}
69 -
70 -
71 -== Groovy Lookup ==
72 -
73 -{{example}}
74 -{{groovy}}
75 -def now = new Date()
76 -println("Current time: " + now)
77 -{{/groovy}}
78 -{{/example}}
79 -
80 -
81 -== Expandable Summary ==
82 -
83 -{{example}}
84 -{{expandable summary="๐Ÿง  Study Summary"}}
85 -Key findings go here.
86 -{{/expandable}}
87 -{{/example}}
88 -
89 -== List Formatting ==
90 -
91 -{{example}}
92 -*Bad formatting*
93 -
94 -* use - inconsistently
95 -** Good formatting:
96 -* Consistent bullet style
97 -* Indented items properly
98 -{{/example}}
99 -
100 -== Python Code ==
101 -
102 -{{example}}
103 -{{code language="python"}}
104 -def greet():
105 - print("Hello World")
106 -{{/code}}
107 -{{/example}}
108 -
109 -== Audio Embedding ==
110 -
111 -{{example}}
112 -{{html}}
113 -<audio controls>
114 - <source src="/bin/download/Sandbox/TestPage2/Anti-Black%20racial%20slur%20was%20found%20written%20on%20high%20school%20desk%20in%20Rockville.mp3" type="audio/mpeg">
115 - Your browser does not support the audio element.
116 -</audio>
117 -{{/html}}
118 -{{/example}}
119 -
120 -This page covers all the essential steps and tips you need to create great content in XWiki without any confusion.
121 -
122 -== ==
123 -
124 124  == ๐Ÿ“Ž **Attachments and Images** ==
125 125  
126 126  You can easily upload files and images directly from the WYSIWYG editor:
... ... @@ -201,6 +201,10 @@
201 201  * **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.๎ˆ†
202 202  * **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.๎ˆ†
203 203  
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 +
204 204  == **Essential Formatting Options** ==
205 205  
206 206  To ensure content is both engaging and accessible, utilize the following formatting techniques:๎ˆ†
... ... @@ -274,21 +274,22 @@
274 274  
275 275  
276 276  
277 -==== **Internal Link**: Use square brackets with the page name. ====
172 +==== ** Internal Link**: Use square brackets with the page name. ====
278 278  
279 279  {{code}}
280 280  [[PageName]]
281 281  {{/code}}
282 282  
283 -
284 -
178 +*
179 +** (((
285 285  ==== **External Link**: Provide the URL directly. ====
181 +)))
286 286  
287 287  {{code}}
288 288  [https://www.example.com]
289 289  {{/code}}
290 290  
291 -(((
187 +* (((
292 292  === **Images** ===
293 293  )))
294 294  
... ... @@ -301,15 +301,15 @@
301 301  
302 302  Macros are powerful tools in XWiki that allow for dynamic content inclusion and advanced formatting. Here are ten notable macros to consider:๎ˆ†
303 303  
304 -== Embed Macro ==
200 +**Box Macro**: Encapsulates content within a styled box, useful for highlighting information.
305 305  
306 -The Embed macro shows external content like YouTube videos.
202 +{{code}}
203 +{{box}}
204 +Your content here.
205 +{{/box}}
206 +{{/code}}
307 307  
308 -{{example}}
309 -{{embed url="https://www.youtube.com/watch?v=dQw4w9WgXcQ"/}}
310 -{{/example}}
311 311  
312 -
313 313  === **Info Macro**: Displays an informational message, often used for tips or notes. ===
314 314  
315 315  {{code}}
... ... @@ -319,16 +319,15 @@
319 319  {{/code}}
320 320  
321 321  
322 -== Footnote Macro ==
218 +=== **Warning Macro**: Highlights warnings or important notices. ===
323 323  
324 -The Footnote macro adds footnotes to the page.
220 +{{code}}
221 +{{warning}}
222 +Caution: Proceed with care.
223 +{{/warning}}
224 +{{/code}}
325 325  
326 -{{example}}
327 -This is a statement{{footnote}}Source: Example Reference{{/footnote}}.
328 -{{putFootnotes/}}
329 -{{/example}}
330 330  
331 -
332 332  === **Code Macro**: Renders code snippets with syntax highlighting. ===
333 333  
334 334  {{code}}
... ... @@ -355,91 +355,28 @@
355 355  {{toc/}}
356 356  {{/code}}
357 357  
358 -== Video Macro ==
359 359  
360 -The Video macro embeds videos.
254 +=== **Include Macro**: Embeds content from another page. ===
361 361  
362 -{{example}}
363 -{{video url="https://www.youtube.com/watch?v=dQw4w9WgXcQ"/}}
364 -{{/example}}
256 +{{code}}
257 +{{include reference="PageName"/}}
258 +{{/code}}
365 365  
366 366  
367 -== Example Macro ==
261 +=== **Display Macro**: Displays the content of another document or an object property. ===
368 368  
369 -The example macro displays the output of a macro or script or anything that you like
263 +{{code}}
264 +{{display reference="PageName"/}}
265 +{{/code}}
370 370  
371 -== Expandable Macro ==
372 372  
373 -The following example demonstrates how to present complex information cleanly using `
268 +=== **Velocity Macro**: Executes Velocity scripts for dynamic content generation. ===
374 374  
375 -{{example}}
376 -{{expandable summary="Study: The Wilson Effect: The Increase in Heritability of IQ With Age"}}
377 -**Source:** *Twin Research and Human Genetics (Cambridge University Press)*
378 -**Date of Publication:** *2013*
379 -**Author(s):** *Thomas J. Bouchard Jr.*
380 -**Title:** *"The Wilson Effect: The Increase in Heritability of IQ With Age"*
381 -**DOI:** [10.1017/thg.2013.54](https://doi.org/10.1017/thg.2013.54)
382 -**Subject Matter:** *Intelligence, Heritability, Developmental Psychology*
270 +{{code}}
271 +{{velocity}}
272 +#set($greeting = "Hello, $user.name!")
273 +$greeting
274 +{{/velocity}}
275 +{{/code}}
383 383  
384 -{{expandable summary="๐Ÿ“Š Key Statistics"}}
385 -1. **General Observations:**
386 - - The study documents how the **heritability of IQ increases with age**, reaching an asymptote at **0.80 by adulthood**.
387 - - Analysis is based on **longitudinal twin and adoption studies**.
388 -
389 -2. **Subgroup Analysis:**
390 - - Shared environmental influence on IQ **declines with age**, reaching **0.10 in adulthood**.
391 - - Monozygotic twins show **increasing genetic similarity in IQ over time**, while dizygotic twins become **less concordant**.
392 -
393 -3. **Other Significant Data Points:**
394 - - Data from the **Louisville Longitudinal Twin Study and cross-national twin samples** support findings.
395 - - IQ stability over time is **influenced more by genetics than by shared environmental factors**.
396 -{{/expandable}}
397 -
398 -{{expandable summary="๐Ÿ”ฌ Findings"}}
399 -1. **Primary Observations:**
400 - - Intelligence heritability **strengthens throughout development**, contrary to early environmental models.
401 - - Shared environmental effects **decrease by late adolescence**, emphasizing **genetic influence in adulthood**.
402 -
403 -2. **Subgroup Trends:**
404 - - Studies from **Scotland, Netherlands, and the US** show **consistent patterns of increasing heritability with age**.
405 - - Findings hold across **varied socio-economic and educational backgrounds**.
406 -
407 -3. **Specific Case Analysis:**
408 - - Longitudinal adoption studies show **declining impact of adoptive parental influence on IQ** as children age.
409 - - Cross-sectional twin data confirm **higher IQ correlations for monozygotic twins in adulthood**.
410 -{{/expandable}}
411 -
412 -{{expandable summary="๐Ÿ“ Critique & Observations"}}
413 -1. **Strengths of the Study:**
414 - - **Robust dataset covering multiple twin and adoption studies over decades**.
415 - - **Clear, replicable trend** demonstrating the increasing role of genetics in intelligence.
416 -
417 -2. **Limitations of the Study:**
418 - - Findings apply primarily to **Western industrialized nations**, limiting generalizability.
419 - - **Lack of neurobiological mechanisms** explaining how genes express their influence over time.
420 -
421 -3. **Suggestions for Improvement:**
422 - - Future research should investigate **gene-environment interactions in cognitive aging**.
423 - - Examine **heritability trends in non-Western populations** to determine cross-cultural consistency.
424 -{{/expandable}}
425 -
426 -{{expandable summary="๐Ÿ“Œ Relevance to Subproject"}}
427 -- Provides **strong evidence for the genetic basis of intelligence**.
428 -- Highlights the **diminishing role of shared environment in cognitive development**.
429 -- Supports research on **cognitive aging and heritability across the lifespan**.
430 -{{/expandable}}
431 -
432 -{{expandable summary="๐Ÿ” Suggestions for Further Exploration"}}
433 -1. Investigate **neurogenetic pathways underlying IQ development**.
434 -2. Examine **how education and socioeconomic factors interact with genetic IQ influences**.
435 -3. Study **heritability trends in aging populations and cognitive decline**.
436 -{{/expandable}}
437 -
438 -{{expandable summary="๐Ÿ“„ Download Full Study"}}
439 -[[Download Full Study>>attach:10.1017_thg.2013.54.pdf]]
440 -{{/expandable}}
441 -{{/expandable}}
442 -{{/example}}
443 -
444 -
445 445