* این یک فهرست است
* آیتم دوم
* ممکن است سطح‌های مختلف داشته باشید
* آیتم دیگر
- همان فهرست فقط به صورت منظم (شماره‌بندی شده)
- آیتم دیگر
- برای سطح‌های عمیق‌تر کافی است از علامت‌های فاصله بیشتری استفاده نمایید.
- به همین سادگی
همچنین به [[doku>faq:lists|FAQ مربوط به آیتم‌های فهرست]] نگاه کنید.
===== تبدیل متن به تصویر یا HTML =====
جزوه پویای آکادمیاکافه می‌تواند برخی از کاراکترها یا رشته‌های از پیش تعریف شده را به تصویرها یا دیگر متن‌ها یا HTML تبدیل کند.
تبدیل متن به تصویر بیشتر برای خندانک‌ها استفاده می‌شود. متن به HTML نیز بیشتر برای جایگزین‌سازی‌های تایپی به کار می‌رود، ولی می‌توان آن را به شکلی تعریف نمود که که HTML های دیگر را نیز استفاده کند.
==== تبدیل متن به تصویر ====
جزوه پویای آکادمیاکافه [[wp>شکلک]]های شناخته شده را به معادل‌های تصویری آنها تبدیل می‌کند. این [[doku>خندانک‌ها]] و دیگر تصویرها را می‌توان تعریف نمود و آنها را توسعه داد. در زیر فهرستی از خندانک‌های به کار رفته در جزوه پویای آکادمیاکافه آورده شده است:
* 8-) %% 8-) %%
* 8-O %% 8-O %%
* :-( %% :-( %%
* :-) %% :-) %%
* =) %% =) %%
* :-/ %% :-/ %%
* :-\ %% :-\ %%
* :-? %% :-? %%
* :-D %% :-D %%
* :-P %% :-P %%
* :-O %% :-O %%
* :-X %% :-X %%
* :-| %% :-| %%
* ;-) %% ;-) %%
* ^_^ %% ^_^ %%
* :?: %% :?: %%
* :!: %% :!: %%
* LOL %% LOL %%
* FIXME %% FIXME %%
* DELETEME %% DELETEME %%
==== تبدیل متن به HTML ====
[[:برنامه ریزی برای پذیرش|جزوه پویای آکادمیاکافه]] می‌تواند کاراکترهای ساده متنی را به شکل‌های درست نوشتاری آنها تبدیل کند. نمونه‌ای از کاراکترهای شناخته شده در زیر آورده شده است:
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."
روش مشابهی را می‌توان برای ایجاد هر نوع HTML به کار گرفت. برای این کار کافیست که به [[doku>entities|فایل الگو]] افزوده شود.
سه استثنا وجود دارد که از آن فایل الگو نمی‌آیند: ضرب کردن مقادیر (640x480)، 'تنها' و "نقل‌قول‌های دوگانه". این موارد را می‌توان در [[doku>config:typography|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 |
توجه: امکان تنظیم راستای عمودی در سلول‌ها فراهم نیست.
===== بدون فرمت‌بندی =====
اگر می‌خواهید متن به همان صورت که نوشته می‌شود نشان داده شود (بدون هرگونه فرمت‌بندی)، عبارت ''%%%%'' یا ''%%%%'' در متن قرار داد.
در ابتدای این نوشته دو علامت فاصله گذاشته شده است.
این نوشته به صورت کد نشان داده شده و همه علامت‌های فاصله حفظ شده است: مانند <-این
این هم تقریبا مشابه قبلی است، اما می‌تواند برای نشان دادن اینکه یک فایل نقل قول شده به کار رود.
بلوک‌های بالا توسط سورس‌های زیر نوشته شده‌اند:
در ابتدای این نوشته دو علامت فاصله گذاشته شده است.
این نوشته به صورت کد نشان داده شده و همه علامت‌های فاصله حفظ شده است: مانند <-این
این هم تقریبا مشابه قبلی است، اما می‌تواند برای نشان دادن اینکه یک فایل نقل قول شده به کار رود.
==== سایه‌زدن بخش‌هایی از کد ====
[[:برنامه ریزی برای پذیرش|جزوه پویای آکادمیاکافه]] این امکان را فراهم می‌کند که بخش‌هایی از سورس کد، سایه زده شود و به این ترتیب خواندن این کدها آسانتر شود. برای این منظور از ابزار سایه‌زنی [[http://qbnz.com/highlighter/|GeSHi]] استفاده می‌شود -- بنابراین هر زبانی که توسط GESHi شناسایی شود در اینجا نیز قابل استفاده است. قاعده کار مشابه بلوک‌های کدنویسی و فایل است که در بخش قبل توضیح داده شد، با این تفاوت که این بار نام دستوری که می‌بایست سایه زده شود نیز در عبارت موردنظر آورده می‌شود، برای نمونه ''
/**
* 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//
==== بلوک‌های کدنویسی قابل دانلود ====
وقتی از دستور ''%%%%'' یا ''%%%%'' همانند بالا استفاده می‌شود، ممکن است بخواهید که امکان دانلود کردن کد نشان داده شده هم فراهم باشد. این کار را می‌توانید با مشخص ساختن نام یک فایل پس از کد انجام دهید، به صورت زیر:
اگر نمی‌خواهید هیچگونه سایه‌زنی وجود داشته باشد ولی امکان دانلود فایل فراهم باشد، یک خط تیره (''-'') را به عنوان کد بگذارید: ''%%%%''.
===== قرار دادن HTML و PHP =====
شما می‌توانید با استفاده از دستورهای ''%%%%'' یا ''%%%%'' کدهای HTML یا PHP را در نوشته‌های خود بگذارید. (اگر می‌خواهید المان‌های سطح بلوک را ببندید از دستورهای با حروف بزرگ استفاده نمایید).
مثال HTML:
This is some inline HTML
And this is some block HTML
This is some inline HTML
And this is some block HTML
مثال PHP:
echo 'A logo generated by PHP:';
echo ' . ')
';
echo '(generated inline HTML)';
echo 'The same, but inside a block level element: ';
echo '
';
echo 'A logo generated by PHP:';
echo '';
echo '(inline HTML)';
echo 'The same, but inside a block level element: ';
echo '
';
**توجه**: به طور پیش‌فرض قرار دادن HTML و PHP غیر فعال شده است. اگر غیر فعال شده باشد، به جای آنکه کد اجرا شده باشد نشان داده می‌شود.
===== کدهای RSS/ATOM =====
[[:برنامه ریزی برای پذیرش|جزوه پویای آکادمیاکافه]] می‌تواند داده‌های XMLهای بیرونی را نیز بپذیرد. برای آنالیز داده‌های معرفی شده توسط XML، از [[http://simplepie.org/|SimplePie]] استفاده می‌شود. تمام دستورها و قالب‌های به کار رفته در SimplePie را می‌توان در جزوه پویای آکادمیاکافه نیز به کار گرفت. با به کارگیری برخی پارامترهای اضافی می‌توان روی چگونگی به روز رسانی اطلاعات اثر گذاشت:
^ پارامتر ^ کارکرد ^
| عدد دلخواه | به عنوان بیشینه تعداد آیتم‌های که می‌بایست نشان داده شود (به طور پیش‌فرض 8) به کار می‌رود |
| reverse | ابتدا آیتم‌های پایانی معرفی شده توسط XML را نشان می‌دهد |
| author | نام مولفان آیتم موردنظر را نشان می‌دهد |
| date | تاریخ‌های آیتم موردنظر را نشان می‌دهد |
| description| توضیح مربوط به آیتم موردنظر را نشان می‌دهد. اگر [[doku>config:htmlok|HTML]] is غیر فعال شده باشد همه توضیح‌ها بدون نوشته خواهند ماند |
| //n//[dhm] | بازه زمانی فراخوانی اطلاعات، که در آن d= تعداد روزها، h= تعداد ساعت‌ها و m= تعداد دقیقه‌ها است. (برای نمونه 12h = دوازده ساعت). |
پیش‌فرض بازه زمانی فراخوانی اطلاعات 4 ساعت است. اعداد کوچکتر از 10 دقیقه به عنوان 10 دقیقه در نظر گرفته می‌شوند. در حالت کلی، [[:برنامه ریزی برای پذیرش|جزوه پویای آکادمیاکافه]] نسخه cashe شده صفحه‌ها را نشان می‌دهد، بدیهی است وقتی یک صفحه دارای اطلاعاتی باشد که به صورت پویا از بیرون تامین می‌شوند این موضوع چندان مناسب نخواهد بود. این پارامتر به [[:برنامه ریزی برای پذیرش|جزوه پویای آکادمیاکافه]] می‌گوید که اگر مدت زمان آخرین به‌روز‌رسانی صفحه از //بازه زمانی فراخوانی اطلاعات// بیشتر شده است، صفحه را دوباره به روز رسانی کند.
**مثال:**
{{rss>http://slashdot.org/index.rss 5 author date 1h }}
{{rss>http://slashdot.org/index.rss 5 author date 1h }}
===== ماکروها =====
برخی از دستورها به گونه‌ای روی جزوه (ویکی) اثر می گذارند که یک صفحه را بدون آنکه خودش خروجی خاصی ایجاد کند، به‌روز‌رسانی کند. در این زمینه ماکروهای کنترل کننده زیر وجود دارند.
^ ماکرو ^ کارکرد |
| %%~~NOTOC~~%% | اگر این ماکرو در صفحه وجود داشته باشد هیچگونه جدول فهرست عنوان‌ها (Table of Contents) در ابتدای صفحه موردنظر ایجاد نخواهد شد. |
| %%~~NOCACHE~~%% | جزوه پویای آکادمیاکافه به طور پیش‌فرض همه خروجی‌ها را cashe می‌کند. گاهی نیاز است که این کار انجام نشود (برای نمونه زمانی که دستور %%%% بالا استفاده می‌شود)، افزودن این ماکرو جزوه را ملزم می‌کند تا در هر فراخوانی، صفحه را به روز کند. |
===== پلاگین‌ها =====
دستورهای جزوه پویای آکادمیاکافه را می‌توان با استفاده از [[doku>plugins|پلاگین‌ها]] گسترش داد. شیوه به کارگیری پلاگین‌های نصب شده در صفحه‌های مربوط به آنها توضیح داده شده است:
~~INFO:syntaxplugins~~