0 Votes

Changes for page Start here if you're new

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

From version 27.1
edited by Ryan C
on 2025/05/14 15:40
Change comment: There is no comment for this version
To version 7.1
edited by Ryan C
on 2025/03/16 01:16
Change comment: There is no comment for this version

Summary

Details

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