راهنمای میرا

میرا برای نصب به پرل نسخه 5.12 به بالا نیاز دارد برای تست این که پرل را روی سیستم خود از قبل نصب شده دارید یا نه، terminal یا command line را باز کنید و تایپ کنید perl -v اگر پرل از قبل نصب شده باشد متنی شبیه به این را خواهید دید که ورژن پرل نصب شده را به شما نشان خواهد داد This is perl 5, version 24, subversion 1 (v5.24.1) اگر پرل را ندارید از این طریق آن‌را نصب کنید: ویندوز اگر از ویندوز استفاده میکنید Strawberry Perl یا «پرل توت فرنگی» را ابتدا نصب کنید توت فرنگی cpan minus را به شکل توکار همراه خود دارد، برای نصب میرا تایپ کنید: cpanm Mira سیستم‌های شبه یونیکس لینوکس توزیع‌های لی

برای شروع به کار با میرا ابتدا یک دایرکتوری جدید با هر نامی که دوست دارید بسازید، این دایرکتوری مکان تمامی محتواها، تنظیمات و قالب‌های سایت شما خواهد بود، وارد مسیر دایرکتوری خود شوید و کار با میرا را شروع کنید دایرکتوری جدید را می‌توانید هم از طریق کلیک راست در پنجره‌های گرافیکی و انتخاب new folder بسازید و هم از طریق خط فرمان برای شروع مثلا یک دایرکتوری به نام YOUR_Mira را در نظر بگیرید mkdir YOUR_Mira از طریق خط فرمان وارد مسیر مورد نظر شوید cd YOUR_Mira به میرا بگویید که در این دایرکتوری پیکربندی شود mira init حالا شما در دایرکتوری خود این‌ها را می‌توانید ببینید YOUR_Mira/

برای نوشتن هر پست جدید لازم است که تیتر و طبقه‌ای که محتوا در آن تولید میشود با سوییچ های t یا title و سوییچ f یا floor مشخص کنیم، در صورتیکه طبقه را مشخص نکنید پست جدید در طبقه‌ای که به عنوان پیش فرض در تنظیمات مشخص شده ثبت میشود mira new -t "hello world" -f blog یا mira new --title="hello world" --floor=blog بعد از ساخته شدن اولین پست محتوا با پیغامی شبیه به این روبرو خواهید شد که محل و نام فایل جدید را مشخص می‌کند /Your_Mira/content/blog/2017-2-11-hello_world.ms created توجه۱: مسیر فایل در دایرکتوری content مشخص کننده‌ی طبقه‌ی آن برای انتشار است، تغیر مکان آن به معنی تغییر محل قرارگیر

حالا که اولین محتوای خود را نوشتیم وقت منتشر کردن آن رسیده برای انتشار باید طبقات ساختمان میرا را ساخت، برای این کار در خط فرمان تایپ کنید mira build تمام شد، صبر کنید تا ساخت تمام شود حالا به در دایرکتوری public بروید، چیزی شبیه به این را خواهید دید Your_Mira/public/ . ├── blog │   ├── 2017 │   │   └── 02 │   │   └── 12 │   │   └── hello-world │   │   └── index.html │   ├── archive │   │   └── 2017 │   │   └── 02 │   │   └── index.html │   ├── author │   │   └── kiavash │   │   └── index.html │   ├── categories │   │   ├── دسته-بندی-۱ │   │   │   └

برای دیدن یک پیش نمایش از سایت خود بر روی لوکال هاست و با استفاده از مرورگرتان، از سوییچ view استفاده کنید mira view پیغامی شبیه به این خواهید دید HTTP::Server::PSGI: Accepting connections at http://0:5000/ حالا بر روی لوکال هاست و port:5000 سایت شما قابل دسترسی است، مرورگر را باز کنید و در آدرس بار این صفحه را باز کنید: http://0.0.0.0:5000/ یا http://127.0.0.1:5000/ در صورتیکه بخواهید سرور پیش نمایش بر روی آدرس یا درگاه دیگری قابل دسترسی شود، از سوییچ های p یا port و سوییچ o یا host اسنفاده کنید mira view -o 127.0.0.1 -p 1024 یا mira view --host=127.255.255.254 --port=65535

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

هر چیزی که در فایل config.yml وجود دارد در سایت شما با برچسب MAIN و هر کدام از تنظیمات اختصاصی در که در شاخه config دارید در طبقه‌ی خودش با برچسب SITE قابل دسترسی است مثلاً اگر در config.yml فیلد icno را داشته باشیم {{ MAIN.icon }} یا اگر در config/books.yml فیلد logo داشته باشیم در تمام صفحات قالب books با این دستور قابل دسترسی است {{ SITE.logo }} همانطور که می‌بینید، میتوان از مقادیر config به عنوان مقادیر ثابت استفاده کرد، مثلا آدرس عکس لوگوی سایت را در تنظیمات مقدار دهی کرد: logo: /static/images/logo.png و هرجا نیاز بود آن را لود کرد: <img src ="{{ SITE.logo }}"> همچنین میتو

محتوا مهم‌ترین قسمت تشکیل دهنده‌ی سایت شماست، دقیق‌تر تنها دلیل استفاده از میرا مدیریت کردن و تولید خروجی برای محتوای شماست. محل نگهداری محتوای خام در شاخه‌ی content است، هر دایرکتوری در content یک طبقه‌ی مجزا از داده‌هاست که میتواند تنظیمات، دسته بندی‌ها و قالب خروجی اختصاصی خودش را داشته باشد.برای مثال blog یا document یا هرچیز دیگری. هر فایل موجود در این طبقات، یک محتوای خام قابل انتشار به حساب می‌آید. تنها از فایل‌هایی با پسوند draft چشم پوشی خواهد شد. همچنین این‌هایل‌ها میتوانند در شاخه‌ی اصلی طبقه یا در زیر شاخه‌هایی با هر عمقی باشند، تنها زیرشاخه‌ای که میرا برای پیدا کردن محتوا در آن

برای تولید محتوای جدید از دستور new با فرمت زیر استفاده کنید: mira new -t "YOUR POST TITLE" -f "blog" یا mira new --title="YOUR POST TITLE" --floor="blog" با پیامی شبیه به این روبرو خواهید شد: .../YOUR_Mira/content/blog/2017-2-15-YOUR_POST_TITLE.md created یک فایل در مسیر طبقه مورد نظر با پیشوند تاریخ و پسوند pen ساخته میشود، نام این فایل تاثیری در نتیجه خروجی نخواهد داشت، پس با خیال راحت و هر طور که دوست دارید میتوانید نام این فایل را تغییر دهید. نکته: در صورتی که میخواهید از انتشار یک فایل به شکل موقت چشم پوشی کنید، یا به اصطلاح آن را در درفت نگهداری کنید، تنها کافی است پسوند این فایل

تیتر، مشخصات، تنظیمات و هر خصوصیت دیگری که بخواهید به یک نوشته اختصاص دهید در قسمت سربرگ نوشته می‌شود، تعدادی فیلد در هر سربرگ به صورت پیش فرض تولید میشود، مابقی را میتوانید به صورت دستی به هر نوشته اضافه کنید یا فایلی همنام هر طبقه در شاخه structure بسازید و فیلدهایی که میخواهید با دستور new در سربرگ هر پست از یک طبقه خاص به صورت اتوماتیک تولید شوند را مشخص کنید بدون توجه به وجود فایل استراکچر این فیلدها همیشه هنگام ساختن پست جدید در سربرگ ظاهر میشوند utid date title

این فیلد از نظر سیستمی مهمترین فیلد هر نوشته میباشد، ترتیب نمایش، محل ذخیره در حافظه، آدرس دهی و هر چیزی که به محتوای شما مربوط باشد به این فیلد وابسته است. در صورتی که این فیلد موجو نباشد، میرا از تمام محتوای موجود چشم پوشی میکند. کلمه‌ی utid در اصل مخفف unique time ID میباشد، همانطور که از نام فیلد هم میتوان دریافت، این فیلد یک مشخصه یکتا است که براساس زمان تولید شده به شکل پیش فرض و در هنگام ساختن هر پست جدید یک شناسه چهارده رقمی از کنار هم قرار دادن سال، ماه، روز، ساعت، دقیقه و ثانیه تولید هر پست به عنوان مقدار این فیلد تولید میشود. ترتیب تولید و نمایش نوشته های شما در سایت بر اساس مقدا

تاریخ تولید فایل محتوا با یکی از این دو فرمت قابل قبول است YYYY-MM-DD HH:MM:SS YYYY-MM-DDTHH:MM:SS میرا تاریخ را با یک کاراکتر فاصیه بین تاریخ و زمان میسازد اما اگر فاصله با T هم جایگزین شود باز هم مورد قبول است، اما به جز این دو فرمت از حالت دیگری برای ذخیره تاریخ و زمان در فیلد date استفاده نکنید. این فیلد برای معتبر بودن، حتما باید تاریخ و زمان را با خود داشته باشد. پس در صورت نیاز به این فیلد، اقدام به حذف ساعت و دقیقه و ثانیه از این فیلد نکنید، اما میتوانید آنها را با صفر جایگزین کنید. هیچ الزامی به نگه داشتن این فیلد وجود ندارد، در صورت عدم نیاز، آن را خالی بگذارید یا حتی از سربرگ ح

تیتر یا عنوان نوشته شما وجود این فیلد هم مانند utid ضروری است و باید حتما مقدار دهی شود. اما بر خلاف utid، در صورت عدم وجود، میرا از پست چشم پوشی نمیکند، بلکه مقدار title را با عدد utid مساوی قرار می‌دهد. علاوه بر استفاده به عنوان تیتر نوشته در صفحات ایستا و هدرهای html، برای ساخت آدرس ثابت هر پست هم از این مقدار استفاده میشود، برای مثال اگر عنوان پست شما و فرمت مورد نظرتان برای تولید آدرس اینها باشد: title: 3rd Hel-lo World :) :year/:month/:title در نهایت آدرس یکتای این پست این خواهد بود: ADDRESS.COM/FLOOR/2017/02/3rd-hel-lo-world/ همانطور که در بالا دیدید هنگام تولید آدرس تمام علایم غی

همانطور که در مورد فیلد title خواندید، آدرس نهایی پست شما با استفاده از آن ساخته خواهد شد، اما در صورتیکه عنوان بیش از حدی که مایل باشید طولانی باشد و نخواهید آدرس طولانی داشته باشید، یا از چیزی به جز اعداد و حروف نوشتاری در عنوان استفاده کردید که وجودشان برای مفهوم بودن معنی ضروری است و میخواهید در آدرس از نام آنها به جای علامتشان استفاده کنید(مثلا به جای * در تیتر، در آدرس بنویسید star) یا حتی تیتر به زبان فارسی نوشته شده اما میخواهید آدرس به انگلیسی ساخته شود، میتوانید از این فیلد کمک بگیرید. برای مثال اگر عنوان پست شما چیزی شبیه به این باشد: یک تیتر خیلی خیلی طولانی در مورد هتل‌های ۵

نام نویسنده مطلب، به صورت پیش فرض با فیلدی که به همین نام در فایل تنظیمات مشخص کرده‌اید پر خواهد شد. در صورت عدم نیاز میتواند خالی بماند یا حذف شود قابل بازیابی در قالب در حلقه‌ی POSTS با استفاده از این برچسب: {{ author }}

فرمتی که با آن بدنه محتوا را مینویسید، یا همان markup language. به شکل پیش فرض با مقداری که به فیلدی با نام default_markup در فایل تنظیمات مشخص کرده‌اید پر خواهد شد، اما برای هر پست میتوانید آن را تغییر دهید. اگر در فایل تنظیمات مقداری برای این فیلد مشخص نکرده باشید و در سربرگ هم به آن مقداری ندهید میرا به شکل پیش فرض از markdown برای پردازش نهایی استفاده میکند. مقادیری که میرا برای این فیلد می‌شناسد، این‌ها هستند: markdown md textile bbcode html text txt مقادیر md و markdown یکی هستند، همچنین txt و text نیز یکی هستند. اگر میخواهید فقط از کدهای html در بدنه‌ی نوشته‌تان استفاده کنید و مقد

در حالت پیش فرض آدرس ایستای هر نوشته با مقداری که به فیلد permalink در فایل تنظیمات داده‌اید ساخته میشود، با مقدار دهی به این فیلد مقدار موجود در فایل تنظیمات نادیده گرفته میشود و از این مقدار استفاده خواهد شد. برای تنظیم این فیلد، دقیقا از همان مقادیری که برای فیلد permalink در فایل تنظیمات توضیح داده شده می‌توانید استفاده کنید.

میرا برای تولید خروجی نهایی تمام پست‌ها، به شکل پیش فرض از فایلی به نام post.tt2 در پوسته‌ای که در تنظیمات مشخص کرده‌اید استفاده می‌کند، اما اگر به این فیلد مقدار بدهید، پست مورد نظر، از یک قالب اختصاصی می‌تواند استفاده می‌کند.

در صورتیکه در هر پست به این فیلد مقدار page بدهید، پست مورد نظر، در صفحات اول سایت و کلیدهای page next و page prev پست‌ها لیست نمیشود. استفاده از این فیلد و فیلدهای layout و permalink برای ساختن صفحات در سایت مفید هست، برای مثال اگر بخواهید یک صفحه به نام «درباره من» بسازید که در صفحات سایت به صورت سریالی بین سایر نوشته‌ها نمایش داده نشود، میتوانید تنظیماتی شبیه به این در هدر آن داشته باشید title: درباره من _type: page _layout: about.tt2 _index: about _permalink: /:title/

به جز موارد ذکر شده از هر فیلد دیگری که بخواهید میتوانید در سربرگ استفاده کنید، مثلا اگر بخواهید برای هر نوشته یک عکس ثابت برای صفحه ایستای آن در کنار عنوان داشته باشید یا اگر مطالبی که مینویسید ترجمه‌ای از منابع مختلف است و میخواهید از نام منبع به شکل ثابتی در قالب جدا از بدنه نوشته استفاده کنید، یا هر چیز دیگر. میتوانید در سر برگ نوشته فیلدی برای این منظور ها بسازید thumbs: address.com/img/image.jpg source: other.com/post.html از این فیلدها در قالب در زیر مجموعه‌ی حلقه‌ی POSTS با برچسب‌هایی هم نام همین فیلدها میتوانید استفاده کنید {{ FOREACH POSTS }} <a href="{{ url }}#more>{{

اگر بخواهید فیلدهایی را با مقداری بیشتر از یک آیتم داشته باشید، باید آن‌ها را به صورت لیست‌هایی با این دستور زبان بسازید: نام فیلد، دونقطه، اینتر، فاصله، خط تیره، فاصله، مقدار categories: - cat1 - cat2 tags: - tag1 - tag2 - tag3 - tag4

در صورتیکه بخواهید بر اساس هر کدام از مقادیر سربرگ آٰشیو بسازید، مثل دسته بندی‌ها و ... باید حتما در فایل تنظیمات در قسمت lists نام فیلد را وارد کنید، مثل tags یا categories یا هر نوع آرشیو دیگری که مایل باشید. مقادیر آرشیو میتوانند لیست یا تکی باشند. برای مثال برای ساختن صفحات این اسناد از دو نوع لیست استفاده شده، chapter و tags که در chapter نام دسته‌ای که مطالب در آن نوشته شده به صورت تکی مشخص شده مثل تنظیمات و شروع و در tags، بر چسب هایی که برای هر نوشته در نظر گرفته‌ام، یا همان هش‌تگ ها

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

بدنه قسمت اصلی محتوای شماست، هر چیزی که در مورد آن میخواهید بنویسید در این قسمت قرار میگیرد.

برای نوشتن بدنه می‌توانید از Mrkup Language هایی که میرا پشتیبانی میکند، کدهای html یا متن‌های خالص استفاده کنید

markdown
md
textile
bbcode
html
text
txt

تنها به یاد داشته باشید که برای نمایش صحیح متن، در فیلد _markup در سربرگ هر فایل یا فایل تنظیمات، مشخص کرده باشید که دقیقا از چه مارک‌آپی برای نوشتن متن استفاده کرده‌اید.

قسمت‌های بدنه

بدنه هنگام پردازش به دو قسمت less و more تقسیم میشود، less خلاصه یا توضیحی از متنی است که مینویسید و more شامل تمام متن نوشته شده می‌شود

به شکل پیش فرض میرا ۶۰۰ حرف ابتدایی هر متن را بعد از حذف کردن تمام کدهای HTML که ممکن است در آن نوشته شده باشد و نادیده گرفتن تمام قواعد MarkUPی که استفاده کرده‌اید، به عنوان less مشخص می‌کند، اما در صورتیکه بخواهید مقدار less را می‌توانید خودتان مشخص کنید، کافی است هر جا که خواستید در متن‌تان این عبارت را بنویسید

<!-- more -->

تعداد فاصله ها مهم نیستند، میتوانید اینطور بنویسید

<!--        more               -->

تمام قسمت‌های قبل از آن به عنوان less مشخص می‌شوند، در این حالت کدهای HTML نیز از متن حذف نخواهند شد

خلاصه‌ای از متن
یا همان
less
در این قسمت نوشته شده

<!--     more     -->

ادامه متن
را در این قسمت
مینویسیم
کل متن قبل و بعد از نشانه گذار
به عنوان
more
شناخته خواهد شد

به یاد داشته باشید more شامل تمام متن، قبل و بعد از نشانه گذار

بعد از انجام تمام تنظیمات و تولید محتوا، مطمینا نیازمند خروجی برای محتوای تولید شده خواهیم بود، قالب یا template یا همان پوسته‌های خروجی، به ما برای ساختن ظاهر خروجی مطابق سلیقه و نیازهایمان کمک خواهند کرد. هر قالب یک دایرکتوری است در شاخه‌ی template از شاخه‌ی اصلی. برای استفاده از قالب ها نام این دایرکتوری را در فایل تنظیمات در مقابل فیلد template وارد کنید. اجزای اصلی تشکیل دهنده هر قالب، این پنج فایل هستند /template/THEME/ . ├── archive.tt2 ├── atom.tt2 ├── index.tt2 ├── main.tt2 └── post.tt2 همچنین دایرکتوری به نام include هم در شاخه‌ی پوسته، هنگام پردازش نهایی دیده میشود و اگر بخواهید

برچسب‌های معتبر در این قالب و مقادیرشان. {{ MainTITLE }} {{ MainDESCRIPTION }} {{ MainURL }} {{ MainROOT }} {{ MainSTATIC }} {{ MainIMAGEURL }} {{ MainAUTHOR }} {{ MainEMAIL }} {{ MainPageTitle }} تنها راه نمایش محتوا در صفحه‌ی main، استفاده از حلقه‌ی FLOORS به صورت مستقل، یا حلقه‌ی ENTRIES و کلیدهای UTIDS می‌باشد. برای انتشار محتوا در هر سایت از حلقه‌ی POSTS استفاده خواهیم کرد، دقت کنید این حلقه در main معتبر نیست. اما posts به عنوان یک حلقه زیر مجموعه FLOORS معتبر است. FLOORS این حلقه تنها به اندازه‌ی مقداری که در فیلد post_num در فایل config.yml مشخص کرده‌اید از محتوای هر طبقه را در

به جز برچسب UTIDS تمام برچسب‌های main.tt2 در index و atom feed با همان مقادیر معتبر هستند {{ MianTITLE }} {{ MianDESCRIPTION }} {{ MianURL }} {{ MianROOT }} {{ MianSTATIC }} {{ MainIMAGEURL }} {{ MianAUTHOR }} {{ MianEMAIL }} {{ PageTITLE }} {{ TITLE }} {{ DESCRIPTION }} {{ URL }} {{ ROOT }} {{ STATIC }} {{ IMAGEURL }} {{ AUTHOR }} {{ EMAIL }} {{ ARCHIVES}} : {{ FOREACH archive IN ARCHIVES.pairs }} برای اطلاعات کامل‌تر در مورد آرشیو ها قسمت اول بخش پوسته ها را ببینید، این برچسب مناسب برای نمایش در سایدبار و امثال آن است. برای ساختن صفحات آرشیو، archive.tt2 از POSTS استفاده می‌کند، کارکرد ا

به جز برچسب UTIDS تمام برچسب‌های main.tt2 و index.tt2 در archive با همان مقادیر معتبر هستند {{ MainTITLE }} {{ MainDESCRIPTION }} {{ MainURL }} {{ MainROOT }} {{ MainSTATIC }} {{ MainIMAGEURL }} {{ MainAUTHOR }} {{ MainEMAIL }} {{ MainPageTitle }} {{ TITLE }} {{ DESCRIPTION }} {{ URL }} {{ ROOT }} {{ STATIC }} {{ IMAGEURL }} {{ AUTHOR }} {{ EMAIL }} {{ ArchiveTITLE }} {{ ENTRIES }} {{ FLOORS }}

تمام برچسب‌های index.tt2 در post.tt2 با همان مقادیر معتبر هستند. تنها برچسب اختصاصی در این الگو PostTITLE است که برابر با نام تیتر نوشته شما یا همان فیلد title در سربرگ میباشد {{ MainTITLE }} {{ MainDESCRIPTION }} {{ MainURL }} {{ MainROOT }} {{ MainSTATIC }} {{ MainIMGURL }} {{ MainAUTHOR }} {{ MainEMAIL }} {{ MainPageTitle }} {{ TITLE }} {{ DESCRIPTION }} {{ URL }} {{ ROOT }} {{ STATIC }} {{ IMAGEURL }} {{ AUTHOR }} {{ EMAIL }} {{ ARCHIVES}} : {{ FOREACH archive IN ARCHIVES.pairs }} برای اطلاعات کامل‌تر در مورد آرشیو ها قسمت اول بخش پوسته ها را ببینید، این برچسب مناسب برای نمایش در ساید

جهت نمایش محتوا در هر کدام از صفحات باید از حلقه‌ای که مقادیر POSTS را نمایش خواهد داد استفاده کرد. در تمام صفحات به جز صفحه‌ی main.tt2 برای نمایش محتوا از این حلقه استفاده می‌شود. {{ FOREACH POSTS }} ... {{ END }} اطلاعات ذخیره شده در هر POSTS چیزی شبیه به بلوک زیر است، بسته به تنظیم شخصی که انجام دادید، ممکن است فیلدها کمتر یا بیشتر باشند. 'title' => "post title", 'author' => 'kiavash', 'floor' => 'blog', 'body' => { 'less' => "less body content", 'more' => "full body content" }, 'date' => '2017-02-10 17:45:03', 'CALENDAR' => {

تمام فیلدهای موجود در فایل‌های تنظیم را میتوان به پوسته نیز وارد کرد برای داشتن مقادیر موجود در فایل config.yml از برچسب MAIN و تنظیمات ذخیره شده در شاخه‌ی کانفیگ برای هر طبقه با برچسب SITE در قالب قابل بازیابی هستند. حتی تمام مقادیری که برچسب مستقل دارند مسث description و ... را نیز میتوان از این راه نیز به قالب وارد کرد. برای مثال اگر در config.yml فیلد icno را داشته باشیم {{ MAIN.icon }} یا اگر در config/books.yml فیلد logo داشته باشیم در تمام صفحات قالب books با این دستور قابل دسترسی است {{ SITE.logo }} همچنین فیلدهایی که مانند آرایه یا هش، به شکل لیستی از پشته‌ها ذخیره شده‌اند را ه

با استفاده از قواعد درونی parserهای میرا میتوان علاوه بر استفاده از markup برای نوشتن بدنه محتوا، از برچسب‌های درونی میرا نیز استفاده کرد

در هر قسمت از فایل محتوایی که با پسوند pen تولید شده، با استفاده از برچسب {{ img }} میتوان یک عکس را در بدنه نوشته لود کرد قاعده استفاده از آن به این شکل است: {{ img addres/image.jpg [alt] [title] }} در این برچسب alt و title اختیاری هستند هر دو گزینه‌ی alt و title باید بین [] قرار بگیرند آدرس عکسی که لود میکنید اگر با http:// https:// ftp:// یا هرچیزی مثل این‌ها شروع نشود از فیلد imageurl در فایل تنظیمات طبقه انشعاب میگیرد. در هر جایی از نوشته که میرا با برچسب بالا مواجه شود آن را با کد html شبیه به این یکی میداند. <img src="/FLOOR/IMG/address/image.jpg" alt="alt" title="title">