ابزار کاربر

ابزار سایت


wiki:syntax

این یک نگارش قدیمی از این مطلب است!


راهنمای ویرایش و قالب‌بندی

جزوه پویای آکادمیاکافه از نشانه گذاری‌های ساده‌ای استفاده می‌کند که تلاش آنها بر آسان‌سازی هر چه بیشتر خواندن فایل‌های داده‌ای است. این صفحه به توضیح همه دستورها و قواعدی پرداخته است که شما برای ویرایش صفحه‌های مختلف می‌توانید از آنها استفاده نمایید. برای مشاهده منبع این صفحه می‌توانید «ویرایش این صفحه» را بزنید. اگر می‌خواهید چیزی را آزمایش کنید، می توانید از صفحه زمین بازی استفاده نمایید. همچنین آسانگر نشانه‌گذاری به سادگی در نوار ابزار قابل دسترس است.

مبانی قالب‌بندی متن

جزوه پویای آکادمیا کافه امکان نوشتن متن به صورت ضخیم، خمیده، زیرخط‌دار و هم‌عرض‌شده را فراهم می‌کند. البته امکان ترکیب کردن همه اینها نیز وجود دارد.

جزوه پویای آکادمیا کافه امکان نوشتن متن به صورت **ضخیم**، //خمیده//، __زیرخط‌دار__ و ''هم‌عرض‌شده'' را
فراهم می‌کند. البته امکان **__//''ترکیب کردن''//__** همه اینها نیز وجود دارد.

می‌توانید از زیروند و بالاوند نیز استفاده نمایید.

می‌توانید از <sub>زیروند</sub> و <sup>بالاوند</sup> نیز استفاده نمایید.

می‌توانید یک متن را به صورت حذف شده نیز نشان دهید.

می‌توانید یک متن را به صورت <del>حذف شده</del> نیز نشان دهید.

پاراگراف‌ها از خط های فاصله (با زدن دکمه Enter) ایجاد می شوند. اگر می خواهید از قابلیت ایجاد یک خط جدید اجباری بدون ایجاد پاراگراف استفاده نمایید، می توانید دو علامت خط مورب و سپس یک علامت فاصله در انتهای خط بگذارید.

این نمونه‌ای از یک متن دارای چند خط جدید اجباری است
توجه داشته باشید که دو علامت خط مورب فقط در انتهای یک خط شناسایی می‌شوند
یا آنکه
یک علامت فاصله در ادامه آن آمده باشد \\بدون آن این اتفاق رخ می‌دهد.

این نمونه‌ای از یک متن دارای چند خط جدید اجباری است\\ توجه داشته باشید که
دو علامت خط مورب فقط در انتهای یک خط شناسایی می‌شوند\\
یا آنکه\\ یک علامت فاصله در ادامه آن آمده باشد \\بدون آن این اتفاق رخ می‌دهد.

تنها زمانی می بایست از ایجاد اجباری یک خط جدید استفاده نمایید که واقعا نیاز باشد زیرا زیبایی نوشته را از بین می‌برند.

پیوندها

در جزوه پویای آکادمیاکافه چندین راه برای ایجاد پیوند (link) وجود دارد.

بیرونی

پیوندهای بیرونی به طور خودکار شناسایی می شوند: http://www.google.com یا به سادگی www.google.com - می توانید همچنین متن پیوند را تنظیم کنید این پیوند به گوگل می رود. آدرس های ایمیل مانند این: andi@splitbrain.org نیز به طور خودکار شناسایی می شوند.

پیوندهای بیرونی به طور خودکار شناسایی می شوند: http://www.google.com 
یا به سادگی www.google.com - می توانید همچنین متن پیوند را
تنظیم کنید [[http://www.google.com|این پیوند به گوگل می رود]]. 
آدرس های ایمیل مانند این: <andi@splitbrain.org> نیز به طور خودکار شناسایی می شوند.

درونی

پیوندهای درونی توسط براکت ایجاد می شوند. می توانید تنها نام صفحه را بدهید یا اینکه متن مربوط به پیوند را هم معرفی نمایید.

پیوندهای درونی توسط براکت ایجاد می شوند. می توانید تنها [[نام صفحه]] را بدهید
یا اینکه [[نام صفحه|متن مربوط به پیوند]] را هم معرفی نمایید.

نام صفحه‌های ویکی به طور خودکار به حروف کوچک تبدیل می‌شوند و نمی‌توان در آنها از کاراکترهای خاص استفاده نمود.

می‌توانید با به کارگیری علامت دونقطه در نام صفحه از namespaces استفاده نمایید.

می‌توانید با به کارگیری علامت دونقطه در نام صفحه از [[some:namespaces]] استفاده نمایید.

برای جزئیات مربوط به namespaceها می‌توانید namespaces را نگاه کنید.

پیوند دادن به یک بخش خاص نیز امکان‌پذیر است. برای این کار فقط کافیست نام بخش موردنظر را همانگونه که در HTML مرسوم است، پس از علامت # قرار دهید. این به این بخش پیوند داده شده است.

این به [[syntax#internal|این بخش]] پیوند داده شده است.

نکات:

  • پیونددهی به صفحه‌های موجود به شکل متفاوتی از صفحه‌های وجودنداشته نشان داده می‌شوند.
  • جزوه پویای آکادمیاکافه به طور پیش‌فرض برای ایجاد خودکار پیوندها از شیوه نوشتاری درشت‌نویسی استفاده نمی‌کند، ولی این قابلیت را می‌توان در فایل config فعال نمود. نکته: اگر در این نوشته عبارت DokuWiki به صورت لینک نشان داده می‌شود، در آنگاه این قابلیت فعال است.
  • وقتی عنوان یک بخش تغییر می‌یابد، نشانه‌گذاری (bookmark) آن نیز تغییر می‌کند. بنابراین زیاد به پیونددهی به بخش متکی نباشید.

درون‌ویکی

جزوه پویای آکادمیا کافه قابلیت پیوندهای درون‌ویکی را فراهم می‌کند. اینها پیوندهای سریعی هستند که به دیگر ویکی‌ها داده می‌شوند. برای نمونه این یک پیوند به Wiki است: صفحه مربوط به ویکی‌ها در وبسایت ویکی‌پدیا.

DokuWiki supports [[doku>Interwiki]] links. These are quick links to other Wikis.
For example this is a link to Wikipedia's page about Wikis: [[wp>Wiki]].

اشتراک‌های ویندوز

اشتراک‌های ویندوز همچون این نیز توسط این جزوه پویا شناسایی می‌شوند. لطفا توجه داشته باشید که این موارد فقط در یک گروه کاربری یکسان اینترانت مانند یک سازمان یا شرکت، معنا خواهند داشت.

اشتراک‌های ویندوز همچون [[\\server\share|این]] نیز توسط این جزوه پویا شناسایی می‌شوند.

نکات:

  • به دلایل امنیتی، به طور پیش‌فرض، مرور و جستجوی اشتراک‌های ویندوز فقط در مرورگر اینترنتی مایکروسافت (و فقط در «ناحیه محلی») کار می‌کند.
  • در مورد مرورگرهای موزیلا و فایرفاکس می‌توان این قابلیت را از راه دیگری که در پایگاه اطلاعاتی موزیلا توضیح داده شده است، فعال نمود. با این حال، هنگام باز کردن یک اشتراک ویندوزی، یک پیغام هشدار JavaScript داده خواهد شد. برای حذف این پیغام هشدار (برای تمام کاربران)، این رشته را در conf/userscript.js قرار دهید:
LANG.nosmblinks = '';

پیوندهای تصویر

همچنین می‌توانید از یک تصویر برای پیوند دادن به یک صفحه بیرونی یا درونی استفاده کنید. برای این کار کافیست که دستورهای مربوط به پیوندها و تصویرها (پایین را نگاه کنید) مانند این با یکدیگر ترکیب شوند:

[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]

لطفا توجه داشته باشید که تنها دستورهای قالب‌بندی تصویر در نام پیوندها پذیرفته می‌شود.

کل دستورهای مربوط به تصویر و پیوند (شامل تغییر اندازه دادن تصویر، URLها و تصویرهای درونی و بیرونی و پیوندهای درون‌ویکی) قابل استفاده هستند.

پاورقی‌ها

می‌توانید با استفاده از دو پرانتز باز و بسته، یک پاورقی 1) ایجاد کنید.

می‌توانید با استفاده از دو پرانتز باز و بسته، یک پاورقی ((این یک پاورقی است)) ایجاد کنید.

بخش‌بندی

در این جزوه امکان ایجاد حداکثر پنج سطح برای عنوان‌ها وجود دارد. اگر بیشتر از سه عنوان داشته باشید، یک جدول عنوان‌ها به صورت خودکار در ابتدای متن ایجاد می‌شود – برای غیر فعال نمودن این قابلیت می‌توان رشته ~~NOTOC~~ را در متن قرار داد.

عنوان سطح سه

عنوان سطح چهار

عنوان سطح پنج
==== عنوان سطح سه ====
=== عنوان سطح چهار ===
== عنوان سطح پنج ==

با گذاشتن چهار یا تعداد بیشتری علامت مساوی می‌توانید یک خط افقی ایجاد نمایید:


تصویرها و دیگر فایل‌ها

شما می‌توانید با استفاده از دو کروشه باز و دو کروشه بسته، تصویرهای درونی و بیرونی را در متن بیاورید.

اندازه واقعی:

تغییر اندازه دادن به یک عرض دلخواه:

تغییر اندازه دادن به عرض و ارتفاع دلخواه2):

تصویر تغییر اندازه شده بیرونی:

اندازه واقعی:                                    {{wiki:dokuwiki-128.png}}
تغییر اندازه دادن به یک عرض دلخواه:            {{wiki:dokuwiki-128.png?50}}
تغییر اندازه دادن به عرض و ارتفاع دلخواه:     {{wiki:dokuwiki-128.png?200x50}}
تصویر تغییر اندازه شده بیرونی:                 {{http://de3.php.net/images/php.gif?200x50}}

با به کارگیری علامت‌های فاصله در سمت چپ یا راست می‌توانید راستای تصویر را انتخاب نمایید.

{{ wiki:dokuwiki-128.png}}
{{wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png }}

همچنین می‌توانید یک عنوان برای تصویر بگذارید که توسط بیشتر مرورگرها به عنوان یک caption شناسایی می‌شود. با بردن نشانگر موس به روی تصویر این عنوان را می‌توان دید.

این عنوان است

{{ wiki:dokuwiki-128.png |این عنوان است}}

اگر نام یک فایل (درونی یا بیرونی) را مشخص سازید که تصویر (gif, jpeg, png) نباشد، در این صورت به شکل یک پیوند نشان داده خواهد شد.

برای پیوند دادن یک تصویر به یک صفحه دیگر پیوندهای تصویر در بالا را نگاه کنید.

فهرست‌ها

جزوه پویای آکادمیاکافه قابلیت نشان دادن فهرست‌های منظم (شماره‌بندی شده) و نامنظم (بدون شماره) را داراست. برای ایجاد یک فهرست، در ابتدای متن موردنظر دو علامت فاصله بگذارید و سپس اگر می خواهید فهرست به صورت شماره‌دار باشد علامت - و اگر می‌خواهید فهرست به صورت بدون شماره باشد یک علامت * بگذارید.

  • این یک فهرست است
  • آیتم دوم
    • ممکن است سطح‌های مختلف داشته باشید
  • آیتم دیگر
  1. همان فهرست فقط به صورت منظم (شماره‌بندی شده)
  2. آیتم دیگر
    1. برای سطح‌های عمیق‌تر کافی است از علامت‌های فاصله بیشتری استفاده نمایید.
  3. به همین سادگی
  * این یک فهرست است
  * آیتم دوم
    * ممکن است سطح‌های مختلف داشته باشید
  * آیتم دیگر

  - همان فهرست فقط به صورت منظم (شماره‌بندی شده)
  - آیتم دیگر
    - برای سطح‌های عمیق‌تر کافی است از علامت‌های فاصله بیشتری استفاده نمایید.
  - به همین سادگی

همچنین به FAQ مربوط به آیتم‌های فهرست نگاه کنید.

تبدیل متن به تصویر یا HTML

جزوه پویای آکادمیاکافه می‌تواند برخی از کاراکترها یا رشته‌های از پیش تعریف شده را به تصویرها یا دیگر متن‌ها یا HTML تبدیل کند.

تبدیل متن به تصویر بیشتر برای خندانک‌ها استفاده می‌شود. متن به HTML نیز بیشتر برای جایگزین‌سازی‌های تایپی به کار می‌رود، ولی می‌توان آن را به شکلی تعریف نمود که که HTML های دیگر را نیز استفاده کند.

تبدیل متن به تصویر

جزوه پویای آکادمیاکافه شکلکهای شناخته شده را به معادل‌های تصویری آنها تبدیل می‌کند. این خندانک‌ها و دیگر تصویرها را می‌توان تعریف نمود و آنها را توسعه داد. در زیر فهرستی از خندانک‌های به کار رفته در جزوه پویای آکادمیاکافه آورده شده است:

  • 8-) 8-)
  • 8-O 8-O
  • :-( :-(
  • :-) :-)
  • =) =)
  • :-/ :-/
  • :-\ :-\
  • :-? :-?
  • :-D :-D
  • :-P :-P
  • :-O :-O
  • :-X :-X
  • :-| :-|
  • ;-) ;-)
  • ^_^ ^_^
  • :?: :?:
  • :!: :!:
  • LOL LOL
  • FIXME FIXME
  • DELETEME DELETEME

تبدیل متن به HTML

جزوه پویای آکادمیاکافه می‌تواند کاراکترهای ساده متنی را به شکل‌های درست نوشتاری آنها تبدیل کند. نمونه‌ای از کاراکترهای شناخته شده در زیر آورده شده است:

→ ← ↔ ⇒ ⇐ ⇔ » « – — 640×480 © ™ ® «He thought 'It's a man's world'…»

-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."

روش مشابهی را می‌توان برای ایجاد هر نوع HTML به کار گرفت. برای این کار کافیست که به فایل الگو افزوده شود.

سه استثنا وجود دارد که از آن فایل الگو نمی‌آیند: ضرب کردن مقادیر (640×480)، 'تنها' و «نقل‌قول‌های دوگانه». این موارد را می‌توان در confing option غیر فعال نمود.

نقل قول کردن

گاهی نیاز دارید که یک متن را به شکلی نشانه‌گذاری نمایید که نشان دهید یک پاسخ یا کامنت است. برای این کار می‌توانید از ساختار زیر استفاده نمایید:

فکر می کنم می‌بایست آن را انجام دهیم.

> نه نباید انجام دهیم.

>> ولی من می‌گویم می‌بایست انجام دهیم.

> واقعا؟

>> بله!

>>> پس انجامش بدهیم!

فکر می کنم می‌بایست آن را انجام دهیم.

نه نباید انجام دهیم.
ولی من می‌گویم می‌بایست انجام دهیم.
واقعا؟
بله!
پس انجامش بدهیم!

جدول‌ها

جزوه پویای آکادمیاکافه از قواعد ساده‌ای برای ایجاد جدول‌ها استفاده می‌کند.

Heading 1 Heading 2 Heading 3
Row 1 Col 1 Row 1 Col 2 Row 1 Col 3
Row 2 Col 1 some colspan (note the double pipe)
Row 3 Col 1 Row 3 Col 2 Row 3 Col 3

ردیف‌های معمولی جدول می‌بایست با یک | آغاز و پایان یابند. ردیف عنوان می‌بایست با ^ آغاز و پایان یابد.

^ Heading 1      ^ Heading 2       ^ Heading 3          ^
| Row 1 Col 1    | Row 1 Col 2     | Row 1 Col 3        |
| Row 2 Col 1    | some colspan (note the double pipe) ||
| Row 3 Col 1    | Row 3 Col 2     | Row 3 Col 3        |

برای وصل کردن افقی سلول‌ها به یکدیگر، کافیست همانگونه در بالا نشان داده شد، سلول کناری کاملا خالی باشد. اطمینان حاصل کنید که همیشه تعداد جداکننده‌های سلول‌ها به اندازه مساوی باشند!

گذاشتن عنوان‌های عمودی نیز امکان‌پذیر است.

Heading 1 Heading 2
Heading 3 Row 1 Col 2 Row 1 Col 3
Heading 4 no colspan this time
Heading 5 Row 2 Col 2 Row 2 Col 3

همانگونه که می‌بینید، جداکننده‌ای که قبل از هر سلول گذاشته می‌شود در مورد نوع آن تصمیم‌گیری می‌کند:

|              ^ Heading 1            ^ Heading 2          ^
^ Heading 3    | Row 1 Col 2          | Row 1 Col 3        |
^ Heading 4    | no colspan this time |                    |
^ Heading 5    | Row 2 Col 2          | Row 2 Col 3        |

می‌توانید با اضافه کردن ::: چند سلول را به طور عمودی به یکدیگر متصل سازید.

Heading 1 Heading 2 Heading 3
Row 1 Col 1 this cell spans vertically Row 1 Col 3
Row 2 Col 1 Row 2 Col 3
Row 3 Col 1 Row 2 Col 3

به غیر از قاعده مربوط به سلول‌های عمودی متصل شده، آن سلول‌ها نباید دارای نوشته دیگری باشند.

^ Heading 1      ^ Heading 2                  ^ Heading 3          ^
| Row 1 Col 1    | this cell spans vertically | Row 1 Col 3        |
| Row 2 Col 1    | :::                        | Row 2 Col 3        |
| Row 3 Col 1    | :::                        | Row 2 Col 3        |

می‌توان راستای نوشته‌های جدول را نیز تعیین نمود. برای این کار فقط کافیست تا دو علامت فاصله در انتهای جهت خلاف متن موردنظر قرار دهید. برای راست‌چین نمودن، دو علامت فاصله در سمت چپ قرار دهید. برای چپ‌چین نمودن، دو علامت فاصله در سمت راست قرار دهید. برای وسط‌چین نمودن، در هر دو انتهای نوشته دو علامت فاصله بگذارید.

Table with alignment
right center left
left right center
xxxxxxxxxxxx xxxxxxxxxxxx xxxxxxxxxxxx

جدول بالا در حالت سورس به صورت زیر دیده می‌شود:

^           Table with alignment           ^^^
|         right|    center    |left          |
|left          |         right|    center    |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

توجه: امکان تنظیم راستای عمودی در سلول‌ها فراهم نیست.

بدون فرمت‌بندی

اگر می‌خواهید متن به همان صورت که نوشته می‌شود نشان داده شود (بدون هرگونه فرمت‌بندی)، عبارت <nowiki> را در دو سوی آن قرار دهید. برای این کار همچنین می‌توانید دو علامت درصد %% در دو سوی نوشته موردنظر قرار دهید.

This is some text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it. The same is true for //__this__ text// with a smiley ;-).

<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 %%//__this__ text// with a smiley ;-)%%.

بلوک‌های کدنویسی

می‌توانید بلوک‌های مربوط به کدها را با گذاشتن دو علامت فاصله در ابتدای آنها (همانند آنچه برای مثال‌های قبلی به کار رفت) یا با استفاده از عبارت‌های <code> یا <file> در متن قرار داد.

در ابتدای این نوشته دو علامت فاصله گذاشته شده است.
این نوشته به صورت کد نشان داده شده و همه علامت‌های فاصله حفظ شده است: مانند           <-این
این هم تقریبا مشابه قبلی است، اما می‌تواند برای نشان دادن اینکه یک فایل نقل قول شده به کار رود.

بلوک‌های بالا توسط سورس‌های زیر نوشته شده‌اند:

  در ابتدای این نوشته دو علامت فاصله گذاشته شده است.
<code>
این نوشته به صورت کد نشان داده شده و همه علامت‌های فاصله حفظ شده است: مانند           <-این
</code>
<file>
این هم تقریبا مشابه قبلی است، اما می‌تواند برای نشان دادن اینکه یک فایل نقل قول شده به کار رود.
</file>

سایه‌زدن بخش‌هایی از کد

جزوه پویای آکادمیاکافه این امکان را فراهم می‌کند که بخش‌هایی از سورس کد، سایه زده شود و به این ترتیب خواندن این کدها آسانتر شود. برای این منظور از ابزار سایه‌زنی GeSHi استفاده می‌شود – بنابراین هر زبانی که توسط GESHi شناسایی شود در اینجا نیز قابل استفاده است. قاعده کار مشابه بلوک‌های کدنویسی و فایل است که در بخش قبل توضیح داده شد، با این تفاوت که این بار نام دستوری که می‌بایست سایه زده شود نیز در عبارت موردنظر آورده می‌شود، برای نمونه <code java> یا <file java>.

/**
 * The HelloWorldApp class implements an application that
 * simply displays "Hello World!" to the standard output.
 */
class HelloWorldApp {
    public static void main(String[] args) {
        System.out.println("Hello World!"); //Display the string.
    }
}

هم‌اکنون رشته‌های زیر در اینجا شناسایی می‌شوند: 4cs, 6502acme, 6502kickass, 6502tasm, 68000devpac, abap, actionscript-french, actionscript, actionscript3, ada, algol68, apache, applescript, asm, asp, autoconf, autohotkey, autoit, avisynth, awk, bascomavr, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_loadrunner, c_mac, caddcl, cadlisp, cfdg, cfm, chaiscript, cil, clojure, cmake, cobol, coffeescript, cpp, cpp-qt, csharp, css, cuesheet, d, dcs, delphi, diff, div, dos, dot, e, epc, ecmascript, eiffel, email, erlang, euphoria, f1, falcon, fo, fortran, freebasic, fsharp, gambas, genero, genie, gdb, glsl, gml, gnuplot, go, groovy, gettext, gwbasic, haskell, hicest, hq9plus, html, html5, icon, idl, ini, inno, intercal, io, j, java5, java, javascript, jquery, kixtart, klonec, klonecpp, latex, lb, lisp, llvm, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, magiksf, make, mapbasic, matlab, mirc, modula2, modula3, mmix, mpasm, mxml, mysql, newlisp, nsis, oberon2, objc, objeck, ocaml-brief, ocaml, oobas, oracle8, oracle11, oxygene, oz, pascal, pcre, perl, perl6, per, pf, php-brief, php, pike, pic16, pixelbender, pli, plsql, postgresql, povray, powerbuilder, powershell, proftpd, progress, prolog, properties, providex, purebasic, pycon, python, q, qbasic, rails, rebol, reg, robots, rpmspec, rsplus, ruby, sas, scala, scheme, scilab, sdlbasic, smalltalk, smarty, sql, systemverilog, tcl, teraterm, text, thinbasic, tsql, typoscript, unicon, uscript, vala, vbnet, vb, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, winbatch, whois, xbasic, xml, xorg_conf, xpp, yaml, z80, zxbasic

بلوک‌های کدنویسی قابل دانلود

وقتی از دستور <code> یا <file> همانند بالا استفاده می‌شود، ممکن است بخواهید که امکان دانلود کردن کد نشان داده شده هم فراهم باشد. این کار را می‌توانید با مشخص ساختن نام یک فایل پس از کد انجام دهید، به صورت زیر:

<file php myexample.php>
<?php echo "hello world!"; ?>
</file>
myexample.php
<?php echo "hello world!"; ?>

اگر نمی‌خواهید هیچگونه سایه‌زنی وجود داشته باشد ولی امکان دانلود فایل فراهم باشد، یک خط تیره (-) را به عنوان کد بگذارید: <code - myfile.foo>.

قرار دادن HTML و PHP

شما می‌توانید با استفاده از دستورهای <html> یا <php> کدهای HTML یا PHP را در نوشته‌های خود بگذارید. (اگر می‌خواهید المان‌های سطح بلوک را ببندید از دستورهای با حروف بزرگ استفاده نمایید).

مثال HTML:

<html>
This is some <span style="color:red;font-size:150%;">inline HTML</span>
</html>
<HTML>
<p style="border:2px dashed red;">And this is some block HTML</p>
</HTML>

This is some <span style="color:red;font-size:150%;">inline HTML</span>

<p style="border:2px dashed red;">And this is some block HTML</p>

مثال PHP:

<php>
echo 'A logo generated by PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
echo '(generated inline HTML)';
</php>
<PHP>
echo '<table class="inline"><tr><td>The same, but inside a block level element:</td>';
echo '<td><img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" /></td>';
echo '</tr></table>';
</PHP>

echo 'A logo generated by PHP:'; echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />'; echo '(inline HTML)';

echo '<table class="inline"><tr><td>The same, but inside a block level element:</td>';
echo '<td><img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" /></td>';
echo '</tr></table>';

توجه: به طور پیش‌فرض قرار دادن HTML و PHP غیر فعال شده است. اگر غیر فعال شده باشد، به جای آنکه کد اجرا شده باشد نشان داده می‌شود.

کدهای RSS/ATOM

DokuWiki can integrate data from external XML feeds. For parsing the XML feeds, SimplePie is used. All formats understood by SimplePie can be used in DokuWiki as well. You can influence the rendering by multiple additional space separated parameters:

Parameter Description
any number will be used as maximum number items to show, defaults to 8
reverse display the last items in the feed first
author show item authors names
date show item dates
description show the item description. If HTML is disabled all tags will be stripped
n[dhm] refresh period, where d=days, h=hours, m=minutes. (e.g. 12h = 12 hours).

The refresh period defaults to 4 hours. Any value below 10 minutes will be treated as 10 minutes. DokuWiki will generally try to supply a cached version of a page, obviously this is inappropriate when the page contains dynamic external content. The parameter tells DokuWiki to re-render the page if it is more than refresh period since the page was last rendered.

مثال:

{{rss>http://slashdot.org/index.rss 5 author date 1h }}

ماکروها

Some syntax influences how DokuWiki renders a page without creating any output it self. The following control macros are availble:

Macro Description
~~NOTOC~~ If this macro is found on the page, no table of contents will be created
~~NOCACHE~~ DokuWiki caches all output by default. Sometimes this might not be wanted (eg. when the <php> syntax above is used), adding this macro will force DokuWiki to rerender a page on every call

پلاگین‌ها

DokuWiki's syntax can be extended by 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:

  • LTR 2007-01-21 توسط ariel kroszynski
    switch to ltr rendering within a rtl page
  • Wrap Plugin 2018-04-22 توسط Anika Henke
    Universal plugin which combines functionalities of many other plugins. Wrap wiki text inside containers (divs or spans) and give them a class (choose from a variety of preset classes), a width and/or a language with its associated text direction.
  • Info Plugin 2014-10-01 توسط Andreas Gohr
    Displays information about various DokuWiki internals
1)
این یک پاورقی است
2)
وقتی نسبت عرض و ارتفاع مشخص شده با نسبت‌ عرض و ارتفاع مربوط به تصویر یکی نباشد، قبل از آنکه به نسبت موردنظر تغییر یابد، بریده (cropped) می‌شود
wiki/syntax.1382613989.txt.gz · آخرین ویرایش: 2019/08/17 19:50 (ویرایش خارجی)