أدوات المستخدم

أدوات الموقع


wiki:syntax

اختلافات

عرض الاختلافات بين النسخة المختارة و النسخة الحالية من الصفحة.

رابط إلى هذه المقارنة

جانبي المراجعة السابقةالمراجعة السابقة
المراجعة الأخيرةجانبي المراجعة التالية
wiki:syntax [2022/11/07 12:53] mhsabbaghwiki:syntax [2022/11/07 12:54] mhsabbagh
سطر 1: سطر 1:
 ====== دليل التنسيق ====== ====== دليل التنسيق ======
  
-======   DokuWiki   supports some simple markup language, which tries to make the datafiles to be as readable as possible. This page contains all possible syntax you may use when editing the pages. Simply have a look at the source of this page by pressing "Edit this page". If you want to try something, just use the  playground  page. The simpler markup is easily accessible via  quickbuttons , too.   ======+DokuWiki supports some simple markup language, which tries to make the datafiles to be as readable as possible. This page contains all possible syntax you may use when editing the pages. Simply have a look at the source of this page by pressing "Edit this page". If you want to try something, just use the playground page. The simpler markup is easily accessible via quickbuttons , too.
  
 ===== Basic Text Formatting ===== ===== Basic Text Formatting =====
سطر 12: سطر 12:
 </code> </code>
  
-You can use <sub>subscript</sub> and <sup>superscript</sup> , too.+You can use <sub>subscript</sub> and <sup>superscript</sup>  , too.
 <code> <code>
 You can use <sub>subscript</sub>  and <sup>superscript</sup> , too. You can use <sub>subscript</sub>  and <sup>superscript</sup> , too.
سطر 26: سطر 26:
 **Paragraphs** are created from blank lines. If you want to **force a newline** without a paragraph, you can use two backslashes followed by a whitespace or the end of line. **Paragraphs** are created from blank lines. If you want to **force a newline** without a paragraph, you can use two backslashes followed by a whitespace or the end of line.
  
-This is some text with some \linebreaks +This is some text with some \linebreaks Note that the two backslashes are only recognized at the end of a \line or followed \by a whitespace \\this happens without it.
-Note that the two backslashes are only recognized at the end of a \line +
-or followed \by +
-a whitespace \\this happens without it.+
  
 <code> <code>
سطر 65: سطر 62:
 </code> </code>
  
-[[doku>www.dokuwiki.org/pagename|Wiki pagenames]] are converted to lowercase automatically, special characters are not allowed.+[[doku>www.dokuwiki.org/www.dokuwiki.org/pagename|Wiki pagenames]] are converted to lowercase automatically, special characters are not allowed.
  
 You can use [[:some:namespaces|namespaces]] by using a colon in the pagename. You can use [[:some:namespaces|namespaces]] by using a colon in the pagename.
سطر 86: سطر 83:
  
   * Links to [[:wiki:syntax|existing pages]] are shown in a different style from [[:wiki:nonexisting|nonexisting]] ones.   * Links to [[:wiki:syntax|existing pages]] are shown in a different style from [[:wiki:nonexisting|nonexisting]] ones.
-  * DokuWiki does not use [[wp>en.wikipedia.org/wiki/CamelCase|CamelCase]] to automatically create links by default, but this behavior can be enabled in the [[doku>config]] file. Hint: If DokuWiki is a link, then it's enabled.+  * DokuWiki does not use [[wp>en.wikipedia.org/wiki/en.wikipedia.org/wiki/CamelCase|CamelCase]] to automatically create links by default, but this behavior can be enabled in the [[doku>config]] file. Hint: If DokuWiki is a link, then it's enabled.
   * When a section's heading is changed, its bookmark changes, too. So don't rely on section linking too much.   * When a section's heading is changed, its bookmark changes, too. So don't rely on section linking too much.
  
سطر 142: سطر 139:
 ===== Footnotes ===== ===== Footnotes =====
  
-You can add footnotes ((This is a footnote))   by using double parentheses.+You can add footnotes ((This is a footnote))  by using double parentheses.
 <code> <code>
  
سطر 172: سطر 169:
 ===== Media Files ===== ===== Media Files =====
  
-You can include external and internal [[doku>www.dokuwiki.org/images|images, videos and audio files]] with curly brackets. Optionally you can specify the size of them.+You can include external and internal [[doku>www.dokuwiki.org/www.dokuwiki.org/images|images, videos and audio files]] with curly brackets. Optionally you can specify the size of them.
  
 Real size: [[https://linux-2-day.com/lib/exe/detail.php?id=wiki:syntax&media=wiki:dokuwiki-128.png|{{:wiki:dokuwiki-128.png}}]] Real size: [[https://linux-2-day.com/lib/exe/detail.php?id=wiki:syntax&media=wiki:dokuwiki-128.png|{{:wiki:dokuwiki-128.png}}]]
سطر 180: سطر 177:
 Resize to given width and height((when the aspect ratio of the given width and height doesn't match that of the image, it will be cropped to the new ratio before resizing)) : [[https://linux-2-day.com/lib/exe/detail.php?id=wiki:syntax&media=wiki:dokuwiki-128.png|{{:wiki:dokuwiki-128.png?200x50}}]] Resize to given width and height((when the aspect ratio of the given width and height doesn't match that of the image, it will be cropped to the new ratio before resizing)) : [[https://linux-2-day.com/lib/exe/detail.php?id=wiki:syntax&media=wiki:dokuwiki-128.png|{{:wiki:dokuwiki-128.png?200x50}}]]
  
-Resized external image:           [[https://linux-2-day.com/lib/exe/fetch.php?tok=34bb7b&media=https://secure.php.net/images/php.gif|{{https://secure.php.net/images/php.gif?direct&200x50}}]]+Resized external image: [[https://linux-2-day.com/lib/exe/fetch.php?tok=34bb7b&media=https://secure.php.net/images/php.gif|{{https://secure.php.net/images/php.gif?direct&200x50}}]]
 <code> <code>
  
سطر 234: سطر 231:
 </code> </code>
  
-{{https://linux-2-day.com/lib/exe/fetch.php?media=wiki:dokuwiki-128.png?linkonly|dokuwiki-128.png}}  This is just a link to the image.+{{https://linux-2-day.com/lib/exe/fetch.php?tok=315117&media=https://linux-2-day.com/lib/exe/fetch.php?media=wiki:dokuwiki-128.png?linkonly|dokuwiki-128.png}} This is just a link to the image.
  
 ==== Fallback Formats ==== ==== Fallback Formats ====
سطر 254: سطر 251:
  
 Dokuwiki supports ordered and unordered lists. To create a list item, indent your text by two spaces and use a ''*''  for unordered lists or a ''-''  for ordered ones. Dokuwiki supports ordered and unordered lists. To create a list item, indent your text by two spaces and use a ''*''  for unordered lists or a ''-''  for ordered ones.
 +
   * This is a list   * This is a list
   * The second item   * The second item
سطر 277: سطر 275:
 </code> </code>
  
-Also take a look at the [[doku>www.dokuwiki.org/faq:lists|FAQ on list items]].+Also take a look at the [[doku>www.dokuwiki.org/www.dokuwiki.org/faq:lists|FAQ on list items]].
  
 ===== Text Conversions ===== ===== Text Conversions =====
سطر 289: سطر 287:
 DokuWiki converts commonly used [[wp>emoticon]]s to their graphical equivalents. Those [[doku>Smileys]] and other images can be configured and extended. Here is an overview of Smileys included in DokuWiki: DokuWiki converts commonly used [[wp>emoticon]]s to their graphical equivalents. Those [[doku>Smileys]] and other images can be configured and extended. Here is an overview of Smileys included in DokuWiki:
  
-  * 8-)  <nowiki> 8-) </nowiki> +  * 8-) <nowiki> 8-) </nowiki> 
-  * 8-O  <nowiki> 8-O </nowiki> +  * 8-O <nowiki> 8-O </nowiki> 
-  * :-(  <nowiki> :-( </nowiki> +  * :-( <nowiki> :-( </nowiki> 
-  * :-)  <nowiki> :-) </nowiki> +  * :-) <nowiki> :-) </nowiki> 
-  * =)  <nowiki> =) </nowiki> +  * =) <nowiki> =) </nowiki> 
-  * :-/  <nowiki> :-/ </nowiki> +  * :-/ <nowiki> :-/ </nowiki> 
-  * :-" class=  <nowiki> :- </nowiki> +  * :-" class= <nowiki> :- </nowiki> 
-  * :-?  <nowiki> :-? </nowiki> +  * :-? <nowiki> :-? </nowiki> 
-  * :-D  <nowiki> :-D </nowiki> +  * :-D <nowiki> :-D </nowiki> 
-  * :-P  <nowiki> :-P </nowiki> +  * :-P <nowiki> :-P </nowiki> 
-  * :-O  <nowiki> :-O </nowiki> +  * :-O <nowiki> :-O </nowiki> 
-  * :-X  <nowiki> :-X </nowiki> +  * :-X <nowiki> :-X </nowiki> 
-  * :-|  <nowiki> :-| </nowiki> +  * :-| <nowiki> :-| </nowiki> 
-  *;-)  <nowiki>;-) </nowiki> +  *;-) <nowiki>;-) </nowiki> 
-  * ^_^  <nowiki> ^_^ </nowiki> +  * ^_^ <nowiki> ^_^ </nowiki> 
-  * m(  <nowiki> m( </nowiki> +  * m( <nowiki> m( </nowiki> 
-  * :?:  <nowiki> :?: </nowiki> +  * :?: <nowiki> :?: </nowiki> 
-  * :!:  <nowiki> :!: </nowiki> +  * :!: <nowiki> :!: </nowiki> 
-  * LOL  <nowiki> LOL </nowiki> +  * LOL <nowiki> LOL </nowiki> 
-  * FIXME  <nowiki> FIXME </nowiki> +  * FIXME <nowiki> FIXME </nowiki> 
-  * DELETEME  <nowiki> DELETEME </nowiki>+  * DELETEME <nowiki> DELETEME </nowiki>
  
 ==== Text to HTML Conversions ==== ==== Text to HTML Conversions ====
سطر 323: سطر 321:
 </code> </code>
  
-The same can be done to produce any kind of HTML, it just needs to be added to the [[doku>www.dokuwiki.org/entities|pattern file]].+The same can be done to produce any kind of HTML, it just needs to be added to the [[doku>www.dokuwiki.org/www.dokuwiki.org/entities|pattern file]].
  
 There are three exceptions which do not come from that pattern file: multiplication entity (640×480), 'single' and "double quotes". They can be turned off through a [[doku>config:typography|config option]]. There are three exceptions which do not come from that pattern file: multiplication entity (640×480), 'single' and "double quotes". They can be turned off through a [[doku>config:typography|config option]].
سطر 332: سطر 330:
 <code> <code>
  
-I think we should do it +I think we should do it> No we shouldn't
-> No we shouldn't+
  
 >> Well, I say we should >> Well, I say we should
سطر 366: سطر 363:
 |Row 3 Col 1  |Row 3 Col 2  |Row 3 Col 3  | |Row 3 Col 1  |Row 3 Col 2  |Row 3 Col 3  |
  
-Table rows have to start and end with a ''''| for normal rows or a ''''^ for headers.+Table rows have to start and end with a | for normal rows or a ^ for headers.
 <code> <code>
  
سطر 433: سطر 430:
 ===== No Formatting ===== ===== No Formatting =====
  
-If you need to display text exactly like it is typed (without any formatting), enclose the area either with ''<nowiki>''  tags or even simpler, with double percent signs ''<nowiki>%%</nowiki>''.+If you need to display text exactly like it is typed (without any formatting), enclose the area either with ''<nowiki>'' tags or even simpler, with double percent signs ''<nowiki>%%</nowiki>''.
  
 <nowiki> This is some text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it. </nowiki> The same is true for <nowiki>//__this__ text// with a smiley;-)</nowiki>. <nowiki> This is some text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it. </nowiki> The same is true for <nowiki>//__this__ text// with a smiley;-)</nowiki>.
سطر 447: سطر 444:
 ===== Code Blocks ===== ===== Code Blocks =====
  
-You can include code blocks into your documents by either indenting them by at least two spaces (like used for the previous examples) or by using the tags ''<code>''  or ''<file>''.+You can include code blocks into your documents by either indenting them by at least two spaces (like used for the previous examples) or by using the tags '' or ''<file>''''
  
-<code> +''<code> This is text is indented by two spaces. ''
-This is text is indented by two spaces. +
- +
-</code>+
  
 <code> <code>
سطر 480: سطر 474:
  
 <code> <code>
- 
 This is pretty much the same, but you could use it to show that you quoted a file. This is pretty much the same, but you could use it to show that you quoted a file.
  
سطر 499: سطر 492:
     }     }
 } }
 +
  
 </code> </code>
سطر 508: سطر 502:
 ==== Downloadable Code Blocks ==== ==== Downloadable Code Blocks ====
  
-When you use the ''<code>''  or ''<file>''  syntax as above, you might want to make the shown code available for download as well. You can do this by specifying a file name after language code like this:+When you use the '' or ''<file>''  syntax as above, you might want to make the shown code available for download as well. You can do this by specifying a file name after language code like this:
 <code> <code>
 + ''
  
-<file php myexample.php> +''<file php myexample.php> <?php echo __GESHI_QUOT__hello world!__GESHI_QUOT__; ?> ''
-<?php echo "hello world!"; ?>+
  
-</file> +'' 
-</code>+</file> ''
  
 <file php myexample.php> <file php myexample.php>
 <?php echo "hello world!"; ?> <?php echo "hello world!"; ?>
 +
  
 </file> </file>
سطر 571: سطر 566:
 |author  |show item authors names| |author  |show item authors names|
 |date  |show item dates| |date  |show item dates|
-|description|show the item description. If [[doku>www.dokuwiki.org/config:htmlok|HTML]] is disabled all tags will be stripped|+|description|show the item description. If [[doku>www.dokuwiki.org/www.dokuwiki.org/config:htmlok|HTML]] is disabled all tags will be stripped|
 |nosort  |do not sort the items in the feed| |nosort  |do not sort the items in the feed|
 |//n// [dhm]|refresh period, where d=days, h=hours, m=minutes. (e.g. 12h = 12 hours).| |//n// [dhm]|refresh period, where d=days, h=hours, m=minutes. (e.g. 12h = 12 hours).|
سطر 598: سطر 593:
 ===== Syntax Plugins ===== ===== Syntax Plugins =====
  
-DokuWiki's syntax can be extended by [[doku>www.dokuwiki.org/plugins|Plugins]]. How the installed plugins are used is described on their appropriate description pages. The following syntax plugins are available in this particular DokuWiki installation:+DokuWiki's syntax can be extended by [[doku>www.dokuwiki.org/www.dokuwiki.org/plugins|Plugins]]. How the installed plugins are used is described on their appropriate description pages. The following syntax plugins are available in this particular DokuWiki installation:
  
 ~~INFO:syntaxplugins~~ ~~INFO:syntaxplugins~~
wiki/syntax.txt · آخر تعديل: 2024/03/12 19:44 بواسطة 127.0.0.1

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki