الگو:Graphical timeline

توضیحات الگو[نمایش] [ویرایش] [تاریخچه] [پاکسازی]

روش آسان

در مقالهٔ خود {{include timeline}} را بنویسید، پیش‌نمایش بگیرید و پیوندی را که تولید می‌شود دنبال کنید. یک الگوی آمادهٔ استفاده به شما نمایش داده خواهد شد؛ پس از تکمیل آن، به مقالهٔ خود بازگردید و { {include timeline} } خط زمانی شما را نمایش خواهد داد.

توسعه

هرچند این الگو را تا جایی که توانسته‌ام به‌دقت آزموده‌ام، گمان می‌کنم که می‌توان آن را بیشتر بهبود داد. اگر اشکال یا بخشی یافتید که می‌خواهید سفارشی‌سازی کنید، لطفاً به من اطلاع دهید! Verisimilus T 12:02, 12 June 2007 (UTC)

کارکرد الگو

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

چرا از این الگو استفاده کنیم؟

جایگزین این الگو، m:EasyTimeline با استفاده از نحو <template> است. EasyTimeline کاستی‌های زیر را دارد:

• تصویری پیکسلی تولید می‌کند که ظاهر متفاوتی دارد و زمان بارگذاری صفحه را افزایش می‌دهد
• زمان راه‌اندازی طولانی - حتی زمانی که می‌دانید چه می‌کنید بیش از ۳۰ دقیقه طول می‌کشد
• کدی پیچیده و نفوذناپذیر که نیازمند نحو دقیق است
• جای‌گذاری دقیق میله‌ها در محل دلخواه دشوار است
• تغییر دادن تاریخ‌ها و اندازه‌های کمینه نیازمند تغییر در چندین جا است
• همه‌چیز باید مشخص شود - هیچ‌چیز خودکار نیست
• مقیاس‌پذیر نیست - با اندازهٔ متن بزرگ نمی‌شود.

استفاده از الگو

کجا از آن استفاده کنیم

هرچند خط‌های زمانی کوتاه را می‌توان مستقیماً در مقاله درج کرد، برخی از ویرایشگران شکایت دارند که خط‌های زمانی بلند و پیچیده روند صفحه را برهم می‌زنند و ویرایش را دشوار می‌کنند. بنابراین، شاید بخواهید از {{Include timeline}} استفاده کنید تا کد خط زمانی را در صفحه‌ای جداگانه نگه دارید که به‌صورت خودکار تراگنجانده خواهد شد.

شروع کار

می‌توانید کلید |help=on را در الگو تنظیم کنید تا چند راهنمایی سریع تولید شود.
هنگام شروع کار، شاید بخواهید از {{Graphical timeline|help=on}} برای تولید یک الگوی آمادهٔ خالی استفاده کنید - یا عبارت {{subst:Graphical timeline/blank}} را در یک صفحهٔ تمرین بنویسید، صفحه را ذخیره کنید و کد حاصل را ویرایش کنید. امیدوارم که نام پارامترها به‌اندازهٔ کافی گویا باشند.

معنای اعداد

مقادیر عددی به‌طور پیش‌فرض بر حسب em هستند، یعنی ارتفاع و عرض یک حرف M بزرگ.

استثنای این مورد، پارامترهای left و right یک میله است که با مختصات کسری تنظیم می‌شوند. به‌بیان دیگر، کد |bar1-left=0 |bar1-right=0.5 |bar2-left=0.666 |bar3-left=0.5 |bar3-right=0.666 سبب می‌شود bar1 نیمهٔ چپ ناحیه را بپوشاند، bar2 سمت راست‌ترین یک‌سوم را بپوشاند و bar3 میان آن‌ها قرار گیرد. افزون بر این، به دلایل عملیاتی، واحدهای ارتفاع همواره برای تولید عرض حاشیه‌ها استفاده می‌شوند.

حاشیهٔ میله‌ها

حاشیه‌ها تنها در بالا و پایین هر میله ظاهر می‌شوند. متأسفانه این مورد را نمی‌توان تغییر داد - برای داشتن حاشیه فقط در بالا یا پایین یک میله، باید میله‌ای جداگانه بسازید تا روی انتهای آن قرار گیرد.

سبک حاشیه را می‌توان بر پایهٔ استانداردهای برگه‌های سبک آبشاری روی یکی از مقادیر solid, dotted, dashed, double, groove, ridge, inset یا outset تنظیم کرد. عرض با همان واحد ارتفاع است و اگر مقداری مشخص نشود، ۰٫۱ تا ۰٫۲ مقدار مناسبی برای یک خط بسیار باریک است.

خط‌های خالی

خالی گذاشتن یک پارامتر با مشخص‌نکردن آن یکسان نیست - این کار مقدار پیش‌فرض الگو را بازنویسی می‌کند. مطمئن شوید که هر خطی را که مشخص نمی‌کنید حذف کرده‌اید.

دوره‌های زمین‌شناسی

برای ترسیم یک دورهٔ زمین‌شناسی، از نحو |period3=Triassic همراه با |period3-left=0.1 طبق معمول استفاده کنید. آنگاه الگو آغاز، پایان و رنگ درست میله را محاسبه می‌کند. برای نمونه، الگو:Triassic graphical timeline (پیوندهای به این صفحه، ویرایش) را ببینید.

ملاحظات

مرورگرها

متأسفانه مرورگرهای گوناگون شیوه‌های متفاوتی برای رفتار با خط‌های متنی که از ظرف خود سرریز می‌کنند دارند - برخی ظرف را کش می‌آورند و برخی دیگر متن را می‌پیچانند. این یعنی اگر خط زمانی به‌ویژه پیچیده‌ای می‌سازید، احتمالاً ارزش دارد که خط زمانی نهایی خود را دست‌کم در اینترنت اکسپلورر و فایرفاکس موزیلا بررسی کنید.

رنگ‌ها

اگر رنگ‌ها را با مقادیر اچ‌تی‌ام‌ال مانند #e0b539 تنظیم می‌کنید، در نظر داشته باشید که برخی نمایشگرهای قدیمی و بسیاری از ویدئوپروژکتورها نمی‌توانند برخی رنگ‌ها را نمایش دهند. پایبندبودن به رنگ‌های امن وب بیشترین سازگاری را تضمین می‌کند که اغلب مورد استقبال است؛ یعنی مضرب‌هایی از 33، برای نمونه #ff99cc یا #03C.

ظرفیت

اگر دریافتید که میله‌ها، یادداشت‌ها یا درآیه‌های راهنما با شمارهٔ بالا نمایش داده نمی‌شوند، شاید به این دلیل باشد که الگو برای پشتیبانی از آن کدنویسی نشده است. در کد الگو دستورهایی هست که چگونه خودتان ظرفیت میله‌های بیشتر و مانند آن را بیفزایید (این کار صرفاً یک رونوشت و چسباندن ساده است)؛ اگر در انجام آن مطمئن نیستید، به Verisimilus T اطلاع دهید.

ویرایش آسان

اگر خط زمانی را در یک زیرصفحه می‌سازید، حتماً از پارامتر | link-to= استفاده کنید. نام صفحه را مشخص کنید (برای نمونه Template:My graphical timeline) تا پیوندهای «ویرایش» و «تاریخچه» ظاهر شوند.

فهرست پارامترها

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

هر نمونه از # را با یک عدد جایگزین کنید.

پارامترهای to و from اجباری‌اند و همهٔ پارامترهای دیگر اختیاری هستند.

پارامترهای عمومی

پارامترهای خط زمانی

پارامتر	کارکرد	اجباری؟
from	تاریخ آغاز خط زمانی. می‌تواند منفی باشد.	آری
to	تاریخ پایانی (بالاترین) خط زمانی. می‌تواند منفی باشد.	آری
width	عرض خط زمانی	نه
title	آنچه در میلهٔ عنوان نمایش داده می‌شود	نه
title-colour	رنگ پس‌زمینهٔ میلهٔ عنوان	نه

دوره‌های زمین‌شناسی

پارامترهای دوره

پارامتر	کارکرد
period#	نام دوره را مشخص کنید؛ الگو به‌طور خودکار آغاز و پایان آن را محاسبه و آن را به‌درستی رنگ‌آمیزی می‌کند.

میله‌ها

پارامترهای میله

پارامتر	کارکرد
width	عرض خط زمانی

راهنما

پارامترهای راهنما

پارامتر	کارکرد
width	عرض خط زمانی

یادداشت‌ها

پارامترهای یادداشت

پارامتر	کارکرد
width	عرض خط زمانی

در عمل: یک نمونه

کد سمت چپ، خط زمانی سمت راست را تولید می‌کند که عمداً افتضاح طراحی شده تا محدودیت‌های الگو را نشان دهد. برای یک نمونهٔ کارآمد، پیشنهاد می‌کنم به Ediacaran biota نگاه کنید.

{{Graphical timeline

|title=Example Timeline
|align=right

|plot-colour=#bbeebb

|from=-550
|to=-500
|scale-increment=10

|width=10
|height=250
|height-unit=px

|legend1=[[پیدازیستی]]

|bar1-from=-542
|bar1-left=0
|bar1-right=0.1

|legend2=[[پرکامبرین]]

|bar2-to=-542
|bar2-left=0
|bar2-right=0.2

|legend3=[[Infracambrian]]
|legend3-colour=#e0aacc

|bar3-to=-534
|bar3-left=0.1
|bar3-right=0.2
|bar3-colour=#e0aacc

|<!-- اگر این bar 4 بود، با میلهٔ بوتومین هم‌پوشانی پیدا می‌کرد -->
|bar14-from=-530
|bar14-to=-520
|bar14-left=0.95
|bar14-right=1.05
|bar14-colour=red
|legend14=Cambrian explosion

|<!--دوره‌ها و اشکوب‌ها-->
|bar5-text=[[ادیاکاران]]
|bar5-to=-540
|bar5-left=0.2
|bar5-border-width=1
|bar5-border-colour= #996666
|bar5-colour=#cc9999

|bar6-text=[[کامبرین]]
|bar6-from=-542
|bar6-to=-534
|bar6-left=0.2
|bar6-border-width=0.1
|bar6-colour=#99cc99

|bar7-text=[[کامبرین]]
|bar7-from=-534
|bar7-to=-530
|bar7-left=0.1
|bar7-colour=#99cc99
|bar7-border-width=0.1

|bar8-from=-530.1
|bar8-to=-529.9
|bar8-left=0.2
|bar8-colour=black

|bar9-text=[[کامبرین]]
|bar9-from=-530
|bar9-to=-524
|bar9-left=0.1
|bar9-right=0.95
|bar9-colour=#99cc99

|bar10-text=[[کامبرین]]
|bar10-from=-524
|bar10-to=-518
|bar10-left=0.1
|bar10-colour=#99cc99
|bar10-border-width=0.1

|bar11-text=[[کامبرین]]
|bar11-from=-518
|bar11-to=-513
|bar11-left=0.1
|bar11-border-width=0.1
|bar11-colour=#99cc99

|note1=Base of the Cambrian
|note1-at=-542
|note1-colour=green

|note2=[[کامبرین]]
|note2-nudge-left=8.5
|note2-nudge-down=0
|note2-at=-507
|note2-remove-arrow=yes

|caption=یک گاه‌نگار تقریبی از رخدادها<br>در پایهٔ [[کامبرین]] [[Period (geology){{!}}Period]].
<br>مقیاس محور بر حسب میلیون سال پیش است.
}}

نکته‌هایی دربارهٔ نمونه

• {{!}} باید هر جا که می‌خواهید یک | ظاهر شود به‌کار رود (برای نمونه در caption)
• اگر مشخص نکنید که یک میله کجا باید آغاز یا پایان یابد، تا لبهٔ نمودار ادامه خواهد یافت
• متن نباید برای میله بیش از حد بلند باشد
• شیوهٔ پیچیده‌شدن متن سرریز نیز در دو مرورگر متفاوت رفتار می‌شود - در فایرفاکس از سمت راست میله بیرون می‌زند، اما در IE درون آن پیچانده می‌شود. تا جای ممکن خودتان به‌صورت دستی خط جدید وارد کنید به‌جای آنکه به مرورگرها برای حل آن تکیه کنید. یا یک یادداشت را روی میله جای دهید - note2 را ببینید که به سمت چپ روی پس‌زمینهٔ نمودار جابه‌جا شده است.

توضیحات بالا تراگنجانده‌شده از الگو:Graphical timeline/توضیحات است. (ویرایش | تاریخچه)
ویرایشگران می‌توانند در صفحات تمرین (ویرایش | تفاوت) و آزمایشی (ویرایش) این الگو را آزمایش کنند.
لطفاً رده‌ها را به زیرصفحهٔ /توضیحات بیفزایید. زیرصفحه‌های این الگو.