diff options
Diffstat (limited to 'files/pl/archive')
53 files changed, 6470 insertions, 0 deletions
diff --git a/files/pl/archive/add-ons/add-on_sdk/tools/index.html b/files/pl/archive/add-ons/add-on_sdk/tools/index.html new file mode 100644 index 0000000000..7ce4fa6d2f --- /dev/null +++ b/files/pl/archive/add-ons/add-on_sdk/tools/index.html @@ -0,0 +1,158 @@ +--- +title: Tools +slug: Archive/Add-ons/Add-on_SDK/Tools +tags: + - Add-on SDK + - CFX + - JPM + - NeedsTranslation + - TopicStub +translation_of: Archive/Add-ons/Add-on_SDK/Tools +--- +<p></p><div class="warning"><p>Add-ons using the techniques described in this document are considered a legacy technology in Firefox. Don't use these techniques to develop new add-ons. Use <a href="/en-US/Add-ons/WebExtensions">WebExtensions</a> instead. If you maintain an add-on which uses the techniques described here, consider migrating it to use WebExtensions.</p><p><strong>Starting from <a href="https://wiki.mozilla.org/RapidRelease/Calendar">Firefox 53</a>, no new legacy add-ons will be accepted on addons.mozilla.org (AMO) for desktop Firefox and Firefox for Android.</strong></p><p><strong>Starting from <a href="https://wiki.mozilla.org/RapidRelease/Calendar">Firefox 57</a>, only extensions developed using WebExtensions APIs will be supported on Desktop Firefox and Firefox for Android. </strong></p><p>Even before Firefox 57, changes coming up in the Firefox platform will break many legacy extensions. These changes include multiprocess Firefox (e10s), sandboxing, and multiple content processes. Legacy extensions that are affected by these changes should migrate to use WebExtensions APIs if they can. See the <a href="https://blog.mozilla.org/addons/2017/02/16/the-road-to-firefox-57-compatibility-milestones/">"Compatibility Milestones" document</a> for more information.</p><p>A wiki page containing <a href="https://wiki.mozilla.org/Add-ons/developer/communication">resources, migration paths, office hours, and more</a>, is available to help developers transition to the new technologies.</p></div><section class="Quick_links" id="Quick_Links"> + <ol> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions"><strong>Browser extensions</strong></a></li> + + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions#Getting_started">Getting started</a> + <ol> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/What_are_WebExtensions">What are extensions?</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Your_first_WebExtension">Your first extension</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Your_second_WebExtension">Your second extension</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension">Anatomy of an extension</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Examples">Example extensions</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/What_next_">What next?</a></li> + </ol> + </li> + + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions#Concepts">Concepts</a> + <ol> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Using_the_JavaScript_APIs">Using the JavaScript APIs</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Content_scripts">Content scripts</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Match_patterns">Match patterns</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Working_with_files">Working with files</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Internationalization">Internationalization</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Security_best_practices">Security best practices</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Content_Security_Policy">Content Security Policy</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_messaging">Native messaging</a></li> + </ol> + </li> + + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions#User_Interface">User interface</a> + <ol> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/user_interface">User Interface</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/user_interface/Browser_action">Toolbar button</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/user_interface/Page_actions">Address bar button</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/user_interface/Sidebars">Sidebars</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/user_interface/Context_menu_items">Context menu items</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/user_interface/Options_pages">Options page</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/user_interface/Extension_pages">Extension pages</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/user_interface/Notifications">Notifications</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/user_interface/Omnibox">Address bar suggestions</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/user_interface/devtools_panels">Developer tools panels</a></li> + </ol> + </li> + + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions#How_to">How to</a> + <ol> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Intercept_HTTP_requests">Intercept HTTP requests</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Modify_a_web_page">Modify a web page</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Safely_inserting_external_content_into_a_page">Insert external content</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Add_a_button_to_the_toolbar">Add a button to the toolbar</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Implement_a_settings_page">Implement a settings page</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Working_with_the_Tabs_API">Work with the Tabs API</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Work_with_the_Bookmarks_API">Work with the Bookmarks API</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Work_with_the_Cookies_API">Work with the Cookies API</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Work_with_contextual_identities">Work with contextual identities</a></li> + </ol> + </li> + + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions#Porting">Porting</a> + <ol> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Porting_a_Google_Chrome_extension">Porting a Google Chrome extension</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Porting_a_legacy_Firefox_add-on">Porting a legacy Firefox extension</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Embedded_WebExtensions">Embedded WebExtensions</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Comparison_with_the_Add-on_SDK">Comparison with the Add-on SDK</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Comparison_with_XUL_XPCOM_extensions">Comparison with XUL/XPCOM extensions</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Chrome_incompatibilities">Chrome incompatibilities</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Differences_between_desktop_and_Android">Differences between desktop and Android</a></li> + </ol> + </li> + + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions#Firefox_workflow">Firefox workflow</a> + <ol> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/User_experience_best_practices">User Experience</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Temporary_Installation_in_Firefox">Temporary Installation in Firefox</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Debugging">Debugging</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Testing_persistent_and_restart_features">Testing persistent and restart features</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Developing_WebExtensions_for_Firefox_for_Android">Developing for Firefox for Android</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Getting_started_with_web-ext">Getting started with web-ext</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/web-ext_command_reference">web-ext command reference</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/WebExtensions_and_the_Add-on_ID">Extensions and the Add-on ID</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Request_the_right_permissions">Request the right permissions</a></li> + + </ol> + </li> + + <li data-default-state="closed"><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API">JavaScript APIs</a> + <ol><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Browser_support_for_JavaScript_APIs">Browser support for JavaScript APIs</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/alarms">alarms</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/bookmarks">bookmarks</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/browserAction">browserAction</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/browserSettings">browserSettings</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/browsingData">browsingData</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/clipboard">clipboard</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/commands">commands</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/contentScripts">contentScripts</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/contextualIdentities">contextualIdentities</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/cookies">cookies</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/devtools.inspectedWindow">devtools.inspectedWindow</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/devtools.network">devtools.network</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/devtools.panels">devtools.panels</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/dns">dns</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/downloads">downloads</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/events">events</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/extension">extension</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/extensionTypes">extensionTypes</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/find">find</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/history">history</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/i18n">i18n</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/identity">identity</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/idle">idle</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/management">management</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/menus">menus</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/notifications">notifications</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/omnibox">omnibox</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/pageAction">pageAction</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/permissions">permissions</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/pkcs11">pkcs11</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/privacy">privacy</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/proxy">proxy</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/runtime">runtime</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/search">search</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/sessions">sessions</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/sidebarAction">sidebarAction</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/storage">storage</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/tabs">tabs</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/theme">theme</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/topSites">topSites</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/types">types</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/webNavigation">webNavigation</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/webRequest">webRequest</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/windows">windows</a></li></ol> + </li> + + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json">Manifest keys</a> + <ol><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/applications">applications</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/author">author</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/background">background</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/browser_action">browser_action</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/chrome_settings_overrides">chrome_settings_overrides</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/chrome_url_overrides">chrome_url_overrides</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/commands">commands</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts">content_scripts</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_security_policy">content_security_policy</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/default_locale">default_locale</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/description">description</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/developer">developer</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/devtools_page">devtools_page</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/homepage_url">homepage_url</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/icons">icons</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/incognito">incognito</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/manifest_version">manifest_version</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/name">name</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/omnibox">omnibox</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/optional_permissions">optional_permissions</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/options_ui">options_ui</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/page_action">page_action</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions">permissions</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/protocol_handlers">protocol_handlers</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/short_name">short_name</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action">sidebar_action</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/theme">theme</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/version">version</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/version_name">version_name</a></li><li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/web_accessible_resources">web_accessible_resources</a></li></ol> + </li> + + <li><a href="/en-US/docs/Mozilla/Add-ons/Themes"><strong>Themes</strong></a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/Themes/Theme_concepts">Browser themes</a> + <ol> + <li><a href="/en-US/docs/Mozilla/Add-ons/Themes/Theme_concepts">Browser theme concepts</a></li> + </ol> + </li> + <li><a href="/en-US/docs/Mozilla/Add-ons/Themes/Lightweight_themes">Lightweight themes</a> + <ol> + <li><a href="/en-US/docs/Mozilla/Add-ons/Themes/Lightweight_themes">Lightweight themes</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/Themes/Lightweight_Themes/FAQ">Lightweight themes FAQ</a></li> + </ol> + </li> + + <li><a href="/en-US/docs/Mozilla/Add-ons/Distribution"><strong>Publishing and Distribution</strong></a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/Distribution">Publishing add-ons</a> + <ol> + <li><a href="/en-US/docs/Mozilla/Add-ons/Distribution">Signing and distribution overview</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Package_your_extension_">Package your extension</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/Distribution/Submitting_an_add-on">Submit an add-on</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/Source_Code_Submission">Source code submission</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/Distribution/Resources_for_publishers">Resources for publishers</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/Listing">Creating an appealing listing</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/AMO/Policy/Reviews">Review policies</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/AMO/Policy/Agreement">Developer agreement</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/AMO/Policy/Featured">Featured add-ons</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/Distribution/Retiring_your_extension">Retiring your extension</a></li> + </ol> + </li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Alternative_distribution_options">Distributing add-ons</a> + <ol> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Alternative_distribution_options/Sideloading_add-ons">For sideloading</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Alternative_distribution_options/Add-ons_for_desktop_apps">For desktop apps</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Alternative_distribution_options/Add-ons_in_the_enterprise">For an enterprise</a></li> + </ol> + </li> + + <li><a href="https://discourse.mozilla.org/c/add-ons"><strong>Community and Support</strong></a></li> + <li><a href="#">Channels</a> + <ol> + <li><a href="https://blog.mozilla.org/addons">Add-ons blog</a></li> + <li><a href="https://discourse.mozilla.org/c/add-ons">Add-on forums</a></li> + <li><a href="http://stackoverflow.com/questions/tagged/firefox-addon">Stack Overflow</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/#Contact_us">Contact us</a></li> + </ol> + </li> + + </ol> +</section><p></p> + +<p>Articles listed here provide a reference for the SDK's tools:</p> + +<p></p><div class="row topicpage-table"> + <div class="section"><dl><dl><dt class="landingPageList"><a href="/en-US/docs/Archive/Add-ons/Add-on_SDK/Tools/cfx">cfx</a></dt><dd class="landingPageList">Enables you to test, run, and package add-ons. cfx is is no longer supported as of Firefox 44 and no longer accepted for add-on submission, jpm should now be used instead.</dd><dt class="landingPageList"><a href="/en-US/docs/Archive/Add-ons/Add-on_SDK/Tools/cfx_to_jpm">cfx to jpm</a></dt><dd class="landingPageList">A guide to working with jpm if you're already familiar with cfx.</dd><dt class="landingPageList"><a href="/en-US/docs/Archive/Add-ons/Add-on_SDK/Tools/console">console</a></dt><dd class="landingPageList">Enables your add-on to log error, warning or informational messages.</dd><dt class="landingPageList"><a href="/en-US/docs/Archive/Add-ons/Add-on_SDK/Tools/jpm">jpm</a></dt><dd class="landingPageList">jpm is a command-line tool that enables you to test, run, and package add-ons.</dd><dt class="landingPageList"><a href="/en-US/docs/Archive/Add-ons/Add-on_SDK/Tools/jpm-mobile">jpm-mobile</a></dt><dd class="landingPageList">The Node-based replacement for <a href="/en-US/Add-ons/SDK/Tools/cfx"><code>cfx --force-mobile</code></a>. Enables you to run and test add-ons for Firefox Mobile (aka Fennec).</dd></dl></dl></div> + <div class="section"><dl><dt class="landingPageList"><a href="/en-US/docs/Archive/Add-ons/Add-on_SDK/Tools/jpmignore">jpmignore</a></dt><dd class="landingPageList">Use <code>.jpmignore</code> to ignore files from your XPI builds created via <a href="/en-US/docs/Mozilla/Add-ons/SDK/Tools/jpm">jpm</a>.</dd><dt class="landingPageList"><a href="/en-US/docs/Archive/Add-ons/Add-on_SDK/Tools/package_json">package.json</a></dt><dd class="landingPageList">The <code>package.json</code> file contains manifest data for your add-on, providing not only descriptive information about the add-on for presentation in the Add-ons Manager, but other metadata required of add-ons.</dd></dl></div> + </div><p></p> diff --git a/files/pl/archive/add-ons/add-on_sdk/tools/jpm/index.html b/files/pl/archive/add-ons/add-on_sdk/tools/jpm/index.html new file mode 100644 index 0000000000..853afb805a --- /dev/null +++ b/files/pl/archive/add-ons/add-on_sdk/tools/jpm/index.html @@ -0,0 +1,883 @@ +--- +title: jpm +slug: Archive/Add-ons/Add-on_SDK/Tools/jpm +translation_of: Archive/Add-ons/Add-on_SDK/Tools/jpm +--- +<div> +<div class="warning"> +<p>Support for extensions using XUL/XPCOM or the Add-on SDK was removed in Firefox 57, released November 2017. As there is no supported version of Firefox enabling these technologies, this page will be removed by December 2020.</p> + +<p>Add-ons using the techniques described in this document are considered a legacy technology in Firefox. Don't use these techniques to develop new add-ons. Use <a href="/en-US/Add-ons/WebExtensions">WebExtensions</a> instead. If you maintain an add-on which uses the techniques described here, consider migrating it to use WebExtensions.</p> + +<p><strong>Starting from <a href="https://wiki.mozilla.org/RapidRelease/Calendar">Firefox 53</a>, no new legacy add-ons will be accepted on addons.mozilla.org (AMO) for desktop Firefox and Firefox for Android.</strong></p> + +<p><strong>Starting from <a href="https://wiki.mozilla.org/RapidRelease/Calendar">Firefox 57</a>, only extensions developed using WebExtensions APIs will be supported on Desktop Firefox and Firefox for Android. </strong></p> + +<p>Even before Firefox 57, changes coming up in the Firefox platform will break many legacy extensions. These changes include multiprocess Firefox (e10s), sandboxing, and multiple content processes. Legacy extensions that are affected by these changes should migrate to use WebExtensions APIs if they can. See the <a href="https://blog.mozilla.org/addons/2017/02/16/the-road-to-firefox-57-compatibility-milestones/">"Compatibility Milestones" document</a> for more information.</p> + +<p>A wiki page containing <a href="https://wiki.mozilla.org/Add-ons/developer/communication">resources, migration paths, office hours, and more</a>, is available to help developers transition to the new technologies.</p> +</div> + +<section class="Quick_links" id="Quick_Links"> +<ol> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions"><strong>Browser extensions</strong></a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions#Getting_started">Getting started</a> + <ol> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/What_are_WebExtensions">What are extensions?</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Your_first_WebExtension">Your first extension</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Your_second_WebExtension">Your second extension</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension">Anatomy of an extension</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Examples">Example extensions</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/What_next_">What next?</a></li> + </ol> + </li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions#Concepts">Concepts</a> + <ol> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Using_the_JavaScript_APIs">Using the JavaScript APIs</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Content_scripts">Content scripts</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Match_patterns">Match patterns</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Working_with_files">Working with files</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Internationalization">Internationalization</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Security_best_practices">Security best practices</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Content_Security_Policy">Content Security Policy</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_messaging">Native messaging</a></li> + </ol> + </li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions#User_Interface">User interface</a> + <ol> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/user_interface">User Interface</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/user_interface/Browser_action">Toolbar button</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/user_interface/Page_actions">Address bar button</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/user_interface/Sidebars">Sidebars</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/user_interface/Context_menu_items">Context menu items</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/user_interface/Options_pages">Options page</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/user_interface/Extension_pages">Extension pages</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/user_interface/Notifications">Notifications</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/user_interface/Omnibox">Address bar suggestions</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/user_interface/devtools_panels">Developer tools panels</a></li> + </ol> + </li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions#How_to">How to</a> + <ol> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Intercept_HTTP_requests">Intercept HTTP requests</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Modify_a_web_page">Modify a web page</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Safely_inserting_external_content_into_a_page">Insert external content</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Add_a_button_to_the_toolbar">Add a button to the toolbar</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Implement_a_settings_page">Implement a settings page</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Working_with_the_Tabs_API">Work with the Tabs API</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Work_with_the_Bookmarks_API">Work with the Bookmarks API</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Work_with_the_Cookies_API">Work with the Cookies API</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Work_with_contextual_identities">Work with contextual identities</a></li> + </ol> + </li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions#Porting">Porting</a> + <ol> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Porting_a_Google_Chrome_extension">Porting a Google Chrome extension</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Porting_a_legacy_Firefox_add-on">Porting a legacy Firefox extension</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Embedded_WebExtensions">Embedded WebExtensions</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Comparison_with_the_Add-on_SDK">Comparison with the Add-on SDK</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Comparison_with_XUL_XPCOM_extensions">Comparison with XUL/XPCOM extensions</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Chrome_incompatibilities">Chrome incompatibilities</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Differences_between_desktop_and_Android">Differences between desktop and Android</a></li> + </ol> + </li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions#Firefox_workflow">Firefox workflow</a> + <ol> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/User_experience_best_practices">User Experience</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Temporary_Installation_in_Firefox">Temporary Installation in Firefox</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Debugging">Debugging</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Testing_persistent_and_restart_features">Testing persistent and restart features</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Developing_WebExtensions_for_Firefox_for_Android">Developing for Firefox for Android</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Getting_started_with_web-ext">Getting started with web-ext</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/web-ext_command_reference">web-ext command reference</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/WebExtensions_and_the_Add-on_ID">Extensions and the Add-on ID</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Request_the_right_permissions">Request the right permissions</a></li> + </ol> + </li> + <li data-default-state="closed"><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API">JavaScript APIs</a> + <ol> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Browser_support_for_JavaScript_APIs">Browser support for JavaScript APIs</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/alarms">alarms</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/bookmarks">bookmarks</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/browserAction">browserAction</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/browserSettings">browserSettings</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/browsingData">browsingData</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/clipboard">clipboard</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/commands">commands</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/contentScripts">contentScripts</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/contextualIdentities">contextualIdentities</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/cookies">cookies</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/devtools.inspectedWindow">devtools.inspectedWindow</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/devtools.network">devtools.network</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/devtools.panels">devtools.panels</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/dns">dns</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/downloads">downloads</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/events">events</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/extension">extension</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/extensionTypes">extensionTypes</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/find">find</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/history">history</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/i18n">i18n</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/identity">identity</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/idle">idle</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/management">management</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/menus">menus</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/notifications">notifications</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/omnibox">omnibox</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/pageAction">pageAction</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/permissions">permissions</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/pkcs11">pkcs11</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/privacy">privacy</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/proxy">proxy</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/runtime">runtime</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/search">search</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/sessions">sessions</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/sidebarAction">sidebarAction</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/storage">storage</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/tabs">tabs</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/theme">theme</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/topSites">topSites</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/types">types</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/webNavigation">webNavigation</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/webRequest">webRequest</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/windows">windows</a></li> + </ol> + </li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json">Manifest keys</a> + <ol> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/applications">applications</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/author">author</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/background">background</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/browser_action">browser_action</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/chrome_settings_overrides">chrome_settings_overrides</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/chrome_url_overrides">chrome_url_overrides</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/commands">commands</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts">content_scripts</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_security_policy">content_security_policy</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/default_locale">default_locale</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/description">description</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/developer">developer</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/devtools_page">devtools_page</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/homepage_url">homepage_url</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/icons">icons</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/incognito">incognito</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/manifest_version">manifest_version</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/name">name</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/omnibox">omnibox</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/optional_permissions">optional_permissions</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/options_ui">options_ui</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/page_action">page_action</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions">permissions</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/protocol_handlers">protocol_handlers</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/short_name">short_name</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action">sidebar_action</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/theme">theme</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/version">version</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/version_name">version_name</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/web_accessible_resources">web_accessible_resources</a></li> + </ol> + </li> + <li><a href="/en-US/docs/Mozilla/Add-ons/Themes"><strong>Themes</strong></a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/Themes/Theme_concepts">Browser themes</a> + <ol> + <li><a href="/en-US/docs/Mozilla/Add-ons/Themes/Theme_concepts">Browser theme concepts</a></li> + </ol> + </li> + <li><a href="/en-US/docs/Mozilla/Add-ons/Themes/Lightweight_themes">Lightweight themes</a> + <ol> + <li><a href="/en-US/docs/Mozilla/Add-ons/Themes/Lightweight_themes">Lightweight themes</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/Themes/Lightweight_Themes/FAQ">Lightweight themes FAQ</a></li> + </ol> + </li> + <li><a href="/en-US/docs/Mozilla/Add-ons/Distribution"><strong>Publishing and Distribution</strong></a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/Distribution">Publishing add-ons</a> + <ol> + <li><a href="/en-US/docs/Mozilla/Add-ons/Distribution">Signing and distribution overview</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Package_your_extension_">Package your extension</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/Distribution/Submitting_an_add-on">Submit an add-on</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/Source_Code_Submission">Source code submission</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/Distribution/Resources_for_publishers">Resources for publishers</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/Listing">Creating an appealing listing</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/AMO/Policy/Reviews">Review policies</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/AMO/Policy/Agreement">Developer agreement</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/AMO/Policy/Featured">Featured add-ons</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/Distribution/Retiring_your_extension">Retiring your extension</a></li> + </ol> + </li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Alternative_distribution_options">Distributing add-ons</a> + <ol> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Alternative_distribution_options/Sideloading_add-ons">For sideloading</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Alternative_distribution_options/Add-ons_for_desktop_apps">For desktop apps</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Alternative_distribution_options/Add-ons_in_the_enterprise">For an enterprise</a></li> + </ol> + </li> + <li><a href="https://discourse.mozilla.org/c/add-ons"><strong>Community and Support</strong></a></li> + <li><a href="#">Channels</a> + <ol> + <li><a href="https://blog.mozilla.org/addons">Add-ons blog</a></li> + <li><a href="https://discourse.mozilla.org/c/add-ons">Add-on forums</a></li> + <li><a href="http://stackoverflow.com/questions/tagged/firefox-addon">Stack Overflow</a></li> + <li><a href="/en-US/docs/Mozilla/Add-ons/#Contact_us">Contact us</a></li> + </ol> + </li> +</ol> +</section> +</div> + +<p><span class="seoSummary">jpm is a command-line tool that enables you to test, run, and package add-ons.</span></p> + +<p>This is the reference page for jpm. See also <a href="/en-US/Add-ons/SDK/Tutorials/Getting_Started_%28jpm%29">jpm tutorial</a> for getting started.</p> + +<p>jpm <span class="tlid-translation translation" lang="pl"><span title="">użyj go</span></span> :</p> + +<pre class="brush: bash">jpm [command] [options] +</pre> + +<p>jpm <span class="tlid-translation translation" lang="pl"><span title="">obsługuje następujące opcje globalne</span></span> :</p> + +<pre class="brush: bash">-h, --help - show a help message and exit +-V, --version - print the jpm version number +--addon-dir - directory for your source code, + defaulting to the current directory +</pre> + +<h2 id="Instalacja"><span class="tlid-translation translation" lang="pl"><span title="">Instalacja</span></span></h2> + +<p>jpm is distributed with the node package manager <a class="external external-icon" href="https://www.npmjs.org/package/jpm">npm</a>.</p> + +<h3 id="Instalowanie_npm"><span class="tlid-translation translation" lang="pl"><span title="">Instalowanie</span></span> npm</h3> + +<p> <span class="tlid-translation translation" lang="pl"><span title="">Istnieją dwa sposoby uzyskania</span></span> npm.</p> + +<ul> + <li><span class="tlid-translation translation" lang="pl"><span class="alt-edited" title="">Pobierz i zainstaluj</span></span> Node.js z <a class="external external-icon" href="https://nodejs.org/">nodejs.org</a>. Node.js <span class="tlid-translation translation" lang="pl"><span title="">zawiera</span></span> npm.</li> + <li><span class="tlid-translation translation" lang="pl"><span title="">Lub</span></span> , <span class="tlid-translation translation" lang="pl"><span title="">jeśli masz</span></span> <span class="tlid-translation translation" lang="pl"><span title="">menedżer pakietów, taki jak APT</span></span>, zainstaluj npm <span class="tlid-translation translation" lang="pl"><span title="">przez to</span></span>. <span class="tlid-translation translation" lang="pl"><span title="">Na przykład</span></span>, <span class="tlid-translation translation" lang="pl"><span title="">w oknie terminalu Ubuntu lub Debian</span></span>, <span class="tlid-translation translation" lang="pl"><span class="alt-edited" title="">wpisz</span></span> <code>sudo apt-get install nodejs nodejs-legacy npm</code>.</li> +</ul> + +<p><span class="tlid-translation translation" lang="pl"><span title="">Aby przetestować instalację, uruchom</span></span>:</p> + +<pre class="lang-js prettyprint prettyprinted">/usr/bin/env node -v</pre> + +<p><span class="tlid-translation translation" lang="pl"><span title="">Jeśli pojawi się komunikat o błędzie z informacją</span></span> <em>/usr/bin/env: node: No such file or directory</em> and you have installed nodejs through a package manager, <span class="tlid-translation translation" lang="pl"><span title="">nodejs mógł zostać zainstalowany pod inną nazwą wykonywalną</span></span>. <span class="tlid-translation translation" lang="pl"><span title="">Aby zapewnić zgodność z jpm</span></span>, <span class="tlid-translation translation" lang="pl"><span title="">jednak musi znajdować się w Twoim PATH pod nazwą</span></span> <code>node</code>. <span class="tlid-translation translation" lang="pl"><span title="">W Debianie i Ubuntu można temu zaradzić, zapewniając zainstalowanie pakietu zgodności</span></span>, <code>nodejs-legacy</code>:</p> + +<pre class="brush:bash">sudo apt-get install nodejs-legacy</pre> + +<p><span class="tlid-translation translation" lang="pl"><span title="">W innych dystrybucjach konieczne może być ręczne utworzenie lokalnego dowiązania symbolicznego do nodejs:</span></span></p> + +<pre class="brush:bash">sudo ln -s "$(which nodejs)" /usr/local/bin/node</pre> + +<h3 id="Instalowanie_jpm"><span class="tlid-translation translation" lang="pl"><span title="">Instalowanie</span></span> jpm</h3> + +<p>After you have npm installed and <code>node</code> on your PATH, install jpm just as you would any other npm package.</p> + +<h4 id="Installing_jpm_globally">Installing jpm globally</h4> + +<pre class="brush: bash">npm install jpm --global</pre> + +<p>Depending on your setup, you might need to run this as an administrator: <code>sudo npm install jpm --global</code></p> + +<h4 id="Installing_jpm_locally">Installing jpm locally</h4> + +<p>If you do not wish to, or are unable to, install jpm globally, you may instead install it locally:</p> + +<pre class="brush: bash">cd $HOME && npm install jpm</pre> + +<p>To run <code>jpm</code> from a terminal when installed locally, you must add the directory <code>"$HOME/node_modules/.bin/"</code> to your terminal's PATH first. Add the following line to the end of the file <code>$HOME/.profile</code> to add it to your PATH permanently (as the file <code>.profile</code> is executed every time a new terminal is opened):</p> + +<pre class="brush: bash">export PATH="$HOME/node_modules/.bin/:$PATH"</pre> + +<h4 id="Installing_jpm_from_git">Installing jpm from git</h4> + +<p>Alternatively, you can also get the latest version of jpm using git:</p> + +<pre class="brush:bash">git clone https://github.com/mozilla-jetpack/jpm.git +cd jpm +npm install +npm link +</pre> + +<h3 id="After_installing_jpm">After installing jpm</h3> + +<p>After installation, at the command prompt, type:</p> + +<pre class="brush: bash">jpm</pre> + +<p>You should see a screen summarizing the available jpm commands. Note that unlike cfx, jpm is available in every command prompt you start, as long as you installed it with the <code>--global</code> flag.</p> + +<h3 id="Install_a_different_version_of_Firefox">Install a different version of Firefox</h3> + +<p>As of Firefox 48, it is not possible to use <a href="/en-US/docs/Mozilla/Add-ons/Distribution">unsigned add-ons</a> (i.e. any add-on which you are in the process of developing) in the branded release or beta versions of Firefox. Thus, you will need to download and install a different version of Firefox. Assuming you don't want an <a href="ftp.mozilla.org/pub/firefox/releases/">old version</a> of Firefox, your options are <a href="https://www.mozilla.org/en-US/firefox/developer/">Firefox Developer Edition</a>, <a href="https://nightly.mozilla.org/">Firefox Nightly</a>, <a href="https://wiki.mozilla.org/Add-ons/Extension_Signing#Unbranded_Builds">Unbranded Beta, or Unbranded Release</a>.</p> + +<p>When testing your add-on, you will need to use the <code>-b</code> option to <code>jpm run.</code> See <a href="/en-US/Add-ons/SDK/Tools/jpm#Selecting_a_browser_version">Selecting a browser version</a>.</p> + +<h3 id="Problems">Problems?</h3> + +<p>If you do not see this, ask for help. SDK users and project team members discuss problems and proposals on the <a class="external external-icon" href="https://groups.google.com/forum/#!forum/mozilla-labs-jetpack">project mailing list</a>. Someone else may have had the same problem you do, so try searching the list. You are welcome to post a question, too. You can also chat with other SDK users in <a class="external external-icon" href="https://mibbit.com/?channel=%23jetpack&server=irc.mozilla.org">#jetpack</a> on <a class="external external-icon" href="http://irc.mozilla.org/">Mozilla's IRC network</a>.</p> + +<h2 id="Command_reference">Command reference</h2> + +<p>jpm supports the following commands:</p> + +<table class="fullwidth-table standard-table"> + <tbody> + <tr> + <td style="width: 20%;"><a href="/en-US/Add-ons/SDK/Tools/jpm#jpm_init"><code>jpm init</code></a></td> + <td>Create a skeleton add-on as a starting point for your add-on.</td> + </tr> + <tr> + <td><a href="/en-US/Add-ons/SDK/Tools/jpm#jpm_run"><code>jpm run</code></a></td> + <td>Launch an instance of Firefox with your add-on installed.</td> + </tr> + <tr> + <td><a href="/en-US/Add-ons/SDK/Tools/jpm#jpm_test"><code>jpm test</code></a></td> + <td>Runs your add-on's unit tests.</td> + </tr> + <tr> + <td><a href="/en-US/Add-ons/SDK/Tools/jpm#jpm_xpi"><code>jpm xpi</code></a></td> + <td>Package your add-on as an <a href="/en-US/docs/XPI">XPI</a> file, which is the install file format for Firefox add-ons.</td> + </tr> + <tr> + <td><a href="/en-US/Add-ons/SDK/Tools/jpm#jpm_post"><code>jpm post</code></a></td> + <td>Package your add-on as an <a href="/en-US/docs/XPI">XPI</a> file, and then post it to some URL.</td> + </tr> + <tr> + <td><a href="/en-US/Add-ons/SDK/Tools/jpm#jpm_watchpost"><code>jpm watchpost</code></a></td> + <td>Package your add-on as an <a href="/en-US/docs/XPI">XPI</a> file whenever there is a file change and post that to some URL.</td> + </tr> + <tr> + <td><a href="/en-US/Add-ons/SDK/Tools/jpm#jpm_sign"><code>jpm sign</code></a></td> + <td>Package your add-on as an <a href="/en-US/docs/XPI">XPI</a> file, and then retrieve a new XPI signed by Mozilla.</td> + </tr> + </tbody> +</table> + +<h3 id="jpm_init">jpm init</h3> + +<p>This command initializes a new add-on from scratch.</p> + +<p>Create a new directory, change into it, and run <code>jpm init</code>.</p> + +<pre class="brush: bash">mkdir my-addon +cd my-addon +jpm init</pre> + +<p>You'll then be asked to supply some information about your add-on: this will be used to create your add-on's <a href="/en-US/Add-ons/SDK/Tools/package_json">package.json</a> file.</p> + +<ul> + <li><a href="/en-US/Add-ons/SDK/Tools/package_json#title">title</a></li> + <li><a href="/en-US/Add-ons/SDK/Tools/package_json#name">name</a>: this defaults to the name of the directory in which you are running <code>jpm init</code>. Unless an <a href="https://developer.mozilla.org/en-US/Add-ons/SDK/Tools/package_json#id"><code>id</code></a> field is present in package.json, jpm prepends "@" to <code>name</code> and use the result as the <a href="/en-US/Add-ons/Install_Manifests#id"><code>id</code> field in the add-on's install manifest</a>.</li> + <li><a href="/en-US/Add-ons/SDK/Tools/package_json#version">version</a></li> + <li><a href="/en-US/Add-ons/SDK/Tools/package_json#description">description</a></li> + <li><a href="/en-US/Add-ons/SDK/Tools/package_json#main">entry point</a> (which maps to "main" in package.json)</li> + <li><a href="/en-US/Add-ons/SDK/Tools/package_json#author">author</a></li> + <li><a href="/en-US/Add-ons/SDK/Tools/package_json#engines">engines</a> (supported applications)</li> + <li><a href="/en-US/Add-ons/SDK/Tools/package_json#license">license</a></li> +</ul> + +<p>Most of these fields have a default, which is shown in brackets after the question. If you just press Enter, your add-on gets the default value.</p> + +<p>Once you've supplied a value or accepted the default for these properties, you'll be shown the complete contents of "package.json" and asked to accept it.</p> + +<p>Then jpm creates a skeleton add-on, as a starting point for your add-on development, with the following file structure:</p> + +<ul class="directory-tree"> + <li>my-addon + <ul> + <li>index.js</li> + <li>package.json</li> + <li>test + <ul> + <li>test-index.js</li> + </ul> + </li> + </ul> + </li> +</ul> + +<h3 id="jpm_run">jpm run</h3> + +<p>This command runs a new instance of Firefox with the add-on installed:</p> + +<pre class="brush: bash">jpm run</pre> + +<p><code>jpm run</code> accepts the following options:</p> + +<table class="fullwidth-table standard-table"> + <tbody> + <tr> + <td style="width: 30%;"><code>-b --binary BINARY</code></td> + <td> + <p>Use the version of Firefox specified in BINARY. BINARY may be specified as a full path or as a path relative to the current directory.</p> + + <pre class="brush: bash"> +jpm run -b /path/to/Firefox/Nightly</pre> + See <a href="/en-US/Add-ons/SDK/Tools/jpm#Selecting_a_browser_version">Selecting a browser version</a>.</td> + </tr> + <tr> + <td><code>--binary-args CMDARGS</code></td> + <td> + <p>Pass <a href="/en-US/docs/Mozilla/Command_Line_Options">extra arguments</a> to Firefox.</p> + + <p>For example, to pass the <code>-jsconsole</code> argument to Firefox and launch the <a href="/en-US/docs/Tools/Browser_Console">Browser Console</a>, try the following:</p> + + <pre class="brush: bash"> +jpm run --binary-args -jsconsole</pre> + + <p>To pass multiple arguments, or arguments containing spaces, quote them:</p> + + <pre class="brush: bash"> +jpm run --binary-args '-url mzl.la -jsconsole'</pre> + </td> + </tr> + <tr> + <td><code>--debug</code></td> + <td>Run the <a href="/en-US/Add-ons/Add-on_Debugger">Add-on Debugger</a> attached to the add-on.</td> + </tr> + <tr> + <td><code>-o --overload PATH</code></td> + <td> + <p>Rather than use the SDK modules built into Firefox, use the modules found at PATH. If <code>-o</code> is specified and PATH is omitted, jpm looks for the JETPACK_ROOT environment variable and use its value as the path.</p> + + <p>See <a href="/en-US/Add-ons/SDK/Tools/jpm#Overloading_the_built-in_modules">Overloading the built-in modules</a> for more information.</p> + </td> + </tr> + <tr> + <td><code>-p --profile=<code> PROFILE</code></code></td> + <td> + <p>By default, jpm uses a clean temporary Firefox <a href="https://support.mozilla.org/en-US/kb/profiles-where-firefox-stores-user-data">profile</a> each time you call jpm run. Use the <code>--profile</code> option to instruct jpm to launch Firefox with an existing profile.</p> + + <p>The PROFILE value may be a profile name or the path to the profile.</p> + + <p>See <a href="#Using_profiles">Using profiles</a> for more information.</p> + </td> + </tr> + <tr> + <td><code>-v --verbose</code></td> + <td>Verbose operation.</td> + </tr> + <tr> + <td><code>--no-copy</code></td> + <td> + <div class="warning">Use with caution because <code>jpm run|test</code> changes many preferences, never use with your main profile.</div> + + <div class="note">This only applies when <code>--profile</code> is used.</div> + Disables the copying of the profile used, which allows one to reuse a profile.</td> + </tr> + </tbody> +</table> + +<h3 id="jpm_test">jpm test</h3> + +<p>Use this command to run an add-on's unit tests. The command:</p> + +<ul> + <li>Looks for a directory called "test" within the current directory (or <code>--addon-dir</code>).</li> + <li>Opens every file in there whose name starts with "test-". Make note of the hyphen after "test" in the filename. <code>jpm test</code> include a file called "test-myCode.js", but will exclude files called "test_myCode.js" or "testMyCode.js")</li> + <li>call every function exported from that file whose name starts with "test".</li> +</ul> + +<pre class="brush: bash">jpm test +</pre> + +<p>See the <a href="/en-US/Add-ons/SDK/Tutorials/Unit_testing">tutorial on unit testing</a> and the <a href="/en-US/Add-ons/SDK/Low-Level_APIs/test_assert">reference documentation for the <code>assert</code> module</a> for more details on this.</p> + +<p><code>jpm test</code> accepts the following options:</p> + +<table class="fullwidth-table standard-table"> + <tbody> + <tr> + <td><code>-b --binary BINARY</code></td> + <td> + <p>Use the version of Firefox specified in BINARY. BINARY may be specified as a full path or as a path relative to the current directory.</p> + + <pre class="brush: bash"> +jpm test -b /path/to/Firefox/Nightly</pre> + + <p>See <a href="/en-US/Add-ons/SDK/Tools/jpm#Selecting_a_browser_version">Selecting a browser version</a>.</p> + </td> + </tr> + <tr> + <td><code>--binary-args CMDARGS</code></td> + <td> + <p>Pass <a href="http://kb.mozillazine.org/Command_line_arguments">extra arguments</a> to Firefox.</p> + + <p>For example, to pass the <code>-jsconsole</code> argument to Firefox, which will launch the <a href="/en-US/docs/Tools/Browser_Console">Browser Console</a>, try the following:</p> + + <pre class="brush: bash"> +jpm test --binary-args -jsconsole</pre> + + <p>To pass multiple arguments, or arguments containing spaces, quote them:</p> + + <pre class="brush: bash"> +jpm test --binary-args '-url mzl.la -jsconsole'</pre> + </td> + </tr> + <tr> + <td><code>--debug</code></td> + <td>Run the <a href="/en-US/Add-ons/Add-on_Debugger">Add-on Debugger</a> attached to the add-on.</td> + </tr> + <tr> + <td style="width: 30%;"><code>-f --filter FILE[:TEST]</code></td> + <td> + <p>Only run tests whose filenames match FILE and optionally match TEST, both regexps.</p> + + <pre class="brush: bash"> +jpm test --filter base64:btoa</pre> + + <p>The above command only runs tests in files whose names contain "base64", and in those files only runs tests whose names contain "btoa".</p> + </td> + </tr> + <tr> + <td style="width: 30%;"><code>-o --overload PATH</code></td> + <td> + <p>Rather than use the SDK modules built into Firefox, use the modules found at PATH. If <code>-o</code> is specified and PATH is omitted, jpm will look for the JETPACK_ROOT environment variable and use its value as the path.</p> + + <p>See <a href="/en-US/Add-ons/SDK/Tools/jpm#Overloading_the_built-in_modules">Overloading the built-in modules</a> for more information.</p> + </td> + </tr> + <tr> + <td style="width: 30%;"><code>-p --profile<code> PROFILE</code></code></td> + <td> + <p>By default, jpm uses a clean temporary Firefox <a href="https://support.mozilla.org/en-US/kb/profiles-where-firefox-stores-user-data">profile</a> each time you call jpm run. Use the <code>--profile</code> option to instruct jpm to launch Firefox with an existing profile.</p> + + <p>The PROFILE value may be a profile name or the path to the profile.</p> + + <p>See <a href="#Using_profiles">Using profiles</a> for more information.</p> + </td> + </tr> + <tr> + <td><code>--stop-on-error</code></td> + <td> + <p>By default, jpm test keeps running tests even after tests fail. Specify <code>--stop-on-error</code> to stop running tests after the first failure:</p> + + <pre class="brush: bash"> +jpm test --stop-on-error</pre> + </td> + </tr> + <tr> + <td><code>--tbpl</code></td> + <td>Print test output in <a href="https://treeherder.mozilla.org/">Treeherder</a> format</td> + </tr> + <tr> + <td><code>--times NUMBER</code></td> + <td> + <p>Run tests NUMBER of times:</p> + + <pre class="brush: bash"> +jpm test --times 2</pre> + </td> + </tr> + <tr> + <td><code>-v --verbose</code></td> + <td>Verbose operation.</td> + </tr> + <tr> + <td><code>--no-copy</code></td> + <td> + <div class="warning">Use with caution because <code>jpm run|test</code> changes many preferences, never use with your main profile.</div> + + <div class="note">This only applies when <code>--profile</code> is used.</div> + Disables the copying of the profile used, which allows one to reuse a profile.</td> + </tr> + </tbody> +</table> + +<h3 id="jpm_xpi">jpm xpi</h3> + +<p>This command packages the add-on as an <a href="/en-US/docs/XPI">XPI</a> file, which is the install file format for Mozilla add-ons.</p> + +<pre class="brush: bash">jpm xpi</pre> + +<p>It looks for a file called <code>package.json</code> in the current directory (or <code>--addon-dir</code>) and creates the corresponding XPI file. It ignores any ZIPs or XPIs in the add-on's root, and any test files. It includes all other files. If you want to exclude extra files, see <a href="/en-US/Add-ons/SDK/Tools/jpmignore">the .jpmignore file</a>.</p> + +<p>Once you have built an XPI file, you can distribute your add-on by submitting it to <a href="https://addons.mozilla.org/">addons.mozilla.org</a>.</p> + +<p><code>jpm xpi</code> accepts the following option:</p> + +<table class="fullwidth-table standard-table"> + <tbody> + <tr> + <td><code>--dest-dir</code></td> + <td> + <p>Optional destination directory for the generated XPI file. The current working directory is the default destination.</p> + </td> + </tr> + <tr> + <td><code>-v --verbose</code></td> + <td> + <p>Verbose operation:</p> + + <pre class="brush: bash"> +jpm xpi -v</pre> + </td> + </tr> + </tbody> +</table> + +<h3 id="jpm_post">jpm post</h3> + +<p>This command packages the add-on as an <a href="/en-US/docs/XPI">XPI</a> file then posts it to some URL.</p> + +<pre class="brush: bash">jpm post</pre> + +<p>It looks for a file called <code>package.json</code> in the current directory (or <code>--addon-dir</code>) and creates an XPI file with which to post to the <code>--post-url</code>.</p> + +<p><code>jpm post</code> accepts the following options:</p> + +<table class="fullwidth-table standard-table"> + <tbody> + <tr> + <td><code>--post-url URL</code></td> + <td> + <p>The URL to post the extension to after creating an XPI.</p> + + <pre class="brush: bash"> +jpm post --post-url http://localhost:8888/</pre> + + <p>See <a href="https://www.npmjs.com/package/jpm#using-post-and-watchpost">Using Post and Watchpost</a> for more information.</p> + </td> + </tr> + <tr> + <td><code>-v --verbose</code></td> + <td> + <p>Verbose operation:</p> + + <pre class="brush: bash"> +jpm post --post-url http://localhost:8888/ -v</pre> + </td> + </tr> + </tbody> +</table> + +<h3 id="jpm_watchpost">jpm watchpost</h3> + +<p>This command packages the add-on as an <a href="/en-US/docs/XPI">XPI</a> file then posts it to some URL whenever a file in the current working directory changes.</p> + +<pre class="brush: bash">jpm watchpost</pre> + +<p>Creates an XPI whenever a file changes in the current working directory (or <code>--addon-dir</code>) and posts that to the <code>--post-url</code>.</p> + +<p><code>jpm watchpost</code> accepts the following options:</p> + +<table class="fullwidth-table standard-table"> + <tbody> + <tr> + <td><code>--post-url URL</code></td> + <td> + <p>The URL to post the extension to after creating an XPI.</p> + + <pre class="brush: bash"> +jpm watchpost --post-url http://localhost:8888/</pre> + + <p>See <a href="https://www.npmjs.com/package/jpm#using-post-and-watchpost">Using Post and Watchpost</a> for more information.</p> + </td> + </tr> + <tr> + <td><code>-v --verbose</code></td> + <td> + <p>Verbose operation:</p> + + <pre class="brush: bash"> +jpm watchpost --post-url http://localhost:8888/ -v</pre> + </td> + </tr> + </tbody> +</table> + +<h3 id="jpm_sign">jpm sign</h3> + +<div class="note"> +<p>This feature is only supported from jpm 1.0.4 onwards.</p> +</div> + +<p>This command retrieves a new <a href="/en-US/docs/XPI">XPI</a> for your add-on signed by Mozilla. This allows you to <a href="#Supporting_updates_for_self-hosted_add-ons">self-host your add-on</a> so that users can install it without error when <a href="https://wiki.mozilla.org/Add-ons/Extension_Signing">signed add-ons are required</a>.</p> + +<p>You can sign an XPI you've already generated by passing the XPI file in the <code>--xpi</code> argument, like this:</p> + +<pre class="bz_comment_text" id="comment_text_2">jpm sign --api-key ${JWT_ISSUER} --api-secret ${JWT_SECRET} --xpi <xpi file></pre> + +<p>Alternatively, you can omit the <code>--xpi</code> argument, in which case <code>jpm sign</code> will generate an XPI from the current directory (or <code>--addon-dir</code>).</p> + +<pre class="brush: bash">jpm sign --api-key ${JWT_ISSUER} --api-secret ${JWT_SECRET}</pre> + +<p>This submits an <a href="/en-US/docs/XPI">XPI</a> it to the <a href="https://addons.mozilla.org/">addons.mozilla.org</a> <a href="https://olympia.readthedocs.org/en/latest/topics/api/signing.html">signing API</a>, then downloads a signed XPI to the working directory if it passes validation.</p> + +<p>To get values for <code>--api-key</code> and <code>--api-secret</code>, you will need to <a href="https://addons.mozilla.org/en-US/developers/addon/api/key/">create API credentials on addons.mozilla.org</a>. On the AMO key management page, these values are labeled "JWT_Issuer" and "JWT_Secret".</p> + +<p>Here are some possible outcomes of running the <code>sign</code> command:</p> + +<ul> + <li>Your add-on passed validation, was signed by Mozilla, and a new signed <a href="/en-US/docs/XPI">XPI</a> was downloaded to your working directory.</li> + <li>Your add-on failed validation, was not signed, and you got a link to a detailed report. After fixing the validation errors, you can run the command again.</li> + <li>You add-on passed validation but it could not be automatically signed because your add-on is <a href="/en-US/Add-ons/Distribution">listed</a>. Listed add-ons will require a manual review before they can be signed.</li> + <li>Your add-on at this exact version number already exists, so it was not signed. Increment the version number in your <a href="/en-US/Add-ons/SDK/Tools/package_json">package.json</a> file and run the command again.</li> +</ul> + +<p>Under the hood, <code>jpm sign</code> creates an unlisted add-on inside <a href="https://addons.mozilla.org/">addons.mozilla.org</a>, which means you must distribute the XPI file yourself for your users to install it. If you need to create a listed add-on, just <a href="https://addons.mozilla.org/en-US/developers/addon/submit/2">submit it directly to addons.mozilla.org</a> where it is signed automatically. See the <a href="/en-US/docs/Extension_Versioning%2C_Update_and_Compatibility#Debugging_and_solving_problems">debugging</a> section if you are experiencing difficulty installing a signed add-on.</p> + +<p><code>jpm sign</code> accepts the following options:</p> + +<table class="fullwidth-table standard-table"> + <tbody> + <tr> + <td><code>--api-key=JWT_ISSUER</code></td> + <td> + <p>API access key (string) generated on the <a href="https://addons.mozilla.org/en-US/developers/addon/api/key/">addons.mozilla.org key management page</a>.</p> + + <p>On the AMO key management page, this value is labeled "JWT Issuer".</p> + </td> + </tr> + <tr> + <td><code>--api-secret=JWT_SECRET</code></td> + <td> + <p>API access secret (string) generated on the <a href="https://addons.mozilla.org/en-US/developers/addon/api/key/">addons.mozilla.org key management page</a>. This value should be guarded with care and never checked into version control. If your secret is compromised, another developer could upload add-ons to your account. You should revoke and regenerate compromised API credentials immediately.</p> + + <p>On the AMO key management page, this value is labeled "JWT Secret".</p> + </td> + </tr> + <tr> + <td><code>--api-url-prefix=http://.../api</code></td> + <td> + <p>An optional API URL prefix in case you'd like to use a pre-production signing API.</p> + + <p>For example, you could pass <code>https://addons-dev.allizom.org/api/v3</code> to use the dev instance of <a href="https://addons.mozilla.org/">addons.mozilla.org</a>.</p> + </td> + </tr> + <tr> + <td><code>--xpi=/path/to/file.xpi</code></td> + <td> + <p>An <a href="/en-US/docs/XPI">XPI</a> file to sign. When no file is specified, a new XPI will be generated from the current directory (or <code>--addon-dir</code>).</p> + </td> + </tr> + </tbody> +</table> + +<h2 id="Techniques">Techniques</h2> + +<h3 id="Selecting_a_browser_version">Selecting a browser version</h3> + +<p>By default, <code>jpm run</code> and <code>jpm test</code> runs the release version of Firefox. You can instruct jpm to use a different version in one of two ways:</p> + +<ul> + <li> + <p>You can use the <code>-b</code> or <code>--binary</code> option to instruct jpm to run a different version of Firefox. You can supply a path to a specific binary:</p> + + <pre class="brush: bash">jpm run -b /path/to/Firefox/Nightly</pre> + + <p>As a shorthand for this, you can pass "nightly", "firefoxdeveloperedition", "aurora", "beta", or "firefox" and jpm will look in the default location for these Firefox versions [Note: As of Firefox 48, the shorthands "firefox" and "beta" will resolve to versions of Firefox which will not run your add-on. This is due to Firefox 48, and later, not having the option to run add-ons which are <a href="/en-US/docs/Mozilla/Add-ons/Distribution">unsigned</a>.]:</p> + + <pre class="brush: bash">jpm run -b nightly</pre> + </li> + <li> + <p>You can set the <code>JPM_FIREFOX_BINARY</code> environment variable with the path to the version of Firefox you want to run. When you invoke <code>jpm run</code> or <code>jpm test</code> without the <code>-b</code> option, jpm first checks <code>JPM_FIREFOX_BINARY</code>, and use this as the path if it is set.</p> + </li> +</ul> + +<h3 id="Using_.jpmignore_to_ignore_files">Using <code>.jpmignore</code> to ignore files</h3> + +<p>Using <code>.jpmignore</code> is similar to using <code>.gitignore</code> with <code>git</code>, <code>.hgignore</code> with Mercurial, or <code>.npmignore</code> with <code>npm</code>. By using this file, you can let <code>jpm</code> know which files you would like it to ignore when building a <code>.xpi</code> file with <code>jpm xpi</code>.</p> + +<p>Here is an example:</p> + +<pre class="brush: bash"># Ignore .DS_Store files created by mac +.DS_Store + +# Ignore any zip or xpi files +*.zip +*.xpi +</pre> + +<p>A <code>.jpmignore</code> file with the above contents would ignore all zip files and <code>.DS_Store</code> files from the xpi generated by <code>jpm xpi</code>.</p> + +<h3 id="Using_profiles">Using profiles</h3> + +<p>By default, <code>jpm run</code> uses a new profile each time it is executed. This means that any profile-specific data entered from one run of <code>jpm</code> is not, by default, available in the next run.</p> + +<p>This includes, for example, any extra add-ons you installed, or your history, or any data stored using the <a href="/en-US/Add-ons/SDK/High-Level_APIs/simple-storage">simple-storage</a> API.</p> + +<p>To make <code>jpm</code> use a specific profile, pass the <code>--profile</code> option, specifying the name of the profile you wish to use, or the path to the profile.</p> + +<pre class="brush: bash">jpm run --profile boogaloo +</pre> + +<pre class="brush: bash">jpm run --profile path/to/boogaloo</pre> + +<p>Use the <a href="https://support.mozilla.org/en-US/kb/profile-manager-create-and-remove-firefox-profiles">profile manager</a> to create a new profile if needed.</p> + +<p>If you need changes to the profile to persist, add the <code>--no-copy</code> argument. However beware that jpm might also apply changes to the profile, setting some preferences that will make it unusable for daily usage.</p> + +<h3 id="Developing_without_browser_restarts">Developing without browser restarts</h3> + +<p>Because <code>jpm run</code> restarts the browser each time you invoke it, it can be a little cumbersome if you are making very frequent changes to an add-on. An alternative development model is to use the <a href="https://addons.mozilla.org/en-US/firefox/addon/autoinstaller/" rel="noreferrer">Extension Auto-Installer</a> add-on: this listens for new XPI files on a specified port and installs them automatically. That way you can test new changes without needing to restart the browser:</p> + +<ul> + <li>make a change to your add-on</li> + <li>run <code>jpm post --post-url http://localhost:8888/</code>, to make an XPI and post it.</li> +</ul> + +<p>You could even automate this workflow with a simple script. For example:</p> + +<pre class="brush: bash">jpm watchpost --post-url http://localhost:8888/ +</pre> + +<p>Note that the logging level defined for the console is different when you use this method, compared to the logging level used when an add-on is run using <code>jpm run</code>. This means that if you want to see the output from <a href="/en-US/Add-ons/SDK/Tutorials/Logging" rel="noreferrer"><code>console.log()</code></a> messages, you have to tweak a setting. See the documentation on <a href="/en-US/Add-ons/SDK/Tools/console#Logging_Levels" rel="noreferrer">logging levels</a> for the details on this.</p> + +<h3 id="Overloading_the_built-in_modules">Overloading the built-in modules</h3> + +<p>The SDK modules you use to implement your add-on are built into Firefox. When you run or package an add-on using <code>jpm run</code> or <code>jpm xpi</code>, the add-on uses the versions of the modules in the version of Firefox that hosts it.</p> + +<p>As an add-on developer, this is usually what you want. But if you're developing the SDK modules themselves, of course, it isn't. In this case you need to:</p> + +<ul> + <li>Get a local copy of the SDK modules that you want: this usually means checking out the SDK from its <a href="https://github.com/mozilla/addon-sdk" rel="noreferrer">GitHub repo</a></li> + <li>Set the <code>JETPACK_ROOT</code> environment variable to your local copy</li> + <li>Pass the <code>-o</code> option to <code>jpm run</code> or <code>jpm xpi</code>:</li> +</ul> + +<pre class="brush:bash">jpm run -o +</pre> + +<p>This instructs jpm to use the local copies of the SDK modules, not the ones in Firefox. If you do not want to set the <code>JETPACK_ROOT</code> environment variable, you can pass the location of your copy of the SDK modules along with <code>-o</code>:</p> + +<pre class="brush:bash">jpm run -o "/path/to/addon-sdk/"</pre> + +<p>The path must be an absolute path and point to the SDK's root (not <code>addon-sdk/sdk</code> or <code>addon-sdk/sdk/lib</code>, for instance).</p> + +<h3 id="Supporting_updates_for_self-hosted_add-ons">Supporting updates for self-hosted add-ons</h3> + +<div class="note"> +<p>This feature is only supported from jpm 1.0.3 onwards.</p> +</div> + +<p>When you make updates to your add-on to add features or fix bugs, you'll want any previously installed versions of the add-on to update themselves to the new version.</p> + +<p>If you list your add-on on <a href="https://addons.mozilla.org/">addons.mozilla.org</a>, then all you have to do here is submit the new version; add-ons default to checking <a href="https://addons.mozilla.org/">addons.mozilla.org</a> for new versions of themselves. You can stop reading this section.</p> + +<p>If you do not list your add-on on <a href="https://addons.mozilla.org/">addons.mozilla.org</a>, you need to generate a Mozilla-signed XPI and tell Firefox where it can find new versions of your add-on. The way this works is:</p> + +<ul> + <li>you run <a href="/en-US/Add-ons/SDK/Tools/jpm#jpm_sign">jpm sign</a> anytime you need to create a new version</li> + <li>you host the signed add-on XPI and update it when you need to</li> + <li>you host an "update manifest", which, among other things, contains a URL pointing to the XPI</li> + <li>your add-on tells Firefox where it can find the update manifest</li> +</ul> + +<p>To do this, include two extra keys in package.json:</p> + +<ul> + <li><code><a href="/en-US/Add-ons/SDK/Tools/package_json#updateURL">updateURL</a></code>: This URL is included in the <a href="/en-US/docs/Mozilla/Add-ons/Install_Manifests">install manifest</a> of the XPI file that <code>jpm xpi</code> builds. It points to your update manifest. The <code>updateURL</code> value <em>may</em> be HTTPS. If it is not, then you'll also need to sign the update manifest, and then include the public key using the <code><a href="/en-US/Add-ons/SDK/Tools/package_json#updateKey">updateKey</a></code> field in package.json. See <a href="/en-US/docs/Extension_Versioning%2C_Update_and_Compatibility#Securing_Updates">Securing updates</a> for more on this.</li> + <li><code><a href="/en-US/Add-ons/SDK/Tools/package_json#updateLink">updateLink</a></code>: This URL is included in the update manifest file. It points to the XPI, and <em>must</em> be an HTTPS URL.</li> +</ul> + +<p><img alt="" src="https://mdn.mozillademos.org/files/11847/addons-update.svg" title="[https://mdn.mozillademos.org]"></p> + +<p>If you include <code>updateURL</code> and <code>updateLink</code> (and also <code>updateKey</code> in case <code>updateURL</code> is not HTTPS), then <code>jpm xpi</code> will:</p> + +<ul> + <li>Embed the value you supplied for <code>updateURL</code> in the XPI it generates.</li> + <li>Generate an update manifest alongside the XPI, and embed the value you supplied for <code>updateLink</code> in the manifest.</li> +</ul> + +<p>You then host the update manifest at <code>updateURL</code>, and host new versions of the XPI at <code>updateLink</code>.</p> + +<p>For some more details on this, see <a href="/en-US/docs/Extension_Versioning,_Update_and_Compatibility#Automatic_Add-on_Update_Checking">Automatic Add-on Update Checking</a>.</p> diff --git a/files/pl/archive/add-ons/api_przechowywania_sesji/index.html b/files/pl/archive/add-ons/api_przechowywania_sesji/index.html new file mode 100644 index 0000000000..ec38997ac2 --- /dev/null +++ b/files/pl/archive/add-ons/api_przechowywania_sesji/index.html @@ -0,0 +1,85 @@ +--- +title: API przechowywania sesji +slug: Archive/Add-ons/API_przechowywania_sesji +tags: + - Dodatki + - Rozszerzenia + - Wszystkie_kategorie +translation_of: Archive/Add-ons/Session_store_API +--- +<p> +</p><p><a href="pl/Firefox_2">Firefox 2</a> wprowadza mechanizm przechowywania sesji który umożliwia <a href="pl/Rozszerzenia">rozszerzeniom</a> łatwo zapisywać i przywracać dane pomiędzy sesjami Firefoksa. Istnieje też proste API, które umożliwia rozszerzeniom łatwy dostęp do zapisanych sesji. +</p><p>Przykładem sytuacji, w której wsparcie dla tej funkcji może być kluczowe: Firefox 2 pozwala użytkownikom przywrócić uprzednio zamknięte karty. W celu prawidłowego przechowania stanu Twojego rozszerzenia kiedy karta zostaje przywrócona, musi ono skorzystać z metody API przechowywania sesji <code>setTabValue()</code>, aby zachować wszelkie dane, które potem będzie należało przywrócić, a następnie, podczas przywracania karty, wywołać <code>getTabValue()</code>, aby odzyskać uprzednio zachowane ustawienia. +</p><p>API przechowywania sesji jest zaimplementowane przy użyciu interfejsu <code><a href="pl/NsISessionStore">nsISessionStore</a></code>. +</p> +<h2 id="Sk.C4.85d_wiedzie.C4.87_kiedy_przywraca.C4.87.3F">Skąd wiedzieć kiedy przywracać?</h2> +<p>Za każdym razem kiedy Firefox ma przywrócić uprzednio zamkniętą kartę, zostaje wysłane zdarzenie <code>SSTabRestoring</code>. Jeżeli chcesz, aby Twoje rozszerzenie mogło przywracać dane podczas przywracania karty, wystarczy, że ustawisz nasłuch (listener) na to zdarzenie: +</p> +<pre>function myExtensionHandleRestore(aEvent) { + Components.classes["@mozilla.org/consoleservice;1"]. + getService(Components.interfaces.nsIConsoleService). + logStringMessage("przywracanie kart"); +}; + +document.addEventListener("SSTabRestoring", myExtensionHandleRestore, false); +</pre> +<p>Po prostu zastąp treść funkcji <code>myExtensionHandleRestore()</code> swoim własnym kodem. W powyższym przykładzie został użyty serwis (service) <code><a href="pl/NsIConsoleService">nsIConsoleService</a></code>, do wyświetlenia wiadomość w <a href="pl/Konsola_b%c5%82%c4%99d%c3%b3w">konsoli</a>. +</p><p>Zdarzenie jest wysyłane tuż przed przywróceniem karty. Zdarzenie typu <code>SSTabRestored</code> jest wysyłane po przywróceniu ostatniej karty. +</p> +<h2 id="Proces_przywracania_sesji">Proces przywracania sesji</h2> +<p>Dokładna sekwencja zdarzeń, która jest wykonywana podczas przywracania sesji wygląda tak: +</p> +<ol><li> Stan sesji ma zostać przywrócony. Może się to zdarzyć podczas startu przeglądarki, albo w wyniku akcji Przywróć Zamkniętą Kartę, ponieważ zamknięte karty są przywracane jako sesje pojedyńczych kart. +</li><li> Nowe okna są otwierane zgodnie z kolejnością (jedno na każde okno, które zostało zachowane), następnie przywracane są ciastka oraz ostatnio zamknięte karty. +</li></ol> +<p>Po tym, dla każdej przywracanej karty, zostają podjęte następujące kroki: +</p> +<ol><li> Albo wykorzystywana jest istniejąca karta, albo tworzona nowa. W drugim przypadku, wysyłane jest zdarzenie <code>TabOpen</code>. +</li><li> Przywracane są przechowywane stałe atrybuty XUL (ang. persistent attributes) (te zapisane poprzez odwołania do <code><a href="pl/NsISessionStore#persistTabAttribute.28.29">persistTabAttribute()</a></code>) oraz uprawnienia. +</li><li> Wysyłane jest zdarzenie <code>SSTabRestoring</code>. +</li><li> Karta zaczyna pobierać URL, który ma wyświetlić. +</li><li> Po zakończeniu ładowania strony, przywracane są stany pól tekstowych i przewijania. +</li><li> Na końcu, wysyłane jest zdarzenie <code>SSTabRestored</code>. +</li></ol> +<p>Jeżeli chcesz ustawić uprawnienia lub w inny sposób zmieniać przywracaną kartę przed załadowaniem strony, powinieneś obserwować <code>SSTabRestoring</code>. Jeżeli chcesz zrobić coś po załadowaniu strony, należy obserwować <code>SSTabRestored</code>. +</p><p>Oba zdarzenia są zawsze wysyłane dla każdej, przywracanej, karty. Możesz określić, która karta jest przywracana przez sprawdzenie pola <code>originalTarget</code> z obiektu zdarzenia. +</p><p>Właściwie nie istnieje metoda na określenie kiedy ostatnia karta została przywrócona, chyba, że określisz ile kart ma zostać przywróconych, a następnie policzysz zdarzenia <code>SSTabRestored</code>. +</p> +<h2 id="Wykorzystanie_API_przechowywania_sesji">Wykorzystanie API przechowywania sesji</h2> +<p>Tutaj opisujemy kilka prostych przykładów wykorzystania API przechowywania sesji. +</p> +<h3 id="Zachowywanie_warto.C5.9Bci_dla_karty">Zachowywanie wartości dla karty</h3> +<p>Poniższy kod dołączy do karty parę klucz/wartość. Po przywróceniu karty, ta para będzie z nią powiązana. +</p> +<pre class="eval"> var ss = Components.classes["@mozilla.org/browser/sessionstore;1"]. + getService(Components.interfaces.nsISessionStore); + var currentTab = getBrowser().selectedTab; + var dataToAttach = "Chcę to przyłączyć"; + ss.setTabValue(currentTab, "key-name-here", dataToAttach); +</pre> +<p>Ten kod ustawia wartość klucza "key-name-here" na <var>dataToAttach</var>. Możesz tu użyć dowolnego obiektu JavaScript jako danych. +</p> +<h3 id="Pobieranie_zachowanej_warto.C5.9Bci">Pobieranie zachowanej wartości</h3> +<p>W dowolnym momencie możesz pobrać wartość powiązaną z kartą (niezależnie czy karta jest w takcie przywracania czy nie), używając takiego kodu: +</p> +<pre class="eval"> var ss = Components.classes["@mozilla.org/browser/sessionstore;1"]. + getService(Components.interfaces.nsISessionStore); + var currentTab = getBrowser().selectedTab; + var retrievedData = ss.getTabValue(currentTab, "key-name-here"); +</pre> +<p>Po wykonaniu tego kodu, zmienna <var>retrivedData</var> zawiera zachowaną wartość dla klucza "key-name-here". <var>retrievedData</var> pozostanie jako undefined jeśli nie została zachowana żadna wartość dla tego klucza. +</p> +<h3 id="Usuwanie_warto.C5.9Bci_powi.C4.85zanej_z_kart.C4.85">Usuwanie wartości powiązanej z kartą</h3> +<p>Aby usunąć wartość z karty, możesz skorzystać z poniższego kodu: +</p> +<pre class="eval"> var ss = Components.classes["@mozilla.org/browser/sessionstore;1"]. + getService(Components.interfaces.nsISessionStore); + var currentTab = getBrowser().selectedTab; + ss.deleteTabValue(currentTab, "key-name-here"); +</pre> +<h3 id="Uwagi">Uwagi</h3> +<p>Funkcje zachowywania i przywracania dla okien działają tak samo jak te dla kart (z uwzględnieniem zmian w nazwach). +</p> +<h2 id="Zobacz_te.C5.BC">Zobacz też</h2> +<p><a href="pl/NsISessionStore">nsISessionStore</a> +</p>{{ languages( { "es": "es/API_de_restauraci\u00f3n_de_sesi\u00f3n", "fr": "fr/API_de_restauration_de_session", "ja": "ja/Session_store_API", "en": "en/Session_store_API" } ) }} diff --git a/files/pl/archive/add-ons/index.html b/files/pl/archive/add-ons/index.html new file mode 100644 index 0000000000..caac45ae4c --- /dev/null +++ b/files/pl/archive/add-ons/index.html @@ -0,0 +1,8 @@ +--- +title: Add-ons +slug: Archive/Add-ons +translation_of: Archive/Add-ons +--- +<p>In progress. Archived add-ons documentation.</p> + +<p>{{SubpagesWithSummaries}}</p> diff --git a/files/pl/archive/add-ons/wsparcie_dla_podpowiedzi_wyszukiwania_w_wyszukiwarkach/index.html b/files/pl/archive/add-ons/wsparcie_dla_podpowiedzi_wyszukiwania_w_wyszukiwarkach/index.html new file mode 100644 index 0000000000..abea49f93b --- /dev/null +++ b/files/pl/archive/add-ons/wsparcie_dla_podpowiedzi_wyszukiwania_w_wyszukiwarkach/index.html @@ -0,0 +1,58 @@ +--- +title: Wsparcie dla podpowiedzi wyszukiwania w wyszukiwarkach +slug: Archive/Add-ons/Wsparcie_dla_podpowiedzi_wyszukiwania_w_wyszukiwarkach +tags: + - Dodatki + - Wszystkie_kategorie + - Wtyczki_wyszukiwarek +translation_of: Archive/Add-ons/Supporting_search_suggestions_in_search_plugins +--- +<p> +</p><p>MozSearch wspiera podpowiedzi wyszukiwania; gdy użytkownik wprowadza dane w panelu wyszukiwania, <a href="pl/Firefox_2">Firefox 2</a> przesyła zapytanie do adresu URL określonego przez wtyczkę wyszukiwarki, aby dostarczyć dynamiczne podpowiedzi wyszukiwania. +</p><p>Gdy lista zostanie dostarczona, może ona być wyświetlona w wyskakującym okienku (popup), które pojawia się pod panelem wyszukiwania i pozwala użytkownikowi wybrać jeden z sugerowanych wyników. Jeśli użytkownik będzie kontynuował wpisywanie, zażądany zostanie nowy zestaw podpowiedzi z silnika wyszukiwarki i zastąpi on obecnie wyświetlaną listę. +</p><p>Wtyczki wyszukiwania Yahoo i Google dołączone z Firefoksem 2 obsługują podpowiedzi wyszukiwania. +</p> +<h2 id="Implementowanie_obs.C5.82ugi_podpowiedzi_we_wtyczkach_wyszukiwarek" name="Implementowanie_obs.C5.82ugi_podpowiedzi_we_wtyczkach_wyszukiwarek">Implementowanie obsługi podpowiedzi we wtyczkach wyszukiwarek</h2> +<p>Aby obsługiwać podpowiedzi wyszukiwania, wtyczka musi posiadać zdefiniowany dodatkowy element <code><Url></code> wraz z atrybutem <code>type</code> ustawionym na <code>"application/x-suggestions+json"</code> (oznacza to, że wtyczka wyszukiwarki obsługująca podpowiedzi będzie mieć dwa elementy <code><Url></code>, z których jeden jest głównym adresem URL typu <code>text/html</code> i odpowiada za wyszukiwarkę). +</p><p>Na przykład, wtyczka wyszukiwarki Yahoo posiada taki wpis <code><Url></code>: +</p> +<pre><Url type="application/x-suggestions+json" template="http://ff.search.yahoo.com/gossip?output=fxjson&command={searchTerms}"/> +</pre> +<p>Jeśli użytkownik wprowadzi "fir" w panelu wyszukiwania, po czym się zatrzyma, Firefox umieści "fir" w miejsce <code>{searchTerms}</code> i wyśle zapytanie do takiego adresu URL: +</p> +<pre><Url type="application/x-suggestions+json" template="http://ff.search.yahoo.com/gossip?output=fxjson&command=fir"/> +</pre> +<p>Wyniki są używane do stworzenia okienka z listą podpowiedzi. +</p><p>Zobacz <a href="pl/Tworzenie_wtyczek_MozSearch">Tworzenie wtyczek MozSearch</a>, aby dowiedzieć się więcej o tym, jak zaimplementować wtyczkę wyszukiwarki. +</p> +<h2 id="Implementowanie_obs.C5.82ugi_podpowiedzi_na_serwerze" name="Implementowanie_obs.C5.82ugi_podpowiedzi_na_serwerze">Implementowanie obsługi podpowiedzi na serwerze</h2> +<p>Większość z obsługi podpowiedzi wyszukiwania jest obecnie implementowane po stronie serwera. Jeśli jesteś projektantem strony internetowej i chcesz wspierać podpowiedzi wyszukiwania, musisz zaimplementować obsługę zwracania podpowiedzi w <a class="external" href="http://www.json.org/">Notacji Obiektu JavaScript</a> (JavaScript Object Notation - JSON). +</p><p>Gdy przeglądarka chce otrzymać możliwe wyniki dla szukanego wyrażenia, wysyła ona żądanie HTTP GET do adresu URL określonego w elemencie <code><Url></code>. +</p><p>Wtedy Twój serwer powinien wybrać podpowiedzi, które jego zdaniem pasują do określonych warunków wyszukiwania i stworzyć JSON, który składa się z co najmniej dwóch i co najwyżej z czterech elementów: +</p> +<dl><dt> <b>łańcuch zapytania</b> +</dt><dd> Pierwszy element w JSON jest oryginalnym łańcuchem znaków zapytania. Pozwala to Firefoksowi zweryfikować czy podpowiedzi odpowiadają obecnym warunkom wyszukiwania. +</dd></dl> +<dl><dt> <b>lista dopełnienia</b> +</dt><dd> Tablica sugerowanych warunków wyszukiwania. Tablica powinna być ograniczona nawiasami kwadratowymi. Na przykład: <tt>{{ mediawiki.external('\"warunek 1\", \"warunek 2\", \"warunek 3\", \"warunek 4\"') }}</tt> +</dd></dl> +<dl><dt> <b>opisy</b> +</dt><dd> Ten opcjonalny element jest tablicą, składającą się z opisów dla każdej podpowiedzi określonej w elemencie <i>lista dopełnienia</i>. Mogą to być dodatkowe informacje, które silnik wyszukiwarki może zwrócić do wyświetlenia przez przeglądarkę, jak na przykład ilość wyników dostępnych dla tego wyszukiwania. +</dd></dl> +<div class="note">Opisy nie są obsługiwane w Firefoksie 2 i w przypadku ich zdefiniowania są one ignorowane.</div> +<dl><dt> <b>adresy URL zapytania</b> +</dt><dd> Ten opcjonalny element jest tablicą alternatywnych adresów URL dla każdej podpowiedzi w elemencie <i>lista dopełnienia</i>. Na przykład, jeśli chcesz zaproponować mapę odnośników zamiast strony z wynikami wyszukiwania dla podanej podpowiedzi, możesz w tej tablicy zwrócić adres URL do mapy. +</dd></dl> +<dl><dd> Jeśli nie określisz adresu URL zapytania, użyte zostanie domyślne zapytanie oparte na wyszukiwarce opisanej przez element <code><Url></code> w opisie XML wtyczki wyszukiwania. +</dd></dl> +<div class="note">Element "adresy URL zapytania" nie jest obsługiwany w Firefoksie 2 i jest ignorowany.</div> +<p>Na przykład, jeśli wyrażeniem wyszukiwania jest "fir" i nie zwracasz opisów i alternatywnych adresów URL zapytania, możesz zwrócić następujący JSON: +</p> +<pre class="eval">["fir", ["firefox", "first choice", "mozilla firefox"]] +</pre> +<p>Zauważ, że w tym przykładzie określony jest tylko łańcuch zapytania i lista dopełnienia, z pominięciem elementów opcjonalnych. +</p><p>Twoja lista dopełnienia może zawierać tyle wiele podpowiedzi, ile tylko chcesz, jednak powinna ona być łatwa w obsłudze, zwłaszcza że będzie ona dynamicznie uaktualniana podczas wpisywania przez użytkownika słów do wyszukania. Ponadto metoda, której będziesz używał do wyboru podpowiedzi, zależy wyłącznie od Ciebie. +</p> +<div class="noinclude"> +</div> +{{ languages( { "ca": "ca/Implementaci\u00f3_de_suggeriments_en_els_connectors_de_cerca", "en": "en/Supporting_search_suggestions_in_search_plugins", "es": "es/Permitir_sugerencias_en_los_plugins_de_b\u00fasqueda", "fr": "fr/Gestion_de_suggestions_dans_les_plugins_de_recherche", "it": "it/Supportare_i_suggerimenti_nei_plugin_di_ricerca", "ja": "ja/Supporting_search_suggestions_in_search_plugins", "zh-tw": "zh_tw/\u8b93\u641c\u5c0b\u6a21\u7d44\u652f\u63f4\u641c\u5c0b\u5efa\u8b70" } ) }} diff --git a/files/pl/archive/b2g_os/add-ons/index.html b/files/pl/archive/b2g_os/add-ons/index.html new file mode 100644 index 0000000000..7fe91371cd --- /dev/null +++ b/files/pl/archive/b2g_os/add-ons/index.html @@ -0,0 +1,58 @@ +--- +title: Firefox OS add-ons +slug: Archive/B2G_OS/Add-ons +translation_of: Archive/B2G_OS/Add-ons +--- +<p class="summary">Firefox OS 2.5 introduces support for add-ons, a feature that desktop users have known and loved since the beginning of Firefox. Add-ons on Firefox OS are even more powerful and can customize not only the browser, but the whole phone experience, including tweaks to the homescreen and system apps like E-Mail and Messages. This page tells you everything you need to know to get started with creating Firefox OS add-ons and get involved with the add-ons community.</p> + +<div class="note"> +<p dir="ltr"><strong>Note</strong>: Firefox OS add-ons are based on the <a href="/en-US/docs/Mozilla/Add-ons/WebExtensions">WebExtensions API</a>, which is also supported in Firefox desktop starting with version 42 and is based on the extension APIs used in Chrome and Opera.</p> +</div> + +<h2 id="Prerequisites">Prerequisites</h2> + +<p>You should follow the below steps to get set up to start developing extensions.</p> + +<h3 dir="ltr" id="1._Flash_your_phone_to_Firefox_OS_2.5">1. Flash your phone to Firefox OS 2.5</h3> + +<p dir="ltr">Firefox OS add-ons are only supported on Firefox OS 2.5 and later. Here’s a list of supported devices and how to update them (this list is incomplete, and will be added to as time goes on.)</p> + +<ul> + <li dir="ltr">Flame (recommended): See <a href="/en-US/Firefox_OS/Phone_guide/Flame/Updating_your_Flame#Quick_guide_to_updating_your_device">Quick guide to updating your Flame</a>.</li> +</ul> + +<h3 id="2._Enable_USB_Debugging">2. Enable USB Debugging</h3> + +<p>In the <em>Settings</em> app on the device, select <em>Developer > Debugging via USB > ADB and Devtools</em>. You should now be able to debug installed apps using WebIDE, either via a USB cable, <a href="/en-US/docs/Tools/Remote_Debugging/Debugging_Firefox_OS_over_Wifi">and over Wifi</a> (no USB cable required.)</p> + +<h3 id="3._Set_up_WebIDE">3. Set up WebIDE</h3> + +<p>The <a href="/en-US/docs/Tools/WebIDE">WebIDE</a> tool is part of Firefox and can be used to install add-ons on your phone during development — see <a href="/en-US/docs/Mozilla/Firefox_OS/Add-ons/Developing_Firefox_OS_add-ons#Testing_your_add-on_using_WebIDE">Testing your add-on using WebIDE</a> for more information.</p> + +<h2 id="See_also">See also</h2> + +<h3 id="Developing">Developing</h3> + +<ul> + <li dir="ltr"><strong>Tutorial</strong>: <a href="https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Add-ons/Developing_Firefox_OS_add-ons">https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Add-ons/Developing_Firefox_OS_add-ons</a></li> + <li dir="ltr"><strong>In-depth example</strong>: <a href="https://hacks.mozilla.org/2015/11/building-an-ios-style-unread-notifications-add-on-for-firefox-os/">https://hacks.mozilla.org/2015/11/building-an-ios-style-unread-notifications-add-on-for-firefox-os/</a></li> + <li dir="ltr"><strong>API reference</strong>: <a href="https://developer.mozilla.org/en-US/Add-ons/WebExtensions">https://developer.mozilla.org/en-US/Add-ons/WebExtensions</a></li> +</ul> + +<h3 dir="ltr" id="Distributing">Distributing</h3> + +<ul> + <li dir="ltr"><strong>Submitting to Marketplace</strong>: <a href="/en-US/docs/Mozilla/Marketplace/Add-on_submission">Add-on submission</a></li> + <li dir="ltr"><strong>Review criteria</strong> (working draft): <a href="/en-US/docs/Mozilla/Marketplace/Add-on_submission/Review_criteria">Add-on review criteria</a></li> +</ul> + +<h3 dir="ltr" id="Get_involved">Get involved</h3> + +<ul> + <li dir="ltr"><strong>Mailing list</strong>: <a href="https://mail.mozilla.org/listinfo/dev-addons">https://mail.mozilla.org/listinfo/dev-fxos</a></li> + <li dir="ltr"><strong>Discourse forum</strong>: <a href="https://discourse.mozilla-community.org/c/add-ons/development">https://discourse.mozilla-community.org/c/add-ons/development</a></li> + <li dir="ltr"><strong>IRC</strong>: irc.mozilla.org, #webextensions and #fxos</li> + <li dir="ltr"><strong>Join the unofficial Telegram group</strong>: <a href="https://telegram.me/joinchat/BTLPMAC90O9n8cpgsZ03_A">https://telegram.me/joinchat/BTLPMAC90O9n8cpgsZ03_A</a></li> + <li dir="ltr"><strong>Let us know what new APIs we should prioritize</strong>: <a href="https://webextensions.uservoice.com/forums/315663-webextension-api-ideas">https://webextensions.uservoice.com/forums/315663-webextension-api-ideas</a></li> + <li dir="ltr"><strong>Follow us on Twitter</strong>: <a href="https://twitter.com/MozWebExt">@MozWebExt</a></li> +</ul> diff --git a/files/pl/archive/b2g_os/firefox_os_wstępne_budowanie/index.html b/files/pl/archive/b2g_os/firefox_os_wstępne_budowanie/index.html new file mode 100644 index 0000000000..f9e294568c --- /dev/null +++ b/files/pl/archive/b2g_os/firefox_os_wstępne_budowanie/index.html @@ -0,0 +1,381 @@ +--- +title: Firefox OS wstępne budowanie +slug: Archive/B2G_OS/Firefox_OS_wstępne_budowanie +translation_of: Archive/B2G_OS/B2G_OS_build_prerequisites +--- +<div class="summary"> + <p><span class="seoSummary">Before obtaining the code to build Firefox OS, you need a properly configured <a href="https://developer.mozilla.org/en-US/docs/Developer_Guide/Build_Instructions" title="https://developer.mozilla.org/en-US/docs/Developer_Guide/Build_Instructions">build system</a> — this page shows you how. You can currently build on 64-bit Linux distributions and OS X.</span></p> +</div> +<div class="note"> + <p><strong>Note</strong>: To build Firefox OS onto a phone, begin with your phone NOT connected to your computer. We'll tell you when to plug it in.</p> +</div> +<h2 id="Posiadaj_kompatybilne_urządzenieemulator">Posiadaj kompatybilne urządzenie/emulator</h2> +<p>You need to have a compatible device to build onto, or to use an emulator. Though we support several phones, some have multiple variations. We currently support specific variations and some devices have better support than others.</p> +<div class="note"> + <p><strong>Note</strong>: Mozilla's <a href="https://github.com/mozilla-b2g/B2G">B2G source code</a> effectively is the reference implementation of B2G, but phone vendors are free to add patches or make changes. When you buy an Alcatel One Touch for example, it contains the vendor's version. This doesn't make a difference for the installed apps, but it can at the platform level. The Nexus 4 port is maintained directly by Mozilla; so it's a lot more likely to work with our version of Gecko out of the box than other tier 3 devices.</p> +</div> +<h3 id="Krok_1">Krok 1</h3> +<p>Tier 1 devices represent a primary target for development and will typically be the first to receive bug fixes and feature updates.</p> +<dl> + <dt> + Keon</dt> + <dd> + Keon is the <a href="http://www.geeksphone.com/" title="http://www.geeksphone.com/">Geeksphone</a> Keon device, which was one of the initial developer phones. Note that builds for this device are provided by Geeksphone.</dd> + <dt> + Inari</dt> + <dd> + Inari is another testing device. Use this configuration to build for the ZTE Open device. <strong>Warning:</strong> newer builds of Firefox OS may have trouble booting on the ZTE Open's default boot partition.</dd> + <dt> + <a href="/en-US/docs/Mozilla/Firefox_OS/Using_the_B2G_emulators" title="en-US/docs/Mozilla/Firefox_OS/Using_the_B2G_emulators">Emulator (ARM and x86)</a></dt> + <dd> + There are two emulators available: one emulates ARM code and the other runs everything in x86 code. <a href="/en-US/docs/Mozilla/Firefox_OS/Using_the_B2G_emulators" title="/en-US/docs/Mozilla/Firefox_OS/Using_the_B2G_emulators">Learn more about installing and using the emulators</a>.</dd> + <dd> + <strong>Note that you shouldn't use the x86 emulator — it is hard to install and not well supported.</strong></dd> + <dt> + <a href="/en-US/docs/Mozilla/Firefox_OS/Using_the_B2G_desktop_client" title="/en-US/docs/Mozilla/Firefox_OS/Using_the_B2G_desktop_client">Desktop</a></dt> + <dd> + You can also build a desktop version of Firefox OS; this runs <a href="/en-US/docs/Mozilla/Gecko" title="/en-US/docs/Mozilla/Gecko">Gecko</a> in a <a href="/en-US/docs/XULRunner" title="/en-US/docs/XULRunner">XULRunner</a> application, and you then use the <a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Gaia/Introduction_to_Gaia" title="/en-US/docs/Mozilla/Firefox_OS/Platform/Gaia/Introduction_to_Gaia">Gaia</a> user experience inside it.</dd> +</dl> +<p>You can, of course, build the <a href="/en-US/docs/Mozilla/Firefox_OS/Using_the_B2G_desktop_client" title="en-US/docs/Mozilla/Firefox_OS/Using_the_B2G_desktop_client">desktop client</a> or one of the <a href="/en-US/docs/Mozilla/Firefox_OS/Using_the_B2G_emulators" title="en-US/docs/Mozilla/Firefox_OS/Using_the_B2G_emulators">emulators</a> without a phone.</p> +<h3 id="Krok_2">Krok 2</h3> +<p><span id="answer_long1" style="display: block;">Tier 2 devices are generally functional and many developers (especially app developers) are using them, so they tend to pick up changes secondarily.</span></p> +<dl> + <dt> + <a href="/en-US/docs/Mozilla/Firefox_OS/Samsung_Nexus_S" title="/en-US/docs/Mozilla/Firefox_OS/Samsung_Nexus_S"><span class="link-https">Samsung Nexus S</span></a></dt> + <dd> + The known working model numbers of Nexus S devices are GT-I9020A and GT-I9023. Others may work.</dd> + <dt> + Samsung Nexus S 4G</dt> + <dd> + The SPH-D720 is supported as a tier 2 device.</dd> +</dl> +<h3 id="Krok_3">Krok 3</h3> +<p><span id="answer_long1" style="display: block;">Firefox OS can be built for these devices, but they are not being actively worked on a regular basis by core developers. Their reliability and feature set may lag noticeably behind tier 1 and even tier 2 devices.</span></p> +<dl> + <dt> + Samsung Galaxy S2</dt> + <dd> + The only model that works is the i9100; no other variants are officially compatible. (i9100P might work, since the only change is a NFC chip added)</dd> + <dt> + Samsung Galaxy Nexus</dt> + <dd> + We are not currently aware of any variations that are not compatible.</dd> + <dt> + Nexus 4</dt> + <dd> + Some users on IRC have tested this successfully. May or may not require reflashing to Android 4.3 first if was running 4.4 (Android <a href="https://developers.google.com/android/nexus/images#occamjwr66y">images available from Google</a>)</dd> + <dt> + Nexus 5</dt> + <dd> + Some users on IRC have tested this successfully.</dd> + <dt> + Tara</dt> + <dd> + Tara is another testing device. Manifest of Tara is in master branch only. The script of getting Tara code is "BRANCH=master ./config.sh tara".</dd> + <dt> + Unagi</dt> + <dd> + Unagi is a phone being used as a test and development platform as a low-to-midrange smartphone. Many core Firefox OS developers are working on Unagi.</dd> + <dt> + <a href="/en-US/docs/Mozilla/Firefox_OS/Pandaboard" title="/en-US/docs/Mozilla/Firefox_OS/Pandaboard">Pandaboard</a></dt> + <dd> + The Pandaboard is a development board based on the OMAP 4 architecture, used to do development work on mobile platforms.</dd> +</dl> +<div class="warning"> + <strong>Important</strong>: Only devices running at least <strong>Android 4</strong> (aka <strong>Ice Cream Sandwich</strong>) are supported. If your device is listed above but running an older version of Android, please update it before doing anything.</div> +<div class="note"> + <p><strong>Note</strong>: Tier 2 and Tier 3 devices have a software home button instead of a hardware home button</p> + <p>All Tier 1 devices have a hardware Home button which returns the user to the home screen. Most current ICS based Android devices use onscreen touch buttons for navigation. We have a virtual home button for the devices without hardware home button now. If it's not automatically enabled, <span style="line-height: 1.5em; font-size: 14px;">open the Settings app, go to the <a href="/en-US/Firefox_OS/Debugging/Developer_settings">Developer settings</a>, and then toggle on the <a href="/en-US/Firefox_OS/Debugging/Developer_settings#Enable_software_home_button">Enable software home button</a> preference.</span></p> + <p><span style="line-height: 1.5em; font-size: 14px;">In 1.4 there is also a developer option for "Home gesture enabled"; enabling that will remove the on-screen home button in favor of swiping up from the bottom of the screen.</span></p> +</div> +<h2 id="Wymagania_dla_systemu_GNULinux">Wymagania dla systemu GNU/Linux</h2> +<p>To build on Linux, you'll need:</p> +<ul> + <li>A <strong>64 bit GNU/Linux</strong> distribution (Ubuntu 12.04 recommended).</li> + <li>At least <strong>4 GB</strong> of RAM.</li> + <li>At least <strong>30 GB</strong> of available hard disk space.</li> +</ul> +<p>This is more than the bare minimum, but sometimes building fails just because it's missing resources. A typical error in this case is "<span style="line-height: 1.5;"><strong>arm-linux-androideabi-g++: Internal error: Killed (program cc1plus)</strong>".</span></p> +<p>You will also need the following tools installed:</p> +<ul> + <li><strong>autoconf 2.13</strong></li> + <li><strong>bison</strong></li> + <li><strong>bzip2</strong></li> + <li><strong>ccache</strong></li> + <li><strong>curl</strong></li> + <li><strong>flex</strong></li> + <li><strong>gawk</strong></li> + <li><strong>git</strong></li> + <li><strong>gcc / g++ / g++-multilib</strong></li> + <li><strong>make</strong></li> + <li><strong>OpenGL shared libraries</strong></li> + <li><strong>patch</strong></li> + <li><strong>X11 headers</strong></li> + <li><strong>32-bit ncurses</strong></li> + <li><strong>32-bit zlib</strong></li> +</ul> +<h3 id="Emulator_build_issues"><strong>Emulator build issues</strong></h3> +<p>If you are making an <strong>emulator</strong> build, you need to pay attention to these issues:</p> +<div class="note"> + <p><strong>First, note that you shouldn't use the x86 emulator — it is hard to install and not well supported.</strong></p> +</div> +<p>Next, the build-system for the emulator builds both 32bit and 64bit versions of the emulator. As the emulator depends on OpenGL, this means that you need to have both 32bit and 64bit versions of OpenGL libraries installed on your system. See the discussion in <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=897727" title="https://bugzilla.mozilla.org/show_bug.cgi?id=897727">bug 897727</a>.</p> +<p>There are two ways that you can solve this problem:</p> +<h4 id="Solution_1_have_both_32bit_and_64bit_OpenGL_libs_installed_with_the_right_symlinks">Solution #1: have both 32bit and 64bit OpenGL libs installed, with the right symlinks</h4> +<p>If your linux distro has multilib packages for OpenGL libraries, you can attempt installing them. You might then have to manually create some symlinks.</p> +<p>For example, here is the situation on Ubuntu 12.04 LTS x86-64. On this distribution, the <code>libgl1-mesa-dev</code> package cannot be installed simultaneously in x86-64 and i386 versions, but you can have the following combination of packages simultaneously installed:</p> +<pre class="bz_comment_text" id="comment_text_12">sudo apt-get install libgl1-mesa-dev libglapi-mesa:i386 libgl1-mesa-glx:i386</pre> +<p>After having run this command, you will still have to manually create some symlinks for the emulator build to succeed:</p> +<pre class="note">sudo ln -s /usr/lib/i386-linux-gnu/libX11.so.6 /usr/lib/i386-linux-gnu/libX11.so +sudo ln -s /usr/lib/i386-linux-gnu/mesa/libGL.so.1 /usr/lib/i386-linux-gnu/libGL.so</pre> +<h4 id="Solution_2_just_patch_the_emulator_so_it_only_builds_64bit">Solution #2: just patch the emulator so it only builds 64bit</h4> +<p>Just apply <a href="https://bug897727.bugzilla.mozilla.org/attachment.cgi?id=786280" title="https://bug897727.bugzilla.mozilla.org/attachment.cgi?id=786280">this patch</a> to the sdk/ git repository under the B2G repo. This will cause the B2G emulator to only attempt to build the 64bit emulator if you're on a 64bit system, thus avoiding any multilib issues. The 32bit emulator is unused anyway on a 64bit system. This is the simplest solution, until this patch eventually bit-rots.</p> +<h3 id="64_bit_requirement_installation">64 bit requirement installation</h3> +<p>This section lists the commands you need to run in different Linux distributions to install all the requirements for building Firefox OS.</p> +<h4 id="Ubuntu_12.04_Linux_Mint_13_Debian_6">Ubuntu 12.04 / Linux Mint 13 / Debian 6</h4> +<p>Run the following command in Terminal:</p> +<pre>sudo apt-get update +sudo apt-get install autoconf2.13 bison bzip2 ccache curl flex gawk gcc g++ g++-multilib git ia32-libs lib32ncurses5-dev lib32z1-dev libgl1-mesa-dev libx11-dev make zip</pre> +<p>If you'll build for the <a href="https://developer.mozilla.org/en-US/Firefox_OS/Developer_phone_guide/Flame">"Flame"</a> reference device or Nexus 5, run the following command in Terminal:</p> +<pre>sudo apt-get install libxml2-utils </pre> +<p>And see the above comments about emulator build issues!</p> +<h4 id="Ubuntu_12.10">Ubuntu 12.10</h4> +<p>Run the following command in Terminal:</p> +<pre>sudo apt-get install autoconf2.13 bison bzip2 ccache curl flex gawk gcc g++ g++-multilib gcc-4.6 g++-4.6 g++-4.6-multilib git ia32-libs lib32ncurses5-dev lib32z1-dev libgl1-mesa-dev libx11-dev make zip</pre> +<p>In addition to the emulator build issues discussed above, the compiler will default to <code>gcc-4.7</code>, which will fail to build with an error along the following lines:</p> +<p>"<code>KeyedVector.h:193:31: error: indexOfKey was not declared in this scope, and no declarations were found by argument-dependent lookup at the point of instantiation"</code></p> +<p>To fix this, you will need to specify GCC 4.6 as the default host compiler after having retrieved the B2G sources: Read <a href="/en-US/docs/Mozilla/Firefox_OS/Customization_with_the_.userconfig_file#Changing_the_default_host_compiler">Changing the default host compiler</a> to find out how to do it.</p> +<p class="note">In a fresh Ubuntu 12.10 install, you'll get an error about unmet dependencies for ia32-libs. The following commands fix it:</p> +<pre>sudo dpkg --add-architecture i386 +sudo apt-get update +sudo apt-get install ia32-libs</pre> +<h4 id="Ubuntu_13.04">Ubuntu 13.04</h4> +<p>Run the following command in Terminal:</p> +<pre>sudo apt-get install --no-install-recommends autoconf2.13 bison bzip2 ccache curl flex gawk gcc g++ g++-multilib gcc-4.6 g++-4.6 g++-4.6-multilib git ia32-libs lib32ncurses5-dev lib32z1-dev zlib1g:amd64 zlib1g-dev:amd64 zlib1g:i386 zlib1g-dev:i386 libgl1-mesa-dev libx11-dev make zip</pre> +<p>In addition to the emulator build issues discussed above, the compiler will default to <code>gcc-4.7</code>, which will fail to build with an error along the following lines:</p> +<p>"<code>KeyedVector.h:193:31: error: indexOfKey was not declared in this scope, and no declarations were found by argument-dependent lookup at the point of instantiation"</code></p> +<p>To fix this, you will need to specify GCC 4.6 as the default host compiler after having retrieved the B2G sources: Read <a href="/en-US/docs/Mozilla/Firefox_OS/Customization_with_the_.userconfig_file#Changing_the_default_host_compiler">Changing the default host compiler</a> to find out how to do it.</p> +<h4 id="Ubuntu_13.10">Ubuntu 13.10</h4> +<p>With Ubuntu 13.10, multi-arch packages are now the main way to support multiple architectures (e.g. 32-bit on a 64-bit install). You must tell your Ubuntu system that you want to support 32-bit packages as well:<br> + </p> +<pre>sudo dpkg --add-architecture i386 +sudo apt-get update</pre> +<p>Once you've completed that, then you can install the necessary packages:</p> +<pre style="font-family: 'Open Sans', sans-serif; line-height: 21px;">sudo apt-get install --no-install-recommends autoconf2.13 bison bzip2 ccache curl flex gawk gcc g++ g++-multilib gcc-4.6 g++-4.6 g++-4.6-multilib git lib32ncurses5-dev lib32z1-dev zlib1g:amd64 zlib1g-dev:amd64 zlib1g:i386 zlib1g-dev:i386 libgl1-mesa-dev libx11-dev make zip libxml2-utils + +sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-4.6 1 + +sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-4.8 2 + +sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-4.6 1 + +sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-4.8 2 + +sudo update-alternatives --set gcc "/usr/bin/gcc-4.6" + +sudo update-alternatives --set g++ "/usr/bin/g++-4.6" </pre> +<h4 id="Fedora_17181920"><br> + Fedora 17/18/19/20</h4> +<p>Run the following command in Terminal:</p> +<pre class="note">sudo yum install autoconf213 bison bzip2 ccache curl flex gawk gcc-c++ git glibc-devel glibc-static libstdc++-static libX11-devel make mesa-libGL-devel ncurses-devel patch zlib-devel ncurses-devel.i686 readline-devel.i686 zlib-devel.i686 libX11-devel.i686 mesa-libGL-devel.i686 glibc-devel.i686 libstdc++.i686 libXrandr.i686 zip perl-Digest-SHA wget</pre> +<p>In addition to the above you will need GCC 4.6.x in order to compile the project:</p> +<ul> + <li><a href="http://people.mozilla.org/~gsvelto/gcc-4.6.4-fc18.tar.xz">Pre-compiled GCC 4.6.x for Fedora 17/18</a></li> + <li><a href="http://people.mozilla.org/~gsvelto/gcc-4.6.4-fc19.tar.xz">Pre-compiled GCC 4.6.x for Fedora 19/20</a></li> +</ul> +<p>Download the right version for your Fedora installation, then install it to <code>/opt,</code> with the following command on Fedora 17/18:</p> +<pre class="note">curl -O http://people.mozilla.org/~gsvelto/gcc-4.6.4-fc18.tar.xz +sudo tar -x -a -C /opt -f gcc-4.6.4-fc18.tar.xz +</pre> +<p>And with the following command for Fedora 19/20:</p> +<pre class="note">curl -O http://people.mozilla.org/~gsvelto/gcc-4.6.4-fc19.tar.xz +sudo tar -x -a -C /opt -f gcc-4.6.4-fc19.tar.xz +</pre> +<p>You will need to specify GCC 4.6.x as the default host compiler after having retrieved the B2G sources: Read <a href="/en-US/docs/Mozilla/Firefox_OS/Customization_with_the_.userconfig_file#Changing_the_default_host_compiler">Changing the default host compiler</a> to find out how to do it.</p> +<p>If build fails with the compiler complaining about not finding libmpc.so.2, install the package compat-libmpc</p> +<h4 id="Arch_Linux"><strong>Arch Linux</strong></h4> +<p>Run the following command in Terminal:</p> +<pre class="note">sudo <span style=""><span style="">pacman -S --needed </span></span><span style=""><span style="">alsa-lib </span></span><span style=""><span style="">autoconf2.13</span></span><span style=""><span style=""> bison</span></span><span style=""><span style=""> ccache</span></span><span style=""><span style=""> </span></span><span style=""><span style="">curl firefox </span></span><span style=""><span style="">flex </span></span><span style=""><span style="">gcc-multilib </span></span><span style=""><span style="">git </span></span><span style=""><span style="">gperf </span></span><span style=""><span style="">libnotify </span></span><span style=""><span style="">libxt </span></span><span style=""><span style="">libx11 mesa multilib-devel </span></span><span style=""><span style="">wget wireless_tools </span></span><span style=""><span style="">yasm</span></span><span style=""><span style=""> zip </span></span><span style=""><span style="">lib32-mesa </span></span>lib32-mesa-libgl <span style=""><span style="">lib32-ncurses lib32-readline</span></span><span style=""><span style=""> </span></span><span style=""><span style="">lib32-zlib</span></span></pre> +<p>To install the lib32-* packages you need to have the multilib repository enabled.</p> +<p>B2G <a href="https://developer.mozilla.org/en-US/Firefox_OS/Building#KeyedVector.h.3A193.3A31.3A_error.3A_indexOfKey_was_not_declared_in_this_scope">can only be compiled with gcc4.6.4</a>, and because Arch Linux always has bleeding edge software you will need to install <a href="https://aur.archlinux.org/packages/gcc46-multilib">gcc46-multilib from AUR</a>. Note that you will have to edit the PKGBUILD and add <code>staticlibs</code> to the <code>options</code> array, or gcc will be unable to compile B2G and give you a <code>cannot find -lgcc</code> error when compiling. You will also need to add the following to your <code>.userconfig</code> file:</p> +<pre class="language-html">export CC=gcc-4.6.4 +export CXX=g++-4.6.4</pre> +<p>By default, Arch Linux uses Python3. You'll have to force it to use the old python2. You can do that by linking the python2 executable to python but this is discouraged and considered error-prone. This will also break python 3 if it is installed on your system. A better way is to use <code>virtualenv</code>/<code>virtualenvwrapper</code>:</p> +<pre><span style=""><span style="">sudo pacman -S python-virtualenvwrapper +</span></span>source /usr/bin/virtualenvwrapper.sh +mkvirtualenv -p `which python2` firefoxos +workon firefoxos +</pre> +<p>Android will complain that you need make 3.81 or make 3.82 instead of 4.0. You can download <a href="https://aur.archlinux.org/packages/make-3.81/">make 3.81 from AUR</a>. This will install the make-3.81 binary on your path, you need to create a symlink named make to a location earlier in the PATH variable for the build to use the correct version.</p> +<pre>mkdir -p ~/bin +ln -s `which make-3.81` ~/bin/make +export PATH=~/bin:$PATH +</pre> +<p>Android also needs the Java6 SDK and Arch only has Java7. Unfortunately the aur build is broken, but you can still download the <a href="http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archive-downloads-javase6-419409.html#jdk-6u45-oth-JPR">Java 6 SDK</a> and install it manually. You will then need to put it in your path.</p> +<pre>cp ~/Downloads/jdk-6u45-linux-x64.bin /opt +su +cd /opt +chmod +x jdk-6u45-linux-x64.bin +./jdk-6u45-linux-x64.bin +exit +ln -s /opt/jdk1.6.0_45/bin/java ~/bin/java + +</pre> +<h4 id="Gentoo_Linux"><strong>Gentoo Linux</strong></h4> +<h5 id="Installing_ccache">Installing ccache</h5> +<p>You will need to install <strong><a href="http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=2&chap=3#doc_chap3">ccache</a></strong>, a tool for caching partial builds.</p> +<pre><span style=""><span style=""># emerge -av ccache</span></span> +</pre> +<p>Because ccache is known to frequently cause support issues, Gentoo encourages you to use it <em>explicitly</em> and <em>sparingly</em>.</p> +<p>To enable the required use of ccache, on <em>the subsequent step</em> of this guide where the <code>./build.sh</code> script is called, Gentoo users should instead run the command with an explicitly extended path, ie.</p> +<pre><span style=""><span style=""><strong>PATH=/usr/lib64/ccache/bin:$PATH</strong> ./build.sh</span></span> +</pre> +<h5 id="Generating_Partition_Images">Generating Partition Images</h5> +<p>If you are building B2G for actual physical hardware, then you may at some point also wish to generate some partition images for upload to your device. (For example, to restore backed up files to the device via the <strong><em>fastboot</em></strong> utility)</p> +<p>The filesystem image format used in this case is YAFFS2 (Yet Another Filesystem 2). Gentoo has support for the very latest (ie. git HEAD) <code>yaffs2-utils</code> userland package in portage. (Note: You will also need kernel patches if you want to mount YAFFS2 images, but this is not really required since you can deconstruct and rebuild them instead.)</p> +<pre># emerge --autounmask-write yaffs2-utils; etc-update; emerge -av yaffs2-utils</pre> +<p>In order to generate such an image, simply change to the parent directory of the partition filesystem tree you wish to package, and issue a command like this:</p> +<pre>mkyaffs2image system/ system.img</pre> +<h2 id="Wymagania_dla_systemu_Mac_OS_X">Wymagania dla systemu Mac OS X</h2> +<p>To build Firefox OS on Mac OS X, there are a number of prequisite steps you need to follow, which are detailed below. We also discuss common errors you might come across in particular situations, and solutions to those.</p> +<div class="note"> + <p><strong>Note: Configuring and Building B2G for Keon WON'T WORK on a Mac</strong>. You'll need to use Linux to build B2G for this device.</p> +</div> +<h3 id="Install_XCode_Command_Line_Utilities"><strong>Install XCode Command Line Utilities</strong></h3> +<p>You need to install Xcode's Command Line Utilities. You can download <em>just</em> the Command Line Utilities from <a href="https://developer.apple.com/downloads/" title="https://developer.apple.com/downloads/">Apple's developer downloads page</a> for your particular version of OS X, however if you would like the entire Xcode suite of applications, you can <a class="external" href="http://itunes.apple.com/us/app/xcode/id497799835?mt=12" style="line-height: 1.572;" title="http://itunes.apple.com/us/app/xcode/id497799835?mt=12">install Xcode</a><span style="line-height: 1.572;"> through the Mac App Store. </span></p> +<p>Xcode 4.3.1 (OS X 10.7 "Lion") and other newer versions such as 4.4.1+ (that is, Mac OS X 10.8 "Mountain Lion"), won't necessarily include the required Command Line Utilities. When you install Xcode, make sure to go into Preferences, then the Downloads panel, and install the Command Line Utilities. In addition, make sure you have at least 20 GB of free disk space.</p> +<p><img alt="Screenshot of Xcode Downloads Command Line Tools" src="/files/4557/xcode_downloads_command_line_tools.png" style="width: 750px; height: 528px;"></p> +<div class="note"> + <strong>Note:</strong> The Firefox OS emulator requires a Core 2 Duo processor or later; that is, a system that is compatible with Mac OS X 10.7 "Lion". You do not actually have to be running Lion, you just have to be compatible with it. You can, however, build any Firefox OS build on many older Macs.</div> +<h3 id="Run_Firefox_OS_Mac_Bootstrap">Run Firefox OS Mac Bootstrap</h3> +<p>Next, open a terminal and run the following command:</p> +<pre class="brush: bash">curl -fsSL https://raw.github.com/mozilla-b2g/B2G/master/scripts/bootstrap-mac.sh | bash</pre> +<p>This will pull and run a bootstrap script that makes sure you have all the prerequisites met to build the emulator. It will also prompt you for permission to install anything you're missing, and provide warnings and suggested fixes to problems. The script will check for and install the following items:</p> +<ul> + <li><code>git</code></li> + <li><code>gpg</code></li> + <li><code>ccache</code></li> + <li><code>yasm</code></li> + <li><code>autoconf-213</code></li> + <li><code>gcc-4.6</code></li> + <li><code>homebrew</code></li> +</ul> +<h4 id="Xcode_wrangling">Xcode wrangling</h4> +<p>If you have already upgraded to Xcode 4.4+ and get the message that Xcode is outdated, check the Xcode path with:</p> +<pre>xcode-select -print-path</pre> +<p>If it still points to <code>/Developer</code> you can update the path with:</p> +<pre>sudo xcode-select -switch /Applications/Xcode.app</pre> +<h4 id="Making_the_Mac_OS_X_10.6_SDK_available">Making the Mac OS X 10.6 SDK available</h4> +<p>You also need to have the Mac OS X 10.6 SDK available. The SDK needs to be available at</p> +<pre>/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/</pre> +<p>If it cannot be found there you will need to extract and copy it from Xcode 4.3. To do this:</p> +<ol> + <li>Download the XCode 4.3 .dmg file from the <a class="external" href="https://developer.apple.com/downloads/index.action">Apple Developer</a> portal (you'll need an <a href="https://developer.apple.com/register/index.action" title="https://developer.apple.com/register/index.action">Apple Developer account</a>).</li> + <li>Download the utility <a href="http://www.charlessoft.com/" title="http://www.charlessoft.com/">Pacifist</a> and use it to extract the 10.6 SDK from the XCode 4.3 .dmg file. Click on the "Extract Package" button, find the SDK by searching for 10.6 in the search box, then <em>Ctrl + click</em> on the MacOSX10.6.sdk directory and Extract it to a suitable location.</li> + <li>Add a symlink from the 10.6 SDK location to the <code>/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/</code> directory. For example, if you put the 10.6 SDK on your desktop, the comment would be</li> +</ol> +<pre>ln -s /Users/<em><yourusername></em>/Desktop/MacOSX10.6.sdk /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/</pre> +<h3 id="Be_aware_of_Mac_file_system_case_sensitivity">Be aware of Mac file system case sensitivity</h3> +<p>By default, Mac OS X ships with a case-insensitive file system. This is problematic because the Linux kernel has a number of files with the same name, but different case. For example, see the header files <code>xt_CONNMARK.h</code> and <code>xt_connmark.h</code>. This results in a number of files appearing to be modified in <code>/kernel</code> after a fresh <code>./config.sh</code>.</p> +<p>In many cases you can run the build just fine; for some platforms, however, you may encounter the following error:</p> +<pre><span class="quote">ERROR: You have uncommited changes in kernel +You may force overwriting these changes +with |source build/envsetup.sh force| + +ERROR: Patching of kernel/ failed.</span></pre> +<p><span class="quote">Please see <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=867259" title="https://bugzilla.mozilla.org/show_bug.cgi?id=867259">bug 867259</a></span> for more discussion and possible fixes for this problem.</p> +<p>Alternatively, it will always be safest to build on a case sensitive file system. The easiest way to do this is to create a separate, mountable disk image with case-sensitivity enabled. You can do this using Apple's Disk Utility application or from the command line:</p> +<pre>hdiutil create -volname 'firefoxos' -type SPARSE -fs 'Case-sensitive Journaled HFS+' -size 40g ~/firefoxos.sparseimage</pre> +<p>Mount the drive with:</p> +<pre>open ~/firefoxos.sparseimage</pre> +<p>Change into the mounted drive with:</p> +<pre>cd /Volumes/firefoxos/</pre> +<p>You can then check out the code and compile from this location without worrying about case-sensitivity problems.</p> +<h3 id="Mountain_Lion_homebrew_gotcha">Mountain Lion homebrew gotcha</h3> +<div> + <div> + If you are on Mountain Lion and you receive an error during the installation of the dependencies via homebrew, such as:</div> +</div> +<div> + <pre>clang: error: unable to execute command: Segmentation fault: 11</pre> + ... try reinstalling the dependency manually adding the <code>--use-gcc</code> flag, for example: + <pre>brew install mpfr --use-gcc</pre> +</div> +<h3 id="Follow_Samsung_Galaxy_S2_extra_steps">Follow Samsung Galaxy S2 extra steps</h3> +<p>If you plan to build for the Samsung Galaxy S2, you will also need to install heimdall. See {{ anch("Installing heimdall") }} for details. This is <strong>not</strong> done for you by the bootstrap script!</p> +<div class="note"> + <strong>Note:</strong> If you have installed the <a class="external" href="http://www.samsung.com/us/kies/" title="http://www.samsung.com/us/kies/">Samsung Kies</a> tool, which is used to manage the contents of many Samsung phones, you will have to remove it before you can flash Firefox OS onto your device. You can use the standard application removal process on Windows; on Mac, the Kies install disk image has a utility to fully remove Kies from your system. Flashing <strong>will not work</strong> if you have Kies installed. If you forget to remove Kies, the build system will detect it and remind you to uninstall it. Note also that the uninstall tool does not correctly remove the folder <code>~/Library/Application Support/.FUS</code>, and leaves a reference to a utility there in your user startup items list. You will want to remove these manually.</div> +<h3 class="note" id="Fix_libmpc_dependency_if_broken">Fix libmpc dependency if broken</h3> +<p><code>gcc 4.6</code> was built with <code>libmpc 0.9</code>; if you then use homebrew to update packages, libmpc gets updated to version 1.0, but homebrew doesn't rebuild <code>gcc 4.6</code> after the library version changes. So you need to create a symlink to make things work again, like this:</p> +<pre>cd /usr/local/lib/ +ln -s libmpc.3.dylib libmpc.2.dylib</pre> +<h3 id="Optional_Install_HAX">Optional: Install HAX</h3> +<p>Intel provides a special driver that lets the B2G emulator run its code natively on your Mac instead of being emulated, when you're using the x86 emulator. If you wish to use this, you can <a class="external" href="http://software.intel.com/en-us/articles/intel-hardware-accelerated-execution-manager/" title="http://software.intel.com/en-us/articles/intel-hardware-accelerated-execution-manager/">download and install</a> it. It's not required, but it can improve emulation performance and stability. </p> +<p>Before you install HAX you will need to install the <a href="http://developer.android.com/sdk/index.html" title="http://developer.android.com/sdk/index.html">Android SDK</a>.</p> +<h2 class="note" id="Instalacja_adb">Instalacja adb</h2> +<p>The build process needs to pull binary blobs from the Android installation on the phone before building B2G (unless you're building the emulator, of course). For this, you will need <code>adb</code>, the Android Debug Bridge. Our <a href="/en-US/Firefox_OS/Debugging/Installing_ADB">Installing ADB</a> article explains how to get <code>adb</code> installed.</p> +<div class="warning"> + <p>Note for future when you start to use adb: adb needs the phone's lock screen to be unlocked in order to see your phone (at least in later versions of Firefox OS). You'll probably want to disable the lock screen (we'll get to how later in the build instructions).</p> +</div> +<h2 class="note" id="Instalacja_heimdall">Instalacja heimdall</h2> +<p>Heimdall is a utility for flashing the Samsung Galaxy S2. It's used by the Boot to Gecko flash utility to replace the contents of the phone with Firefox OS, as well as to flash updated versions of B2G and Gaia onto the device. You'll need it if you want to install Firefox OS on a Galaxy S2; it is <strong>not</strong> needed for any other device. For other devices, we build and use the fastboot utility instead.</p> +<div class="note"> + <strong>Note:</strong> Again, it's important to note that this is <strong>only required for installing Firefox OS on the Samsung Galaxy S2</strong>.</div> +<p>There are two ways to install heimdall:</p> +<ul> + <li>You can <a class="link-https" href="https://github.com/Benjamin-Dobell/Heimdall" title="https://github.com/Benjamin-Dobell/Heimdall">download the code</a> GitHub and build it yourself.</li> + <li>Use a package manager to install it. + <ul> + <li>On Linux: <code>sudo apt-get install libusb-1.0-0 libusb-1.0-0-dev</code></li> + <li>On Mac, you can <a class="link-https" href="https://github.com/downloads/Benjamin-Dobell/Heimdall/heimdall-suite-1.3.2-mac.dmg" title="https://github.com/downloads/Benjamin-Dobell/Heimdall/heimdall-suite-1.3.2-mac.dmg">download an installer package</a> and use that.</li> + </ul> + </li> +</ul> +<h2 id="Konfiguracja_ccache">Konfiguracja ccache</h2> +<p>The B2G build process uses ccache. The default cache size for ccache is 1GB, but the B2G build easily saturates this; around 3GB is recommended. You can configure your cache by running the following command inside terminal:</p> +<pre><code>$ ccache --max-size 3GB</code></pre> +<h2 id="Dla_systemu_Linux_konfigurowanie_reguł_udev_dla_telefonu">Dla systemu Linux: konfigurowanie reguł udev dla telefonu</h2> +<div class="note"> + <p><strong>Note</strong>: This section is specific to Linux; Mac OS X has the necessary device permissions set up already.</p> +</div> +<p>Next, you need to confingure the udev rule for your phone,</p> +<p>You can get the <a href="https://developer.android.com/tools/device.html#VendorIds">USB vendor ID</a> by running <code>lsusb</code> with your phone plugged in, but typically it's Google <code>18d1,</code> Samsung <code>04e8</code>, ZTE <code>19d2</code>, Geeksphone/Qualcomm <code>05c6</code>. Add this line in your <code>/etc/udev/rules.d/android.rules</code> file (replacing <code>XXXX</code> with the ID for your device):</p> +<pre>SUBSYSTEM=="usb", ATTR{idVendor}=="XXXX", MODE="0666", GROUP="plugdev"</pre> +<p>Take ZTE for example, the content in android.rules will be</p> +<pre style="font-size: 14px;">SUBSYSTEM=="usb", ATTR{idVendor}=="19d2", MODE="0666", GROUP="plugdev"</pre> +<div class="note"> + <p><span style="line-height: 1.572;">If the file doesn't exist, create it. The <code>rules.d</code> directory is usually read only by default, so you may have to use <code>chmod</code> to make the directory writeable, or the file, or both.</span></p> +</div> +<p><span style="line-height: 1.572;">Once you've saved the file, and closed it, make the file readable:</span></p> +<pre>sudo chmod a+r /etc/udev/rules.d/android.rules +</pre> +<p>Now that the udev rules have been updated, restart the udev daemon. For ubuntu:</p> +<pre>sudo service udev restart</pre> +<p>Finally, unplug and the USB cable but don't replug it in because we need to enable remote debugging on the phone first.</p> +<h2 id="Enable_remote_debugging">Enable remote debugging</h2> +<p>Before you plug your phone back into your USB port, put it USB developer mode. This allows you to debug and flash the phone. To enable developer mode, on your phone enable <a href="/en-US/Firefox_OS/Debugging/Developer_settings#Remote_debugging">Remote Debugging</a> in <a href="/en-US/Firefox_OS/Debugging/Developer_settings">Developer settings</a> (this was called Developer mode on older versions.) Once the option is checked, remote debugging is enabled, and you are ready to go.</p> +<p>At this point, connect your phone to your computer via a USB cable (if you created the udev rule before, this will trigger udev to detect the phone and create the device node with the right permissions). Now you can check if you can list your device via the <code>adb devices</code> command (remember that adb can only see your phone when the lock screen is unlocked). If everything has worked ok, you should see an output similar to this (the following is for a Geeksphone Keon):</p> +<pre style="font-size: 14px;">$ adb devices +List of devices attached +full_keon device</pre> +<p>If the device did not list as expect, check the file name and the script are all correct (see previous section), then restart the computer and retype the command again. Note also that if your device uses fastboot, the bootloader may identify itself with a different vendor ID than the one you see when the device boots normally.</p> +<h2 id="Backup_the_phone_system_partition">Backup the phone system partition</h2> +<div class="note"> + <p><strong>Note</strong>: You have to do this before you build your device if you do not have an existing system backup, because some libraries will be referenced in build time. These library might be proprietary so we can't provide in our code base.</p> +</div> +<p>It is recommended that you back up the entire Android system partition on your phone.</p> +<p>You can use this copy of the binary blobs for Android in case you later delete your B2G tree. To do this, run:</p> +<pre>adb pull /system <backup target dir>/system +</pre> +<p> Depending on the phone, you may also need to pull the <code>/data</code> and/or <code>/vendor</code> directories:</p> +<pre>adb pull /data <backup target dir>/data +adb pull /vendor <backup target dir>/vendor +</pre> +<p>If the pull commands fail with an "insufficient permission" message, try the following:</p> +<ul> + <li>stop and restart the adb server, or if that fails,</li> + <li>double-check that you have granted root permissions to the <code>adb</code> tool within your custom ROM (e.g. under CyanogenMod, change <em>Settings > System > Developer Options > Root Access</em> to <em>Apps and ADB</em> or <em>ADB only</em>).</li> + <li>Verify that you have set up the udev rule correctly (see {{ anch("For Linux: configure the udev rule for your phone") }}.</li> +</ul> +<h2 id="On_to_the_next_step">On to the next step</h2> +<p>At this point, you should be ready to <a href="/en-US/docs/Mozilla/Firefox_OS/Preparing_for_your_first_B2G_build" title="en-US/docs/Mozilla/Firefox_OS/Preparing_for_your_first_B2G_build">fetch the Firefox OS code</a>!</p> diff --git a/files/pl/archive/b2g_os/index.html b/files/pl/archive/b2g_os/index.html new file mode 100644 index 0000000000..7ed185db02 --- /dev/null +++ b/files/pl/archive/b2g_os/index.html @@ -0,0 +1,86 @@ +--- +title: B2G OS +slug: Archive/B2G_OS +tags: + - B2G + - Firefox OS + - Gaia + - Początek FirefoxOS + - Początkujący + - Przegląd + - Łatwe +translation_of: Archive/B2G_OS +--- +<p>Firefox OS jest obecnie w trakcie intensywnego rozwoju; Stale pracujemy nad ułatwieniami w używaniu i bezpieczeństwie Gaia, i tworzeniu aplikacji. Jakkolwiek, potrzebujesz wiedzy o systemach na jakich jest zbudowany stos Firefox OS lub telefon z Firefox OS. Linki poniżej są przeznaczone dla programistów sieciowych zainteresowanych uruchamianiem i tworzeniem zmian do Gaia lub tworzeniem i rozwijaniem aplikacji na urządzenia z systemem Firefox OS.</p> + +<table class="topicpage-table"> + <tbody> + <tr> + <td> + <h2 class="Documentation" id="Documentation" name="Documentation">Dokumentacja Firefox OS</h2> + + <dl> + <dt><a href="/en-US/docs/Mozilla/Boot_to_Gecko/Introduction" title="en-US/docs/Mozilla/Boot_to_Gecko/Introduction">Wprowadzenie do Firefox OS</a></dt> + <dd>Informacje wprowadzające czym jest Firefox OS i jak on działa.</dd> + <dt><a href="/en-US/docs/Mozilla/Boot_to_Gecko/Writing_apps_for_Boot_to_Gecko" title="en-US/docs/Mozilla/Boot_to_Gecko/Writing apps for Boot to Gecko">Pisanie aplikacji dla Firefox OS</a></dt> + <dd>Tutorial opisujący jak tworzyć aplikacje działające na urządzeniach z Firefox OS.</dd> + <dt><a href="/en-US/docs/Mozilla/Boot_to_Gecko/Building_and_installing_Boot_to_Gecko" title="en-US/docs/Mozilla/Boot_to_Gecko/Building and installing Boot to Gecko">Kompilacja i instalacja Firefox OS</a></dt> + <dd>Przewodnik jak skompilować Firefox OS i zainstalować go na swoim urządzeniu. Ten przewodnik obejmuje również kompilację emulatora Firefox OS dla uruchamiania Firefox OS na komputerze.</dd> + <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Gaia" title="/en-US/docs/Mozilla/Gaia">Gaia</a></dt> + <dd>Dokumentacja Gaia, aplikacji interfejsu użytkownika dla urządzeń z Firefox OS. Jest to internetowa aplikacja uruchamiana na szczycie stosu oprogramowania Firefox OS.</dd> + <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Gonk" title="/en-US/docs/Mozilla/Firefox_OS/Gonk">Gonk</a></dt> + <dd>Dokumentacja Gonk, warstwy systemu operacyjnego poniżej Gaia. Składa się on z jądra Linuxa i warstwy abstakcyjnej sprzętu, z którym łączy się Gecko.</dd> + <dt><a href="/en-US/docs/Gecko" title="/en-US/docs/Gecko">Gecko</a></dt> + <dd>Gecko jest warstwą Firefox OS która zapewnia taką samą implementację otwartych standardów internetowych, jakiej używają Firefox i Thunderbird, a także wiele innych aplikacji.</dd> + <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Security" title="/en-US/docs/Mozilla/Firefox_OS/Security">Bezpieczeństwo</a></dt> + <dd>Dokumentacja zabezpieczeń w Firefox OS. Ten zawierający tematy o bezpieczeństwie urządzeń z każdej perspektywy: dla programistów aplikacji, integratorów urządzeń, itd. </dd> + <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Performance" title="/en-US/docs/Mozilla/Firefox_OS/Performance">Wydajność</a></dt> + <dd>Artykuły o optymalizacji aplikacji dla Firefox OS.</dd> + <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Architecture" title="/en-US/docs/Mozilla/Firefox_OS/Architecture">Przegląd architektury Firefox OS</a></dt> + <dd>Przegląd jak zbudowany jest Firefox OS.</dd> + <dt><a href="/en-US/docs/Mozilla/Boot_to_Gecko/Troubleshooting" title="/en-US/docs/Mozilla/Boot_to_Gecko/Troubleshooting">Rozwiązywanie problemów</a></dt> + <dd>Przewodnik wspólnego rozwiązywania problemów z Firefox OS.</dd> + <dt><a href="/en-US/docs/Mozilla/Boot_to_Gecko/Testing_Boot_to_Gecko" title="en-US/docs/Mozilla/Boot_to_Gecko/Testing Boot to Gecko">Testowanie Firefox OS</a></dt> + <dd>Przewodnik testowania Firefox OS, zawierający informacje o tworzeniu testów automatycznych.</dd> + <dt><a href="/en-US/docs/Mozilla/Boot_to_Gecko/Debugging_on_Boot_to_Gecko" title="en-US/docs/Mozilla/Boot_to_Gecko/Debugging on Boot to Gecko">Debugowanie w Firefox OS</a></dt> + <dd>Przewodnik debugowania twoich aplikacji mobilnych i samego Firefox OS.</dd> + <dt><a href="/en-US/docs/Mozilla/Boot_to_Gecko/Boot_to_Gecko_developer_phone_guide" title="/en-US/docs/Mozilla/Boot_to_Gecko/Boot to Gecko developer phone guide">Przewodnik telefonu dla programisty </a><a href="/en-US/docs/Mozilla/Boot_to_Gecko/Boot_to_Gecko_developer_phone_guide" title="/en-US/docs/Mozilla/Boot_to_Gecko/Boot to Gecko developer phone guide">Firefox OS</a></dt> + <dd>Przewodnik po telefonie programisty Firefox OS, który Mozilla zapewnia niektórym programistom. Ten przewodnikma zastosowanie również wtedy, gdy ktoś zainstalował Firefox OS na twoim telefonie za ciebie.</dd> + <dt><a href="/en-US/docs/Mozilla/Boot_to_Gecko/Porting" title="/en-US/docs/Mozilla/Boot_to_Gecko/Porting">Przenoszenie Firefox OS</a></dt> + <dd>Informacja o tym jak przenieść Firefox OS na nowe urządzenie.</dd> + </dl> + + <p><span class="alllinks"><a href="/en-US/docs/tag/B2G" title="/en-US/docs/tag/B2G">Zobacz wszystko...</a></span></p> + </td> + <td> + <h2 class="Community" id="Community" name="Community">Jak dostać pomoc od społeczności</h2> + + <p>Jeśli pracujesz z Firefox OS lub tworzysz aplikacje, które chcesz uruchomić na urządzeniach z Firefox OS, tutaj są wspólne zasoby, aby ci pomóc!</p> + + <ul> + <li>Zadawaj swoje pytania na kanale IRC Mozilli do spraw Gecko: <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">Nie zapominaj o netykiecie...</a></span></p> + + + <h2 class="Related_Topics" id="Related_Topics" name="Related_Topics">Powiązane tematy</h2> + + <ul> + <li><a href="/en-US/docs/Mobile" title="en-US/docs/Mobile">Mobilność</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="Zasoby">Zasoby</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">Mapa drogowa</a></li> + <li><a href="/en-US/docs/Mozilla/Boot_to_Gecko/Feature_support_chart" title="/en-US/docs/Mozilla/Boot_to_Gecko/Feature_support_chart">Tabela opcji pomocy</a></li> + </ul> + </td> + </tr> + </tbody> +</table> diff --git a/files/pl/archive/b2g_os/instalacja_firefox_os/index.html b/files/pl/archive/b2g_os/instalacja_firefox_os/index.html new file mode 100644 index 0000000000..792927987e --- /dev/null +++ b/files/pl/archive/b2g_os/instalacja_firefox_os/index.html @@ -0,0 +1,72 @@ +--- +title: Instalacja Firefox OS +slug: Archive/B2G_OS/Instalacja_Firefox_OS +tags: + - Android + - Firefox + - Firefox OS + - FirefoxOS + - Gaia + - OS + - dual boot + - instalacja + - konfiguracja + - sgs2 + - system +translation_of: Archive/B2G_OS/Building_and_installing_B2G_OS +--- +<p>Ponieważ Firefox OS jest aktualnie w fazie ciągłego rozwoju (przedpremierowa wersja) najlepszą drogą do upewnienia się, że posiadamy jego aktualną wersję jest instalcja ręczna. Poniższe artykuły pomogą Ci przejść przez proces przygotowania i instalacji Firefox OS na emulatorze, kompatybilnym urządzeniu lub w interfejsie użytkownika <a href="/en-US/docs/Mozilla/Boot_to_Gecko/Introduction_to_Gaia" title="en-US/docs/Mozilla/Boot_to_Gecko/Introduction_to_Gaia">Gaia</a> przeglądarki Firefox.</p> +<table class="topicpage-table"> + <tbody> + <tr> + <td> + <h2 class="Documentation" id="Pobieranie_i_konfiguracja_Firefox_OS">Pobieranie i konfiguracja Firefox OS</h2> + <dl> + <dt> + <a href="/en-US/docs/Mozilla/Boot_to_Gecko/B2G_build_prerequisites" title="en-US/docs/Mozilla/Boot_to_Gecko/B2G build prerequisites">Wymagania Firefox OS</a></dt> + <dd> + Co potrzebujesz(oraz co musisz zrobić) zanim skonfigurujesz Firefox OS po raz pierwszy.</dd> + <dt> + <a href="/en-US/docs/Mozilla/Boot_to_Gecko/Preparing_for_your_first_B2G_build" title="/en-US/docs/Mozilla/Boot_to_Gecko/Preparing for your first B2G build">Przygotowanie do konfiguracji Firefox OS</a></dt> + <dd> + <span id="result_box" lang="pl"><span class="hps">Zanim będzie można</span> konfigurować <span class="hps">Firefox</span> <span class="hps">OS</span><span>, trzeba</span> <span class="hps">sklonować repozytorium</span><span class="hps">.</span> <span class="hps">W tym artykule opisano</span><span>, jak to zrobić</span><span>.</span></span></dd> + <dt> + <a href="/en-US/docs/Mozilla/Boot_to_Gecko/Building_Boot_to_Gecko" title="en-US/docs/Mozilla/Boot_to_Gecko/Building Boot to Gecko">Konfiguracja Firefox OS</a></dt> + <dd> + Jak skonfigurować Firefox OS.</dd> + </dl> + <p><span class="alllinks"><a href="/en-US/docs/tag/B2G" title="/en-US/docs/tag/B2G">Więcej...</a></span></p> + </td> + <td> + <h2 class="Community" id="Instalacja_Firefox_OS_ilub_Gaia">Instalacja Firefox OS i/lub Gaia</h2> + <dl> + <dt> + <a href="/en-US/docs/Mozilla/Boot_to_Gecko/Choosing_how_to_run_Gaia_or_B2G" title="en-US/docs/Mozilla/Boot_to_Gecko/Choosing how to run Gaia or B2G">Sposób uruchamiania interfejsu Gaia lub Firefox OS</a></dt> + <dd> + Możesz używać interfejsu Gaia w Firefoxie lub uruchamiać Firefox OS na urządzeniu mobilnym lub w symulatorze okienkowym na komputerze. Ten przewodnik pomoże wybrać odpowiednie rozwiązanie dla Ciebie.</dd> + <dt> + <a href="/en-US/docs/Mozilla/Boot_to_Gecko/Using_Gaia_in_Firefox" title="en-US/docs/Mozilla/Boot_to_Gecko/Using Gaia in Firefox">Używanie intefejsu Gaia w Firefoxie</a></dt> + <dd> + Jak używać interfejsu Gaia w przeglądarce Firefox na komputerze.</dd> + <dt> + <a href="/en-US/docs/Mozilla/Boot_to_Gecko/Using_the_B2G_desktop_client" title="en-US/docs/Mozilla/Boot_to_Gecko/Using_the_B2G_desktop_client">Używanie klienta okienkowego Firefox OS</a></dt> + <dd> + Artykuł poświęcony używaniu klienta okienkowego Firefox Os; Symuluje interfejs Gaia w oknie aplikacji. Jest to lepsze rozwiązanie od pracy w oknie przeglądarki, ale gorsze od używania emulatorów.</dd> + <dt> + <a href="/en-US/docs/Mozilla/Boot_to_Gecko/Using_the_B2G_emulators" title="en-US/docs/Mozilla/Boot_to_Gecko/Using the B2G emulators">Używanie emulatorów Firefox OS</a></dt> + <dd> + Artykuł dotyczący wyboru wersji emulatora Firefox Os, jego konfiguracji i instalacji.</dd> + <dt> + <a href="/en-US/docs/Mozilla/Boot_to_Gecko/Installing_Boot_to_Gecko_on_a_mobile_device" title="en-US/docs/Mozilla/Boot_to_Gecko/Installing Boot to Gecko on a mobile device">Instalacja Firefox OS na urządzeniu mobilnym</a></dt> + <dd> + Jak zainstalować system Firefox OS na urządzeniu mobilnym.</dd> + <dt> + <a href="/en-US/docs/Mozilla/Boot_to_Gecko/Dual_boot_of_B2G_and_Android_on_SGS2" title="/en-US/docs/Mozilla/Boot_to_Gecko/Dual boot of B2G and Android on SGS2">Dual boot Firefox OS oraz Androida na SGS2</a></dt> + <dd> + Jak przygotować Firefox OS/ Androida do dual boot'a na Samsungu Galaxy S2</dd> + </dl> + </td> + </tr> + </tbody> +</table> +<p> </p> diff --git a/files/pl/archive/b2g_os/instalacja_firefox_os/streszczenie_procesu_budowania_firefox_os/index.html b/files/pl/archive/b2g_os/instalacja_firefox_os/streszczenie_procesu_budowania_firefox_os/index.html new file mode 100644 index 0000000000..3666a7ded4 --- /dev/null +++ b/files/pl/archive/b2g_os/instalacja_firefox_os/streszczenie_procesu_budowania_firefox_os/index.html @@ -0,0 +1,149 @@ +--- +title: Streszczenie procesu kompilowania Firefox OS +slug: Archive/B2G_OS/Instalacja_Firefox_OS/Streszczenie_procesu_budowania_Firefox_OS +tags: + - Firefox OS + - Kompilowanie + - instalacja + - install +translation_of: Archive/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_build_process_summary +--- +<div class="summary"> +<p>Kompilowanie i instalowanie systemu Firefox OS wymaga dużo wolnego czasu, szybkiego łącza internetowego i wysokiej mocy obliczeniowej komputera. Niestety podczas tak długiego procesu coś może pójść nie tak. Na tej stronie znajdują się informacje, które pomogą przebyć tę długą drogę.</p> +</div> + +<div class="note"> +<p><strong style="font-weight: bold;">Notatka:</strong> Podczas czytania artykułów dotyczących kompilowania Firefox OS natkniesz się na określenia "B2G", lub "Boot2Gecko". "Boot2Gecko" jest oficjalną nazwą kodową systemu Firefox OS.</p> +</div> + +<h2 id="Główny_cel_uzyskanie_czterech_plików_.img">Główny cel: uzyskanie czterech plików .img</h2> + +<p> </p> + +<table style="margin: 4px auto; vertical-align: top; width: 90%;"> + <tbody> + <tr> + <td><strong>boot.img</strong></td> + <td>Zawiera rdzeń Linuxa, system plików i podstawowe narzędzia Unixowe.</td> + </tr> + <tr> + <td><strong>system.img</strong></td> + <td>Znajduje się tam główny rdzeń systemu Firefox OS, czyli Gonk, Gecko i plik wykonywalny b2g.</td> + </tr> + <tr> + <td><strong>userdata.img</strong></td> + <td>Tutaj zawarty jest profil Gecko i aplikacje Gaia.</td> + </tr> + <tr> + <td><strong>recovery.img</strong></td> + <td>Tak samo jak boot.img, zawiera rdzeń Linuxa i system plików, ale odpowiada za udostępnienie użytkownikowi narzędzi do naprawy uszkodzonego urządzenia.</td> + </tr> + </tbody> +</table> + +<p>Kiedy te cztery obrazy zostaną stworzone, mogą zostać przesłane do urządzenia.</p> + +<p>Firefox OS jest tworzony na podstawie Android Open Source Project (AOSP). Narzędzia AOSP takie jak<code> adb</code> lub <code>fastboot </code>pozwalają na zaawansowane zarządzanie urządzeniem. Przykładem może być komenda <code>adb reboot-bootloader</code>, która sprawia, że urządzenie zrestartuje się i zatrzyma rozruch systemu na wczesnym etapie, co umożliwi przesłanie obrazu systemu poprzez wpisanie komendy <code>fastboot flash $partition $image</code>.</p> + +<h3 id="Pierwszy_obraz_boot.img">Pierwszy obraz: boot.img</h3> + +<p>Zawiera rdzeń Linuxa, odpowiadający za uruchamianie podstawowych programów i wykonywanie skryptów. Zostanie przesłany na partycję "boot" i dostęp do niego będzie możliwy poprzez użycie komendy <code>adb shell</code>. Ponieważ jest najważniejszą częścią systemu, aby go modyfikować, potrzeba uprawnień <strong>root</strong>.</p> + +<p>Możliwe jest również modyfikowanie istniejącego już obrazu boot.img, poprzez przeglądanie, kopiowanie, ponowne kompilowanie jego elementów. Takie operacje zostały opisane na tej stronie: <a href="http://k.japko.eu/alcatel-otf-hackers-guide-1.html">Alcatel One Touch Fire Hacking (Mini) Guide</a>.</p> + +<p>Obrazy <code>boot.img</code> mogą zostać przetestowane przed przesłaniem ich. Gdy urządzenie będzie w trybie bootloadera, wystarczy użyć narzędzia <code>fastboot</code> do uruchomienia obrazu boot.img. Nie trzeba wtedy instalować obrazu na urządzeniu, tak, jak miałoby to miejsce w przypadku komendy <code>fastboot boot /ścieżka/do/boot.img</code>.</p> + +<h3 id="Drugi_obraz_system.img">Drugi obraz: system.img</h3> + +<p>Obraz systemu (<code>system.img</code>) zawiera główne elementy systemu Firefox OS:</p> + +<ul> + <li><strong>Gonk</strong>: nisko-poziomowy dostęp systemu do komponentów urządzenia.</li> + <li><strong>Gecko</strong>: silnik przeglądarki Firefox, przystosowany do obsługi urządzeń mobilnych.</li> + <li><strong>B2G</strong>: główny proces systemowy.</li> +</ul> + +<div class="note"> +<p>Więcej informacji o budowie systemu znajdziesz na stronie <a href="https://developer.mozilla.org/en-US/Firefox_OS/Platform">Firefox OS platform</a>.</p> +</div> + +<p>Obraz systemu zostanie przesłany na główną partycję urządzenia (utworzoną przez obraz <code>boot.img</code>), a wszystkie pliki systemowe będą znajdowały się w folderze <code>/system/</code>.</p> + +<div class="note"> +<p><strong>Notatka</strong>: Obraz systemu zawiera również plamy binarne (binary blobs), które mogą zostać wykorzystane przez urządzenie do kontrolowania radia komórkowego.</p> +</div> + +<h3 id="Trzeci_obraz_userdata.img">Trzeci obraz: userdata.img</h3> + +<p>Obraz z danymi użytkownika zawiera aplikacje Gaia, które są wykorzystywane podczas pracy systemu.</p> + +<p>Obraz <code>userdata.img</code> zostanie umieszczony na partycji <code>userdata</code>, a jego zawartość będzie widoczna w folderze <code>/data/</code> wtedy, gdy system plików urządzenia będzie z niego korzystał. Trzeba również wspomnieć, że folder <code>/data/b2g/</code> zawiera profil platformy Gecko, a zawartością folderu <code>/data/local/webapps/</code> są wszystkie aplikacje, które znajdują się w pamięci urządzenia.</p> + +<h3 id="Czwarty_obraz_recovery.img">Czwarty obraz: recovery.img</h3> + +<p>Obraz przywracania systemu zawiera taki sam rdzeń, jaki ma obraz <code>boot.img</code>. Różnicą jest sposób wykonywania skryptu, co pozwala użytkownikowi na aktywowanie skryptu przywracającego system poprzez użycie fizycznych przycisków na urządzeniu.</p> + +<p>Obraz <code>recovery.img</code> zostanie umieszczony na partycji <code>recovery </code>i nie może on zostać zmodyfikowany podczas działania systemu.</p> + +<h2 id="Proces_kompilacji">Proces kompilacji</h2> + +<p>Cały proces kompilacji systemu Firefox OS składa się z następujących etapów:</p> + +<table style="margin: 4px auto; vertical-align: top; width: 90%;"> + <tbody> + <tr> + <td><strong>Przygotowania</strong></td> + <td>Uzyskanie wszystkich programów potrzebnych do przeprowadzenia procesu kompilacji. Do tych programów zaliczają się kompilatory, biblioteki itp.</td> + </tr> + <tr> + <td><strong>Konfiguracji</strong></td> + <td>Pobranie kodu źródłowego i utworzenie pliku <code>.configure</code>, w którym zawarte będą zmiennie, ścieżki i inne wartości, które zostaną wykorzystane w procesie kompilacji.</td> + </tr> + <tr> + <td><strong>Tworzenia</strong></td> + <td>Tworzenie profili platformy Gecko i aplikacji Gaia dla urządzenia.</td> + </tr> + <tr> + <td><strong>Instalowania</strong></td> + <td>Zainstalowanie na urządzeniu wcześniej przygotowanych plików.</td> + </tr> + </tbody> +</table> + +<p> </p> + +<h3 id="Przygotowanie">Przygotowanie</h3> + +<p>Należy przeprowadzić konfigurację wstępną, aby upewnić się, że komputer ma wszystkie narzędzia, potrzebne do skompilowania systemu. Do takich narzędzi zalicza się m.in. kompilator.</p> + +<p>Ten krok można wykonać przy użyciu skryptu. Szczegóły zostały omówione na <a href="https://developer.mozilla.org/en-US/Firefox_OS/Firefox_OS_build_prerequisites" title="Firefox OS build prerequisites">tej stronie</a>.</p> + +<div class="note"> +<p><strong>Notatka</strong>: Na Unixowych systemach można sprawdzić obecność wymaganego oprogramowania, poprzez komendę <code>which</code>. Parametrem komendy <code>which</code> jest sprawdzany program.</p> +</div> + +<h3 id="Konfiguracja">Konfiguracja</h3> + +<p>Aktualny krok zaczyna się wraz z uzyskaniem plików systemu Firefox OS. W uzyskaniu tych plików może pomóc narzędzie <code>git</code>. Konfiguracja obejmie cały kod źródłowy i utworzy plik<code> .config</code>, w którym znajdą się zmienne dla kompilowanego systemu.</p> + +<p>Konfiguracja rozpocznie się po uruchomieniu skryptu <code>config.sh</code>. Szczegóły zostały omówione na stronie <a href="/en-US/Firefox_OS/Preparing_for_your_first_B2G_build" title="Preparing for your first B2G build">Preparing for your first B2G build</a>.</p> + +<p>Skrypt konfiguracyjny potrzebuje parametrów urządzenia, na którym ma zostać zainstalowany system Firefox OS. Nazwa tworzonego systemu jest nazwą kodową powiązaną z architekturą CPU, a nie z konkretnym urządzeniem. Lista nazw kodowych znajduje się <a href="/en-US/Firefox_OS/Phones">tutaj</a>.</p> + +<p>Podczas konfiguracji używane jest również narzędzie Android Open Source Project <code>repo</code>. Pozwala ono na pobranie lub zaktualizowanie kodu używanego podczas procesu kompilacji.</p> + +<h3 id="Kompilacja">Kompilacja</h3> + +<p>W tym kroku zaczyna się kompilacja kodu źródłowego i uzyskanie czterech obrazów.</p> + +<p>Kompilacja uruchomi się po aktywowaniu skryptu <code>build.sh</code>. Szczegóły zostały omówione na stronie <a href="/en-US/Firefox_OS/Building" title="Building">Building Firefox OS</a>.</p> + +<p>Możliwe jest skompilowanie tylko części systemu Firefox OS. Można to zrobić poprzez dodanie do skryptu kompilującego jednego parametru. Na przykład, jeżeli chcemy uzyskać tylko element gaia, to dodajemy parametr <code>gaia</code>.</p> + +<p>Możliwe jest również skompilowanie obrazów omówionych na początku tej strony. Jeżeli chcemy skompilować obraz <code>system.img</code>, możemy to zrobić komendą <code>./build.sh out/platform/$target/system.img </code>(parametr <code>$target</code> jest taki sam, jak w procesie konfiguracji).</p> + +<h3 id="Instalacja">Instalacja</h3> + +<p>Należy uruchomić skrypt <code>flash.sh</code>, aby nowo skompilowany kod trafił do pamięci urządzenia.</p> + +<p>Możliwe jest zainstalowanie tylko poszczególnych części systemu. Żeby to zrobić, trzeba dodać parametr do skryptu <code>flash.sh</code>. Na przykład, żeby zainstalować tylko aplikacje Gaia, wystarczy wpisać <code>./flash.sh gaia</code>.</p> diff --git a/files/pl/archive/b2g_os/phone_guide/index.html b/files/pl/archive/b2g_os/phone_guide/index.html new file mode 100644 index 0000000000..d90e90d259 --- /dev/null +++ b/files/pl/archive/b2g_os/phone_guide/index.html @@ -0,0 +1,53 @@ +--- +title: Firefox OS developer phone guide +slug: Archive/B2G_OS/Phone_guide +tags: + - B2G + - Firefox OS + - Landing + - NeedsTranslation + - Phones + - TopicStub +translation_of: Archive/B2G_OS/Phone_guide +--- +<div class="summary"> + <p>This section contains developer information relevant to specific phones that run Firefox OS. We have general information available on <a href="/en-US/docs/Mozilla/Firefox_OS/Building_and_installing_Firefox_OS" title="Building and installing Firefox OS">Building and installing Firefox OS</a> and <a href="/en-US/docs/Mozilla/Firefox_OS/Hacking_Firefox_OS" title="/en-US/docs/Mozilla/Firefox_OS/Hacking_Firefox_OS">Hacking Firefox OS</a>, so please go there for information about building and installing the platform from scratch. Developers with specific phones in their possession may however find the following articles useful.</p> +</div> +<h2 id="Specific_device_information">Specific device information</h2> +<dl> + <dt> + <a href="/en-US/docs/Mozilla/Firefox_OS/Phones">Firefox OS phone data</a></dt> + <dd> + In this article we list the various available Firefox OS phones along with information such as their code names, availability, and specific hardware features.</dd> + <dt> + <a href="/en-US/Firefox_OS/Developer_phone_guide/Flame">Flame</a></dt> + <dd> + Information on Mozilla's high-end Firefox OS reference phone, codenamed the Flame, and produced in partnership with T<sup>2</sup>Mobile.</dd> + <dt> + <a href="/en-US/Firefox_OS/Developer_phone_guide/Geeksphone">Geeksphone</a></dt> + <dd> + In this article we cover some basic tips on how to keep your Geeksphone up-to-date and how to tweak the system Gaia applications.</dd> + <dt> + <a href="/en-US/docs/Mozilla/Firefox_OS/Developer_phone_guide/ZTE_OPEN">ZTE OPEN</a></dt> + <dd> + This article contains information on the ZTE OPEN Firefox OS device.</dd> + <dt> + <a href="/en-US/Firefox_OS/Developer_phone_guide/ZTE_OPEN_C">ZTE OPEN C</a></dt> + <dd> + The ZTE Open C is an updated ZTE-produced Firefox OS device, with higher end hardware and newer software.</dd> +</dl> +<h2 id="General_Firefox_OS_information">General Firefox OS information</h2> +<dl> + <dt> + <a href="/en-US/Firefox_OS/Developer_phone_guide/Firefox_OS_device_features">General device features</a></dt> + <dd> + This page lists typical Firefox OS hardware features and minimum hardware requirements.</dd> + <dt> + <a href="/en-US/docs/Mozilla/Firefox_OS/Troubleshooting">Troubleshooting</a></dt> + <dd> + This article provides tips for resolving common problems you may have while using Firefox OS.</dd> + <dt> + <a href="/en-US/Firefox_OS/Developer_phone_guide/Best_practices_open_reference_devices">Best practices for open reference devices</a></dt> + <dd> + A set of best practices that we believe should come highly recommended for any widely available open reference devices. All of the recent Firefox OS reference devices have followed these practices.</dd> +</dl> diff --git a/files/pl/archive/b2g_os/phone_guide/płomień/index.html b/files/pl/archive/b2g_os/phone_guide/płomień/index.html new file mode 100644 index 0000000000..ab4c222e60 --- /dev/null +++ b/files/pl/archive/b2g_os/phone_guide/płomień/index.html @@ -0,0 +1,384 @@ +--- +title: płomień +slug: Archive/B2G_OS/Phone_guide/płomień +translation_of: Archive/B2G_OS/Phone_guide/Flame +--- +<div class="geckoVersionNote"> +<p><strong>Updates on your Flame</strong>: We encourage you to join the following mailing list to receive periodic updates on software builds and other news affecting your Flame device: <a href="https://mail.mozilla.org/listinfo/flamenews">https://mail.mozilla.org/listinfo/flamenews</a></p> +</div> + +<p><img alt="A picture of the Flame device, showing the Firefox OS homescreen containing several app icons." src="https://mdn.mozillademos.org/files/8373/flame-dev-hud.png" style="float: left; margin-bottom: 20px; margin-right: 50px; width: 25%;"></p> + +<h2 id="Available_to_order" style="text-indent: 100%; white-space: nowrap; overflow: hidden; margin: 0; height: 0;">Available to order</h2> + +<p><span class="seoSummary">The Flame developer reference phone is a milestone in Firefox OS device releases. The Flame hardware offers a representative set of specs — including FWVGA display and dual-core processor — to help developers build great content and experiences. A single hardware platform is also good for testers, making it easier to test and address specific software issues without having to worry about device model-specific bugs, etc.</span></p> + +<p>If you have your phone in hand and want to start playing with it, developing and distributing apps, or contributing to the Firefox platform, the following links will get you where you need to go:</p> + +<ul> + <li><a href="/en-US/Firefox_OS">Firefox OS zone</a>: For creating your own Firefox OS builds and contributing to the B2G and Gaia projects.</li> + <li><a href="/en-US/Apps">App Center zone</a>: For building open web apps compatible with Firefox OS.</li> + <li><a href="/en-US/Marketplace">Marketplace zone</a>: For information on publishing and distributing apps.</li> + <li><a href="https://marketplace.firefox.com/">Firefox Marketplace</a>: The best place to find and publish new Firefox OS apps.</li> +</ul> + +<p>If you’d like to find out more about updating the operating system, recovering it, pushing apps to it, or phone specs, you’ll find the information you need below.</p> + +<h2 id="Purchasing_a_device">Purchasing a device</h2> + +<p>Our device manufacturer partner has made the device <a href="http://www.everbuying.com/product549652.html">available to order</a> on everbuying.com, for US$170 including global shipping (device cost is $145, shipping is $25 and custom fees may still apply, depending on the destination country). The device is bootloader- and carrier-unlocked, and it utilizes a quad-band GSM+UMTS radio so that it can work with a wide variety of operators/carriers.</p> + +<h2 id="Important_steps_to_follow_first">Important steps to follow first</h2> + +<p>There are a couple of steps you should make sure you follow for your particular operating system, before you start trying to update your device, for example by updating your Flame's version of Firefox OS, or pushing apps to your phone (both are covered below.)</p> + +<h3 id="All_operating_systems">All operating systems</h3> + +<p>You need to install ADB and Fastboot on your computer — these are applications that allow you to interact with your phone from your computer when the two are connected via the phone's USB charger cable. They are needed for Flashing your phone to a new version of Firefox OS, recovering from an unresponsive state, pushing apps to your phone, etc.</p> + +<div class="note"> +<p><strong>Note</strong>: If you are on Ubuntu you can install ADB and Fastboot simply by using <code>sudo apt-get install android-tools-adb android-tools-fastboot</code> on the command line.</p> +</div> + +<p>ADB and Fastboot are available in the <a class="external external-icon" href="http://developer.android.com/sdk/index.html" title="Android Developer Tookit">Android Developer Toolkit</a>:</p> + +<ol> + <li>Go to the above link.</li> + <li>Press the <em>Download Eclipse ADT</em> button.</li> + <li>Agree to the license conditions.</li> + <li>Choose between the 32-bit and 64-bit version (32-bit will do if you are not sure).</li> + <li>Click the final <em>Download Eclipse ADT with the Android SDK...</em> button.</li> + <li>Once the download is complete, unzip the zip file's contents onto your computer's desktop.</li> + <li>The folder name is a bit complicated; rename it to just <em>adt.</em></li> +</ol> + +<p>ADB is a tool that you run from the command line. If you open your terminal/command prompt, go to adt/sdk/platform-tools and run the <code>adb</code> command, you should see a load of information thrown back at you about what you can do with ADB. Running <code>adb devices</code> should return the line <code>List of devices attached</code>, and nothing else, because you haven't got any devices attached yet.</p> + +<p>But at this point, you need to set the PATH variable to point to the ADB tool, so you can run it from anywhere, not just when you are in the exact directory that ADB is in.</p> + +<p>To do this on Windows 8 (Windows 7 will be very similar, but with slightly different menu options):</p> + +<ul> + <li>Right click on the Windows button in the bottom left and select <em>Control Panel</em> > <em>System and Security</em> > <em>System</em> > <em>Advanced System settings</em> > <em>Environment Variables</em>.</li> + <li>In the <em>System variables</em> list, find the one called <em>Path</em>, select it, then click <em>Edit...</em></li> + <li>In the <em>Variable value</em> text field of the resulting dialog box, make sure you are at the end of the big string of characters in the box, then type a semi colon (;), followed by the location of the adb tool on your system, which should be <em>C:\Users\[YOUR USER NAME]\Desktop\adt\sdk\platform-tools</em>.<br> + <br> + So if your user name is jamessmith, you would enter ;<em>C:\Users\jamessmith\Desktop\adt\sdk\platform-tools</em>.</li> + <li>Press <em>OK</em> on all the dialog boxes you opened up in this section.</li> + <li>Close your command prompt, open a new one, and test it by typing <code>adb devices</code>. If it comes up with <code>List of devices attached</code>, you are successful!</li> +</ul> + +<p>On Mac/Linux:</p> + +<ul> + <li>In the Finder app, go to your home folder (the one with the house icon.)</li> + <li>If you can't already see hidden files (for example, system files with dots (.) at the beginning), go to Terminal and enter the command <code>defaults write com.apple.finder AppleShowAllFiles YES</code>, then restart Finder.</li> + <li>Open your <code>.bash_profile</code> or <code>.bashrc</code> file in a plain text editor like Text Wrangler or Sublime Text (it needs to be a plain text editor.)</li> + <li>Inside the file, add a new line <code>PATH=/Users/<em>[YOUR USER NAME]</em>/Desktop/adt/sdk/platform-tools:$PATH</code></li> + <li>Save and close the file.</li> + <li>Restart your terminal, and test it by typing <code>adb devices</code>. If it comes up with <code>List of devices attached</code>, you are successful!</li> +</ul> + +<h3 id="Extra_steps_for_Linux_and_Mac">Extra steps for Linux and Mac</h3> + +<p>No additional steps should be required if you are using a Linux or Mac system, although depending on your Linux distro, you might need to <a href="https://developer.mozilla.org/en-US/Firefox_OS/Firefox_OS_build_prerequisites#For_Linux.3A_configure_the_udev_rule_for_your_phone">add a udev rule</a> for your phone.</p> + +<p>The udev rule for the Flame should look something like the following:</p> + +<pre>SUBSYSTEM=="usb", ATTRS{idVendor}=="05c6", ATTRS{idProduct}=="9025", GROUP="users", MODE="0666"</pre> + +<p>Make sure to <code>--reload-rules</code>, then unplug and replug and your device before continuing.</p> + +<h3 id="Extra_steps_for_Windows">Extra steps for Windows</h3> + +<p>To access the Flame device with the <a href="/en-US/Firefox_OS/Debugging/Installing_ADB">ADB</a> and Mozilla dev tools like <a href="/en-US/Firefox_OS/Using_the_App_Manager">App Manager</a>/<a href="/en-US/docs/Tools/WebIDE">WebIDE</a>, a USB driver is required. Follow the steps outlined in the below sections to install it.</p> + +<h4 id="Downloading_the_driver">Downloading the driver</h4> + +<p><a href="http://cds.w5v8t3u9.hwcdn.net/Alcatel_USB_Driver_Q_4.0.0_2013_11_11_noinstall.zip">Download the Windows driver from this location</a>. Once downloaded, extract the contents of the ZIP file to a suitable place on your hard drive.</p> + +<div class="note"> +<p><strong>Note</strong>: The Android Debug Bridge (<a href="/en-US/Firefox_OS/Debugging/Installing_ADB">ADB</a>) must be installed first: see instructions above if you've not already done this.</p> +</div> + +<h4 id="Installing_the_USB_Driver">Installing the USB Driver</h4> + +<p>At this point, connect your Flame device to your computer using a USB cable.</p> + +<p>To install the driver, open the <code>Alcatel_USB_Driver_Q_4.0.0_2013_11_11_noinstall</code> directory within the extracted ZIP file and double click on the <code>DriverInstaller.exe</code> executable. You may receive a warning at this point that the executable is from an unknown publisher. If so, select the <em>Yes</em> button and the executable will be launched.</p> + +<p><img alt="Simple dialog box showing a picture of a phone along with install and uninstall buttons." src="https://mdn.mozillademos.org/files/8079/driver-install.png" style="display: block; height: 523px; margin: 0px auto; width: 358px;"></p> + +<p>Click on the <em>Install</em> button to install the driver.</p> + +<p>After the driver installs, you can check that it is working by opening a command line window and typing <code>adb devices</code>. This should list the connected device with an output something like:</p> + +<pre>List of devices attached +3561d02a device</pre> + +<p>If your device is not showing up here, check in the Windows Device Manager. Your Flame may be showing up as "ACER ADB Interface". You can confirm this by unplugging the device and seeing if it disappears from the device manager. Uninstall the driver software by right-clicking on "ACER ADB Interface" and clicking uninstall. Be sure to check the box in the dialog to delete the driver software. Now re-run the installer above. It is advisable to set the screen timeout on your Flame to something high (<em>Settings</em> > <em>Display</em> > <em>Screen timeout</em>) as Windows sometimes appears to reinstall the default drivers when the screen turns off.</p> + +<h2 id="Updating_your_Flame's_software">Updating your Flame's software</h2> + +<p>We will have two main "channels" of Firefox OS software version releases for the Flame phone:</p> + +<ul> + <li>The first channel is our release channel. Flames ship with this channel and will receive over-the-air updates for future major versions, that is, Flames will update from 1.3 to 2.0 to 2.1, etc.</li> + <li>The second channel is our nightly channel. Flames can be flashed to this channel, and after the initial flashing will get over the air updates on a daily or nearly daily basis.</li> +</ul> + +<p>You can get recovery files and tools at the following storage location:</p> + +<ul> + <li><a href="http://cds.w5v8t3u9.hwcdn.net/Flame_2.0_v180_1.zip">Base image v180.zip</a>: An archive containing the Flame's base image of Firefox OS 2.0.</li> +</ul> + +<div class="note"> +<p><strong>Note</strong>: Firefox OS images v180 and above are based on Android KK (Kitkat, 4.4); JB (Jellybean, 4.1–4.3) builds have now been discontinued and are no longer supported, so don't use anything older than v180.</p> +</div> + +<div class="warning"> +<p><strong>Important</strong>: When running a shallow or full flash, your phone data will be overwritten: you should therefore back up your data before updating! See the {{anch("Backing up and restoring your Flame data")}} section for more details.</p> +</div> + +<p>To install the base image on your device:</p> + +<ol> + <li>Make sure remote debugging is enabled on your Flame, using the <em>Remote debugging/Debugging via USB</em> option in the device's <a href="/en-US/Firefox_OS/Debugging/Developer_settings">Developer settings</a> (the option is different, depending on whether you have Firefox 1.3 and under, or Firefox 1.4+ installed).</li> + <li>Connect your Flame to your computer via a USB cable if it isn't already. Verify that the computer is connected to the device by running the <code>adb devices</code> command in a terminal.</li> + <li>Download the <code>.zip</code> file referenced above. Unzip it onto your Desktop.</li> + <li>Go into the directory you extracted the software into and run it: + <ul> + <li>On Windows, enter the directory in your command prompt, then run the <code>flash.bat</code> script using <code>flash.bat</code> (or double click the file in explorer.)<br> + <strong>Note</strong>: If <code>flash.bat </code>is missing, simply rename the <code>flash.sh</code> file to <code>flash.bat</code>, then run that. Make sure you have <code>adb</code> and <code>fastboot</code> installed and available on <code>PATH</code>.</li> + <li>On Linux / OSX, enter the directory in your terminal, then run the <code>flash.sh</code> script using <code>sudo ./flash.sh</code> (if you don't run it using <code>sudo</code>, the flash script may fail to see your device, and it won't work).</li> + </ul> + </li> +</ol> + +<div class="note"> +<p><strong>Note</strong>: You are also welcome to build your own builds to install on the Flame: see <a href="/en-US/Firefox_OS/Building_and_installing_Firefox_OS">Building and installing Firefox OS</a>.</p> +</div> + +<h3 id="Updating_your_Flame_to_a_nightly_build">Updating your Flame to a nightly build</h3> + +<div class="note"> +<p><strong>Note</strong>: For this current build, Nightly development builds of Firefox OS do not support A-GPS, which may lead to slow performance of GPS functionality. We plan to resolve this in an updated future Nightly channel.</p> +</div> + +<div class="warning"> +<p><strong>Important</strong>: When running a shallow or full flash, your phone data will be overwritten: you should therefore back up your data before updating! See the {{anch("Backing up and restoring your Flame data")}} section for more details.</p> +</div> + +<ol> + <li>Before updating your phone to a Nightly build you should flash the latest base image to make sure the underlying systems are up to date. Download a base image and use it to update your device's software, as explained above.</li> + <li>Because the above step installs a fresh operating system on your device, you'll need to enable remote debugging on your Flame again, using the <em>Remote debugging </em>option in the device's <a href="/en-US/Firefox_OS/Debugging/Developer_settings">Developer settings</a>.</li> + <li>Next, choose a build to install (found on <a href="http://ftp.mozilla.org/pub/mozilla.org/b2g/nightly/">http://ftp.mozilla.org/pub/mozilla.org/b2g/nightly/</a>.) You'll want one of the following: + <ul style="margin-left: 40px;"> + <li>Production builds (including locales) + <ul> + <li><a href="https://ftp.mozilla.org/pub/mozilla.org/b2g/nightly/latest-mozilla-central-flame-kk/">Latest master builds</a> (currently 2.2)</li> + <li><a href="https://ftp.mozilla.org/pub/mozilla.org/b2g/nightly/latest-mozilla-aurora-flame-kk/">Latest aurora builds</a> (currently 2.1)</li> + <li><a href="https://ftp.mozilla.org/pub/mozilla.org/b2g/nightly/latest-mozilla-b2g32_v2_0-flame-kk/">Latest release builds</a> (currently 2.0)</li> + </ul> + </li> + <li>Engineering builds (with test apps and only pseudo-locales) + <ul> + <li><a href="https://ftp.mozilla.org/pub/mozilla.org/b2g/nightly/latest-mozilla-central-flame-kk-eng/">Latest master builds</a> (currently 2.2)</li> + <li><a href="https://ftp.mozilla.org/pub/mozilla.org/b2g/nightly/latest-mozilla-aurora-flame-kk-eng/">Latest aurora builds</a> (currently 2.1)</li> + <li><a href="https://ftp.mozilla.org/pub/mozilla.org/b2g/nightly/latest-mozilla-b2g32_v2_0-flame-kk-eng/">Latest release builds</a> (currently 2.0)</li> + </ul> + </li> + </ul> + </li> + <li>Pick a version and download both the <code>b2g-XX.XX.en-US.android-arm.tar.gz</code> and <code>gaia.zip</code> files. Save them inside a directory on your Desktop called something like <code>fxos</code>.</li> + <li>Download the <a href="https://github.com/Mozilla-TWQA/B2G-flash-tool/blob/master/shallow_flash.sh">shallow flash script</a> and save it in the same directory as the above two files: follow the link, press the <em>Raw</em> button, then use your browser's save functionality to save the page directly as <code>shallow_flash.sh</code>.</li> + <li><strong>For Windows users:</strong> Also download the <a href="https://raw.githubusercontent.com/Mozilla-TWQA/B2G-flash-tool/master/shallow_flash.bat">shallow_flash.bat windows script</a> and install <a href="https://cygwin.com">Cygwin</a>, which provides a Linux-like environment on Windows. You will need to install the default Cygwin <em>base</em> category plus the <em>unzip</em> package (on the installer, type <em>unzip</em> in the search box and click <em>skip</em>).</li> + <li> + <p>In your Terminal, <code>cd</code> into the directory you saved the files in and Flash the builds to your phone using the following:</p> + + <p><strong>Linux</strong>:</p> + + <pre class="brush: bash">./shallow_flash.sh -ggaia.zip -Gb2g-XX.XX.en-US.android-arm.tar.gz +</pre> + + <p><strong>Mac</strong>:</p> + + <pre class="brush: bash">./shallow_flash.sh -g gaia.zip -G b2g-XX.XX.en-US.android-arm.tar.gz</pre> + + <p><strong>Windows</strong>:</p> + + <p>Double click <code>shallow_flash.bat</code> (with cogs icon) or run it from a command shell. It will flash <code>gaia.zip</code> and a single <code>b2g-XX.XX.en-US.android-arm.tar.gz</code> file.</p> + </li> +</ol> + +<div class="note"> +<p><strong>Note</strong>: If you get a "permission denied" error when running the above commands, your shell script probably doesn't have the right permissions. Running <code>chmod +x shallow_flash.sh</code> on it should solve this problem.</p> +</div> + +<div class="note"> +<p><strong>Note</strong>: A "shallow flash" updates <a href="/en-US/docs/Mozilla/Gecko">Gecko</a> and <a href="/en-US/Firefox_OS/Platform/Gaia">Gaia</a> plus data directories, as opposed to a full flash, which updates Gecko/Gaia, but also the underlying <a href="/en-US/Firefox_OS/Platform/Gonk">Gonk</a> layer and associated binaries particular to that device type. This is why it is a good idea to update to the official base image first, as suggested above, then shallow flash over the top of that, once you've got the Gonk/binary layer right.</p> +</div> + +<p>Once the install procedure finishes the phone should reboot into the updated build and display the first time user workflow.</p> + +<h4 id="Font_fix">Font fix</h4> + +<p>After updating Gecko and Gaia to nightly with the v180 base image, there will be a mismatch between the fonts that Gecko and Gaia expects and what the base image provides. To fix this, download our <a href="https://people.mozilla.org/~mwu/fira-font-update.zip">font update package</a>, extract it, navigate into the directory created by extracting, and run the supplied <code>flash.sh</code> script.</p> + +<div class="note"> +<p><strong>Note</strong>: Another option is to use the <a href="https://github.com/Mozilla-TWQA/B2G-flash-tool/blob/master/update_system_fonts.sh"><code>update_system_fonts.sh</code></a> script, which will download and flash the system fonts automatically.</p> +</div> + +<h4 id="Switch_to_nightly_update_channel">Switch to nightly update channel</h4> + +<ol> + <li>Make sure remote debugging is enabled on your Flame, using the <em>Remote debugging/Debugging via USB</em> option in the device's <a href="/en-US/Firefox_OS/Debugging/Developer_settings">Developer settings</a></li> + <li>Download the <a href="https://github.com/Mozilla-TWQA/B2G-flash-tool/blob/master/change_channel.sh">change channel</a> script: follow the link, press the <em>Raw</em> button, then use your browser's save functionality to save the page directly as <code>change_channel.sh</code>.</li> + <li>In your Terminal, <code>cd</code> into the directory you saved the script in and change the update channel on your phone using the following command:<br> + + <pre class="brush: bash">./change_channel.sh -v nightly</pre> + </li> + <li>Once the phone reboots, check for updates by going into <em>Settings > Device information > Check now</em></li> +</ol> + +<p>You should now get nightly OTA updates to your phone.</p> + +<div class="note"> +<p><strong>Note:</strong> You can choose between several different update channels. Run "./change_channel.sh -h" to see the other channel options.</p> +</div> + +<h3 id="Fastboot_mode">Fastboot mode</h3> + +<p>If flashing a new build to your phone fails to work, your phone may become unresponsive, leading to the phone rebooting in recovery mode. The recovery mode provides few options (<em>Reboot</em>, <em>Update from adb</em>, <em>Wipe data</em>, <em>Wipe cache</em>, and <em>Update from sdcard</em>). Unfortunately, selecting <em>Update from adb</em> triggers a sideload mode in which you cannot use the other adb commands. The <code>adb sideload</code> command would work but the various flash scripts rely on other adb commands.</p> + +<p>You can force fastboot mode as follows:</p> + +<ol> + <li>Power off the phone (which may involve removing the battery in extreme cases...)</li> + <li>Plug in the USB cable.</li> + <li>Power the phone up again by pressing the Volume Down and Power buttons together.</li> +</ol> + +<p>The phone should now display the text "FASTBOOT": it is in fastboot mode and is waiting for a USB connection. At this point, a USB-connected, computer with adb installed should see the phone listed when the <code>fastboot devices</code> command is run. Note that regular adb would not see the device — only fastboot sees it. In this mode, you can use the flash script to install v180 as explained above. As the script does use both adb and fastboot commands, you may see some initial error and warnings from adb, but the device should be flashed properly at the end of the procedure.</p> + +<h3 id="Emergency_download_mode">Emergency download mode</h3> + +<p>If flashing a new build to your phone fails to work, your phone becomes unresponsive, and the phone cannot enter fastboot mode, you can use emergency mode for recovery. A USB cable and the <a href="http://cds.w5v8t3u9.hwcdn.net/Flame%20Rescue%20Tool.zip">Emergency Download Tool</a> are required to enter emergency download mode. Install this tool and follow the instructions.</p> + +<h3 id="Recovery_mode">Recovery mode</h3> + +<p>You can enter recovery mode to clear your phone data or manually update the firmware. There are two ways to enter this mode:</p> + +<ul> + <li>If <a href="/en-US/Firefox_OS/Debugging/Installing_ADB">ADB</a> tools are available, make sure Remote debugging is turned on in the phone's <a href="/en-US/Firefox_OS/Debugging/Developer_settings#Remote_debugging">Developer settings</a>, connect your phone to your computer via USB and enter <code>adb reboot recovery</code> on the command line.</li> + <li>If your phone is powered off, press the Volume Up + Power buttons together.</li> +</ul> + +<p>When in recovery mode, press the Volume up/down keys to move the selection highlight, and the Power key to select. Make sure you have your phone data (Contacts, SMS, etc.) backed up before clearing data, and your upgrade packages downloaded before updating.</p> + +<h2 id="Backing_up_and_restoring_your_Flame_data">Backing up and restoring your Flame data</h2> + +<p>When using a Flame, you won't want to lose your phone's contacts and other data while upgrading to a new build (as explained earlier in this article). To backup and restore data you can use our <a href="https://github.com/Mozilla-TWQA/B2G-flash-tool/blob/master/backup_restore_profile.sh">Backup and restore profile</a> tool.</p> + +<ol> + <li>To use this, first download it from Github at the above link. The easiest way to save it is to press the <em>Raw</em> button, then save the raw code as a <code>.sh</code> file using your browser's <em>Save As...</em> option.</li> + <li>Next, make sure you'll have the necessary permissions to execute this file: <code>cd</code> into the directory where you saved the file, and run the following command: + <pre class="brush: bash">chmod +x backup_restore_profile.sh</pre> + </li> +</ol> + +<div class="note"> +<p><strong>Note</strong>: When using this tool, you'll also need to make sure that your phone is connected via USB to your computer, and that ADB (see {{anch("Important steps to follow first")}} above) and Debugging via USB (in your device's <a href="/en-US/Firefox_OS/Debugging/Developer_settings">Developer settings</a>) are enabled.</p> +</div> + +<div class="note"> +<p><strong>Note</strong>: These instructions should work on Mac and Linux out of the box. To use the backup and restore feature on Windows you'll have to install <a href="https://www.cygwin.com/">Cygwin</a> and run it from inside that.</p> +</div> + +<h3 id="Backing_up_data_from_your_phone">Backing up data from your phone</h3> + +<p>In the directory where you saved the <code>backup_restore_profile.sh</code> file, run the following:</p> + +<pre class="brush: bash">./backup_restore_profile.sh -b</pre> + +<p>This should save your device profile to a directory called <code>mozilla-profile</code>, in the same directory as the script is located.</p> + +<h3 id="Restoring_data_to_your_phone">Restoring data to your phone</h3> + +<p>In the directory where your <code>mozilla-profile</code> directory is located (see above section), run the following:</p> + +<pre class="brush: bash">./backup_restore_profile.sh -r</pre> + +<h3 id="Other_options">Other options</h3> + +<p>The full list of options available for the <code>backup_restore_profile.sh</code> script is as follows:</p> + +<ul> + <li><code>-b</code> or <code>--backup</code> — Backup user profile.</li> + <li><code>-r</code> or <code>--restore</code> — Restore user profile.</li> + <li><code>--sdcard</code> — Also backup/restore the SD card.</li> + <li><code>--no-reboot</code> — Do not reboot B2G after backup/restore.</li> + <li><code>-p</code> or <code>--profile-dir</code> — Specify the profile folder. The default is <code>./mozilla-profile</code>.</li> + <li><code>-h</code> or <code>--help</code> — Display help.</li> +</ul> + +<h2 id="Pushing_apps_to_your_Flame">Pushing apps to your Flame</h2> + +<p>The <a href="/en-US/Firefox_OS/Using_the_App_Manager">App Manager</a> and <a href="/en-US/docs/Tools/WebIDE">WebIDE</a> tools make it easy to push apps to your phone, for testing, etc.</p> + +<h2 id="RAM_adjustment">RAM adjustment</h2> + +<p>You can adjust the available RAM capacity to see how apps perform on Firefox OS phones with lower memory footprints.</p> + +<p>This is accomplished by entering fastboot mode (install fastboot first, which is available on the same SDK page as <a href="/en-US/Firefox_OS/Debugging/Installing_ADB">ADB</a>) and typing:</p> + +<pre class="brush: bash">adb reboot bootloader +fastboot oem mem [0|256-1024]</pre> + +<p>“0” is the memory automatically detected and “256-1024” is the number of megabytes. For example, if you want to adjust device RAM capacity to 512M, enter <code>fastboot oem mem 512</code>.</p> + +<p>You'll need to then reboot your device for the settings to take effect. This can be done using:</p> + +<pre class="brush: bash">fastboot reboot</pre> + +<p>The current memory size can be returned by entering fastboot mode and typing:</p> + +<pre class="brush: bash">fastboot getvar mem +</pre> + +<h2 id="Network_and_Device_specs">Network and Device specs</h2> + +<p><strong>Network</strong>:</p> + +<ul> + <li>802.11b/g/n wireless internet</li> + <li>GSM 850/900/1800/1900MHz</li> + <li>UMTS 850/900/1900/2100MHz</li> +</ul> + +<p><strong>Hardware</strong>: You can find more of the hardware features listed on our <a href="/en-US/Firefox_OS/Developer_phone_guide/Phone_specs">Phone and device specs page</a>.</p> + +<p>Additional features include:</p> + +<ul> + <li>NFC</li> + <li>Bluetooth 3.0</li> + <li>Accelerometer</li> + <li>FM radio</li> + <li>Proximity Sensor</li> + <li>GPS W / A-GPS support</li> + <li>Ambient Light Sensor</li> +</ul> + +<h2 id="See_also">See also</h2> + +<ul> + <li> + <div class="warning"> + <div class="syntaxbox"><a href="https://hacks.mozilla.org/2014/08/videos-getting-started-with-your-flame-device/">Getting started with your Flame</a>: How-to videos by Chris Heilmann</div> + </div> + </li> +</ul> + +<p> </p> diff --git a/files/pl/archive/b2g_os/phone_guide/zte_open_c/index.html b/files/pl/archive/b2g_os/phone_guide/zte_open_c/index.html new file mode 100644 index 0000000000..8e4616e631 --- /dev/null +++ b/files/pl/archive/b2g_os/phone_guide/zte_open_c/index.html @@ -0,0 +1,82 @@ +--- +title: ZTE OPEN C +slug: Archive/B2G_OS/Phone_guide/ZTE_OPEN_C +translation_of: Archive/B2G_OS/Phone_guide/ZTE_OPEN_C +--- +<div class="summary"> + <p><span class="seoSummary">ZTE Open C jest następnym telefonem od ZTE z Firefox OS. </span>Posiada między innymi 3-megapikselowy aparat i 4-calowy ekran WVGA. Wyposażony jest w Firefox OS 1.3. Ten artykuł przedstawia informację o tym telefonie oraz szczegóły o aktualizacji i naprawianiu problemów.</p> +</div> +<div class="note"> + <p><strong>Uwaga</strong>: Ten artkuł nie dotyczy ZTE Open. Jeśli posiadasz ten model, powinieneś udać się na stronę <a href="/en-US/Firefox_OS/Developer_phone_guide/ZTE_OPEN">ZTE Open</a>.</p> +</div> +<div class="note"> + <p><strong>Uwaga</strong>: Narzędzie aktualizacji, które jest potrzebne, aby odblokować telefon jest narazię dostępne tylko do systemu Windows. Nie kupuj tego telefonu jeśli nie masz systemu Windows i chcesz ręcznie instalować własne budowy Firefox OS.</p> +</div> +<p>ZTE Open C jest pierwszym telefonem z <a href="http://blog.mozilla.org/futurereleases/2014/05/08/firefox-os-update-adds-new-features-including-dual-sim-support-and-enhancements-for-music-lovers-and-gamers">ostatnią aktualizacją Firefox OS</a>, oferującą dużo nowości, w tym dostęp do odtwarzacza muzyki z zablokowanego ekranu oraz pasek powiadomień i zaawansowane udostępnianie bluetooth, pozwalające na przenoszenie wielu plików jednoczesnie. Urzytkownicy mogą teraz poruszać się po telefonie szybciej, dzięki inteligentnym folderom, które grupują aplikacje i wyszukiwanie aplikacji w kategorie. Dodatkowo zostały przyśpieszone czasy uruchamiania i przewijania systemowych aplikacji, np. kalendarza, kontaktów, aparatu.</p> +<h2 id="Kupno_urządzenia">Kupno urządzenia</h2> +<p>Telefon kosztuje US$99.99, i jest dostępny w sklepie eBay:</p> +<ul> + <li><a href="http://item.ebay.com/291125433026">ZTE eBay US store</a></li> + <li><a href="http://item.ebay.co.uk/171301269724">ZTE eBay UK store</a> (Klienci z Francji i innych pobliskich europejskich krajów)</li> + <li><a href="http://cgi.ebay.de/ws/eBayISAPI.dll?ViewItem&item=131151681046&ssPageName=STRK:MESE:IT">ZTE eBay DE store</a></li> + <li><a href="http://www.ebay.com/itm/111326263156">ZTE eBay RU and EU stores</a></li> +</ul> +<div class="note"> + <p><strong>Uwaga</strong>: Telefon nie posiada domyślnie zainstalowanych aplikacji i usług dla konkretnych sieci. Jest odblokowany dla wszystkich operatorów.</p> +</div> +<h2 id="Parametry_telefonu">Parametry telefonu</h2> +<p>Zobacz <a href="/en-US/Firefox_OS/Developer_phone_guide/Phone_specs">Telefony i informacje</a>.</p> +<h2 id="Aktualizowanie_Firefox_OS">Aktualizowanie Firefox OS</h2> +<p>Najłatwiej zaktualizować urzywając aktualizacji ze <a href="http://www.ztedevices.com/support/selectproduct.html?type=software">Strony pomocy ZTE</a>, wybierz swój kraj w lewej kolumnie, "<em>Smart Phones"</em> w środkowej, i w prawej "Open C(European Standard)" jeśli mieszkasz w europie lub "Open C(American Standard)" jeśli w USA. Potem kliknij przycisk "Selected" aby przejść do strony pobierania.</p> +<p>Gdy pobierzesz aktualizację, w pobranym pliku ZIP poszukaj pliku PDF, pokazującego jak zaktualizować telefon.</p> +<h2 id="Ręczne_aktualizacje">Ręczne aktualizacje</h2> +<p>Jesli chcesz zaktualizować Geco lub Gaia samemu, proces jest trochę trudniejszy. Telefon jest domyślnie zablokowany(bez uprawnień root'a). Aby odblokować telefon użyj <a href="http://en.comebuy.com/developer-firefox-os-open-c.html">Open_C_upgrade_Tool na stronie comebuy.com</a>. Te narzędzie aktualizuje firmware dając prawa root'a i włączając fastboot. Pozwala to także na wgranie nowego oprogramowania na telefon.</p> +<div class="note"> + <p><strong>Uwaga</strong>: To narzędzie jest narazię dostępne tylko dla systemu Windows.</p> +</div> +<h3 id="Aktualizowanie_Geco_i_Gaia">Aktualizowanie Geco i Gaia</h3> +<p>Kiedy posiadasz włączony fastboot, możesz <a href="https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Building_and_installing_Firefox_OS">zbudować i zainstalować nowe elementy Firefox OS/B2G</a> Gecko i Gaia na nim.</p> +<ol> + <li>Zacznij od instrukcji <a href="https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_build_prerequisites">wstępnej budowy</a> i traktuj Open C jak telefon Flame na potrzeby konfiguracji. Ponieważ obydwa (Flame i Open C) bazują na systemie Android Jellybean.</li> + <li>W dalszych krokach trzeba odwołać się do niestandardowego pliku manifest. <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1016867">Pobież załącznik tego bug'u</a> i zapisz jako openc.xml.</li> + <li>Wyczyść katalog B2G, usuwając niepotrzebne katalogi:<br> + <pre class="brush: bash" id="comment_text_2">rm -rf objdir-gecko/ out/ backup-flame/</pre> + </li> + <li>Teraz skonfiguruj Firefox OS następującą komendą: + <pre class="brush: bash language-html">./config.sh flame /ŚCIEŻKA/DO/openc.xml</pre> + </li> + <li>Teraz możesz zbudować i wgrać komponenty Gecko wpisując: + <pre class="brush: bash language-html">./build.sh gecko +./flash.sh gecko</pre> + </li> + <li>Teraz powinieneś zaktualizować Gaia, aby nowa wersja Gecko działała z odpowiedną wersją Gaia: + <pre class="brush: bash language-html">cd gaia +make reset-gaia</pre> + </li> +</ol> +<div class="warning"> + <p><strong>Uwaga</strong>: Próba wgrania całego obrazu Flame może uszkodzić telefon, dlatego jest to niezalecane.</p> +</div> +<h3 id="Aktualizowanie_Gaia">Aktualizowanie Gaia</h3> +<p>Aby zaktualizować tylko Gaia(bez Gecko), musisz zrobić fork'a i zklonować repozytorium Gaia na Github, zanim wgrasz go na telefon.</p> +<ol dir="ltr"> + <li>Upewnij się że masz <a href="https://developer.mozilla.org/en-US/Firefox_OS/Debugging/Installing_ADB">ADB</a> zainstalowane.</li> + <li>Wejdź na <a href="https://github.com/mozilla-b2g/gaia">https://github.com/mozilla-b2g/gaia</a> i kliknij "fork" w prawym górnym rogu aby zrobić fork'a do własnego repozytorium.</li> + <li>Skopiuj kod z własnego repozytorium na komputer, następującą komendą: + <pre class="brush: bash language-html">git clone https://github.com/twoj-nick-na-github/gaia.git</pre> + </li> + <li><code>cd</code> do pobranego katalogu .</li> + <li>Na telefonie, <a href="https://developer.mozilla.org/en-US/Firefox_OS/Debugging/Developer_settings#Debugging_via_USB">włącz zdalne debugowanie</a> (wybierz opcję "ADB and Devtools").</li> + <li>Teraz podłącz telefon do komputera przez USB. Sprawdź czy ADB dziala komendą <code>adb devices</code>.</li> + <li>Wpisz poniższą komenda, aby zresetować i zaktualizować twój telefon z nową wersją Gaia: + <pre class="brush: bash language-html">make reset-gaia</pre> + </li> +</ol> +<h2 id="Zepsułem_telefon">Zepsułem telefon</h2> +<p>Jeśli twój telefon przestanie odpowiadać, powinieneś naprawić go urzywając oficjalnych wersji Firefox OS i instrukcji do wgrania ich przez karty SD, na stronie ZTE:</p> +<ul> + <li><a href="http://www.ztedevices.com/support/smart_phone/65229ec9-3165-424e-a7dd-3759356325fd.html?type=software">ZTE Open C (Ebay) - Spain</a></li> + <li><a href="http://www.ztedevices.com/support/smart_phone/92f36c98-9cc0-42d6-8f23-8834b4a6849c.html?type=software">ZTE Open C (Ebay) - UK American Standard</a></li> + <li><a href="http://www.ztedevices.com/support/smart_phone/46d40c52-bed4-4cdc-9df9-01719cdf0a70.html?type=software">ZTE Open C (Ebay) - UK European Standard</a></li> +</ul> +<p>Możesz też odwołać się do tego <a href="https://support.mozilla.org/en-US/questions/1003136">wpisu pomocy technicznej</a> po więcej informacji.</p> diff --git a/files/pl/archive/b2g_os/platform/gaia/index.html b/files/pl/archive/b2g_os/platform/gaia/index.html new file mode 100644 index 0000000000..2e30a4b098 --- /dev/null +++ b/files/pl/archive/b2g_os/platform/gaia/index.html @@ -0,0 +1,69 @@ +--- +title: Gaia +slug: Archive/B2G_OS/Platform/Gaia +translation_of: Archive/B2G_OS/Platform/Gaia +--- +<p>Gaia jest warstwą interfejsu <a href="/en-US/docs/Mozilla/Firefox_OS" title="Mozilla/Firefox_OS">Firefox OS</a>. Wszystko co pojawia się na ekranie po uruchomieniu Firefox OS jest rysowane przez Gaia, włączając w to ekran logowania, ekran główny, aplikację telefonu i inne. Gaia jest całkowicie napisana w <a href="/en-US/docs/en-US/HTML" title="HTML">HTML</a>, <a href="/en-US/docs/CSS" title="CSS">CSS</a> oraz <a href="/en-US/docs/JavaScript" title="JavaScript">JavaScript</a>. Jedynym interfejsem komunikacji z systemem operacyjnym i sprzętem jest standardowe Web API implementowane przez <a href="/en-US/docs/Gecko" title="Gecko">Gecko</a>.</p> +<p>Ze względu na sposób w jaki została zaprojektowana, Gaia może być uruchamiana nie tylko na urządzeniach działających pod kontrolą systemu Firefox OS, lecz także na innych systemach operacyjnych i w innych przeglądarkach internetowych (aczkolwiek, w przypadku tych potencjalnie wycofanych, funkcjonalność zależeć będzie od możliwości przeglądarki).</p> +<p>Aplikacje od zewnętrznych dostawców instalowane poza Gaia mogą być uruchomione za jej pośrednictwem.</p> +<table class="topicpage-table"> + <tbody> + <tr> + <td> + <h2 class="Documentation" id="Documentation" name="Documentation">Dokumentacja na temat Gaia</h2> + <dl> + <dt> + <a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Gaia/Introduction_to_Gaia" title="Mozilla/Boot_to_Gecko/Introduction to Gaia">Wstęp do Gaia</a></dt> + <dd> + Gaia jest aplikacją stanowiącą interfejs użytkownika dla urządzeń z systemem Firefox OS; to po prostu aplikacja webowa uruchomiona na wierzchu stosu aplikacyjnego systemu Firefox OS. Ten przewodnik wprowadza do Gaia.</dd> + <dt> + <a href="https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Platform/Gaia/Gaia_apps">Aplikacje Gaia</a></dt> + <dd> + Informacje o każdej z domyślnych aplikacji dostępnych w rodzinie Gaia wraz ze wskazówkami dotyczących ich użytkowania i modyfikacji.</dd> + <dt> + <a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Gaia/Hacking" title="Mozilla/Boot_to_Gecko/Gaia hacking guide">Przewodnik hackowania Gaia</a></dt> + <dd> + Przewodnik hackowania i modyfikowania interfejsu Gaia.</dd> + <dt> + <a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Gaia/Build_System_Primer" title="/en-US/docs/Mozilla/Firefox_OS/Platform/Gaia/Build_System_Primer">Elementarz Systemu Budującego Gaia</a></dt> + <dd> + Więszość znaczących prac na etapach kompilacji Gaia jest realizowana przez skrypty znajdujące się wewnątrz podkatalogów katalogu build.</dd> + <dt> + <a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Gaia/Hacking_Tips_And_FAQ" title="/en-US/docs/Mozilla/Firefox_OS/Platform/Gaia/Hacking_Tips_And_FAQ">FAQ i wskazówki hackowania Gaia</a></dt> + <dd> + Lista przydatnych wskazówek i często zadawanych pytań dotyczących hackowania Gaia.</dd> + </dl> + <p><span class="alllinks"><a href="/en-US/docs/tag/Gaia" title="tag/B2G">Zobacz wszystko...</a></span></p> + </td> + <td> + <h2 class="Community" id="Community" name="Community">Uzyskanie pomocy od społeczności</h2> + <p>Jeśli pracujesz z Gaia lub tworzysz aplikacje dla Gaia jest mnóstwo zasobów przygotowanych przez społeczność, które mogą Ci pomóc!</p> + <ul> + <li>Zasięgnij porad na forum projektu Boot to Gecko: {{ DiscussionList("dev-gaia", "mozilla.dev.gaia") }}</li> + </ul> + <ul> + <li>Zadaj pytanie na kanale IRC projektu Gaia od Mozilli: <a href="irc://irc.mozilla.org/gaia" title="irc://irc.mozilla.org/gaia">#gaia</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">Nie zapominaj o <em>netykiecie</em>...</a></span></p> + <br> + <h2 class="Related_Topics" id="Related_Topics" name="Related_Topics">Powiązane tematy</h2> + <ul> + <li><a href="/en-US/docs/Mobile" title="Mobile">Mobile</a></li> + <li><a href="/en-US/docs/Web" title="/en-US/docs/Web">Technologie dla webdevelopera </a> + <ul> + <li><a href="/en-US/docs/HTML" title="HTML">HTML</a></li> + <li><a href="/en-US/docs/CSS" title="CSS">CSS</a></li> + <li><a href="/en-US/docs/JavaScript" title="JavaScript">JavaScript</a></li> + </ul> + </li> + <li><a href="/en-US/docs/WebAPI" title="/en-US/docs/WebAPI">WebAPI</a></li> + </ul> + <h2 class="Tools" id="Resources" name="Resources">Zasoby</h2> + <ul> + <li><a href="/en-US/docs/Mozilla/Firefox_OS/Architecture" title="Mozilla/Firefox_OS/Architecture">Przegląd architektury Firefox OS</a></li> + </ul> + </td> + </tr> + </tbody> +</table> +<p> </p> diff --git a/files/pl/archive/b2g_os/platform/index.html b/files/pl/archive/b2g_os/platform/index.html new file mode 100644 index 0000000000..ff2142919b --- /dev/null +++ b/files/pl/archive/b2g_os/platform/index.html @@ -0,0 +1,81 @@ +--- +title: The Firefox OS platform +slug: Archive/B2G_OS/Platform +tags: + - B2G + - Firefox OS + - Landing + - TopicStub +translation_of: Archive/B2G_OS/Platform +--- +<p>The Firefox OS platform consists of many components. While you don't need to understand its architecture in order to build 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.</p> +<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/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/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/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/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/pl/archive/b2g_os/preparing_for_your_first_b2g_build/index.html b/files/pl/archive/b2g_os/preparing_for_your_first_b2g_build/index.html new file mode 100644 index 0000000000..5ac3b5ee4c --- /dev/null +++ b/files/pl/archive/b2g_os/preparing_for_your_first_b2g_build/index.html @@ -0,0 +1,135 @@ +--- +title: Preparing for your first B2G build +slug: Archive/B2G_OS/Preparing_for_your_first_B2G_build +translation_of: Archive/B2G_OS/Preparing_for_your_first_B2G_build +--- +<div class="summary"> + <p>Before you can build B2G, you need to clone the repository and configure your build tree. This article explains how to do that. </p> +</div> +<p>Depending on your internet connection, the configuration step takes a number of hours to download the files necessary to build FirefoxOS (with a mediocre 150 kBps connection, downloading gigabytes of Android repositories can take tens of hours). Waiting is not as fun as doing, so after you have read through this page and have kicked off the configure script, consider using the time to set up and try out the <a class="vt-p" href="/en-US/docs/Mozilla/Firefox_OS/Using_Firefox_OS_Simulator" title="/en-US/docs/Mozilla/Firefox_OS/Using_Firefox_OS_Simulator">Firefox OS simulator</a>, begin familiarizing yourself with <a class="vt-p" href="/en-US/docs/Apps" title="/en-US/docs/Apps">Documentation for app developers</a> including Designing and Building an App, or familiarize yourself with the information on upcoming steps.</p> +<div class="note"> + <p>You might want to have a side task prepared, or a friend available to go for a coffee with, while you are running the B2G config and build steps. They can take a bit of time.</p> +</div> +<h2 id="Clone_B2G_repository">Clone B2G repository</h2> +<p>The first step, before you can start your first build, is to clone the B2G repository. This will not fetch everything! Instead, it will fetch the B2G build system and setup utilities. Most of the actual B2G code is in the main Mozilla <a class="vt-p" href="/en-US/docs/Mercurial" title="Mercurial">Mercurial</a> repository.</p> +<p>To clone the repository, use git:</p> +<pre>git clone git://github.com/mozilla-b2g/B2G.git</pre> +<p>After cloning (which should only take a minute with a fast connection), <code>cd</code> into the B2G directory:</p> +<pre>cd B2G +</pre> +<h2 id="Configuring_B2G_for_your_device">Configuring B2G for your device</h2> +<div class="warning"> + <strong>Important</strong>: Remember that only devices running <strong>Android 4.0.4</strong> (<strong>Ice Cream Sandwich</strong>)<strong>, 4.3 (Jelly Bean) and 4.4 (KitKat)</strong> and platforms based around it are supported (current Firefox OS devices are). Please check that your phone is actually running one of those supported versions, otherwise this step will most likely fail since some drivers are pulled from non-Nexus devices. Also, if you have to flash your device with the matching stock release. Keep in mind that some USB hubs don't work well with flashing tools, so you may have to connect your device to a built-in USB port.</div> +<div class="warning"> + <strong>Important</strong>: if you are doing the build on Ubuntu 12.10+ or Fedora, you will need to specify GCC 4.6 as the default host compiler after having retrieved the B2G sources, for the process to work (these distros use GCC 4.7 by default). Read <a class="vt-p" href="https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Customization_with_the_.userconfig_file#Changing_the_default_host_compiler">Changing the default host compiler</a> to find out how to do it.</div> +<div class="note"> + <strong>Note:</strong> <strong>please read all the instructions below</strong> before running any of the build process commands, to make sure you are doing the right thing for you!</div> +<p>Once you've retrieved the core B2G build system, you need to configure it for the device on which you plan to install it. To get a list of supported devices, you can use the <code>config.sh</code> utility — run the following command from within the B2G directory:</p> +<pre>./config.sh +</pre> +<p>This will display a list of the supported devices, like so:</p> +<pre>Usage: ./config.sh [-cdflnq] (device name) +Flags are passed through to |./repo sync|. + +Valid devices to configure are: +- galaxy-s2 +- galaxy-nexus +- nexus-4 +- nexus-s +- nexus-s-4g +- flo "(Nexus 7 2013)" +- nexus-5 +- flame +- otoro +- unagi +- inari +- keon +- peak +- leo +- hamachi +- helix +- wasabi +- fugu +- tara +- pandaboard +- emulator +- emulator-jb +- emulator-kk +- emulator-x86 +- emulator-x86-jb +- emulator-x86-kk +</pre> +<p>If your device isn't listed, you should stop right now and either help port B2G to your device or wait until someone else does it. We'd prefer it if you help out!</p> +<div class="note"> + <strong>Note:</strong> You can find the device name of your phone on the <a href="/en-US/Firefox_OS/Phones">Firefox OS Phones</a> page.</div> +<div class="note"> + <strong>Note: Configuring and building B2G for Keon on a Mac DOESN'T WORK</strong>. You'll need to use Linux when building for this device.</div> +<div class="note"> + <strong>Note</strong>: If for any reason you want to build against a specific version of Gecko, see <a href="#Building_against_a_custom_Gecko">Building against a custom Gecko</a> before you proceed. If you want to build a branch other than the the default for your device (for example, to build a specific version of B2G), see <a href="#Building_a_branch">Building a branch</a>. Note: the default branch varies by device and is <strong>not necessarily trunk</strong>.</div> +<p>This would be a good time for a coffee break, since at this point, you'll be doing your first pull of all the code needed to build Boot to Gecko. Running the device config step as indicated below can take a long time; you may stop it with Ctrl-C and restart it at a later time. If you think some part of the process may have been terminated without completing, run './repo sync' to repair any possible problems.</p> +<h3 id="Configuring_the_B2G_build_for_a_mobile_device">Configuring the B2G build for a mobile device</h3> +<p>At this point, connect your device if it is not already connected; the configure process will need to access it.</p> +<p>If your device was listed in the results shown above, you can start the configure process by running <code>config.sh</code> again, this time specifying your device's name. For example, to build for the Samsung Google Nexus S, you would type:</p> +<pre>./config.sh nexus-s +</pre> +<div class="note"> + <strong>Note:</strong> If you get an error message like <code>fatal: manifest 'nexus-s.xml' not available</code>, chances are that you simply have to specify the branch you want to use. See <a href="#Building_a_branch">Building a branch</a> for details.</div> +<div class="note"> + <strong>Note</strong>: If the config step fails with an error message like <code>error: manifest required for this command -- please run init</code>, then changes are that the manifest file for the repo (located at <code>B2G/.repo/manifest.xml</code>) wasn't created successfully. You should try running <code>config.sh</code> again. If you are doing this for a new device you could add it to <code>config.sh</code> and then hand it your local manifest file like so:<br> + <code>./config.sh <device> -m path/to/manifest.</code></div> +<p>Near the start of the configuration you might need to set the option for color usage, then after this the process continues. You can just select 'y' here, as you probably want a color build.</p> +<h3 id="Configuring_a_build_using_a_system_backup">Configuring a build using a system backup</h3> +<p>If your phone no longer has Android on it, and your B2G tree doesn't have the binary blobs in it, but you wisely <a class="vt-p" href="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_build_prerequisites#Backup_the_phone_system_partition" title="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_build_prerequisites#Backup_the_phone_system_partition">made a backup of the <code>/system</code> partition</a>, you can perform the build on the system backup like this:</p> +<pre>ANDROIDFS_DIR=<absolute path to parent dir of system dir> ./config.sh <target> +</pre> +<p>The build system will default to looking in someplace like <code>backup-inari/system</code> (depending on the device configuration); if you place the files in the expected place you won't need to specify the directory.</p> +<p>Note that if your phone always had Firefox OS on it to begin with and never ran Android, it's still fine to pull the <code>/system</code> partition per the above directions — this will give you the right files.</p> +<h3 id="Configuring_the_B2G_build_for_an_emulator">Configuring the B2G build for an emulator</h3> +<p>If you want to build an emulator rather than on a real phone, you can specify <code>emulator</code>* to get an ARM device emulator, or <code>emulator-x86*</code> to build an x86 emulator. The latter is faster but not as accurate a representation of an actual mobile device and not as well supported; using it is not advised.</p> +<p>So, to build the ARM Jellybean emulator, for example, you would use the following command:</p> +<pre>./config.sh emulator-jb +</pre> +<p>Near the start of the configuration you might need to set the option for color usage, then after this the process continues. You can just select 'y' here, as you probabaly want a color build.</p> +<p>By this point you should be ready to <a class="vt-p" href="/en-US/docs/Mozilla/Firefox_OS/Building" title="Mozilla/Firefox_OS/Building">start the build</a>, unless you need any of the more advanced information detailed below.</p> +<p>Beware that building for the emulator may fail on 64-bit Linux.</p> +<div class="note"> + <strong>Note:</strong> Developers on Mac OS X 10.9 or above have to switch to emulator-jb or emulator-kk instead, because AOSP ICS based emulator can't be built on Mac OS X 10.9. See <a class="vt-p" href="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_build_prerequisites#Requirements_for_Mac_OS_X" title="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_build_prerequisites#Requirements_for_Mac_OS_X">Requirements for Mac OS X</a> for further information.</div> +<h2 id="Building_against_a_custom_Gecko">Building against a custom Gecko</h2> +<p>There may be times that you want or need to build Boot to Gecko based on a different version of Gecko than the one that's used by default (as specified in the manifest). You can do so by editing the file <code>.userconfig</code>. For example, if you want to build against mozilla-central:</p> +<pre>export GECKO_PATH=/path/to/mozilla-central +export GECKO_OBJDIR=/path/to/mozilla-central/objdir-gonk +</pre> +<div class="note"> + <p><strong>Note</strong>: if building against a custom Gecko in Mac OS X, the mozilla-central directory must be in a case sensitive file system.<br> + </p> +</div> +<p id="Building_a_branch">Note that you can do this either before you pull the repository (i.e. before the <code>config.sh</code> step above) or at any later point. You can also keep multiple builds (with debugging on or not, etc) by having multiple userconfig files (with different settings--each needs a different OBJDIR, of course) and making .userconfig a symlink that points to whichever config you want to build at the moment.</p> +<p>For more information, read <a class="vt-p" href="https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Customization_with_the_.userconfig_file#Changing_the_Gecko_source_tree" title="https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Customization_with_the_.userconfig_file#Changing_the_Gecko_source_tree">Changing the Gecko source tree</a>.</p> +<h2 id="Building_a_branch_2">Building a branch</h2> +<p>If you want to build for a branch other than the default branch (<strong>note: the default branch may not be "master"!</strong>), you will need to prefix your call to config.sh with a branch name, like this:</p> +<pre>BRANCH=branch-name ./config.sh <device></pre> +<p>The branch names are pretty logical, and largely follow the names of the products/versions, so <code>v1-train</code>, <code>v1.0.0</code>, <code>v1.0.1</code>, <code>v1.1</code>, <code>v1.1.0hd</code>, <code>v1.2, v1.3, v1.4, v2.0</code> and so on into the future. As an example, to build B2G Firefox 1.2, for the Arm emulator, you'd enter</p> +<pre>BRANCH=v1.2 ./config.sh emulator</pre> +<p>If you have run config.sh already, you can see the names of the branches, by going to <code>B2G/.repo/manifests</code> and doing "<code>git branch -a</code>" (this isn't populated unti then.) <strong>The branch name is given as the final token on the line, e.g. "<code>v1-train</code>" or "<code>master</code>"</strong>:</p> +<pre> remotes/origin/master + remotes/origin/v1-train + remotes/origin/v1.0.0 + remotes/origin/v1.0.1</pre> +<p>See <a class="vt-p" href="/en-US/docs/Mozilla/Firefox_OS/Customization_with_the_.userconfig_file" title="Mozilla/Firefox_OS/Customization_with_the_.userconfig_file">Customization with the .userconfig file</a> for additional customizations you can do.</p> +<h2 id="Copying_your_B2G_tree_to_a_new_machine">Copying your B2G tree to a new machine</h2> +<p>If you've previously set up the B2G tree and then gotten a new computer (lucky you!), you'll find your life will be much easier if you simply migrate your entire B2G tree from your old computer to your new one, rather than setting the whole thing up again. To do that, mount your old computer's drive onto your new computer, then do this:</p> +<pre>rsync -a <em>source</em>/ <em>dest</em>/ +</pre> +<p>Where <code>source</code> is the full path (including the trailing slash) of the source tree, and <code>dest</code> is where you want to put it (the trailing slash is also important!).</p> +<div class="note"> + <strong>Note:</strong> If you copy the files from a computer with another platform ensure to run '<em>./build.sh clean'</em> before you start the build process. If you don't do this you might encounter compilation issues.</div> +<p>If you do this, you can skip all of the rest of this article and move right on to <a class="vt-p" href="/en-US/docs/Mozilla/Firefox_OS/Building" title="Mozilla/Firefox_OS/Building">building</a>.</p> +<h2 id="Updating_your_B2G_tree">Updating your B2G tree</h2> +<p>When the repository is updated to a newer version of B2G, you'll want to update your B2G tree. To do this, you can run the following commands:</p> +<pre>git fetch origin +git checkout origin/master</pre> +<p>You can check that these worked correctly by running:</p> +<pre>git show HEAD</pre> +<p>and checking that the commit shown matches the latest commit shown at: <a class="vt-p" href="https://github.com/mozilla-b2g/B2G/commits/master" title="https://github.com/mozilla-b2g/B2G/commits/master">https://github.com/mozilla-b2g/B2G/commits/master</a></p> +<h2 id="On_to_the_next_step">On to the next step</h2> +<p>At this point, you should be ready for <a href="/en-US/Firefox_OS/Building">Building Firefox OS [en-US]</a>.</p> diff --git a/files/pl/archive/b2g_os/simulator/index.html b/files/pl/archive/b2g_os/simulator/index.html new file mode 100644 index 0000000000..f9ac33f6e9 --- /dev/null +++ b/files/pl/archive/b2g_os/simulator/index.html @@ -0,0 +1,47 @@ +--- +title: Symulator Firefox OS +slug: Archive/B2G_OS/Simulator +translation_of: Archive/B2G_OS/Simulator +--- +<div class="note"> + <p>Dodatek Symulator Firefox OS składa się z dwóch części:</p> + <p> </p> + <ul> + <li><strong>Symulator</strong>: zawiera <a href="/en-US/docs/Mozilla/Firefox_OS/Using_the_B2G_desktop_client" title="/en-US/docs/Mozilla/Firefox_OS/Using_the_B2G_desktop_client">desktopową wersję klienta Firefox OS</a>, który jest wyższą warstwą <a href="/en-US/docs/Mozilla/Firefox_OS" title="/en-US/docs/Mozilla/Firefox_OS">Firefox OS</a> działającym na twoim pulpicie. Symulator zawiera dodatkowo kilka <a href="#Simulator-toolbar" title="#Simulator-toolbar">dodatkowych funkcji</a> które nie są w standardzie desktopowych wydań Firefox OS</li> + <li><strong>Dashboard</strong>: narzędzie przeglądarki Firefox umożliwiające uruchomienie i zatrzymanie symulatora oraz instalację, deinstalację i debugowanie aplikacji działających symulatora. Dashboard ponadto umożliwi Ci instalację aplikacji na prawdziwym urządzeniu i sprawdzenie manifestów w poszukiwaniu problemów.</li> + </ul> + <p>Teraz te dwie części zostały połączone: funkcje Dashboard są zaimplementowane przez <a href="/en-US/Firefox_OS/Using_the_App_Manager">Menedżer Aplikacji (App Manager)</a> Firefox OS, wbudowanego w Firefoxie. The Simulator add-on now only includes the Simulator part.</p> +</div> +<p>Dodatek Symulator Firefox OS umożliwia Ci testowanie i debugowanie <a href="/en-US/docs/Apps" title="/en-US/docs/Apps">aplikacji Firefox OS</a> na komputerze. Cykl kodowanie-testowanie-debugowanie jest znaczenie szybsze na symulatorze w porównaniu z rzeczywistym urządzeniem, oczywiście nie potrzemujesz urządzenia aby go używać. Symulator jest <a href="/en-US/docs/Mozilla/Firefox_OS/Using_the_B2G_desktop_client" title="/en-US/docs/Mozilla/Firefox_OS/Using_the_B2G_desktop_client">desktopową wersją klienta Firefox OS</a>, który jest wyższą warstwą <a href="/en-US/docs/Mozilla/Firefox_OS" title="/en-US/docs/Mozilla/Firefox_OS">Firefox OS</a> działającym na twoim pulpicie.</p> +<p>Włączasz i wyłączasz symulator i dołączasz narzędzia deweloperskie używając <a href="/en-US/Firefox_OS/Using_the_App_Manager">Menedżera Aplikacji (App Manager)</a>, wbudowanego w Firefox.</p> +<h2 id="Limity_symulatora">Limity symulatora</h2> +<p>Pamiętaj, że symulacja Firefox OS nie jest idealna.</p> +<h3 id="Limity_sprzętowe">Limity sprzętowe</h3> +<p>Symulator nie symuluje limitów sprzętowych takich jak dostępna pamięć RAM lub prędkość procesora.</p> +<h3 id="Kodeki_audiowideo">Kodeki audio/wideo</h3> +<p>Poniższe kodeki wymagają sprzętowego dekodowania i nie są wspierane:</p> +<ul> + <li>MP3</li> + <li>AAC</li> + <li>H.264 (MP4)</li> + <li>WebM</li> +</ul> +<p>To znaczy, że symulator nie potrafi przetestować odtwarzania dźwięku i wideo między innymi na witrynach internetowych.</p> +<h3 id="Niewspierane_API"><a name="Unsupported-APIs">Niewspierane API</a></h3> +<p>Pewne API które normalnie działają na urządzeniu nie zadziałają w symulatorze ze względu na wspierany sprzęt niedostępny na komputerze. Zaimplementowaliśmy symulacje dla kilku API takie jak geolokacja (oczekujemy, że dodamy więcej w przyszłych wydaniach symulatora).</p> +<p>W obecnym momencie poniższe API nie są wspierane. Używanie ich może spowodować otrzymanie błędów lub niewłaściwych wyników:</p> +<ul> + <li><a href="/en-US/WebAPI/WebTelephony" title="/en-US/WebAPI/WebTelephony">Telephony</a></li> + <li><a href="/en-US/docs/WebAPI/WebSMS" title="/en-US/docs/WebAPI/WebSMS">WebSMS</a></li> + <li><a href="/en-US/docs/WebAPI/WebBluetooth" title="/en-US/docs/WebAPI/WebBluetooth">WebBluetooth</a></li> + <li><a href="/en-US/docs/WebAPI/Using_Light_Events" title="/en-US/docs/WebAPI/Using_Light_Events">Ambient Light</a></li> + <li><a href="/en-US/docs/WebAPI/Proximity" title="/en-US/docs/WebAPI/Proximity">Proximity</a></li> + <li><a href="/en-US/docs/WebAPI/Network_Information" title="/en-US/docs/WebAPI/Network_Information">Network Information</a></li> + <li><a href="/en-US/docs/Online_and_offline_events" title="/en-US/docs/Online_and_offline_events">navigator.onLine and offline events</a></li> + <li><a href="/en-US/docs/WebAPI/Vibration" title="/en-US/docs/WebAPI/Vibration">Vibration</a></li> +</ul> +<h2 id="Getting_help"><a name="Simulator-help"></a>Getting help</h2> +<p>The Firefox OS Simulator is still at an early stage of development, and isn't yet as reliable and complete as we'd like it to be.</p> +<p>If you find any bugs, please <a href="https://github.com/mozilla/r2d2b2g/issues?state=open">file them on GitHub</a>. If you have a question, try asking us on the <a href="https://lists.mozilla.org/listinfo/dev-developer-tools">dev-developer-tools mailing list</a> or on <a href="irc://irc.mozilla.org/#devtools">#devtools on irc.mozilla.org</a>.</p> +<h3 id="How_to_enable_verbose_logging"><a name="Simulator-verbose-logging"></a>How to enable verbose logging</h3> +<p>Use about:config to create the preference <a href="mailto:extensions.r2d2b2g@mozilla.org.sdk.console.logLevel">extensions.r2d2b2g@mozilla.org.sdk.console.logLevel</a>, set it to the integer value 0, and disable/reenable the addon. Additional messages about the Simulator's operation will appear in the Error Console (or Browser Console in newer versions of Firefox).</p> diff --git a/files/pl/archive/b2g_os/using_the_app_manager/index.html b/files/pl/archive/b2g_os/using_the_app_manager/index.html new file mode 100644 index 0000000000..2480e1f3ac --- /dev/null +++ b/files/pl/archive/b2g_os/using_the_app_manager/index.html @@ -0,0 +1,274 @@ +--- +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 tool for Firefox Desktop which provides a number of useful tools to help developers test, deploy and debug HTML5 web apps on Firefox OS phones & Simulator, directly from Firefox browser.</p> + +<p>App Manager is available for Firefox OS 1.2 or later, lower versions are supported in <a href="/en-US/docs/Tools/Firefox_OS_1.1_Simulator">Firefox OS 1.1 Simulator</a>. The App Manager is being replaced by the <a href="/en-US/docs/Tools/WebIDE">WebIDE</a>, starting from Firefox 33. The WebIDE provides all the features of the App Manager also features an editing environment to create and develop Firefox OS apps.</p> +</div> + +<p>{{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 > Phone lock > <code>Lock Screen</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_OS_1.2_required">Firefox OS 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 left-most 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.3, Firefox OS 1.4, etc.)</li> + <li>"Cancel": the right hand button cancels the connection.</li> +</ul> + +<div class="note"> +<p><strong>Note</strong>: The Firefox OS 1.5 Simulator has been removed, as 1.5 was changed to 2.0. If you have the Firefox OS 1.5 Simulator installed, it won't automatically update to 2.0, so you should uninstall 1.5 and install 2.0 instead. The Firefox OS 2.0 simulator will then automatically update.</p> +</div> + +<div class="note"> +<p><strong>Note</strong>: The Firefox OS 1.2 Simulator has been removed, as no phones are likely to be released with version 1.2 installed — this version is therefore of limited value, and it makes more sense to spend your time debugging on other versions.</p> +</div> + +<h2 id="Running_custom_builds_in_the_App_Manager">Running custom builds in the App Manager</h2> + +<p>Note that you can run custom B2G Desktop and Gaia/Gecko 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 instructions on how to do this.</p> + +<h2 id="Apps_panel_2"><a name="Apps_panel">Apps panel</a></h2> + +<p>Now that 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>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="Troubleshooting_2"><a name="Troubleshooting">Troubleshooting</a></h2> + +<p id="My_device_is_not_recognized">If the device is not recognized:</p> + +<ul> + <li>If clicking the button corresponding to your Firefox OS phone doesn't do anything, make sure you haven't connected an Android phone at the same time as the Firefox OS phone to your computer.</li> + <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> + <li>If the command "adb devices" shows no entries even though the phone is connected and unlocked, you may have to <a href="http://blog.fh-kaernten.at/wehr/?p=1182">edit adb_usb.ini</a>.</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/pl/archive/index.html b/files/pl/archive/index.html new file mode 100644 index 0000000000..4f4a70c023 --- /dev/null +++ b/files/pl/archive/index.html @@ -0,0 +1,21 @@ +--- +title: Archive of obsolete content +slug: Archive +tags: + - NeedsTranslation + - TopicStub +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("/en-US/docs/Archive", 2, 0, 1)}}</p> diff --git a/files/pl/archive/marketplace/index.html b/files/pl/archive/marketplace/index.html new file mode 100644 index 0000000000..f4d14c03a2 --- /dev/null +++ b/files/pl/archive/marketplace/index.html @@ -0,0 +1,57 @@ +--- +title: Marketplace +slug: Archive/Marketplace +tags: + - Archive + - Landing + - Marketplace + - NeedsTranslation + - TopicStub +translation_of: Archive/Marketplace +--- +<p class="summary">Many aspects of the Firefox Marketplace will soon be removed, with more following as the different services Marketplace offers are End-of-lifed. Related documentation will be moved here as it is removed. See the <a href="https://wiki.mozilla.org/Marketplace/FutureofMarketplaceFAQ">Future of Marketplace FAQ</a> for more answers.</p> + +<div class="row topicpage-table"> +<div class="section"> +<dl> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Marketplace/API">Marketplace API reference</a></dt> + <dd class="landingPageList">Marketplace-related APIs have been removed, therefore the information covering them has been archived.</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Marketplace/Monetization">Monetization</a></dt> + <dd class="landingPageList">Monetization topics that have now been archived due to relevant functionality being removed from the Firefox Marketplace.</dd> +</dl> + +<dl> +</dl> +</div> + +<div class="section"> +<dl> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Marketplace/Options">Options</a></dt> + <dd class="landingPageList">Publishing options that are no longer available, hence the information being archived.</dd> + <dt class="landingPageList"><a href="/en-US/docs/Archive/Marketplace/Publishing">Publishing</a></dt> + <dd class="landingPageList">Publishing details that are no longer available, hence the information being archived.</dd> +</dl> +</div> +</div> + +<div class="hidden"> +<h2 id="Subnav">Subnav</h2> + +<section id="Quick_Links"> +<ol> + <li><strong><a href="/en-US/docs/Archive/Marketplace">Marketplace</a></strong></li> + <li class="toggle"> + <details><summary><a href="/en-US/docs/Archive/Marketplace/API">Marketplace APIs</a></summary>{{ListSubpages("/en-US/docs/Archive/Marketplace/API", 1, 0, 1)}}</details> + </li> + <li class="toggle"> + <details><summary><a href="/en-US/docs/Archive/Marketplace/Monetization">Monetization</a></summary>{{ListSubpages("/en-US/docs/Archive/Marketplace/Monetization", 1, 0, 1)}}</details> + </li> + <li class="toggle"> + <details><summary><a href="/en-US/docs/Archive/Marketplace/Options">Options</a></summary>{{ListSubpages("/en-US/docs/Archive/Marketplace/Options", 1, 0, 1)}}</details> + </li> + <li class="toggle"> + <details><summary><a href="/en-US/docs/Archive/Marketplace/Publishing">Publishing</a></summary>{{ListSubpages("/en-US/docs/Archive/Marketplace/Publishing", 1, 0, 1)}}</details> + </li> +</ol> +</section> +</div> diff --git a/files/pl/archive/meta_docs/index.html b/files/pl/archive/meta_docs/index.html new file mode 100644 index 0000000000..52de2c8447 --- /dev/null +++ b/files/pl/archive/meta_docs/index.html @@ -0,0 +1,12 @@ +--- +title: MDN "meta-documentation" archive +slug: Archive/Meta_docs +tags: + - Archive + - MDN + - NeedsTranslation + - TopicStub +translation_of: Archive/Meta_docs +--- +<p>Here you'll find archived "meta-documentation"; that is, documentation about how to write documentation on MDN. The articles here are obsolete and should no longer be referenced; we are retaining them here for reference while we migrate some content to new places, but very little of this is useful.</p> +<p>{{LandingPageListSubpages}}</p> diff --git a/files/pl/archive/meta_docs/mdn_page_layout_guide/index.html b/files/pl/archive/meta_docs/mdn_page_layout_guide/index.html new file mode 100644 index 0000000000..e6ca288977 --- /dev/null +++ b/files/pl/archive/meta_docs/mdn_page_layout_guide/index.html @@ -0,0 +1,8 @@ +--- +title: MDN page layout guide +slug: Archive/Meta_docs/MDN_page_layout_guide +translation_of: Archive/Meta_docs/MDN_page_layout_guide +--- +<p><span class="seoSummary"><font><font>Przewodniki te uzupełniają </font></font><a href="/en-US/docs/MDN/Contribute/Content/Style_guide"><font><font>podręcznik stylu MDN</font></font></a><font><font> z określonych układów dla różnych typów stron o MDN. </font><font>To pomaga autorów stworzyć nową treść, która jest strukturalnie zgodne z resztą MDN.</font></font></span></p> + +<p><font><font>{{LandingPageListSubpages}}</font></font></p> diff --git a/files/pl/archive/misc_top_level/index.html b/files/pl/archive/misc_top_level/index.html new file mode 100644 index 0000000000..0959a3b10b --- /dev/null +++ b/files/pl/archive/misc_top_level/index.html @@ -0,0 +1,8 @@ +--- +title: Misc top level +slug: Archive/Misc_top_level +translation_of: Archive/Misc_top_level +--- +<p>In progress. These pages were moved from the top level of MDN in a spate of furious reorganization.</p> + +<p>{{SubpagesWithSummaries}}</p> diff --git a/files/pl/archive/misc_top_level/obrazki,_tabele_i_tajemnicze_dziury/index.html b/files/pl/archive/misc_top_level/obrazki,_tabele_i_tajemnicze_dziury/index.html new file mode 100644 index 0000000000..29720aeeac --- /dev/null +++ b/files/pl/archive/misc_top_level/obrazki,_tabele_i_tajemnicze_dziury/index.html @@ -0,0 +1,114 @@ +--- +title: 'Obrazki, tabele i tajemnicze dziury' +slug: 'Archive/Misc_top_level/Obrazki,_tabele_i_tajemnicze_dziury' +tags: + - CSS + - Wszystkie_kategorie +translation_of: 'Archive/Misc_top_level/Images,_Tables,_and_Mysterious_Gaps' +--- +<p> +</p><p>Niezależnie, kiedy zacząłeś(aś) tworzyć strony WWW, jest prawie pewne, że masz jedną lub dwie strony bazujące na klasycznym paradygmacie "poskręcanych tabel i mnóstwa obrazków". Za każdym razem, gdy chciałeś(aś) ułożyć logo, tak aby pasowało do wyglądu strony, lub kiedy używałeś(aś) ton jednopikselowych rozpychających GIF-ów, założenia (i zagrożenia) pozostawały te same. Wtedy, dawno temu, te założenia działały, ponieważ przeglądarki zazwyczaj ustawiały rozmiary komórek tabeli na szerokość i wysokość obrazka, który znajdował się wewnątrz. +</p><p>Przenieśmy się teraz do roku 2001, kiedy to zaczęły powstawać przeglądarki internetowe zgodne ze standardami, które układały strony WWW używając do tego HTML-a i CSS, zamiast swoich własnych, ukrytych algorytmów. Dzięki mrocznym zakątkom specyfikacji CSS, każdy układ bazujący na malutkich obrazkach i komórkach tabeli stawał się potencjalną katastrofą wizualną. Jedyne, czego trzeba było, to nowoczesna przeglądarka i poprawny DOCTYPE... buuum! +</p> +<h3 id="Sk.C5.82adniki" name="Sk.C5.82adniki"> Składniki </h3> +<p>Przyjrzyjmy się powodom tych problemów. Zacznijmy od prostego przykładu, pokazanego na Przykładzie 1: jednokomórkowa tabela z obrazkiem w środku. +</p><p><img align="none" alt="Przykład 1"> +</p><p>Oczywiście większość stron jest trochę bardziej skomplikowana, ale w tym wypadku nie potrzebujemy nic więcej. Jeden obrazek, jedna komórka-- to wszystko. Nie ma nic złego w powyższym przykładzie. Nie miało być, ponieważ to przykład, jak przeglądarki zachowują się tradycyjnie. +</p><p>Teraz zobaczmy, jak wygląda taka prosta tabela w nowoczesnej przeglądarce, kiedy strona posiada DOCTYPE trybu standardów. +</p><p><img align="none" alt="Przykład 2"> +</p><p>Zwróć uwagę na przestrzeń dodaną pod obrazkiem w Przykładzie 2. Składnia tabeli i komórki pozostała niezmieniona-- zmienił się tylko sposób wyświetlania. Zamiast "SkurczSięIOpakuj" ten obrazek, przeglądarka opakowuje komórkę wokół linii, w której znajduje się obrazek. +Obrazek znajduje się w jakiejś linii, ponieważ obrazki należą, domyślnie, do zawartości liniowej (inline). Stąd różnica. +</p> +<h3 id="Jak_tworzona_jest_zawarto.C5.9B.C4.87_liniowa" name="Jak_tworzona_jest_zawarto.C5.9B.C4.87_liniowa"> Jak tworzona jest zawartość liniowa </h3> +<p>Aby zrozumieć, co się właśnie stało, musisz spojrzeć na konstrukcję bloku liniowego, rozmieszczenie obrazków w bloku liniowym i położenie bloku liniowego w komórce tabeli. Najpierw spójrzmy na blok liniowy zawierający tekst, pokazany na Przykładzie 3. +</p><p><img align="none" alt="Przykład 3"> +</p><p>Najważniejszym elementem Przykładu 3 jest bazowa linia pisma (pokazana jako niebieska linia) i jej położenie w bloku liniowym. Dokładne położenie bazowej linii pisma zależy od domyślnego fontu dla danego bloku liniowego (pokazanego jako czerwony prostokąt), która jest określona przez wartość font-family dla elementu zawierającego blok liniowy. Autor nie ma możliwości bezpośredniej zmiany położenia bazowej linii pisma. Przestrzeń pod bazową linią pisma jest określana jako "descender space", ponieważ tutaj właśnie są rysowane dolne fragmenty liter takich jak "j", "y" i "q". Przykład 4 pokazuje, co się stanie, kiedy dodamy do tego obrazek. +</p><p><img align="none" alt="Przykład 4"> +</p><p>Zwróć uwagę, gdzie domyślnie znalazł się obrazek: jego dolna krawędź jest wyrównana z linią bazową bloku liniowego. To położenie może być zmienione poprzez własność vertical-align-- powiemy o tym trochę więcej-- ale prawie nikt nigdy nie zmienia domyślnej wartości. Usuńmy tekst i zostawmy tylko obrazek, jak w Przykładzie 5. +</p><p><img align="none" alt="Przykład 5"> +</p><p>Mamy zatem obrazek ułożony na linii bazowej bloku liniowego, zawierającego tylko obrazek. Teraz rozważmy, co się stanie, kiedy umieścimy tę linię w komórce tabeli (Przykład 6). +</p><p><img align="none" alt="Przykład 6"> +</p><p>No i stało się - tworzą się spacje tam, gdzie nikt by się ich nie spodziewał! Jeszcze gorzej wygląda to przy mniejszych rysunkach - tak jak te, które są wielkości piksela (Przykład 7). +</p><p><img align="none" alt="Przykład 7"> +</p><p>Nagle okazuje się, że jest mnóstwo pustych przestrzeni w naszej tabeli. To wystarczy, żeby doprowadzić designera stron do szału. +</p> +<h3 id="Mo.C5.BCe_poprawk.C4.99.3F" name="Mo.C5.BCe_poprawk.C4.99.3F"> Może poprawkę? </h3> +<p>Istnieje tylko jedno oczywiste rozwiązanie: zaprzestać tworzenia stron, które opierają się na tabelach i jednopikselowych obrazkach. Jednak dla wielu autorów nie jest to praktyczne, a na pewno nie pomaga w naprawie starszych projektów, które nagle rozpadają się w nowoczesnych przeglądarkach. Jest jeszcze inny sposób naprawy: upewnić się, że dokument nie zostanie rozpoznany jako wyświetlany w trybie standardów. +</p><p>Możesz to zrobić używając deklaracji DOCTYPE, która włączy jeden z dwóch trybów: <a class="external" href="http://www.mozilla.org/docs/web-developer/quirks/">"wstecznej zgodności"</a> lub <a href="pl/Gecko's_Almost_Standards_Mode">"almost standards"</a>, lub nie umieszczając wcale deklaracji DOCTYPE w twoim dokumencie. Brak deklaracji DOCTYPE uniemożliwi walidację, i dlatego nie jest zalecany. Dla autorów, którzy pracują z odziedziczonymi dokumentami, tryb "wstecznej zgodności" deklaracji DOCTYPE jest najlepszym wyborem. W przypadku, kiedy autor tworzy nowy dokument lub próbuje przekształcić projekt tak, aby bazował na standardach na tyle, na ile jest to tylko możliwe, wtedy wybór trybu "almost standards" będzie prawdopodobnie lepszym rozwiązaniem. +</p><p>Oczywiście, dokumenty zadeklarowane jako XHTML Strict lub HTML Strict wywołają wyświetlanie w trybie "standardów", zatem zamierzamy przedstawić dwa podstawowe sposoby zajęcia się tym problemem w dokumentach w trybie zgodności i kilka sposobów wywoływania tych "poprawek". +</p> +<h4 id="Ustawianie_obrazk.C3.B3w_jako_blok.C3.B3w" name="Ustawianie_obrazk.C3.B3w_jako_blok.C3.B3w"> Ustawianie obrazków jako bloków </h4> +<p>Pierwszym wyborem, i jedynym, który będzie działał w większości projektów wykorzystujących intensywnie grafikę, jest przekształcenie obrazka z elementu liniowego na element blokowy. Zrobienie tego sprawia, że nie jest generowany dłużej blok liniowy i tym samym problem znika, gwarantując, że obrazek jest jedyną rzeczą, która zajmuje tę komórkę tabeli. W najprostszym przypadku możemy dodać styl taki jak ten: +</p> +<pre> td img {display: block;}</pre> +<p>Rozważmy tę regułę zastosowaną do następujących znaczników: +</p> +<pre><table cellspacing="0" cellpadding="0" border="0" width="500"> +<tr><td><img src="nav1.gif"><img src="nav2.gif"><img src="nav3.gif"><img +src="nav4.gif"><img src="nav5.gif"></td></tr> +<tr><td style="background: red;"> +<img src="smallred.gif" height="1" width="1"></td></tr> +<tr><td> +<p style="margin: 0.5em;">Ten tekst jest jeszcze jedną komórką tabeli. W tekście jest ikona + <img src="icon2.gif"> + wskazująca link do innej strony. Jest to bardzo życiowe. Lorem +ipsum, dolor sit amet...</p></tr></table></pre> +<p>Jak widzimy w Przykładzie 8 działa to dobrze w niektórych przypadkach, ale nie najlepiej w innych. +</p><p><img align="none" alt="Przykład 8"> +</p><p>Cienka czerwona linia pokazuje, że jednopikselowy rozpychający GIF sprawia teraz, iż komórka ma wysokość jednego piksela, tak jak projektant zamierzył. Niestety, teraz wszystkie przyciski w górnej komórce są elementami blokowymi i ostatecznie układają się w stos jeden nad drugim zamiast obok siebie. +</p><p>Jednym z możliwych rozwiązań jest dodanie klasy do każdego obrazka, który powinien być elementem blokowym, i napisanie reguły dopasowującej. +</p> +<pre>td img.decoration {display: block;} + +<td><img src="reddot.gif" class="decoration"></td></pre> +<p>Zależnie od projektu może to wprowadzić wiele klas dodanych dla jednego prostego efektu. Jest to szczególnie widoczne, jeśli mamy wiele jednopikselowych komórek przeznaczonych do tworzenia ładnych linii układających się w stos lub czegoś podobnego. Jeśli samodzielnie dodajesz znaczniki możesz nadać klasy wierszom tabeli zamiast obrazkom. Zatem możesz mieć: +</p> +<pre>tr.decoration img {display: block;}</pre> +<p>...razem z następującą zmianą w znacznikach: +</p> +<pre><tr class="decoration"><td style="background: red;"> +<img src="smallred.gif" height="1" width="1"> +</td></tr></pre> +<p>Rezultatem tego jest przekształcenie w element blokowy jedynie GIF-a tworzącego odstępy, zatem pozostałe obrazki zostają w spokoju. Prowadzi to do rezultatu pokazanego w Przykładzie 9. +</p><p><img align="none" alt="Przykład 9"> +</p><p>Ewentualnie możesz nadać klasę komórkom tabeli zamiast wierszom, jeśli to jest dla ciebie lepszym rozwiązaniem. W każdym z tych przypadków przekształcenie obrazków na elementy blokowe może przynieść niezamierzony efekt, jeśli komórki twojej tabeli zawierają więcej niż jeden pojedynczy obrazek w każdej, jak w Przykładzie 8. +</p><p>Oczywiście, dopóki mamy jednopikselową komórkę tworzącą odstęp w Przykładzie 9, jest tam jeszcze niechciana przestrzeń pod spodem górnych przycisków nawigacyjnych. Uwolnienie się od tego odstępu może być tak proste jak umieszczenie każdego obrazka we własnej komórce i uczynienie go elementem blokowym, pozostawmy jednak je wszystkie razem w jednej komórce, by pokazać jeszcze inne podejście. +</p> +<h4 id="U.C5.BCywanie_wyr.C3.B3wnania_pionowego" name="U.C5.BCywanie_wyr.C3.B3wnania_pionowego"> Używanie wyrównania pionowego </h4> +<p>Innym głównym rozwiązaniem jest pozostawienie obrazków jako elementów liniowych i zmiana pionowego wyrównania obrazka w stosunku do linii bloku. Dla przykładu możesz wypróbować następujące rozwiązanie: +</p> +<pre>td img {vertical-align: bottom;}</pre> +<p>Spowoduje to, że dolna krawędź obrazka będzie wyrównana względem dolnej linii bloku zamiast linii bazowej. Jak możemy zobaczyć na Przykładzie 10, przynosi to zamierzony efekt: przestrzeń pod naszymi obrazkami w pasku nawigacyjnym znika. Jednak dekoracyjna komórka jest nadal zbyt wysoka i inne obrazki nie są wyrównane względem tekstu wokół nich. +</p><p><img align="none" alt="Przykład 10"> +</p><p>Jeszcze raz możemy nadać klasę obrazkom, komórkom lub wierszom w celu precyzyjnego ustawienia efektu. Jednak style pokazane powyżej nie przezwyciężą problemu jednopikselowego obrazka, ponieważ linia bloku otaczająca go będzie miała wysokość czcionki w komórce tabeli i dlatego nie skurczy się. Obrazek przeniesie się na dół komórki, ale komórka nie skurczy się do rozmiarów obrazka. Dodatkowo, każdy inny obrazek, który jest krótszy niż wysokość linii bloku będzie nadal miał pustą przestrzeń wokół siebie -- jak to się działo z czerwoną komórką tworzącą odstęp. Jednopikselowy obrazek w komórce jest teraz wyrównany względem dołu komórki, ale linia bloku powraca i ma rozmiar normalnego tekstu. +</p><p>Zobacz Przykład 11, gdzie rozmiar czcionki dokumentu został podniesiony do większej wartości. Obrazki paska nawigacyjnego mają teraz pustą przestrzeń pojawiającą się nad nimi, a czerwona przestrzeń stała się większa. +</p><p><img align="none" alt="Przykład 11"> +</p><p>Trudno tego uniknąć, ponieważ obrazki (w tym podejściu) są ciągle elementami liniowymi i dlatego nadal biorą udział w tworzeniu linii bloku. Jeśli ta linia bloku otrzyma wystarczającą wysokość, przestrzeń zacznie pojawiać się wokół obrazków +</p> +<h3 id="Oczekuj.C4.85c_na_rozwi.C4.85zanie" name="Oczekuj.C4.85c_na_rozwi.C4.85zanie"> Oczekując na rozwiązanie </h3> +<p>Dzięki gruntowej implementacji CSS2 w Mozilli problem obrazków liniowych w komórkach tabeli, wymuszających niechcianą przestrzeń, został wzięty pod uwagę przez CSS Working Group. Powstało wiele propozycji rozwiązania tego problemu, lecz jedną z najbardziej obiecujących jest właściwość <a class="external" href="http://www.w3.org/TR/css3-box/#line-box-contain">line-box-contain</a>, którą zaproponowano do włączenia w CSS3. Gdy ta właściwość się przyjmie, wtedy każda przeglądarka wspierająca ją będzie mogła naśladować tradycyjne zachowanie "shrinkwrap" bez ryzyka nieoczekiwanego wyglądu z następującą regułą: +</p> +<pre>td {line-box-contain: font replaced;} /* propozycja do CSS3 */</pre> +<p>Możliwe są inne rozwiązania zawierające się w aktualnym CSS3 Working Drafts, jak <a class="external" href="http://www.w3.org/TR/css3-box/#line-height">line-height-policy</a>. Oczywiście, im szybciej rozwiązanie będzie można znaleźć i zaimplementować, autorzy będą szczęśliwsi. +</p> +<h3 id="Rekomendacje" name="Rekomendacje"> Rekomendacje </h3> +<p>Z powodu braku wsparcia dla CSS3, trudno dostarczyć jasny zestaw kroków dla rozwiązania każdego przykładu tego problemu, ponieważ najlepsze rozwiązanie dla danego dokumentu zależy mocno od jego struktury. Jeśli twój dokument używa tradycyjnych znaczników, upewnij się, że deklaracja DOCTYPE odzwierciedla ten fakt i nie wywołuj trybu standardów. Zabezpieczy to przeglądarki przed użyciem wyświetlania opartego na standardach i w ten sposób wszystkie problemy z układem graficznym zostaną ominięte. Jeśli używasz znaczników w trybie strict lub potrzebujesz z innych powodów wyświetlania w trybie standardów, pamiętaj wtedy o poniższych wskazówkach: +</p> +<ul><li> Każdy pojedynczy obrazek w komórce tabeli (np. jednopikselowy obrazek tworzący przestrzeń) powinien być elementem blokowym +</li><li> Każdy obrazek w komórce tabeli z innym obrazkiem powinien być wyrównany w pionie do dolnej linii bloku +</li><li> Każdy obrazek w komórce tabeli z innym obrazkiem i tekstem powinien mieć odpowiednie wyrównanie w pionie zgodnie z potrzebą. +</li></ul> +<p>Z rozsądnym połączeniem podejść i redukcją trików z jednopikselowymi obrazkami-- które w przeglądarkach obsługujących CSS nie są w żaden sposób niezbędne-- jest całkiem możliwe ominięcie dziwnych efektów w trybie standardów. Najlepszym rozwiązaniem może być zagwarantowanie, że obrazki są zawsze w komórkach same, zatem pozwalają twórcom uczynić je elementami blokowymi, ale, jak zwykle, zależy to od autorskiego projektu. +</p> +<h3 id="Podobne_linki" name="Podobne_linki"> Podobne linki </h3> +<ul><li> <a href="pl/Gecko's_Almost_Standards_Mode">Gecko's Almost Standards Mode</a> +</li><li> <a class="external" href="http://www.mozilla.org/docs/web-developer/quirks/">Mozilla's Quirks Mode</a> +</li></ul> +<div class="originaldocinfo"> +<h3 id="Informacje_o_dokumencie" name="Informacje_o_dokumencie"> Informacje o dokumencie </h3> +<ul><li> Autor(zy): Eric A. Meyer +</li><li> Ostatnia modyfikacja: March 21st, 2003 +</li><li> Copyright © 2001-2003 Netscape. +</li></ul> +</div> +{{ languages( { "en": "en/Images,_Tables,_and_Mysterious_Gaps", "es": "es/Im\u00e1genes,_tablas_y_huecos_misteriosos", "fr": "fr/Images,_tableaux_et_d\u00e9calages_myst\u00e9rieux" } ) }} diff --git a/files/pl/archive/mozilla/drag_and_drop/index.html b/files/pl/archive/mozilla/drag_and_drop/index.html new file mode 100644 index 0000000000..b963b08118 --- /dev/null +++ b/files/pl/archive/mozilla/drag_and_drop/index.html @@ -0,0 +1,142 @@ +--- +title: Drag and Drop +slug: Archive/Mozilla/Drag_and_drop +tags: + - NeedsTranslation + - TopicStub + - XUL +translation_of: Archive/Mozilla/Drag_and_drop +--- +<p>{{ Next("Drag and Drop JavaScript Wrapper") }}</p> +<p>{{ deprecated_header("gecko1.9.1") }}</p> +<div class="warning"> + As of Gecko 1.9.1 (Firefox 3.5), these APIs are officially deprecated <a href="/En/DragDrop/Drag_and_Drop" title="en/DragDrop/Drag and Drop">the newer, simpler, portable API</a> should be used in their place.</div> +<p>This section describes how to implement objects that can be dragged around and dropped onto other objects.</p> +<h3 id="The_Drag_and_Drop_Interface" name="The_Drag_and_Drop_Interface">The Drag and Drop Interface</h3> +<p>Many user interfaces allow one to drag particular objects around within the interface. For example, dragging files to other directories, or dragging an icon to another window to open the document it refers to. Mozilla and <a href="/en/XUL" title="en/XUL">XUL</a> provide a number of events that can handle when the user attempts to drag objects around.</p> +<p>A user can start dragging by holding down the mouse button and moving the mouse. The drag stops when the user releases the mouse. Event handlers are called when the user starts and ends dragging, and at various points in-between.</p> +<p>Mozilla implements dragging by using a drag session. When a user requests to drag something that can be dragged, a drag session should be started. The drag session handles updating the mouse cursor and where the object should be dropped. If something cannot be dragged, it should not start a drag session. Because the user generally has only one mouse, only one drag session is in use at a time.</p> +<p>Note that drag sessions can be created from within Mozilla itself or from other applications. Mozilla will translate the data being dragged as needed.</p> +<p>The list below describes the event handlers that can be called, which may be placed on any element. You only need to put values for the handlers where you need to do something when the event occurs.</p> +<dl> + <dt> + ondrag {{ Fx_minversion_inline(3) }}</dt> + <dd> + Called periodically throughout the drag and drop operation.</dd> + <dt> + ondraggesture </dt> + <dd> + Called when the user starts dragging the element, which normally happens when the user holds down the mouse button and moves the mouse. The script in this handler should set up a drag session.</dd> + <dt> + ondragstart {{ Fx_minversion_inline(3) }} </dt> + <dd> + An alias for <code>ondraggesture</code>; this is the HTML 5 spec name for the event and may be used in HTML or XUL; however, for backward compatibility with older versions of Firefox, you may wish to continue using <code>ondraggesture</code> in XUL.</dd> + <dt> + ondragover </dt> + <dd> + This event handler is called for an element when something is being dragged over top of it. If the object can be dropped on the element, the drag session should be notified.</dd> + <dt> + ondragenter </dt> + <dd> + Called for an element when the mouse pointer first moves over the element while something is being dragged. This might be used to change the appearance of the element to indicate to the user that the object can be dropped on it.</dd> + <dt> + ondragexit </dt> + <dd> + Called for an element when the mouse pointer moves out of an element while something is being dragged. The is also called after a drop is complete so that an element has a chance to remove any highlighting or other indication.</dd> + <dt> + ondragdrop </dt> + <dd> + This event handler is called for an element when something is dropped on the element. At this point, the user has already released the mouse button. The element can simply ignore the event or can handle it some way, such as pasting the dragged object into itself.</dd> + <dt> + ondragend {{ Fx_minversion_inline(3) }} </dt> + <dd> + Called when the drag operation is finished.</dd> +</dl> +<p>There are two ways that drag and drop events can be handled. This first involves using the drag and drop <a href="/en/XPCOM" title="en/XPCOM">XPCOM</a> interfaces directly. The second is to use a <a href="/en/Drag_and_Drop_JavaScript_Wrapper" title="en/Drag_and_Drop_JavaScript_Wrapper">JavaScript wrapper</a> object that handles some of this for you. The code for this wrapper can be found in a file named {{ Source("toolkit/content/nsDragAndDrop.js nsDragAndDrop.js") }} which is contained in the widget-toolkit (or global) package.</p> +<h3 id="XPCOM_Drag_and_Drop_interfaces" name="XPCOM_Drag_and_Drop_interfaces">XPCOM Drag and Drop interfaces</h3> +<p>Two interfaces are used to support drag and drop. The first is a drag service, <a href="/en/XPCOM_Interface_Reference/nsIDragService" title="en/nsIDragService">nsIDragService</a> and the second is the drag session, <a href="/en/XPCOM_Interface_Reference/nsIDragSession" title="en/nsIDragSession">nsIDragSession</a>.</p> +<p>The <a href="/en/XPCOM_Interface_Reference/nsIDragService" title="en/nsIDragService">nsIDragService</a> is responsible for creating drag sessions when a drag starts, and removing the drag session when the drag is complete. The function <code>invokeDragSession</code> should be called to start a drag inside an <code>ondraggesture</code> event handler. Once this function is called, a drag has started.</p> +<p>The function invokeDragSession takes four parameters, as described below:</p> +<pre class="eval">invokeDragSession(element,transferableArray,region,actions) +</pre> +<dl> + <dt> + element </dt> + <dd> + A reference to the element that is being dragged. This can be retrieved by getting the property <code>event.target</code> during the event handler.</dd> + <dt> + transferableArray </dt> + <dd> + An array of <a href="/en/NsITransferable" title="en/NsITransferable">nsITransferable</a> objects, one for each item being dragged. An array is used because you might want to drag several objects at once, such as a set of files.</dd> + <dt> + region </dt> + <dd> + A region used for feedback indication. This should usually be set to null.</dd> + <dt> + actions </dt> + <dd> + The actions that the drag uses. This should be set to one of the following constants, or several added together. The action can be changed during the drag depending on what is being dragged over.</dd> +</dl> +<dl> + <dt> + nsIDragService.DRAGDROP_ACTION_NONE </dt> + <dd> + <dl> + <dt> + Used to indicate that no drag is valid.</dt> + <dt> + nsIDragService.DRAGDROP_ACTION_COPY </dt> + <dd> + The item being dragged should be copied to its dropped location.</dd> + <dt> + nsIDragService.DRAGDROP_ACTION_MOVE </dt> + <dd> + The item being dragged should be moved to its dropped location.</dd> + <dt> + nsIDragService.DRAGDROP_ACTION_LINK </dt> + <dd> + A link (or shortcut or alias) to the item being dragged should be created in the dropped location.</dd> + </dl> + </dd> +</dl> +<p>The interface {{ interface("nsIDragService") }} also provides the function <code>getCurrentSession</code> which can be called from within the drag event handlers to get and modify the state of the drag. The function returns an object that implements {{ interface("nsIDragSession") }}.</p> +<p>The interface <a href="/en/XPCOM_Interface_Reference/nsIDragSession" title="en/nsIDragSession">nsIDragSession</a> is used to get and set properties of the drag that is currently occuring. The following properties and methods are available:</p> +<dl> + <dt> + canDrop </dt> + <dd> + Set this property to <code>true</code> if the element the mouse is currently over can accept the object currently being dragged to be dropped on it. Set the value to <code>false</code> if it doesn't make sense to drop the object on it. This should be changed in the <code>ondragover</code> and <code>ondragenter</code> event handlers.</dd> + <dt> + dragAction </dt> + <dd> + Set to the current action to be performed, which should be one or more of the constants described earlier. This can be used to provide extra feedback to the user.</dd> + <dt> + numDropItems </dt> + <dd> + The number of items being dragged. For example, this will be set to 5 if five bookmarks are being dragged.</dd> + <dt> + getData(transfer,index) </dt> + <dd> + Get the data being dragged. The first argument should be an <a href="/en/NsITransferable" title="en/NsITransferable">nsITransferable</a> object to hold the data. The second argument, <code>index</code>, should be the index of the item to return.</dd> + <dt> + sourceDocument </dt> + <dd> + The document where the drag started.</dd> + <dt> + sourceNode </dt> + <dd> + The <a href="/en/DOM" title="en/DOM">DOM</a> node where the drag started.</dd> + <dt> + isDataFlavorSupported(flavor) </dt> + <dd> + Returns <code>true</code> if the data being dragged contains data of the specified flavor.</dd> +</dl> +<p>{{ Next("Drag and Drop JavaScript Wrapper") }}</p> +<div class="originaldocinfo"> + <h2 id="Original_Document_Information" name="Original_Document_Information">Original Document Information</h2> + <ul> + <li>Author(s): <a class="link-mailto" href="mailto:enndeakin@sympatico.ca">Neil Deakin</a></li> + <li>Original Document:</li> + <li>Copyright Information: Copyright (C) <a class="link-mailto" href="mailto:enndeakin@sympatico.ca">Neil Deakin</a></li> + </ul> +</div> diff --git a/files/pl/archive/mozilla/firefox/index.html b/files/pl/archive/mozilla/firefox/index.html new file mode 100644 index 0000000000..c87802d82f --- /dev/null +++ b/files/pl/archive/mozilla/firefox/index.html @@ -0,0 +1,8 @@ +--- +title: Firefox +slug: Archive/Mozilla/Firefox +translation_of: Archive/Mozilla/Firefox +--- +<p>In progress. Out-of-date information about the Firefox project.</p> + +<p>{{SubpagesWithSummaries}}</p> diff --git a/files/pl/archive/mozilla/firefox/zastosowanie_mikroformatów/index.html b/files/pl/archive/mozilla/firefox/zastosowanie_mikroformatów/index.html new file mode 100644 index 0000000000..15a49af1cc --- /dev/null +++ b/files/pl/archive/mozilla/firefox/zastosowanie_mikroformatów/index.html @@ -0,0 +1,145 @@ +--- +title: Zastosowanie mikroformatów +slug: Archive/Mozilla/Firefox/Zastosowanie_mikroformatów +tags: + - Firefox 3 +translation_of: Archive/Mozilla/Firefox/Using_microformats +--- +<p>{{ Fx_minversion_header(3) }} +{{ Draft() }} +Mikroformaty umożliwiają przekazywanie przez witryny internetowe do przeglądarek danych o określonej strukturze semantycznej. Umożliwia to zaprezentowanie podsumowania informacji na stronie bez wiedzy na temat tego, jak należy przetwarzać sam przekazywany dokument. W Firefoksie 3 zaimplementowano globalny obiekt <code>Microformats</code>, pozwalający na dostęp do mikroformatów. Interfejs API tego obiektu umożliwia łatwe wykrywanie i odczytywanie mikroformatów. +</p> +<h2 id=".C5.81adowanie_interfejsu_API_mikroformat.C3.B3w" name=".C5.81adowanie_interfejsu_API_mikroformat.C3.B3w">Ładowanie interfejsu API mikroformatów</h2> +<p>Obiekt <code>Microformats</code> można utworzyć za pomocą nowego mechanizmu ładowania skryptów dostępnego w programie Firefox 3. Aby skorzystać z interfejsu API, należy najpierw załadować obiekt: +</p> +<pre class="eval"><span class="nowiki">Components.utils.import("resource://gre/modules/Microformats.js");</span> +</pre> +<p>Po załadowaniu interfejsu API można korzystać z mikroformatów, używając podanych poniżej metod. Informacje na temat przetwarzania mikroformatów znajdują się artykule <a href="pl/Przetwarzanie_mikroformat%c3%b3w_w_j%c4%99zyku_JavaScript">Przetwarzanie mikroformatów w języku JavaScript</a>. +</p> +<h2 id="Wst.C4.99pnie_zdefiniowane_mikroformaty" name="Wst.C4.99pnie_zdefiniowane_mikroformaty">Wstępnie zdefiniowane mikroformaty</h2> +<p>W programie Firefox 3 zaimplementowano definicje kilku popularnych mikroformatów: +</p> +<dl><dt><code><a href="pl/Mikroformat_adr">adr</a></code> +</dt><dd>Reprezentuje adres (np. zamieszkania lub korespondencyjny). +</dd><dt><code><a href="pl/Mikroformat_geo">geo</a></code> +</dt><dd>Reprezentuje lokalizację geograficzną (określaną za pomocą długości i szerokości geograficznej). +</dd><dt><code><a href="pl/Mikroformat_hCard">hCard</a></code> +</dt><dd>Reprezentuje informacje kontaktowe dotyczące osób. +</dd><dt><code><a href="pl/Mikroformat_hCalendar">hCalendar</a></code> +</dt><dd>Reprezentuje pozycję w kalendarzu (np. spotkanie). +</dd><dt><code><a href="pl/Mikroformat_tag">tag</a></code> +</dt><dd>Używany w celu dodawania znaczników do innych mikroformatów. +</dd></dl> +<h2 id="Metody" name="Metody">Metody</h2> +<h3 id="add.28.29" name="add.28.29">add()</h3> +<p>Dodaje nowy mikroformat do modułu mikroformatu. +</p><p>{{ Note("Jeżeli mikroformat o danej nazwie istnieje, jest zastępowany przez nowy mikroformat.") }} +</p> +<pre class="eval">add(nazwa, definicja); +</pre> +<h6 id="Parametry" name="Parametry">Parametry</h6> +<dl><dt><tt>nazwa</tt> +</dt><dd>Nazwa mikroformatu, który ma zostać dodany do modułu mikroformatu. +</dd><dt><tt>definicja</tt> +</dt><dd>Struktura języka JavaScript opisująca mikroformat. Aby uzyskać szczegółowe informacje, patrz <a href="pl/Opisywanie_mikroformat%c3%b3w_w_j%c4%99zyku_JavaScript">Opisywanie mikroformatów w języku JavaScript</a>. +</dd></dl> +<h3 id="count.28.29" name="count.28.29">count()</h3> +<p>Zwraca liczbę istniejących w dokumencie mikroformatów, które spełniają podane kryteria. +</p> +<pre class="eval">liczbaMikroformatow = Microformats.count(nazwa, element_główny, uwzględniaj_rekurencyjnie_ramki); +</pre> +<h6 id="Parametry_2" name="Parametry_2">Parametry</h6> +<dl><dt><tt>nazwa</tt> +</dt><dd>Nazwa mikroformatu, którego egzemplarze są liczone. +</dd><dt><tt>element_główny</tt> +</dt><dd>Argument opcjonalny. Element DOM, od którego ma być rozpoczęte przeszukiwanie. Domyślnie jest to element <code>content.document</code> (innymi słowy, cały dokument). +</dd><dt><tt>uwzględniaj_rekurencyjnie_ramki</tt> +</dt><dd>Argument opcjonalny. W przypadku podania wartości <code>true</code> w przeszukiwaniu uwzględnione będą ramki potomne. Wartością domyślną jest <code>true</code>. +</dd></dl> +<h6 id="Zwracana_warto.C5.9B.C4.87" name="Zwracana_warto.C5.9B.C4.87">Zwracana wartość</h6> +<p>Liczba całkowita określająca liczbę mikroformatów, które spełniają podane kryteria. +</p> +<h3 id="debug.28.29" name="debug.28.29">debug()</h3> +<p>Zwraca ciąg znaków określający obiekt mikroformatu. +</p><p>{{ Note("Zamiast stosowania metody <code>debug()</code> można po prostu skorzystać z metody obiektu mikroformatu o tej samej nazwie: <code>microformatObject.debug()</code>.") }} +</p> +<pre class="eval">zrzucanyCiag = debug(obiekt_mikroformatu) +</pre> +<h6 id="Parametry_3" name="Parametry_3">Parametry</h6> +<dl><dt><tt>obiekt_mikroformatu</tt> +</dt><dd>Obiekt mikroformatu, którego zrzut jest wykonywany. +</dd></dl> +<h6 id="Zwracana_warto.C5.9B.C4.87_2" name="Zwracana_warto.C5.9B.C4.87_2">Zwracana wartość</h6> +<p>Ciąg znaków opisujący zawartość podanego obiektu mikroformatu. +</p> +<h3 id="get.28.29" name="get.28.29">get()</h3> +<p>Zwraca tablicę z obiektami mikroformatów, odpowiadającymi znalezionym mikroformatom spełniającym podane kryteria. +</p> +<pre class="eval">tablicaMikroformatow = Microformats.count(nazwa, element_główny, opcje, tablica_docelowa); +</pre> +<h6 id="Parametry_4" name="Parametry_4">Parametry</h6> +<dl><dt><tt>nazwa</tt> +</dt><dd>Nazwa poszukiwanego mikroformatu. +</dd><dt><tt>element_główny</tt> +</dt><dd>Element DOM, od którego ma być rozpoczęte przeszukiwanie. +</dd><dt><tt>opcje</tt> +</dt><dd>Argument opcjonalny. Obiekt JavaScript zawierający zero lub więcej następujących wskaźników: +</dd></dl> +<blockquote> +<dl><dt><tt>recurseFrames</tt> +</dt><dd>W przypadku podania wartości <code>true</code> w przeszukiwaniu uwzględnione będą ramki potomne. Wartością domyślną jest <code>true</code>. +</dd><dt><tt>showHidden</tt> +</dt><dd>W przypadku podania wartości <code>true</code> dodawane są ukryte mikroformaty; w przeciwnym przypadku są one ignorowane. Wartością domyślną jest <code>false</code>. +</dd><dt><tt>debug</tt> +</dt><dd>W przypadku korzystania z trybu debugowania należy podać wartość <code>true</code>; w przeciwnym przypadku należy podać wartość <code>false</code>. Wartością domyślną jest <code>false</code>. +</dd></dl> +</blockquote> +<dl><dt><tt>tablica_docelowa</tt> +</dt><dd>Argument opcjonalny. Tablica zawierająca obiekty mikroformatów, do której dodawane będą rezultaty wyszukiwania. +</dd></dl> +<h6 id="Zwracana_warto.C5.9B.C4.87_3" name="Zwracana_warto.C5.9B.C4.87_3">Zwracana wartość</h6> +<p>Nowa tablica zawierająca obiekty mikroformatów, które spełniały podane kryteria, lub tablica określona w obiekcie <tt>microformats</tt>, do której dodano nowe, znalezione obiekty mikroformatów. +</p> +<h3 id="getNamesFromNode.28.29" name="getNamesFromNode.28.29">getNamesFromNode()</h3> +<p>Zwraca listę rozdzielonych znakami spacji nazw mikroformatów, które odpowiadały podanemu węzłowi mikroformatu. +</p> +<pre class="eval">listaNazw = Microformats.getNamesFromNode(węzeł); +</pre> +<h6 id="Parametry_5" name="Parametry_5">Parametry</h6> +<dl><dt><tt>węzeł</tt> +</dt></dl> +<dl><dd>Węzeł, z którego ma zostać pobrana lista nazw mikroformatów. +</dd></dl> +<h6 id="Zwracana_warto.C5.9B.C4.87_4" name="Zwracana_warto.C5.9B.C4.87_4">Zwracana wartość</h6> +<p>Jeżeli podany <tt>węzeł</tt> jest mikroformatem, zwracany jest ciąg znaków stanowiący listę rozdzielonych znakami spacji nazw mikroformatów, które odpowiadały podanemu węzłowi. Jeżeli węzeł nie jest mikroformatem, nie jest zwracana żadna wartość. +</p> +<h3 id="getParent.28.29" name="getParent.28.29">getParent()</h3> +<p>Zwraca nadrzędny węzeł podanego mikroformatu lub węzła potomnego mikroformatu. +</p><p>wezelNadrzedny = Microformats.getParent(węzeł); +</p> +<h6 id="Parametry_6" name="Parametry_6">Parametry</h6> +<dl><dt><tt>węzeł</tt> +</dt><dd>Węzeł, którego węzeł nadrzędny ma być pobrany. +</dd></dl> +<h6 id="Zwracana_warto.C5.9B.C4.87_5" name="Zwracana_warto.C5.9B.C4.87_5">Zwracana wartość</h6> +<p>Węzeł nadrzędny podanego węzła. Jeżeli podany <tt>węzeł</tt> nie jest mikroformatem ani węzłem potomnym mikroformatu, nie jest zwracana żadna wartość. +</p> +<h3 id="isMicroformat.28.29" name="isMicroformat.28.29">isMicroformat()</h3> +<p>Określa, czy podany węzeł DOM jest mikroformatem. +</p> +<pre class="eval">wskaznik = Microformats.isMicroformat(węzeł); +</pre> +<h6 id="Parametry_7" name="Parametry_7">Parametry</h6> +<dl><dt><tt>węzeł</tt> +</dt><dd>Węzeł DOM, który ma zostać sprawdzony. +</dd></dl> +<h6 id="Zwracana_warto.C5.9B.C4.87_6" name="Zwracana_warto.C5.9B.C4.87_6">Zwracana wartość</h6> +<p><code>true</code>, jeżeli węzeł jest mikroformatem; w przeciwnym przypadku zwracana jest wartość <code>false</code>. +{{ Note("Metoda <i>nie</i> zwraca wartości <code>true</code>, jeżeli węzeł jest węzłem potomnym mikroformatu.") }} +</p><p><br> +</p><p><br> +</p><p><br> +</p> +<div class="noinclude"> +</div> +{{ languages( { "en": "en/Using_microformats", "es": "es/El_uso_de_microformatos", "fr": "fr/Utilisation_de_microformats", "ja": "ja/Using_microformats", "ko": "ko/Using_microformats" } ) }} diff --git a/files/pl/archive/mozilla/index.html b/files/pl/archive/mozilla/index.html new file mode 100644 index 0000000000..0acec76e6d --- /dev/null +++ b/files/pl/archive/mozilla/index.html @@ -0,0 +1,10 @@ +--- +title: Archived Mozilla and build documentation +slug: Archive/Mozilla +tags: + - NeedsTranslation + - TopicStub +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/pl/archive/mozilla/venkman/index.html b/files/pl/archive/mozilla/venkman/index.html new file mode 100644 index 0000000000..26629f1eb2 --- /dev/null +++ b/files/pl/archive/mozilla/venkman/index.html @@ -0,0 +1,33 @@ +--- +title: Venkman +slug: Archive/Mozilla/Venkman +tags: + - 'JavaScript:Narzędzia' + - Narzędzia + - 'Programowanie_WWW:Narzędzia' + - 'Rozszerzenia:Narzędzia' + - Venkman + - Wszystkie_kategorie +translation_of: Archive/Mozilla/Venkman +--- +<p>Venkman jest opartym na Mozilli debuggerem JavaScriptu.</p> +<h3 id="Pobierz_Venkman" name="Pobierz_Venkman">Pobierz Venkman</h3> +<ul> + <li><b>Mozilla Suite</b> i <b>SeaMonkey</b>: Venkman jest jedną z opcji podczas instalacji (wybierz instalację zaawansowaną).</li> + <li><b>Mozilla Suite</b>, <b>SeaMonkey</b>, <b>Firefox</b>, i <b>Thunderbird</b>: ostatnia wersja Venkman jest dostępna na stronie <a class="link-https" href="https://addons.mozilla.org/pl/firefox/addon/javascript-debugger/">Mozilla Addons</a>.</li> + <li><b>Nvu</b>: dla Nvu jest dostępna wersja ze strony <a class="external" href="http://glazman.org/nvu/releases/extensions/">glazman.org</a>.</li> +</ul> +<h3 id=".C5.B9r.C3.B3d.C5.82a" name=".C5.B9r.C3.B3d.C5.82a">Źródła</h3> +<p>Obejrzyj następujące strony, aby zdobyć więcej informacji o Venkman:</p> +<ul> + <li><a class="external" href="http://www.mozilla.org/projects/venkman/">Venkman - strona główna</a></li> + <li><a class="external" href="http://www.hacksrus.com/~ginda/venkman/">Venkman - strona programowania</a></li> + <li><a class="external" href="http://www.hacksrus.com/~ginda/venkman/screenshots/?M=D">Zrzuty ekranu</a></li> + <li><a class="external" href="http://www.hacksrus.com/~ginda/venkman/faq/venkman-faq.html">FAQ</a></li> + <li>Grupy dyskusyjne: <a class="external" href="http://groups.google.com/group/mozilla.dev.apps.js-debugger">mozilla.dev.apps.js-debugger</a></li> + <li><a class="external" href="http://www.hacksrus.com/~ginda/venkman/faq/venkman-faq.html#irc">IRC</a>: <a class="link-irc" href="irc://irc.mozilla.org/venkman" rel="freelink">irc://irc.mozilla.org/venkman</a></li> +</ul> +<ul> + <li><a class="external" href="http://www.svendtofte.com/code/learning_venkman/">"Nauka debuggera JavaScriptu - Venkman"</a> napisany przez Svend Tofte.</li> +</ul> +<p>{{ languages( { "en": "en/Venkman", "es": "es/Venkman", "fr": "fr/Venkman", "it": "it/Venkman", "ja": "ja/Venkman", "ko": "ko/Venkman" } ) }}</p> diff --git a/files/pl/archive/mozilla/xbl/index.html b/files/pl/archive/mozilla/xbl/index.html new file mode 100644 index 0000000000..34cb613a90 --- /dev/null +++ b/files/pl/archive/mozilla/xbl/index.html @@ -0,0 +1,39 @@ +--- +title: XBL +slug: Archive/Mozilla/XBL +tags: + - Wszystkie_kategorie + - XBL +translation_of: Archive/Mozilla/XBL +--- +<p> <b>XML Binding Language</b> (<b>XBL</b>, czasami także nazywany <b>Rozszerzalny Język Wiązań</b>) jest językiem służącym do deklarowania zachowań elementów. Element, do którego dołączone jest wiązanie, nazywany <i>elementem wiązanym</i> (eng. <i>bound element</i>), zostaje rozszerzony o nowe zachowanie określone w wiązaniu. +</p><p>Wiązania mogą posiadać uchwyty zdarzeń, które są rejestrowane dla wiązanego elementu, implementacje nowych metod i własności, które stają się dostępne z poziomu wiązanego elementu oraz anonimową zawartość, która jest włączana wewnątrz wiązanego elementu. +</p><p>Większość kontrolek <a href="pl/XUL">XUL</a> jest przynajmniej w części implementowana przy użyciu języka XBL. Możesz zbudować własne kontrolki bazując na istniejących w <a href="pl/XUL">XUL</a>-u, <a href="pl/HTML">HTML</a>-u, <a href="pl/SVG">SVG</a> i innych prymitywnych językach używających XBL-a. +</p> +<h3 id="Specyfikacje"> Specyfikacje </h3> +<ul><li> Specyfikacja XBL 1.0 jest opisana w <a href="pl/XBL/Dokumentacja_XBL_1.0">Dokumentacja XBL 1.0</a>. Niestety, aktualna implementacja w Mozilli różni się od specyfikacji i co za tym idzie nie ma żadnego dokumentu opisującego te różnice. Na szczęście, dokument będzie uaktualniony o wspomniane różnice .<br>XBL 1.0 jest technologią Mozilli, a nie standardem <a class="external" href="http://w3.org/">W3C</a> standard. XBL 1.0 jest technologią opartą na Mozilli i nie należy do standardu <a class="external" href="http://w3.org/">W3C</a>. Przynajmniej dwa nowe standardy są opracowywane: sXBL i XBL 2.0. +</li></ul> +<ul><li> W3C <a class="external" href="http://w3.org/TR/sXBL/">sXBL</a> (szkic roboczy, 2005) mówi o <i>SVG's XML Binding Language</i>. Opisuje podzbiór XBL2.0 potrzebny do <a href="pl/SVG">SVG</a>. Jest on bardzo podobny do Mozillowego XBL-a ale istnieje w nim parę różnic. Na przykład występują zmiana nazewnictwa niektórych elementów. sXBL nie posiada także niektórych funkcji XBL-a, takich jak dziedziczenie wiązań oraz definiowanie metod/właściwości w wiązanych elementach. +</li><li> <a class="external" href="http://www.mozilla.org/projects/xbl/xbl2.html">XBL 2.0</a> (<a class="external" href="http://w3.org/TR/XBL/">kandydat na rekomendację W3C</a>) jest rozwijany, aby poprawić problemy znalezione w XBL 1.0 oraz pozwolić na implementacje w większej liczbie przeglądarek WWW. Mozilla planuje implementację XBL2 w przyszłych wersjach <a href="pl/Gecko">Gecko</a>. +</li></ul> +<p>Niektóre różnice pomiedzy sXBL a XBL2 są wymienione w <a class="external" href="http://annevankesteren.nl/2005/11/xbl">artykule Anne van Kesteren</a> (Listopad, 2005). +</p><p>Przegląd różnic pomiędzy XBL-em Mozilli a XBL2 można znaleźć <a class="external" href="http://groups.google.com/group/mozilla.dev.tech.xbl/msg/af3d4e37cce1d907">w wiadomości Jonas'a Sicking'a</a> (Kwiecień, 2007). +</p> +<h3 id="Zobacz_także"> Zobacz także </h3> +<ul><li> <a href="pl/Kurs_XUL/Wprowadzenie_do_XBL">Wprowadzenie do XBL</a> z <a href="pl/Kurs_XUL">kursu XUL</a>. +</li><li> <a class="external" href="http://mb.eschew.org/15.php">Rozdział XBL</a> z <a class="external" href="http://mb.eschew.org/">"Rapid Application Development with Mozilla"</a> +</li><li> <a class="external" href="http://www.w3.org/TR/xbl-primer/">Podstawy XBL 2.0</a> (szkic) +</li></ul> +<ul><li> <a>Więcej źródeł XBL...</a> +</li></ul> +<h3 id="Społeczność"> Społeczność </h3> +<ul><li> Obejrzyj fora Mozilli... +</li></ul> +<p></p><ul> + <li><a href="https://lists.mozilla.org/listinfo/dev-tech-xbl"> jako listę dyskusyjna</a></li> + + + <li><a href="http://groups.google.com/group/mozilla.dev.tech.xbl"> jako newsgroup</a></li> + <li><a href="http://groups.google.com/group/mozilla.dev.tech.xbl/feeds"> jako kanał</a></li> +</ul> +<p></p> diff --git a/files/pl/archive/mozilla/xulrunner/index.html b/files/pl/archive/mozilla/xulrunner/index.html new file mode 100644 index 0000000000..92a2d1c00b --- /dev/null +++ b/files/pl/archive/mozilla/xulrunner/index.html @@ -0,0 +1,80 @@ +--- +title: XULRunner +slug: Archive/Mozilla/XULRunner +tags: + - XUL + - XULRunner +translation_of: Archive/Mozilla/XULRunner +--- +<div class="callout-box"><strong><a class="external" href="http://blogs.acceleration.net/ryan/archive/2005/05/06/1073.aspx">Przewodnik XULRunner</a></strong><br> +Krótkie wprowadzenie do XULRunner.</div> + +<div> +<p><strong>XULRunner</strong> jest pojedynczym pakietem instalacyjnym, który może być użyty do uruchamiania wielu aplikacji bazujących na XUL+XPCOM takich jak Firefox czy Thunderbird.</p> + +<p>Możesz pobrać XULRunner-a z <a class="external" href="http://ftp.mozilla.org/pub/mozilla.org/xulrunner/nightly/">ftp.mozilla.org</a></p> +</div> + +<table class="topicpage-table"> + <tbody> + <tr> + <td> + <h2 id="Pe.C5.82na_wersja" name="Pe.C5.82na_wersja">Pełna wersja</h2> + + <div class="note"> + <p>XULRunner 1.8.0.4 jest stabilną pełną wersją <strong>developer preview</strong> opartą na tym samym kodzie źródłowym co Firefox 1.5.0.4. Jest dostępny dla <a class="external" href="http://ftp.mozilla.org/pub/mozilla.org/xulrunner/releases/1.8.0.4/win32/en-US/xulrunner-1.8.0.4.en-US.win32.zip">Windows</a>, <a class="external" href="http://ftp.mozilla.org/pub/mozilla.org/xulrunner/releases/1.8.0.4/mac/en-US/xulrunner-1.8.0.4.en-US.mac.dmg">Mac OS X</a>, i <a class="external" href="http://ftp.mozilla.org/pub/mozilla.org/xulrunner/releases/1.8.0.4/linux-i686/en-US/xulrunner-1.8.0.4.en-US.linux-i686.tar.gz">Linux</a> w angielskiej wersji językowej. Przeczytaj <a href="/pl/XULRunner_1.8.0.4_Release_Notes" title="pl/XULRunner_1.8.0.4_Release_Notes">uwagi dotyczące tej wersji</a>, aby zainstalować, odinstalować oraz dla zdobycia dodatkowych informacji.</p> + </div> + + <h2 id="Przegl.C4.85d" name="Przegl.C4.85d">Przegląd</h2> + + <ul> + <li>{{ interwiki('wikimo', 'XULRunner:Roadmap', 'Development Roadmap') }}</li> + <li><a href="/pl/XULRunner/What_XULRunner_Provides" title="pl/XULRunner/What_XULRunner_Provides">What XULRunner Provides</a></li> + <li><a href="/pl/XULRunner_FAQ" title="pl/XULRunner_FAQ">XULRunner FAQ</a></li> + <li>Nightly builds: <a class="external" href="http://ftp.mozilla.org/pub/mozilla.org/xulrunner/nightly/latest-mozilla1.8/">latest-mozilla1.8</a> <a class="external" href="http://ftp.mozilla.org/pub/mozilla.org/xulrunner/nightly/latest-trunk/">unstable-trunk</a></li> + </ul> + + <h2 id="Dokumentacja" name="Dokumentacja"><a href="/Special:Tags?tag=XULRunner&language=pl" title="Special:Tags?tag=XULRunner&language=pl">Dokumentacja</a></h2> + + <dl> + <dt><a href="/Special:Tags?tag=XULRunner&language=pl" title="Special:Tags?tag=XULRunner&language=pl">Pokaż wszystkie...</a></dt> + </dl> + + <dl> + <dt><a href="/Special:Tags?tag=XULRunner:Przyk%C5%82ady&language=pl" title="Special:Tags?tag=XULRunner:Przykłady&language=pl">Przykłady aplikacji</a></dt> + <dd><small>Prosty przykład aplikacji XULRunner, które mogą być kopiowane.</small></dd> + </dl> + + <dl> + <dt><a class="external" href="http://blogs.acceleration.net/ryan/archive/2005/05/06/1073.aspx">Przewodnik XULRunner</a></dt> + <dd><small>Krótkie wprowadzenie do XULRunner.</small></dd> + </dl> + + <p><span class="alllinks"><a href="/Special:Tags?tag=XULRunner&language=pl" title="Special:Tags?tag=XULRunner&language=pl">Pokaż wszystkie...</a></span></p> + </td> + <td> + <h2 id="Spo.C5.82eczno.C5.9B.C4.87" name="Spo.C5.82eczno.C5.9B.C4.87">Społeczność</h2> + + <ul> + <li>Obejrzyj fora Mozilli...</li> + </ul> + + <p>{{ DiscussionList("dev-tech-xul", "mozilla.dev.tech.xul") }}</p> + + <ul> + <li><a class="link-irc" href="irc://irc.mozilla.org/#xulrunner">#xulrunner na irc.mozilla.org</a></li> + <li><a class="external" href="http://mail.mozilla.org/listinfo/xulrunner-dev">Lista dyskusyjna XULRunner-Dev</a></li> + <li><a href="/pl/XULRunner/Społeczność" title="pl/XULRunner/Społeczność">Inne linki...</a></li> + </ul> + + <h2 id="Wybrane_tematy" name="Wybrane_tematy">Wybrane tematy</h2> + + <dl> + <dd><a href="/pl/XUL" title="pl/XUL">XUL</a></dd> + </dl> + </td> + </tr> + </tbody> +</table> + +<p><span class="comment">Categories</span></p> diff --git a/files/pl/archive/rss/elementy/index.html b/files/pl/archive/rss/elementy/index.html new file mode 100644 index 0000000000..fe9070ad7b --- /dev/null +++ b/files/pl/archive/rss/elementy/index.html @@ -0,0 +1,148 @@ +--- +title: Elementy +slug: Archive/RSS/Elementy +tags: + - Dokumentacje + - Junk + - RSS + - 'RSS:Dokumentacje' + - Strony_wymagające_dopracowania + - Wszystkie_kategorie +translation_of: Archive/RSS_elements +--- +<h2 id="Elementy_RSS" name="Elementy_RSS">Elementy RSS</h2> + +<h3 id="A" name="A">A</h3> + +<ul> + <li><a href="pl/RSS/Elementy/author"><author></a> (<a href="pl/RSS/Elementy/author">Element RSS: Author</a>)</li> +</ul> + +<h3 id="B" name="B">B</h3> + +<h3 id="C" name="C">C</h3> + +<ul> + <li><a href="pl/RSS/Elementy/category"><category></a> (<a href="pl/RSS/Elementy/category">RSS Category Element</a>)</li> + <li><a href="pl/RSS/Elementy/channel"><channel></a> (<a href="pl/RSS/Elementy/channel">RSS Channel Element</a>)</li> + <li><a href="pl/RSS/Elementy/cloud"><cloud></a> (<a href="pl/RSS/Elementy/cloud">RSS Cloud Element</a>)</li> + <li><a href="pl/RSS/Elementy/comments"><comments></a> (<a href="pl/RSS/Elementy/comments">RSS Comments Element</a>)</li> + <li><a href="pl/RSS/Elementy/copyright"><copyright></a> (<a href="pl/RSS/Elementy/copyright">RSS Copyright Element</a>)</li> +</ul> + +<h3 id="D" name="D">D</h3> + +<ul> + <li><a href="pl/RSS/Elementy/day"><day></a> (<a href="pl/RSS/Elementy/day">RSS Day Element</a>)</li> + <li><a href="pl/RSS/Elementy/description"><description></a> (<a href="pl/RSS/Elementy/description">RSS Description Element</a>)</li> + <li><a href="pl/RSS/Elementy/docs"><docs></a> (<a href="pl/RSS/Elementy/docs">RSS Docs Element</a>)</li> +</ul> + +<h3 id="E" name="E">E</h3> + +<ul> + <li><a href="pl/RSS/Elementy/enclosure"><enclosure></a> (<a href="pl/RSS/Elementy/enclosure">RSS Enclosure Element</a>)</li> +</ul> + +<h3 id="F" name="F">F</h3> + +<h3 id="G" name="G">G</h3> + +<ul> + <li><a href="pl/RSS/Elementy/generator"><generator></a> (<a href="pl/RSS/Elementy/generator">RSS Generator Element</a>)</li> + <li><a href="pl/RSS/Elementy/guid"><guid></a> (<a href="pl/RSS/Elementy/guid">RSS GUID Element</a>)</li> +</ul> + +<h3 id="H" name="H">H</h3> + +<ul> + <li><a href="pl/RSS/Elementy/height"><height></a> (<a href="pl/RSS/Elementy/height">RSS Height Element</a>)</li> + <li><a href="pl/RSS/Elementy/hour"><hour></a> (<a href="pl/RSS/Elementy/hour">RSS Hour Element</a>)</li> +</ul> + +<h3 id="I" name="I">I</h3> + +<ul> + <li><a href="pl/RSS/Elementy/image"><image></a> (<a href="pl/RSS/Elementy/image">Element RSS: Image</a>)</li> + <li><a href="pl/RSS/Elementy/item"><item></a> (<a href="pl/RSS/Elementy/item">Element RSS: Item</a>)</li> +</ul> + +<h3 id="J" name="J">J</h3> + +<h3 id="K" name="K">K</h3> + +<h3 id="L" name="L">L</h3> + +<ul> + <li><a href="pl/RSS/Elementy/language"><language></a> (<a href="pl/RSS/Elementy/language">Element RSS: Language</a>)</li> + <li><a href="pl/RSS/Elementy/lastBuildDate"><lastBuildDate></a> (<a href="pl/RSS/Elementy/lastBuildDate">Element RSS: Last Build Date Element</a>)</li> + <li><a href="pl/RSS/Elementy/link"><link></a> (<a href="pl/RSS/Elementy/link">Element RSS Link</a>)</li> +</ul> + +<h3 id="M" name="M">M</h3> + +<ul> + <li><a href="pl/RSS/Elementy/managingEditor"><managingEditor></a> (<a href="pl/RSS/Elementy/managingEditor">Element RSS: Managing Editor</a>)</li> +</ul> + +<h3 id="N" name="N">N</h3> + +<ul> + <li><a href="pl/RSS/Elementy/name"><name></a> (<a href="pl/RSS/Elementy/name">Element RSS: Name</a>)</li> +</ul> + +<h3 id="O" name="O">O</h3> + +<h3 id="P" name="P">P</h3> + +<ul> + <li><a href="pl/RSS/Elementy/pubDate"><pubDate></a> (<a href="pl/RSS/Elementy/pubDate">RSS Published Date Element</a>)</li> +</ul> + +<h3 id="Q" name="Q">Q</h3> + +<h3 id="R" name="R">R</h3> + +<ul> + <li><a href="pl/RSS/Elementy/rating"><rating></a> (<a href="pl/RSS/Elementy/rating">RSS Rating Element</a>)</li> + <li><a href="pl/RSS/Elementy/rss"><rss></a> (<a href="pl/RSS/Elementy/rss">Element RSS's Root "rss"</a>)</li> +</ul> + +<h3 id="S" name="S">S</h3> + +<ul> + <li><a href="pl/RSS/Elementy/skipDays"><skipDays></a> (<a href="pl/RSS/Elementy/skipDays">RSS Skip Days Element</a>)</li> + <li><a href="pl/RSS/Elementy/skipHours"><skipHours></a> (<a href="pl/RSS/Elementy/skipHours">RSS Skip Hours Element</a>)</li> + <li><a href="pl/RSS/Elementy/source"><source></a> (<a href="pl/RSS/Elementy/source">RSS Source Element</a>)</li> +</ul> + +<h3 id="T" name="T">T</h3> + +<ul> + <li><a href="pl/RSS/Elementy/textinput"><textinput></a> (<a href="pl/RSS/Elementy/textinput">Elementy RSS - Text Input</a>)</li> + <li><a href="pl/RSS/Elementy/title"><title></a> (<a href="pl/RSS/Elementy/title">Elemety RSS - Tytuł</a>)</li> + <li><a href="pl/RSS/Elementy/ttl"><ttl></a> (<a href="pl/RSS/Elementy/ttl">Elementy RSS - TTL</a>)</li> +</ul> + +<h3 id="U" name="U">U</h3> + +<ul> + <li><a href="pl/RSS/Elementy/url"><url></a> (<a href="pl/RSS/Elementy/url">RSS URL Element</a>)</li> +</ul> + +<h3 id="V" name="V">V</h3> + +<h3 id="W" name="W">W</h3> + +<ul> + <li><a href="pl/RSS/Elementy/webMaster"><webMaster></a> (<a href="pl/RSS/Elementy/webMaster">RSS Web Master Element</a>)</li> + <li><a href="pl/RSS/Elementy/width"><width></a> (<a href="pl/RSS/Elementy/width">RSS Width Element</a>)</li> +</ul> + +<h3 id="X" name="X">X</h3> + +<h3 id="Y" name="Y">Y</h3> + +<h3 id="Z" name="Z">Z</h3> + +<p><span class="comment">Interwiki Language Links</span></p> diff --git a/files/pl/archive/rss/elementy/title/index.html b/files/pl/archive/rss/elementy/title/index.html new file mode 100644 index 0000000000..ad9ceea54c --- /dev/null +++ b/files/pl/archive/rss/elementy/title/index.html @@ -0,0 +1,133 @@ +--- +title: title +slug: Archive/RSS/Elementy/title +tags: + - Dokumentacje + - RSS + - 'RSS:Dokumentacje' + - Wszystkie_kategorie +translation_of: Archive/RSS_elements/title +--- +<p> +</p> +<h2 id="Element_RSS_-_title" name="Element_RSS_-_title"> Element RSS - <i>title</i></h2> +<p><b><title>...</title></b> - element RSS tytułu ma cztery zastosowania, które są sprecyzowane dla elementu <i>title</i>. Jest stosowany w elementach; <a href="pl/RSS/Elementy/Channel"><channel></a>, <a href="pl/RSS/Elementy/image"><image></a>, <a href="pl/RSS/Elementy/item"><item></a> lub <a href="pl/RSS/Elementy/textinput"><textinput></a>. +</p><p>Tytuł elementu RSS stanowią dane typu <i>plain text</i>. +</p> +<div class="note"> +<p><b>Uwaga</b>: w wersji <a href="pl/RSS/Wersje/0.91/Userland">Userland RSS 0.91</a> znajduje się maksymalny limit znaków, który wynosi 100. +</p> +</div> +<p><b>Przykład <a href="pl/RSS/Wersje/0.91/Netscape/Wersja_3">Netscape RSS 0.91 Wersja 3</a></b> +</p> +<pre class="eval"> <span class="nowiki"> + <?xml version="1.0"?> + <!DOCTYPE rss SYSTEM "http://my.netscape.com/publish/formats/rss-0.91.dtd"> + + <rss version="0.91"> + <channel> + </span><b><span class="highlightred"><span class="nowiki"><title>Advogato</title></span></span></b><span class="nowiki"> + <link>http://www.advogato.org/article/</link> + <description>Recent Advogato articles</description> + <language>en-us</language> + <image> + <link>http://www.advogato.org/</link> + </span><b><span class="highlightred"><span class="nowiki"><title>Advogato</title></span></span></b><span class="nowiki"> + <url>http://www.advogato.org/image/tinyadvogato.png</url> + </image> + <item> + </span><b><span class="highlightred"><span class="nowiki"><title>Why can I not get any tang?!</title></span></span></b><span class="nowiki"> + <link>http://www.advogato.org/article/10101.html</link> + <description>Seriously. Why can't I get any tang?</description> + </item> + </channel> + </rss> + </span> +</pre> +<h3 id="Atrybuty" name="Atrybuty"> Atrybuty </h3> +<dl><dd> <i>brak</i> +</dd></dl> +<h3 id="Pod_elementy" name="Pod_elementy"> Pod elementy </h3> +<dl><dd> <i>brak</i> +</dd></dl> +<h3 id="Element_b.C4.99d.C4.85cy_rodzicem" name="Element_b.C4.99d.C4.85cy_rodzicem"> Element będący rodzicem </h3> +<p>Tabela poniżej pokazuje listę <a href="pl/RSS/Elementy">elementów RSS</a>, które są elementami potomnymi tego elementu. +</p> +<center> + +<tr> +<th>Nazwa</td> +<th>Tag</td> +<th><a href="pl/RSS/Wersje/0.90">0.90</a></td> +<th><a href="pl/RSS/Wersje/0.91/Netscape/Wersje_1">N 0.91 R1</a></td> +<th><a href="pl/RSS/Wersje/0.91/Netscape/Wersje_3">N 0.91 R3</a></td> +<th><a href="pl/RSS/Wersje/0.91/Userland">U 0.91</a></td> +<th><a href="pl/RSS/Wersje/0.92">0.92</a></td> +<th><a href="pl/RSS/Wersje/0.93">0.93</a></td> +<th><a href="pl/RSS/Wersje/0.94">0.94</a></td> +<th><a href="pl/RSS/Wersje/1.0">1.0</a></td> +<th><a href="pl/RSS/Wersje/2.0">2.0</a></td> +</tr> +<tr> +<td><a href="pl/RSS/Elementy/Channel">Element RSS: channel</a></td> +<td><a href="pl/RSS/Elementy/Channel"><channel></a></td> +<td>✔</td> +<td>✔</td> +<td>✔</td> +<td>✔</td> +<td>?</td> +<td>?</td> +<td>?</td> +<td>?</td> +<td>?</td> +</tr> +<tr> +<td><a href="pl/RSS/Elementy/image">Element RSS: image</a></td> +<td><a href="pl/RSS/Elementy/image"><image></a></td> +<td>✔</td> +<td>✔</td> +<td>✔</td> +<td>✔</td> +<td>?</td> +<td>?</td> +<td>?</td> +<td>?</td> +<td>?</td> +</tr> +<tr> +<td><a href="pl/RSS/Elementy/item">Element RSS: item</a></td> +<td><a href="pl/RSS/Elementy/item"><item></a></td> +<td>✔</td> +<td>✔</td> +<td>✔</td> +<td>✔</td> +<td>?</td> +<td>?</td> +<td>?</td> +<td>?</td> +<td>?</td> +</tr> +<tr> +<td><a href="pl/RSS/Elementy/textinput">Element RSS: textinput</a></td> +<td><a href="pl/RSS/Elementy/textinput"><textinput></a></td> +<td>✔</td> +<td>✔</td> +<td>✔</td> +<td>✔</td> +<td>?</td> +<td>?</td> +<td>?</td> +<td>?</td> +<td>?</td> +</tr> +</table> +</center> <h3 id="Zobacz_tak.C5.BCe" name="Zobacz_tak.C5.BCe"> Zobacz także </h3><dl><dd> <i>brak</i> +</dd></dl><p>{{ RSS:Element_Navigation() }} +</p><p><span class="comment">Interwiki Language Links</span> +</p><table class="standard-table"> +<tbody><tr> +<th colspan="2" style="text-align: center;"><a href="pl/RSS/Elementy">Elementy RSS</a></td> +<th colspan="9" style="text-align:center"><a href="pl/RSS/Wersje">Wersje RSS</a></th> +</tr> + +</tbody></table></center>{{ languages( { "en": "en/RSS/Element/title" } ) }} diff --git a/files/pl/archive/rss/encje/index.html b/files/pl/archive/rss/encje/index.html new file mode 100644 index 0000000000..2b8b26e7ff --- /dev/null +++ b/files/pl/archive/rss/encje/index.html @@ -0,0 +1,1380 @@ +--- +title: Encje +slug: Archive/RSS/Encje +tags: + - RSS + - Wszystkie_kategorie +translation_of: Archive/RSS/Entity_list +--- +<p> +</p> +<h2 id="Lista_encji_RSS" name="Lista_encji_RSS"> Lista encji RSS </h2> +<div class="note"> +<p><b>Uwaga</b>: Są trzy różne wersje RSS 0.91. Pierwszą jest <a href="pl/RSS/Wersje/0.91/Netscape/Wersja_1">Netscape'a RSS 0.91 (Wersja 1)</a> (N 0.91 R1), następną jest <a href="pl/RSS/Wersje/0.91/Netscape/Wersja_3">Netscape'a RSS 0.91 Wersja 3</a> (N 0.91 R3) i <a href="pl/RSS/Wersje/0.91/Userland">Userland RSS 0.91</a> (U 0.91). Wersja Netscape'a RSS 0.91 używa DTD, który definiuje 96 dodatkowych nazw encji. (wersja wydana przez Userland RSS 0.91 NIE używa tego DTD.) +</p> +</div> + +<tr> +<th><a href="pl/RSS/Wersje/0.90">0.90</a></td> +<th><a href="pl/RSS/Wersje/0.91/Netscape/Wersja_1">N 0.91 R1</a></td> +<th><a href="pl/RSS/Wersje/0.91/Netscape/Wersja_3">N 0.91 R3</a></td> +<th><a href="pl/RSS/Wersje/0.91/Userland">U 0.91</a></td> +<th><a href="pl/RSS/Wersje/0.92">0.92</a></td> +<th><a href="pl/RSS/Wersje/0.93">0.93</a></td> +<th><a href="pl/RSS/Wersje/0.94">0.94</a></td> +<th><a href="pl/RSS/Wersje/1.0">1.0</a></td> +<th><a href="pl/RSS/Wersje/2.0">2.0</a></td> +</tr> +<tr> +<td>&aacute;</td> +<td>#</td> +<td>á</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&Aacute;</td> +<td>#</td> +<td>Á</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&acute;</td> +<td>#</td> +<td>´</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&acirc;</td> +<td>#</td> +<td>â</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&Acirc;</td> +<td>#</td> +<td>Â</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&aelig;</td> +<td>#</td> +<td>æ</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&AElig;</td> +<td>#</td> +<td>Æ</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&agrave;</td> +<td>#</td> +<td>à</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&Agrave;</td> +<td>#</td> +<td>À</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&aring;</td> +<td>#</td> +<td>å</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&Aring;</td> +<td>#</td> +<td>Å</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&atilde;</td> +<td>#</td> +<td>ã</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&Atilde;</td> +<td>#</td> +<td>Ã</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&auml;</td> +<td>#</td> +<td>ä</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&Auml;</td> +<td>#</td> +<td>Ä</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&brvbar;</td> +<td>&#166;</td> +<td>¦</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&ccedil;</td> +<td>#</td> +<td>ç</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&Ccedil;</td> +<td>#</td> +<td>Ç</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&cedil;</td> +<td>#</td> +<td>¸</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&cent;</td> +<td>&#162;</td> +<td>¢</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&copy;</td> +<td>#</td> +<td>©</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&curren;</td> +<td>&#164;</td> +<td>¤</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&deg;</td> +<td>#</td> +<td>°</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&divide;</td> +<td>#</td> +<td>÷</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&eacute;</td> +<td>#</td> +<td>é</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&Eacute;</td> +<td>#</td> +<td>É</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&ecirc;</td> +<td>#</td> +<td>ê</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&Ecirc;</td> +<td>#</td> +<td>Ê</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&egrave;</td> +<td>#</td> +<td>è</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&Egrave;</td> +<td>#</td> +<td>È</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&eth;</td> +<td>#</td> +<td>ð</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&ETH;</td> +<td>#</td> +<td>Ð</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&euml;</td> +<td>#</td> +<td>ë</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&Euml;</td> +<td>#</td> +<td>Ë</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&frac12;</td> +<td>#</td> +<td>½</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&frac14;</td> +<td>#</td> +<td>¼</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&frac34;</td> +<td>#</td> +<td>¾</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&iacute;</td> +<td>#</td> +<td>í</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&Iacute;</td> +<td>#</td> +<td>Í</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&icirc;</td> +<td>#</td> +<td>î</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&Icirc;</td> +<td>#</td> +<td>Î</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&iexcl;</td> +<td>&#161;</td> +<td>¡</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&igrave;</td> +<td>#</td> +<td>ì</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&Igrave;</td> +<td>#</td> +<td>Ì</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&iquest;</td> +<td>#</td> +<td>¿</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&iuml;</td> +<td>#</td> +<td>ï</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&Iuml;</td> +<td>#</td> +<td>Ï</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&laquo;</td> +<td>#</td> +<td>«</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&macr;</td> +<td>#</td> +<td>¯</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&micro;</td> +<td>#</td> +<td>µ</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&middot;</td> +<td>#</td> +<td>·</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&nbsp;</td> +<td>&#160;</td> +<td> </td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&not;</td> +<td>#</td> +<td>¬</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&ntilde;</td> +<td>#</td> +<td>ñ</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&Ntilde;</td> +<td>#</td> +<td>Ñ</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&oacute;</td> +<td>#</td> +<td>ó</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&Oacute;</td> +<td>#</td> +<td>Ó</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&ocirc;</td> +<td>#</td> +<td>ô</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&Ocirc;</td> +<td>#</td> +<td>Ô</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&ograve;</td> +<td>#</td> +<td>ò</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&Ograve;</td> +<td>#</td> +<td>Ò</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&ordf;</td> +<td>#</td> +<td>ª</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&ordm;</td> +<td>#</td> +<td>º</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&oslash;</td> +<td>#</td> +<td>ø</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&Oslash;</td> +<td>#</td> +<td>Ø</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&otilde;</td> +<td>#</td> +<td>õ</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&Otilde;</td> +<td>#</td> +<td>Õ</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&ouml;</td> +<td>#</td> +<td>ö</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&Ouml;</td> +<td>#</td> +<td>Ö</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&para;</td> +<td>#</td> +<td>¶</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&pound;</td> +<td>&#163;</td> +<td>£</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&plusmn;</td> +<td>#</td> +<td>±</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&raquo;</td> +<td>#</td> +<td>»</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&reg;</td> +<td>#</td> +<td>®</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&sect;</td> +<td>#</td> +<td>§</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&shy;</td> +<td>#</td> +<td></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&sup1;</td> +<td>#</td> +<td>¹</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&sup2;</td> +<td>#</td> +<td>²</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&sup3;</td> +<td>#</td> +<td>³</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&szlig;</td> +<td>#</td> +<td>ß</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&thorn;</td> +<td>#</td> +<td>þ</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&THORN;</td> +<td>#</td> +<td>Þ</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&times;</td> +<td>#</td> +<td>×</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&uacute;</td> +<td>#</td> +<td>ú</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&Uacute;</td> +<td>#</td> +<td>Ú</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&ucirc;</td> +<td>#</td> +<td>û</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&Ucirc;</td> +<td>#</td> +<td>Û</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&ugrave;</td> +<td>#</td> +<td>ù</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&Ugrave;</td> +<td>#</td> +<td>Ù</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&uml;</td> +<td>#</td> +<td>¨</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&uuml;</td> +<td>#</td> +<td>ü</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&Uuml;</td> +<td>#</td> +<td>Ü</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&yacute;</td> +<td>#</td> +<td>ý</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&Yacute;</td> +<td>#</td> +<td>Ý</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&yen;</td> +<td>&#165;</td> +<td>¥</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +<tr> +<td>&yuml;</td> +<td>#</td> +<td>ÿ</td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td><b>✔</b></td> +<td> </td> +<td> </td> +<td> </td> +<td> </td> +<td>?</td> +<td> </td> +</tr> +</table> +<table class="fullwidth-table"> +<tbody><tr> +<th rowspan="2">Encja</td> +<p><th rowspan="2">Dziesiętny</td> +<th rowspan="2">Znak</td> +</p> +<th colspan="9" style="text-align:center"><a href="pl/RSS/Wersje">Wersje RSS</a></th> +</tr></tbody></table>{{ languages( { "en": "en/RSS/Entity", "fr": "fr/RSS/Entit\u00e9s" } ) }} diff --git a/files/pl/archive/rss/index.html b/files/pl/archive/rss/index.html new file mode 100644 index 0000000000..3a975b352a --- /dev/null +++ b/files/pl/archive/rss/index.html @@ -0,0 +1,18 @@ +--- +title: RSS +slug: Archive/RSS +tags: + - RSS + - Wszystkie_kategorie +translation_of: Archive/RSS +--- +<p><span>"Getting Started" box, if there is no "Getting Started" article yet written, should be populated with another feature article or tutorial, should one exist. Otherwise, just comment it out</span></p> +<div class="callout-box"><strong><a href="/pl/RSS/Na_początek" title="pl/RSS/Na_początek">Na początek</a></strong><br> +Kurs RSS-a dla początkujących.</div> +<p><strong>Really Simple Syndication (RSS)</strong> jest podobnym do <a href="/pl/HTML" title="pl/HTML">HTML</a>-a, bazowanym na <a href="/pl/XML" title="pl/XML">XML</a>-u formatem danych używanym syndykacji. RSS posiada złożoną historię oraz wiele różnych, niekompatybilnych <a href="/pl/RSS/Wersje" title="pl/RSS/Wersje">wersji</a>. (Niektóre bazowane na <a href="/pl/RDF" title="pl/RDF">RDF</a>-ie, ale większość bazowana na <a href="/pl/XML" title="pl/XML">XML</a>-u.) Mimo to, RSS jest niezwykle popularnym formatem używanym do syndykacji wiadomości, postów na blogach, w IPradio i IPTV.</p> +<table class="topicpage-table"> <tbody> <tr> <td> <h4 id="Dokumentacja"><a href="/Special:Tags?tag=RSS&language=pl" title="Special:Tags?tag=RSS&language=pl">Dokumentacja</a></h4> <p><span>; <a href="/pl/RSS/Artykuły/Why_RSS_Slash_is_Popular_-_Counting_Your_Comments">Why RSS Slash is Popular - Counting Your Comments</a>: <small>Charles Iliya Krempeaux talks about the RSS Slash Module, why it is popular among some, and how it is used to give a ''count'' for your comments.</small> ; <a href="/pl/RSS/Artykuły/Why_Well-Formed Web_RSS_Module_is_Popular_-_Syndicating_Your_Comments">Why Well-Formed Web RSS Module is Popular - Syndicating Your Comments</a>: <small>Charles Iliya Krempeaux talks about the RSS Well-Formed Web Module, why it is popular among some, and how it is used to link to your comments.</small></span></p> <dl> <dt><a class="external" href="http://diveintomark.org/archives/2004/02/04/incompatible-rss">Mit kompatybilności RSS</a></dt> <dd><small>Mark Pilgrim opowiada o brudnej historii RSS i wylicza poszczególne detale niezgodności pomiędzy poszczególnymi wersjami.</small></dd> </dl> <dl> <dt><a class="external" href="http://www.tbray.org/ongoing/When/200x/2005/07/27/Atomic-RSS">Atomic RSS</a></dt> <dd><small>Tim Bray opowiada o użyciu Atom 1.0 jako mikro formatu i rozszerzenia modułu RSS 2.0; Używaj nadal format syndykacji RSS 2.0, lecz rozpocznij używać elementów Atom 1.0.</small></dd> </dl> <p><br> <span><a href="/Special:Tags?tag=RSS&language=pl" title="Special:Tags?tag=RSS&language=pl">Pokaż wszystkie...</a></span></p> </td> <td> <h4 id="Spo.C5.82eczno.C5.9B.C4.87">Społeczność</h4> <ul> <li>Obejrzyj fora Mozilli...</li> </ul> <p>{{ DiscussionList("dev-tech-xml", "mozilla.dev.tech.xml") }}</p> <h4 id="Powi.C4.85zane_tematy">Powiązane tematy</h4> <dl> <dd><a href="/pl/RDF" title="pl/RDF">RDF</a>, <a href="/pl/XML" title="pl/XML">XML</a></dd> </dl> <p> </p> </td> </tr> </tbody> +</table> +<p><br> +<span>Interwiki Language Links</span></p> +<p> </p> +<p>{{ languages( { "en": "en/RSS", "es": "es/RSS", "fr": "fr/RSS", "it": "it/RSS", "ja": "ja/RSS", "ko": "ko/RSS", "pt": "pt/RSS" } ) }}</p> diff --git a/files/pl/archive/rss/moduły/index.html b/files/pl/archive/rss/moduły/index.html new file mode 100644 index 0000000000..2de3bdbedc --- /dev/null +++ b/files/pl/archive/rss/moduły/index.html @@ -0,0 +1,16 @@ +--- +title: Moduły +slug: Archive/RSS/Moduły +tags: + - RSS + - Wszystkie_kategorie +translation_of: Archive/RSS/Module +--- +<p> +</p> +<h2 id="Lista_modu.C5.82.C3.B3w_RSS" name="Lista_modu.C5.82.C3.B3w_RSS"> Lista modułów RSS </h2> +<p>Moduły RSS są mikroformatami włączonymi do dokumentu RSS poprzez użycie przestrzeni nazw <a href="pl/XML">XML</a>. Są one sposobem na rozszerzenie RSS. Poniżej znajduje się lista najpopularniejszych modułów RSS. +</p> +<table class="standard-table"> <tbody><tr> <th>Nazwa</th> <th>Przedrostek</th> <th>Status</th> <th>Data wydania</th> <th>Autor</th> </tr> <tr> <td><a href="pl/RSS/Modu%c5%82y/Atom">Atomic RSS</a></td> <td>atom</td> <td> </td><td>27 lipca 2005</td> <td>Tim Bray</td> </tr> <tr> <td><a href="pl/RSS/Modu%c5%82y/blogChannel">blogChannel</a></td> <td> </td><td> </td><td>17 września 2002</td> <td>Dave Winer</td> </tr> <tr> <td><a href="pl/RSS/Modu%c5%82y/Content">Content</a></td> <td>content</td> <td> </td><td> </td><td> </td></tr> <tr> <td><a href="pl/RSS/Modu%c5%82y/creativeCommons">creativeCommons</a></td> <td>cc</td> <td> </td><td>16 grudnia 2002</td> <td>Dave Winer</td> </tr> <tr> <td><a href="pl/RSS/Modu%c5%82y/Dublin_Core">Dublin Core</a></td> <td>dc</td> <td> </td><td> </td><td> </td></tr> <tr> <td><a href="pl/RSS/Modu%c5%82y/Slash">Slash</a></td> <td>slash</td> <td> </td><td> </td><td> </td></tr> <tr> <td><a href="pl/RSS/Modu%c5%82y/Well-Formed_Web">Well-Formed Web</a></td> <td>wfw</td> <td> </td><td> </td><td>Joe Gregorio i Chris Sells</td> </tr> +</tbody></table> +{{ languages( { "en": "en/RSS/Module" } ) }} diff --git a/files/pl/archive/rss/moduły/slash/elementy/index.html b/files/pl/archive/rss/moduły/slash/elementy/index.html new file mode 100644 index 0000000000..92ba6aabd3 --- /dev/null +++ b/files/pl/archive/rss/moduły/slash/elementy/index.html @@ -0,0 +1,85 @@ +--- +title: Elementy +slug: Archive/RSS/Moduły/Slash/Elementy +tags: + - Dokumentacje + - Junk + - RSS + - 'RSS:Dokumentacje' + - Strony_wymagające_dopracowania + - Wszystkie_kategorie +translation_of: Archive/RSS/Module/Slash/Element +--- +<h2 id="Elementy_RSS_modu.C5.82u_Slash" name="Elementy_RSS_modu.C5.82u_Slash">Elementy RSS modułu Slash</h2> + +<div class="note"> +<p><strong>Notatka</strong>: Na liście elementów poniżej przestrzeń nazw XML jest użyta jako prefiks <strong>slash</strong> (od <strong>it is a popular choice)</strong>. Kiedykolwiek, użyjemy przestrzeń nazw jako prefiksu <strong>slash</strong> <strong>as the XML Namespace prefix is NOT necessary</strong>. Pozostawiamy Ci wolny wybór swojego prefiksu.</p> +</div> + +<h3 id="A" name="A">A</h3> + +<h3 id="B" name="B">B</h3> + +<h3 id="C" name="C">C</h3> + +<ul> + <li><a href="pl/RSS/Modu%c5%82y/Slash/Elementy/comments"><slash:comments></a> (<a href="pl/RSS/Modu%c5%82y/Slash/Elementy/comments">RSS Slash Module Comments Element</a>)</li> +</ul> + +<h3 id="D" name="D">D</h3> + +<ul> + <li><a href="pl/RSS/Modu%c5%82y/Slash/Elementy/department"><slash:department></a> (<a href="pl/RSS/Modu%c5%82y/Slash/Elementy/department">Element Department modułu Slash RSS</a>)</li> +</ul> + +<h3 id="E" name="E">E</h3> + +<h3 id="F" name="F">F</h3> + +<h3 id="G" name="G">G</h3> + +<h3 id="H" name="H">H</h3> + +<ul> + <li><a href="pl/RSS/Modu%c5%82y/Slash/Elementy/hit_parade"><slash:hit_parade></a> (<a href="pl/RSS/Modu%c5%82y/Slash/Elementy/hit_parade">RSS Slash Hit Parade Department Element</a>)</li> +</ul> + +<h3 id="I" name="I">I</h3> + +<h3 id="J" name="J">J</h3> + +<h3 id="K" name="K">K</h3> + +<h3 id="L" name="L">L</h3> + +<h3 id="M" name="M">M</h3> + +<h3 id="N" name="N">N</h3> + +<h3 id="O" name="O">O</h3> + +<h3 id="P" name="P">P</h3> + +<h3 id="Q" name="Q">Q</h3> + +<h3 id="R" name="R">R</h3> + +<h3 id="S" name="S">S</h3> + +<ul> + <li><a href="pl/RSS/Modu%c5%82y/Slash/Elementy/section"><slash:section></a> (<a href="pl/RSS/Modu%c5%82y/Slash/Elementy/section">RSS Slash Module Section Element</a>)</li> +</ul> + +<h3 id="T" name="T">T</h3> + +<h3 id="U" name="U">U</h3> + +<h3 id="V" name="V">V</h3> + +<h3 id="W" name="W">W</h3> + +<h3 id="X" name="X">X</h3> + +<h3 id="Y" name="Y">Y</h3> + +<h3 id="Z" name="Z">Z</h3> diff --git a/files/pl/archive/rss/moduły/slash/index.html b/files/pl/archive/rss/moduły/slash/index.html new file mode 100644 index 0000000000..28730373ad --- /dev/null +++ b/files/pl/archive/rss/moduły/slash/index.html @@ -0,0 +1,70 @@ +--- +title: Slash +slug: Archive/RSS/Moduły/Slash +tags: + - RSS + - Wszystkie_kategorie +translation_of: Archive/RSS/Module/Slash +--- +<div class="callout-box"><b><a href="pl/RSS/Modu%c5%82y/Slash/Na_pocz%c4%85tek">Na początek</a></b><br> +<small>Przewodnik, który ma Ci pomóc w nauce modułu Slash RSS-a.</small></div> + +<p><b>RSS Slash Module</b> jest popularnym opartym na Slash blogu pomiędzy blogami imitując feel for Slashdot. Slash jest oparty na znanym silniku <a class="external" href="http://slashdot.org">Slashdot</a>.</p> + +<table class="topicpage-table"> + <tbody> + <tr> + <td> + <h4 id="Wybrane_artyku.C5.82y_UP_TO_10" name="Wybrane_artyku.C5.82y_UP_TO_10">Wybrane artykuły <span class="comment">UP TO 10</span></h4> + + <dl> + <dt><a href="pl/RSS/Artyku%c5%82y/Why_RSS_Slash_is_Popular_-_Counting_Your_Comments">Why RSS Slash is Popular: Counting Your Comments</a></dt> + <dd><small>Charles Iliya Krempeaux talks about the RSS Slash Module, why it is popular among some, and how it is used to give a + <i>count</i> + for your comments (2005-08-22).</small></dd> + </dl> + + <p> </p> + </td> + <td> + <h4 id="Referencje" name="Referencje">Referencje</h4> + + <ul> + <li><a href="pl/RSS/Modu%c5%82y/Slash/Elementy">Lista elementów Slash modułu RSS</a></li> + </ul> + + <h4 id="Przyk.C5.82ady" name="Przyk.C5.82ady">Przykłady</h4> + + <ul> + <li>brak</li> + </ul> + + <h4 id="Spo.C5.82eczno.C5.9B.C4.87" name="Spo.C5.82eczno.C5.9B.C4.87">Społeczność</h4> + + <ul> + <li>brak</li> + </ul> + + <h4 id="Narz.C4.99dzia" name="Narz.C4.99dzia">Narzędzia</h4> + + <ul> + <li>brak</li> + </ul> + + <h4 id="Inne_.C5.BAr.C3.B3d.C5.82a" name="Inne_.C5.BAr.C3.B3d.C5.82a">Inne źródła</h4> + + <ul> + <li><a class="external" href="http://purl.org/rss/1.0/modules/slash/">Moduł Slash RSS</a></li> + <li><a class="external" href="http://www.slashcode.com/">Slash</a></li> + <li><a class="external" href="http://slashdot.org/">Slashdot</a></li> + </ul> + + <h4 id="Podobne_tematy" name="Podobne_tematy">Podobne tematy</h4> + + <dl> + <dd><a href="pl/RSS">RSS</a>, <a href="pl/RDF">RDF</a>, <a href="pl/XML">XML</a></dd> + </dl> + </td> + </tr> + </tbody> +</table> diff --git a/files/pl/archive/rss/na_początek/czym_jest_rss/index.html b/files/pl/archive/rss/na_początek/czym_jest_rss/index.html new file mode 100644 index 0000000000..ee8785d49d --- /dev/null +++ b/files/pl/archive/rss/na_początek/czym_jest_rss/index.html @@ -0,0 +1,227 @@ +--- +title: Czym jest RSS +slug: Archive/RSS/Na_początek/Czym_jest_RSS +tags: + - 'RSS:Na_początek' +translation_of: Archive/RSS/Getting_Started/What_is_RSS +--- +<p> +</p><p>Strona ta wyjaśnia, czym jest RSS. Jeszcze nie teraz będziesz mógł utworzyć swój własny plik RSS, lecz na razie spójrz jak się go zazwyczaj wykorzystuje i obejrzyj przykłady plików najczęściej używanych. Przeczytaj także krótką historię rozwoju plików RSS. +</p> +<h3 id="Czym_jest_RSS.3F" name="Czym_jest_RSS.3F"> Czym jest RSS? </h3> +<p>Najbardziej popularną <a href="pl/RSS/Wersje">wersją RSS</a> są znaczniki <a href="pl/XML">XML</a> -języka używanego do syndykacji. (Chociaż istnieje format RSS opaty o <a href="pl/RDF">RDF</a>, to jest on wycofany <a href="pl/RSS/Wersje/0.90">RSS 0.90</a> i <a href="pl/RSS/Wersje/1.0">RSS 1.0</a>.) Zwykle używamy syndykacji RSS dla pobrania nagłówków nowości ze stron internetowych, blogów, IPradio, i z IPTV. +</p><p>Przewodnik ten uczy <a href="pl/RSS/Wersje/2.0">RSS 2.0</a>. Podejmuje on wysiłek nauki innych numerów <a href="pl/RSS/Wersje">wersji RSS</a>. +</p><p>RSS prawie nigdy nie był tworzony ręcznie, lecz zawsze za pomocą oprogramowania znajdującego się po stronie serwera (server side - często napisanego w językach takich jak PHP, Java, C# lub Python) umieszczonych na serwerze strony. Jednakże, podczas nauki RSS-a, będziemy tworzyć skrypty RSS ręcznie. +</p> +<h3 id="Kr.C3.B3tka_historia_RSS" name="Kr.C3.B3tka_historia_RSS"> Krótka historia RSS </h3> +<p>W marcu 1999 roku firma Netscape opublikowała <a href="pl/RSS/Wersje/0.90">RSS 0.90</a>. Był to o wiele, wiele inny RSS, niż ten dzisiejszy. Nie był on prawdziwym formatem syndykacji, ale był formatem, który dostarczał podsumowanie o stronie internetowej. Faktycznie nazwa RSS nie oznaczała <b>Really Simple Syndication</b> lecz w tym momencie miała znaczenie <b>Rich Site Summary</b>. +</p><p>W czerwcu 1999 opublikowano <a href="pl/RSS/Wersje/0.91/Netscape">Netscape RSS 0.91</a>. Podobnie jak <a href="pl/RSS/Wersje/0.90">RSS 0.90</a>, RSS 0.91 firmy Netscape było formatem dostarczającym podsumowanie strony, i nie było ono w pełni formatem syndykacji (jak jest to dziś). Netscape utworzył RSS 0.91 uprościć jeszcze poprzedni kanał. RSS 0.90 był oparty <a href="pl/RDF">RDF</a> (wiele założeń miało budowę zbyt skomplikowaną.) Firma Netscape oparła RSS 0.91 tylko na <a href="pl/XML">XML</a> i dodaniu <a href="pl/DTD">DTD</a> dopuszczając kilka encji (średnio znanych w <a href="pl/HTML">HTML</a>). +</p><p>W tym momencie Netscape wycofało oparty o <a href="pl/RDF">RDF</a>-a <a href="pl/RSS/Wersje/0.90">RSS 0.90</a> i narzuciło wszystkim używanie wersji <a href="pl/RSS/Wersje/0.91/Netscape">Netscape RSS 0.91</a>, która jest oparta na <a href="pl/XML">XML</a>. +</p><p>W czerwcu 2000 została opublikowana wersja <a href="pl/RSS/Wersje/0.91/Userland">Userland RSS 0.91</a>. (To znaczy, że istniały dwie różne wersje <a href="pl/RSS/Wersje/0.91">RSS 0.91</a>.) Różnica pomiędzy nimi, dwoma różnymi wersjami <a href="pl/RSS/Wersje/0.91">RSS 0.91</a> -- Firmy <a href="pl/RSS/Wersje/0.91/Netscape">Netscape RSS 0.91</a> i firmy <a href="pl/RSS/Wersje/0.91/Userland">Userland RSS 0.91</a> -- jest taka, że Userland RSS 0.91 nie posiada <a href="pl/DTD">DTD</a>, które posiada Netscape RSS 0.91; i nie zawiera w sobie dodatkowych encji, które ma Netscape RSS 0.91 (średnio znanych w <a href="pl/HTML">HTML</a>). Oprócz wspomianej różnicy, to są one identyczne. Technicznie mówiąc wersja firmy Userland RSS 0.91 jest podzbiorem wersji Netscape RSS 0.91. +</p><p>W grudniu 2000 grupa robocza RSS-DEV opublikowała <a href="pl/RSS/Wersje/1.0">RSS 1.0</a>. Ta wersja RSS była niedługo całkowicie oparta na <a href="pl/XML">XML</a>, ale oparto ją też na <a href="pl/RDF">RDF</a> (jak oryginalna, lecz już wycofana <a href="pl/RSS/Wersje/0.90">RSS 0.90</a>).Grupa robocza RSS-DEV zmieniła to, że to, co obsługiwało RSS, pozostało i stało się <b>RDF Site Summary</b>. (Ostatecznie to jest to, co zostało umieszczone w tej wersji RSS.) +</p><p>W jednym momencie mieliśmy <a href="pl/RSS/Wersje/0.91/Netscape">Netscape RSS 0.91</a>, <a href="pl/RSS/Wersje/0.91/Userland">Userland RSS 0.91</a>, i wersję opracowaną przez grupę roboczą RSS-DEV <a href="pl/RSS/Wersje/1.0">RSS 1.0</a>. +</p><p>Jeszcze tego samego miesiąca Userland opublikował <a href="pl/RSS/Wersje/0.92">RSS 0.92</a>. RSS 0.92 was meant to replace <a href="pl/RSS/Wersje/0.91/Userland">Userland RSS 0.91</a>. (<b>If you notice though, the RSS versioning number got all messed up at this point. RSS 0.92 jest newer than</b> <a href="pl/RSS/Wersje/1.0">RSS 1.0</a>.) +</p><p>W tym momecie mieliśmy wersje RSS-a; <a href="pl/RSS/Wersje/0.91/Netscape">Netscape RSS 0.91</a>, wersje grupy roboczej RSS-DEV, czyli <a href="pl/RSS/Wersje/1.0">RSS 1.0</a>, i Userland <a href="pl/RSS/Wersje/0.92">RSS 0.92</a>. +</p><p>W kwietniu 2001 Userland opublikował draft wersji <a href="pl/RSS/Wersje/0.93">RSS 0.93</a>. Ta wersja RSS nigdy nie została ukończona i została wydana jedynie jako draft i nigdy nie stała się się wersją, która zastąpiłaby wersję firmy Userland <a href="pl/RSS/Wersje/0.92">RSS 0.92</a>. +</p><p>W sierpniu 2002 Userland opublikował <b>draft?</b> wersji <a href="pl/RSS/Wersje/0.94">RSS 0.94</a>. Wersja <a href="pl/RSS/Wersje/0.93">RSS 0.93</a>, nigdy nie została ukończona i została wydana jedynie jako draft i nigdy nie stała się wersją, która zastąpiłaby wersję firmy Userland <a href="pl/RSS/Wersje/0.92">RSS 0.92</a>. +</p><p>W tym momencie <em>wciąż</em> mieliśmy <a href="pl/RSS/Wersje/0.91/Netscape">Netscape RSS 0.91</a>, wersję grupy roboczej RSS-DEV <a href="pl/RSS/Wersje/1.0">RSS 1.0</a>, i wersje Userland <a href="pl/RSS/Wersje/0.92">RSS 0.92</a>. (Pomimo, że niektórzy używali <a href="pl/RSS/Wersje/0.93">RSS 0.93</a> i <a href="pl/RSS/Wersje/0.94">RSS 0.94</a> pomimo tego, że nie były one wspierane). +</p><p>We wrześniu 2002 Userland opublikował <a href="pl/RSS/Wersje/2.0">RSS 2.0</a>. RSS 2.0 miało być wersją która zastąpi <a href="pl/RSS/Wersje/0.92">RSS 0.92</a> (drafty <a href="pl/RSS/Wersje/0.93">RSS 0.93</a> i <a href="pl/RSS/Wersje/0.94">RSS 0.94</a> nie były wspierane). Userland postanowiło użyć takiego numeru wersji <b>2.0</b>, ponieważ grupa robocza RSS-DEV w tym czasie wydała wersje <b>1.0</b> opartą na <a href="pl/RDF">RDF</a> <a href="pl/RSS/Wersje/1.0">RSS 1.0</a>. +</p><p>W tym momencie mieliśmy dostępne wersje: <a href="pl/RSS/Wersje/0.91/Netscape">Netscape RSS 0.91</a>, wersje grupy roboczej RSS-DEV <a href="pl/RSS/Wersje/1.0">RSS 1.0</a> i firmy Userland <a href="pl/RSS/Wersje/2.0">RSS 2.0</a>. +</p><p>Historia ta nie ma krótkiego końca. Raz w listopadzie 2002 i jeszcze raz w styczniu 2003 roku, specyfikacja <a href="pl/RSS/Wersja/2.0">RSS 2.0</a> została zmieniona przez firmę Userland. Poprzez wprowadzenie wszystkich zmian w porównaniu do poprzednich wersji, została wprowadzona nazwa RSS 2.0 dla elementów <a href="pl/RSS/Elementy/rss"><rss></a>. +</p><p>Aktualnie, na dzisiejszy dzień, wciąż mamy wersję <a href="pl/RSS/Wersje/0.91/Netscape">Netscape's RSS 0.91</a> (Netscape nigdy jej nie wycofał), lecz jest on znikomo używany. Bardziej popularną wersją opartą także na <a href="pl/RDF">RDF</a> <a href="pl/RSS/Wersja/1.0">RSS 1.0</a> lub opartą o <a href="pl/XML">XML</a> <a href="pl/RSS/Wersja/2.0">RSS 2.0</a>. Opartą o XML jest RSS 2.0, która jest najbardziej popularną wersją. (Ten kurs pokazuje zastosowanie <a href="pl/RSS/Wersje/2.0">RSS 2.0</a>). +</p> +<h3 id="Jak_u.C5.BCywamy_RSS_dzisiaj" name="Jak_u.C5.BCywamy_RSS_dzisiaj"> Jak używamy RSS dzisiaj </h3> +<p>Dziś, RSS jest najczęściej wykorzystywany do syndykacji. Syndykacja jest to proces mówiący innym, że zostało umieszczona nowa zawartość np. tekstu do przeczytania. Innymi słowami: kiedy używasz syndykacji, mówisz wszystkim mniej więcej coś takiego: "Cześć wszystkim. Mam napisany artykuł, który chce abyście przeczytali po wejściu na moją stronę. Wystarczy tylko zasubskrybować mój kanał RSS i mieli zawsze możliwość pobrania najnowszych nagłówków moich artykułów". +</p> +<div class="note"> +<p><b>Uwaga</b>: Jeśli dostarczasz kanał RSS nie zabezpieczony hasłem, to bez żadnych zastrzeżeń dajesz wszystkim dostęp do zawartości kanału RSS w prawie każdej postaci jak użytkownicy chcą go przeglądać. Użytkownik może go czytać. Może utworzyć jego lokalną kopię. Może dzielić localną kopię z innym użytkownikiem. Może także używać go na innej stronie internetowej. Może on nawet <b>re-syndicated it</b>, i wiele więcej. +</p><p>Jeśli nie chcesz, aby którykolwiek z powyższych przypadków był wykonany, to nie twórz kanału RSS niezabezpieczonego hasłem (Oczywiście nie twórz publicznego hasła.) +</p> +</div> +<p>Nowości ze stron internetowych używają kanału RSS do dostarczenia każdemu, kto się wpisał na listę najnowszych artykułów. Na przykład: +</p> +<pre class="eval"> <span class="nowiki"> + <?xml version="1.0"?> + + <rss version="2.0"> + + <channel> + <title>Example News Site</title> + <description>This is an Example News Site.</description> + <lastBuildDate>Wed, 27 Jul 2005 00:30:30 -0700</lastBuildDate> + <link>http://news.example.com/</link> + + <item> + <title>News Flash: I Like Bread</title> + <guid>4d4a0a12-f188-4c97-908b-eea27213c2fe</guid> + <pubDate>Wed, 27 Jul 2005 00:30:30 -0700</pubDate> + <link>http://news.example.com/artcle/554</link> + </item> + <item> + <title>Big News Today: Birds Fly</title> + <guid>c4a63f09-b45b-466b-8773-6ff264001ab7</guid> + <pubDate>Tue, 19 Jul 2005 04:32:51 -0700</pubDate> + <link>http://news.example.com/artcle/553</link> + </item> + <item> + <title>Fire is Hot</title> + <guid>c1795324-d5ea-44fa-95b1-b5ce2090d4f1</guid> + <pubDate>Sun, 15 May 2005 13:02:08 -0700</pubDate> + <link>http://news.example.com/artcle/552</link> + </item> + </channel> + + </rss> + </span> +</pre> +<p>Osoby prowadzące własnego bloga używają RSS, aby dostarczać każdemu, kto znajduje się na ich liście służącej do powiadomienia o najnowszym zamieszczonym poście. Na przykład: </p> +<pre class="eval"> <span class="nowiki"> + <?xml version="1.0"?> + + <rss version="2.0"> + + <channel> + <title>Joe Blow's Blog</title> + <description>This is the Weblog of Joe Blow</description> + <lastBuildDate>Sun, 15 May 2005 13:02:08 -0500</lastBuildDate> + <link>http://joe-blow.example.net/</link> + + <item> + <title>I Be Blogging...</title> + <guid>http://joe-blow.example.net/log/21</guid> + <pubDate>Sun, 15 May 2005 13:02:08 -0500</pubDate> + <link>http://joe-blow.example.net/log/21</link> + </item> + <item> + <title>I am so SMRT</title> + <guid>http://joe-blow.example.net/log/20</guid> + <pubDate>Sat, 14 May 2005 22:19:18 -0500</pubDate> + <link>http://joe-blow.example.net/log/20</link> + </item> + <item> + <title>Huh?</title> + <guid>http://joe-blow.example.net/log/19</guid> + <pubDate>Sat, 14 May 2005 09:55:59 -0500</pubDate> + <link>http://joe-blow.example.net/log/19</link> + </item> + <item> + <title>Black Cat Spotted</title> + <guid>http://joe-blow.example.net/log/18</guid> + <pubDate>Fri, 13 May 2005 13:13:13 -0500</pubDate> + <link>http://joe-blow.example.net/log/18</link> + </item> + </channel> + + </rss> + </span> +</pre> +<p>Ci, co tworzą IPradio pozwalając używać RSS do transmisji ich przedstawienia. Na przykład: </p> +<pre class="eval"> <span class="nowiki"> + <?xml version="1.0"?> + + <rss version="2.0"> + + <channel> + <title>Joe's IPradio Show</title> + <description>The best IPradio Show on the Internet, staring Joe!</description> + <lastBuildDate>Mon, 15 Aug 2005 16:12:37 -0400</lastBuildDate> + <link>http://joe.ipradio.example.net/</link> + + <item> + <title>I C UR Tan Line</title> + <guid>http://joe.ipradio.example.net/show/55</guid> + <pubDate>Mon, 15 Aug 2005 16:11:57 -0400</pubDate> + <enclosure url="http://joe.ipradio.example.net/show/55" + length="4487216" + type="application/ogg" + /> + </item> + <item> + <title>Car Care for Car Fanatics</title> + <guid>http://joe.ipradio.example.net/show/54</guid> + <pubDate>Mon, 8 Aug 2005 13:12:12 -0400</pubDate> + <enclosure url="http://joe.ipradio.example.net/show/54" + length="4892178" + type="audio/x-mp3" + /> + </item> + <item> + <title>Best Beaches in BC</title> + <guid>http://joe.ipradio.example.net/show/53</guid> + <pubDate>Mon, 1 Aug 2005 18:22:14 -0400</pubDate> + <enclosure url="http://joe.ipradio.example.net/show/53" + length="3984215" + type="application/ogg" + /> + </item> + </channel> + + </rss> + </span> +</pre> +<div class="note"> +<p><b>Uwaga</b>: Transmisja radia Internetowego jest czasami nazywana <em>Podcasting</em>, <em>IPradio</em>, i <em>Audio Blogging</em>. +</p> +</div> +<p>Ten, kto tworzy Internetową telewizję stosuje RSS pozwalając pokazywać użytkownikom co jest transmitowane. Na przykład: +</p> +<pre class="eval"> <span class="nowiki"> + <?xml version="1.0"?> + + <rss version="2.0"> + + <channel> + <title>Kate's IPTV Show</title> + <description>Watch it or else! You know you want to.</description> + <lastBuildDate>Tue, 23 Aug 2005 21:02:05 -0800</lastBuildDate> + <link>http://katetv.example.com/</link> + + <item> + <title>This is Fun</title> + <guid>http://katetv.example.com/show/4</guid> + <pubDate>Tue, 23 Aug 2005 21:02:05 -0800</pubDate> + <enclosure url="http://katetv.example.com/show/4" + length="1911146" + type="application/ogg" + /> + </item> + <item> + <title>Watch This</title> + <guid>http://katetv.example.com/show/3</guid> + <pubDate>Tue, 16 Aug 2005 16:11:57 -0400</pubDate> + <enclosure url="http://katetv.example.com/show/3" + length="1387442" + type="application/ogg" + /> + </item> + <item> + <title>It is me again</title> + <guid>http://katetv.example.com/show/2</guid> + <pubDate>Tue, 9 Aug 2005 13:12:12 -0400</pubDate> + <enclosure url="http://katetv.example.com/show/2" + length="1894877" + type="video/mpeg" + /> + </item> + <item> + <title>Hello</title> + <guid>http://katetv.example.com/show/1</guid> + <pubDate>Tue, 2 Aug 2005 18:22:14 -0400</pubDate> + <enclosure url="http://katetv.example.com/show/1" + length="17442215" + type="application/ogg" + /> + </item> + </channel> + + </rss> + </span> +</pre> +<p>Przezorny czytnik może powiadomić, że przykłady <i>strona internetowa z nowościami</i> i <i>blogger</i> są tego samego typu RSS i także przykłady <i>radio internetowe</i> i <i>telewizja internetowa</i> są tego samego typu RSS. Faktycznie, prawdziwą różnicą pomiędzy newsami/blogami zawierającymi kanały RSS i tymi zawierającymi RSS kanałami radio/telewizja internetowa,jest taka, że kanały RSS nowości/blogi używają elementu <a href="pl/RSS/Elementy/link"><link></a> i internetowe radio/telewizja używają elementu RSS <a href="pl/RSS/Elementy/enclosure"><enclosure></a>. +</p> +<div class="note"> +<p><b>Uwaga</b>: Te przykłady RSS są bardzo, bardzo proste, i zostały zaprojektowane tylko dla pokazania przykładów RSS, jak one wyglądają. Wszystkie przykłady RSS są minimimalne. Kiedy będziesz tworzył swój własny kanał RSS, będziesz chciał zrobić bardziej złożony i zawierający dodatkowe <a href="pl/RSS/Elementy">elementy RSS</a> oraz zawierający rozmaite <a href="pl/RSS/Modu%c5%82y">moduły RSS</a>. +</p> +</div> +<p>{{ Next("RSS:Na początek:Dlaczego używamy RSS") }} +</p>{{ languages( { "en": "en/RSS/Getting_Started/What_is_RSS", "fr": "fr/RSS/Premiers_pas/Pr\u00e9sentation_de_RSS" } ) }} diff --git a/files/pl/archive/rss/na_początek/dlaczego_używamy_rss/index.html b/files/pl/archive/rss/na_początek/dlaczego_używamy_rss/index.html new file mode 100644 index 0000000000..0a19b5c5d2 --- /dev/null +++ b/files/pl/archive/rss/na_początek/dlaczego_używamy_rss/index.html @@ -0,0 +1,22 @@ +--- +title: Dlaczego używamy RSS +slug: Archive/RSS/Na_początek/Dlaczego_używamy_RSS +tags: + - RSS + - 'RSS:Na_początek' + - Wszystkie_kategorie +translation_of: Archive/RSS/Getting_Started/Why_use_RSS +--- +<p> +</p><p>Strona ta wyjaśnia, dlaczego możesz chcieć użyć RSS. W tym artykule jeszcze nie pokażemy w jaki sposób tworzyć własne pliki RSS, ale powiemy Ci, dlaczego warto go użyć. </p> +<h3 id="Dlaczego_u.C5.BCywamy_RSS.3F" name="Dlaczego_u.C5.BCywamy_RSS.3F"> Dlaczego używamy RSS? </h3> +<p>Jeśli czytasz ten tekst, prawdopodobnie masz już swój powód, dla którego chcesz użyć RSS. Tak naprawdę jest wiele przyczyn, które przemawiają za użyciem RSS. Ale (najogólniej mówiąc) decydują o tym dwie największe przyczyny: 1: (oczywiście używamy tylko gdy) zaspokaja nasze potrzeby +2: posiada on ogromną siłę rozpędu - używają go już wszyscy. +</p><p>RSS ma ogromną siłę rozpędu. Ludzie używają go do syndykacji różnych rzeczy. Nowe artykuły, blogi, zakładki, radio internetowe, internetowa telewizja, aktualizacje oprogramowania, e-maile, listy mailingowe, muzyczne playlisty i wiele więcej. Jeśli jest wyświetlane co jakiś czas, to możesz być syndykowane za pomocą RSS. </p><p>Oprogramowanie, które potrafi czytać i wyświetlać RSS, jest niemal wszędzie. Mozilla Firefox obsługuje RSS (wspiera RSS poprzez technologię "dynamicznych zakładek" - Live Bookmark). Jest tak wiele agregatorów RSS, że trudno je zliczyć. Również różne oprogramowanie używa RSS. +</p> +<h3 id="Agregatory_RSS_s.C4.85_wsz.C4.99dzie" name="Agregatory_RSS_s.C4.85_wsz.C4.99dzie"> Agregatory RSS są wszędzie </h3> +<p>Jednym z powodów używania RSS do syndykacji jest mnogość agregatorów RSS +(zbyt wiele, by je wszystkie spisać). Jeśli używasz syndykacji z pomocą RSS, wtedy wszystkie te agregatory RSS mogą używać oraz odczytywać twoje wątki RSS. +</p><p><br> +{{ PreviousNext("RSS:Na początek:Czym jest RSS", "RSS:Na początek:Jak działa RSS") }} +</p>{{ languages( { "fr": "fr/RSS/Premiers_pas/Pourquoi_utiliser_RSS", "en": "en/RSS/Getting_Started/Why_use_RSS" } ) }} diff --git a/files/pl/archive/rss/na_początek/index.html b/files/pl/archive/rss/na_początek/index.html new file mode 100644 index 0000000000..fca98e0922 --- /dev/null +++ b/files/pl/archive/rss/na_początek/index.html @@ -0,0 +1,54 @@ +--- +title: Na początek +slug: Archive/RSS/Na_początek +tags: + - RSS + - 'RSS:Na_początek' + - Wszystkie_kategorie +translation_of: Archive/RSS/Getting_Started +--- +<p> +</p> +<h3 id="Wprowadzenie" name="Wprowadzenie"> Wprowadzenie </h3> +<p>Przewodnik ten jest wprowadzeniem do <b>Really Simple Syndication</b> (<b>RSS</b>). +</p><p>Przeprowadzi Cię on krok po kroku przez podstawy RSS i zaprezentuje przykłady w akcji. W tym przewodniku zastosowana została znana mantra, mówiąca że "najlepszym sposobem nauki jest zrobienie czegoś". Z tego powodu będziesz sam tworzył pliki RSS. </p> +<h4 id="Kto_powinien_skorzysta.C4.87_z_przewodnika.3F" name="Kto_powinien_skorzysta.C4.87_z_przewodnika.3F"> Kto powinien skorzystać z przewodnika? </h4> +<p>Ten przewodnik jest w większości przeznaczony dla osób zaczynających naukę RSS (to znaczy osób, które nie miały lub mają nieznaczne doświadczenie w RSS). Jednak również osoby doświadczone mogą uznać ten przewodnik za pomocny, gdyż może on im pomóc uzupełnić ich informacje o RSS lub posłużyć jako przypomnienie. +</p><p>Ten przewodnik zakłada, że masz jakiekolwiek doświadczenie z <a href="pl/HTML">HTML</a> (lub <a href="pl/XML">XML</a>) i jesteś obyty z podstawowymi <i>znacznikami</i>. Inaczej ujmując, kod taki jak poniżej nie sprawia Ci problemów: +</p> +<pre class="eval"> To jest z kod ze znacznikami <b>pogrubienia</b>. +</pre> +<p>Jeśli opanowałeś dostatecznie znaczniki, nie powinnieneś mieć problemu z nauką RSS. +</p> +<div class="note"> +<p><b>Uwaga</b>: Jeśli NIE jesteś projektantem stron i NIE chcesz się nim stać, to ten przewodnik NIE jest dla Ciebie. Musisz swobodnie się poruszać w kwestii używania <i>znaczników</i>, takich jak w przykładzie powyżej, by efektywnie skorzystać z tego przewodnika. +</p> +</div> +<h4 id="Co_jest_potrzebne_przed_rozpocz.C4.99cie_pracy.3F" name="Co_jest_potrzebne_przed_rozpocz.C4.99cie_pracy.3F"> Co jest potrzebne przed rozpoczęcie pracy? </h4> +<p>Aby opanować większość tematów z tego przewodnika, będziesz potrzebować edytora tekstu i czytnika RSS. Musisz także wiedzieć, jak się nimi posługiwać. +</p> +<div class="note"> +<p><b>Uwaga</b>: Edytor tekstu nie jest tym samym, co edytor tekstowy. Upewnij się za każdym razem, że zapisujesz pliki RSS w zwykłym formacie tekstowym. +</p> +</div> +<p>Nie jest wymagane, aby tworzyć pliki RSS opisane w tym przewodniku (możesz go czytać), jednak jest to mniej efektywny sposób nauki. Zachowasz i wchłoniesz więcej informacji, jeśli będziesz tworzyć własne pliki RSS razem z tym przewodnikiem. +</p> +<h4 id="Jak_nale.C5.BCy_korzysta.C4.87_z_przewodnika" name="Jak_nale.C5.BCy_korzysta.C4.87_z_przewodnika"> Jak należy korzystać z przewodnika </h4> +<p>Pomimo iż każda strona jest napisana tak, aby mogła funkcjonować jako samodzielny przewodnik, to każda z nich zakłada, że posiadasz wiedzę zdobytą na poprzednich stronach tego przewodnika. Mimo że możesz przejść do wybranego przez Ciebie miejsca przewodnika, zalecamy aby początkujący przeczytali ten przewodnik we właściwej kolejności. +</p> +<h3 id="Przewodnik" name="Przewodnik"> Przewodnik </h3> +<ol><li><b><a href="pl/RSS/Na_pocz%c4%85tek/Czym_jest_RSS">Czym jest RSS</a></b> +</li><li><b><a href="pl/RSS/Na_pocz%c4%85tek/Dlaczego_u%c5%bcywamy_RSS">Dlaczego używamy RSS</a></b> +</li><li><b><a href="pl/RSS/Na_pocz%c4%85tek/Jak_dzia%c5%82a_RSS">Jak działa RSS</a></b> +</li><li><b><a href="pl/RSS/Na_pocz%c4%85tek/Hello_World">Hello World</a></b> +</li><li><b><a href="pl/RSS/Na_pocz%c4%85tek/Syndykacja">Syndykacja</a></b> +</li><li><b><a href="pl/RSS/Na_pocz%c4%85tek/Blogi">Blogi</a></b> +</li><li><b><a href="pl/RSS/Na_pocz%c4%85tek/Transfer_danych">Transfer danych</a></b> +</li><li><b><a href="pl/RSS/Na_pocz%c4%85tek/Mikroformaty">Mikroformaty</a></b> +</li><li><b><a href="pl/RSS/Na_pocz%c4%85tek/Zaawansowany_transfer_danych">Zaawansowany transfer danych</a></b> +</li></ol> +<p><br> +</p> +<div class="noinclude"> +</div> +{{ languages( { "en": "en/RSS/Getting_Started", "es": "es/RSS/Primeros_pasos", "fr": "fr/RSS/Premiers_pas", "ja": "ja/RSS/Getting_Started" } ) }} diff --git a/files/pl/archive/rss/na_początek/jak_działa_rss/index.html b/files/pl/archive/rss/na_początek/jak_działa_rss/index.html new file mode 100644 index 0000000000..b2f083d1ba --- /dev/null +++ b/files/pl/archive/rss/na_początek/jak_działa_rss/index.html @@ -0,0 +1,16 @@ +--- +title: Jak działa RSS +slug: Archive/RSS/Na_początek/Jak_działa_RSS +tags: + - RSS + - 'RSS:Na_początek' + - Wszystkie_kategorie +translation_of: Archive/RSS/Getting_Started/How_RSS_Works +--- +<p> +</p><p>Strona ta, ma za zadanie wyjaśnienia nam jak działa RSS. Jeszcze teraz nie będziemy tworzyć własnego pliku RSS, lecz nauczymy się jak różne systemy służą do odczytu nagłówków wiadomości RSS. </p> +<h3 id="Jak_dzia.C5.82a_RSS" name="Jak_dzia.C5.82a_RSS"> Jak działa RSS </h3> +<p>Do pobrania nagłówków wiadomości RSS, dwa warunki muszą być spełnione: musi być <i>serwer</i> wysyłający i czytnik, który odczyta kanał. </p><p>Końcowym <i>serwerem</i> przesyłania nagłówków RSS jest część systemu, która tworzy kanał RSS. Strona nowości byłaby końcem <i>serwera</i>, gdzie można pobrać nagłówki wiadomości RSS. Blog byłby na serwerze końcem syndykacji RSS. IPradio wyświetla ostatnie nagłówki RSS wysłane z <i>serwera</i>. IPTV wyświetla ostatnie nagłówki RSS wysłane z <i>serwera</i> +</p><p>Końcowy <i>klient</i> przesyłania nagłówków kanału RSS, jest to taka część, która wczytuje kanał RSS (czytnik). Przeglądarka Mozilla Firefox jest takim czytnikiem, czyli końcowym <i>klientem</i> do pobrania kanału RSS. Panel RSS powinien być wbudowany w czytnik RSS. Agregator RSS opart na stronie będzie po stronie <i>klienta</i> syndykacji RSS. +</p><p>{{ PreviousNext("RSS:Na początek:Dlaczego używamy RSS", "RSS:Na początek:Hello World") }} +</p>{{ languages( { "fr": "fr/RSS/Premiers_pas/Fonctionnement_de_RSS", "en": "en/RSS/Getting_Started/How_RSS_Works" } ) }} diff --git a/files/pl/archive/rss/na_początek/syndykacja/index.html b/files/pl/archive/rss/na_początek/syndykacja/index.html new file mode 100644 index 0000000000..fcd6b45d6f --- /dev/null +++ b/files/pl/archive/rss/na_początek/syndykacja/index.html @@ -0,0 +1,76 @@ +--- +title: Syndykacja +slug: Archive/RSS/Na_początek/Syndykacja +tags: + - RSS + - 'RSS:Na_początek' + - Wszystkie_kategorie +translation_of: Archive/RSS/Getting_Started/Syndicating +--- +<p> +</p><p>Strona ta wyjaśnia syndykacje strony z RSS. Dowiesz się jak zrobić, aby użytkownicy i maszyny mogły znaleźć Twój kanał RSS. </p> +<h3 id="Czym_jest_syndykacja" name="Czym_jest_syndykacja"> Czym jest syndykacja </h3> +<p><strong>Syndykacją</strong> (lub <strong>Syndykacją strony</strong>) jest moment utworzenia zawartości/treści dostępnej dla wszystkich, którzy chcą czytać, słuchać lub pooglądać nagłówki nowości. </p><p>RSS pomaga w syndykacji. RSS zorganizuje Twoją syndykacją do takiej formy, która zostanie w bardzo prosty sposób zrozumiana przez maszynę. </p><p>Syndykacja z RSS znaczy 3 rzeczy. +</p> +<ol><li> Utworzenie kanału RSS. +</li><li> Dodaj specjalny element <code><a href="pl/HTML/Element/link"><link></a></code> do kodu strony HTML. +</li><li> Dodaj specjalny element <code><a href="pl/HTML/Element/a"><a></a></code> do kodu strony HTML. +</li></ol> +<p>Do tej pory omówiliśmy punkt 1 -- Utworzenie kanału RSS -- więc skupimy się teraz na 2 i 3 punkcie. +</p> +<h3 id="Dodajemy_.3Clink.3E" name="Dodajemy_.3Clink.3E"> Dodajemy <code><link></code> </h3> +<p>Często dane kanału RSS są również udostępniane na stronie HTML. W tym przypadku strona ta pozwala zarówno ludziom jak i maszynom na pobranie kanału za pomocą następującego kodu. +</p> +<pre><link rel="alternate" type="application/rss+xml" href="http://example.com/feed" /> +</pre> +<p>Często ludzie chcą ogłaszać poprzez kanał RSS swoich twór (na przykład notki bloga). Można to zrobić w sposób następujący. +</p> +<pre><link rel="home" type="application/rss+xml" href="http://example.com/feed" /> +</pre> +<p>Zauważ, że kod ten wygląda prawie tak samo jak poprzedni. Jedyna różnicą jest wartość atrybutu <code>rel</code> (poprzedni link posiada wartość atrybutu <code>rel</code> równą <code><b>alternate</b></code>. Powyższy atrybut <code><b>rel</b></code> posiada wartość <code><b>home</b></code>). +</p> +<div class="note"> +<p><b>Uwaga</b>: Zdarzały się nadużycia elementu <code><link></code> dla syndykacji RSS. Niektórzy blogerzy chcieli by inni mogli <em>subskrybować</em> ich blogi z jakiejkolwiek podstrony (a nie tylko z ich <em>strony domowej</em>). Powodowało to dodawanie wszędzie wielu elementów <code><link></code>, gdzie atrybut <code>rel="alternate"</code>. (Również we wpisach bloga, a nie tylko na <em>stronie domowej</em>.) Jest to niepoprawne! Używanie w tym przypadku przypisania <code>rel="alternate"</code> jest błędne. Powinno być przypisanie <code>rel="home"</code>. (Zobacz również artykuł <a href="pl/Understanding_rel_and_rev">Understanding rel and rev</a>). Ważną częścią używania elementu <code><link></code> do syndykacji kanału RSS jest wykorzystanie przypisania <code>type="application/rss+xml"</code>. +</p> +</div> +<h3 id="Dodajemy_.3Ca.3E" name="Dodajemy_.3Ca.3E"> Dodajemy <code><a></code> </h3> +<p>Kiedy używamy kodu HTML element <code><b><link></b></code> jest przeważnie <em>ukryty</em>. W celu przedstawienia kanału RSS w sposób bardziej bezpośredni można używać elementu <code><b><a></b></code> wykorzystując podobieństwo z elementem <code><b><link></b></code> opisanym powyżej. +</p><p>Dla stworzenia odnośnika do strony HTML, na której dostępny jest również kanał RSS użyj: +</p> +<pre><a rel="alternate" type="application/rss+xml" href="http://example.com/feed">...</a> +</pre> +<p>Dla stworzenia odnośnika do wpisu na blogu użyj: +</p> +<pre><a rel="home" type="application/rss+xml" href="http://example.com/feed">...</a> +</pre> +<p>Zauważ, że powyższy kod jest prawie identyczny. Różni się tylko wartością atrybutu <code><b>rel</b></code>. (W poprzednim kodzie wartość atrybutu <code><b>rel</b></code> równa jest <code><b>alternate</b></code>. Natomiast w tym wartosc ta wynosi <code><b>home</b></code>.) +</p> +<h3 id="Ikona_kana.C5.82u" name="Ikona_kana.C5.82u"> Ikona kanału </h3> +<p>Kanały RSS (i inne) używają specjalnej ikonki. Zalecane jest, abyś podczas tworzenia specjalnego linku <code><a></code> użył tej ikony do własnego kanału. Ikona wygląda następująco: </p> +<dl><dd><img alt="Grafika:Feed-icon-32x32.png"> +</dd></dl> +<p>Ze <a class="external" href="http://feedicons.com/">strony</a>, można pobrać o wiele więcej ikonek kanału RSS (są dostępne w innych rozmiarach i kolorach. Dostępne są także źródła plików). +</p> +<h3 id="Zaawansowane_techniki_syndykacji" name="Zaawansowane_techniki_syndykacji"> Zaawansowane techniki syndykacji </h3> +<p>Pomimo, że zaawansowane techniki syndykacji nie są konieczne, ich wsparcie jest zalecane; zwłaszcza dla stron i aplikacji wymagających dużych wydajności. +Protokół <a href="pl/HTTP">HTTP</a> -- jeden z podstawowych technologii sieciowych -- dostarczający metodę prioretyzacji treści, jaka klient HTTP preferuje otrzymywać. Ta technika wykorzystuje <em>preferowanie</em> syndykacji RSS przez klienta (niż HTML lub inne formaty). Poniżej przedstawiamy przykład. +</p> +<pre>Accept: application/rss+xml, text/html +</pre> +<p>Jednakże w oprogramowaniu może to wyglądać następująco: +</p> +<pre>Accept: application/rss+xml, application/xhtml+xml, text/html +</pre> +<p>Tutaj znajduje się więcej w pełni gotowych przykładów: +</p> +<pre>GET / HTTP/1.1 +Host: example.com +Accept: application/rss+xml, application/xhtml+xml, text/html +</pre> +<p>Po otrzymaniu tego przez serwer HTTP powinno nastąpić przekierowanie klienta HTTP do kanału RSS za pomocą <code>HTTP 302 Found</code>. Podobnie do: +</p> +<pre>HTTP/1.1 302 Found +Location: http://example.com/feed +</pre> +<p>{{ PreviousNext("RSS:Na początek:Hello World", "RSS:Na początek:Blogi") }} +</p>{{ languages( { "en": "en/RSS/Getting_Started/Syndicating", "fr": "fr/RSS/Premiers_pas/Syndication" } ) }} diff --git a/files/pl/archive/rss/wersje/0.90/index.html b/files/pl/archive/rss/wersje/0.90/index.html new file mode 100644 index 0000000000..41a0757a63 --- /dev/null +++ b/files/pl/archive/rss/wersje/0.90/index.html @@ -0,0 +1,85 @@ +--- +title: '0.90' +slug: Archive/RSS/Wersje/0.90 +tags: + - RSS + - Wszystkie_kategorie +translation_of: Archive/RSS/Version/0.90 +--- +<p> +</p><p>{{ Deprecated_header() }} +</p> +<h2 id="RSS_0.90" name="RSS_0.90"> RSS 0.90 </h2> +<p>RSS 0.90 jest najwcześniejszą znaną wersją RSS, opublikowaną jako pełną wersje i została zastąpiona przez wersje <a href="pl/RSS/Wersje/0.91/Netscape/Wersja_1">Netscape'a RSS 0.91 (Wersja 1)</a>. Stworzony został przez firmę Netscape, aby być formatem metadanych, które dostarczają podsumowanie ze stron internetowych (i nie tylko był formatem syndykacji, tak jak to jest na dzień dzisiejszy). </p><p>RSS 0.90 jest oparty na formacie <a href="pl/RDF">RDF</a>. +</p><p>Podczas tworzenia RSS 0.90, inicjalizacja RSS rozumie go jako <b>Rich Site Summary</b>, a nie jako <b>Really Simple Syndication</b>. (Zobacz <a href="pl/RSS/What_is_in_a_Name">RSS - What is in a Name</a> aby dowiedzieć się więcej nt. historii i stosowanych nazwach poszczególnych wersji.) +</p> +<div class="note"> +<p><b>NOTATKA</b>: RSS 0.90 został wycofany (<b>deprected</b>). Osoby tworzące kanał RSS <i>NIE POWINY</i> tworzyć kanału RSS w wersji 0.90 i <i>POWINNI</i> zamiast tego używać nigdy nie wycofanej wersji formatu RSS. (Zobacz <a href="pl/RSS/Wersje">listę wersji RSS</a>, aby zobaczyć, który format nie jest formatem wycofanym). Użytkownicy RSS <i>POWINNi</i> wciąż być chociaż zdolni zaakceptować kanał RSS 0.90. +</p> +</div> +<p><br> +</p> +<h3 id="Przyk.C5.82ady" name="Przyk.C5.82ady"> Przykłady </h3> +<p>RSS 0.90 wygląda podobnie do poniżeszego kodu: +</p> +<pre class="eval"> <span class="nowiki"> + <?xml version="1.0"?> + + <rdf:RDF + xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" + xmlns="http://my.netscape.com/rdf/simple/0.9/" + > + + <channel> + <title>Mozilla Dot Org</title> + <link>http://www.mozilla.org</link> + <description>the Mozilla Organization web site</description> + </channel> + + <image> + <title>Mozilla</title> + <url>http://www.mozilla.org/images/moz.gif</url> + <link>http://www.mozilla.org</link> + </image> + + <item> + <title>New Status Updates</title> + <link>http://www.mozilla.org/status/</link> + </item> + + <item> + <title>Bugzilla Reorganized</title> + <link>http://www.mozilla.org/bugs/</link> + </item> + + <item> + <title>Mozilla Party, 2.0!</title> + <link>http://www.mozilla.org/party/1999/</link> + </item> + + <item> + <title>Unix Platform Parity</title> + <link>http://www.mozilla.org/build/unix.html</link> + </item> + + <item> + <title>NPL 1.0M published</title> + <link>http://www.mozilla.org/NPL/NPL-1.0M.html</link> + </item> + + </rdf:RDF> + </span> +</pre> +<p>Note that here, RSS is being used to list sections of the web site. Rather than for syndication. +</p><p><br> +</p> +<h3 id="Specyfikacje" name="Specyfikacje"> Specyfikacje </h3> +<p>Oryginalna specyfikacja RSS 0.90 znikneła z oryginalnego adresu strony +</p> +<dl><dd> <span class="nowiki">http://my.netscape.com/publish/help/quickstart.html</span> +</dd></dl> +<p>Kopie zostały zapisane i można je zobaczyć: </p> +<ul><li> <a href="http://www.purplepages.ie/RSS/netscape/rss0.90.html" class=" external" rel="freelink">http://www.purplepages.ie/RSS/netscape/rss0.90.html</a> +</li><li> <a href="http://web.archive.org/web/*/http://my.netscape.com/publish/help/quickstart.html" class=" external" rel="freelink">http://web.archive.org/web/*/http://...uickstart.html</a> +</li></ul> +{{ languages( { "en": "en/RSS/Version/0.90", "ja": "ja/RSS/Version/0.90" } ) }} diff --git a/files/pl/archive/rss/wersje/0.91/index.html b/files/pl/archive/rss/wersje/0.91/index.html new file mode 100644 index 0000000000..e407e5e780 --- /dev/null +++ b/files/pl/archive/rss/wersje/0.91/index.html @@ -0,0 +1,18 @@ +--- +title: '0.91' +slug: Archive/RSS/Wersje/0.91 +tags: + - RSS + - Wszystkie_kategorie +translation_of: Archive/RSS/Version/0.91 +--- +<p> +</p> +<h2 id="RSS_0.91" name="RSS_0.91"> RSS 0.91 </h2> +<p>Poniżej znajdują się 3 różne wersje RSS 0.91: +</p> +<ul><li> <a href="pl/RSS/Wersje/0.91/Netscape/Wersja_1">Netscape RSS 0.91 (Wersja 1)</a> +</li><li> <a href="pl/RSS/Wersje/0.91/Netscape/Wersja_3">Netscape RSS 0.91 (Wersja 3)</a> +</li><li> <a href="pl/RSS/Wersje/0.91/Userland">Userland RSS 0.91</a> +</li></ul> +{{ languages( { "en": "en/RSS/Version/0.91", "ja": "ja/RSS/Version/0.91" } ) }} diff --git a/files/pl/archive/rss/wersje/index.html b/files/pl/archive/rss/wersje/index.html new file mode 100644 index 0000000000..cc6cbdc0af --- /dev/null +++ b/files/pl/archive/rss/wersje/index.html @@ -0,0 +1,31 @@ +--- +title: Wersje +slug: Archive/RSS/Wersje +tags: + - RSS + - Wszystkie_kategorie +translation_of: Archive/RSS/Version +--- +<p> +</p> +<h2 id="Wersje_RSS" name="Wersje_RSS"> Wersje RSS </h2> +<p>RSS posiada złożoną historię. Różni ludzie i grupy tworzyły niepowiązane ze sobą standardy o nazwie RSS. Niektóre formaty RSS-a bazują na <a href="pl/XML">XML</a>-u. Inne na <a href="pl/RDF">RDF</a>-ie. +</p><p>Poniższa lista przedstawia wszystkie znane wersje RSS-a. Są one poukładane w kolejności chronologicznej. +</p> +<div class="note"> +<p><b>Uwaga</b>: RSS 1.0, na poniższej liście wydaje się być nie na miejscu na jakim powinno się znajdować. Jednak, ze względu na kolejność chronologiczna, takie właśnie miejsce mu się należy. +</p> +</div> +<div class="note"> +<p><b>Uwaga</b>: Istnieją trzy, różne, wersje <a href="pl/RSS/Wersje/0.91">RSS-a 0.91</a>. RSS 0.91 Netscape'a (Wersja 1), RSS 0.91 Netscape'a Wersja 3 oraz RSS 0.91 Userland'a. Mówiąc szczegółowo, RSS 0.91 Userland'a jest podzbiorem RSS 0.91 Netscape'a. +</p> +</div> +<div class="note"> +<p><b>Uwaga</b>: RSS 0.93 i RSS 0.94 zostały wydane tylko jako "szkice" i nigdy nie stały się "finalne" więc nie zostały nigdy przeznaczone do użycia. +</p> +</div> +<p><br> +</p> +<table class="standard-table"> <tbody><tr> <th>Nazwa</th> <th>Status</th> <th>Data wydania</th> <th>Bazuje na</th> <th>Autor</th> </tr> <tr> <td><a href="pl/RSS/Wersje/0.90">RSS 0.90</a></td> <td>{{ Deprecated_inline() }}</td> <td class="small">marzec 1999</td> <td><a href="pl/RDF">RDF</a></td> <td class="small">Netscape</td> </tr> <tr> <td><a href="pl/RSS/Wersje/0.91/Netscape/Wersja_1">RSS 0.91 Netscape (Wersja 1)</a></td> <td>{{ Deprecated_inline() }}</td> <td class="small">?</td> <td><a href="pl/XML">XML</a></td> <td class="small">Netscape</td> </tr> <tr> <td><a href="pl/RSS/Wersje/0.91/Netscape/Wersja_3">RSS 0.91 Netscape (Wersja 3)</a></td> <td>{{ Obsolete_inline() }}</td> <td class="small">10 lipiec 1999</td> <td><a href="pl/XML">XML</a></td> <td class="small">Netscape</td> </tr> <tr> <td><a href="pl/RSS/Wersje/0.91/Userland">RSS 0.91 Userland</a></td> <td>{{ Deprecated_inline() }}</td> <td class="small">4 czerwca 2000</td> <td><a href="pl/XML">XML</a></td> <td class="small">Userland</td> </tr> <tr> <td><a href="pl/RSS/Wersje/1.0">RSS 1.0</a></td> <td>Standard</td> <td class="small">9 grudzień 2000</td> <td><a href="pl/RDF">RDF</a></td> <td class="small">Grupa robocza RSS-DEV</td> </tr> <tr> <td><a href="pl/RSS/Wersje/0.92">RSS 0.92</a></td> <td>{{ Deprecated_inline() }}</td> <td class="small">25 grudzień 2000</td> <td><a href="pl/XML">XML</a></td> <td class="small">Userland</td> </tr> <tr> <td><a href="pl/RSS/Wersje/0.93">RSS 0.93</a></td> <td>{{ Deprecated_inline() }}</td> <td class="small">20 kwiecień 2001</td> <td><a href="pl/XML">XML</a></td> <td class="small">Userland</td> </tr> <tr> <td><a href="pl/RSS/Wersje/0.94">RSS 0.94</a></td> <td>{{ Deprecated_inline() }}</td> <td class="small">19 sierpień 2002</td> <td><a href="pl/XML">XML</a></td> <td class="small">Userland</td> </tr> <tr> <td><a href="pl/RSS/Wersje/2.0">RSS 2.0</a></td> <td>{{ Deprecated_inline() }}</td> <td class="small">wrzesień 2002</td> <td><a href="pl/XML">XML</a></td> <td class="small">Userland</td> </tr> <tr> <td><a href="pl/RSS/Wersje/2.0/2002-11-11">RSS 2.0 (po 2002-11-11)</a></td> <td>{{ Deprecated_inline() }}</td> <td class="small">11 listopad 2002</td> <td><a href="pl/XML">XML</a></td> <td class="small">Userland</td> </tr> <tr> <td><a href="pl/RSS/Wersje/2.0/2003-01-21">RSS 2.0 (po 2003-01-21)</a></td> <td>Standard</td> <td class="small">21 styczeń 2003</td> <td><a href="pl/XML">XML</a></td> <td class="small">Userland</td> </tr> +</tbody></table> +{{ languages( { "en": "en/RSS/Version", "es": "es/RSS/Versiones", "fr": "fr/RSS/Version", "ja": "ja/RSS/Version" } ) }} diff --git a/files/pl/archive/standardy_www/index.html b/files/pl/archive/standardy_www/index.html new file mode 100644 index 0000000000..2ebda169bd --- /dev/null +++ b/files/pl/archive/standardy_www/index.html @@ -0,0 +1,67 @@ +--- +title: Standardy WWW +slug: Archive/Standardy_WWW +translation_of: Archive/Web_Standards +--- +<div><strong>Standardy WWW</strong> zostały stworzone w celu zagwarantowania wszystkim internautom długoterminowej kompatybilności w odczycie stron WWW. Projektowanie i pisanie z wykorzystaniem tych standardów upraszcza produkcję i obniża jej koszty, a tak stworzone produkty stają się dostępne dla większej ilości odbiorców i przeglądarek internetowych. Strony tworzone zgodnie z tymi regułami będą działały prawidłowo w przyszłych wersjach obecnych przeglądarek internetowych, a także w nowych urządzeniach odbiorczych, które w przyszłości pojawią się na rynku {{ Ref(1) }}.</div> + +<table class="topicpage-table"> + <tbody> + <tr> + <td> + <h2 id="Dokumentacja" name="Dokumentacja"><a href="/Special:Tags?tag=Standardy_WWW&language=pl" title="Special:Tags?tag=Standardy_WWW&language=pl">Dokumentacja</a></h2> + + <dl> + <dt><a href="/pl/Wyb%C3%B3r_zgodno%C5%9Bci_ze_standardami_zamiast_praktyk_w%C5%82asno%C5%9Bciowych" title="pl/Wybór_zgodności_ze_standardami_zamiast_praktyk_własnościowych">Wybór zgodności ze standardami zamiast praktyk własnościowych</a></dt> + <dd><small>W świecie programistów istnieje potrzeba standardów, ponieważ aplikacje są tworzone w wielu niezależnych grupach.</small></dd> + </dl> + + <dl> + <dt><a href="/pl/Firefox_-_potrzeba_wolno%C5%9Bci" title="pl/Firefox_-_potrzeba_wolności">Firefox - potrzeba wolności</a></dt> + <dd><small>Prezentacja z konferencji <a class="external" href="http://www.isoc.org.pl/2005/woadm/">Wolne oprogramowanie w administracji publicznej</a> na temat roli wolnych standardów w projektach publicznych.</small></dd> + </dl> + + <p><br> + <span class="alllinks"><a href="/Special:Tags?tag=Standardy_WWW&language=pl" title="Special:Tags?tag=Standardy_WWW&language=pl">Pokaż wszystkie...</a></span></p> + </td> + <td> + <h2 id="Spo.C5.82eczno.C5.9B.C4.87" name="Spo.C5.82eczno.C5.9B.C4.87">Społeczność</h2> + + <ul> + <li>Obejrzyj fora Mozilli...</li> + </ul> + + <p>{{ DiscussionList("dev-web-development", "mozilla.dev.web-development") }}</p> + + <ul> + <li><a class="external" href="http://webstandards.org/">Projekt standardów sieciowych</a></li> + <li><a class="external" href="http://webdevfeedhouse.com/">WebDev FeedHouse</a></li> + <li><a href="/pl/Standardy_WWW/Spo%C5%82eczno%C5%9B%C4%87" title="pl/Standardy_WWW/Społeczność">Inne linki...</a></li> + </ul> + + <h2 id="Narz.C4.99dzia" name="Narz.C4.99dzia">Narzędzia</h2> + + <ul> + <li><a class="link-https" href="https://addons.mozilla.org/extensions/moreinfo.php?id=60&application=firefox">Rozszerzenie Web Developer</a></li> + <li><a class="external" href="http://validator.w3.org/">Walidator (W3C)</a></li> + <li><a class="external" href="http://jigsaw.w3.org/css-validator/">Walidator CSS (W3C)</a></li> + </ul> + + <p><span class="alllinks"><a href="/Special:Tags?tag=Standardy_WWW:Narz%C4%99dzia&language=pl" title="Special:Tags?tag=Standardy_WWW:Narzędzia&language=pl">Pokaż wszystkie...</a></span></p> + + <h2 id="Powi.C4.85zane_tematy" name="Powi.C4.85zane_tematy">Powiązane tematy</h2> + + <dl> + <dd><a href="/pl/CSS" title="pl/CSS">CSS</a>, <a href="/pl/DHTML" title="pl/DHTML">DHTML</a>, <a href="/pl/HTML" title="pl/HTML">HTML</a>, <a href="/pl/Programowanie_WWW" title="pl/Programowanie_WWW">Programowanie WWW</a>, <a href="/pl/XHTML" title="pl/XHTML">XHTML</a>, <a href="/pl/XML" title="pl/XML">XML</a></dd> + </dl> + + <p> </p> + </td> + </tr> + </tbody> +</table> + +<hr> +<p><small>{{ Note(1) }} - <a class="external" href="http://webstandards.org/">The Web Standards Project</a></small></p> + +<p><span class="comment">Categories</span></p> diff --git a/files/pl/archive/standardy_www/poprawne_użycie_tytułów_w_zewnętrznych_arkuszach_stylów/index.html b/files/pl/archive/standardy_www/poprawne_użycie_tytułów_w_zewnętrznych_arkuszach_stylów/index.html new file mode 100644 index 0000000000..19412f9bd7 --- /dev/null +++ b/files/pl/archive/standardy_www/poprawne_użycie_tytułów_w_zewnętrznych_arkuszach_stylów/index.html @@ -0,0 +1,40 @@ +--- +title: Poprawne użycie tytułów w zewnętrznych arkuszach stylów +slug: Archive/Standardy_WWW/Poprawne_użycie_tytułów_w_zewnętrznych_arkuszach_stylów +tags: + - CSS + - Wszystkie_kategorie +translation_of: Archive/Web_Standards/Correctly_Using_Titles_With_External_Stylesheets +--- +<p> +</p><p>Zewnętrzne arkusze stylów są zwykle łączone z dokumentami HTML przy użyciu elementu <code>link</code>, ale niezwykle ważnym jest właściwe użycie atrybutów tego elementu. Ponieważ istnieją trzy rodzaje arkuszy stylów, atrybut <code>title</code> jest niezbędny do określenia dwóch z nich. Obecność atrybutu <code>title</code> w elemencie <code>link</code> odwołującym się do zewnętrznego arkusza stylów może sprawić, że stanie się on <i>preferowanym arkuszem stylów</i>. W większości przypadków spowoduje to zignorowanie zewnętrznego arkusza stylów, co zwykle nie jest tym, czego życzył sobie autor. +</p> +<h3 id="Dlaczego_tytu.C5.82_si.C4.99_liczy.3F"> Dlaczego tytuł się liczy? </h3> +<p>Atrybut <code>title</code> wpływa na sposób w jaki zewnętrzny arkusz stylów będzie zastosowany w dokumencie. Użycie atrybutu <code>title</code> jest tak charakterystyczne, że specyfikacja HTML 4.01 dzieli arkusze stylów ze względu na jego obecność lub jej brak. Poprzez użycie atrybutu <code>title</code> można kontrolować, kiedy dany arkusz stylów zawsze stosuje się do dokumentu, czy też jest używany tylko w niektórych, specyficznych przypadkach. +</p><p>Istnieją trzy rodzaje arkuszy stylów: <i>stałe</i>, <i>preferowane</i> oraz <i>alternatywne</i>. Najbardziej znanymi autorom będą stałe arkusze stylów, których dowolna ilość może być jednocześnie użyta w dokumencie. Stałym arkuszem stylów jest taki, który nie ma atrybutu <code>title</code>, a wartością atrybutu <code>rel</code> jest <code>stylesheet</code>. Dokument może się odwoływać do jednego lub więcej stałych arkuszy stylów, z których wszystkie są używane podczas prezentacji dokumentu. +</p><p>Preferowanym arkuszem stylów jest natomiast taki, który ma do atrybutu <code>rel</code> przypisaną wartość <code>stylesheet</code> i posiada dowolną wartość atrybutu <code>title</code>. Poniżej dwa przykłady: +</p> +<pre><link type="text/css" rel="stylesheet" title="Style podstawowe" href="basic.css" /> +<link type="text/css" rel="stylesheet" title="Ryby i łódki" href="ocean.css" /></pre> +<p>W specyfikacji HTML 4.01 określone jest, iż tylko <b>jeden</b> z preferowanych arkuszy stylów może być użyty w danym momencie. W związku z tym, patrząc na powyższy przykład, tylko jeden z podanych dwóch preferowanych arkuszy stylów będzie zastosowany w dokumencie. W specyfikacji brak procedury decydującej o tym, który z podanych arkuszy stylów powinien być użyty, wobec czego przeglądarki mają wolny wybór, który arkusz stylów zastosują. +</p><p>Zatem dowolny <code>link</code> do arkusza stylów, w którym określony został atrybut <code>title</code> <b>nie może</b> być stały, i może być zignorowany przez przeglądarkę. Każdy z elementów <code>link</code> odwołujący się do arkusza stylów i zawierający atrybut <code>title</code> musi być preferowanym albo alternatywnym arkuszem stylów, zależnie od wartości atrybutu <code>rel</code>. +</p><p>W dokumencie odwołującym się do alternatywnych arkuszy stylów, preferowany arkusz stylów będzie używany tak długo, póki użytkownik nie wybierze żadnego z arkuszy alternatywnych. Zatem, kiedy dokument jest ładowany przeglądarka użyje wszystkich stałych arkuszy stylów, oraz jednego preferowanego (należy pamiętać, iż tylko jeden z arkuszy powinien być określony jako preferowany). Gdy użytkownik wybierze jeden z arkuszy alternatywnych, arkusz preferowany przestanie być używany, lecz będzie mógł być wybrany ponownie przez użytkownika. +</p><p>Podstawowym użyciem preferowanego arkusza stylów jest określenie jednego z arkuszy stylów jako "domyślnego" dla prezentacji. Jeśli zostanie wybrany którykolwiek z alternatywnych arkuszy stylów, arkusz preferowany przestaje być używany na korzyść wybranego przez użytkownika alternatywnego arkusza stylów. +</p> +<h3 id="Zalecenia"> Zalecenia </h3> +<p>Twórcy stron powinni upewniać się, że każdy z arkuszy stylów, które powinny być używane zawsze są zadeklarowane jako stałe, a nie preferowane. Cytując, <a class="external" href="http://www.w3.org/TR/HTML401/present/styles.html#h-14.3.1">Specyfikacja HTML 4.01, sekcja 14.3.1</a> określa: +</p> +<ul><li> Aby uczynić arkusz stylów stałym, ustaw atrybut <a class="external" href="http://www.w3.org/TR/HTML401/struct/links.html#adef-rel"><code>rel</code></a> równy "stylesheet" i nie ustawiaj atrybutu <a class="external" href="http://www.w3.org/TR/HTML401/struct/global.html#adef-title"><code>title</code></a>. +</li><li> Aby uczynić arkusz stylów preferowanym, ustaw atrybut <a class="external" href="http://www.w3.org/TR/HTML401/struct/links.html#adef-rel"><code>rel</code></a> równy "stylesheet" i nadaj nazwę temu arkuszowi używając atrybutu <a class="external" href="http://www.w3.org/TR/HTML401/struct/global.html#adef-title"><code>title</code></a>. +</li></ul> +<h3 id="Odno.C5.9Bniki"> Odnośniki </h3> +<ul><li> <a class="external" href="http://www.w3.org/TR/html401/present/styles.html#h-14.3">Specyfikacja HTML 4.01, sekcja 14.3: Zewnętrzne arkusze stylów</a> +</li></ul> +<div class="originaldocinfo"> +<h3 id="Informacje_o_dokumencie"> Informacje o dokumencie </h3> +<ul><li> Autor: Eric A. Meyer +</li><li> Data ostatniej aktualizacji: December 30th, 2002 +</li><li> Informacje o prawach autorskich: Copyright © 2001-2003 Netscape. +</li></ul> +</div> +{{ languages( { "fr": "fr/Utiliser_des_titres_corrects_avec_des_feuilles_de_styles_externes", "en": "en/Correctly_Using_Titles_With_External_Stylesheets" } ) }} diff --git a/files/pl/archive/standardy_www/stylizowanie_skrótów_i_akronimów/index.html b/files/pl/archive/standardy_www/stylizowanie_skrótów_i_akronimów/index.html new file mode 100644 index 0000000000..0f7a6ee703 --- /dev/null +++ b/files/pl/archive/standardy_www/stylizowanie_skrótów_i_akronimów/index.html @@ -0,0 +1,44 @@ +--- +title: Stylizowanie skrótów i akronimów +slug: Archive/Standardy_WWW/Stylizowanie_skrótów_i_akronimów +tags: + - CSS + - Dostępność + - Wszystkie_kategorie +translation_of: Archive/Web_Standards/Styling_Abbreviations_and_Acronyms +--- +<p> +</p><p><span class="comment">Podsumowanie: Elementy HTML <code>abbr</code> i <code>acronym</code> są użytecznymi pomocami w tworzeniu dostępnych stron, jednak ich stylizacja może okazać się zaskakująca. Zobacz, jak można kontrolować ich prezentację bez poświęcania korzyści, jakie dają te elementy.</span> +</p><p>Wielu autorów zaczyna używać na swoich stronach elementów HTML <code>abbr</code> (skrót) i <code>acronym</code> (akronim). Jest to godne polecenia i zgodnie z <a class="external" href="http://www.w3.org/TR/WCAG10/#gl-abbreviated-and-foreign">Guideline 4 of the Web Content Accessibility Guidelines</a>, obydwa elementy powinny posiadać atrybut <code>title</code>, aby poprawić "czytelność stron internetowych dla wszystkich, w tym ludzi z zaburzeniami poznawczymi, trudnościami w uczeniu się czy też ludzi głuchych". +</p> +<h3 id="Problem" name="Problem"> Problem </h3> +<p>Autorzy zauważyli, że <code>abbr</code> i <code>acronym</code> w Mozilli i związanych z nią przeglądarkach wyświetlane są z kropkowanym "podkreśleniem". Owo podkreślenie nie daje się usunąć za pomocą <code>text-decoration: none</code>. Powód takiej sytuacji można znaleźć w pliku Mozilli <tt>html.css</tt>: +</p> <pre>abbr[title], acronym[title] { + border-bottom: dotted 1px; + }</pre> +<p>"Podkreślenie" jest w rzeczywistości dolnym obramowaniem. +</p> +<h3 id="Rozwi.C4.85zanie" name="Rozwi.C4.85zanie"> Rozwiązanie </h3> +<p>Jeżeli autor chce usunąć podkreślenie dla <code>abbr</code> i <code>acronym</code>, można to wykonać za pomocą poniższej reguły: +</p> <pre>abbr[title], acronym[title] { + border-bottom-width: 0; + }</pre> +<p>Oczywiście można też zrobić sporo innych rzeczy, jak zmiana stylu czy koloru obramowania, zmiana wyglądu tekstu w tych elementach, użycie nieznacznie innego koloru, itd. +</p><p>Lepszym wyjściem może być zmniejszenie widocznej grubości ramki bez faktycznego jej usuwania. "Podkreślenie" mówi czytającemu, że wyróżniony wyraz związany jest z pewną dodatkową informacją. W Mozilli po umieszczeniu wskaźnika myszy nad elementem i pozostawieniu go przez chwilę zawartość atrybutu <code>title</code> pojawi się jako "dymek" obok wskaźnika myszy. Usunięcie "podkreślenia" z tych elementów pozbawi czytelników oznakowania, że dostępna jest ta dodatkowa informacja. +</p> +<h3 id="Zalecenia" name="Zalecenia"> Zalecenia </h3> +<ul><li> Jeżeli "podkreślenie" ma zostać usunięte, autor musi nadać elementowi (lub elementom) dolne obramowanie. <code>text-decoration</code> nie ma zastosowania w tej sytuacji. +</li></ul> +<h3 id="Odno.C5.9Bniki" name="Odno.C5.9Bniki"> Odnośniki </h3> +<ul><li> <a class="external" href="http://www.w3.org/TR/WCAG10/">Web Content Accessibility Guidelines 1.0</a> +</li></ul> +<div class="originaldocinfo"> +<h3 id="Informacje_o_dokumencie" name="Informacje_o_dokumencie"> Informacje o dokumencie </h3> +<ul><li> Autor(zy): Eric A. Meyer, Netscape Communications +</li><li> Ostatnia aktualizacja: opublikowano 9 sierpnia 2002 +</li><li> Informacja o prawach autorskich: Copyright © 2001-2003 Netscape. All rights reserved. +</li><li> Uwaga: Ten artykuł był pierwotnie częścią witryny DevEdge. +</li><li> Tłumaczenie: Jan Dudek +</li></ul> +</div> +{{ languages( { "en": "en/Styling_Abbreviations_and_Acronyms", "ja": "ja/Styling_Abbreviations_and_Acronyms" } ) }} diff --git a/files/pl/archive/standardy_www/wybór_zgodności_ze_standardami_zamiast_praktyk_własnościowych/index.html b/files/pl/archive/standardy_www/wybór_zgodności_ze_standardami_zamiast_praktyk_własnościowych/index.html new file mode 100644 index 0000000000..4052a985e3 --- /dev/null +++ b/files/pl/archive/standardy_www/wybór_zgodności_ze_standardami_zamiast_praktyk_własnościowych/index.html @@ -0,0 +1,104 @@ +--- +title: Wybór zgodności ze standardami zamiast praktyk własnościowych +slug: >- + Archive/Standardy_WWW/Wybór_zgodności_ze_standardami_zamiast_praktyk_własnościowych +tags: + - Standardy_WWW + - Strony_wymagające_dopracowania + - Wszystkie_kategorie +translation_of: Archive/Web_Standards/Choosing_Standards_Compliance_Over_Proprietary_Practices +--- +<h3 id="Wst.C4.99p" name="Wst.C4.99p">Wstęp</h3> + +<p>Istnieje pewna liczba standardów, procedur oraz procesów, którą każda organizacja może wykorzystać. Na wyższym poziomie istnieją dwa podstawowe typy standardów: proceduralny (jak my to robimy) oraz techniczny (czym się kierujemy). Organizacje wdrażają wewnętrzne standardy proceduralne, aby móc wydajnie działać. Mogą także wdrażać zewnętrzne procedury oraz/lub standardy techniczne. Techniczne standardy tradycyjnie były wprowadzane przez konsorcja lub ciała standaryzujące. Standardy techniczne mogą być zarówno publiczne, oparte na standardach lub własnościowe. Celem tego dokumentu jest omówienie i podkreślenie wagi wsparcia otwartych standardów technologicznych, które są zewnętrzne względem organizacji. Jednak zacznijmy dyskusję od spojrzenia w głąb wewnętrznych procedur, procesów i standardów.</p> + +<p>Czemu organizacje powinny mieć standardowe procedury na każdym poziomie? Kierowanie się standardami nie jest niczym nowym; organizacje wymagają od swoich pracowników, aby trzymali się pewnych zasad lub zestawu standardów na okrągło. Pagery, karty czasowe, procedury kontroli kont to wszystko są standardy na poziomie grup.</p> + +<p>W świecie programowania istnieje potrzeba standardów, ponieważ aplikacje są tworzone między wieloma grupami programistów. Wiele organizacji upublicznia swoje wewnętrzne standardy i procedury programistyczne. Na przykład, organizacja może zdecydować, że C++, Java i JavaScript będą jej podstawowymi językami programistycznymi. Mogą wymagać, aby każdy projekt posiadał Dokumenty Wymagań Marketingowych, Dokumenty Wymagań Produktu, Dokumenty Wymagań Funkcjonalności, Plany Testów Kontroli Jakości i Dokumenty Certyfikujące.</p> + +<p>Wraz z rozwojem organizacji, rośnie potrzeba tworzenia procesów zapewniających więcej kontroli, która pozwala łatwiej planować i przewidywać. Z procesami organizacje mogą tworzyć harmonogramy wydań, wdrażać plany marketingowe, analizować rozdział zasobów i wprowadzać poprawki w razie konieczności. Zawierzenie standardom i procesom może wprowadzić dodatkowy poziom elastyczności, ponieważ programowanie staje się przewidywalne. Dodatkowo, standardowe procesy zwiększają zrozumienie przebiegu tworzenia oraz pozwalają ograniczyć koszty.</p> + +<h3 id="Popularne_procesy_rozwojowe" name="Popularne_procesy_rozwojowe">Popularne procesy rozwojowe</h3> + +<p>Kiedy organizacja rozrasta się, menedżerowie i inżynierowie spostrzegają jak ważne jest pilnowanie tych procesów. Kiedy zespół przedstawia projekt, następuje jego ocena pod względem kompatybilności projektu z całkowitą strategią budżetową. Pion marketingu musi następnie przeanalizować możliwości promocyjne danej aplikacji/produktu, a następnie przeprowadzić dogłębną techniczną ocenę aplikacji oraz badania rozwojowe. Jeżeli projekt zostaje zaakceptowany, zebrane informacje, analizy i badania są wiązane w tzw. Request For Proposal (RFP).</p> + +<p>Taka sytuacja zdarza się dość często: większość organizacji posiada podstawowy proces zarządzania projektem dla każdego produktu lub usługi. Wewnętrzne procesy organizacji są dobrze dopasowane do pracy w środowisku kulturowym danej firmy. Właśnie w takim momencie tworzy się standard rozwojowy - pojawia się konieczność przestrzegania go przez wszystkich.</p> + +<p>Bardzo łatwo złapać się w pętlę ślepej realizacji założeń, zapominając po co organizacjom procesy. Przede wszystkim organizacje korzystają z nich, ponieważ to pozwala oszczędzić pieniądze, czas i zasoby. Są też inne powody - podział zadań, punkty kontrolne, harmonogramy itd. Końcowym efektem powinien być proces pozwalający zmaksymalizować wydajność organizacji.</p> + +<h3 id="Inne_standardy" name="Inne_standardy">Inne standardy</h3> + +<p>Ważne jest również, aby stosować się do innych standardów. Istnieje niezliczona ilość organizacji standaryzujących, które wpływają na to jak i dlaczego robimy to, co robimy. Na przykład w obszarze księgowości istnieje FASB (Financial Accounting Standards Board - Rada do Spraw Standardów Rachunkowości Finansowej) oraz IASB (International Accounting Standards Board - Rada ds. Międzynarodowych Standardów Rachunkowości). Oczekuje się od wszystkich firm i przedsiębiorstw, aby przestrzegały zasad ustalonych przez FASB. Gdy kontrolerzy oceniają sytuację finansową organizacji, robią to w oparciu o zasady FASB.</p> + +<p>Wracając do rozwoju oprogramowania, istnieje wiele organów standaryzujących, mających wpływ na decyzje dotyczące tego procesu. Na przykład, jeśli jakaś firma tworzy aplikację internetową, powinna ona trzymać się standardów wyznaczonych przez następujące organizacje:</p> + +<ul> + <li>ANSI (<em><a class="external" href="http://www.ansi.org/">American National Standards Institute</a></em>),</li> + <li>ATSC (<em><a class="external" href="http://www.atsc.org/">Advanced Television Systems Committee</a></em>),</li> + <li>ECMA (<em><a class="external" href="http://www.ecma-international.org/">European Computer Manufacturers Association</a>: Standardizing Information and Communication Systems</em>),</li> + <li>IEEE (<em><a class="external" href="http://www.ieee.org/">Institute of Electrical and Electronics Engineers</a></em>),</li> + <li>IETF (<em><a class="external" href="http://www.ietf.org/">Internet Engineering Task Force</a></em>),</li> + <li>IRTF (<em><a class="external" href="http://www.irtf.org/">Internet Research Task Force</a></em>),</li> + <li>ISO (<em><a class="external" href="http://www.iso.org/">International Standards Organization</a></em>),</li> + <li>ITU (<em><a class="external" href="http://www.itu.org/">International Telecommunication Union</a></em>),</li> + <li>OASIS (<em><a class="external" href="http://www.oasis-open.org">Organization for the Advancement of Structured Information Standards</a></em>),</li> + <li>OMA (<em><a class="external" href="http://www.openmobilealliance.org/">Open Mobile Alliance</a></em> (formalnie WAP)),</li> + <li>UNI (<em><a class="external" href="http://www.unicode.org/">Unicode Consortium</a></em>) oraz</li> + <li>W3C (<em><a class="external" href="http://www.w3.org/">World Wide Web Consortium</a></em>),</li> +</ul> + +<p>Podobnie jak procesy i standardy, które księgowi i menedżerzy projektu muszą przestrzegać, wyżej wymienione organizacje wyznaczają drogę, jaką muszą się kierować inżynierzy rozwoju. Przez podążanie tymi wytycznymi firmy takie jak AOL mogą polepszyć doświadczenia użytkownika, interoperacyjność, użycie kodu, dzielone zasoby oraz popularność - wraz z jednoczesną redukcją kosztów. Omówię każdy z tych elementów poniżej.</p> + +<h3 id="Interoperacyjno.C5.9B.C4.87" name="Interoperacyjno.C5.9B.C4.87">Interoperacyjność</h3> + +<p>Kluczem do interoperacyjności jest wybór standardu o możliwościach długotrwałego zastosowania. Organizacje muszą być pewne, że standard, który zdecydują się wdrożyć do procesu rozwoju, będzie odpowiedni również w przyszłości. Innymi słowy musi on posiadać długoterminowy potencjał. Fundamentalnym błędem popełnianym przez większość organizacji jest użycie własnościowych metod, oprogramowania, kodu lub standardów. Dla wielu z nich podążanie drogą własnościową okazało się katastrofalne w skutkach.</p> + +<p>Dobry przykład: korporacja Xerox. Gdy we wczesnych latach 80 zaprojektował on i rozpoczął rozwój systemu Star Office, Xerox niewątpliwie wykraczał ponad swoje czasy. Była to elegancka stacja robocza z pulpitem zaprojektowanym przez inżynierów z PARC (Palo Alto Research Center - Ośrodek Badawczy Palo Alto). System Star Office oferował funkcjonalność, z którą nie mógły się równać zarówno oferty Microsoftu jak i firmy Apple.</p> + +<p>Inżynierzy zaprojektowali Stara na własnościowym systemie operacyjnym znanym pod nazwą Pilot. Pilot posiadał wysoce zintegrowane narzędzie debugujące zwane Co-pilot, które pozwalało Xeroksowi na szybkie i łatwe debugowanie wielu błędów. Jednak tym, co Xerox pominął, było zrozumienie, że pomimo potęgi oprogramowania Pilot i Co-pilot, stacja robocza Star nie mogła rozwijać się w czasie, ponieważ była ona własnościowa. Xerox był ograniczony do unikatowej platformy sprzętowej oraz do zamkniętego systemu operacyjnego. I Xerox zdecydował się pominąć wiele okazji do przeniesienia kodu na inne platformy oraz do dostarczenia otwartego kodu źródłowego. W konsekwencji Xerox musiał ostatecznie zamknąć produkcję stacji roboczej z powodu zmniejszającego się popytu oraz rosnących kosztów rozwoju.</p> + +<p>Największy atut Xeroksa stał się przyczyną jego upadku. Wybrał on środowisko własnościowe i przegapił okazję, aby ze środowiska tego zrobić wzorzec - i ustanowić je jako standard.</p> + +<p>Podążanie otwartymi standardami posiada dodatkową zaletę. Gdy konieczne jest, aby organizacje oddziaływały ze sobą poprzez sojusze, fuzje lub przejęcie, integracja i interoperacyjność jest znacznie mniej kosztowna, jeśli każdy z zainteresowanych podmiotów przestrzega standardów od początku. Zgodność standardów znacząco redukuje ilość potrzebnej pracy oraz zapewnia zgodne i przewidywalne zachowanie obu podmiotów.</p> + +<h3 id="Do.C5.9Bwiadczenia_u.C5.BCytkownika_i_popularno.C5.9B.C4.87" name="Do.C5.9Bwiadczenia_u.C5.BCytkownika_i_popularno.C5.9B.C4.87">Doświadczenia użytkownika i popularność</h3> + +<p>Zachowanie klientów i ekspansja rynku są najważniejsze. Gdy klienci decydują się na wybór konkretnego produktu, należy im dostarczyć pozytywnych doświadczeń z niezawodnym, logicznym i przewidywalnym postępowaniem. Z czasem, gdy gust użytkowników stanie się bardziej wyrafinowany, a dodatkowe urządzenia lepiej dostępne, będą oni dochodzić do źródła informacji poprzez różne sposoby - i oczekiwać, że będą one wyglądać i działać w ten sam sposób – niezależnie od tego, czy będą oglądać stronę ze swojego komputera, telefonu komórkowego czy innego podręcznego urządzenia. W rezultacie jeśli organizacja oferuje pakiet produktów, musi ona upewnić się, że doświadczenia użytkownika są zgodne i przewidywalne w zakresie wszystkich produktów.</p> + +<h4 id="Zgodno.C5.9B.C4.87" name="Zgodno.C5.9B.C4.87">Zgodność</h4> + +<p>Aby osiągnąć sukces, organizacja musi zrozumieć oczekiwania użytkownika i dostarczyć mu zgodnych doświadczeń w zakresie oferowanych produktów. Gdy użyteczność zmienia zbyt wiele ponad produktami, użytkownik zaczyna narzekać.</p> + +<p>Apple i Microsoft bardzo dobrze pojęli tę lekcję. Gdy użytkownicy Macintosha przeszli z MacOS 8.x na MacOS 9.x przemiana interfejsu i pulpitu była właściwie niezauważalna. Użytkownicy mogli szybko przenieść się z jednej wersji na kolejną. Jednak gdy został wydany Mac OS X, Apple całkowicie przerobił wygląd interfejsu i pulpitu. Ta zmiana wywołała całkiem duże zamieszanie w społeczności użytkowników Apple'a. Uczyniło to system kłopotliwym w obsłudze, jednak nie na tyle, by użytkownicy nie mogli się dostosować. Apple otrzymał pozytywne jak i negatywne opinie; stracili oni również paru użytkowników, zyskując ostatecznie również nowych.</p> + +<p>Przykład tego jak zgodne doświadczenia użytkownika pozwalają na zyskanie jego przywiązania, dostrzec można w tym jak Microsoft zapewnia uogólnione zachowanie pomiędzy aplikacjami. Przykładowo w Wordzie, Excelu i innych aplikacjach Windows wiemy, że naciśnięcie kombinacji <code>CTRL</code>+<code>C</code> w dowolnym produkcie Microsoftu oznacza kopiowanie, Zachowanie to, zgodne i przewidywalne, w rezultacie stało się de-facto standardem. Przyczyną zgodności i przewidywalności jest to, że Microsoft ustanowił firmowy zbiór standardów użyteczności i obsługuje istotne standardy międzynarodowe.</p> + +<h4 id="Dost.C4.99pno.C5.9B.C4.87" name="Dost.C4.99pno.C5.9B.C4.87">Dostępność</h4> + +<p>Żadna organizacja nie może sobie pozwolić na pomijanie lub ignorowanie standardów dostępności. W środowisku sieciowym standardy dostępności są ściśle powiązane z HTML-em, XML-em, XHTML-em i innymi standardami W3C. Poprzez wcielanie i popieranie wytycznych dostępności, organizacja jest w stanie zaoferować swoją linię produktów lub usług większej i bardziej zróżnicowanej grupie użytkowników.</p> + +<h4 id="Zamienno.C5.9B.C4.87" name="Zamienno.C5.9B.C4.87">Zamienność</h4> + +<p>Jeśli użytkownik doświadcza zgodnego zachowania w wielu produktach, może on przewidzieć w jaki sposób konkretna czynność lub funkcja zadziała lub jaki będzie miał efekt. Dla dostawcy produktu celem powinien być jak najmniejszy element zaskoczenia. Poprzez zaszczepianie zbioru globalnych celów i standardów w infrastrukturę organizacyjną, organizacja zapewnia swoim użytkownikom końcowym zdolność do interakcji, funkcjonowania, obserwowania i przetwarzania informacji w sposób zgodny w miarę ich przechodzenia z jednego urządzenia do drugiego.</p> + +<p>Znaczącą wadą istnienia rozbieżności między aplikacjami jest to, że informacje muszę być powielane, zmieniane lub manipulowane, aby możliwe było ich przetworzenie w rozbieżnych aplikacjach. Stwarza to również problem, jeśli chodzi o narzędzia autorskie dla tych różnych aplikacji. Przykładowo powiedzmy, że mamy kilka ofert aplikacji, które mogą być użyte do przeglądania sieci. Każde z tych aplikacji podążała własną drogą rozwoju i wspierania standardów. Mogą one obsługiwać część międzynarodowych standardów, ale nie w pełni. Które narzędzia powinniśmy użyć? Czy finansowo nie będzie rozważnym krokiem rozwijanie własnościowych narzędzi autorskich dla każdej z tych aplikacji? Jaki w tym przypadku będzie stopień przyswojenia przez rynek kompletu tych aplikacji? W jaki sposób organizacja może zgodnie zyskać udziały na rynku, jeśli jej oferty produktów nie są zintegrowane? I co ważniejsze, co jeśli w ocenie użytkownika jej produkt nie jest zamienny?</p> + +<h3 id="Zasoby_dzielone" name="Zasoby_dzielone">Zasoby dzielone</h3> + +<p>Gdy organizacja zaszczepia ogólnofirmową politykę standardów dzielonych, może ona przenosić zasoby inżynierii między różnymi projektami. Inżynierowie rozwoju mogą przemieszczać się między projektami w sposób łatwiejszy i z niewielkim lub nawet żadnym przestojem w pracy. Praktyki kodowania są zgodne. Oczekiwania są znane. Istnieje równoważna funkcjonalność pomiędzy aplikacjami oferowanymi przez organizację. I inżynierowie mają większą podstawę doświadczenia, co czyni ich bardziej wartościowymi wewnątrz organizacji.</p> + +<p>Na przykład jeśli oczekuje się, że aplikacja internetowa będzie zgodna ze standardami W3C, oczekuje się również, aby każdy inżynier znał i rozumiał te standardy. Wysiłki mające na celu rozwój będą w konsekwencji wspierać podobne poziomy wspierania standardów, co prawdopodobnie doprowadzi kodowania wieloaplikacyjnego lub ponownego użycia danego kodu.</p> + +<p>Przykładowo jeśli inżynier rozwoju pisze aplikację spełniającą standard ANSI języka C i C++ oraz pisze kod działający na konkretnej platformie, kod ten może być skompilowany na dowolnej platformie i systemie operacyjnym wspierającym standardy ANSI. Produkty Microsoft są trudne do wyeksportowania, ponieważ wprowadzają one bibliotekę MFC (Microsoft Foundation Classes), która jest standardem działającym tylko na systemie Windows i nie przestrzega ona zasad ANSI.</p> + +<h3 id="Kontrola_jako.C5.9Bci" name="Kontrola_jako.C5.9Bci">Kontrola jakości</h3> + +<p>Z doświadczenia wiemy, że bez rygorystycznych testów nasze produkty mogą fatalnie zawieść po ich wprowadzeniu na rynek. Wsparcie techniczne jest kosztowne, nie tylko w związku z kosztami zatrudnienia odpowiedniej kadry, ale również z powodu potencjalnego niezadowolenia klienta.</p> + +<p>Dlatego właśnie organizacja musi również stosować standardy podczas kontroli jakości. Poprzez przyswojenie zbioru standardów, organizacja kontroli jakości może stworzyć zbiór zestawów testowych, które mogą zostać potem użyte między różnymi projektami. Poprzez ustandaryzowanie zestawów testowych, organizacja kontroli jakości może w łatwy sposób zarządzać, weryfikować i certyfikować testy oraz eliminować zbyteczne testowe bazy danych, w celu zapewnienia zgodności i niezawodności. Jak w przypadku inżynierów, standaryzacja pomaga inżynierom kontroli jakości w szybszym zyskiwaniu doświadczenia, a także w łatwości przenoszenia się pomiędzy projektami.</p> + +<h3 id="Podsumowanie" name="Podsumowanie">Podsumowanie</h3> + +<p>W czasach, gdy organizacje rozszerzają pole działania na coraz więcej urządzeń i platform, integracja i kompatybilność muszą być kluczowymi wymaganiami. Dążenie do stworzenia w przyszłości międzynarodowych standardów umożliwi codzienną realizację między-platformowych produktów. Akceptacja standardów pomoże nie tylko organizacjom, lecz także ułatwi odbiór końcowym użytkownikom aplikacji. Organizacje będą tworzyły produkty o lepszej jakości i przenośności, wyposażając wszystkich w elastyczne orpogramowanie. Ostatecznie, dzięki postępującej standaryzacji, organizacje będą łatwiej i trafniej oceniać postęp i wyniki wewnętrzne.</p> + +<p>The most compelling dilemma is how an organization chooses to follow open external standards verses a proprietary de facto standard. Following proprietary de facto standards leaves an organization vulnerable and open to obsolescence when the owner of the de facto changes focus or direction, or abandons the de facto altogether and renders the standard stagnate. On the other hand, by adopting open technology standards and participating in the development and direction of those standards, an organization is providing a path for future development, growth and revenue.</p> diff --git a/files/pl/archive/web/index.html b/files/pl/archive/web/index.html new file mode 100644 index 0000000000..6f60d315ff --- /dev/null +++ b/files/pl/archive/web/index.html @@ -0,0 +1,12 @@ +--- +title: Archived open Web documentation +slug: Archive/Web +tags: + - Archived + - NeedsTranslation + - TopicStub + - Web +translation_of: Archive/Web +--- +<p>The documentation listed below is archived, obsolete material about open Web topics.</p> +<p>{{SubpagesWithSummaries}}</p> diff --git a/files/pl/archive/web/xforms/index.html b/files/pl/archive/web/xforms/index.html new file mode 100644 index 0000000000..26cc7274fa --- /dev/null +++ b/files/pl/archive/web/xforms/index.html @@ -0,0 +1,68 @@ +--- +title: XForms +slug: Archive/Web/XForms +tags: + - Wszystkie_kategorie + - XForms +translation_of: Archive/Web/XForms +--- +<p> +</p> +<div class="callout-box"><b><a class="external" href="http://xformsinstitute.com/essentials/browse/">Istota XForms</a></b><br> +Przewodnik online dający Ci możliwość poznania XForms.</div> +<div><b>XForms</b> jest przyszłością formularzy online jak przewiduje W3C. Bazując na innych standardach W3C takich jak <a href="pl/XML_Schema">XML Schema</a>, <a href="pl/XPath">XPath</a> i <a href="pl/XML_Events">XML Events</a>, XForms jest próbą odniesienia się do niektórych ograniczeń obecnego modelu formularzy <a href="pl/HTML">HTML</a>. Pozostałe nowe cechy XForms to odseparowanie danych od wyglądu, silna typizacja, możliwość przesyłania danych <a href="pl/XML">XML</a> do serwera zamiast pary nazwa-wartość oraz tworzenie formularzy w sposób opisowy, co pozwoli na wyświetlanie ich na większej liczbie urządzeń. XForms jest <a class="external" href="http://www.w3.org/MarkUp/Forms/">specyfikacją W3C</a>.</div> +<div class="callout-box"><b><a class="external" href="http://en.wikibooks.org/wiki/XForms">XForms Tutorial and Cookbook</a> (en)</b><br> +XForms w formacie Wikibook - ponad 50 przykładów przetestowanych w Firefoksie.</div> +<div> +<p>Obsługa XForms może być dodana do przeglądarki Firefox i SeaMonkey poprzez zainstalowanie <a class="external" href="http://www.mozilla.org/projects/xforms">rozszerzenia Mozilla XForms</a>. +</p> +</div> +<table class="topicpage-table"> +<tbody><tr><td> +<h4 id="Dokumentacja" name="Dokumentacja"> <a>Dokumentacja</a> </h4> +<dl><dt> <a href="pl/XForms/Rozwi%c4%85zywanie_problem%c3%b3w_z_formularzami">Rozwiązywanie problemów z XForms</a> +</dt><dd> <small>Mała kolekcja porad jak radzić sobie z niektórymi problemami z formularzami XForms.</small> +</dd></dl> +<dl><dt> <a href="pl/XForms/Specjalno%c5%9bci_Mozilla_XForms">Specjalności Mozilla XForms</a> +</dt><dd> <small>Wyjaśnia gdzie i jak Mozilla XForms rozszerza lub odchodzi od specyfikacji XForms 1.0.</small> +</dd></dl> +<dl><dt> <a href="pl/XForms/W%c5%82asne_kontrolki">Własne kontrolki XForms</a> +</dt><dd> <small>Własne kontrolki pozwalają autorowi formularza na "stylizację" każdej kontrolki XForms poprzez XBL i utworzenie kontrolki <code>input</code> w SVG.</small> +</dd></dl> +<dl><dt> <a href="pl/XForms/Preferencje_u%c5%bcytkownika">Preferencje użytkownika XForms</a> +</dt><dd> <small>Opis zmiennych <code>about:config</code> używanych w XForms.</small> +</dd></dl> +<dl><dt> <a href="pl/XForms/Dokumentacja_API">Dokumentacja API XForms</a> +</dt><dd> <small>Dokumentacja interfejsu XForms.</small> +</dd></dl> +<dl><dt> <a href="pl/XForms/Elementy_interfejsu_u%c5%bcytkownika">Dokumentacja elementów UI XForms</a> +</dt><dd> <small>Dokumentacja elementów interfejsu użytkownika XForms.</small> +</dd></dl> +<p><span class="alllinks"><a>Pokaż wszystkie...</a></span> +</p> +</td> +<td> +<h4 id="Spo.C5.82eczno.C5.9B.C4.87" name="Spo.C5.82eczno.C5.9B.C4.87"> Społeczność </h4> +<ul><li> Obejrzyj fora Mozilli... +</li></ul> +<p>{{ DiscussionList("dev-tech-xforms", "mozilla.dev.tech.xforms") }} +</p> +<ul><li> <a class="link-irc" href="irc://irc.mozilla.org/xforms">Kanał #xforms na irc.mozilla.org</a> +</li><li> <a class="external" href="http://lists.w3.org/Archives/Public/www-forms/">Lista dyskusyjna W3C Forms</a> +</li><li> <a class="external" href="http://beaufour.dk/blog">Blog techniczny XForms</a> +</li><li> <a href="pl/XForms/Spo%c5%82eczno%c5%9b%c4%87">Inne odnośniki...</a> +</li></ul> +<h4 id="Narz.C4.99dzia" name="Narz.C4.99dzia"> Narzędzia </h4> +<ul><li> <a class="external" href="http://xformsinstitute.com/validator/">Walidator XForms</a> +</li><li> <a class="external" href="http://beaufour.dk/index.php?sec=misc&pagename=xforms">XForms Buddy</a> +</li></ul> +<p><span class="alllinks"><a>Pokaż wszystkie...</a></span> +</p> +<h4 id="Powi.C4.85zane_tematy" name="Powi.C4.85zane_tematy"> Powiązane tematy </h4> +<dl><dd> <a href="pl/Rozszerzenia">Rozszerzenia</a>, <a href="pl/HTML">HTML</a>, <a href="pl/XHTML">XHTML</a>, <a href="pl/XML">XML</a>, <a href="pl/XPath">XPath</a> +</dd></dl> +</td></tr></tbody></table> +<p><span class="comment">Categories</span> +</p><p><span class="comment">Interwiki Language Links</span> +</p><p><br> +</p>{{ languages( { "en": "en/XForms", "es": "es/XForms", "fr": "fr/XForms", "it": "it/XForms", "ja": "ja/XForms" } ) }} diff --git a/files/pl/archive/web/xforms/inne_zasoby/index.html b/files/pl/archive/web/xforms/inne_zasoby/index.html new file mode 100644 index 0000000000..733c2df569 --- /dev/null +++ b/files/pl/archive/web/xforms/inne_zasoby/index.html @@ -0,0 +1,16 @@ +--- +title: Inne zasoby +slug: Archive/Web/XForms/Inne_zasoby +tags: + - Wszystkie_kategorie + - XForms +translation_of: Archive/Web/XForms/Other_Resources +--- +<p> +</p> +<h3 id="Wszystkie_inne_zasoby" name="Wszystkie_inne_zasoby"> Wszystkie inne zasoby </h3> +<ul><li> <a class="external" href="http://www.mozilla.org/projects/xforms">Oficjalna strona Mozilli projektu XForms</a> +</li><li> <a class="external" href="http://www.w3.org/MarkUp/Forms/Test">W3C Test Suite</a> +</li><li> <a class="external" href="http://www.xformstest.org/">xformstest.org</a> +</li></ul> +{{ languages( { "en": "en/XForms/Other_Resources" } ) }} |