ابزار کاربر

ابزار سایت


wiki:راهنمای_نگارش

راهنمای نگارش جزوه (ویکی)

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

لطفا توجه کنید که اولین قدم برای انجام تغییرات ورود به سیستم است. برای این کار لطفا از طریق منوی بالای صفحه وارد ویکی شوید.

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

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

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

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

می‌توانید از <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> نیز به طور خودکار شناسایی می شوند.

درونی

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

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

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

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

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

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

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

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

نکات:

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

درون‌ویکی

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

جزوه پویای آکادمیا کافه قابلیت پیوندهای [[doku>درون‌ویکی]] را فراهم می‌کند.
اینها پیوندهای سریعی هستند که به دیگر ویکی‌ها داده می‌شوند. برای نمونه این 
یک پیوند به [[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

جزوه پویای آکادمیاکافه می‌تواند داده‌های XMLهای بیرونی را نیز بپذیرد. برای آنالیز داده‌های معرفی شده توسط XML، از SimplePie استفاده می‌شود. تمام دستورها و قالب‌های به کار رفته در SimplePie را می‌توان در جزوه پویای آکادمیاکافه نیز به کار گرفت. با به کارگیری برخی پارامترهای اضافی می‌توان روی چگونگی به روز رسانی اطلاعات اثر گذاشت:

پارامتر کارکرد
عدد دلخواه به عنوان بیشینه تعداد آیتم‌های که می‌بایست نشان داده شود (به طور پیش‌فرض 8) به کار می‌رود
reverse ابتدا آیتم‌های پایانی معرفی شده توسط XML را نشان می‌دهد
author نام مولفان آیتم موردنظر را نشان می‌دهد
date تاریخ‌های آیتم موردنظر را نشان می‌دهد
description توضیح مربوط به آیتم موردنظر را نشان می‌دهد. اگر HTML is غیر فعال شده باشد همه توضیح‌ها بدون نوشته خواهند ماند
n[dhm] بازه زمانی فراخوانی اطلاعات، که در آن d= تعداد روزها، h= تعداد ساعت‌ها و m= تعداد دقیقه‌ها است. (برای نمونه 12h = دوازده ساعت).

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

مثال:

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

ماکروها

برخی از دستورها به گونه‌ای روی جزوه (ویکی) اثر می گذارند که یک صفحه را بدون آنکه خودش خروجی خاصی ایجاد کند، به‌روز‌رسانی کند. در این زمینه ماکروهای کنترل کننده زیر وجود دارند.

ماکرو کارکرد
~~NOTOC~~ اگر این ماکرو در صفحه وجود داشته باشد هیچگونه جدول فهرست عنوان‌ها (Table of Contents) در ابتدای صفحه موردنظر ایجاد نخواهد شد.
~~NOCACHE~~ جزوه پویای آکادمیاکافه به طور پیش‌فرض همه خروجی‌ها را cashe می‌کند. گاهی نیاز است که این کار انجام نشود (برای نمونه زمانی که دستور <php> بالا استفاده می‌شود)، افزودن این ماکرو جزوه را ملزم می‌کند تا در هر فراخوانی، صفحه را به روز کند.

پلاگین‌ها

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

  • Info Plugin 2014-10-01 توسط Andreas Gohr
    Displays information about various DokuWiki internals
  • 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.
1)
این یک پاورقی است
2)
وقتی نسبت عرض و ارتفاع مشخص شده با نسبت‌ عرض و ارتفاع مربوط به تصویر یکی نباشد، قبل از آنکه به نسبت موردنظر تغییر یابد، بریده (cropped) می‌شود
wiki/راهنمای_نگارش.txt · آخرین ویرایش: 2015/11/28 23:30 توسط babak