diff options
Diffstat (limited to 'files/fa/mdn/contribute/howto')
4 files changed, 272 insertions, 0 deletions
diff --git a/files/fa/mdn/contribute/howto/be_a_beta_tester/index.html b/files/fa/mdn/contribute/howto/be_a_beta_tester/index.html new file mode 100644 index 0000000000..5f3f96aa8c --- /dev/null +++ b/files/fa/mdn/contribute/howto/be_a_beta_tester/index.html @@ -0,0 +1,36 @@ +--- +title: چطور یک آزمایش کنندهٔ بتا شوید +slug: MDN/Contribute/Howto/Be_a_beta_tester +translation_of: MDN/Contribute/Howto/Be_a_beta_tester +--- +<div>{{MDNSidebar}}</div><p>هر از گاهی توسعه‌دهندگان پلتفرم MDN یا <a href="https://developer.mozilla.org/en-US/docs/MDN/Kuma">Kuma</a> تغیراتی در وب‌سایت ایجاد می‌کنند، ما این تغییرات را به کاربرانی که در برنامه آزمایش بتا فعال شده باشند نمایش می‌دهیم. همانطور که در تمام نسخه‌های بتا متداول است، بعضی از امکانات در شرایط خاصی ممکن است به درستی کار نکنند.</p> + +<h2 id="وارد_برنامه_تست_بتا_شوید">وارد برنامه تست بتا شوید</h2> + +<ol> + <li>هنگامی که وارد MDN شده‌اید، بر روی نام خود در نوار بالایی کلیک کنید. این کار شما را به صفحه مجموعه تنظیمات شما می‌برد.</li> + <li>بر روی دکمه <strong>Edit </strong>کلیک کنید. این کار صفحه شما را در حالت ویرایش باز می‌کند.</li> + <li>گزینه مربوط به <strong>Beta tester </strong>را انتخاب کنید.</li> + <li>بر روی دکمه <strong>Publish </strong>کلیک کنید.</li> +</ol> + +<h2 id="از_برنامه_تست_بتا_خارج_شوید">از برنامه تست بتا خارج شوید</h2> + +<ol> + <li>هنگامی که وارد MDN شده‌اید، بر روی نام خود در نوار بالایی کلیک کنید. این کار شما را به صفحه مجموعه تنظیمات شما می‌برد.</li> + <li>بر روی دکمه <strong>Edit </strong>کلیک کنید. این کار صفحه شما را در حالت ویرایش باز می‌کند.</li> + <li>گزینه مربوط به <strong>Beta tester </strong>را پاک کنید.</li> + <li>بر روی دکمه <strong>Publish </strong>کلیک کنید.</li> +</ol> + +<h2 id="بازخوردهای_خود_را_گزارش_کنید">بازخوردهای خود را گزارش کنید</h2> + +<ol> + <li>اگر در باگزیلا حساب ندارید، <a href="https://bugzilla.mozilla.org/createaccount.cgi">یک حساب باز کنید</a>.</li> + <li><a href="https://bugzilla.mozilla.org/form.mdn#h=detail%7Cbug">یک گزارش اشکال برای MDN در باگزیلا</a> باز کنید.</li> + <li>کلمه «Beta» را در فیلد خلاصه وارد کنید تا توسعه‌دهندگان MDN بتوانند آنها را فیلتر و به راحتی تست کنند.</li> + <li>گزارش اشکال خود را به بهترین حالتی که می‌توانید پُر کنید. تا آنجایی که می‌توانید جزئیات را تشریح کنید.</li> + <li>بر روی دکمه <strong>Submit </strong>کلیک کنید.</li> +</ol> + +<p> </p> diff --git a/files/fa/mdn/contribute/howto/create_and_edit_pages/index.html b/files/fa/mdn/contribute/howto/create_and_edit_pages/index.html new file mode 100644 index 0000000000..82d2ebb7bd --- /dev/null +++ b/files/fa/mdn/contribute/howto/create_and_edit_pages/index.html @@ -0,0 +1,179 @@ +--- +title: نحوه ایجاد و ویرایش صفحات +slug: MDN/Contribute/Howto/Create_and_edit_pages +translation_of: MDN/Contribute/Howto/Create_and_edit_pages +--- +<div>{{MDNSidebar}}</div> + +<p><span class="seoSummary">این مقاله عوامل جدیدی را در روند ویرایش صفحات موجود و ایجاد صفحات جدید معرفی می کند.</span></p> + +<h2 id="Editing_an_existing_page">Editing an existing page</h2> + +<p>To edit a page:</p> + +<ol> + <li>If you are on the read-only version of MDN Web Docs (https://developer.mozilla.org), click <strong>Edit in wiki</strong> in the article header. This takes you to the editable, wiki version of the site (https://wiki.developer.mozilla.org), but does not actually open the editing interface.</li> + <li>Click the <strong>Edit</strong> button in the article header of the wiki page.</li> + <li>The page then reloads, with an editing interface where you can add or delete information directly.</li> + <li>Add paragraphs, delete text, insert headings, and perform more of the basic functions involved in writing and editing.</li> +</ol> + +<p>See the guide to <a href="/en-US/docs/MDN/Contribute/Editor/Basics">Editor UI elements</a> in the <a href="/en-US/docs/MDN/Contribute/Editor">MDN Editor guide</a> for more information on using <strong>MDN</strong>'s built-in editor.</p> + +<h3 id="Preview_changes">Preview changes</h3> + +<p>To see what your changes look like:</p> + +<ul> + <li>Click the <strong>Preview</strong> button, within the editing function at the top or bottom of the page.</li> + <li>This opens the preview page, showing your revisions in a new window, or tab.</li> + <li>Each time you click this button, it refreshes your preview page with the latest changes.</li> +</ul> + +<p>Be careful! Previewing a page <strong>does not</strong> save your progress. Don't close the editing tab until you've saved your work.</p> + +<h3 id="Revision_comment">Revision comment</h3> + +<p>After previewing your changes, you will want to <em>save your revision</em>. Before you <strong>save</strong>, look for the revision comment box, below the editing box, leaving a comment to inform other contributors why you made changes. For example, you might have added a new section, changed some words to make the terminology more consistent, rewritten a paragraph to clarify the language, or removed information because it was redundant.</p> + +<h3 id="Table_of_Contents">Table of Contents</h3> + +<p>The 'On this Page' section of an article, is an auto-generated list of links to the headings on the page. The wording of these can be edited via the headings. It's also possible to remove a table of contents or decrease its number of links, by selecting 'Edit Page Title and Properties', changing the value of the "TOC" drop down.</p> + +<h3 id="Tags">Tags</h3> + +<p>You can add or remove tags, which describe the page content and purpose, below the editing section. See <a href="/en-US/docs/MDN/Contribute/Tagging">How to properly tag pages</a>, for information on which tags to apply.</p> + +<h3 id="Review_needed">Review needed?</h3> + +<p>If an expert or experienced contributor should review your edits, please request a technical review (for code, API's, or technologies), and/or an editorial review (for prose, grammar, and content), making sure the appropriate box is checked before you save.</p> + +<h3 id="Attach_files">Attach files</h3> + +<p>Attaching files requires a special user privilege. See <a href="/en-US/docs/MDN/Contribute/Editor/Basics/Attachments">Attachments in the MDN editor</a> for details, including how to request the upload privilege.</p> + +<h3 id="Publish_Discard_or_Keep_editing">Publish, Discard, or Keep editing</h3> + +<p>When you finish editing and are happy with your preview, publish your work and comments by clicking the <em>green</em> <strong>Publish</strong> button, to the <strong>right of the page title</strong>, or towards the <strong>bottom of the page</strong>. If you wish to continue working, click <strong>Publish and keep editing</strong>, which publishes your changes and keeps the edit interface open.</p> + +<p>If you change your mind, you can discard edits, by clicking the <em>red</em> <strong>Discard</strong> button. Note that discarding changes <em>permanently</em> discards them.</p> + +<p>Pressing <strong>Enter</strong> in the Revision Comment field is equivalent to clicking <strong>Publish and Keep Editing</strong>.</p> + +<div class="note"> +<p>Note: If attempting to save, but changes are rejected as invalid, and you feel the content is appropriate for MDN, <a href="mailto:mdn-admins@mozilla.com?subject=MDN%3A%20Content%20Rejection%20Appeal&body=%3CDescribe%20the%20content%20you%20were%20trying%20to%20save%20and%20where%20you%20were%20trying%20to%20place%20it.%3E">email the MDN admin team</a> for assistance.</p> +</div> + +<h2 id="Getting_page-creation_permissions">Getting page-creation permissions</h2> + +<p>For security reasons, newly-created accounts don't have the ability to create new pages. If you try to do so, you'll see a page instructing you how to get the page created. There are two options:</p> + +<ul> + <li><strong>Ask for the page to be created for you.</strong> To do this, <a href="https://github.com/mdn/sprints/issues/new?template=issue-template.md&projects=mdn/sprints/2&labels=user-report">file a documentation request issue</a>, with the title "Create page: <page title>". Fill out the URL field of the template with the location on MDN where you'd like the page to go if you know where to place it. In the comment text, include information on why this page needs creating.</li> + <li><strong>Request page creation privileges.</strong> If you request page creation privileges, and they're granted to you, you'll be able to add new pages by following the instructions here. To request these privileges, <a href="mailto:mdn-admins@mozilla.org">email the MDN admin</a> team with your request. Include your username, why you would like to have the ability to create new pages. For instance, you're documenting a new API which involves many new pages, or you'd like to add new terms to the glossary. You should also have made useful contributions to this site's content, and been a contributor for some time. This length of time, and the other factors are collectively considered.</li> +</ul> + +<h2 id="Creating_a_new_page">Creating a new page</h2> + +<p>Once you have page-creation permission, you can begin creating pages.</p> + +<p>If you do not know where to place a new article, <strong>do not worry.</strong> Put it anywhere, we will find it, move to where it belongs, or merge it into existing content. Whatever makes the most sense. Do not worry about making it perfect. We have happy helper gnomes who help to make your content clean and rather luscious.</p> + +<p>There are a few ways to create a new page:</p> + +<ul> + <li><a href="#Missing_page_link">'Missing page' link.</a></li> + <li><a href="#New_page_without_link">New page without a link.</a></li> + <li><a href="#Subpage_of_an_existing_page">A subpage of an existing page.</a></li> + <li><a href="#Clone_of_an_existing_page">Clone of an existing page.</a></li> + <li><a href="#Link_from_an_existing_page">Link from an existing page.</a></li> +</ul> + +<h3 id="Missing_page_link">'Missing page' link</h3> + +<p>As with most wikis, it is possible to create a link to a page that is yet to exist. For example, an author might create a list of all the members of an API, before creating the pages for those members. On MDN, links to non-existent pages are typically displayed in red.</p> + +<p>To create a page from a 'missing page' link:</p> + +<ol> + <li>Log into MDN, and have page-creation permission. If not logged in, clicking a 'missing page' link results in a 404 (page not found) error.</li> + <li>Click the 'missing page' link. If you have page creation permission, the <a href="/en-US/docs/MDN/Contribute/Editor">MDN Editor UI</a> opens, ready for you to create the missing page.</li> + <li>Write the content of the page, and save it.</li> +</ol> + +<h3 id="New_page_without_link">New page without link</h3> + +<p><em>To create a new page without linking from another page</em>, enter a unique page name in the URL field of your browser. For example, if you enter:</p> + +<pre class="language-html notranslate">https://wiki.developer.mozilla.org/en-US/docs/FooBar</pre> + +<p>MDN Creates a new page, with the title "FooBar", opening the editor for you to add new content. Refer to the <a href="#Editing_an_existing_page">Editing an existing page</a> section of this article, for information on how to use the editor mode.</p> + +<p><em>To create a new page without linking from another page</em>:</p> + +<ol> + <li>Log in, and have page-creation permission.</li> + <li>Enter the following in the URL field of your browser:</li> +</ol> + +<pre class="language-html notranslate">https://wiki.developer.mozilla.org/en-US/docs/new</pre> + +<p>MDN Creates a new page, with a place for a title, opening the editor to add new content to this page. Refer to <a href="#Editing_an_existing_page">Editing an existing page</a>, for information on using editor mode.</p> + +<h3 id="Subpage_of_an_existing_page">Subpage of an existing page</h3> + +<p>To create a page you want to be below an existing page, in the page hierarchy:</p> + +<ol> + <li>If needed, navigate to the wiki site by clicking <strong>Edit in wiki</strong> in the article header.</li> + <li>On the 'parent' page, click the <strong>Advanced</strong> menu (the gear icon in the toolbar), then click <strong>New sub-page</strong>.</li> + <li>An editor view opens for creating a new document.</li> + <li>Add a title for this document, in the <strong>Title</strong> field.</li> + <li>Change the <strong>Slug</strong> field, if needed. For example, if the title is long, and a shorter URL seems appropriate. This field is automatically filled by the editor, substituting underscores for spaces found in the title, changing only the last part of the URL.</li> + <li>In the <strong>TOC</strong> field, select heading levels you want to be displayed in the table of contents for the page. Or select 'No table of contents', if one is not needed.</li> + <li>Write content of the page in the editor pane, saving your changes. Refer to <a href="#Editing_an_existing_page">Editing an existing page</a>, for further information on using editor mode.</li> +</ol> + +<h3 id="Clone_of_an_existing_page">Clone of an existing page</h3> + +<p>If there is an existing page, whose format you wish to use as a base for your new page, you can 'clone' that page, and then change its content.</p> + +<ol> + <li>If needed, navigate to the wiki site by clicking <strong>Edit in wiki</strong> in the article header.</li> + <li>On the original page, click the <strong>Advanced</strong> menu (the gear icon in the toolbar), and click <strong>Clone this page</strong>. An editor view opens, for creating a new document.</li> + <li>Change the <strong>Title</strong> of the page, as appropriate for the new content. The <strong>Slug</strong> field is updated automatically as you change the <strong>Title</strong> field.</li> + <li>Change the path portion of the <strong>Slug</strong> field, as needed, to put the new document in a different location in the document hierarchy. In most cases, this is not needed. A cloned page often has similar content to its original, and need to be in a similar location.</li> + <li>In the <strong>TOC</strong> field, select the heading levels you want to be automatically displayed in the table of contents for this page. Or select 'No table of contents', if one is not needed.</li> + <li>Write your content in the editor pane, saving your changes. Refer to <a href="#Editing_an_existing_page">Editing an existing page</a>, for more information on using editor mode.</li> +</ol> + +<h3 id="Link_from_an_existing_page">Link from an existing page</h3> + +<p>This is a bit of a hybrid. You can create a link on another page, then click the link you just inserted, to create the new page:</p> + +<ol> + <li>Enter the name of your new page, anywhere that makes sense in the text of an existing page.</li> + <li>Highlight this new name, and <strong>click the Link icon (<img alt="" src="https://developer.mozilla.org/files/3810/link-icon.png" style="height: 28px; width: 29px;">) </strong>in the editor's toolbar. The <strong>'Update Link'</strong> dialog opens, with the highlighted text in the <strong>'Link To'</strong> field.</li> + <li><strong>"/en-US/docs/"</strong> is inserted by default, to the beginning of the URL field.<em> Enter the name </em>of the page after "/en-US/docs/". The page name does not have to be the same as the link text.</li> + <li>Click <strong>OK</strong>, to create and insert the link.</li> +</ol> + +<p>If the page does not yet exist, the link is displayed in red. If the page <em>does</em> exist, the link is displayed blue. If you want to create a new page, but the page title you desire is already taken, check if it makes sense helping edit and improve the page already there. Otherwise, think of a unique title for your new page, and create a link for it. Refer to <a href="https://developer.mozilla.org/Project:en/Page_Naming_Guide" title="Project:en/Page_Naming_Guide">page naming guide</a> for guidelines.</p> + +<p>To add content to your new page, click on the red link you just created, after saving and closing the editor. The new page opens in editor mode, enabling you to start writing. Refer to <a href="#Editing_an_existing_page">Editing an existing page</a>, for further information on using editor mode.</p> + +<h2 id="Refreshing_page_content">Refreshing page content</h2> + +<p>MDN support of KumaScript macros, and integration of content from other pages can sometimes be hampered by the need for caching of pages, for performance reasons. Pages are built from their source, and this output is cached for future requests. From that moment on, any macros (templates), or integrations (using the macro<span class="templateLink"><code><a href="https://developer.mozilla.org/en-US/docs/Template:Page">Page</a></code></span>), will not reflect later changes made to the macro, its output, or the contents of the integrated material.</p> + +<ul> + <li>To manually update a page, force-refresh your Web browser. MDN detects this, triggering a page rebuild, pulling in updated macro output, and integrating page content.</li> + <li>You can also configure pages to periodically rebuild, automatically. This should not be done unless you expect the page to update frequently. See <a href="/en-US/docs/MDN/Contribute/Tools/Page_regeneration">Page regeneration</a>, for detailed information.</li> +</ul> + +<h2 id="See_also">See also</h2> + +<ul> + <li><a href="/en-US/docs/MDN/Contribute/Editor">MDN editor guide</a></li> + <li><a href="/en-US/docs/MDN/Contribute/Content/Style_guide">MDN style guide</a></li> +</ul> diff --git a/files/fa/mdn/contribute/howto/index.html b/files/fa/mdn/contribute/howto/index.html new file mode 100644 index 0000000000..08734f5092 --- /dev/null +++ b/files/fa/mdn/contribute/howto/index.html @@ -0,0 +1,15 @@ +--- +title: How-to guides +slug: MDN/Contribute/Howto +tags: + - Landing + - MDN Meta + - NeedsTranslation + - TopicStub +translation_of: MDN/Contribute/Howto +--- +<div>{{MDNSidebar}}</div><div>{{IncludeSubnav("/en-US/docs/MDN")}}</div> + +<p>These articles provide step-by-step guides to accomplishing specific goals when contributing to MDN.</p> + +<p>{{LandingPageListSubpages}}</p> diff --git a/files/fa/mdn/contribute/howto/ساختنـحسابـکاربری/index.html b/files/fa/mdn/contribute/howto/ساختنـحسابـکاربری/index.html new file mode 100644 index 0000000000..4eb955f71c --- /dev/null +++ b/files/fa/mdn/contribute/howto/ساختنـحسابـکاربری/index.html @@ -0,0 +1,42 @@ +--- +title: چگونه یک حساب کاربری بسازیم +slug: MDN/Contribute/Howto/ساختنـحسابـکاربری +translation_of: MDN/Contribute/Howto/Create_an_MDN_account +--- +<div>{{MDNSidebar}}</div><p dir="rtl"><span class="seoSummary">برای اینکه بتوانید مطالب داخل MDN را تغییر دهید , باید یک اکانت MDN بسازید . اما اگر فقط می خواهید از مطالب MDN استفاده کنید میازی به این اکانت ندارید . این مطلب جهت راهنمایی شما جهت ساختن پروفایلی داخل MDN است .</span></p> + +<div class="pull-aside"> +<div class="moreinfo" dir="rtl"><strong>چرا MDN به آدرس ایمیل من نیاز دارد ؟</strong><br> +<br> +آدرس ایمیل شما برای بازگردانی و بازنشانی اکانت MDN شما ( البته اگر نیازی به اینکار باشد ) توسط مدیران MDN تا از این طریق بتوانند در مورد خوده اکانت یا فعالیت های شما داخل این سایت با شما تماس بگیرند .<br> +<br> +علاوه بر این شما می توانید برای دریافت اطلاعیه ها ( مثلا در مورد<a href="https://developer.mozilla.org/en-US/docs/MDN/Contribute/Howto/Watch_a_page"> تغییر برخی صفحات خاص</a> ) یا پیغام ها ( به عنوان مثال اگر شما عضو گروه توسعه دهنده ما باشید , باید ایمیل هایی را که درباره یه اجزای جدیدی که نیاز به تست شدن دارن دریافت کنید ) .<br> +<br> +آدرس ایمیل شما هیچوقت داخل MDN نمایش داده نمی شود و فقط در مواردی که در <a href="https://www.mozilla.org/privacy/websites/">سیاست نامه ی حفظ حریم خصوصی</a> نامبرده شده است استفاده خواهد شد .<br> + +<div class="note"> +<p dir="rtl"><strong>پای نوشت : اگر شما با استفاده از GitHub وارد MDN شده اید, و اگر شما در GitHub از یک آدرس « نادرست » ایمیل استفاده کرده اید , شما این پیام ها را از MDN دریافت نخواهی کرد . ( که شامل اطلاعیه های صفحاتی که عضوش شده اید میشود </strong></p> +</div> +</div> + + +</div> + +<ol dir="rtl"> + <li>بالای هر صفحه ی MDN شما یک دکمه که روی آن عبارت <strong>Sign In </strong>نوشته شده است را می بینید . نشانگر موس خود را روی این دکمه ببرید ( ولی اگر از تلفن همراه استفاده می کنید باید لمسش کنید ) تا لیستی از سرویس های احراز هویتی که ما برای وارد شدن به MDN از آنها حمایت می کنیم به نمایش گزاشته شود .</li> + <li>سرویسی را برای وارد شدن انتخاب کنید . در حال حاضر این کار فقط با GitHub ممکن است . به یاد داشته باشید که اگر شما از GitHub برای اینکار استفاده کنید , پیوندی به اکانت GitHub شما در صفحه ی پروفایل شما در MDN ایجاد خواهد شد .</li> + <li>مراحلی درخواستی GitHub را دنبال کنید تا اکانت خود را به MDN متصل کنید .</li> + <li>وقتی که سیستم احراز هویت شما را به MDN باز گرداند, از شما درخواست میشود تا عبارتی را جهت نام کاربری و آدرس ایمیل خود را وارد کنید .<em>نام کاربری شما به صورت عمومی جهت نسبت دادن کارهای انجام شده توسط شما به کار گرفته میشود . <u>از آدرس ایمیل خود جهت نام کاربری خود استفاده نکنید</u> .</em></li> + <li>روی عبارت <strong>Create my MDN profile </strong>کلیک کنید .</li> + <li>اگر آدرس ایمیلی که شما در مرحله ی چهار وارد کرده اید با آدرس ایمیلی که سیستم احراز هویت استفاده کرده است مغایرت دارد , لطفا ایمیل خود را چک کرده و روی لینکی که ما برای تایید فرستاده ایم کلیک کنید .</li> +</ol> + +<p dir="rtl">تمام شد ! شما یک اکانت MDN ساختید , و شما می توانید فورا جهت ویرایش صفحات اقدام کنید !</p> + +<p dir="rtl">اگر می خواهید پروفایل عمومی خود را ببینید , می توانید روی اسم خود بالای هر صفحه ای از MDN کلیک کنید . از آنجا شما می توانید روی <strong>Edit</strong> کلیک کنید تا تغییراتی روی پروفایل خود اعمال کنید .</p> + +<div class="note"> +<p dir="rtl"><strong>پای نوشت : نام های کاربری جدید نمی توانند شما فاصله ( Space ) یا کارکتر اتساین ( @ ) شنود . به یاد داشته باشید که نام کاربری شما جهت شناسایی کارهایی که شما انجام داده اید , به صورت عمومی , استفاده خواهد شد .</strong></p> +</div> + +<p> </p> |