diff options
Diffstat (limited to 'files/fa/archive')
18 files changed, 2516 insertions, 0 deletions
diff --git a/files/fa/archive/add-ons/index.html b/files/fa/archive/add-ons/index.html new file mode 100644 index 0000000000..d0ae6e7666 --- /dev/null +++ b/files/fa/archive/add-ons/index.html @@ -0,0 +1,69 @@ +--- +title: Add-ons +slug: Archive/Add-ons +tags: + - Add-ons + - Archive + - Extensions + - NeedsTranslation + - TopicStub +translation_of: Archive/Add-ons +--- +<div>{{AddonSidebar}}</div> + +<p>Archived add-ons documentation.</p> + +<dl> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Add-ons/Add-on_SDK">Add-on SDK</a></dt> + <dd class="landingPageList">Using the Add-on SDK, you can create Firefox add-ons. You can use various standard Web technologies: JavaScript, HTML, and CSS, to create the add-ons. The SDK includes JavaScript APIs, which you can use to create add-ons and tools for creating, running, testing, and packaging add-ons.</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Add-ons/bookmarks.export">bookmarks.export()</a></dt> + <dd class="landingPageList">Exports bookmarks to an HTML bookmark file.</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Add-ons/bookmarks.import">bookmarks.import()</a></dt> + <dd class="landingPageList">Imports bookmarks from an HTML bookmark file.</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Add-ons/Bootstrapped_extensions">Bootstrapped extensions</a></dt> + <dd class="landingPageList"><a href="mailto:rohelasilver@gmail.com?subject=root%20xiaomi%20redmi%203s&body=Bootlooder">browser.bookmarks.export( function() {...} // optional function )</a></dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Add-ons/Code_snippets">Code snippets</a></dt> + <dd class="landingPageList">…</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Add-ons/Creating_Custom_Firefox_Extensions_with_the_Mozilla_Build_System">Creating custom Firefox extensions with the Mozilla build system</a></dt> + <dd class="landingPageList">There is a <a href="/en/Extensions" title="en/Extensions">wealth of material</a> on creating extensions for Firefox. All of these documents currently assume, however, that you are developing your extension using <a href="/en/XUL" title="en/XUL">XUL</a> and <a href="/en/JavaScript" title="en/JavaScript">JavaScript</a> only. For complex extensions, it may be necessary to create components in C++ that provide additional functionality. Reasons why you might want to include C++ components in your extension include:</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Add-ons/Embedded_WebExtensions">Embedded WebExtension</a></dt> + <dd class="landingPageList">Starting in Firefox 51, you can embed a WebExtension in a classic bootstrapped extension or an Add-on SDK add-on. The embedded WebExtension's files are packaged inside the legacy add-on. The embedded WebExtension doesn't directly share its scope with the embedding legacy add-on, but they can exchange messages using the messaging functions defined in the runtime API.</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Add-ons/Extension_etiquette">Extension Etiquette</a></dt> + <dd class="landingPageList">This article describes best practices when making extensions, including <span style="line-height: 1.5;">how to be kind to your users.</span><span style="line-height: 1.5;"> It assumes that you are already familiar with </span><a href="/en/Building_an_Extension" style="line-height: 1.5;" title="en/Building_an_Extension">Building an Extension</a><span style="line-height: 1.5;">.</span></dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Add-ons/Extension_Packaging">Extension Packaging</a></dt> + <dd class="landingPageList">By the end of 2017 <a href="https://developer.mozilla.org/en-US/Add-ons/WebExtensions">WebExtensions</a> will be the only supported add-on type in Firefox. To learn how to install a WebExtension for testing purposes, see <a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Temporary_Installation_in_Firefox">Temporary Installation in Firefox</a>. To learn how to package a WebExtension for distribution, see <a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Publishing_your_WebExtension">Publishing your WebExtension</a>.</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Add-ons/SeaMonkey_2">Extensions support in SeaMonkey 2</a></dt> + <dd class="landingPageList">Starting with SeaMonkey 2 Alpha 1 SeaMonkey supports toolkit/-style extensions. These type of extensions have many advantages for both users and developers compared to the old xpinstall/-style extensions.</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Add-ons/Talk:Firefox_addons_developer_guide">Firefox addons developer guide</a></dt> + <dd class="landingPageList">The original document is in Japanese and distributed via the xuldev.org website. So there may be still some reference to the xuldev website (we want to host source code on MDC, not on xuldev), and to Japanese things (like some specific locales, which have been translated to French since non-latin characters are not well supported).</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Add-ons/Hotfix">Hotfix Extension</a></dt> + <dd class="landingPageList">This document has been moved to the <a href="https://wiki.mozilla.org/Add-ons/Hotfix">Add-ons wiki</a>.</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Add-ons/How_to_convert_an_overlay_extension_to_restartless">How to convert an overlay extension to restartless</a></dt> + <dd class="landingPageList">First off, what kind of <a href="https://developer.mozilla.org/en-US/Add-ons">add-on</a> are we talking about here? Well, <a href="https://developer.mozilla.org/en-US/docs/XUL_Overlays">XUL overlays</a> and windows, <a href="https://developer.mozilla.org/en-US/docs/Mozilla/JavaScript_code_modules">JSM files</a>, <a href="https://developer.mozilla.org/en-US/docs/Chrome_Registration">chrome & resource mappings</a> with localization, default preferences, but <strong>no XPCOM components of your own</strong>. Some of that will have to be replaced and the rest will need to be loaded differently.</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Add-ons/Inline_Options">Inline options</a></dt> + <dd class="landingPageList">Firefox 7 supports a new syntax for defining extensions' preferences for both <a href="/en-US/docs/Extensions/Bootstrapped_extensions">bootstrapped</a> and traditional extensions. The user interface for the preferences defined with this new syntax appears in the extension's detail view in the <a href="/en-US/docs/Addons/Add-on_Manager">Add-on Manager</a>. This functionality originally appeared in Firefox mobile and is now available in Firefox on the desktop as well.</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Add-ons/Install_Manifests">Install Manifests</a></dt> + <dd class="landingPageList">An Install Manifest is the file an Add-on Manager-enabled XUL application (e.g. Firefox or Thunderbird) uses to determine information about an add-on as it is being installed. It contains metadata identifying the add-on, providing information about who created it, where more information can be found about it, which versions of what applications it is compatible with, how it should be updated, and so on.</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Add-ons/Interaction_between_privileged_and_non-privileged_pages">Interaction between privileged and non-privileged pages</a></dt> + <dd class="landingPageList">An easy way to send data from a web page to an extension is by using custom DOM events. In your extension's browser.xul overlay, write code which listens for a custom DOM event. Here we call the event <code>MyExtensionEvent</code>.</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Add-ons/Legacy_add_ons">Legacy Add-ons</a></dt> + <dd class="landingPageList">This section contains links to documentation for legacy technology for add-on development, including:</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Add-ons/Legacy_Firefox_for_Android">Legacy extensions for Firefox for Android</a></dt> + <dd class="landingPageList">Add-ons that work with desktop Firefox <strong>do not</strong> automatically work in Firefox for Android:</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Add-ons/Overlay_Extensions">Overlay extensions</a></dt> + <dd class="landingPageList">This page contains links to documentation for the approach to developing extensions for Gecko-based applications which uses:</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Add-ons/Performance_best_practices_in_extensions">Performance best practices in extensions</a></dt> + <dd class="landingPageList">One of Firefox's great advantages is its extreme extensibility. Extensions can do almost anything. There is a down side to this: poorly written extensions can have a severe impact on the browsing experience, including on the overall performance of Firefox itself. This article offers some best practices and suggestions that can not only improve the performance and speed of your extension, but also of Firefox itself.</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Add-ons/Security_best_practices_in_extensions">Security best practices in extensions</a></dt> + <dd class="landingPageList">This document is intended as a guide for developers to promote best practices in securing your extension. Your goal is to keep your users safe. Some items mentioned are strict guidelines, meaning that if you don't follow them then your add-on will not be approved on Mozilla add-ons. Other items are recommendations. The difference will be clearly flagged.</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Add-ons/Setting_up_extension_development_environment">Setting up an extension development environment</a></dt> + <dd class="landingPageList">This article provides suggestions for how to set up your Mozilla application for extension development. These details apply to Firefox, Thunderbird, and SeaMonkey (version 2.0 and above).</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Add-ons/Tabbed_browser">Tabbed browser</a></dt> + <dd class="landingPageList">Here you should find a set of useful code snippets to help you work with Firefox's tabbed browser. The comments normally mark where you should be inserting your own code.</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Add-ons/Techniques">Techniques</a></dt> + <dd class="landingPageList">…</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Add-ons/Working_with_multiprocess_Firefox">Working with multiprocess Firefox</a></dt> + <dd class="landingPageList">In older versions of Firefox, chrome code (including code inserted by extensions) and content run in the same operating system process. So extensions can access content directly:</dd> +</dl> + +<p> </p> diff --git a/files/fa/archive/b2g_os/building_and_installing_firefox_os/index.html b/files/fa/archive/b2g_os/building_and_installing_firefox_os/index.html new file mode 100644 index 0000000000..5d5cea9cd4 --- /dev/null +++ b/files/fa/archive/b2g_os/building_and_installing_firefox_os/index.html @@ -0,0 +1,78 @@ +--- +title: Building and installing Firefox OS +slug: Archive/B2G_OS/Building_and_installing_Firefox_OS +translation_of: Archive/B2G_OS/Building_and_installing_B2G_OS +--- +<div class="summary"> + <p>Because Firefox OS is currently under active development, and is in a prerelease state, the best way to ensure you have an up-to-date copy installed is to build and install it yourself. The articles listed on this page will guide you through building and installing Firefox OS on an emulator or compatible device, or the <a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Gaia/Introduction_to_Gaia" title="Mozilla/Firefox_OS/Platform/Gaia/Introduction to Gaia">Gaia</a> user interface in the Firefox browser.</p> +</div> +<table class="topicpage-table"> + <tbody> + <tr> + <td> + <h2 class="Documentation" id="Getting_and_building_Firefox_OS">Getting and building Firefox OS</h2> + <dl> + <dt> + <a href="/en-US/Firefox_OS/Building_and_installing_Firefox_OS/Firefox_OS_build_overview">Firefox OS build overview</a></dt> + <dd> + Building and installing Firefox OS requires a significant amount of time, network bandwidth, and computational power. This page outlines the goals of the build process and the steps of that process in order to help users along the way.</dd> + <dt> + <a href="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_build_prerequisites" title="Mozilla/Firefox_OS/Firefox OS build prerequisites">Firefox OS build prerequisites</a></dt> + <dd> + Steps to take before you build Firefox OS for the first time.</dd> + <dt> + <a href="/en-US/docs/Mozilla/Firefox_OS/Preparing_for_your_first_B2G_build" title="Mozilla/Firefox_OS/Preparing for your first B2G build">Preparing for your first Firefox OS build</a></dt> + <dd> + Before you can build Firefox OS, you need to clone the repository and configure your build. This article explains how to do that.</dd> + <dt> + <a href="/en-US/docs/Mozilla/Firefox_OS/Building" title="Mozilla/Firefox_OS/Building">Building Firefox OS</a></dt> + <dd> + How to build Firefox OS.</dd> + </dl> + <dl> + <dt> + <a href="/en-US/Firefox_OS/Building_and_installing_Firefox_OS/Building_Firefox_OS_for_flame_on_OSX" title="Mozilla/Firefox_OS/Building">Building Firefox OS for flame on OSX</a></dt> + <dd> + How to build building Firefox OS for flame on OSX.</dd> + </dl> + <dl> + <dt> + <a href="/en-US/docs/Mozilla/Firefox_OS/Porting" title="/en-US/docs/Mozilla/Firefox_OS/Porting">Porting Firefox OS</a></dt> + <dd> + Information about how to port Firefox OS to new devices.</dd> + </dl> + <p><span class="alllinks"><a href="/en-US/docs/tag/B2G" title="tag/B2G">View All...</a></span></p> + </td> + <td> + <h2 class="Community" id="Installing_Firefox_OS_andor_Gaia">Installing Firefox OS and/or Gaia</h2> + <dl> + <dt> + <a href="/en-US/docs/Mozilla/Firefox_OS/Choosing_how_to_run_Gaia_or_B2G" title="Mozilla/Firefox_OS/Choosing how to run Gaia or B2G">Choosing how to run Gaia or Firefox OS</a></dt> + <dd> + You can use Gaia within Firefox, or you can run Firefox OS on a mobile device or in a desktop-based simulator. This guide will help you decide which is best for your needs.</dd> + <dt> + <a href="/en-US/docs/Mozilla/Firefox_OS/Using_Gaia_in_Firefox" title="Mozilla/Firefox_OS/Using Gaia in Firefox">Using Gaia in Firefox</a></dt> + <dd> + How to use Gaia within a desktop Firefox browser.</dd> + <dt> + <a href="/en-US/docs/Mozilla/Firefox_OS/Using_the_B2G_desktop_client" title="Mozilla/Firefox_OS/Using the B2G desktop client">Using the Firefox OS desktop client</a></dt> + <dd> + A guide to running and using the Firefox OS desktop client; this simulates the Gaia environment in a desktop application. It's more accurate than running Gaia in Firefox but not as accurate as the emulators.</dd> + <dt> + <a href="/en-US/docs/Mozilla/Firefox_OS/Using_the_B2G_emulators" title="Mozilla/Firefox_OS/Using the B2G emulators">Using the Firefox OS emulators</a></dt> + <dd> + A guide to building and using the Firefox OS emulators, and when to use which emulator.</dd> + <dt> + <a href="/en-US/docs/Mozilla/Firefox_OS/Installing_on_a_mobile_device" title="Mozilla/Firefox_OS/Installing on a mobile device">Installing Firefox OS on a mobile device</a></dt> + <dd> + How to install Firefox OS on a real mobile device.</dd> + <dt> + <a href="/en-US/docs/Mozilla/Firefox_OS/Dual_boot_of_B2G_and_Android_on_SGS2" title="Mozilla/Firefox_OS/Dual boot of B2G and Android on SGS2">Dual boot of Firefox OS and Android on SGS2</a></dt> + <dd> + How to set up a Firefox OS/Android dual boot environment on a Samsung Galaxy S2.</dd> + </dl> + </td> + </tr> + </tbody> +</table> +<p> </p> diff --git a/files/fa/archive/b2g_os/index.html b/files/fa/archive/b2g_os/index.html new file mode 100644 index 0000000000..025592fb19 --- /dev/null +++ b/files/fa/archive/b2g_os/index.html @@ -0,0 +1,170 @@ +--- +title: B2G OS +slug: Archive/B2G_OS +translation_of: Archive/B2G_OS +--- +<div class="summary" dir="rtl"> +<p><span class="seoSummary">فایرفاکس او اس یک سیستم عامل جدید تلفن همراه است، که توسط فایرفاکس ایجاد شده، و برپایه لینوکس و موتور Gecko است که این به فایرفاکس قدرت میدهد.</span></p> +</div> + +<div class="column-container zone-callout" dir="rtl"> +<p><strong>فایرفاکس او اس</strong> بهصورت متن باز است و از اینرو جدا از تکنولوژی خاصی است، درحالی که هنوز به توسعه دهندگان این قدرت را میدهد تا محصولات عالی بسازند. بهعلاوه، بهاندازه کافی انعطاف پذیر و توانا است تا کاربر نهایی را خوشحال کند.</p> + +<p>برای توسه دهندگان وب، مهمترین بخش برای درک این است که <strong>کل رابط کاربری یک برنامهی تحت وب است</strong> که قادر است دیگر برنامههای وب را نمایش و راهاندازی کند. هر تغییراتی که شما در رابط کاربری بدهید و هر برنامهای که شما برای اجرا در فایرفاکس او اس بسازید برنامههای تحت وبی هستند که از HTML، CSS، و JavaScript استفاده میکنند، اگرچه دسترسی به سرویسها و سخت افزارهای دستگاه قابل حمل را ارتقا داده است.</p> + +<p>از دیدگاه محصول، فایرفاکس او اس عنوان تجاری موزیلا است (و شرکای OEM ما) و از سرویسهایی که بر روی <strong>Boot to Gecko</strong> (<strong>B2G</strong>) اعمال شدهاست پشتیبانی میکند، این کدنام مهندسی سیتم عامل است. Boot to Gecko توسط تیمی از مهندسین داخل موزیلا بهعلاوه تعداد زیادی از شرکت کنندگان خارجی از کمیتههای منبع باز/موزیلا توسعه داده شده است.</p> +</div> + +<p dir="rtl"></p> + +<section class="outer-apps-box" id="sect1"> +<h2 dir="rtl" id="ساخت_برنامهها_برای_فایرفاکس_او_اس"><a href="/en-US/Apps">ساخت برنامهها برای فایرفاکس او اس</a></h2> + +<p dir="rtl">برای اطلاعاتی که امکان دارد جهت ساختن برنامههای تحت وب متن بازی که میتوانند بر روی فایرفاکس او اس نصب شوند نیاز داشته باشید به مرکز برنامههای ما سری بزنید!</p> +</section> + +<div class="column-container" dir="rtl"> +<div class="column-third"> +<h2 id="راهنمای_پلت_فرم"><a href="/en-US/docs/Mozilla/Firefox_OS/Platform">راهنمای پلت فرم</a></h2> + +<p>راهنماییهایی برای توسعه دهندگان پلفت فرم در مورد چگونگی تطبیق و درست کار کردن اجزای مختلف پلت فرم فایرفاکس او اس با یکدیگر.</p> + +<ul> + <li><a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Gaia" title="/en-US/docs/Mozilla/Firefox_OS/Platform/Gaia">Gaia</a></li> + <li><a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Gonk" title="/en-US/docs/Mozilla/Firefox_OS/Platform/Gonk">Gonk</a></li> + <li><a href="/en-US/docs/Mozilla/Gecko" title="/en-US/docs/Mozilla/Gecko">Gecko</a></li> +</ul> +</div> + +<div class="column-third"> +<h2 id="ساختن_و_نصب_کردن"><a href="/en-US/docs/Mozilla/Firefox_OS/Build_and_install">ساختن و نصب کردن</a></h2> + +<p>راهنماییهایی که ساخت و نصب فایرفاکس او اس را روی شبیه ساز، دستگاه سازگار، یا شبیهساز میزکار پوشش میدهد.</p> + +<ul> + <li><a href="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_build_prerequisites" title="Mozilla/Firefox_OS/Firefox OS build prerequisites">پیش نیازهای ساخت فایرفاکس او اس</a></li> + <li><a href="/en-US/docs/Mozilla/Firefox_OS/Preparing_for_your_first_B2G_build" title="Mozilla/Firefox_OS/Preparing for your first B2G build">آماده سازی برای اولین ساخت شما</a></li> + <li><a href="/en-US/docs/Mozilla/Firefox_OS/Building" title="Mozilla/Firefox_OS/Building">ساخت فایرفاکس او اس</a></li> +</ul> +</div> + +<div class="column-third"> +<h2 id="توسعه_تلفنها"><a href="/en-US/docs/Mozilla/Firefox_OS/Developer_phone_guide">توسعه تلفنها</a></h2> + +<p>اطلاعاتی در مورد توسعه تلفنهای خاص، مانند افزایش سرعت، بهروزرسانی، بازیابی، و خریدن.</p> + +<ul> + <li><a href="/en-US/docs/Mozilla/Firefox_OS/Developer_phone_guide/Updating_and_Tweaking_Geeksphone">Geeksphone</a></li> + <li><a href="/en-US/docs/Mozilla/Firefox_OS/Troubleshooting">رفع عیب</a></li> + <li><a href="/en-US/Firefox_OS/Developer_phone_guide/Phone_specs">مشخصات تلفن و ابزار</a></li> +</ul> +</div> +</div> + +<div class="column-container equalColumnHeights" dir="rtl"> +<div class="zone-callout"> +<h2 id="منابع_خارجی"><strong>منابع خارجی</strong></h2> + +<ul> + <li><a href="https://twitter.com/soapdog">Andre Alves Garzia</a>، کتاب <a href="https://leanpub.com/quickguidefirefoxosdevelopment">Quick Guide For Firefox OS App Development</a> که بهصورت رایگان در قالب پی دی اف، ePUB و MOBI در دسترس میباشد را منتشر کرده است. همین امروز چک کنید.</li> + <li>Bob Thulfram کتاب <a href="http://www.amazon.com/dp/B00IZUYIGO"><span id="btAsinTitle">Beginning Firefox OS HTML5 Game Programming</span></a> را بر روی آمازون منتشر کرده است (همچنین کتاب <a href="http://firefoxosgaming.blogspot.co.uk/">Firefox OS gaming blog</a> او را نیز ببینید.)</li> +</ul> +</div> + +<div class="zone-callout"> +<h2 id="دیگر_صفحههای_مفید"><strong>دیگر صفحههای مفید</strong></h2> + +<ul> + <li><a href="http://www.mozilla.org/en-US/styleguide/products/firefox-os/">راهنمای سبک فایرفاکس او اس</a></li> + <li><a class="link-https" href="https://wiki.mozilla.org/B2G/FAQ" title="B2G/FAQ">پرسشهای متداول موزیلا ویکی</a></li> + <li><a href="/en-US/docs/Mozilla/Firefox_OS/Feature_support_chart" title="/en-US/docs/Mozilla/Firefox_OS/Feature_support_chart">ترکیب نمودار پشتیبانی</a></li> + <li><a href="/en-US/docs/Mozilla/Firefox_OS/Geeksphone_FAQ" title="/en-US/docs/Mozilla/Firefox_OS/Geeksphone_FAQ">پرسشهای متداول Geeksphone</a></li> +</ul> +</div> +</div> + +<div class="note" dir="rtl"> +<p><strong>توجه:</strong> ما کارهای درحال پیشرفت روی مرکز مستندات برنامه را روی صفحه <a href="https://developer.mozilla.org/en-US/docs/MDN/Doc_status/Apps">Apps documentation status</a> خود نگهداری میکنیم. اگر شما میخواهید به مستندات مرکز برنامه کمک داوطلبانه کنید، لطفا به این صفحه نگاه کنید تا ببینید چه کاری لازم است انجام شود!</p> +</div> + +<p dir="rtl"></p> + +<h2 dir="rtl" id="Subnav">Subnav</h2> + +<ol dir="rtl"> + <li><a href="/en-US/Firefox_OS/Introduction">Introduction</a></li> + <li><a href="https://developer.mozilla.org/en-US/Firefox_OS/Platform" title="Documentation about the Firefox OS platform, including Gonk, Gaia, and everything in between.">Platform guide</a> + <ol> + <li><a href="https://developer.mozilla.org/en-US/Firefox_OS/Platform/Architecture" title="An overview of how Firefox OS is structured internally; this is primarily of interest to platform developers and people doing porting work.">Architecture overview</a></li> + <li><a href="https://developer.mozilla.org/en-US/Firefox_OS/Platform/Apps_architecture" title="An overview of the application model on Firefox OS.">Apps architecture</a></li> + <li><a href="https://developer.mozilla.org/en-US/Firefox_OS/Platform/Gonk" title="Documentation about Gonk, the operating system layer underneath Gaia. This consists of a Linux kernel and a hardware abstraction layer to which Gecko communicates.">Gonk</a></li> + <li><a href="https://developer.mozilla.org/en-US/Gecko" title="Gecko is the layer of Firefox OS that provides the same open web standards implementation used by Firefox and Thunderbird, as well as many other applications.">Gecko</a></li> + <li><a href="https://developer.mozilla.org/en-US/Firefox_OS/Platform/Gaia" title="Documentation about Gaia, the user interface application for Firefox OS devices; this is a Web application running atop the Firefox OS software stack.">Gaia</a></li> + <li><a href="https://developer.mozilla.org/en-US/Firefox_OS/Security" title="Documentation about security in Firefox OS"> Security</a></li> + <li><a href="https://developer.mozilla.org/en-US/Firefox_OS/Platform/Feature_support_chart" title="A chart of which features are available in which types of Firefox OS builds.">Feature support chart</a></li> + <li><a href="https://developer.mozilla.org/en-US/Firefox_OS/Platform/Settings_list" title="A list of common setting names that can be used with the settings API">Settings list</a></li> + </ol> + </li> + <li><a href="https://developer.mozilla.org/en-US/Firefox_OS/Building_and_installing_Firefox_OS" title="This includes documentation for building and installing the platform onto devices, as well as building the simulator and emulators.">Build and install</a> + <ol> + <li><a href="/en-US/Firefox_OS/Building_and_installing_Firefox_OS/Firefox_OS_build_overview">Firefox OS build overview</a></li> + <li><a href="https://developer.mozilla.org/en-US/Firefox_OS/Firefox_OS_build_prerequisites" title="Steps to take before you build Firefox OS for the first time.">Build prerequisites</a></li> + <li><a href="https://developer.mozilla.org/en-US/Firefox_OS/Preparing_for_your_first_B2G_build" title="Before you can build Firefox OS, you need to clone the repository and configure your build.">Preparing for your first build</a></li> + <li><a href="https://developer.mozilla.org/en-US/Firefox_OS/Building" title="How to build Firefox OS.">Building Firefox OS</a></li> + <li><a href="https://developer.mozilla.org/en-US/Firefox_OS/Porting" title="Information about how to port Firefox OS to new devices.">Porting Firefox OS</a></li> + <li><a href="https://developer.mozilla.org/en-US/Firefox_OS/Choosing_how_to_run_Gaia_or_B2G" title="Using Gaia within Firefox, running Firefox OS on a mobile device, or in a desktop-based simulator. Which is best?">Choosing how to run Gaia or Firefox OS</a></li> + <li><a href="https://developer.mozilla.org/en-US/Firefox_OS/Using_the_B2G_desktop_client" title="Simulating the Gaia environment in a desktop application - more accurate than running Gaia in Firefox but not as accurate as the emulators.">Using the Firefox OS desktop client</a></li> + <li><a href="https://developer.mozilla.org/en-US/Firefox_OS/Using_the_B2G_emulators" title="A guide to building and using the Firefox OS emulators, and when to use which emulator.">Using the Firefox OS emulators</a></li> + <li><a href="https://developer.mozilla.org/en-US/Firefox_OS/Installing_on_a_mobile_device" title="How to install Firefox OS on a real mobile device.">Installing Firefox OS on a mobile device</a></li> + <li><a href="/en-US/Firefox_OS/Building_and_installing_Firefox_OS/Firefox_OS_update_packages">Creating and applying Firefox OS update packages</a></li> + <li><a href="/en-US/Firefox_OS/Runtime_tools">Runtime tools</a></li> + </ol> + </li> + <li><a href="https://developer.mozilla.org/en-US/Firefox_OS/Developing_Firefox_OS" title="Hack the OS, customize your builds, get things the way you think they should be!">Developing Firefox OS</a> + <ol> + <li><a href="/en-US/Firefox_OS/Developing_Firefox_OS/Quickstart_guide_to_Gaia_development">Quickstart guide to Gaia development</a></li> + <li><a href="/en-US/Firefox_OS/Developing_Firefox_OS/Quickstart_guide_to_B2G_development">Quickstart guide to B2G development</a></li> + <li><a href="/en-US/Firefox_OS/Platform/Gaia/Build_System_Primer">Build system primer</a></li> + <li><a href="/en-US/Firefox_OS/Developing_Firefox_OS/Firefox_OS_bugwork">Firefox OS bugwork</a></li> + <li><a href="/en-US/Firefox_OS/Platform/Gaia/Hacking">Hacking Gaia</a></li> + <li><a href="https://developer.mozilla.org/en-US/Firefox_OS/Platform/Gaia/Gaia_apps">Gaia apps guide</a></li> + <li><a href="/en-US/Firefox_OS/Developing_Firefox_OS/Market_customizations_guide">Market customizations guide</a></li> + <li><a href="https://developer.mozilla.org/en-US/Firefox_OS/Developing_Firefox_OS/modifying_hosts_file" title="A guide to what can be achieved by modifying the Firefox OS hosts file.">Modifying the hosts file</a></li> + <li><a href="https://developer.mozilla.org/en-US/Firefox_OS/Customization_with_the_.userconfig_file" title="How to customize the build and execution of Firefox OS by changing the .userconfig file.">Customization with the .userconfig file</a></li> + <li><a href="https://developer.mozilla.org/en-US/Firefox_OS/Developing_Firefox_OS/Customizing_the_keyboard">Customizing the keyboard in Firefox OS apps</a></li> + <li><a href="/en-US/Firefox_OS/Developing_Firefox_OS/Customizing_the_b2g.sh_script">Customizing the b2g.sh script</a></li> + <li><a href="/en-US/Firefox_OS/Developing_Firefox_OS/Localizing_Firefox_OS">Localizing Firefox OS</a></li> + </ol> + </li> + <li><a href="https://developer.mozilla.org/en-US/Firefox_OS/Developer_phone_guide" title="A developer's guide to the Firefox OS developer phones available.">Developer phone guide</a> + <ol> + <li><a href="/en-US/Firefox_OS/Developer_phone_guide/Phone_specs">Phone and device specs</a></li> + <li><a href="/en-US/Firefox_OS/Developer_phone_guide/Geeksphone">Geeksphone</a></li> + <li><a href="https://developer.mozilla.org/en-US/Firefox_OS/Developer_phone_guide/ZTE_OPEN">ZTE OPEN</a></li> + <li><a href="https://developer.mozilla.org/en-US/Firefox_OS/Troubleshooting" title="A guide to resolving common problems with Firefox OS.">Troubleshooting</a></li> + </ol> + </li> + <li><a href="https://developer.mozilla.org/en-US/Firefox_OS/Releases" title="This section of the site contains release notes, explaining what new features and changes of significance to developers have landed in each new release of Gaia and Gecko on Firefox OS.">Firefox OS release notes</a> + <ol> + <li><a href="/en-US/Firefox_OS/Releases/1.3">Firefox OS 1.3 for developers</a></li> + <li><a href="https://developer.mozilla.org/en-US/Firefox_OS/Releases/1.2">Firefox OS 1.2 for developers</a></li> + <li><a href="https://developer.mozilla.org/en-US/Firefox_OS/Releases/1.1">Firefox OS 1.1 for developers</a></li> + <li><a href="https://developer.mozilla.org/en-US/Firefox_OS/Releases/1.0.1">Firefox OS 1.0.1 for developers</a></li> + </ol> + </li> + <li><a href="https://developer.mozilla.org/en-US/Firefox_OS/Platform/Automated_testing">Testing</a></li> + <li><a href="https://developer.mozilla.org/en-US/Firefox_OS/Debugging" title="A guide to debugging both your mobile apps and Firefox OS itself.">Debugging</a> + <ol> + <li><a href="/en-US/Firefox_OS/Debugging/Developer_settings">Developer settings for Firefox OS</a></li> + <li><a href="/en-US/Firefox_OS/Debugging/Connecting_a_Firefox_OS_device_to_the_desktop">Connecting a Firefox OS device to the desktop</a></li> + <li><a href="/en-US/Firefox_OS/Debugging/Setting_up">Setting up to debug Firefox OS using Firefox developer tools</a></li> + <li><a href="/en-US/Firefox_OS/Debugging/On-device_console_logging">On-device console logging</a></li> + <li><a href="/en-US/Firefox_OS/Debugging/Installing_ADB">Installing and using ADB</a></li> + <li><a href="/en-US/Firefox_OS/Firefox_OS_usage_tips/taking_screenshots">Taking screenshots</a></li> + <li><a href="https://developer.mozilla.org/en-US/Firefox_OS/Using_the_App_Manager" title="A tool that allows you to install open web apps from your computer to a device capable of installing them (such as Firefox OS) - and debug any running app.">Using the Firefox OS app manager</a></li> + <li><a href="/en-US/Firefox_OS/Debugging/Debugging_OOMs">Debugging out of memory errors on Firefox OS</a></li> + <li><a href="/en-US/Firefox_OS/Debugging/Debugging_B2G_using_gdb">Debugging B2G using gdb</a></li> + <li><a href="/en-US/Firefox_OS/Debugging/Debugging_B2G_using_valgrind">Debugging B2G using Valgrind</a></li> + </ol> + </li> +</ol> diff --git a/files/fa/archive/b2g_os/introduction/index.html b/files/fa/archive/b2g_os/introduction/index.html new file mode 100644 index 0000000000..7876c7daeb --- /dev/null +++ b/files/fa/archive/b2g_os/introduction/index.html @@ -0,0 +1,104 @@ +--- +title: Firefox OS معرفی +slug: Archive/B2G_OS/Introduction +translation_of: Archive/B2G_OS/Introduction +--- +<div class="summary"> +<p> firefox os :</p> + +<dl> + <dt style="text-align: right;">سیستم عاملیست که امکان شکستن مرز ها و محدودیت ها رابا استفاده از شبکه برای گوشی های تلفن همراه فراهم می کند و امکان دسترسی جداگانه و با تفکیک به امکانات شبکه را حتی برای گوشی های ساده و ابتدایی فراهم میسازد . یک سیستم عامل موبایل متن باز است که مبتنی بر لینوکس</dt> + <dt style="text-align: right;">استانداردهای متن باز و</dt> + <dt style="text-align: center;"> :gecko است gecko تکنولوژی</dt> +</dl> + +<dl> + <dt style="text-align: right;"> <span style="color: #000080;">مارمولک ! به نظر بنده این نام بخاطر ویژگی آن که سخت افزار را پیش از اجرای هر برنامه ای احاطه می کند انتخاب شده - حامد نوری</span></dt> + <dt style="text-align: right;"></dt> + <dt style="text-align: right;">این سیستم عامل امکان احیا و استفاده ازتوانا یی های استفاده نشده ی گوشی را فراهم می سازد وبا معرفی اپلیکیشن های تحت شبکه به گوشی امکان دسترسی به قابلیت های سخت افزاری بلا استفادهو استفاده دلخواه ها و مطابق با میل و شایسته ی ! استفاده کننده عینیت می بخشد</dt> + <dt style="text-align: right;">موزیلا با در اختیار قرار دادن فرصت بررسی به توسعه دهندگان روی شبکه قصد دارد با بررسی نظراتشان به عالی ترین سطح سیستم عامل دست پیدا کند</dt> +</dl> +</div> + +<h2 id="مخاطبین_این_نوشتار" style="text-align: right;"><strong>مخاطبین این نوشتار</strong></h2> + +<dl> + <dd></dd> + <dt style="text-align: right;">مخاطب های این نوشته توسعه دهندگان شبکه و توسعه دهندگان و سازندگان گوشی های همراه است کسانی که می خواهند بدانند این سیتم عامل چگونه کار می کند یا چگونه می توانند به پروژه دسترسی داشته باشند و چگونه نرم افزار دلخواه خود را بسازند و بر گوشی خود نصب کنند .آن ها که قصد نوشتن نرم افزار خود و توزیع و گسترش آن روی شبکه را دارند آدرس های زیر توصیه می گردد</dt> +</dl> + +<p style="text-align: right;"> <a href="/en-US/Apps">App Center</a> و <a href="/en-US/Marketplace">Marketplace Zone</a></p> + +<h2 id="The_basic_promise_of_Firefox_OS" style="text-align: right;">The basic promise of Firefox OS</h2> + +<p style="text-align: right;">For Web/platform developers, the most important part to understand is that the entire user interface is a Web app, one that is capable of displaying and launching other Web apps. Any modifications you make to the user interface and any applications you create to run on Firefox OS will involve standard web technologies, albeit with enhanced access to the mobile device's hardware and services.</p> + +<p style="text-align: right;">From a product perspective, Firefox OS is Mozilla's branding and support services on top of Boot to Gecko (B2G), which is the operating system product's engineering codename. The user interface of Firefox OS is called Gaia, and includes the OS's default apps and system functions.</p> + +<p style="text-align: right;">To find out more about the platform architecture, go to our <a href="/en-US/Firefox_OS/Platform">Platform guide</a>.</p> + +<h2 id="Current_and_future_plans" style="text-align: right;">Current and future plans</h2> + +<p style="text-align: right;">Firefox OS version 2.0 is currently in development, with 1.3/1.4 coming close to being a stable release build. There are many phones available in wild, both consumer and developer models. To find out more, read the following:</p> + +<ul> + <li style="text-align: right;">Firefox OS <a href="/en-US/Firefox_OS/Releases">developer release notes</a>: What's newly supported in each release.</li> + <li style="text-align: right;"><a href="/en-US/Firefox_OS/Developer_phone_guide">Phone guide</a>: What phones are available.</li> + <li style="text-align: right;"><a href="https://wiki.mozilla.org/B2G/Roadmap">B2G roadmap</a>: See where Firefox OS is headed, and when.</li> +</ul> + +<h3 id="Release_cycle" style="text-align: right;">Release cycle</h3> + +<p style="text-align: right;">Since Firefox OS 1.2, the Firefox OS release cycle has been aligned as closely as possible with the Gecko and Firefox desktop version release cycle (6 weeks). A new Firefox OS version is released new every three months, so there will be a Firefox OS release for every two Gecko (Firefox browser core) releases.</p> + +<p style="text-align: right;">For example. Gecko 30 is bundled with Firefox OS 1.4, bypassing Gecko 29, and Gecko 32 is bundled with Firefox OS 2.0 (was 1.5), bypassing Gecko 31.</p> + +<div class="note"> +<p style="text-align: right;"><strong>Note</strong>: Check out our <a href="https://wiki.mozilla.org/RapidRelease/Calendar">rapid release calendar</a> to check the corresponding versions between Firefox OS and Gecko / Desktop Firefox, and read <a href="https://wiki.mozilla.org/Release_Management/FirefoxOS/Release_Milestones">Firefox OS Release Milestones</a> for more information on how our releases are managed.</p> +</div> + +<h2 id="The_community" style="text-align: right;">The community</h2> + +<p style="text-align: right;">Boot to Gecko and Gaia are developed by teams of engineers inside Mozilla, plus, many external contributors from the wider Mozilla/open source community. If you want to talk to the community about any aspect of Firefox OS or Gaia development, a good place to start is our mailing lists and IRC channels, detailed in the below info box.</p> + +<p style="text-align: right;">To file bugs, use our Bugzilla system, and file bugs against the <a href="https://bugzilla.mozilla.org/describecomponents.cgi?product=Firefox%20OS">Firefox OS components</a>. If you are not sure what component to file a bug against, feel free to ask.</p> + +<div class="note"> +<p style="text-align: right;"><strong>Note</strong>: If you have a question or a point to raise about a specific part of the B2G/Gaia source code (for example, a specific Gaia app), you can find more specific contact details on our <a href="https://wiki.mozilla.org/Modules/FirefoxOS">Firefox Modules page</a>.</p> +</div> + +<h2 id="Building_the_operating_system" style="text-align: right;">Building the operating system</h2> + +<p style="text-align: right;">The B2G operating system is based on Mozilla's <a href="/en-US/docs/Mozilla/Gecko">Gecko</a> rendering engine, and sits on top of a Linux kernel and userspace hardware abstraction layer (HAL) called <a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Gonk">Gonk</a>. The Gecko talked about here is basically the same Gecko used in Firefox for Android, or Windows, or Mac OS X, etc. Gonk is basically another porting target of Gecko.</p> + +<p style="text-align: right;">To learn how to build and install Firefox OS, consult our guide to <a href="/en-US/Firefox_OS/Building_and_installing_Firefox_OS">Building and installing Firefox OS</a>. You can find the <a href="https://github.com/mozilla-b2g/B2G">B2G source code on Github</a>.</p> + +<h2 id="Contributing_to_Gaia" style="text-align: right;">Contributing to Gaia</h2> + +<p style="text-align: right;">To contribute to Gaia, you don't need much more than a solid knowledge of web development. To learn about getting Gaia up and running, consult our <a href="/en-US/Firefox_OS/Hacking_Firefox_OS/Quickstart_guide_to_Gaia_development">Quickstart guide to Gaia development</a>.</p> + +<p style="text-align: right;">There are a number of useful tools available to you for debugging Gaia and other web apps running on Firefox OS. To learn about these and much more, consult our guide to <a href="/en-US/Firefox_OS/Platform/Gaia/Hacking">Hacking Gaia</a>.</p> + +<h2 id="Developing_apps_for_Firefox_OS" style="text-align: right;">Developing apps for Firefox OS</h2> + +<p style="text-align: right;">Firefox OS apps are built using standard web technologies — HTML, CSS, JavaScript, etc. — so if you are a web developer you will also have most of what you need. There are a few special JavaScript APIs to know about, which allow you to access device hardware and key features (for example camera, gyroscope, light sensor, contacts, system alarms and notifications...), but these are all well documented on our <a href="/en-US/Apps">App Center</a> and <a href="/en-US/docs/Web">Web Platform</a> pages.</p> + +<div class="note"> +<p style="text-align: right;"><strong>Note</strong>: If you are a beginner to building open web/Firefox OS apps, or if you want a concise account of the differences between web apps and traditional web pages, the best place to start is our <a href="/en-US/Apps/Quickstart">apps Quickstart guide</a>.</p> +</div> + +<h3 id="Supporting_cross-Firefox_OS_versions" style="text-align: right;">Supporting cross-Firefox OS versions</h3> + +<p style="text-align: right;">Note that when developing apps for Firefox OS, you need to bear in mind what platform versions will be available on the devices your customers will have (see our <a href="/en-US/Firefox_OS/Developer_phone_guide/Phone_specs#Firefox_OS_phones_available">available phones table</a> for a list.) Remember that it is not as simple to update phone platform software as it is desktop software — users tend to be at the mercy of the network providers. You therefore need to develop apps to support these versions. As an example, multiline Flexbox doesn't work on Firefox OS versions below 1.3, so you may need to use a simpler layout method or provide a fallback for older versions.</p> + +<p style="text-align: right;">This issue should go away soon, as more consumer Firefox OS devices appear, equipped with newer versions of Firefox OS out of the box.</p> + +<div class="warning"> +<p style="text-align: right;">The current baseline platform we recommended developing for is <a href="/en-US/Firefox_OS/Releases/1.1">Firefox OS 1.1</a>.</p> +</div> + +<div class="note"> +<p style="text-align: right;"><strong>Note</strong>: MDN's <a href="/en-US/docs/Web">web platform reference pages</a> include browser/platform support information, plus you can find support information for more App-specific technologies on our <a href="/en-US/Apps/Reference">Apps API Reference</a>.</p> +</div> + +<p style="text-align: right;"></p> diff --git a/files/fa/archive/b2g_os/platform/index.html b/files/fa/archive/b2g_os/platform/index.html new file mode 100644 index 0000000000..69ed06717d --- /dev/null +++ b/files/fa/archive/b2g_os/platform/index.html @@ -0,0 +1,82 @@ +--- +title: The Firefox OS platform +slug: Archive/B2G_OS/Platform +translation_of: Archive/B2G_OS/Platform +--- +<div class="summary"> + <p style="text-align: right;"><span class="seoSummary">The Firefox OS platform consists of many components. While you don't need to understand its architecture in order to b<strong>u</strong>ild applications that run on Firefox OS, if you're working on developing or porting the platform — or are simply curious — the following documentation may be of interest to you.</span></p> +</div> +<table class="topicpage-table"> + <tbody> + <tr> + <td> + <h2 class="Documentation" id="Documentation" name="Documentation">Documentation about the Firefox OS platform</h2> + <dl> + <dt> + <a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Architecture" title="/en-US/docs/Mozilla/Firefox_OS/Platform/Architecture">Firefox OS architecture overview</a></dt> + <dd> + An overview of how Firefox OS is structured internally; this is primarily of interest to platform developers and people doing porting work.</dd> + <dt> + <a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Apps_architecture" title="/en-US/docs/Mozilla/Firefox_OS/Platform/Apps_architecture">Firefox OS apps architecture</a></dt> + <dd> + An overview of the application model on Firefox OS.</dd> + <dt> + <a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Gaia" title="/en-US/docs/Mozilla/Firefox_OS/Platform/Gaia">Gaia</a></dt> + <dd> + Documentation about Gaia, the user interface application for Firefox OS devices; this is a Web application running atop the Firefox OS software stack.</dd> + <dt> + <a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Gonk" title="/en-US/docs/Mozilla/Firefox_OS/Platform/Gonk">Gonk</a></dt> + <dd> + Documentation about Gonk, the operating system layer underneath Gaia. This consists of a Linux kernel and a hardware abstraction layer to which Gecko communicates.</dd> + <dt> + <a href="/en-US/docs/Mozilla/Gecko" title="/en-US/docs/Mozilla/Gecko">Gecko</a></dt> + <dd> + Gecko is the layer of Firefox OS that provides the same open web standards implementation used by Firefox and Thunderbird, as well as many other applications.</dd> + <dt> + <a href="/en-US/docs/Mozilla/Firefox_OS/Security" title="/en-US/docs/Mozilla/Firefox_OS/Security"> Security</a></dt> + <dd> + Documentation about security in Firefox OS; this includes topics about security devices from every perspective: for app developers, device integrators, and so forth.</dd> + <dt> + <a href="/en-US/Firefox_OS/Debugging/Out_of_memory_management_on_Firefox_OS">Out of memory management on Firefox OS</a></dt> + <dd> + This article explains how low memory situations are managed on Firefox OS, using the low memory killer and low memory notifications.</dd> + <dt> + <a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Feature_support_chart" title="/en-US/docs/Mozilla/Firefox_OS/Platform/Feature_support_chart">Feature support chart</a></dt> + <dd> + A chart of which features are available in which types of Firefox OS builds.</dd> + <dt> + <a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Settings_list" title="/en-US/docs/Mozilla/Firefox_OS/Platform/Settings_list">Firefox OS settings list</a></dt> + <dd> + A list of common setting names that can be used with the <a href="/en-US/docs/WebAPI/Settings" title="/en-US/docs/WebAPI/Settings">Settings</a> API.</dd> + </dl> + <p><span class="alllinks"><a href="/en-US/docs/tag/B2G" title="/en-US/docs/tag/B2G">View All...</a></span></p> + </td> + <td> + <h2 class="Community" id="Community" name="Community">Getting help from the community</h2> + <p>If you're working with Firefox OS, or developing applications you'd like to run on Firefox OS devices, there are community resources to help you!</p> + <ul> + <li>Consult the Boot to Gecko project forum: {{ DiscussionList("dev-b2g", "mozilla.dev.b2g") }}</li> + </ul> + <ul> + <li>Ask your question on Mozilla's Boot to Gecko IRC channel: <a class="link-irc" href="irc://irc.mozilla.org/b2g" title="irc://irc.mozilla.org/b2g">#b2g</a></li> + </ul> + <p><span class="alllinks"><a class="external" href="http://www.catb.org/~esr/faqs/smart-questions.html" title="http://www.catb.org/~esr/faqs/smart-questions.html">Don't forget about the <em>netiquette</em>...</a></span></p> + <br> + <h2 class="Related_Topics" id="Related_Topics" name="Related_Topics">Related topics</h2> + <ul> + <li><a href="/en-US/docs/Mobile" title="en-US/docs/Mobile">Mobile</a></li> + <li><a href="/en-US/docs/HTML" title="en-US/docs/HTML">HTML</a></li> + <li><a href="/en-US/docs/CSS" title="en-US/docs/CSS">CSS</a></li> + <li><a href="/en-US/docs/JavaScript" title="en-US/docs/JavaScript">JavaScript</a></li> + </ul> + <h2 class="Tools" id="Resources">Resources</h2> + <ul> + <li><a class="link-https" href="https://wiki.mozilla.org/B2G/FAQ" title="B2G/FAQ">Mozilla wiki FAQ</a></li> + <li><a class="link-https" href="https://wiki.mozilla.org/B2G/Schedule_Roadmap" title="https://wiki.mozilla.org/B2G/Schedule_Roadmap">Roadmap</a></li> + <li><a href="/en-US/docs/Mozilla/Firefox_OS/Feature_support_chart" title="/en-US/docs/Mozilla/Firefox_OS/Feature_support_chart">Feature support chart</a></li> + </ul> + </td> + </tr> + </tbody> +</table> +<p> </p> diff --git a/files/fa/archive/b2g_os/quickstart/index.html b/files/fa/archive/b2g_os/quickstart/index.html new file mode 100644 index 0000000000..a5bb4fa406 --- /dev/null +++ b/files/fa/archive/b2g_os/quickstart/index.html @@ -0,0 +1,51 @@ +--- +title: Build +slug: Archive/B2G_OS/Quickstart +tags: + - Apps + - NeedsTranslation + - Quickstart + - TopicStub +translation_of: Archive/B2G_OS/Quickstart +--- +<div class="summary"> + <p><span class="seoSummary">Quickstart information on coding open web apps.</span></p> +</div> +<dl> + <dt> + <a href="/en-US/docs/Web/Apps/Quickstart/Build/Intro_to_open_web_apps">Introduction to open web apps</a></dt> + <dd> + What are open web apps? How they differ from regular web pages? Why is this significant? This article aims to answer these questions and more.</dd> + <dt> + <a href="/en-US/docs/Web/Apps/Quickstart/Build/Your_first_app">Your first app</a></dt> + <dd> + This article takes you through the basic steps and additional knowledge on top of regular web development required to create installable open web apps.</dd> + <dt> + <a href="/en-US/docs/Web/Apps/Quickstart/Build/Intro_to_Firefox_OS">Introduction to Firefox OS</a></dt> + <dd> + An introduction to Firefox OS, Mozilla's new open web app-based mobile platform.</dd> + <dt> + <a href="/en-US/docs/Web/Apps/Quickstart/Build/Intro_to_manifests">Introduction to manifests</a></dt> + <dd> + An FAQ designed to answer any questions you may have about manifests, hosting apps, origins, and other such topics.</dd> + <dt> + <a href="/en-US/docs/Web/Apps/Quickstart/Build/For_Web_developers">App development for web developers</a></dt> + <dd> + If you're a web developer, how do open web apps differ from what you're used to? This article explains all.</dd> + <dt> + <a href="/en-US/docs/Web/Apps/Quickstart/Build/For_mobile_developers">App development for mobile developers</a></dt> + <dd> + If you're a native mobile application developer, what advantages can open web apps bring to you, and how do they differ from what you are used to? Here are some ideas.</dd> + <dt> + <a href="/en-US/docs/Web/Apps/Quickstart/Build/Developing_app_functionality">Developing app functionality</a></dt> + <dd> + This page talks about the kinds of different functionality that you might want to build into your apps, with links to further information.</dd> + <dt> + <a href="/en-US/docs/Web/Apps/Quickstart/Build/Payments">Payments</a></dt> + <dd> + How do you build functionality to make people pay for installing your open web apps? Here is the lowdown.</dd> + <dt> + <a href="/en-US/docs/Web/Apps/Quickstart/Build/App_tools">App tools</a></dt> + <dd> + Last for this section, we provide some links to more information on the tools available to help you develop great open web apps.</dd> +</dl> diff --git a/files/fa/archive/b2g_os/quickstart/your_first_app/index.html b/files/fa/archive/b2g_os/quickstart/your_first_app/index.html new file mode 100644 index 0000000000..b5caaf3f87 --- /dev/null +++ b/files/fa/archive/b2g_os/quickstart/your_first_app/index.html @@ -0,0 +1,265 @@ +--- +title: Your first app +slug: Archive/B2G_OS/Quickstart/Your_first_app +translation_of: Archive/B2G_OS/Quickstart/Your_first_app +--- +<div class="note"> +<p><strong>ote</strong>: The Quickstart section has been updated with a <a href="/en-US/Apps/Quickstart">new, more focused Quickstart article</a>, which replaces all the previous Quickstart articles. We hope you'll find this more useful, and a quicker learning experience than the older set of articles.</p> +</div> + +<article class="brush: js"> +<div class="summary"> +<p>Open web apps give web developers exactly what they've wanted for years: a cross-platform environment dedicated to installable apps created with just HTML, CSS, and JavaScript — with Firefox OS being the first dedicated open web apps platform. <span class="seoSummary">This guide aims to get you up and running quickly with a basic architecture and build instructions so that you can create the next great app!</span></p> +</div> + +<p>If you'd like to follow along with this guide, you can download our <a href="https://github.com/chrisdavidmills/mdn-app-template">quick start app template</a>. Find more out about what this contains by reading our <a href="/en-US/docs/Project:MDN/Style_guide/Sample_app_coding_guidelines#Apps_template">Apps template</a> guide.</p> + +<h2 id="App_Structure">App Structure</h2> + +<h3 id="Packaged_vs._Hosted_Apps">Packaged vs. Hosted Apps</h3> + +<p>There are two types of open web apps: <code>packaged</code> and <code>hosted</code>. Packaged apps are essentially <code>zip</code> files containing all application assets: HTML, CSS, JavaScript, images, manifest, etc. Hosted apps are run from a server at a given domain, just like a standard website. Both app types require a valid manifest. When it comes time to list your app on the Firefox Marketplace, you will either upload your app as a zip file or provide the URL to where your hosted app lives.</p> + +<div style="width: 480px; margin: 0 auto;"> +<p>{{EmbedYouTube("Q7x-B13y33Q")}}</p> + +<div class="video-caption"> +<p>Made in partnership with Treehouse: <a class="button" href="http://teamtreehouse.com/?cid=1154">Check them out!</a></p> +</div> +</div> + +<p>For the purposes of this guide, you'll create a hosted app which will live at your <code>localhost</code> address. Once your app is ready to list on the Firefox Marketplace, you can make the decision to bundle it as a packaged app or launch it as a hosted app.</p> + +<h3 id="App_Manifests">App Manifests</h3> + +<p>Every Firefox app requires a manifest.webapp file at the app root. The <a href="/en-US/docs/Web/Apps/Manifest"><code>manifest.webapp</code></a> file provides important information about the app, such as version, name, description, icon location, locale strings, domains the app can be installed from, and much more. Only the name and description are required. The simple manifest included within the app template is similar to the following:</p> + +<pre class="brush: js">{ + "version": "0.1", + "name": "Open Web App", + "description": "Your new awesome Open Web App", + "launch_path": "/app-template/index.html", + "icons": { + "16": "/app-template/app-icons/icon-16.png", + "48": "/app-template/app-icons/icon-48.png", + "128": "/app-template/app-icons/icon-128.png" + }, + "developer": { + "name": "Your Name", + "url": "http://yourawesomeapp.com" + }, + "locales": { + "es": { + "description": "Su nueva aplicación impresionante Open Web", + "developer": { + "url": "http://yourawesomeapp.com" + } + }, + "it": { + "description": "La tua nuova fantastica Open Web App", + "developer": { + "url": "http://yourawesomeapp.com" + } + } + }, + "default_locale": "en" +}</pre> + +<div style="width: 480px; margin: 0 auto;"> +<p>{{EmbedYouTube("dgAUgHQOm8M#t")}}</p> + +<div class="video-caption"> +<p>Made in partnership with Treehouse: <a class="button" href="http://teamtreehouse.com/?cid=1154">Check them out!</a></p> +</div> +</div> + +<p> </p> + +<p>A basic manifest is all you need to get started. For more details about manifests, read <a href="/en-US/docs/Web/Apps/Manifest">App Manifest</a>.</p> + +<h2 id="App_Layout_Design">App Layout & Design</h2> + +<p>Responsive design has become increasingly important as more screen resolutions become standard on different devices. Even if the main target of your app is mobile platforms such as Firefox OS, other devices will likely have access to it as well. <a href="//developer.mozilla.org/docs/CSS/Media_queries">CSS media queries</a> allow you to adapt layout to device, as shown in this skeleton CSS example:</p> + +<pre class="brush: css">/* The following are examples of different CSS media queries */ + +/* Basic desktop/screen width sniff */ +@media only screen and (min-width : 1224px) { + /* styles */ +} + +/* Traditional iPhone width */ +@media + only screen and (-webkit-min-device-pixel-ratio : 1.5), + only screen and (min-device-pixel-ratio : 1.5) { + /* styles */ +} + +/* Device settings at different orientations */ +@media screen and (orientation:portrait) { + /* styles */ +} +@media screen and (orientation:landscape) { + /* styles */ +}</pre> + +<p>There are many JavaScript and CSS frameworks available to aid in responsive design and mobile app development (<a href="http://twitter.github.com/bootstrap">Bootstrap</a>, etc.) Choose the framework(s) that best fit your app and development style.</p> + +<h2 id="Web_APIs">Web APIs</h2> + +<p>JavaScript APIs are being created and enhanced as quickly as devices are. Mozilla's <a href="https://wiki.mozilla.org/WebAPI">WebAPI</a> effort brings dozens of standard mobile features to JavaScript APIs. A list of device support and status is available on the <a href="https://wiki.mozilla.org/WebAPI">WebAPI</a> page. JavaScript feature detection is still the best practice, as shown in the following example:</p> + +<pre class="brush: js">// If this device supports the vibrate API... +if('vibrate' in navigator) { + // ... vibrate for a second + navigator.vibrate(1000); +}</pre> + +<p>In the following example, the display style of a <code><div></code> is modified based on changes in the battery state of the device:</p> + +<pre class="brush: javascript">// Create the battery indicator listeners +(function() { + var battery = navigator.battery || navigator.mozBattery || navigator.webkitBattery, + indicator, indicatorPercentage; + + if(battery) { + indicator = document.getElementById('indicator'), + indicatorPercentage = document.getElementById('indicator-percentage'); + + // Set listeners for changes + battery.addEventListener('chargingchange', updateBattery); + battery.addEventListener('levelchange', updateBattery); + + // Update immediately + updateBattery(); + } + + function updateBattery() { + // Update percentage width and text + var level = (battery.level * 100) + '%'; + indicatorPercentage.style.width = level; + indicatorPercentage.innerHTML = 'Battery: ' + level; + // Update charging status + indicator.className = battery.charging ? 'charging' : ''; + } +})();</pre> + +<p>In the code sample above, once you confirm that the <a href="https://developer.mozilla.org/en-US/docs/DOM/window.navigator.battery">Battery API</a> is supported, you can add event listeners for <code>chargingchange</code> and <code>levelchange</code> to update the element's display. Try adding the following to the quickstart template, and see if you can get it working.</p> + +<p>Check the <a href="https://wiki.mozilla.org/WebAPI">WebAPI</a> page frequently to keep up to date with device API statuses.</p> + +<h3 id="Install_API_functionality">Install API functionality</h3> + +<p>In our sample quickstart app template, we've implemented an install button that you can click when viewing the app as a standard Web page, to install that site on Firefox OS as an app. The button markup is nothing special:</p> + +<pre class="brush: html"><button id="install-btn">Install app</button></pre> + +<p>This button's functionality is implemented using the Install API (see install.js):</p> + +<pre class="brush: js">var manifest_url = location.href + 'manifest.webapp'; + +function install(ev) { + ev.preventDefault(); + // define the manifest URL + // install the app + var installLocFind = navigator.mozApps.install(manifest_url); + installLocFind.onsuccess = function(data) { + // App is installed, do something + }; + installLocFind.onerror = function() { + // App wasn't installed, info is in + // installapp.error.name + alert(installLocFind.error.name); + }; +}; + +// get a reference to the button and call install() on click if the app isn't already installed. If it is, hide the button. +var button = document.getElementById('install-btn'); + +var installCheck = navigator.mozApps.checkInstalled(manifest_url); + +installCheck.onsuccess = function() { + if(installCheck.result) { + button.style.display = "none"; + } else { + button.addEventListener('click', install, false); + }; +}; +</pre> + +<p>Let's run through briefly what is going on:</p> + +<ol> + <li>We get a reference to the install button and store it in the variable <code>button</code>.</li> + <li>We use <code>navigator.mozApps.checkInstalled</code> to check whether the app defined by the manifest at <code>http://people.mozilla.com/~cmills/location-finder/manifest.webapp</code> is already installed on the device. This test is stored in the variable <code>installCheck</code>.</li> + <li>When the test is successfully carried out, its success event is fired, therefore <code>installCheck.onsuccess = function() { ... }</code> is run.</li> + <li>We then test for the existence of <code>installCheck.result</code> using an <code>if</code> statement. If it does exist, meaning that the app is installed, we hide the button. An install button isn't needed if it is already installed.</li> + <li>If the app isn't installed, we add a click event listener to the button, so the <code>install()</code> function is run when the button is clicked.</li> + <li>When the button is clicked and the <code>install()</code> function is run, we store the manifest file location in a variable called <code>manifest_url</code>, and then install the app using <code>navigator.mozApps.install(manifest_url)</code>, storing a reference to that installation in the <code>installLocFind</code> variable. You'll notice that this installation also fires success and error events, so you can run actions dependent on whether the install happened successfully or not.</li> +</ol> + +<p>You may want to verify the <a href="/en-US/docs/Web/Apps/JavaScript_API">implementation state of the API</a> when first coming to Installable web apps.</p> + +<div class="note"> +<p>Note: Installable open web apps have a "single app per origin" security policy; basically, you can't host more than one installable app per origin. This makes testing a bit more tricky, but there are still ways around this, such as creating different sub-domains for apps, testing them using the Firefox OS Simulator, or testing the install functionality on Firefox Aurora/Nightly, which allows you to install installable web apps on the desktop. See <a href="/en-US/docs/Web/Apps/FAQs/About_app_manifests">FAQs about apps manifests</a> for more information on origins.</p> +</div> + +<h2 id="WebRT_APIs_(Permissions-based_APIs)">WebRT APIs (Permissions-based APIs)</h2> + +<p>There are a number of WebAPIs that are available but require permissions for that specific feature to be enabled. Apps may register permission requests within the <code>manifest.webapp</code> file like so:</p> + +<pre class="brush: js">// New key in the manifest: "permissions" +// Request access to any number of APIs +// Here we request permissions to the systemXHR API +"permissions": { + "systemXHR": {} +}</pre> + +<p>The three levels of permission are as follows:</p> + +<ul> + <li>Normal — APIs that don't need any kind of special access permissions.</li> + <li>Privileged — APIs available to developers to use in their applications, as long as they set access permissions in the app manifest files, and distribute them through a trusted source.</li> + <li>Certified — APIs that control critical functions on a device, such as the call dialer and messaging services. These are generally not available for third party developers to use.</li> +</ul> + +<p>For more information on app permission levels, read <a href="https://developer.mozilla.org/en-US/docs/Web/Apps/Packaged_apps#Types_of_packaged_apps" title="/en-US/docs/Web/Apps/Packaged_apps#Types_of_packaged_apps">Types of packaged apps</a>. You can find out more information about what APIs require permissions, and what permissions are required, at <a href="/en-US/docs/Web/Apps/App_permissions">App permissions</a>.</p> + +<div class="note"> +<p>It's important to note that not all Web APIs have been implemented within the Firefox OS Simulator.</p> +</div> + +<h2 id="Tools_Testing">Tools & Testing</h2> + +<p>Testing is incredibly important when supporting mobile devices. There are many options for testing installable open web apps.</p> + +<h3 id="Firefox_OS_Simulator">Firefox OS Simulator</h3> + +<p>Installing and using the <a href="https://marketplace.firefox.com/developers/docs/firefox_os_simulator">Firefox OS Simulator</a> is the easiest way to get up and running with your app. After you install the simulator, it is accessible from the Tools -> Web Developer -> Firefox OS Simulator menu. The simulator launches with a JavaScript console so you can debug your application from within the simulator.</p> + +<h3 id="App_Manager">App Manager</h3> + +<p>The new kid on the block with regards to testing tools is called the <a href="/en-US/docs/Mozilla/Firefox_OS/Using_the_App_Manager">App Manager</a>. This tool allows you to connect desktop Firefox to a compatible device via USB (or a Firefox OS simulator), push apps straight to the device, validate apps, and debug them as they run on the device.</p> + +<h3 id="Unit_Testing">Unit Testing</h3> + +<p>Unit tests are extremely valuable when testing on different devices and builds. jQuery's <a href="http://qunitjs.com">QUnit</a> is a popular client-side testing utility, but you can use any set of testing tools you'd like.</p> + +<h3 id="Installing_Firefox_OS_on_a_Device">Installing Firefox OS on a Device</h3> + +<p>Since Firefox OS is an open source platform, code and tools are available to build and install Firefox OS on your own device. Build and installation instructions, as well as notes on what devices it can be installed on, can be found on <a href="https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Platform">MDN</a>.</p> + +<p>Dedicated Firefox OS developer preview devices are also available: read our <a href="https://marketplace.firefox.com/developers/dev_phone">Developer preview phone page</a> for more information.</p> + +<h2 id="App_Submission_and_Distribution">App Submission and Distribution</h2> + +<p>Once your app is complete, you can host it yourself like a standard web site or app (read <a href="/en-US/docs/Web/Apps/Publishing/Self-publishing_Apps">Self-publishing apps</a> for more information), or it can be <a href="https://marketplace.firefox.com/developers/submit/app/manifest">submitted</a> to the <a href="https://marketplace.firefox.com">Firefox Marketplace</a>. Your app's manifest will be validated and you may choose which devices your app will support (e.g. Firefox OS, Desktop Firefox, Firefox Mobile, Firefox Tablet). Once validated, you can add additional details about your app (screenshots, descriptions, price, etc.) and officially submit the app for listing within the Marketplace. Once approved, your app is available to the world for purchase and installation.</p> + +<h3 id="More_Marketplace_Listing_Information">More Marketplace & Listing Information</h3> + +<ol> + <li><a href="/en-US/docs/Web/Apps/Publishing/Submitting_an_app">Submitting an App to the Firefox OS Marketplace </a></li> + <li><a href="/en-US/docs/Web/Apps/Publishing/Marketplace_review_criteria">Marketplace Review Criteria </a></li> + <li><a href="http://s.vid.ly/embeded.html?link=8k2n4w&autoplay=false">App Submission Video Walkthrough </a></li> +</ol> +</article> diff --git a/files/fa/archive/b2g_os/using_the_app_manager/index.html b/files/fa/archive/b2g_os/using_the_app_manager/index.html new file mode 100644 index 0000000000..c323990683 --- /dev/null +++ b/files/fa/archive/b2g_os/using_the_app_manager/index.html @@ -0,0 +1,264 @@ +--- +title: Using the App Manager +slug: Archive/B2G_OS/Using_the_App_Manager +translation_of: Archive/B2G_OS/Using_the_App_Manager +--- +<div class="summary"> +<p>The App Manager is a new tool available in Firefox for Desktop, which provides a number of useful tools to help you test, deploy and debug HTML5 web apps on Firefox OS phones and the Firefox OS Simulator, directly from your browser.</p> + +<p>The App Manager is for developers targeting Firefox OS 1.2 or later. If you're developing apps for Firefox OS 1.1, then you should check out the documentation for the <a href="/en-US/docs/Tools/Firefox_OS_1.1_Simulator">Firefox OS 1.1 Simulator</a> instead.</p> +</div> + +<p style="text-align: center;">{{EmbedYouTube("z1Bxg1UJVf0")}}</p> + +<p>The App Manager is composed of:</p> + +<ul> + <li>An <a href="#Apps_panel"><em>Apps panel</em></a>, which manages local apps (app source code located on your computer) and apps hosted externally, allowing you to package and install them on your device or simulator, and debug them using Toolboxes</li> + <li>A <a href="#Device_panel"><em>Device panel</em></a>, which displays information about the connected device including Firefox OS version installed, permissions required for using device APIs on the device, and apps installed</li> + <li><a href="/en-US/docs/Tools_Toolbox"><em>Toolboxes</em></a>, which are are sets of developer tools (web console, inspector, debugger, etc.) that can be connected to a running app via the Apps panel to perform debugging operations</li> +</ul> + +<h2 id="Quick_setup"><a name="Configuring_device">Quick setup</a></h2> + +<p>This section is designed to get you up and running as soon as possible; if you need some more detail please skip forward to the {{ anch("Device and system configuration") }} section and start reading from there. Also see the {{ anch("Troubleshooting") }} section for help if you are having trouble.</p> + +<ol> + <li>Make sure you have Firefox Desktop 26+ installed</li> + <li>Open the App Manager (in the URL bar, type <code>about:app-manager</code>)</li> + <li>If you don't have a real device: + <ol> + <li><a href="https://ftp.mozilla.org/pub/mozilla.org/labs/fxos-simulator/">Install the Firefox OS Simulator</a></li> + <li>In App Manager's bottom toolbar, click on <em>Start Simulator</em>, then click on the name of the installed simulator, which should appear there.</li> + </ol> + </li> + <li>If you have a real device: + <ol> + <li>Make sure your device is running Firefox OS 1.2+</li> + <li>On Windows, make sure to install the drivers provided by your phone manufacturer</li> + <li>In the Settings of your device, disable Screen Lock (<code>Settings > <code>Screen Lock</code></code>) and enable Remote Debugging (<code>Settings > Device information > More information > Developer</code>)</li> + <li><a href="https://ftp.mozilla.org/pub/mozilla.org/labs/fxos-simulator/">Install the ADB Helper</a> add-on in Firefox Desktop</li> + <li>Connect your device to your machine via a USB cable</li> + <li>You should see the name of your device in the App Manager's bottom bar. Click on it.</li> + </ol> + </li> + <li>The bottom bar should show "Connected to: xxx"</li> + <li>Click on the <em>Apps</em> panel and add an app (packaged or hosted)</li> + <li>The <em>Refresh</em> button validates your app and installs it on the Simulator/Device</li> + <li>The <em>Debug</em> button connects the developer tools to the running app</li> + <li><strong>See the {{ anch("Troubleshooting") }} section for help if you are having trouble</strong></li> +</ol> + +<h2 id="Device_and_system_configuration">Device and system configuration</h2> + +<p>The first thing you'll need to do when using the App Manager is make sure your system and phone are set up correctly. This section will run through all the steps required.</p> + +<h3 id="Firefox_1.2_required">Firefox 1.2+ required</h3> + +<p>Make sure your device is running Firefox OS 1.2/Boot2Gecko 1.2 or higher. To check which version of Firefox OS the device is runing, go to <code>Settings > Device Information > Software</code>.</p> + +<p>If you don't have a high enough version installed, depending on what phone you have you will need to either install an available nightly build of Firefox 1.2+, or configure and build it yourself from source.</p> + +<p>Builds available:</p> + +<ul> + <li><a href="http://downloads.geeksphone.com/">Geeksphone Keon/Peak builds</a> (to find out more about using these, read <a href="/en-US/docs/Mozilla/Firefox_OS/Developer_phone_guide/Updating_and_Tweaking_Geeksphone">Updating and Tweaking your Firefox OS Developer Preview phone/Geeksphone</a>)</li> + <li>More to follow</li> +</ul> + +<div class="note"> +<p><strong>Note</strong>: To build your own Firefox OS 1.2+ distribution, follow the instructions located at <a href="/en-US/docs/Mozilla/Firefox_OS/Building_and_installing_Firefox_OS">Building and installing Firefox OS</a>, starting with <a href="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_build_prerequisites">Firefox OS build prerequisites</a>.</p> +</div> + +<h3 id="Remote_debugging">Remote debugging</h3> + +<p>Next, you need to enable remote debugging in Firefox OS. To do so, go to <code>Settings > Device information > More information > Developer</code> and check the Remote Debugging checkbox.</p> + +<h3 id="Adb_Helper_Add-on" name="Adb_Helper_Add-on">ADB or ADB helper</h3> + +<p>The process uses the Android Debug Bridge (ADB) to handle the device-computer connection and communication. There are two options for running ADB:</p> + +<ul> + <li> + <p>Let Firefox handle ADB (recommended). <a href="https://ftp.mozilla.org/pub/mozilla.org/labs/fxos-simulator/">Install the ADB Helper add-on</a>, which makes the process easier. With this installed, there's no need to install the ADB, and no need to type the <code>adb forward</code> command: everything is handled by the add-on.</p> + <a href="https://ftp.mozilla.org/pub/mozilla.org/labs/fxos-simulator/" style="margin-bottom: 20px; padding: 10px; text-align: center; border-radius: 4px; display: inline-block; background-color: #81BC2E; white-space: nowrap; color: white; text-shadow: 0px 1px 0px rgba(0, 0, 0, 0.25); box-shadow: 0px 1px 0px 0px rgba(0, 0, 0, 0.2), 0px -1px 0px 0px rgba(0, 0, 0, 0.3) inset;" title="https://addons.mozilla.org">Download ADB Helper Add-on</a></li> + <li>Use ADB manually. You need to have it installed on your computer: download and install <code>adb</code> as explained in <a href="/en-US/Firefox_OS/Debugging/Installing_ADB">Installing ADB</a>. You'll need to enable port forwarding by entering the following command into your terminal: + <pre>adb forward tcp:6000 localfilesystem:/data/local/debugger-socket</pre> + Note that you'll need to do this every time the phone is restarted or unplugged then re-plugged.</li> +</ul> + +<div class="note"> +<p><strong>Note</strong>: There's no need to run this command if you installed the ADB Helper Add-on.</p> +</div> + +<h2 id="Connecting_your_device_to_the_App_Manager">Connecting your device to the App Manager</h2> + +<p>With all your configuration done, it's now time to plug your device into your computer and start the App Manager:</p> + +<ol> + <li>Plug the device into your computer via USB.</li> + <li>Disable Screen lock on your device by going to <code>Settings > Screen Lock</code> and unchecking the <code>Lock Screen</code> checkbox. This is a good idea because when the screen gets locked, the phone connection gets lost, meaning it is no longer available for debugging.</li> + <li>Start the App Manager — In Firefox Desktop select the <code>Tools > Web Developer > App Manager</code> menu option, or type <code>about:app-manager</code> in the URL bar.</li> + <li>At the bottom of the App Manager tab, you will see a connection status bar (see screenshot below). You should be able to connect your device by clicking the "Connect to localhost:6000" button.</li> + <li>If this works successfully, a prompt should appear on your device: "An incoming request to permit remote debugging connection was detected. Allow connection?". Tap the OK button (You may also have to press the power button on the phone so you can see the prompt.) The connection status bar should update to say "Connected to B2G", with a Disconnect button available to press if you want to cancel the connection.</li> +</ol> + +<p><img alt="" src="https://mdn.mozillademos.org/files/6263/connection-status.png" style="display: block; height: 30px; margin: 0px auto; width: 600px;"></p> + +<div class="note"> +<p><strong>Note</strong>: The other controls in the connection status bar allow you to connect a simulator to the App Manager, which we cover in the next section, below, and change the port that the connection happens on. If you change the port, you'll also need to enable port forwarding for this port as well, as instructed in the {{anch("Enable port forwarding")}} section, above.</p> +</div> + +<h2 id="Using_a_Firefox_OS_Simulator_Add-on"><a name="Simulator">Using a Firefox OS Simulator Add-on</a></h2> + +<p>If you haven't got a real device available to use with App Manager, you can still try it out using a <a href="/en-US/docs/Tools/Firefox_OS_Simulator">Firefox OS Simulator</a> Add-on. To start off, install the simulator with the following button (multiple versions are available; you are advised to install them all, for maximum flexibility):</p> +<p><a class="download-button external ignore-external" href="https://ftp.mozilla.org/pub/mozilla.org/labs/fxos-simulator/" rel="noopener">Install Simulator</a></p> + + +<p>Once you've installed the simulator(s), you need to go to about:app-manager to see the connection status bar at the bottom of the App Manager tab, and click the "Start simulator" button. At least three buttons will appear:</p> + +<ul> + <li>"Firefox OS 1.3", "Firefox OS 1.2" ... etc. (or something similar): the leftmost buttons contain the names of the simulator versions you have installed. Click one to start a connection to a simulator.</li> + <li>"Add": the middle button navigates to the simulator install links in this article, so you can add more Simulators (Firefox OS 1.2, Firefox OS 1.3, ...).</li> + <li>"Cancel": the right hand button cancels the connection.</li> +</ul> + +<h2 id="Apps_panel_2"><a name="Apps_panel">Apps panel</a></h2> + +<p>Now everything is working, let's review the functionality available inside the App Manager, starting with the Apps panel. From here, you can import an existing app to push onto your device and debug:</p> + +<ul> + <li>To install a local app, click on the plus next to the "Add Packaged App" label and use the resulting file chooser dialog to select the directory your app is contained inside.</li> + <li>To install an externally hosted app, enter the absolute URL of the app's manifest file into the text field inside the "Add Hosted App" box, then press the plus button.</li> +</ul> + +<p>Information about your app should appear on the right hand side of the window, as seen below:</p> + +<p><img alt="" src="https://mdn.mozillademos.org/files/6261/apps-panel.png" style="display: block; height: 375px; margin: 0px auto; width: 600px;"></p> + +<h3 id="Manifest_editor">Manifest editor</h3> + +<p>From Firefox 28 onwards, the Apps Panel includes an editor for the app manifest:</p> + +<p><img alt="" src="https://mdn.mozillademos.org/files/6613/apps-panel-fx-28.png" style="display: block; margin: 0px auto; width: 600px;"></p> + +<h3 id="Debugging">Debugging</h3> + +<p>Clicking on <em>"Update"</em> will update (install) the app on the device. Clicking on <em>"debug"</em> will connect a toolbox to the app, allowing you to debug its code directly:</p> + +<p><img alt="" src="https://mdn.mozillademos.org/files/6265/debug.png" style="display: block; height: 375px; margin: 0px auto; width: 600px;"></p> + +<div class="note"> +<p>Note: You'll enjoy playing around with the toolbox — try altering the DOM, CSS etc. and you'll see the updates reflected on the device in realtime. Such updates will be saved on the installed app code; you'll see them next time you open the app on the device.</p> +</div> + +<p>Before Firefox 28, the tools are launched in a separate window. From Firefox 28 onwards, the tools are launched in a separate tab in the App Manager itself, alongside the Apps and Device tabs. The tab is given your app's icon so it's easy to find:</p> + +<p><img alt="" src="https://mdn.mozillademos.org/files/6615/toolbox-fx-28.png" style="display: block; height: 375px; margin: 0px auto; width: 600px;"></p> + +<h3 id="Errors">Errors</h3> + +<p>If an app was not added successfully — for example if the URL was incorrect, or you selected a packaged app folder — an entry will be added to the page for this app, but this will include error information.</p> + +<p><img alt="" src="https://mdn.mozillademos.org/files/6259/apps-error.png" style="display: block; height: 375px; margin: 0px auto; width: 600px;"></p> + +<p>You can also delete an app from this view, by hovering over the App name/description on the left of the window, and pressing the "X" button that appears in each case. This however doesn't remove the app from the device. To do that you need to manually remove the app using the device itself.</p> + +<h2 id="Device_panel_2"><a name="Device_panel">Device panel</a></h2> + +<p>The <em>Device</em> tab displays information about the connected device. From the <em>"</em>Installed Apps<em>"</em> window, apps on the device can be started and debugged.</p> + +<p><img alt="" src="https://mdn.mozillademos.org/files/6267/device-tab.png" style="display: block; height: 375px; margin: 0px auto; width: 600px;"></p> + +<div class="note"> +<p>Note: Certified Apps are not listed by default. <a href="#Debugging_Certified_Apps">See how to debug certified apps</a>.</p> +</div> + +<p><a name="permissions"></a>The "Permissions" window shows the required priviledges for different <a href="/en-US/docs/WebAPI">Web APIs</a> on the current device:</p> + +<p><img alt="" src="https://mdn.mozillademos.org/files/6269/permissions.png" style="display: block; height: 375px; margin: 0px auto; width: 600px;"></p> + +<p>Finally, you can take a screenshot of the current device display by clicking the "Screenshot" button. The screenshot appears in a new tab on Firefox, and from there you can save or discard it as you wish.</p> + +<h2 id="Debugging_Certified_Apps_2"><a name="Debugging_Certified_Apps">Debugging Certified Apps</a></h2> + +<p>Currently only devices running a development build of Firefox OS 1.2+ are capable of debugging certified apps. If you have a development build, you can enable certified app debugging by changing the pref <code>devtools.debugger.forbid-certified-apps</code> to <code>false</code> in your profile. To do this, follow the steps below:</p> + +<ol> + <li> + <p>On your computer, enter the following command in Terminal/console to enter your device's filesystem via the shell:</p> + + <pre class="brush: bash">adb shell</pre> + + <p>Your prompt should change to <code>root@android</code>.</p> + </li> + <li> + <p>Next, stop B2G running using the following command:</p> + + <pre class="brush: bash">stop b2g</pre> + </li> + <li> + <p>Navigate to the following directory:</p> + + <pre>cd /data/b2g/mozilla/*.default/</pre> + </li> + <li> + <p>Here, update the prefs.js file with the following line:</p> + + <pre class="brush: js">echo 'user_pref("devtools.debugger.forbid-certified-apps", false);' >> prefs.js</pre> + </li> + <li> + <p>After you've finished editing and saving the file, start B2G again using the following command:</p> + + <pre class="brush: bash">start b2g</pre> + </li> + <li> + <p>Exit the android filesystem using the <code>exit</code> command; this will return you to your normal terminal prompt.</p> + </li> + <li> + <p>Next, reconnect to the App Manager and you should see certified apps appear for debugging.</p> + </li> +</ol> + +<div class="note"> +<p>Note: If you want to add this preference to your Gaia build you can run <code>make DEVICE_DEBUG=1 reset-gaia</code>.</p> +</div> + +<h2 id="Running_custom_builds_in_the_App_Manager">Running custom builds in the App Manager</h2> + +<p>You can run custom B2G Desktop and Gaia builds in the App Manager via the simulator. Read <a href="/en-US/Firefox_OS/Running_custom_builds_in_the_App_Manager">Running custom Firefox OS/Gaia builds in the App Manager</a> for more details.</p> + +<h2 id="Troubleshooting_2"><a name="Troubleshooting">Troubleshooting</a></h2> + +<p id="My_device_is_not_recognized">If the device is not recognized:</p> + +<ul> + <li>Read the <a href="#Configuring_device">Device and system configuration</a> section thoroughly, and make sure all the steps are followed:</li> + <li>Is your device running at least Firefox OS 1.2?</li> + <li>Don't see all the apps? Do you need to enable <a href="#Debugging_Certified_Apps">Certified Apps debugging</a>?</li> + <li>Did you enable "Remote Debugging" in the settings of your phone?</li> + <li>If you are not using the <a href="#Adb_Helper_Add-on">ADB Helper add-on</a>: + <ul> + <li>Did you successfully run the <code>adb forward</code> command?</li> + </ul> + </li> + <li>If you are using the <a href="#Adb_Helper_Add-on">ADB Helper add-on</a> and your device is not listed in the bottom toolbar: + <ul> + <li>If you use Linux, <a href="http://developer.android.com/tools/device.html#setting-up">make sure to setup udev correctly</a></li> + <li>If you use Windows, <a href="http://developer.android.com/tools/device.html#setting-up">make sure to install the appropriate drivers</a></li> + <li>You can also enable verbose logging to gather diagnostics: + <ul> + <li>Use about:config to set the pref "<span class="message"><span class="content"><span class="email">extensions.adbhelper@mozilla.org.sdk</span>.console.logLevel"</span></span> to the string value "all"</li> + <li>Disable and re-enable the ADB Helper add-on from the add-ons manager, or restart Firefox</li> + <li>Open the App Manager again</li> + <li>In the <a href="/docs/Tools/Browser_Console">Browser Console</a>, you should now see additional output lines that mention "adbhelper"</li> + <li>If you see them but aren't sure what they mean, stop by the <a href="https://wiki.mozilla.org/DevTools/GetInvolved#Communication">#devtools room on IRC</a> or <a href="https://bugzilla.mozilla.org/enter_bug.cgi?alias=&assigned_to=nobody%40mozilla.org&attach_text=&blocked=&bug_file_loc=http%3A%2F%2F&bug_ignored=0&bug_severity=normal&bug_status=NEW&cf_blocking_b2g=---&cf_crash_signature=&cf_status_b2g18=---&cf_status_b2g_1_1_hd=---&cf_status_b2g_1_2=---&cf_status_firefox24=---&cf_status_firefox25=---&cf_status_firefox26=---&cf_status_firefox27=---&cf_status_firefox_esr17=---&cf_status_firefox_esr24=---&cf_tracking_b2g18=---&cf_tracking_firefox24=---&cf_tracking_firefox25=---&cf_tracking_firefox26=---&cf_tracking_firefox27=---&cf_tracking_firefox_esr17=---&cf_tracking_firefox_esr24=---&cf_tracking_firefox_relnote=---&cf_tracking_relnote_b2g=---&comment=&component=Developer%20Tools%3A%20App%20Manager&contenttypeentry=&contenttypemethod=autodetect&contenttypeselection=text%2Fplain&data=&defined_groups=1&dependson=&description=&flag_type-203=X&flag_type-37=X&flag_type-41=X&flag_type-5=X&flag_type-607=X&flag_type-720=X&flag_type-721=X&flag_type-737=X&flag_type-748=X&flag_type-781=X&flag_type-787=X&flag_type-791=X&flag_type-799=X&flag_type-800=X&flag_type-802=X&flag_type-803=X&flag_type-809=X&flag_type-825=X&form_name=enter_bug&keywords=&maketemplate=Remember%20values%20as%20bookmarkable%20template&op_sys=All&priority=--&product=Firefox&qa_contact=developer.tools%40firefox.bugs&rep_platform=x86&requestee_type-203=&requestee_type-41=&requestee_type-5=&requestee_type-607=&requestee_type-748=&requestee_type-781=&requestee_type-787=&requestee_type-791=&requestee_type-800=&short_desc=&status_whiteboard=&target_milestone=---&version=Trunk">file a bug</a> with the log output</li> + </ul> + </li> + </ul> + </li> + <li>See <strong>"???????"</strong> instead of the device name on Linux? You have permissions issues. <a href="http://developer.android.com/tools/device.html#setting-up">Make sure to setup udev correctly</a>.</li> + <li>Is your phone screen unlocked?</li> +</ul> + +<p>Can't connect your device to the App Manager or start the simulator? <a href="https://wiki.mozilla.org/DevTools/GetInvolved#Communication">Let us know</a> or <a href="https://bugzilla.mozilla.org/enter_bug.cgi?alias=&assigned_to=nobody%40mozilla.org&attach_text=&blocked=&bug_file_loc=http%3A%2F%2F&bug_ignored=0&bug_severity=normal&bug_status=NEW&cf_blocking_b2g=---&cf_crash_signature=&cf_status_b2g18=---&cf_status_b2g_1_1_hd=---&cf_status_b2g_1_2=---&cf_status_firefox24=---&cf_status_firefox25=---&cf_status_firefox26=---&cf_status_firefox27=---&cf_status_firefox_esr17=---&cf_status_firefox_esr24=---&cf_tracking_b2g18=---&cf_tracking_firefox24=---&cf_tracking_firefox25=---&cf_tracking_firefox26=---&cf_tracking_firefox27=---&cf_tracking_firefox_esr17=---&cf_tracking_firefox_esr24=---&cf_tracking_firefox_relnote=---&cf_tracking_relnote_b2g=---&comment=&component=Developer%20Tools%3A%20App%20Manager&contenttypeentry=&contenttypemethod=autodetect&contenttypeselection=text%2Fplain&data=&defined_groups=1&dependson=&description=&flag_type-203=X&flag_type-37=X&flag_type-41=X&flag_type-5=X&flag_type-607=X&flag_type-720=X&flag_type-721=X&flag_type-737=X&flag_type-748=X&flag_type-781=X&flag_type-787=X&flag_type-791=X&flag_type-799=X&flag_type-800=X&flag_type-802=X&flag_type-803=X&flag_type-809=X&flag_type-825=X&form_name=enter_bug&keywords=&maketemplate=Remember%20values%20as%20bookmarkable%20template&op_sys=All&priority=--&product=Firefox&qa_contact=developer.tools%40firefox.bugs&rep_platform=x86&requestee_type-203=&requestee_type-41=&requestee_type-5=&requestee_type-607=&requestee_type-748=&requestee_type-781=&requestee_type-787=&requestee_type-791=&requestee_type-800=&short_desc=&status_whiteboard=&target_milestone=---&version=Trunk">file a bug</a>.</p> diff --git a/files/fa/archive/index.html b/files/fa/archive/index.html new file mode 100644 index 0000000000..08498cb2c9 --- /dev/null +++ b/files/fa/archive/index.html @@ -0,0 +1,18 @@ +--- +title: Archive of obsolete content +slug: Archive +translation_of: Archive +--- +<p>Here at MDN, we try to avoid outright deleting content that might be useful to people targeting legacy platforms, operating systems, and browsers. Perhaps your target audience is people that are using older hardware, for example, and can't upgrade to the latest and greatest browsers. Or for "reasons," your company is required to use very old software and you need to build Web content that runs on that software. Or perhaps you're just curious about the history of an obsolete feature or API, and how it worked.</p> + +<p>There are many reasons older documentation can be useful. So, we've established this area into which we can archive older documentation. Material in this Archived content zone should <strong>not</strong> be used for building new Web sites or apps for modern browsers. It's here for historical reference only.</p> + +<div class="note"> +<p><strong>Note to writers:</strong> We need to try to keep the subpages here organized instead of all dumped into one large folder. Try to create subtrees for categories of material. Also, only move pages here that are <strong>extremely</strong> obsolete. If anyone might realistically need the information in a living product, it may not be appropriate to move it here. In general, it may be best to discuss it in the <a href="https://chat.mozilla.org/#/room/#mdn:mozilla.org">MDN Web Docs chat room</a> before moving content here.</p> +</div> + +<p>{{SubpagesWithSummaries}}</p> + +<h2 id="Subnav">Subnav</h2> + +<p>{{ListSubpages("/fa/docs/Archive", 2, 0, 1)}}</p> diff --git a/files/fa/archive/mozilla/index.html b/files/fa/archive/mozilla/index.html new file mode 100644 index 0000000000..4fd902cdfe --- /dev/null +++ b/files/fa/archive/mozilla/index.html @@ -0,0 +1,10 @@ +--- +title: Archived Mozilla and build documentation +slug: Archive/Mozilla +tags: + - Archive +translation_of: Archive/Mozilla +--- +<p>These articles are archived, obsolete documents about Mozilla, Gecko, and the process of building Mozilla projects.</p> + +<p>{{SubpagesWithSummaries}}</p> diff --git a/files/fa/archive/mozilla/persona/index.html b/files/fa/archive/mozilla/persona/index.html new file mode 100644 index 0000000000..6c0c152f34 --- /dev/null +++ b/files/fa/archive/mozilla/persona/index.html @@ -0,0 +1,176 @@ +--- +title: Persona +slug: Archive/Mozilla/Persona +translation_of: Archive/Mozilla/Persona +--- +<div class="summary" dir="rtl">ساده، ثبت نام منفرد در حریم خصوصی: اجازه دهید کاربران وب سایت شما با استفاده از آدرس ایمل خود در سایت شما ثبت نام کنند، و خودرا از مدیریت کلمههای رمز آزاد سازید.</div> + +<div class="column-container" dir="rtl"> +<p><span class="seoSummary"><a href="https://login.persona.org/">موزیلا شخصی</a> یک سیستم ورود مستقل از مرورگر برای وب است، که برای پیاده سازی و توسعه راحت است. برروی تمامی <a href="/en-US/docs/persona/Browser_compatibility">مرورگرهای اصلی</a> کار میکند، و همین امروز <a href="/en-US/docs/Persona/Quick_Setup">می توانید شروع کنید</a>.</span></p> + +<p>چرا باید از موزیلا شخصی در وب سایت خود استفاده کنید؟</p> + +<ol> + <li><strong>موزیلا شخصی بهطور کامل کلمههای رمز مخصوص سایت را حذف میکند،</strong> کاربرها و وب سایتها را از بار سنگین ساخت، مدیریت، و ذخیره امن کلمههای رمز آزاد میسازد.</li> + <li><strong>موزیلا شخصی برای استفاده آسان است.</strong> فقط با دو کلیک یک کاربر شخصی میتواند در سایت مثل <a href="http://voo.st">Voost</a> ثبت نام کند، سختی ایجاد حساب کاربری را دور میزند.</li> + <li><strong>موزیلا شخصی برای پیاده سازی ساده است</strong><strong>. </strong>توسعه دهندگان در یک بعدازظهر می توانندموزیلا شخصی را به یک سایت اضافه کنند.</li> + <li><strong>هیچ قفلی وجود ندارد</strong>. توسعه دهندگان یک ایمیل تایید از همه کاربرانشان دریافت میکنند، و کاربران از هر آدرس پست الکترونیکی میتوانند استفاده کنند.</li> +</ol> + +<p>بهعلاوه، موزیلا شخصی بهتر میشود: آن برپایه <strong>پروتکل باز، غیرمتمرکز،</strong> که طراحی شده تا به آن اجازه بدهد <strong>با مرورگرها بهصورت مستقیم یکپارچه شود</strong> و <strong>بهصورت محلی از فراهم کنندگان پست الکترونیک پشتیبانی کنند</strong><strong>. </strong>سایتهایی که امروزه موزیلا شخصی را پیاده سازی میکنند بهصورت خودکار این تجربه را کسب میکنند، بدون نیاز به تغیر هیچ کدی.</p> +</div> + +<hr> +<div class="column-container" dir="rtl"> +<h2 id="استفاده_از_موزیلا_شخصی_در_سایت_خودتان">استفاده از موزیلا شخصی در سایت خودتان</h2> + + + +<div class="column-third"> +<h3 id="شروع_بهکار">شروع بهکار</h3> + +<dl> + <dt><a href="/en-US/docs/Persona/Why_Persona">چرا شخصی؟</a></dt> + <dd>نکات خاص در مورد موزیلا شخصی که با دیگر سیستمهای شناسایی و تشخیص هویت مقایشه شده است.</dd> + <dt><a href="/en-US/docs/Persona/Quick_Setup">راهاندازی سریع</a></dt> + <dd>نمایش سریع چگونه موزیلا شخصی را به سایت خودتان اضافه کنید.</dd> +</dl> + +<h3 id="مرجع_API">مرجع API</h3> + +<dl> + <dt><a href="/en-US/Persona/The_navigator.id_API">The navigator.id API</a></dt> + <dd>API مرورگر.</dd> + <dt><a href="/en-US/docs/Persona/Remote_Verification_API">مرجع API تصدیق</a></dt> + <dd>API تصدیق راه دور.</dd> +</dl> +</div> + +<div class="column-third"> +<h3 id="راهنماییها">راهنماییها</h3> + +<dl> + <dt><a href="/en-US/docs/Persona/Security_Considerations">ملاحظههای امنیتی</a></dt> + <dd>تمرینها و تکنیکهایی برای اطمینان از اینکه موزیلا شخصی امن است.</dd> + <dt><a href="/en-US/docs/Persona/Browser_compatibility">سازگاری مرورگر</a></dt> + <dd>یادبگیرید دقیقا کدام مرورگر از موزیلا شخصی پشتیبانی میکند.</dd> + <dt><a href="/en-US/docs/Persona/Internationalization">بینالمللی کردن</a></dt> + <dd>یادبگیرید چطور موزیلا شخصی با ربانهای مختلف رفتار میکند.</dd> + <dt><a href="/en-US/docs/Persona/The_implementor_s_guide">راهنمای مجریها</a></dt> + <dd>نکاتی از سایتهایی که پشتیبانی از موزیلا شخصی را اضافه کردهاند.</dd> +</dl> +</div> + +<div class="column-third"> +<h3 id="منابع">منابع</h3> + +<dl> + <dt><a href="/en-US/docs/Persona/Libraries_and_plugins">کتابخانهها و متّصل شوندهها</a></dt> + <dd>پیدا کردن یک کتابخانه برای زبان برنامه نویسی محبوب، محیط کاری وب، بلاگ، یا سیستم مدیریت محتوی شما.</dd> + <dt><a class="link-https" href="https://github.com/mozilla/browserid-cookbook">کتاب آشپزی موزیلا شخصی</a></dt> + <dd>نمونه کدهای منبع برای سایتهای موزیلا شخصی. شامل قطعه کدهای کوچک در C# (MVC3)، PHP، Node.JS، و نمونههای بیشتر.</dd> + <dt><a href="/en-US/Persona/User_interface_guidelines">راهنماهای رابط کاربر</a></dt> + <dd>چطور ثبت نام در موزیلا شخصی را به کاربران خود نمایش دهید.</dd> +</dl> +</div> +</div> + +<hr> +<h2 dir="rtl" id="تبدیل_شدن_به_یک_ارایه_دهنده_هویت">تبدیل شدن به یک ارایه دهنده هویت</h2> + +<p dir="rtl">اگر شما یک ارایه دهنده سرویس پست الکترونیک یا هویت هستید، لینکهای زیر را برای تبدیل شدن به یک ارایه دهنده هویت دنبال کنید.</p> + +<div class="column-container" dir="rtl"> +<div class="column-third"> +<dl> + <dt><a href="/en-US/docs/Persona/Identity_Provider_Overview">مرور IdP</a></dt> + <dd>یک مرور سطح بالا از ارایه دهنده هویت موزیلا شخصی.</dd> +</dl> +</div> + +<div class="column-third"> +<dl> + <dt><a href="/en-US/docs/Persona/Implementing_a_Persona_IdP">پیاده سازی یک IdP</a></dt> + <dd>یک راهنمای مفصل برای جزییات تکنیکی تبدیل شدن به یک IdP.</dd> +</dl> +</div> + +<div class="column-third"> +<dl> + <dt><a href="/en-US/docs/Persona/.well-known-browserid">.well-known/browserid</a></dt> + <dd>مرور فایل <code>.well-known/browserid</code> ، که IdP ها برای اعلان پشتیبانی از پروتکل استفاده میکنند.</dd> +</dl> +</div> +</div> + +<hr> +<h2 dir="rtl" id="پروژه_موزیلا_شخصی">پروژه موزیلا شخصی</h2> + +<div class="column-container" dir="rtl"> +<div class="column-third"> +<dl> + <dt><a href="/en-US/docs/Persona/Glossary">واژه نامه</a></dt> + <dd>اصطلاحات تعریف شده موزیلا شخصی و BrowserID.</dd> + <dt><a href="/en-US/docs/Persona/FAQ">پرسشهای متداول</a></dt> + <dd>پاسخ به سوالات متداول.</dd> + <dt><a href="/en-US/docs/Persona/Protocol_Overview">مرور پروتکل</a></dt> + <dd>مرور تکنیکی سطح متوسط از زیر ساخت پروتکل BrowserID.</dd> +</dl> +</div> + +<div class="column-third"> +<dl> + <dt><a href="/en-US/docs/persona/Crypto">رمزنگاری</a></dt> + <dd>نگاهی به مفهوم رمز نویسی پشت پرده موزیلا شخصی و BrowserID.</dd> + <dt><a class="link-https" href="https://github.com/mozilla/id-specs/blob/prod/browserid/index.md">تنظیمات</a></dt> + <dd>جزییات فنی بیشتر در اینجا وحود دارند.</dd> +</dl> +</div> + +<div class="column-third"> +<dl> + <dt><a href="/en-US/docs/Persona/Bootstrapping_Persona">وب سایت موزیلا شخصی</a></dt> + <dd>برای بدست آوردن موزیلا شخصی، ما سه سرویس را در <a class="link-https" href="https://login.persona.org" rel="freelink">https://login.persona.org</a> میزبانی میکنیم: ارایه دهنده هویت مجدد، پیاده سازی APIهای {{domxref("navigator.id")}} ، و سرویس تصدیق هویت.</dd> + <dt><a href="https://github.com/mozilla/browserid">کد منبع موزیلا شخصی</a></dt> + <dd>کد موزیلا شخصی بر روی GitHub. خوش آمدید!</dd> +</dl> +</div> +</div> + +<p dir="rtl"></p> + +<h2 dir="rtl" id="Subnav">Subnav</h2> + +<ol dir="rtl"> + <li><a href="#">استفاده از موزیلا شخصی در یک وب سایت</a> + + <ol> + <li><a href="/en-US/Persona/Why_Persona" title="Why Persona?">چرا باید از موزیلا شخصی استفاده کنیم؟</a></li> + <li><a href="/en-US/Persona/Quick_setup" title="Quick Start">شروع کنید</a></li> + <li><a href="/en-US/Persona/The_implementor_s_guide" title="Implementor's Guide">Tips for implementing Persona</a></li> + <li><a href="/en-US/Persona/Security_Considerations" title="Security Considerations">Security considerations</a></li> + <li><a href="/en-US/Persona/Browser_compatibility" title="Browser compatibility">Browser compatibility</a></li> + <li><a href="/en-US/Persona/Internationalization" title="Internationalization">Internationalization</a></li> + <li><a href="/en-US/Persona/The_navigator.id_API" title="The navigator.id API">The navigator.id API</a></li> + <li><a href="/en-US/Persona/Remote_Verification_API" title="Remote Verification API">The remote verification API</a></li> + <li><a href="/en-US/Persona/Libraries_and_plugins" title="Libraries and plugins">کتابخانه ها و افزونه ها</a></li> + <li><a href="/en-US/Persona/User_interface_guidelines" title="User interface guidelines">User interface guidelines</a></li> + </ol> + </li> + <li><a href="#">Becoming an Identity Provider</a> + <ol> + <li><a href="/en-US/Persona/Identity_Provider_Overview" title="IdP Overview">IdP Overview</a></li> + <li><a href="/en-US/Persona/Implementing_a_Persona_IdP" title="Implementing an IdP">Implementing an IdP</a></li> + <li><a href="/en-US/Persona/.well-known-browserid" title=".well-known-browserid format">.well-known-browserid format</a></li> + </ol> + </li> + <li><a href="#">پروژه موزیلا شخصی</a> + <ol> + <li><a href="/en-US/Persona/Glossary" title="Glossary">Glossary</a></li> + <li><a href="/en-US/Persona/FAQ" title="FAQ">سوالات متداول</a></li> + <li><a href="/en-US/Persona/Bootstrapping_Persona" title="Persona hosted services">خدمات هاست موزیلا شخصی</a></li> + <li><a href="/en-US/Persona/Protocol_Overview" title="Protocol overview">Protocol overview</a></li> + <li><a href="/en-US/Persona/Crypto" title="Crypto">Cryptography</a></li> + </ol> + </li> +</ol> diff --git a/files/fa/archive/mozilla/persona/nooshin/index.html b/files/fa/archive/mozilla/persona/nooshin/index.html new file mode 100644 index 0000000000..81afb73107 --- /dev/null +++ b/files/fa/archive/mozilla/persona/nooshin/index.html @@ -0,0 +1,59 @@ +--- +title: Why Persona for Mozilla? +slug: Archive/Mozilla/Persona/nooshin +translation_of: Archive/Mozilla/Persona/Why_Persona +--- +<div dir="ltr" style="margin-left: 40px;"> + Persona is an openly distributed, cross-browser identity system providing a solution to the traditional password model. It addresses the usability deficiencies that plague other privacy-related systems such as OpenID, without resorting to a centralized infrastructure such as Facebook Connect.<span id="result_box" lang="en"><span class="hps"> </span></span></div> +<div dir="ltr" style="margin-left: 40px;"> + </div> +<div dir="ltr" style="margin-left: 40px;"> + <span lang="en"><span class="hps">The current approach for establishing and managing </span><span class="hps">user names</span> <span class="hps">and passwords is tedious, inefficient, and unsecure. </span>U<span class="hps">sers must create and remember complex passwords for each site and service. Sites then must securely encrypt and store passwords to prevent the leaking of sensitive information. The prevention and negation of security leaks is the primary reason for the use of Persona, but the flexibility of its systems outclasses most standard identity security systems.</span></span></div> +<div dir="ltr" style="margin-left: 40px;"> + </div> +<div class="summary"> + <div dir="ltr" style="margin-left: 40px;"> + <strong>Note:</strong> For more detailed information about Persona a<strong>nd its functions </strong>see <a href="https://support.mozilla.org/en-US/kb/what-is-persona-and-how-does-it-work">What is Persona and how does it work?</a></div> +</div> +<h2 id="Persona_eliminates_the_need_for_per-site_passwords">Persona eliminates the need for per-site passwords</h2> +<p style="margin-left: 40px;">Persona utilizes a safe, two-click system built on top of public-key cryptography for logging in to websites. The user's browser generates a cryptographic affirmation of identity that expires after a few minutes and is only valid on one site. By avoiding passwords, users do not need to worry about remembering several distinct passwords and need no longer be concerned with unsecure access to their password.<span id="result_box" lang="en"><span class="hps"> This quick and easy sign-in process eliminates the current inefficiencies of traditional account registration and allows users to quickly establish accounts on websites.</span></span></p> +<h2 id="Persona_uses_email_addresses_as_identities">Persona uses email addresses as identities</h2> +<div id="gt-src-tools"> + <div id="gt-src-tools-l"> + <div id="gt-input-tool" style="display: inline-block;"> + <div id="itamenu" style="margin-left: 40px;"> + Persona's system relies on email addresses as their key component because of email's inherent versatile and private nature. The pre-existing infrastructure works very well from not only a design perspective but an ideal perspective of openly maintained and safe transfer of identity across the Internet.</div> + </div> + </div> +</div> +<h3 id="sect1"> </h3> +<h3 id="Benefits_for_the_user"><span class="short_text" id="result_box" lang="en"><span class="hps">Benefits for</span> <span class="hps">the user</span></span></h3> +<ul style="margin-left: 40px;"> + <li>Users already know their email addresses. They don't have to learn a new and potentially confusing system, like OpenID.</li> + <li><span id="result_box" lang="en"><span class="hps">The</span> <span class="hps">email addresses</span> <span class="hps">carefully</span> <span class="hps">capture the</span> <span class="hps">idea of</span> <span id="result_box" lang="es"><span class="hps"><code>someone@some-context</code></span></span>. This <span class="hps">makes it easier for</span> <span class="hps">users to keep their</span> <span class="hps">identities</span> <span id="result_box" lang="es"><code>@work</code>, <code>@home</code>, or <code>@school </code></span><span>separate.</span> <span class="hps">This differs from</span> <span class="hps">the trend of</span> linking together many accounts <span class="hps">through real</span> <span class="hps">identity,</span> single-account <span class="hps">policies</span> <span class="hps">on social networks like Google+ and Facebook.</span></span></li> + <li><span id="result_box" lang="en"><span class="hps">Email can</span> <span class="hps atn">be self-</span><span>organized</span> <span class="hps">or delegated to</span> <span class="hps">other providers</span><span>,</span> <span class="hps">giving users</span> <span class="hps">control of their</span> <span class="hps">identity.</span></span> This ability is greatly diminished when one must consolidate many accounts into one identity. </li> +</ul> +<div class="almost_half_cell" id="gt-res-content"> + <h3 dir="ltr" id="Advantages_for_developers" style="zoom: 1;"><span class="short_text" id="result_box" lang="en"><span class="hps">Advantages</span> <span class="hps">for developers</span></span></h3> +</div> +<ul style="margin-left: 40px;"> + <li><span id="result_box" lang="en"><span class="hps">Email addresses</span> let <span class="hps">developers </span><span class="hps">communicate directly with </span><span class="hps">users.</span> </span></li> + <li> + <div class="almost_half_cell" id="gt-res-content"> + <div dir="ltr" style="zoom: 1;"> + <span id="result_box" lang="es"><span id="result_box" lang="en"><span class="hps">Persona provides email addresses to websites</span><span class="hps"> automatically</span> <span class="hps">when a user</span> <span class="hps">logs in, </span><span class="hps">eliminating the need for</span> <span class="hps">additional</span> <span class="hps atn">post-</span><span>signup</span> <span class="hps">forms.</span> </span></span></div> + </div> + </li> + <li> + <div class="almost_half_cell" id="gt-res-content"> + <div dir="ltr" style="zoom: 1;"> + <span id="result_box" lang="es"><span id="result_box" lang="en"><span class="hps">Many login systems</span> <span class="hps">treat</span> <span class="hps">email</span> <span class="hps">addresses</span> <span class="hps">as</span> <span class="hps">unique keys, </span><span class="hps">so there is no</span> <span class="hps">lock-in</span> <span class="hps">to</span> <span class="hps">Persona and</span> it <span class="hps">can be integrated</span> <span class="hps">with</span> <span class="hps">existing access</span> <span class="hps">systems</span><span>.</span></span></span><span lang="es"><span lang="en"><span class="hps"> Any user who has an</span></span></span><span lang="es"><span lang="en"><span class="hps"> email address can access content almost immediately</span></span></span><span id="result_box" lang="es"><span id="result_box" lang="en">.</span></span></div> + </div> + </li> +</ul> +<div class="almost_half_cell" id="gt-res-content"> + <h2 dir="ltr" id="How_Persona_is_different_from_other_providers_of_single_sign-on" style="zoom: 1;"><span id="result_box" lang="es"><span class="hps"><span id="result_box" lang="en"><span class="hps">How</span> <span class="hps">Persona</span> <span class="hps">is different</span> <span class="hps">from other providers of</span> <span class="hps">single sign</span><span>-on</span></span></span></span></h2> +</div> +<p style="margin-left: 40px;"><span id="result_box" lang="es"><span id="result_box" lang="en">Persona<span class="hps"> protects</span> <span class="hps">privacy, provides the user with</span><span class="hps"> control,</span> <span class="hps">and embellishes</span><span class="hps"> choice</span> <span class="hps">in a way that</span> <span class="hps">other security providers can't. Many</span> <span class="hps">social networks like</span> <span class="hps">Facebook</span> <span class="hps">and</span> <span class="hps">Google+</span> <span class="hps">require users to</span> <span class="hps">use their</span> <span class="hps">real names, accept their policies,</span> <span class="hps">and</span> <span class="hps">limit users to only</span> <span class="hps">one account.</span> P<span class="hps">ersona</span> <span class="hps">allows users to</span> <span class="hps">keep their work</span><span>, school, and social identities separate b</span></span></span><span style="line-height: 1.5;">y using email addresses as a unique identifier rather than real names.</span> Because of this anonymity you are guaranteed an extra layer of identity and network protection that most social networks do not have.</p> +<p style="margin-left: 40px;"><span lang="en"><span class="hps">Persona</span> <span class="hps">also takes</span> <span class="hps">a new approach</span> <span class="hps">to protecting</span> <span class="hps">user privacy</span> <span class="hps">by placing </span><span class="hps">the user's browser</span> <span class="hps">in the center</span> <span class="hps">of the authentication process. T</span><span>he browser</span> <span class="hps">obtains</span> <span class="hps">credentials</span> <span class="hps">provided by the</span> <span class="hps">user's email</span><span>,</span> <span class="hps">then presents these credentials to a website</span><span class="hps">.</span> <span class="hps">The</span> <span class="hps">email provider</span> <span class="hps">cannot</span> <span class="hps">track the</span> <span class="hps">user,</span> <span class="hps">but sites</span> <span class="hps">can still have</span> <span class="hps">confidence in the identity</span> <span class="hps">of the user by</span> <span class="hps">cryptographically</span> <span class="hps">verifying the</span> <span class="hps">credentials.</span> <span class="hps">Most</span> <span class="hps">other systems,</span> <span class="hps">even</span> <span class="hps">distributed</span> systems <span class="hps">like</span> <span class="hps">OpenID</span><span>,</span> <span class="hps">require</span> <span class="hps">sites</span> <span class="hps">to connect to central networks</span> <span class="hps">before allowing</span> <span class="hps">a user to</span> <span class="hps">log in.</span></span></p> +<p style="margin-left: 40px;">The efficiency of Persona allows an advanced relationship between developers and users. Mozilla is leading the way in open and free web development, and Persona supports Mozilla's design philosophy through its easy-to-use interface and user protection features.</p> diff --git a/files/fa/archive/mozilla/persona/quick_setup/index.html b/files/fa/archive/mozilla/persona/quick_setup/index.html new file mode 100644 index 0000000000..c88e90c73c --- /dev/null +++ b/files/fa/archive/mozilla/persona/quick_setup/index.html @@ -0,0 +1,56 @@ +--- +title: Quick Setup +slug: Archive/Mozilla/Persona/Quick_Setup +translation_of: Archive/Mozilla/Persona/Quick_Setup +--- +<p dir="RTL"><br> + ١- پهیوهندییهكانی بزوتنهوهی كوردو بزوتنهوهی گشتی ئێرانو ئۆپۆزسیۆنی ئێران لهچ ئاستێكدا دهبینی؟</p> +<p dir="RTL">وڵام = لە ئێران بە هۆی دوخی تایبەت و هەر سەردەمە و بە شیوازێک خەبات و بەربەرەکانێ لە گەڵ دەسەڵات لە ئارادا بووە و بەڕێوە چووە و زۆر جاریش ئەو دەربڕینی نارەزایەتیانە و خۆ پێشاندانەکان بە دوور لە کاریگەریی لایەنە سیاسی و رێکخراوەییەکان، یان بە واتایەکیتر "خۆرسک"بووە. بەڵام لە کوردستان جیا کردنەوەی جەماوەر و لایەنە سیاسیەکان کارێکی ئاستەمە. بزووتنەوەی کوردستان هەڵقوڵاوی بەستێنێکی رزگاریخوازی، عەداڵەتخوازی، مافخوازی و کۆمەڵایەتیی پێویستە. بەم پێێە بزووتنەوەی کوردستان نەک تەنیا ویست و ئێرادەی کۆمەڵێک رووناکبیرو خوێندەوار لە زانکۆکان، بەڵکۆ پێویستەیەکی کۆمەڵایەتی و مێژوویی بوو کە لە تووتنەوان، جووتیار، قوتابی، خوێندکار و کیژو کوڕ و پیر و لاوی شارو گوندی کوردستان پێک هاتووە و بنچی کوتاوە. بۆیە ئەو بزووتنەوەیە پێکهاتەیەکە لە کۆمەڵێک رێکخراوی کۆمەڵایەتی و داخوازی روون و ئاشکرا و دەربڕێنی روون و راشکاوی ئەوداخۆازانەو بانگەشەکردن بۆیان. بەڵام بزووتنەوە جەماوەریەکان لە ئێران بە داخەوە خاوەنی داخوازێکی کونکرێت، دیار و شەفاف نین. دیارە هەرکامە و هەڵگری کۆمەڵێک داخوازن، بەڵام هەتا ئێستاشی لە گەڵ بێت نەیان توانیوە لە سەر لانیکەم داخوازە هاوبەشەکانیان هاودەنگ و هاوڕا بن. بەو مانایە کاتێک بزووتنەوی نەتەوە بن دەستەکان هەیە، تەنیا دەمێنێتەوە، هەروەک بینیمان لە ئاخری حەفتاکاندا بزووتنەوەی بەرینی خوێندکاری بە تەنیا مایەوە هەر وەک بزووتنەوە کرێکاریەکان، بزووتنەوەی ژنان، بزووتنەوە پێشەییەکان و . . . هتد بەو دەردەوە ئەناڵێنن.</p> +<p dir="RTL"> ئەو بزووتنەوانە بڕێک جار لە لایەن رێکخراوە حیزبیەکانەوە بە مەبەستێکی تایبەتەوە بە کار هێنراون و مافی سەربەخۆییان لێ زەوت کراوە و بە پێی هەل و مەرج و سیگناڵە سینووسیەکان لە نێو خۆی دەسەڵاتی زاڵ(نەک کۆمەڵگا)، بۆ چوونی ئەوبزووتنەوانەش ئاڵ و گۆڕی نەک تاکتیکی بەڵکۆ زۆرجار بنەڕەتیی تێدا پێک هاتووە تا رادەیەک کە بڕیک جار ریزبەندیی دۆست و دوژمنی شێواندووە.</p> +<p dir="RTL">بەداخەوە سەرەڕای تێپەڕینی سی و چوارساڵ بە سەر دەسەڵاتی ئیسلامی لە ئێران، شپرزەیی، بێ بەرنامەیی، بێ ئاسۆیی، ناتەبایی و بە وتەیەکی راشکاوتر، جیا لە شەڕە دەندووک و کەڵک وەرگرتنی هەلپەرستانە، بەرژەوەندیخۆازانە و بە لاڕێدا و لە بار بردنی پوتانسیەلی بەهێزی جەماوەر، دەسکەوتێکی ئەوتۆمان لە بەردەستدا نیە. لە راستیدا ئەو پەتایەی کە لایەنە ئوپۆزیسیونەکان تووشین، لە بزووتنەوە جەماوەریەکانیشدا تەشەنەی سەندووە. هەرچەندە زۆر جاریش دەسەڵات ناچار کەوتووە لە بەرانبەر خەبات و تێکۆشانی ئەو بزووتنەوانەدا پاشەکشە بکات، بەڵام لە لایەک بە هۆی هەر ئەو شپرزەیی و بێ بەرنامەیی و ناتەباییەی کە ئاماژەی پێکرا نەتواندرا خاوەندارێتی لەو دەسکەوتانە بکرێت و بپارێزرێن و لە لایەکی ترەو کۆماری ئیسلامی بە شیوازێکی تر لە بوارگەلی تردا دیسانەوە ئەو دەسکەوتانەی زەوت کردۆتەوە.</p> +<p dir="RTL">لە کۆتاییدا، هەروەک لانیکەم لە ماوەی ئەم سی و چوار ساڵەدا ئێمە بە گشتی شاهیدی زۆرێک بزووتنە، خەبات و بەربەرەکانێی جەماوەری و پیشەیی لە ئێران بووین و لە ئەگەری هاوئاهەنگی و هاوخەباتی پوتانسیلی بەدەست هێنانی زۆر دەسکەوت و بەرەو پێشچوون و بەرینتر بوونەوەیان هەبووە بەڵام نەیان توانیوە مەبەستەکانی خۆیان بە باشی بپێکن. بۆیە پێویستە بە دوور لە قەتیس مانەوە لە چوارچێوەی لایەنە حیزبیەکان و بەڕێوە بردنی رۆڵی ئامرازانە، سەربەخۆییان بپارێزرێت، پەرەیان پێ بدرێت، رێک بخرێن، هاوئاهەنگ بکرێن، بناسێندرێن و بە گشتی لە بەر ئەوەی کە هەرکامە نوێنەرایەتیی بە شێکی دیاریکراوی کۆمەڵگا دەکەن و ئاوێنەی باڵانمای کۆمەڵگان، لایەنە رێکخراوییەکان پێویستە خۆیان لە گەڵ ئەوان رێک بخەن و هاوئاهەنگ بن نەک هەلپەرستانە و ئامرازانە لە خزمەت بەرژەوەندیی بەرتەسکی حیزبی بەکاریان بێنن.</p> +<p dir="RTL"> </p> +<p dir="RTL"> </p> +<p dir="RTL"><br> + ٢- پێتوایه پهیوهندی حیزبهكوردیهكان لهگهڵ ئۆپۆزسیۆنی ئێرانی لهچ ئاستێكو لهسهر چ بنهمایهكدا بێت؟</p> +<p dir="RTL">وڵام= ئێمە کاتێک باس لە ئوپۆزیسیون دەکەین بەداخەو لە بەر کۆمەڵێک فاکتۆری دیار و ئاشکرا، لایەن یان بابەتێکی جیدی بە ناو ئوپۆزیسیونمان بەرچاو ناکەوێت. لە باتی ئەوە کۆمەڵێک خەڵک ئەبینین زۆرتر خەریکی شەڕە دەندووک و بە یەکدا هەڵگوتن و لەم دواییانەشدا کێبەرکێی رەنگامەین کە بە هۆی دوور کەوتنەوە لە جەماوەر و بڕێک جار خۆ بەستنەوە و خۆ هەڵواسین لە بیروکەیەکی ئیدئۆلۆژیی تایبەتیدا، مەودایەکی زۆریان لە گەڵ کۆمەڵگا و داخۆازە کۆمەڵایەتی، پێشەیی، سیاسی و ئابووریەکانیدا لە نێواندایە. </p> +<p dir="RTL">بە بڕوای من چاوەڕوانی، بێ گەڵالەیی و شپرزەییەکی بەرین بە سەر ئوپۆزیسیونی ئێرانیدا زاڵە و ئەو دۆخە هەڵ ئەگەڕێتەوە بۆ بێ هیوای و نە بوونی متمانە بە خۆ و هەروەها چەشنێک"توهم" لە ئاست دەسەڵاتی ئیسلامی لە نێو ئوپۆزیسیونی ئێرانی بە گشتی. جا ئەو نەبوونی متمانە بە خۆ و تەوەهومە، تا ئەو جێگایە پەرەسەندووە کە لە بچووکترین بابەت لەئاڵ و گۆڕە نێو خۆییەکانی رژیمی ئیسلامی دا خۆ دەردەخات ولایەنهایەک لە ئوپۆزیسیونی ئێران تووشی راڕایی، دوودڵی و تەنانەت قەیران دەکات. لەمبارەوە وێنا زۆرن و بە درێژایی تەمەنی کۆماری ئیسلامی بوونیان هەبووەو هەیە، بۆ وێنە:</p> +<p dir="RTL">هەڵبەز دابەزەکانی رێکخراوی موجاهدین، دۆخی تایبەتیی لایەنە میللی – مەزهەبیەکان، قەیرانە نێو خۆییەکانی رێکخراوی چریکە فیداییەکانی خەڵکی ئێران، قەیران، چارەنووس و ئاکامی حیزبی توودەی ئێران و لەم شازدەساڵەی دواییشدا بە هاتنەئارای باسی ئیسڵاحخوازیی حکومەتی، خولێکی نوێ دیسانەوە دەستی پێکردەوە کە لووتکەکەی پاش هەڵبژاردنی خولی دەیەمی سەرۆک کۆماری و دەرەنجامەکانی، بە زەقی خۆی نیشاندا تا ئەو جێگایەی کە بڕێک لە ئوپۆزیسیون بە شایی لۆغان بەرەو پیریی دەسەڵاتدارانی دوێنی و بێدەسەڵاتکراوانی ئەمڕۆ کە برابەشی تاوانە سامناکەکانی کۆماری ئیسلامین، چوون و چەپڵەیان بۆ لێدان.</p> +<p dir="RTL">لانیکەم لە جۆزەردانی ١٣٨٨ی هەتاوی بەم لاوە، ریزی ئوپۆزیسیونی ئێرانی بە گشتی ئاڵ و گۆڕی گرینگی بە سەردا هات. واتە ئوپۆزیسیون دابەش بوو بە دوو لایەنی: رێفۆرمیست و ئەوانەی هیوایان بە ئاڵ و گۆڕ لە نێو خودی کۆماری ئیسلامیدا بەست و تەنانەت لە گەڵ نێردراوانی کۆماری ئیسلامی لە ژوورە داخراوەکاندا دانیشتن یان لە گەڵ کۆمەڵێک لە ئوپۆزیسیونی دەست نیشان کراو دانیشتن کە هیچ بڕوایەکیان بە مافە ئاسایی، یاسایی و بنەڕەتیەکانی هیچ لایەنێکیتر نیە تەنانەت ئەگەر بە رواڵەتیش بووبێت.</p> +<p dir="RTL">لە ماوەی تەمەنی سی و چوارساڵە و هەموو هەڵس و کەوتەکانی ئەو رژیمە، ئەو راستیەی دەرکەوتووە و سەلمێندراوە کە بە بێ رووخانی کۆماری ئیسلامی بە تەواوەتیی هەبوونیەوە، نە هیج نەتەوە و کەمایەتی یان گروپ و دەستەیەک، بەڵکۆ تەنانەت تاکێکی کۆماڵگای فەرەچەشنیی ئێران ناتوانن بە داخواز و مافە سەرەتاییەکان خۆیان بگەن.</p> +<p dir="RTL">هەر بۆیە لە سەر ئەو بنەما و لێکدانەوەیە، زیندووترین،چالاکترین و ئاکتیڤترین بزووتنەوەو ئوپۆزیسیون لە کوردستان بوونی هەبووە. لە باری تەمەنیشەوە هەر وەک ئوپۆزیسیونی بێ بەرنامە و راڕایی ئێرانی هاوتەمەنی ئەو رژیمەیە، بزوتنەوەی کوردستانیش هاوتەمەنیەتی و بە دڵنیاییەوە ئەتوانین بڵێین خاوەنی درێژترین تەمەنە،. جیا لە بڕێک بابەتی لاوەکی، پەیگیرترین بزووتنەوەو ئوپۆزیسیون لە ئێران بووە. </p> +<p dir="RTL">هەر وەک زۆرێک ئاگادارن، لە رۆژە سەرەتاییەکانی بە دەسەڵات گەیشتنی کۆماری ئیسلامی و زەخت خستنە سەر بیرجیاوازان و زیندانی و ئێعدام کردنی بە کۆمەڵ لە دادگا چەند خولەکی و نیزامیەکاندا، تەنیا سەنگەرێک کە سەرەڕای بێ ئیمکاناتی، هەژاری و نەداری خەڵک و ئابڵۆقە و گەمارۆە بەربڵاوەکانی دەسەڵاتی تاران لە کوردستان، گەلی کورد و وڵاتەکەیان بوونە سەنگەر، بنکە، مەقەڕ و ماوای ئازادیخوازان و بیر جیاوازان لە سەرتاسەری پانتایی ئێران.</p> +<p dir="RTL">لایەنە جۆربەجۆرە سیاسی و خەباتکارەکان لە لایەک بۆ درێژەی خەبات دژی ئەو رژیمەو لە لایەکی ترەو بۆ پاراستنی خۆیان، روویان کردە کوردستان و خەڵکی کوردستانیش بە دڵئاوەڵاییەوە پێشوازییان لێ کردن. هەرچەندە کوردستان و لایەنە کوردیەکان بە ئەو پەڕی دڵپاکی و رووڕاست، سەرەڕای هەموو تەنگ چەڵەمەکان و هەل و مەرجی کوردستان، چوونە پێشوازی ئەو بابەتەوە. بەڵام لایەنی بەرانبەر بڕێکیان بە هۆی هەر ئەو "توهم"ەی کە پێشتر ئاماژەمان پێی کرد، بڕێکیش بە هۆی گێرەو کێشە ناوخۆییەکانیان و لە کۆتاییدا بڕێکیان کە بە مەبەستی کاسبکارانەو و سەوداگەرانەوە هاتبوونە کوردستان، هەرکامەو بە شێوەیەک چوونە پەراوێزەوە.</p> +<p dir="RTL">دواتریش هەر یەکەو بە شێوازێک یان خەڵکی کورد و بزووتنەوەی کوردستانیان لە بیر خۆیان بردەوە یا بە شیوەیەکی نەشیاو هێرشیان کردە سەر بزووتنەوەی کوردستان و رێکخراوە کوردستانیەکان و خەباتی رەوا و خۆڕاگریی خەڵکی کوردستان بە "خێڵەکی"، "قەومپەرست" ،"ناسیونالیست" و" جودایی خواز" و کۆمەڵێک لەو بابەتانە ناو لێناوە و باسکرد.</p> +<p dir="RTL">لە ئەگەری هەر پێشڕەویەکی بزووتنەوەی کوردستان و هەست بە مەترسی کردن لە لایەن لایەنە جۆربەجۆرەکانی ئێران، هەر لە چەپی چەپەوە تا راستی راست و دەسەڵاتدار تا بێدەسەڵاتی پەراوێزخراو، سەرەڕای جێاوازیی بۆچوون و تەنانەت ئیدئۆلۆژیک، بە بێ وەستان لە بەرانبەر بزووتنەوەی کوردستاندا یەکیان گردۆتەوە</p> +<p dir="RTL"> </p> +<p dir="RTL">بۆیە حیزبە کوردیەکان یان لانیکەم ئەو لایەنانە لە رێکخراوە کوردستانیەکان کە بڕوای راستەقینەیان بە وەدەستهێنانی مافەکانی خەڵکی کوردستان هەیە، لەم دووفاق بوونەوەی ئوپۆزیسیونی ئێرانیەدا بە راشکاوی بۆچوون و هەڵوێستی خۆیان بە سات و سەودا ،سازان و پرژاندنی تووی دوودڵی، راڕایی و گومان و کڕێنەوە متمانە بۆ ئەو دەسەڵاتە یان دەست و پێوەندە پەراوێز خراوەکانی لە نێو بەشیک لە کۆمەڵگای کوردی درێژە دەدەن ، یان بە پێداگری لە سەر داخوازەکانی کۆمەڵگای کوردستان و دۆزینەوەی هاوپەیمانی راستەقینە تا دوا قۆناخەکان و سەلماندن و دەستەبەر کردن مافە رەواکانی خەڵکی کوردستان خۆ لە هەر سازان و سات و سەودایەک ئەبوێرن.</p> +<p dir="RTL"> ئێمە زۆر بە راشکاوی ئەو داخوازەمان وەکۆ پرەنسیب بۆخۆمان دیاری کردووە کە: <strong><em>ناچینە هیچ هاوپەیمانی و هاوکاری لە گەڵ هیچ لایەنێکەوە کە بڕوای راستەقینەی بە مافی گەلی کورد تا دامەرزانی دەوڵەتی سەربەخۆی کوردی نەبێت و دانی پێدا نەنێت.</em></strong></p> +<p dir="RTL"><br> + ٣- سهبارهت بهمافهكانی گهلی كورد ئایا ئۆپۆزسیۆنی ئێرانی لهبهرهیهكدا دهبینی یان جیاوازییهكی بهدی دهكرێت، پێتوایه هێڵه سوورهكان بۆ حیزبی كوردی لهو پهیوهندییانهدا چین؟</p> +<p dir="RTL">وڵام= ئەگەر چی بۆ خۆیان دوور و لێک جیاوازن و هەرکامە لە روانگەی ئیدئۆلۆژی و جیهانبینیی خۆیانەوە بۆ بابەت و پرسە جۆراوجۆرەکان ئەڕوانن، بەڵام تا ئەمڕۆ بە کردەوە نیشانیان داوە کە لە ئاست پرسە دیموکراتیک، پیشەیی،کۆمەڵایەتی و مرۆییەکان، بە تایبەت لە سەر ماف و داخوازی نەتەوە بندەستەکانی ئێران، مافی ژنان، بابەتە مرۆییەکان، بە هیچ شیوەیەک جیاوازییان نیەو یەکڕان. بۆیە هەرکامە لە جانتای وشەنامەکانیاندا بە پێی بنەما فیکریەکانیان، کۆمەڵێک وشەی دیاری کراو ریز ئەکەن.</p> +<p dir="RTL">بڕێکیان هەر نکۆڵی لە کورد و نەتەوەی کورد ئەکەن و زۆرتر ئەچنە دوو قاڵبی تایبەتەوە کە بریتین لە لایەنی پان ئێرانیست و مەزنیخۆازیی ئێرانی و ئەڵێن: <strong><em>ئێمە هەموو ئێرانین کورد و فارس و تورک و ئەوانەمان نیە ئەو جیا کردنەوانە مەبەست و خواستی دوژمنانی ئێرانی مەزنە</em></strong>. واتە لە راستیدا ئەو بابەت و پرسە گرینگە ئەشارنەوەو نکۆڵی لێ ئەکەن وهەموو شتێک ئەخەنە خانەی عەزەمەتی ناسیونالیزمی کوێر و بەرتەسکی ئێرانیچیەتیەوە. لایەنی تریش بە چاویلکەیەکی هاوشێوە واتە"امت اسلامی" لە بابەتەکە دەدوێن و ئەڵێن: <strong><em>ئێمە هەموو موسەڵمانین و جیاوازیمان نیە، لێدوان لەو بابەتە و تەنانەت بیرلێکردنەوەشی کفرە و لە خزمەت دوژمنانی ئیسلام دایە.</em></strong></p> +<p dir="RTL">واتە بە دەربڕینی چەند وشەی خۆخڵەتێنی بێ ناوەڕۆک بە نیازی دەرباز کردنی خۆیان لەو قەیرانە ناوچەییەن.</p> +<p dir="RTL">ئەوەی لەو دێڕانەی سەرەوە باسیان لێوە کرا بە درێژایی مێژوو تاقی کراونەتەوە، واتە هەرکامەو ماوەیەکی دوور و درێژ لە ئێران دەسەڵاتیان بە دەستەوە بووە یان هێشتا بە دەستیانەوەیە و تەنیا ئەوکاتانەی کە پێویستیان بووە یان بە پێی بەرژەوندیی مەبەستدار ناوێکیان لە کورد هێناوە.</p> +<p dir="RTL">لە ئوپۆزیسیونی ئێرانی لایەنهایەکیتریش هەن کە لە قەبارەی دروشمدا باس لە کۆمەڵە بابەتێکی "کلیشەیی"و"رواڵەتی" ئەکەن بەڵام دەسەڵتیان بە دەستەوە نەبووەو تاقینەکراونەتەوە تا برایەتیەکەیان بسەلمێندرێت. جا ئاساییە ئێمە پرسەکە نابێت بە یەکجاری بە رەش و سپی بیبینین. داخوازەکانی خەڵکی کوردستان بە راشکاوی باس دەکەین، جاڕی دەدەین، هێزو پشتیوانی بۆ کۆدەکەینەوە و پێداگریی لە سەر ئەکەین.</p> +<p dir="RTL">بە بێ گەڵاڵەی کونکرێت و پێشمەرجی روون و ئاشکرا لە سەر پرسی کورد و بزووتنەوەی خەڵکی کوردستان لە بەرانبەر ئوپۆزیسیونی ئێرانی بە گشتی، چوونە هەر دانیشتن لە پشت دەرکی داخراو، رێکەوتن و بلووک بەندیەکەوە(ئەو بابەتەی کە لەم رۆژانەدا بانگەشەی بۆ دەکرێت) دیسانەوە رادەست کردنەوە و پردەباز کردنی بەرژەوەندی و بزووتنەوەی کوردستانە ئەویش لە بەرانبەر لایەنهایەکی بێ بەڵێنی پاوانخوازی هەلپەرست. جا دیارە ئەوەش نە لە قازانجی بزووتنەوەی رەوای خەڵکی کوردستان بەڵکۆ لە پێناو سات و سەودا بە مەبەستی بەرتەسکی تایبەتدایە.</p> +<p dir="RTL">زۆر بە بێ پەردە و خۆماڵیانە بیڵێم، لە روانگەی منەوە زۆربەی ئەو لایەنانەی کە بە ناوی ئوپۆزیسیونی ئێرانیەوە بوونیان هەیە چ ئەوانەی لە ژێر دروشمی خەڵک فریودەری " ئێران هی هەموو ئێرانیەکانە" خەڵکی کورد رەسەن ترین (قوم)ی!؟ ئێرانین"،" ئێمە هەموو یەک نەتەوەین و ئێرانین"،"کورد و تورک و فارس و ئەوانەمان نیە، ئێمە هەموو(امت اسلام)ین!؟"و" پاراستنی چوارچێوەی ئەرزیی ئێران ئەرکی بێ ئەم لا و ئەولای هەمووانە" هیچ بایەخ و نرخێکیان نیە. نە خاک، نە ئاڵا، نە دروشمی قەبەی دینداری و دیانەت تا ئەو کاتەی مافە سروشتی و ئاساییەکانی منی کورد بە فەرمی نەناسێت و مل کەچی نەبێت، نە ئەوی کە بایەخدار و پیرۆز نیە، بەڵکۆ بۆ تێکشاندنیشی حەول ئەدەم.</p> +<p dir="RTL">7</p> +<p dir="RTL"><br> + ٤- بهبڕوای ئێوە كۆنگرهی 13ی كۆمهڵه دهبێت چ گۆڕانكاری لهسیاسهتو ستراتیژهكانی بكات سهبارهت به پهیوهندیو هاوكارییهكانی لهگهڵ ئۆپۆزسیۆنی ئێرانی؟</p> +<p dir="RTL">دۆخی ئەمڕۆی جیهان، ناوچە، ئێران و کوردستان بە گشتی دۆخێکی تایبەتە و ئاڵ و گۆڕی پەیتا پەیتا و خێرا بە خۆیەوە دەبینێت، بۆیە ئەرکی سەرەکیی هەر لایەن و پێکهاتەیەکی رێکخراوەیی، سیاسی و جەماوەری کە مۆدێڕن و ئەمڕۆیی بێت، لێکدانەی واقێعبینانەی ئەو دۆخەو دۆزینەو بە کار بردنی هەڵوێستی گونجاو لەو بارەوەیە. بەڵام بە داخەوە دەردێکی کۆنی گورچک بڕ داوێنی هەموو لایەنەکانی تەنیوەتەوە کە ئەویش نامۆدێڕن بوون و نائەمڕۆیی بوونە.</p> +<p dir="RTL">هەموو لایەنە سیاسی و رێکخراوەییەکان چ کوردستانی و چ ئەوانەی ئێرانی، لەسەردەمانێکدا بە گشتی خاوەنی پێگەیەکی رێکخراوەیی، سیاسی و کۆمەڵایەتی بوون کە بۆ هەموو لایەک خاڵێکی وەرچەرخان بوو، بەڵام بە هۆکاری روون و ئاشکرا کە بۆ کەس شاراوە نین، یان پێگەکەیان لاواز بوو یان هەر بە تەواوەتی رووخا. هەرچەندە سەرەڕای ئەو تراژدیە ئەسەفبارە لە ئێران بە گشتی، لە کوردستان دۆخەکە بە شیوازێکی ترەو هێشتا رێکخراوە کوردیەکان لە چاو ئێران لە ئاستێکی باشتردان. لەم نێوەدا جەماوەری خەڵکی کوردستان بە هێچ شیوەیەک تاوانبار نین چونکۆ بە درێژایی تەمەنی دەسەڵات و هێزی داگیرکاری رژیمی تاران، راوەستاون، خەباتیان کردووە، قوربانییان داوە و شەرافەتمەندانە ژیاون. لە هەر ئان و ساتدا کە بە پێویستیان زانیبێت بە بێ راڕایی و گۆمان پێشوازییان لە داخوازی حیزبەکوردیەکانەوە کردووە و بە هانایانەوە هاتوون.</p> +<p dir="RTL"> بۆیە ئەوە لایەنە رێکخراوەییەکانن کە پێویستە وڵامدەرەوەی ئەو دۆخە بن، سەرەڕای هەبوونی بەستێنی سیاسی، فەرهەنگی و کۆمەڵایەتیی شیاو و لە بار، نەیانتوانیوە کۆمەڵگا رێکبخەن و وڵامی داخوازە خەباتکارانەکانی جەماوەر بدەنەوە. لە بەر ئەوەی یان خەریکی کۆمەڵێک بابەتی لاوەکین یان سەرقاڵی کێشەی ناوەکی و بە یەکدا هەڵگوتنن.</p> +<p dir="RTL">لە هەر کومەڵگایەک بە پێی دۆخی گشتیی کۆمەڵگا و هەل و مەرجی تایبەت بە ئەو کومەڵگایە، لایەنە رێکخراوەیی و سیاسیەکان لە بەر ئەوەی هێزە ئینسانیەکەیان هەر لە ئەو شوێنە وەر ئەگرن، ئەو حیزب و لایەن یان رێکخراوەیە لە هەموو ئاستەکاندا هەڵگری کولتوورو خۆ و خسڵەتەکانی جەرماوەری پێکهێنەری ئەو کۆمەڵگایەیە، لە کوردستانیش کە بەشێک لەو کۆمەڵگایانەیە، ئاشکرایە کە هەڵگری ئەو خۆ و خسڵەتانەیە و رەنگدانەوەشی لە نێو حیزبەکان یان هەر پێکهاتەیەکی جەماوەری و کۆمەڵایەتی دیار و حاشا هەڵنەگرە.</p> +<p dir="RTL">بۆیە هەڵس وکەوتی نێو لایەن و رێکخراوە کوردیەکانێش بە گشتی لە ژێر کاریگەریی ئەو پرسەدایە. (هەر چەندە لە ئێران بە گشتی لایەنی رووناکبیریی کەمەڵگا چاوی لە دەرەوەی سنوورەکانی خۆی بڕیوە و نە بە نیازی ئەزموون وەرگرتن بەڵکۆ زۆرجار بۆ چاولێگەری و (تقلید) بۆ بابەتەکەی رووانیوە هەر بۆیە تا ئیستا نەیتوانیوە پێوەندیی نێوان کاری سیاسیی پڕۆفشناڵ و کۆمەڵگا قایم و پتەو بکاتەوە. هۆیەکەشی ئەوە بووە کە نەیان تووانیوە جەماوەری کۆمەڵگای خۆیان بناسن و هەڵسەنگاندن و لێکدانەوەیەکی واقێعبیبانەیان لێی هەبێت.)</p> +<p dir="RTL">لە کوردستان ئەو بابەتە بە شیوازێکیتر خۆ دەنوێنێت، ئەویش ئەوەیە کە هێشتا پێوەندیی نێوان جەماوەر و لایەنە رێکخراوەیی، پیشەیی، جەماوەری و سیاسیەکان لە ئاستێکی شیاودا نیە، شیوازی حیزبایەتی لە کوردستان نەیتوانیوە خۆی پێ بگەێنێت، مۆدێڕنەوە بێت و بە پێی پێشەوە چوونەکانی کۆمەڵگای کوردستان گەشە بکات. بۆ وێنە شێوازی حیزبایەتی لە کوردستان تێکڵاوێکە لە داب و نەریتی پاشماوەی شیوازی بەرهەمهێنانی زاڵی سێ چارەکە سەدە لەمەو پێشی کوردستان، حەولدان بۆ خۆ تێوەگلاندن لە تەوژمی هەرس هێناوی نیو سەدەی پێشترو ئێستاش بانگەشەی حیزبایەتیی مۆدێڕن کە بە داخەوە لە نێوان هەرسێکدا ماونەتەوە.</p> +<p dir="RTL">لە مێژووی ژیانی کۆمەڵگای مرۆڤایەتیدا هەر سەردەمەو و ناوچەی جوغرافیایی، کەرەسەو ئامرازی خەبات گۆڕدراوە. لە ئەمڕۆشدا کە خولی سەرهەڵدانی بزووتنەوە پیشەیی، رەگەزی، کۆمەڵایەتی و تایبەتیەکانە، ئەرکی سەرەکیی حیزبێکی مۆدێڕن و ئەوڕٶیی ناسینی ئەو راستیەو خۆ رێکخستن و خۆتەیار کردن بۆ هاو ئاهەنگی لە گەڵ وەها بزووتنەوەگەلێکدایە و لە هەمان کاتدا بە فەرمی ناسینی سەربەخۆیی و مەموو مافەکانی ئەو لایەنانەیە نەک حەول دان بۆ بە حیزبی کردنیان و کەڵک وەرگرتن لەوانە لە پێناو بەرژەوەندیی کورت ماوەو بەرتەسکی حیزبی و بەستنەوەیان لە قاڵب و چوارچێوەی حیزبایەتیدا.</p> +<p dir="RTL">بۆیە بە قەناعەت هێنان و بڕوا بەو راستیە کە شێوازی حیزبایەتی و بەڕێوە بردنی حیزب بەو چلۆنایەتیەی کە هەیە، وڵامدەرەوە نیە، ئەرکی سەرشانی ئەندامانی بەشداری کۆنگرەی سێزدەی کۆمەڵە ئەوەیە کە پێداگری بکەن لە سەر:</p> +<ol> + <li dir="RTL">حیزبیەت کردن و دانانی دەستگاو دامەرزاوەی حیزبی و خۆ دەرباز کردن لە شێوە حیزبایەتیی کلاسیک. ئەویش بە کردەوە و بە عەمەل نە سەردانی کۆمەڵێک دروشمی بریقەداری باو.</li> + <li dir="RTL">جارێک و بۆ هەمێشە سەلماندنی مل کەچ بوون بە هەڵوێست و بڕیاری پەسەندکراوی گشتی، نەک تەسلیم بوون بە خواست و ئیرادەی تاک.</li> + <li dir="RTL">پەسەند کردن و پێداگری لە سەر جێ بە جێ کردنی مێکانیزمێک لە پێناو ئاشت کردنەوی جەماوەر و لایەنە سیاسی و رێکخراوەییەکان و بەخشینەوەی متمانانەی تەم گرتووی کۆمەڵگا بە رێکخراوەکان، کە هۆە سەرەکیەکەی شێوەی هەڵس و کەوتی حیزبەکان خۆیانن.</li> + <li dir="RTL">پێداگری لە سەر سەلماندنەوە و کردنە بڕوای پراکتیکیی ئەو راستیە کە حیزب، رێکخراوە و هەر بابەتێکی لەو چەشنە، ئامرازو کەرەسەیەکن لە خزمت بەرژەوەندیی گشتیی کۆمەڵگادا.</li> + <li dir="RTL">بایەخدان بە ویست و داخوازی جەماوەر و خستنەگەڕی هێزو توانای حیزب لە پێناو وڵامدانەوە بە داخوازە رەواکانی خەڵکی کوردستان لەم قۆناخە هەستیارە لە مێژووی خەباتکارانەی جەماوەری خەڵکی کوردستان.</li> + <li dir="RTL">حەولدان بۆ رێکخستن و سازماندانی کۆڕ و کۆمەڵە مەدەنی و غەیرە حیزبیەکان و هاوکاری و یارمەتی دانی ئەو کۆڕ و کۆمەڵانە.</li> +</ol> diff --git a/files/fa/archive/mozilla/xul/index.html b/files/fa/archive/mozilla/xul/index.html new file mode 100644 index 0000000000..5380037ae5 --- /dev/null +++ b/files/fa/archive/mozilla/xul/index.html @@ -0,0 +1,94 @@ +--- +title: XUL +slug: Archive/Mozilla/XUL +tags: + - NeedsTranslation + - TopicStub + - XUL +translation_of: Archive/Mozilla/XUL +--- +<div class="callout-box"> + <strong><a href="/en-US/docs/XUL_Tutorial" title="en-US/docs/XUL_Tutorial">XUL Tutorial</a></strong><br> + A guided tutorial that will help you get started with XUL, originally from XULPlanet.</div> +<div> + <p><span class="seoSummary"><strong>XUL</strong> (XML User Interface Language) is Mozilla's <a href="/en-US/docs/XML" title="en-US/docs/XML">XML</a>-based language for building user interfaces of applications like Firefox.</span> The term XUL is sometimes used to refer to the whole <a href="/en-US/docs/The_Mozilla_platform" title="/en-US/docs/The_Mozilla_platform">Mozilla platform</a> (e.g. XUL applications are applications using XUL and other components of the platform).</p> + <p><a href="/en-US/docs/XUL_controls" title="en-US/docs/XUL_controls">XUL Controls</a> lists some of the common controls provided by XUL.</p> +</div> +<table class="topicpage-table"> + <tbody> + <tr> + <td> + <h2 class="Documentation" id="Documentation">Documentation</h2> + <dl> + <dt> + <strong><a href="/en-US/docs/XUL_Tutorial" title="en-US/docs/XUL_Tutorial">XUL Tutorial</a></strong></dt> + <dd> + A guided tutorial that will help you get started with XUL, originally from XULPlanet.</dd> + <dt> + <a href="/en-US/docs/XUL_Reference" title="en-US/docs/XUL_Reference">XUL Reference</a></dt> + <dd> + XUL elements, attributes, properties, methods, and event handlers.</dd> + <dt> + <a href="/en-US/docs/XUL_controls" title="en-US/docs/XUL_controls">XUL Controls</a></dt> + <dd> + A quick list of all of the available XUL controls.</dd> + <dt> + <a href="/en-US/docs/The_Joy_of_XUL" title="en-US/docs/The_Joy_of_XUL">The Joy of XUL</a></dt> + <dd> + Describes the key features and components of XUL.</dd> + <dt> + <a href="/en-US/docs/XUL/PopupGuide" title="en-US/docs/XUL/PopupGuide">Menus and Popups Guide</a></dt> + <dd> + A guide on using menus and popup panels.</dd> + <dt> + <a href="/en-US/docs/XUL/Template_Guide" title="en-US/docs/XUL/Template_Guide">Template Guide</a></dt> + <dd> + A detailed guide on XUL templates, which is a means of generating content from a datasource.</dd> + <dt> + <a href="/en-US/docs/DragDrop/Drag_and_Drop" title="Drag and Drop">Drag and Drop</a></dt> + <dd> + How to perform drag and drop operations.</dd> + <dt> + <a href="/en-US/docs/XUL_Overlays" title="en-US/docs/XUL_Overlays">Overlays</a></dt> + <dd> + Overlays are used to describe extra content for the UI. They provide a powerful mechanism for extending and customizing existing XUL applications.</dd> + </dl> + <dl> + <dt> + XUL Periodic Table</dt> + <dd> + This collection of XUL demos used to be available as a web page, but can no longer be viewed in Firefox since support for <a href="/en-US/docs/Remote_XUL" title="/en-US/docs/Remote_XUL">Remote XUL</a> was disabled. There is a XULRunner application containing the XUL Periodic Table which can be opened with Gecko based browsers. <a href="https://github.com/matthewkastor/XULRunner-Examples" title="https://github.com/matthewkastor/XULRunner-Examples">You can get it here</a>. See: <a href="/en-US/docs/XULRunner_tips#Using_Firefox_3_to_run_XULRunner_applications" title="/en-US/docs/XULRunner_tips#Using_Firefox_3_to_run_XULRunner_applications">XULRunner_tips#Using_Firefox_3_to_run_XULRunner_applications</a> for instructions on running XULRunner apps in Firefox.</dd> + <dt> + Changes to XUL</dt> + <dd> + New XUL features and changes to existing features are included in the <a href="/en-US/docs/Mozilla/Firefox/Releases" title="/en-US/docs/Mozilla/Firefox/Releases">Firefox developer release notes</a>.</dd> + </dl> + <p><span class="alllinks"><a href="/en-US/docs/tag/XUL" title="tag/XUL">View All...</a></span></p> + </td> + <td> + <h2 class="Community" id="Community">Community</h2> + <ul> + <li>View Mozilla forums...{{ DiscussionList("dev-tech-xul", "mozilla.dev.tech.xul") }}</li> + <li><a class="link-irc" href="irc://irc.mozilla.org/xul">#xul on irc.mozilla.org</a></li> + </ul> + <h2 class="Tools" id="Tools">Tools</h2> + <ul> + <li><a class="external" href="/en-US/docs/XUL_Explorer" title="en-US/docs/XUL_Explorer">XUL Explorer</a> (a lightweight XUL IDE)</li> + <li><a href="https://github.com/matthewkastor/XULExplorer" title="https://github.com/matthewkastor/XULExplorer">XULExplorer</a> (Patched version of XUL explorer)</li> + <li><a class="external" href="http://ted.mielczarek.org/code/mozilla/extensiondev/">Extension developer's extension</a> (featuring a Live XUL Editor)</li> + <li><a class="external" href="http://forum.addonsmirror.net/index.php?showtopic=751" title="http://forum.addonsmirror.net/index.php?showtopic=751">XULRef sidebar</a></li> + <li><a class="external" href="http://www.getfirebug.com/">Firebug</a></li> + <li><a href="/en-US/docs/DOM_Inspector" title="en-US/docs/DOM_Inspector">DOM Inspector</a></li> + <li><a class="external" href="http://www.spket.com/">Spket IDE</a>, IDE for XUL/XBL</li> + <li><a class="external" href="http://www.amplesdk.com" title="http://www.amplesdk.com/">Ample SDK</a>, (Cross-browser XUL renderer in JavaScript/HTML)</li> + </ul> + <p><span class="alllinks"><a href="/en-US/docs/tag/tools" title="tag/tools">View All...</a></span></p> + <h2 class="Related_Topics" id="Related_Topics">Related Topics</h2> + <ul> + <li><a href="/en-US/docs/JavaScript" title="en-US/docs/JavaScript">JavaScript</a>, <a href="/en-US/docs/XBL" title="en-US/docs/XBL">XBL</a>, <a href="/en-US/docs/CSS" title="en-US/docs/CSS">CSS</a>, <a href="/en-US/docs/RDF" title="en-US/docs/RDF">RDF</a>, <a href="/en-US/docs/Extensions" title="en-US/docs/Extensions">Extensions</a>, <a href="/en-US/docs/XULRunner" title="en-US/docs/XULRunner">XULRunner</a></li> + </ul> + </td> + </tr> + </tbody> +</table> +<p> </p> diff --git a/files/fa/archive/mozilla/xul/مرجع_زبان_طراحی_واسط_کاربری_مبتنی_بر_ایکس_ام_ال/index.html b/files/fa/archive/mozilla/xul/مرجع_زبان_طراحی_واسط_کاربری_مبتنی_بر_ایکس_ام_ال/index.html new file mode 100644 index 0000000000..efddf1246c --- /dev/null +++ b/files/fa/archive/mozilla/xul/مرجع_زبان_طراحی_واسط_کاربری_مبتنی_بر_ایکس_ام_ال/index.html @@ -0,0 +1,365 @@ +--- +title: مرجع زبان طراحی واسط کاربری مبتنی بر ایکس ام ال +slug: Archive/Mozilla/XUL/مرجع_زبان_طراحی_واسط_کاربری_مبتنی_بر_ایکس_ام_ال +translation_of: Archive/Mozilla/XUL/XUL_Reference +--- +<div dir="rtl"> + « <a href="/en-US/docs/XUL" title="en-US/XUL">XUL Reference</a> «</div> +<h2 dir="rtl" id="فهرست_الفبایی_عناصر_XUL">فهرست الفبایی عناصر XUL</h2> +<div class="cols-3"> + <ul> + <li><code><a href="/en-US/docs/XUL/action" title="XUL/action">action</a></code></li> + <li><code><a href="/en-US/docs/XUL/arrowscrollbox" title="XUL/arrowscrollbox">arrowscrollbox</a></code></li> + <li><code><a href="/en-US/docs/XUL/assign" title="XUL/assign">assign</a></code></li> + <li><code><a href="/en-US/docs/XUL/bbox" title="XUL/bbox">bbox</a></code></li> + <li><code><a href="/en-US/docs/XUL/binding" title="XUL/binding">binding</a></code></li> + <li><code><a href="/en-US/docs/XUL/bindings" title="XUL/bindings">bindings</a></code></li> + <li><code><a href="/en-US/docs/XUL/box" title="XUL/box">box</a></code></li> + <li><code><a href="/en-US/docs/XUL/broadcaster" title="XUL/broadcaster">broadcaster</a></code></li> + <li><code><a href="/en-US/docs/XUL/broadcasterset" title="XUL/broadcasterset">broadcasterset</a></code></li> + <li><code><a href="/en-US/docs/XUL/button" title="XUL/button">button</a></code></li> + <li><code><a href="/en-US/docs/XUL/browser" title="XUL/browser">browser</a></code></li> + <li><code><a href="/en-US/docs/XUL/checkbox" title="XUL/checkbox">checkbox</a></code></li> + <li><code><a href="/en-US/docs/XUL/caption" title="XUL/caption">caption</a></code></li> + <li><code><a href="/en-US/docs/XUL/colorpicker" title="XUL/colorpicker">colorpicker</a></code></li> + <li><code><a href="/en-US/docs/XUL/column" title="XUL/column">column</a></code></li> + <li><code><a href="/en-US/docs/XUL/columns" title="XUL/columns">columns</a></code></li> + <li><code><a href="/en-US/docs/XUL/commandset" title="XUL/commandset">commandset</a></code></li> + <li><code><a href="/en-US/docs/XUL/command" title="XUL/command">command</a></code></li> + <li><code><a href="/en-US/docs/XUL/conditions" title="XUL/conditions">conditions</a></code></li> + <li><code><a href="/en-US/docs/XUL/content" title="XUL/content">content</a></code></li> + <li><code><a href="/en-US/docs/XUL/datepicker" title="XUL/datepicker">datepicker</a></code></li> + <li><code><a href="/en-US/docs/XUL/deck" title="XUL/deck">deck</a></code></li> + <li><code><a href="/en-US/docs/XUL/description" title="XUL/description">description</a></code></li> + <li><code><a href="/en-US/docs/XUL/dialog" title="XUL/dialog">dialog</a></code></li> + <li><code><a href="/en-US/docs/XUL/dialogheader" title="XUL/dialogheader">dialogheader</a></code></li> + <li><code><a href="/en-US/docs/XUL/dropmarker" title="XUL/dropmarker">dropmarker</a></code></li> + <li><code><a href="/en-US/docs/XUL/editor" title="XUL/editor">editor</a></code></li> + <li><code><a href="/en-US/docs/XUL/grid" title="XUL/grid">grid</a></code></li> + <li><code><a href="/en-US/docs/XUL/grippy" title="XUL/grippy">grippy</a></code></li> + <li><code><a href="/en-US/docs/XUL/groupbox" title="XUL/groupbox">groupbox</a></code></li> + <li><code><a href="/en-US/docs/XUL/hbox" title="XUL/hbox">hbox</a></code></li> + <li><code><a href="/en-US/docs/XUL/iframe" title="XUL/iframe">iframe</a></code></li> + <li><code><a href="/en-US/docs/XUL/image" title="XUL/image">image</a></code></li> + <li><code><a href="/en-US/docs/XUL/key" title="XUL/key">key</a></code></li> + <li><code><a href="/en-US/docs/XUL/keyset" title="XUL/keyset">keyset</a></code></li> + <li><code><a href="/en-US/docs/XUL/label" title="XUL/label">label</a></code></li> + <li><code><a href="/en-US/docs/XUL/listbox" title="XUL/listbox">listbox</a></code></li> + <li><code><a href="/en-US/docs/XUL/listcell" title="XUL/listcell">listcell</a></code></li> + <li><code><a href="/en-US/docs/XUL/listcol" title="XUL/listcol">listcol</a></code></li> + <li><code><a href="/en-US/docs/XUL/listcols" title="XUL/listcols">listcols</a></code></li> + <li><code><a href="/en-US/docs/XUL/listhead" title="XUL/listhead">listhead</a></code></li> + <li><code><a href="/en-US/docs/XUL/listheader" title="XUL/listheader">listheader</a></code></li> + <li><code><a href="/en-US/docs/XUL/listitem" title="XUL/listitem">listitem</a></code></li> + <li><code><a href="/en-US/docs/XUL/member" title="XUL/member">member</a></code></li> + <li><code><a href="/en-US/docs/XUL/menu" title="XUL/menu">menu</a></code></li> + <li><code><a href="/en-US/docs/XUL/menubar" title="XUL/menubar">menubar</a></code></li> + <li><code><a href="/en-US/docs/XUL/menuitem" title="XUL/menuitem">menuitem</a></code></li> + <li><code><a href="/en-US/docs/XUL/menulist" title="XUL/menulist">menulist</a></code></li> + <li><code><a href="/en-US/docs/XUL/menupopup" title="XUL/menupopup">menupopup</a></code></li> + <li><code><a href="/en-US/docs/XUL/menuseparator" title="XUL/menuseparator">menuseparator</a></code></li> + <li><code><a href="/en-US/docs/XUL/notification" title="XUL/notification">notification</a></code></li> + <li><code><a href="/en-US/docs/XUL/notificationbox" title="XUL/notificationbox">notificationbox</a></code></li> + <li><code><a href="/en-US/docs/XUL/observes" title="XUL/observes">observes</a></code></li> + <li><code><a href="/en-US/docs/XUL/overlay" title="XUL/overlay">overlay</a></code></li> + <li><code><a href="/en-US/docs/XUL/page" title="XUL/page">page</a></code></li> + <li><code><a href="/en-US/docs/XUL/panel" title="XUL/panel">panel</a></code></li> + <li><code><a href="/en-US/docs/XUL/param" title="XUL/param">param</a></code></li> + <li><code><a href="/en-US/docs/XUL/popupset" title="XUL/popupset">popupset</a></code></li> + <li><code><a href="/en-US/docs/XUL/preference" title="XUL/preference">preference</a></code></li> + <li><code><a href="/en-US/docs/XUL/preferences" title="XUL/preferences">preferences</a></code></li> + <li><code><a href="/en-US/docs/XUL/prefpane" title="XUL/prefpane">prefpane</a></code></li> + <li><code><a href="/en-US/docs/XUL/prefwindow" title="XUL/prefwindow">prefwindow</a></code></li> + <li><code><a href="/en-US/docs/XUL/progressmeter" title="XUL/progressmeter">progressmeter</a></code></li> + <li><code><a href="/en-US/docs/XUL/query" title="XUL/query">query</a></code></li> + <li><code><a href="/en-US/docs/XUL/queryset" title="XUL/queryset">queryset</a></code></li> + <li><code><a href="/en-US/docs/XUL/radio" title="XUL/radio">radio</a></code></li> + <li><code><a href="/en-US/docs/XUL/radiogroup" title="XUL/radiogroup">radiogroup</a></code></li> + <li><code><a href="/en-US/docs/XUL/resizer" title="XUL/resizer">resizer</a></code></li> + <li><code><a href="/en-US/docs/XUL/richlistbox" title="XUL/richlistbox">richlistbox</a></code></li> + <li><code><a href="/en-US/docs/XUL/richlistitem" title="XUL/richlistitem">richlistitem</a></code></li> + <li><code><a href="/en-US/docs/XUL/row" title="XUL/row">row</a></code></li> + <li><code><a href="/en-US/docs/XUL/rows" title="XUL/rows">rows</a></code></li> + <li><code><a href="/en-US/docs/XUL/rule" title="XUL/rule">rule</a></code></li> + <li><code><a href="/en-US/docs/XUL/scale" title="XUL/scale">scale</a></code></li> + <li><code><a href="/en-US/docs/XUL/script" title="XUL/script">script</a></code></li> + <li><code><a href="/en-US/docs/XUL/scrollbar" title="XUL/scrollbar">scrollbar</a></code></li> + <li><code><a href="/en-US/docs/XUL/scrollbox" title="XUL/scrollbox">scrollbox</a></code></li> + <li><code><a href="/en-US/docs/XUL/scrollcorner" title="XUL/scrollcorner">scrollcorner</a></code></li> + <li><code><a href="/en-US/docs/XUL/separator" title="XUL/separator">separator</a></code></li> + <li><code><a href="/en-US/docs/XUL/spacer" title="XUL/spacer">spacer</a></code></li> + <li><code><a href="/en-US/docs/XUL/spinbuttons" title="XUL/spinbuttons">spinbuttons</a></code></li> + <li><code><a href="/en-US/docs/XUL/splitter" title="XUL/splitter">splitter</a></code></li> + <li><code><a href="/en-US/docs/XUL/stack" title="XUL/stack">stack</a></code></li> + <li><code><a href="/en-US/docs/XUL/statusbar" title="XUL/statusbar">statusbar</a></code></li> + <li><code><a href="/en-US/docs/XUL/statusbarpanel" title="XUL/statusbarpanel">statusbarpanel</a></code></li> + <li><code><a href="/en-US/docs/XUL/stringbundle" title="XUL/stringbundle">stringbundle</a></code></li> + <li><code><a href="/en-US/docs/XUL/stringbundleset" title="XUL/stringbundleset">stringbundleset</a></code></li> + <li><code><a href="/en-US/docs/XUL/tab" title="XUL/tab">tab</a></code></li> + <li><code><a href="/en-US/docs/XUL/tabbrowser" title="XUL/tabbrowser">tabbrowser</a> (Firefox-only starting with Firefox 3/Gecko 1.9)</code></li> + <li><code><a href="/en-US/docs/XUL/tabbox" title="XUL/tabbox">tabbox</a></code></li> + <li><code><a href="/en-US/docs/XUL/tabpanel" title="XUL/tabpanel">tabpanel</a></code></li> + <li><code><a href="/en-US/docs/XUL/tabpanels" title="XUL/tabpanels">tabpanels</a></code></li> + <li><code><a href="/en-US/docs/XUL/tabs" title="XUL/tabs">tabs</a></code></li> + <li><code><a href="/en-US/docs/XUL/template" title="XUL/template">template</a></code></li> + <li><code><a href="/en-US/docs/XUL/textnode" title="XUL/textnode">textnode</a></code></li> + <li><code><a href="/en-US/docs/XUL/textbox" title="XUL/textbox">textbox</a></code></li> + <li><code><a href="/en-US/docs/XUL/Textbox_(Toolkit_autocomplete)" title="XUL/textbox_(Firefox_autocomplete)">textbox (Firefox autocomplete)</a></code></li> + <li><code><a href="/en-US/docs/XUL/Textbox_(XPFE_autocomplete)" title="XUL/textbox_(Mozilla_autocomplete)">textbox (Mozilla autocomplete)</a></code></li> + <li><code><a href="/en-US/docs/XUL/timepicker" title="XUL/timepicker">timepicker</a></code></li> + <li><code><a href="/en-US/docs/XUL/titlebar" title="XUL/titlebar">titlebar</a></code></li> + <li><code><a href="/en-US/docs/XUL/toolbar" title="XUL/toolbar">toolbar</a></code></li> + <li><code><a href="/en-US/docs/XUL/toolbarbutton" title="XUL/toolbarbutton">toolbarbutton</a></code></li> + <li><code><a href="/en-US/docs/XUL/toolbargrippy" title="XUL/toolbargrippy">toolbargrippy</a></code></li> + <li><code><a href="/en-US/docs/XUL/toolbaritem" title="XUL/toolbaritem">toolbaritem</a></code></li> + <li><code><a href="/en-US/docs/XUL/toolbarpalette" title="XUL/toolbarpalette">toolbarpalette</a></code></li> + <li><code><a href="/en-US/docs/XUL/toolbarseparator" title="XUL/toolbarseparator">toolbarseparator</a></code></li> + <li><code><a href="/en-US/docs/XUL/toolbarset" title="XUL/toolbarset">toolbarset</a></code></li> + <li><code><a href="/en-US/docs/XUL/toolbarspacer" title="XUL/toolbarspacer">toolbarspacer</a></code></li> + <li><code><a href="/en-US/docs/XUL/toolbarspring" title="XUL/toolbarspring">toolbarspring</a></code></li> + <li><code><a href="/en-US/docs/XUL/toolbox" title="XUL/toolbox">toolbox</a></code></li> + <li><code><a href="/en-US/docs/XUL/tooltip" title="XUL/tooltip">tooltip</a></code></li> + <li><code><a href="/en-US/docs/XUL/tree" title="XUL/tree">tree</a></code></li> + <li><code><a href="/en-US/docs/XUL/treecell" title="XUL/treecell">treecell</a></code></li> + <li><code><a href="/en-US/docs/XUL/treechildren" title="XUL/treechildren">treechildren</a></code></li> + <li><code><a href="/en-US/docs/XUL/treecol" title="XUL/treecol">treecol</a></code></li> + <li><code><a href="/en-US/docs/XUL/treecols" title="XUL/treecols">treecols</a></code></li> + <li><code><a href="/en-US/docs/XUL/treeitem" title="XUL/treeitem">treeitem</a></code></li> + <li><code><a href="/en-US/docs/XUL/treerow" title="XUL/treerow">treerow</a></code></li> + <li><code><a href="/en-US/docs/XUL/treeseparator" title="XUL/treeseparator">treeseparator</a></code></li> + <li><code><a href="/en-US/docs/XUL/triple" title="XUL/triple">triple</a></code></li> + <li><code><a href="/en-US/docs/XUL/vbox" title="XUL/vbox">vbox</a></code></li> + <li><code><a href="/en-US/docs/XUL/where" title="XUL/where">where</a></code></li> + <li><code><a href="/en-US/docs/XUL/window" title="XUL/window">window</a></code></li> + <li><code><a href="/en-US/docs/XUL/wizard" title="XUL/wizard">wizard</a></code></li> + <li><code><a href="/en-US/docs/XUL/wizardpage" title="XUL/wizardpage">wizardpage</a></code></li> + </ul> +</div> +<h2 dir="rtl" id="فهرست_عناصر_طبقه_بندی_شده_XUL">فهرست عناصر طبقه بندی شده XUL</h2> +<div dir="rtl"> + « <a href="/en-US/docs/XUL" title="en-US/XUL">XUL Reference</a> «</div> +<h3 dir="rtl" id="پنجره_(ویندوز)">پنجره (ویندوز)</h3> +<div class="cols-3" dir="rtl"> + <ul> + <li><a href="/en-US/docs/XUL/window" title="XUL/window">window</a></li> + <li><a href="/en-US/docs/XUL/wizard" title="XUL/wizard">wizard</a></li> + <li><a href="/en-US/docs/XUL/wizardpage" title="XUL/wizardpage">wizardpage</a></li> + <li>titlebar</li> + </ul> +</div> +<h3 dir="rtl" id="ساختار_پنجره">ساختار پنجره</h3> +<div class="cols-3" dir="rtl"> + <ul> + <li>---</li> + </ul> +</div> +<h3 dir="rtl" id="منوها_و_پنجره_های_خودبازشو">منوها و پنجره های خودبازشو</h3> +<div class="cols-3" dir="rtl"> + <ul> + <li>---</li> + </ul> +</div> +<h3 dir="rtl" id="نوار_ابزار">نوار ابزار</h3> +<div class="cols-3" dir="rtl"> + <ul> + <li>toolbar</li> + <li>toolbarbutton</li> + <li>toolbargrippy</li> + <li>toolbaritem</li> + <li>toolbarpallete</li> + <li>toolbarseperator</li> + <li>toolbarspring</li> + </ul> +</div> +<h3 dir="rtl" id="سربرگ_ها_و_ابزارهای_گروه_بندی">سربرگ ها و ابزارهای گروه بندی</h3> +<div class="cols-3" dir="rtl"> + <ul> + <li>tab</li> + <li>tabbox</li> + <li>tabpanel</li> + <li>tabpanels</li> + <li>tabs</li> + </ul> +</div> +<h3 dir="rtl" id="کنترل_ها">کنترل ها</h3> +<div class="cols-3" dir="rtl"> + <ul> + <li>---</li> + </ul> +</div> +<h3 dir="rtl" id="متن_و_تصویر">متن و تصویر</h3> +<div class="cols-3" dir="rtl"> + <ul> + <li>label</li> + <li>caption</li> + <li>image</li> + </ul> +</div> +<h3 dir="rtl" id="فهرست_ها">فهرست ها</h3> +<div class="cols-3" dir="rtl"> + <ul> + <li>---</li> + </ul> +</div> +<h3 dir="rtl" id="ساختارهای_درختی">ساختارهای درختی</h3> +<div class="cols-3" dir="rtl"> + <ul> + <li>---</li> + </ul> +</div> +<h3 dir="rtl" id="آرایش">آرایش</h3> +<div class="cols-3" dir="rtl"> + <ul> + <li>---</li> + </ul> +</div> +<h3 dir="rtl" id="قالب_ها">قالب ها</h3> +<div class="cols-3" dir="rtl"> + <ul> + <li>---</li> + </ul> +</div> +<h3 dir="rtl" id="اسکریپت_ها">اسکریپت ها</h3> +<div class="cols-3" dir="rtl"> + <ul> + <li>---</li> + </ul> +</div> +<h3 dir="rtl" id="عناصر_کمکی">عناصر کمکی</h3> +<h2 dir="rtl" id="Other_XUL_lists" name="Other_XUL_lists">دیگر عناصر XUL</h2> +<div class="cols-3"> + <ul> + <li><a href="/en-US/docs/XUL/dialog" title="XUL/dialog">dialog</a></li> + <li><a href="/en-US/docs/XUL/overlay" title="XUL/overlay">overlay</a></li> + <li><a href="/en-US/docs/XUL/page" title="XUL/page">page</a></li> + <li><a href="/en-US/docs/XUL/window" title="XUL/window">window</a></li> + <li><a href="/en-US/docs/XUL/wizard" title="XUL/wizard">wizard</a></li> + <li><a href="/en-US/docs/XUL/wizardpage" title="XUL/wizardpage">wizardpage</a></li> + <li><a href="/en-US/docs/XUL/preference" title="XUL/preference">preference</a></li> + <li><a href="/en-US/docs/XUL/preferences" title="XUL/preferences">preferences</a></li> + <li><a href="/en-US/docs/XUL/prefpane" title="XUL/prefpane">prefpane</a></li> + <li><a href="/en-US/docs/XUL/prefwindow" title="XUL/prefwindow">prefwindow</a></li> + <li><a href="/en-US/docs/XUL/browser" title="XUL/browser">browser</a></li> + <li><a href="/en-US/docs/XUL/tabbrowser" title="XUL/tabbrowser">tabbrowser</a></li> + <li><a href="/en-US/docs/XUL/editor" title="XUL/editor">editor</a></li> + <li><a href="/en-US/docs/XUL/iframe" title="XUL/iframe">iframe</a></li> + <li><a href="/en-US/docs/XUL/titlebar" title="XUL/titlebar">titlebar</a></li> + <li><a href="/en-US/docs/XUL/resizer" title="XUL/resizer">resizer</a></li> + <li><a href="/en-US/docs/XUL/statusbar" title="XUL/statusbar">statusbar</a></li> + <li><a href="/en-US/docs/XUL/statusbarpanel" title="XUL/statusbarpanel">statusbarpanel</a></li> + <li><a href="/en-US/docs/XUL/dialogheader" title="XUL/dialogheader">dialogheader</a></li> + <li><a href="/en-US/docs/XUL/notification" title="XUL/notification">notification</a></li> + <li><a href="/en-US/docs/XUL/notificationbox" title="XUL/notificationbox">notificationbox</a></li> + <li><a href="/en-US/docs/XUL/menubar" title="XUL/menubar">menubar</a></li> + <li><a href="/en-US/docs/XUL/menu" title="XUL/menu">menu</a></li> + <li><a href="/en-US/docs/XUL/menuitem" title="XUL/menuitem">menuitem</a></li> + <li><a href="/en-US/docs/XUL/menuseparator" title="XUL/menuseparator">menuseparator</a></li> + <li><a href="/en-US/docs/XUL/menupopup" title="XUL/menupopup">menupopup</a></li> + <li><a href="/en-US/docs/XUL/panel" title="XUL/panel">panel</a></li> + <li><a href="/en-US/docs/XUL/tooltip" title="XUL/tooltip">tooltip</a></li> + <li><a href="/en-US/docs/XUL/popupset" title="XUL/popupset">popupset</a></li> + <li><a href="/en-US/docs/XUL/toolbar" title="XUL/toolbar">toolbar</a></li> + <li><a href="/en-US/docs/XUL/toolbarbutton" title="XUL/toolbarbutton">toolbarbutton</a></li> + <li><a href="/en-US/docs/XUL/toolbargrippy" title="XUL/toolbargrippy">toolbargrippy</a></li> + <li><a href="/en-US/docs/XUL/toolbaritem" title="XUL/toolbaritem">toolbaritem</a></li> + <li><a href="/en-US/docs/XUL/toolbarpalette" title="XUL/toolbarpalette">toolbarpalette</a></li> + <li><a href="/en-US/docs/XUL/toolbarseparator" title="XUL/toolbarseparator">toolbarseparator</a></li> + <li><a href="/en-US/docs/XUL/toolbarset" title="XUL/toolbarset">toolbarset</a></li> + <li><a href="/en-US/docs/XUL/toolbarspacer" title="XUL/toolbarspacer">toolbarspacer</a></li> + <li><a href="/en-US/docs/XUL/toolbarspring" title="XUL/toolbarspring">toolbarspring</a></li> + <li><a href="/en-US/docs/XUL/toolbox" title="XUL/toolbox">toolbox</a></li> + <li><a href="/en-US/docs/XUL/tabbox" title="XUL/tabbox">tabbox</a></li> + <li><a href="/en-US/docs/XUL/tabs" title="XUL/tabs">tabs</a></li> + <li><a href="/en-US/docs/XUL/tab" title="XUL/tab">tab</a></li> + <li><a href="/en-US/docs/XUL/tabpanels" title="XUL/tabpanels">tabpanels</a></li> + <li><a href="/en-US/docs/XUL/tabpanel" title="XUL/tabpanel">tabpanel</a></li> + <li><a href="/en-US/docs/XUL/groupbox" title="XUL/groupbox">groupbox</a></li> + <li><a href="/en-US/docs/XUL/caption" title="XUL/caption">caption</a></li> + <li><a href="/en-US/docs/XUL/separator" title="XUL/separator">separator</a></li> + <li><a href="/en-US/docs/XUL/spacer" title="XUL/spacer">spacer</a></li> + <li><a href="/en-US/docs/XUL/button" title="XUL/button">button</a></li> + <li><a href="/en-US/docs/XUL/checkbox" title="XUL/checkbox">checkbox</a></li> + <li><a href="/en-US/docs/XUL/colorpicker" title="XUL/colorpicker">colorpicker</a></li> + <li><a href="/en-US/docs/XUL/datepicker" title="XUL/datepicker">datepicker</a></li> + <li><a href="/en-US/docs/XUL/menulist" title="XUL/menulist">menulist</a></li> + <li><a href="/en-US/docs/XUL/progressmeter" title="XUL/progressmeter">progressmeter</a></li> + <li><a href="/en-US/docs/XUL/radio" title="XUL/radio">radio</a></li> + <li><a href="/en-US/docs/XUL/radiogroup" title="XUL/radiogroup">radiogroup</a></li> + <li><a href="/en-US/docs/XUL/scale" title="XUL/scale">scale</a></li> + <li><a href="/en-US/docs/XUL/splitter" title="XUL/splitter">splitter</a></li> + <li><a href="/en-US/docs/XUL/textbox" title="XUL/textbox">textbox</a></li> + <li><a href="/en-US/docs/XUL/Textbox_(Toolkit_autocomplete)" title="XUL/textbox_(Firefox_autocomplete)">textbox (Firefox autocomplete)</a></li> + <li><a href="/en-US/docs/XUL/Textbox_(XPFE_autocomplete)" title="XUL/textbox_(Mozilla_autocomplete)">textbox (Mozilla autocomplete)</a></li> + <li><a href="/en-US/docs/XUL/timepicker" title="XUL/timepicker">timepicker</a></li> + <li><a href="/en-US/docs/XUL/description" title="XUL/description">description</a></li> + <li><a href="/en-US/docs/XUL/label" title="XUL/label">label</a></li> + <li><a href="/en-US/docs/XUL/image" title="XUL/image">image</a></li> + <li><a href="/en-US/docs/XUL/listbox" title="XUL/listbox">listbox</a></li> + <li><a href="/en-US/docs/XUL/listitem" title="XUL/listitem">listitem</a></li> + <li><a href="/en-US/docs/XUL/listcell" title="XUL/listcell">listcell</a></li> + <li><a href="/en-US/docs/XUL/listcol" title="XUL/listcol">listcol</a></li> + <li><a href="/en-US/docs/XUL/listcols" title="XUL/listcols">listcols</a></li> + <li><a href="/en-US/docs/XUL/listhead" title="XUL/listhead">listhead</a></li> + <li><a href="/en-US/docs/XUL/listheader" title="XUL/listheader">listheader</a></li> + <li><a href="/en-US/docs/XUL/richlistbox" title="XUL/richlistbox">richlistbox</a></li> + <li><a href="/en-US/docs/XUL/richlistitem" title="XUL/richlistitem">richlistitem</a></li> + <li><a href="/en-US/docs/XUL/tree" title="XUL/tree">tree</a></li> + <li><a href="/en-US/docs/XUL/treecell" title="XUL/treecell">treecell</a></li> + <li><a href="/en-US/docs/XUL/treechildren" title="XUL/treechildren">treechildren</a></li> + <li><a href="/en-US/docs/XUL/treecol" title="XUL/treecol">treecol</a></li> + <li><a href="/en-US/docs/XUL/treecols" title="XUL/treecols">treecols</a></li> + <li><a href="/en-US/docs/XUL/treeitem" title="XUL/treeitem">treeitem</a></li> + <li><a href="/en-US/docs/XUL/treerow" title="XUL/treerow">treerow</a></li> + <li><a href="/en-US/docs/XUL/treeseparator" title="XUL/treeseparator">treeseparator</a></li> + <li><a href="/en-US/docs/XUL/box" title="XUL/box">box</a></li> + <li><a href="/en-US/docs/XUL/hbox" title="XUL/hbox">hbox</a></li> + <li><a href="/en-US/docs/XUL/vbox" title="XUL/vbox">vbox</a></li> + <li><a href="/en-US/docs/XUL/bbox" title="XUL/bbox">bbox</a></li> + <li><a href="/en-US/docs/XUL/deck" title="XUL/deck">deck</a></li> + <li><a href="/en-US/docs/XUL/stack" title="XUL/stack">stack</a></li> + <li><a href="/en-US/docs/XUL/grid" title="XUL/grid">grid</a></li> + <li><a href="/en-US/docs/XUL/columns" title="XUL/columns">columns</a></li> + <li><a href="/en-US/docs/XUL/column" title="XUL/column">column</a></li> + <li><a href="/en-US/docs/XUL/rows" title="XUL/rows">rows</a></li> + <li><a href="/en-US/docs/XUL/row" title="XUL/row">row</a></li> + <li><a href="/en-US/docs/XUL/scrollbox" title="XUL/scrollbox">scrollbox</a></li> + <li><a href="/en-US/docs/XUL/action" title="XUL/action">action</a></li> + <li><a href="/en-US/docs/XUL/assign" title="XUL/assign">assign</a></li> + <li><a href="/en-US/docs/XUL/binding" title="XUL/binding">binding</a></li> + <li><a href="/en-US/docs/XUL/bindings" title="XUL/bindings">bindings</a></li> + <li><a href="/en-US/docs/XUL/conditions" title="XUL/conditions">conditions</a></li> + <li><a href="/en-US/docs/XUL/content" title="XUL/content">content</a></li> + <li><a href="/en-US/docs/XUL/member" title="XUL/member">member</a></li> + <li><a href="/en-US/docs/XUL/param" title="XUL/param">param</a></li> + <li><a href="/en-US/docs/XUL/query" title="XUL/query">query</a></li> + <li><a href="/en-US/docs/XUL/queryset" title="XUL/queryset">queryset</a></li> + <li><a href="/en-US/docs/XUL/rule" title="XUL/rule">rule</a></li> + <li><a href="/en-US/docs/XUL/template" title="XUL/template">template</a></li> + <li><a href="/en-US/docs/XUL/textnode" title="XUL/textnode">textnode</a></li> + <li><a href="/en-US/docs/XUL/triple" title="XUL/triple">triple</a></li> + <li><a href="/en-US/docs/XUL/where" title="XUL/where">where</a></li> + <li><a href="/en-US/docs/XUL/script" title="XUL/script">script</a></li> + <li><a href="/en-US/docs/XUL/commandset" title="XUL/commandset">commandset</a></li> + <li><a href="/en-US/docs/XUL/command" title="XUL/command">command</a></li> + <li><a href="/en-US/docs/XUL/broadcaster" title="XUL/broadcaster">broadcaster</a></li> + <li><a href="/en-US/docs/XUL/broadcasterset" title="XUL/broadcasterset">broadcasterset</a></li> + <li><a href="/en-US/docs/XUL/observes" title="XUL/observes">observes</a></li> + <li><a href="/en-US/docs/XUL/key" title="XUL/key">key</a></li> + <li><a href="/en-US/docs/XUL/keyset" title="XUL/keyset">keyset</a></li> + <li><a href="/en-US/docs/XUL/stringbundle" title="XUL/stringbundle">stringbundle</a></li> + <li><a href="/en-US/docs/XUL/stringbundleset" title="XUL/stringbundleset">stringbundleset</a></li> + <li><a href="/en-US/docs/XUL/scrollbar" title="XUL/scrollbar">arrowscrollbox</a></li> + <li><a href="/en-US/docs/XUL/dropmarker" title="XUL/dropmarker">dropmarker</a></li> + <li><a href="/en-US/docs/XUL/grippy" title="XUL/grippy">grippy</a></li> + <li><a href="/en-US/docs/XUL/scrollbar" title="XUL/scrollbar">scrollbar</a></li> + <li><a href="/en-US/docs/XUL/scrollcorner" title="XUL/scrollcorner">scrollcorner</a></li> + <li><a href="/en-US/docs/XUL/spinbuttons" title="XUL/spinbuttons">spinbuttons</a></li> + <li><a href="/en-US/docs/XUL/Attribute" title="XUL/Attribute">All attributes</a></li> + <li><a href="/en-US/docs/XUL/Property" title="XUL/Property">All properties</a></li> + <li><a href="/en-US/docs/XUL/Method" title="XUL/Method">All methods</a></li> + <li><a href="/en-US/docs/XUL_element_attributes" title="XUL_element_attributes">Attributes defined for all XUL elements</a></li> + <li><a href="/en-US/docs/XUL/Style" title="XUL/Style">Style classes</a></li> + <li><a href="/en-US/docs/XUL/Events" title="XUL/Events">Event handlers</a></li> + <li><a href="/en-US/docs/XUL/Deprecated_and_defunct_markup" title="XUL/Deprecated//Defunct_Markup">Deprecated/Defunct Markup</a></li> + </ul> +</div> diff --git a/files/fa/archive/web/index.html b/files/fa/archive/web/index.html new file mode 100644 index 0000000000..ce3481b9ae --- /dev/null +++ b/files/fa/archive/web/index.html @@ -0,0 +1,81 @@ +--- +title: Archived open Web documentation +slug: Archive/Web +tags: + - Archive + - Landing + - NeedsTranslation + - TopicStub + - Web +translation_of: Archive/Web +--- +<div class="hidden">{{IncludeSubnav("/en-US/docs/Archive")}}</div> + +<div>{{Obsolete_Header}}</div> + +<p class="summary">The documentation listed below is archived, obsolete material about open Web topics.</p> + +<div class="row topicpage-table"> +<div class="section"> +<dl> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Web/Talk:CSS_background-size">Talk:background-size</a></dt> + <dd class="landingPageList">Should not the "Browser compatibility" table also list Google Chrome and Konqueror? Chome is not mentioned at all, but is becoming increasingly popular. Konqueror is listed <em>below</em> the table, which seems inconsistent. <a href="/User:Znerd" rel="custom nofollow">Znerd</a> 04 August 2009</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Web/Browser_Detection_and_Cross_Browser_Support">Browser Detection and Cross Browser Support</a></dt> + <dd class="landingPageList">Improper browser detection can lead to web maintenance nightmares. Rethinking the basics of when and how to detect user agents is crucial to creating maintainable, cross browser web content. This article reviews several approaches to browser detection, their usefulness in specific circumstances to arrive at a common sense approach to browser detection.</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Web/Browser_feature_detection">Browser Feature Detection</a></dt> + <dd class="landingPageList">An experimental approach to discovering degree of support for Standards</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Web/CSS">CSS</a></dt> + <dd class="landingPageList">Obsolete CSS features</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Web/Displaying_notifications_(deprecated)">Displaying notifications (deprecated)</a></dt> + <dd class="landingPageList">Firefox offers support for "desktop notifications"; these are notifications that are displayed to the user outside the context of the web content, using the standard notification system provided by the operating system.</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Web/E4X">E4X</a></dt> + <dd class="landingPageList"><strong>ECMAScript for XML</strong> (<strong>E4X</strong>) is a programming language extension that adds native XML support to <a href="/en-US/docs/JavaScript" title="JavaScript">JavaScript</a>. It does this by providing access to the XML document in a form that feels natural for ECMAScript programmers. The goal is to provide an alternative, simpler syntax for accessing XML documents than via <a href="/en-US/docs/DOM" title="DOM">DOM</a> interfaces. A valid alternative to E4X is a non-native <a href="/en-US/docs/JXON" title="JXON">JXON algorithm</a>.</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Web/E4X_tutorial">E4X Tutorial</a></dt> + <dd class="landingPageList">This tutorial walks you through the basic syntax of <strong>E4X (ECMAScript for XML)</strong>. With E4X, programmers can manipulate an <a href="/en-US/docs/XML" title="XML">XML</a> document with a syntax more familiar to <a href="/en-US/docs/JavaScript" title="JavaScript">JavaScript</a> programming.</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Web/Talk:JavaScript_Reference_Global_Objects_Array_forEach">Talk:Array.forEach()</a></dt> + <dd class="landingPageList">Ok, in the end I didn't remove the old code as it isn't hosted anywhere (I thought the github reference contained the code) but inserted a faster implementation above while retaining the rest of the document.</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Web/Iterator">Iterator</a></dt> + <dd class="landingPageList">The <code><strong>Iterator</strong></code> function returns an object which implements legacy iterator protocol and iterates over enumerable properties of an object.</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Web/LiveConnect">LiveConnect</a></dt> + <dd class="landingPageList">(Please update or remove as needed.)</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Web/MSX_Emulator_(jsMSX)">MSX Emulator (jsMSX)</a></dt> + <dd class="landingPageList"> </dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Web/Old_Proxy_API">Old Proxy API</a></dt> + <dd class="landingPageList">Proxies are objects for which the programmer has to define the semantics in JavaScript. The default object semantics are implemented in the JavaScript engine, often written in lower-level languages like C++. Proxies let the programmer define most of the behavior of an object in JavaScript. They are said to provide a <strong>meta-programming API</strong>.</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Web/ParallelArray">ParallelArray</a></dt> + <dd class="landingPageList">The goal of <strong><code>ParallelArray</code></strong> was to enable data-parallelism in web applications. The higher-order functions available on <code>ParallelArray</code> attempted to execute in parallel, though they may fall back to sequential execution if necessary. To ensure that your code executes in parallel, it is suggested that the functions should be limited to the <a href="http://smallcultfollowing.com/babysteps/blog/2013/04/30/parallelizable-javascript-subset/">parallelizable subset of JS that Firefox supports</a>.</dd> +</dl> + +<dl> +</dl> +</div> + +<div class="section"> +<dl> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Web/Properly_Using_CSS_and_JavaScript_in_XHTML_Documents_">Properly Using CSS and JavaScript in XHTML Documents</a></dt> + <dd class="landingPageList"><a class="external" href="http://www.w3.org/TR/xhtml1">XHTML™ 1.0 The Extensible HyperText Markup Language (Second Edition)</a> defines XHTML to be a reformulation of HTML 4 as an XML 1.0 application.</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Web/Talk:JavaScript_Reference">Talk:JavaScript Reference</a></dt> + <dd class="landingPageList">The guide section links to an interesting document discussing how to create and use private variables in objects, which is great if you want to protect the various properties within an object from being poked at accidentally. I also just read a document on proper inheritance using apply(). Well if you combine the two, you can have inherited private variables:</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Web/Scope_Cheatsheet">Scope Cheatsheet</a></dt> + <dd class="landingPageList">JavaScript with Mozilla extensions has both function-scoped <strong><code>var</code></strong>s and block-scoped <strong><code>let</code></strong>s. Along with hoisting and dynamic behavior, scope in JavaScript is sometimes surprising.</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Web/Server-Side_JavaScript">Server-Side JavaScript</a></dt> + <dd class="landingPageList">Here's a radical idea: Use one language to write entire Web apps -- the same language which billions of web pages already use, every day.</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Web/Sharp_variables_in_JavaScript">Sharp variables in JavaScript</a></dt> + <dd class="landingPageList">A sharp variable is a syntax in object initializers that allows serialization of objects that have cyclic references or multiple references to the same object.</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Web/Standards-Compliant_Authoring_Tools">Standards-Compliant Authoring Tools</a></dt> + <dd class="landingPageList">Creating cross-browser code upfront will save you lots of time quality testing your web content. The following authoring tools adhere to the W3 standards. If you're using older versions of tools that rely on old browser bugs or generate browser-specific code, it may be time to upgrade:</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Web/StopIteration">StopIteration</a></dt> + <dd class="landingPageList">The <code><strong>StopIteration</strong></code> object was used to tell the end of the iteration in the legacy iterator protocol. Do not use this ancient feature.</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Web/Styling_the_Amazing_Netscape_Fish_Cam_Page">Styling the Amazing Netscape Fish Cam Page</a></dt> + <dd class="landingPageList"> </dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Web/IndexedDB_API_Using_JavaScript_Generators_in_Firefox">Using JavaScript Generators in Firefox</a></dt> + <dd class="landingPageList">Generators can be used to simplify asynchronous code in Firefox by opting in to using JavaScript version 1.7 or later. You can opt in in HTML as follows:</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Web/Window.importDialog">Window.importDialog()</a></dt> + <dd class="landingPageList">Because opening windows on mobile isn't necessarily appropriate, the Firefox Mobile team designed the <code>importDialog()</code> method to replace <a href="/en-US/docs/Web/API/Window/openDialog" title="window.openDialog() is an extension to window.open(). It behaves the same, except that it can optionally take one or more parameters past windowFeatures, and windowFeatures itself is treated a little differently."><code>window.openDialog()</code></a>. Instead of opening a new window, it merges the specified XUL dialog into the main window.</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Web/Writing_JavaScript_for_HTML">Writing JavaScript for XHTML</a></dt> + <dd class="landingPageList">Technical review completed. Editorial review completed.</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Web/XForms">XForms</a></dt> + <dd class="landingPageList"><strong>XForms</strong> were envisioned as the future of online forms as envisioned by the W3C. Drawing on other W3C standards like <a href="/en/XML_Schema" title="en/XML_Schema">XML Schema</a>, <a href="/en/XPath" title="en/XPath">XPath</a>, and <a href="/en/XML_Events" title="en/XML_Events">XML Events</a>, XForms tried to address some of the limitations of the current <a href="/en/HTML" title="en/HTML">HTML</a> forms model. However, XForms never gained traction and is now considered obsolete.</dd> +</dl> +</div> +</div> diff --git a/files/fa/archive/web/server-side_javascript/index.html b/files/fa/archive/web/server-side_javascript/index.html new file mode 100644 index 0000000000..5969623300 --- /dev/null +++ b/files/fa/archive/web/server-side_javascript/index.html @@ -0,0 +1,17 @@ +--- +title: Server-Side JavaScript +slug: Archive/Web/Server-Side_JavaScript +tags: + - NeedsTranslation + - TopicStub +translation_of: Archive/Web/Server-Side_JavaScript +--- +<p>Here's a radical idea: Use one language to write entire Web apps -- the same language which billions of web pages already use, every day.</p> + +<p>Sounds obvious, but for at least the first twelve years of the Web's evolution, developers have pretty much had to use different languages on the server from those available in the browser, leading to segregated teams, disparate and inconsistent know-how, and plenty of server-side <span style="line-height: 1.572;">string manipulation</span><span style="line-height: 1.572;"> gymnastics to generate HTML or Ajax pages. </span></p> + +<p><span style="line-height: 1.572;">The simplicity of using JavaScript on the server was part of Netscape's original vision back in the day with Netscape LiveWire. But back then, 350 MHz servers were the best you could buy, and Mozilla was yet to emerge from the Netscape organization to continue to advance the state of Web technologies. Today with computing cycles having increased more than 10-fold and Mozilla's work on </span><a class="internal" href="/en/Rhino" style="line-height: 1.572;" title="En/Rhino">Rhino </a><span style="line-height: 1.572;">(JavaScript interpreter in Java) and </span><a class="internal" href="/en/SpiderMonkey" style="line-height: 1.572;" title="En/SpiderMonkey">SpiderMonkey </a><span style="line-height: 1.572;">(JavaScript interpreter in C) and </span><a class="internal" href="/en/JavaScript" style="line-height: 1.572;" title="En/JavaScript">JavaScript </a><span style="line-height: 1.572;">itself, we have very solid foundations for JavaScript to be extraordinarily useful and applicable on the server-side again -- with </span><a class="external" href="http://www.aptana.com/jaxer/benchmarks" style="line-height: 1.572;" title="http://www.aptana.com/jaxer/benchmarks">performance in the same range</a><span style="line-height: 1.572;"> as popular server-side environments like PHP and Ruby on Rails. </span></p> + +<p><span style="line-height: 1.572;">Now, with </span><a class="external" href="https://brendaneich.com/2008/08/tracemonkey-javascript-lightspeed/" style="line-height: 1.572;" title="http://weblogs.mozillazine.org/roadmap/archives/2008/08/tracemonkey_javascript_lightsp.html">TraceMonkey</a><span style="line-height: 1.572;"> available, JavaScript (both client side and server-side) can see 20x to 40x speed improvements according to Brendan Eich, Mozilla CTO and creator of JavaScript. Server-Side JavaScript is another way in which, as </span><a class="external" href="http://arstechnica.com/news.ars/post/20080822-firefox-to-get-massive-javascript-performance-boost.html" style="line-height: 1.572;" title="http://arstechnica.com/news.ars/post/20080822-firefox-to-get-massive-javascript-performance-boost.html">this article quotes</a><span style="line-height: 1.572;"> Eich, "Mozilla wants to 'get people thinking about JavaScript as a more general-purpose language' and show them that 'it really is a platform for writing full applications.'"</span></p> + +<p><a class="external" href="http://en.wikipedia.org/wiki/SSJS" title="http://en.wikipedia.org/wiki/SSJS">Many vendors</a> today are embedding Mozilla Rhino or Mozilla SpiderMonkey into Web server environments. Some, like Aptana with the open source <a class="external" href="http://www.aptana.com/jaxer" title="http://www.aptana.com/jaxer">Jaxer server</a> actually embed the entire Mozilla Firefox browser engine (including SpiderMonkey) within a Web server to enable server-side Ajax and server-side DOM access in addition to server-side execution of JavaScript.</p> diff --git a/files/fa/archive/web/server-side_javascript/راهنما/index.html b/files/fa/archive/web/server-side_javascript/راهنما/index.html new file mode 100644 index 0000000000..ddd898c081 --- /dev/null +++ b/files/fa/archive/web/server-side_javascript/راهنما/index.html @@ -0,0 +1,557 @@ +--- +title: 'بازگشت به سرور: اوج گیری جاوا اسکریپت سمت سرور' +slug: Archive/Web/Server-Side_JavaScript/راهنما +translation_of: Archive/Web/Server-Side_JavaScript/Walkthrough +--- +<p dir="rtl"><em><font color="#000000"><font face="Times New Roman, serif"><font size="3">نوشته ی: دیوی واترسن، معمار جاوا اسکریپت، آپتانا</font></font></font></em></p> + +<p dir="rtl"><font color="#000000" face="Times New Roman, serif" size="3"><em>شکی نیست که جاوا اسکریپت پرکاربردترین زبان سمت کاربر در وب است. فارغ از این که بک اند برنامه تحت وب شما چگونه پیاده سازی شده، در سمت کاربر برای انجام (تقریبا) هر کاری از جاوا اسکریپت استفاده می کنید: از اعتبارسنجی فرم تا یک برنامه سراسر Ajax. حالا تصور کنید که می توانید با جاوا اسکریپت سمت سروربرنامه های وب خود را نیز توسعه دهید. آیا امکان استفاده از یک زبان برای سمت سرور و کاربر زندگی را برای ما توسعه دهندگان آسان تر نمی کند؟</em></font></p> + +<p dir="rtl"><strong>چرخه ی کامل</strong></p> + +<p dir="rtl">اگر شما بخشی از انفجار بزرگ وب در اواسط دههی 1990 بودهاید شاید به یاد داشته باشید که (ایدهی) استفاده از جاوا اسکریپت در هر دو سمت سرور و کاربر، هستهی اصلی نگرش نتاسکیپ برای برنامههای وب بود. «نت اسکیپ لایو وایر» نخستین موتور جاوا اسکریپت سمت سرور بود. اکنون با گذشت بیش از 10 سال و تبدیل گروه تکنولوژی نت اسکیپ به بنیاد موزیلا، جاوا اسکریپت سمت سرور با توجه به افزایش بیش از 10 برابری قدرت پردازندههای امروزی به نسبت پردازنده های اواسط دهه ی 90 در پردازش جاوااسکریپت، کار توسعه دهندگان وب را آسانتر کرده و به همین دلیل شاهد تجدید حیاتی بزرگ است. همانند گذشته این تیم موزیلا است که در مرکز این سیر تکاملی وب قرار دارد. بنا بر گفته ی <a href="http://en.wikipedia.org/wiki/Brendan_Eich">Brendan Erich</a> مدیر فنی موزیلا و خالق جاوا اسکریپت، موتور بعدی جاوا اسکریپت موزیلا با نام <a href="https://wiki.mozilla.org/JavaScript:TraceMonkey">TraceMonkey</a> می تواند کارآیی جاوا اسکریپت را 20 تا 40 برابر بیشتر کند. در پیشرفت های اخیر شاهد ظهور موتورهای دیگری مانند <a href="http://code.google.com/p/v8/">V8 از گوگل</a> و <a href="http://trac.webkit.org/wiki/SquirrelFish">squirrelfish</a> از webKit برای جاوا اسکریپت بوده ایم. این موتورها استانداردهای کارآیی را ارتقاء داده و به حفظ فضای رقابتی کمک میکنند و باعث هدایت رقابت به سمت بخشهای مرتبط با کارآیی تمام استفادههای اصلی جاوا اسکریپت می شود.</p> + +<p dir="rtl">در حال حاضر دو موتور اصلی جاوا اسکریپت در سمت سرور استفاده می شوند و هر دو برآمده از موزیلا هستند: «موزیلا راینو» و «موزیلا اسپایدر مانکی». «راینو» یک مفسر جاوا اسکریپت است که با جاوا نوشته شده و می تواند پلی میان جاوا اسکریپت و جاوای سمت سرور باشد. «استیو یگ» از گوگل کارهای جالبی با این موتور انجام داده. از سوی دیگر «اسپایدر مانکی» موتور جاوا اسکریپت است (که با C نوشته شده) و در مرورگر محبوب فایرفاکس استفاده شده. «اسپایدر مانکی» پس از تکامل تبدیل به «تریس مانکی» خواهد شد. همچنین Jaxer «سرور Ajax» (پروژهای که در آپتانا کار کردهام) نمونه ای از SSJS است که نه تنها از «اسپایدر مانکی» استفاده میکند بلکه </p> + +<p lang="en-US" style="margin-bottom: 0in; font-style: normal;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3"><span style="background: transparent none repeat scroll 0% 0%;"><span style="font-style: normal;"><span lang="en-US"><font size="3"><font color="#000000">but also embeds the entire Firefox browser engine in the application server such that you can do server-side DOM manipulation and other Ajaxy things server-side that Rhino was not built to do.</font></font></span></span></span></font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in; font-style: normal;"> </p> + +<p lang="en-US" style="margin-bottom: 0in; font-style: normal;"><font color="#000000"><font face="Times New Roman, serif"><font size="3"><span style="background: transparent none repeat scroll 0% 0%;">Let's take a look at various SSJS implementations and some examples of putting them to use.</span></font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in; font-style: normal;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="4"><strong>Server-Side JavaScript (SSJS) via Embedded JavaScript Engines</strong></font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">The extension of JavaScript to the server is made possible via embedded JavaScript engines. The two most well established engines are SpiderMonkey and Rhino, both currently maintained by the Mozilla Foundation. SpiderMonkey is the code name for the first ever JavaScript engine, an open source C implementation which can be found embedded in leading software products such as Mozilla Firefox, Adobe Acrobat, and Aptana Jaxer. Rhino is a Java implementation of JavaScript which is commonly embedded in Java applications to expose scripting capability. The Helma web application framework is an example of Rhino in use. The Dojo Toolkit also has capabilities that run in Rhino. Let’s take a closer look at Rhino and its importance to the JavaScript developer.</font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">Rhino offers a unique opportunity for the JavaScript developer to tap into the power of Java classes using JavaScript. Armed with some basic Java knowledge, you can extend JavaScript to include some of the most desired capability such as database access, remote web requests, and XML processing. We’ll start by taking a look at querying a SQL database. </font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">This first example we’ll demonstrate is querying a mySQL database for some employee contact information. It is assumed that you have already downloaded, extracted, and consumed the necessary documentation to get up and running with some basic Rhino scripts. If you don’t already have it, you’ll need to also download the <font color="#000080"><u><a class="external" href="http://dev.mysql.com/downloads/connector/j/5.0.html">JDBC driver for mySQL</a></u></font>, extract the class files, and include the path in your CLASSPATH environment variable. The code in Listing 1 is a sample JavaScript script which incorporates Java classes to handle the database query.</font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">Listing 1 - Querying a mySQL database from Rhino</font></font></font></p> + +<pre class="eval">// import the java sql packages +importPackage( java.sql ); + +// load the mySQL driver +java.lang.Class.forName( "com.mysql.jdbc.Driver" ); + +// create connection to the database +var conn = DriverManager.getConnection( "jdbc:<a class="external" rel="freelink">mysql://localhost/rhino</a>", "uRhino", "pRhino" ); + +// create a statement handle +var stmt = conn.createStatement(); + +// get a resultset +var rs = stmt.executeQuery( "select * from employee" ); + +// get the metadata from the resultset +var meta = rs.getMetaData(); + +// loop over the records, dump out column names and values +while( rs.next() ) { + for( var i = 1; i <= meta.getColumnCount(); i++ ) { + print( meta.getColumnName( i ) + ": " + rs.getObject( i ) + "\n" ); + } + print( "----------\n" ); +} + +// cleanup +rs.close(); +stmt.close(); +conn.close();</pre> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">This code starts off by using a Rhino function named <em>importPackage</em> which is just like using the <em>import</em> statement in Java. Here, we’re including all the classes in the <em>java.sql</em> namespace in the script. The appropriate database driver for mySQL is loaded and the connection string to a database named <em>rhino</em> on my local machine is configured using the user account <em>uRhino</em> with the password of <em>pRhino</em>. The SQL statement is prepared, executed, and printed with the help of the metadata obtained from the resultset. Sample output is shown in Listing 2.</font></font></font></p> + +<pre class="eval">id: 1 +first_name: Sammy +last_name: Hamm +department: IT +title: Network Administrator +---------- +id: 2 +first_name: Nigel +last_name: Bitters +department: Finance +title: Accounting Manager +... +</pre> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">It’s clear to see that with just a few lines of code, we can easily take advantage of SQL data stores in JavaScript. The sample script in Listing 1 could be factored out to it’s own function to retrieve the set of employee information, or abstracted further into a more generic data handler class. Next we’ll take a look at another powerful feature in Rhino, E4X processing.</font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">E4X (ECMAScript for XML) is an extension of JavaScript which provides direct support for XML, greatly simplifying the process of consuming XML via JavaScript. Rhino’s support of this important standard eliminates the pain of using DOM or SAX based parsers in Java. Listing 3 below details a script used to process an RSS feed from the Mozilla website.</font></font></font></p> + +<pre class="eval">importPackage( java.net ); + +// connect to the remote resource +var u = new URL( "<a class="external" href="http://www.mozilla.org/news.rdf" rel="freelink">http://www.mozilla.org/news.rdf</a>" ); +var c = u.openConnection(); +c.connect(); + +// read in the raw data +var s = new java.io.InputStreamReader( c.getInputStream() ); +var b = new java.io.BufferedReader( s ); +var l, str = ""; + +while( ( l = b.readLine() ) != null ) { + // skip + if( l != "" ) { + str = str + l + "\n"; + } +} +// define the namespaces, first the default, +// then additional namespaces +default xml namespace = "<a class="external" href="http://purl.org/rss/1.0/" rel="freelink">http://purl.org/rss/1.0/</a>"; +var dc = new Namespace( "<a class="external" href="http://purl.org/dc/elements/1.1/" rel="freelink">http://purl.org/dc/elements/1.1/</a>" ); +var rdf = new Namespace( "<a class="external" href="http://www.w3.org/1999/02/22-rdf-syntax-ns#" rel="freelink">http://www.w3.org/1999/02/22-rdf-syntax-ns#</a>" ); + +// use e4x to process the feed +var x = new XML( str ); +for each( var i in x..item ) { + print( "Title: " + i.title + "\n" ); + print( "About: " + i.@rdf::about + "\n" ); + print( "Link: " + i.link + "\n" ); + print( "Date: " + i.dc::date + "\n" ); +} +</pre> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">The first half of this script is standard Java code used to retrieve the feed data. After the asset is retrieved and stored in a string, the proper namespaces are defined for this particular resource. The default namespace is defined along with two others, in particular <strong>dc</strong> and <strong>rdf</strong>. Defining these namespaces becomes important if we want to be able to access any data elements in the feed defined in these namespaces. </font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">The act of creating an E4X object is quite simple, in the case of Listing 3, we do this through the line</font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Courier New, monospace"><font size="2">var x = new XML( str );</font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">From here, the XML is accessible via dot notation. Notice during the processing of the <em>item</em> element where we use the <em>rdf</em> and <em>dc</em> namespace to access the <em>about</em> attribute of the <em>item</em> element, and the <em>date</em> element respectively. The syntax for accessing E4X objects is actually quite natural and certainly easier than most methods.</font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">JavaScript engines such as Rhino and SpiderMonkey on their own have proven to be a useful and powerful tool to the developer. However, taking advantage of frameworks such as Aptana Jaxer (SpiderMonkey) and Helma (Rhino) can reveal even greater rewards as a great deal of work has already been done for you. All you need to do is implement the JavaScript. Let’s take a closer look on the SpiderMonkey side with Jaxer.</font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">As stated earlier, Aptana Jaxer is built using the Mozilla Browser Engine engine that powers Mozilla Firefox, which includes SpiderMonkey as its JavaScript interpreter, but lots more features beyond SSJS alone such as DOM, DB, File IO, CSS, server sessions, E4X, etc...] This is a great advantage to the developer as it presents a consistent server-side and client-side development environment for both browser and server contexts that is centered on open source and Web standards. Also since you know which engine you're targeting, you're free to confidently use advanced built in controls such as XML processing via E4X, XPath, and XSLT. Let's take a tour through some of the top features of Jaxer through code examples.</font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3"><strong><font size="4">Jaxer – Server-Side Ajax via the Firefox Browser Engine on the server</font></strong></font></font></font> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">Although server-side JavaScript is not a new concept, Jaxer implements it in a unique fashion. By taking advantage of current ScriptMonkey and Ajax capabilities not to mention the loads of other features packed into the Mozilla Firefox Browser Engine, Aptana Jaxer fuses the client-side with the server-side, creating a unified “same language” development platform. Where once you would need to master not only JavaScript for the client-side but also some flavor of a server-side Web language, Jaxer puts all the rich capability of a server-side language into JavaScript. This accounts for added simplicity and promotes rapid development methodologies.</font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3"><strong>Managing Context</strong></font></font></font> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">To take advantage of all the operating contexts of Jaxer, you'll need to specify how your scripts should behave using the runat attribute of the script tag (or by setting a runat property on a JavaScript function object). The common values for this attribute are explained below, though there are more than just these.</font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<ul> + <li> + <p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3"><strong>runat=”client”</strong> – Code contained in this block is restricted to execution client-side, which is also what happens if no <font face="Courier New">runat</font> attribute is specified.</font></font></font></p> + </li> + <li> + <p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3"><strong>runat=”server”</strong> – Code contained in this block is restricted to execution server-side.</font></font></font></p> + </li> + <li> + <p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3"><strong>runat=”both”</strong> – Code may be invoked on the client or server side.</font></font></font></p> + </li> + <li> + <p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3"><strong>runat=”server-proxy”</strong> – Allows for the exposure of server-side JavaScript functions to the browser. Jaxer manages Ajax calls behind the scenes to accomplish this.</font></font></font></p> + </li> +</ul> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">While most of the <font size="2"><font face="Courier New, monospace">runat</font></font> attribute values above are self explanatory, the <font size="2"><font face="Courier New">server-proxy</font></font> concept is best explained through example. Consider the code in Listing 4.</font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in; font-style: normal;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">Listing 4 - Demonstration of server and client context</font></font></font></p> + +<pre class="eval"><script runat="server"> +function exposed() { + return "exposed to the browser"; +} + +function notExposed() { + return "can't see me!"; +} +</script> + + +<script runat="client"> +alert( exposed() ); +alert( notExposed() ); +</script> +</pre> + +<p><span style="font-family: courier new;">There are two blocks of scripts defined, one with runat set to server and the other set to client. This creates a strict separation of the two environments. As it stands, the code in the client block would throw an error since the server-side JavaScript is not within scope. If you intend to allow the execution of server-side JavaScript from the client-side, you can correct the code in listing 1 by doing one of three things.</span></p> + +<ol> + <li> + <p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">Change the <font size="2"><font face="Courier New">runat</font></font> attribute value of <font face="Courier New">server</font> to <font face="Courier New">server-proxy</font>.</font></font></font></p> + </li> + <li> + <p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">Add a statement inside the server-side script block to expose a particular server-side function to the browser. This statement is of the form<em> <strong><functionName></strong></em><strong>.proxy = true</strong>.</font></font></font></p> + </li> + <li> + <p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">Ensure the server-side function name is contained within the <strong>Jaxer.proxies </strong>array.</font></font></font></p> + </li> +</ol> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">Generally it's a best practice to use either the second or third strategy since in this case you are exposing only what's needed to the client. See Listing 5 for an update to Listing 1 to reflect this.</font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">Listing 5 - Demonstration of server-proxy</font></font></font></p> + +<pre class="eval"><script runat="server"> +function notExposed() { + // runs on the server, hidden from the browser + return "can't see me!"; +} + +function exposed() { + // runs on the server, callable from the browser + return "exposed to the browser"; +} +exposed.proxy = true; // tell Jaxer this function is ok to be called from the browser +</script> + +<script runat="client" type="text/javascript"> +alert( exposed() ); //works like a charm +alert( notExposed() ); //produces an object not found error since it server-side only +</script> +</pre> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">Understanding the concept of operating context in Jaxer is central to moving forward with the example application which is what we'll examine next.</font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="4"><strong>Jaxer – Example Application</strong></font></font></font> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">The example application consists of a simple form used to accept comments from public users and was built to cover some of the most useful Jaxer features. The example application is running under Jaxer build 0.9.7.2472 and also incorporates the ExtJS version 2.1 JavaScript framework for user interface controls. For more information how to obtain and install these products, refer to the resources section.</font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3"><strong>Single Page Applications</strong></font></font></font> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">The first feature the application demonstrates is the concept of a single page application. Since Jaxer allows you to define which code is reserved for the server-side, which code stays on the client-side, and which code is shared between the two, it's very possible to produce a single page application which could also include any number of external assets such as a popular third party framework. Listing 6 shows the beginning of our application which takes advantage of some of these concepts.</font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">Listing 6 - Creating the User Interface</font></font></font></p> + +<pre><link href="/jaxer_examples/js/ext-2.1/resources/css/ext-all.css" type="text/css" rel="stylesheet"/> +<script src="/jaxer_examples/js/ext-2.1/adapter/ext/ext-base.js"/> +<script src="/jaxer_examples/js/ext-2.1/ext-all.js"/> + +<link href="/jaxer_examples/css/main.css" type="text/css" rel="stylesheet"/> + +<script runat="both" src="/jaxer_examples/js/validateComments.js"/> + +<script> +var txt_name; +var txt_email; +var txt_message; +var btn_comments; +var form_comments; + +Ext.onReady( function() { + // create the name text field + txt_name = new Ext.form.TextField({ + name: "name", + fieldLabel: "Name", + width: 200 + }); + + // create the e-mail text field + txt_email = new Ext.form.TextField({ + name: "email", + fieldLabel: "E-mail", + width: 200 + }); + + // create the message text field + txt_message = new Ext.form.TextArea({ + name: "message", + fieldLabel: "Message", + width: 200 + }); + + // create a button used to send the form details. + btn_comments = new Ext.Button({ + text: "Submit", + fieldLabel: "", + handler: formHandler + }); + +// create the form panel, attach the inputs +form_comments = new Ext.form.FormPanel({ + labelAlign: "right", + width: 400, + title: "Comments", + items: [ + txt_name, + txt_email, + txt_message, + btn_comments + ], + renderTo: "form-comments" + }); + +}); +</script> + + + +</pre> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">The code in Listing 6 starts by hooking in the Ext JS library which is used to produce the UI elements of the form. Next a script named <em>validateComments.js</em> is hooked in with the <font face="Courier New">runat</font> attribute set to <font face="Courier New">both</font>. The function defined within this file checks the form to make sure it is complete, returning a boolean. The <font face="Courier New">both</font> context it operates within is a very powerful concept as we are able to use this code to check values entered in the form on both the client and server side. No custom validation libraries for each environment makes for rapid development with less risk for error. </font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">Towards the bottom of the code are two div tags with ids <strong>form-comments</strong> and <strong>out-logger</strong>. The <strong>form-comments</strong> div is used to render the form and the <strong>out-logger</strong> will be used as a log display as each comment is added. The completed user interface is shown in Figure 1.</font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">Figure 1 – The user interface</font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"> <img alt="ui.png" class="default internal" src="/@api/deki/files/2878/=ui.png" style="height: 482px; width: 619px;"></p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3"><strong>Server-Side DOM Processing</strong></font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">Another powerful concept of Jaxer is the ability to access the DOM server-side with JavaScript. This gives you added control to interrogate and manage the document structure before it's pushed to the client. Listing 7 contains the code which demonstrates this concept.</font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">Listing 7 - Manipulating the DOM server-side</font></font></font></p> + +<pre class="eval"><script runat="server"> + window.onserverload = function() { + document.getElementById( "out-logger" ).innerHTML = Jaxer.File.read( "dump.txt" ); + } +</script></pre> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">The code in listing 7 is executed server-side and takes advantage of the <font face="Courier New">onserverload</font> event which ensures that we have a complete DOM before trying to access it. This code is simple in that it updates the <font face="Courier New">innerHTML</font> of the logging div with the contents of a text file. The contents of this file are obtained through the file I/O capabilities exposed by Jaxer which is what we'll examine next.</font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3"><strong>File I/O</strong></font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">Jaxer ships with a comprehensive filesystem I/O capability that is very useful. There are numerous methods in this namespace which allow for a simple, yet powerful approach to file management. The example application uses this capability to log comments submitted by the form to a plain text file named <em>dump.txt</em>. Listing 8 shows the two functions used to handle the comment submission process. </font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">Listing 8 - Submitting Comment Data</font></font></font></p> + +<pre class="eval"><script> +function formHandler() { + +// get the form values + var name = txt_name.getValue(); + var email = txt_email.getValue(); + var message = txt_message.getValue(); + + // if the form passes validation client-side, submit results to the processor + if( validateComments( name, email, message ) ) { + formProcessor( name, email, message ); + // update the logger with the most recent entry + document.getElementById( "out-logger" ).innerHTML += "name: " + name + "<br/>email: " + email + "<br/>message: " + message + "<br/><br/>"; + } else { + Ext.Msg.alert( "Error", "Please enter the required fields" ); + } +} +</script> + +<!-- processes the form contents --> +<script runat="server"> +function formProcessor( name, email, message ) { + // perform the same validation of the data server-side + if( !validateComments( name, email, message ) ) { + throw "Incomplete data was submitted."; + } + // assemble the string + var s = "name: " + name + "<br/>" + + "email: " + email + "<br/>" + + "message: " + message + "<br/><br/>"; + // append the entry to the log file + Jaxer.File.append( "dump.txt", s ); +} +formProcessor.proxy = true; +</script> + +</pre> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">The first function, <strong>formHandler</strong>, performs some first-level validation using the <strong>validateComments</strong> function. If it passes validation, the <strong>formProcessor</strong> server-side function is invoked which does the same validation check using the shared <strong>validateComments</strong> function. Finally, the comment information is assembled into a string and appended to the dump file. </font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3"><strong>Database Access</strong></font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">For more robust data management, Jaxer comes with the ability to manage data in either a SQLite database which is included in Jaxer, or a mySQL database, and is extensible to others. Much like the file I/O namespace, database access in Jaxer can be as simple or complicated as you want or need it to be. For debugging, Jaxer will also send database errors to the client if you want.</font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">Upgrading the example application to include database access requires just a few lines of code added to the <strong>formProcessor</strong> method. Listing 9 demonstrates these changes.</font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">Listing 9 - Jaxer database access</font></font></font></p> + +<pre class="eval"><script runat="server"> +function formProcessor( name, email, message ) { + + // perform the same validation of the data server-side + if( !validateComments( name, email, message ) ) { + throw "Incomplete data was submitted."; + } + + // assemble the string + var s = "name: " + name + "<br/>" + + "email: " + email + "<br/>" + + "message: " + message + "<br/><br/>"; + + // append the entry to the log file + Jaxer.File.append( "dump.txt", s ); + + // add support for management via database + Jaxer.DB.execute( "create table if not exists comments ( id integer primary key auto_increment, " + + "name varchar(50) not null, " + + "email varchar(255) not null, " + + "message varchar(300) not null )" ); + + Jaxer.DB.execute( "insert into comments ( name, email, message ) values ( ?, ?, ? )", [ name, email, message ] ); + +} + +formProcessor.proxy = true; +</script></pre> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">The first statement which uses the <strong>Jaxer.DB</strong> namespace creates a new database table in the default SQLite database if it doesn't already exist. You can see the field names and data types which make sense for the type of data that's been added. The second statement is just a simple insert statement using the data obtained from the form. Placeholders in the form of '?' are used to match up the argument values with their proper position in the insert statement.</font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3"><strong>XML Processing</strong></font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">The final feature we'll explore is XML processing with a particular emphasis first on the capability to create a simple XML service on the server-side, then use the E4X capabilities to processes it.</font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">Listing 10 demonstrates the configuration of a simple service we're able to advertise through Jaxer using the data from the database we captured from prior form submissions.</font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">Listing 10 - Creating a simple XML service</font></font></font></p> + +<pre class="eval"> +<script runat="server"> +var rs_comments = Jaxer.DB.execute("SELECT * FROM Comments"); +var doc = document.implementation.createDocument('', 'comments', null); +var root = doc.documentElement; +rs_comments.rows.forEach(function(row, index) +{ +if (true || index < 10) +{ +var node = doc.createElement('comment'); +node.setAttribute('id', row.id); +node.setAttribute('name', row.name); +node.setAttribute('message', row.message); +root.appendChild(node); +} +}); +Jaxer.response.exit(200, doc); +</script> </pre> + +<p>The data from the database is represented in XML format as follows:</p> + +<pre><comments> <comment message="”Jaxer" name="”Nigel" id="”1”"></comment> ... more comments ... </comments> +</pre> + +<p>Now that we've created this simple XML feed, we can now also consume it using the code from Listing 11.</p> + +<p>Listing 11 - Consuming the XML feed</p> + +<pre class="eval"><script runat="server"> +var r = Jaxer.Web.get("service.html", {as: 'e4x'}); +for (var i=0, len = r.comment.length(); i<len; i++) { + var comment = r.comment[i]; + document.write('id: ' + comment.@id + '<br/>'); + document.write('name: ' + comment.@name + '<br/>'); + document.write('message: ' + comment.@message + '<br/>'); + document.write('<hr/>'); +} +</script></pre> + +<p> <font color="#000000"><font face="Times New Roman, serif"><font size="3">The code in Listing 11 is very simple. First a call to get the XML feed is made using the <strong>get</strong> method from the <strong>Jaxer.Web</strong> namespace, using the option that requests the response as a new E4X object. The comment nodes are looped over with data output using the simplified E4X syntax. </font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">Out of all the features we looked at, this one has to be my favorite. To be able to use Jaxer to essentially create an XML based RESTful service in JavaScript is useful and shifts a great deal of power to the JavaScript developer.</font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="4"><strong>Conclusion</strong></font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3">JavaScript can be successfully used for full <span lang="en-US"><font size="3"><font color="#000000">application</font></font></span> development on both the client <span lang="en-US"><font size="3"><font color="#000000">and</font></font></span> server, fulfilling Netscape's original vision for a single, unified language for the Web that makes apps easier to develop and maintain. Advances such as Ajax and running Ajax on the server side with the Jaxer server boosted by today's faster JavaScript engines and radically faster ones like TraceMonkey to come from Mozilla, sets the stage for significant use of server-side JavaScript now.</font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="4"><strong>Resources</strong></font></font></font></p> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<ul> + <li> + <p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3"><font color="#000080"><u><a href="/../../../../En/SpiderMonkey" title="../../../../En/SpiderMonkey">Mozilla SpiderMonkey</a></u></font></font></font></font></p> + </li> + <li> + <p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3"><font color="#000080"><u><a class="external" href="http://www.mozilla.org/rhino">Mozilla Rhino</a></u></font></font></font></font></p> + </li> + <li> + <p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3"><font color="#000080"><u><a href="/ServerJS" title="https://developer.mozilla.org/ServerJS">ServerJS discussion on proposed Common API for SSJS</a></u></font></font></font></font></p> + </li> + <li> + <p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3"><font color="#000080"><u><a class="external" href="http://en.wikipedia.org/wiki/SSJS">SSJS (Server Side JavaScript) at Wikipedia.com</a></u></font></font></font></font></p> + </li> + <li> + <p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3"><font color="#000080"><u><a class="external" href="http://www.aptana.com/jaxer">Aptana Jaxer</a></u></font></font></font></font></p> + </li> + <li> + <p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3"><font color="#000080"><u><a class="external" href="http://www.aptana.com/jaxer/book">Aptana Jaxer Documentation</a></u></font></font></font></font></p> + </li> + <li> + <p lang="en-US" style="margin-bottom: 0in;"><font color="#000000"><font face="Times New Roman, serif"><font size="3"><font color="#000080"><u>Ext JS</u></font></font></font></font></p> + </li> +</ul> + +<p lang="en-US" style="margin-bottom: 0in;"> </p> + +<p> </p> |