0 Votes

Changes for page Start here if you're new

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

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

Summary

Details

Page properties
Content
... ... @@ -2,20 +2,20 @@
2 2  
3 3  ----
4 4  
5 -== Getting Started with XWiki ==
5 +== ==
6 6  
7 -This page covers all the essential steps and tips you need to create great content in XWiki without any confusion.
8 -
9 9  == πŸ“– Table of Contents: ==
10 10  
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]]
9 +{{toc/}}
16 16  
17 17  ----
18 18  
13 +== Getting Started with XWiki ==
14 +
15 +This page covers all the essential steps and tips you need to create great content in XWiki without any confusion.
16 +
17 +== ==
18 +
19 19  == πŸ“Ž **Attachments and Images** ==
20 20  
21 21  You can easily upload files and images directly from the WYSIWYG editor:
... ... @@ -52,7 +52,7 @@
52 52  
53 53  ----
54 54  
55 -== ✏️** Basic Formatting and Links (Quick Guide)** ==
55 +== ✏️** Basic Formatting and Links (Quick Guide)** ==
56 56  
57 57  * **Bold text**: Select text, click the **Bold** button or press Ctrl + B.
58 58  * **Italic text**: Select text, click "Italic" in the toolbar or use Ctrl+I.
... ... @@ -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. ξˆ€citeξˆ‚turn0search6ξˆξˆ†
102 -
103 103  == **Essential Formatting Options** ==
104 104  
105 105  To ensure content is both engaging and accessible, utilize the following formatting techniques:ξˆ†
... ... @@ -116,7 +116,8 @@
116 116  === **Text Formatting** ===
117 117  
118 118  
119 -*
115 +
116 +*
120 120  ** (((
121 121  === **Bold**: Surround text with double asterisks. ===
122 122  )))
... ... @@ -125,7 +125,8 @@
125 125  **bold text**
126 126  {{/code}}
127 127  
128 -*
125 +
126 +*
129 129  ** (((
130 130  === **Italics**: Use double underscores. ===
131 131  )))
... ... @@ -134,7 +134,8 @@
134 134  __italic text__
135 135  {{/code}}
136 136  
137 -*
135 +
136 +*
138 138  ** (((
139 139  === **Underline**: Enclose text with double tildes. ===
140 140  )))
... ... @@ -143,10 +143,8 @@
143 143  ~~underlined text~~
144 144  {{/code}}
145 145  
146 -*
147 -*
148 148  
149 -*
146 +*
150 150  ** (((
151 151  === **Unordered List**: Begin lines with asterisk (*) or hyphen (-). ===
152 152  )))
... ... @@ -156,7 +156,8 @@
156 156  * Item 2
157 157  {{/code}}
158 158  
159 -*
156 +
157 +*
160 160  ** (((
161 161  === **Ordered List**: Start lines with a number followed by a period. ===
162 162  )))
... ... @@ -166,15 +166,11 @@
166 166  2. Second item
167 167  {{/code}}
168 168  
169 -* (((
170 -=== ===
171 -)))
172 -* (((
173 -=== **Links** ===
174 -)))
175 175  
168 +== **Links** ==
176 176  
177 177  
171 +
178 178  ==== **Internal Link**: Use square brackets with the page name. ====
179 179  
180 180  {{code}}
... ... @@ -181,16 +181,15 @@
181 181  [[PageName]]
182 182  {{/code}}
183 183  
184 -*
185 -** (((
178 +
179 +
186 186  ==== **External Link**: Provide the URL directly. ====
187 -)))
188 188  
189 189  {{code}}
190 190  [https://www.example.com]
191 191  {{/code}}
192 192  
193 -* (((
186 +(((
194 194  === **Images** ===
195 195  )))
196 196  
... ... @@ -203,17 +203,17 @@
203 203  
204 204  Macros are powerful tools in XWiki that allow for dynamic content inclusion and advanced formatting. Here are ten notable macros to consider:ξˆ†
205 205  
206 -1. **Box Macro**: Encapsulates content within a styled box, useful for highlighting information.ξˆ†
199 +== Embed Macro ==
207 207  
208 -{{code}}
209 -{{box}}
210 -Your content here.
211 -{{/box}}
212 -{{/code}}
201 +The Embed macro shows external content like YouTube videos.
213 213  
203 +{{example}}
204 +{{embed url="https://www.youtube.com/watch?v=dQw4w9WgXcQ"/}}
205 +{{/example}}
214 214  
215 -=== **Info Macro**: Displays an informational message, often used for tips or notes.ξˆ† ===
216 216  
208 +=== **Info Macro**: Displays an informational message, often used for tips or notes. ===
209 +
217 217  {{code}}
218 218  {{info}}
219 219  This is an informational note.
... ... @@ -221,17 +221,18 @@
221 221  {{/code}}
222 222  
223 223  
224 -=== **Warning Macro**: Highlights warnings or important notices.ξˆ† ===
217 +== Footnote Macro ==
225 225  
226 -{{code}}
227 -{{warning}}
228 -Caution: Proceed with care.
229 -{{/warning}}
230 -{{/code}}
219 +The Footnote macro adds footnotes to the page.
231 231  
221 +{{example}}
222 +This is a statement{{footnote}}Source: Example Reference{{/footnote}}.
223 +{{putFootnotes/}}
224 +{{/example}}
232 232  
233 -=== **Code Macro**: Renders code snippets with syntax highlighting.ξˆ† ===
234 234  
227 +=== **Code Macro**: Renders code snippets with syntax highlighting. ===
228 +
235 235  {{code}}
236 236  {{code language="python"}}
237 237  def hello_world():
... ... @@ -240,7 +240,7 @@
240 240  {{/code}}
241 241  
242 242  
243 -=== **Gallery Macro**: Creates an image gallery from attached images.ξˆ† ===
237 +=== **Gallery Macro**: Creates an image gallery from attached images. ===
244 244  
245 245  {{code}}
246 246  {{gallery}}
... ... @@ -256,28 +256,60 @@
256 256  {{toc/}}
257 257  {{/code}}
258 258  
253 +== Video Macro ==
259 259  
260 -=== **Include Macro**: Embeds content from another page. ===
255 +The Video macro embeds videos.
261 261  
262 -{{code}}
263 -{{include reference="PageName"/}}
264 -{{/code}}
257 +{{example}}
258 +{{video url="https://www.youtube.com/watch?v=dQw4w9WgXcQ"/}}
259 +{{/example}}
265 265  
261 +== Expandable Macro ==
262 +The following example demonstrates how to present complex information cleanly using `{{expandable}}` and `{{example}}`.
266 266  
267 -=== **Display Macro**: Displays the content of another document or an object property. ===
264 +{{example}}
265 +{{expandable summary="🧠 Study: Survey of Expert Opinion on Intelligence"}}
266 +**Source:** *Intelligence (Elsevier)*
267 +**Date:** *2019*
268 +**Authors:** *Heiner Rindermann, David Becker, Thomas R. Coyle*
269 +**DOI:** [10.1016/j.intell.2019.101406](https://doi.org/10.1016/j.intell.2019.101406)
270 +**Subject:** *Psychology, Intelligence Research*
268 268  
269 -{{code}}
270 -{{display reference="PageName"/}}
271 -{{/code}}
272 +{{expandable summary="πŸ“Š Key Statistics"}}
273 +- Survey of **102 intelligence experts**
274 +- **90% from Western countries**, **83% male**
275 +- **54% left-liberal**, **24% conservative**
276 +- **50/50 split** on genetic vs environmental causes of Black-White IQ gap
277 +{{/expandable}}
272 272  
279 +{{expandable summary="πŸ”¬ Findings"}}
280 +- Support for **g-factor theory**
281 +- Agreement on **heritability of intelligence**
282 +- Political lean: left = environmental, right = genetic causes
283 +{{/expandable}}
273 273  
274 -=== **Velocity Macro**: Executes Velocity scripts for dynamic content generation. ===
285 +{{expandable summary="πŸ“ Critique"}}
286 +- Largest expert survey on intelligence
287 +- **Western-only sample**, possible **self-selection bias**
288 +{{/expandable}}
275 275  
276 -{{code}}
277 -{{velocity}}
278 -#set($greeting = "Hello, $user.name!")
279 -$greeting
280 -{{/velocity}}
281 -{{/code}}
290 +{{expandable summary="πŸ“Œ Relevance"}}
291 +- Shows **ideological divide** in science
292 +- Highlights **media vs expert disconnect**
293 +{{/expandable}}
282 282  
283 -
295 +{{expandable summary="πŸ” Explore More"}}
296 +- Global surveys on intelligence beliefs
297 +- Media analysis follow-up studies
298 +{{/expandable}}
299 +
300 +{{expandable summary="πŸ“„ Download"}}
301 +[[Download Study>>attach:10.1016_j.intell.2019.101406.pdf]]
302 +{{/expandable}}
303 +{{/expandable}}
304 +{{/example}}
305 +
306 +
307 +== See Also: ==
308 +
309 +[[Syntax Help official documentation for a full list of formatting options>>doc:XWiki.XWikiSyntax]]