i.5. قواعد این راهنما
این راهنما فرضیات و پیشنیازهای زیر را در نظر می‌گیرد:
- این راهنما بر اساس موضوعات طبقه‌بندی شده است؛ برای جزئیات بیشتر قسمت i.3, “سازمان‌دهی” را مشاهده کنید. بسیاری موضوعات شامل یک قسمت دانش پیشنیاز هستند، که به فهرست کردن سایر موضوعات جانبی برای درک بهتر موضوع اصلی می‌پردازد. برخی دانش پیش‌زمینه که پوشش داده نمی‌شود نیز مد نظر است؛ برای جزئیات بیشتر قسمت i.2, “مخاطب و اهداف” را مشاهده کنید.
- بسیاری موضوعات تمرینی به فهرست کردن پیشنیازهای سایت می‌پردازند، یعنی کارهایی که باید قبل از انجام دادن تمرین روی سایت خود انجام دهید.
- مشخصات پیشنیازهای سایت، مرتبط با سناریویی مبتنی بر ایجاد یک سایت برای فروشگاه محصولات کشاورزی است (برای جزئیات بیشتر قسمت i.6, “سناریوی راهنما” را مشاهده کنید). تمرین‌ها را می‌توانید با سناریوی خود منطبق سازید، اما باید تغییرات مورد نیاز را با توجه به مطابقت سایت با تمرین به یاد داشته باشید.
- برای تمام موضوعات کاربردی پس از قسمت 3.4, “اجرای فرآیند نصب” ، یک پیشنیاز ضمنی وجود دارد: باید نرم‌افزار مدیریت محتوا رو نصب کرده باشید و با حساب کاربری اصلی وارد آن شوید (مانند حساب کاربری که هنگام نصب سایت ایجاد کرده‌اید، که به صورت پیشفرض تمام مجوزهای لازم را دارد).
- اگر تمام موضوعات را به ترتیب مطالعه و تمام گام‌ها را در یک تمرین اجرا کنید، باید دانش پیشنیاز و و پیشنیازهای سایت را نیز مظالعه کرده باشید.
قواعد زیر در متن این راهنما استفاده شده‌اند:
- نشانی example.com به معنای نشانی اصلی وبسایت شماست. قسمت پیمایش را در ادامه برای جزئیات بیشتر درباره نشانی‌های داخلی سایت خود مشاهده کنید.
- متنی که در رابط کاربری سایت خود می‌بینید به صورت italics می‌آید مانند: کلیک روی Save configuration. این تنها در مورد متن موجود در نرم‌افزار اصلی است، نه متنی که در یک موضوع قبلی وارد شده است. برای نمونه، در موضوعی درباره ویرایش، ممکن است چنین دستورالعملی ببینید: روی ویرایش در بالای صفحه About کلیک کنید(ویرایش ممکن است به صورت ایتالیک باشد، اما About نیست چرا که صفحه About در یک موضوع قبلی ایجاد شده است).
- نشانی‌ها، نام فایل‌ها و اصطلاحات جدید به صورت italics نمایش می‌یابند.
متنی که باید در قالب دستور در محبط خط-فرمان وارد شود به صورت monospace نمایش می‌یابد مانند:
drush cc
- در این راهنما، کلمه دایرکتوری همیشه در مورد محلی برای ذخیره‌سازی فایل‌ها استفاده می‌شود (که برخی افراد با نام فولدر به آن اشاره می‌کنند).
برای انجام اکثر موضوعات تمرینی در این راهنما، نیاز است که به یک یا چند صفحه در رابط مدیریتی سایت خود مراجعه کنید. ممکن است چیزی مشابه با این در دستورالعمل‌ها ببینید (زمانی که نرم‌افزار را نصب کنید درک بهتری خواهید داشت):
از منوی مدیریت به مسیر ساختار > دسته‌بندی (admin/structure/taxonomy) بروید.
دستورالعمل‌های پیمایش نظیر این، فرض را بر این می‌گذارند که افزونه Toolbar را نصب دارید و این نمونه به معنی این است که در نوار منوی بالای صفحه پس از کلیک روی گزینه مدیریت باید به مسیر ساختار سپس دسته‌بندی بروید و در این مسیر نشانی صفحه عبارت است از http://example.com/admin/structure/taxonomy (اگر نشانی پایه سایت شما http://example.com باشد).
در اینجا نمونه دیگری مشاهده می‌کنید:
از منوی مدیریت به مسیر پیکربندی > سیستم > اطلاعات سایت (admin/config/system/site-information) بروید.
در این نمونه، پس از کلیک روی مدیریت و پیکربندی باید قسمت سیستم را پیدا کرده و روی اطلاعات سایت کلیک کنید. در انتها در مسیر http://example.com/admin/config/system/site-information قرار می‌گیرید.
یک نکته دیگر: اگر از قالب استاندارد مدیریتی Seven استفاده می‌کنید، بسیاری از دکمه‌های "افزودن" در رابط مدیریتی آن با علامت + نمایش داده می‌شوند. برای نمونه، در admin/content دکمه افزودن محتوای جدید به صورت افزودن محتوای جدید + نمایش می‌یابد. اگرچه، این عمل مبتنی بر قالب است و در حقیقت قسمتی از متن روی دکمه نیست (برای نمونه، الزاما توسط یک صفحه‌خوان خوانده نمی‌شود). پس در این راهنما، به علامت + روی دکمه‌ها اشاره‌ای نمی‌شود.
بسیاری از موضوعات تمرینی این راهنما شامل گامی هستند که باید در آن یک فرم را پر کنید. در اکثر موارد، یک تصویر از فرم نمایش داده می‌شود، به همراه جدولی از مقدارها که باید در فیلدهای آن قرار دهید. برای نمونه، ممکن است جدولی را ببینید که به صورت زیر شروع می‌شود، که اطلاعات سایت را برای فرم مربوط به آن در پیکربندی > سیستم > اطلاعات سایت (admin/config/system/site-information) توضیح می‌دهد.
| نام فیلد | توضیحات | مقدار نمونه |
|---|---|---|
نام سایت | نام سایت شما | فروشگاه محصولات کشاورزی |
برای استفاده از این جدول، در فیلد نام سایت اطلاعات موجود را در آن قرار دهید. یک نام نمونه عبارت است از "فروشگاه محصولات کشاورزی"، که به سناریوی ایجاد یک وبسایت برای فروشگاه کشاورزی اشاره شده در این راهنما مرتبط است (برای جزئیات بیشتر قسمت i.6, “سناریوی راهنما” را مشاهده کنید).
مشارکت‌کنندگان
نگارش و ویرایش توسط Jennifer Hodgdon
ترجمه توسط Navid Emami
Source file: preface-conventions.asciidoc
Help improve this page
You can:
- Log in, click Edit, and edit this page
- Log in, click Discuss, update the Page status value, and suggest an improvement
- Log in and create a Documentation issue with your suggestion
