diff options
3764 files changed, 562547 insertions, 0 deletions
diff --git a/files/ar/_redirects.txt b/files/ar/_redirects.txt new file mode 100644 index 0000000000..5b6e089613 --- /dev/null +++ b/files/ar/_redirects.txt @@ -0,0 +1,37 @@ +# FROM-URL TO-URL +/ar/docs/HTML /ar/docs/Web/HTML +/ar/docs/Introduction /ar/docs/Mozilla/Developer_guide/Introduction +/ar/docs/Learn/CSS/Introduction_to_CSS /en-US/docs/Learn/CSS/First_steps +/ar/docs/Learn/CSS/Introduction_to_CSS/How_CSS_works /en-US/docs/Learn/CSS/First_steps/How_CSS_works +/ar/docs/Learn/CSS/Introduction_to_CSS/Selectors /en-US/docs/Learn/CSS/Building_blocks/Selectors +/ar/docs/Learn/Getting_started_with_the_web/%D8%A3%D8%B3%D8%A7%D8%B3%D9%8A%D8%A7%D8%AA_%D9%84%D8%BA%D8%A9_%D8%AA%D8%B1%D9%85%D9%8A%D8%B2_%D8%A7%D9%84%D9%86%D8%B5_%D8%A7%D9%84%D9%81%D8%A7%D8%A6%D9%82 /ar/docs/Learn/Getting_started_with_the_web/HTML_basics +/ar/docs/Learn/Getting_started_with_the_web/%D8%A7%D9%84%D8%AA%D8%B9%D8%A7%D9%85%D9%84_%D9%85%D8%B9_%D8%A7%D9%84%D9%85%D9%84%D9%81%D8%A7%D8%AA /ar/docs/Learn/Getting_started_with_the_web/Dealing_with_files +/ar/docs/Learn/Getting_started_with_the_web/%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA_%D8%A7%D9%84%D8%A8%D8%B1%D9%85%D8%AC%D9%8A%D8%A7%D8%AA_%D8%A7%D9%84%D8%A3%D8%B3%D8%A7%D8%B3%D9%8A%D8%A9 /ar/docs/Learn/Getting_started_with_the_web/Installing_basic_software +/ar/docs/Learn/Getting_started_with_the_web/%D9%83%D9%8A%D9%81_%D9%8A%D8%AC%D8%A8_%D8%A3%D9%86_%D9%8A%D8%A8%D8%AF%D9%88_%D9%85%D9%88%D9%82%D8%B9%D9%83 /ar/docs/Learn/Getting_started_with_the_web/What_will_your_website_look_like +/ar/docs/Learn/HTML/%D9%85%D9%82%D8%AF%D9%85%D8%A9_%D8%A5%D9%84%D9%89_%D9%84%D8%BA%D8%A9_%D8%AA%D8%B1%D9%85%D9%8A%D8%B2_%D8%A7%D9%84%D9%86%D8%B5_%D8%A7%D9%84%D9%81%D8%A7%D8%A6%D9%82 /ar/docs/Learn/HTML/Introduction_to_HTML +/ar/docs/Learn/HTML/%D9%85%D9%82%D8%AF%D9%85%D8%A9_%D8%A5%D9%84%D9%89_%D9%84%D8%BA%D8%A9_%D8%AA%D8%B1%D9%85%D9%8A%D8%B2_%D8%A7%D9%84%D9%86%D8%B5_%D8%A7%D9%84%D9%81%D8%A7%D8%A6%D9%82/Getting_started /ar/docs/Learn/HTML/Introduction_to_HTML/Getting_started +/ar/docs/Learn/HTML/%D9%85%D9%82%D8%AF%D9%85%D8%A9_%D8%A5%D9%84%D9%89_%D9%84%D8%BA%D8%A9_%D8%AA%D8%B1%D9%85%D9%8A%D8%B2_%D8%A7%D9%84%D9%86%D8%B5_%D8%A7%D9%84%D9%81%D8%A7%D8%A6%D9%82/HTML_text_fundamentals /ar/docs/Learn/HTML/Introduction_to_HTML/HTML_text_fundamentals +/ar/docs/MDN/Contribute/Guidelines /ar/docs/MDN/Guidelines +/ar/docs/MDN/Contribute/Guidelines/Writing_style_guide /ar/docs/MDN/Guidelines/Writing_style_guide +/ar/docs/MDN/Contribute/Tools /ar/docs/MDN/Tools +/ar/docs/MDN/Contribute/Tools/Deleting_pages /ar/docs/MDN/Tools/Deleting_pages +/ar/docs/MDN/Feedback /ar/docs/MDN/Contribute/Feedback +/ar/docs/MDN/Getting_started /ar/docs/MDN/Contribute/Getting_started +/ar/docs/MDN/User_guide /ar/docs/MDN/Tools +/ar/docs/MDN/User_guide/Deleting_pages /ar/docs/MDN/Tools/Deleting_pages +/ar/docs/Web/%D8%AF%D8%B1%D9%88%D8%B3 /ar/docs/Web/Tutorials +/ar/docs/Web/API/HTMLElement.contentEditable /ar/docs/Web/API/HTMLElement/contentEditable +/ar/docs/Web/Apps /ar/docs/Web/%D8%AA%D8%B7%D8%A8%D9%8A%D9%82%D8%A7%D8%AA +/ar/docs/Web/Guide/HTML /ar/docs/Learn/HTML +/ar/docs/Web/Guide/HTML/%D9%85%D9%82%D8%AF%D9%85%D8%A9 /ar/docs/Learn/HTML/Introduction_to_HTML +/ar/docs/Web/HTML/Element /ar/docs/HTML/Element +/ar/docs/Web/HTML/Element/bdo /ar/docs/HTML/Element/bdo +/ar/docs/Web/HTML/Element/headings_elements /ar/docs/HTML/Element/headings_elements +/ar/docs/Web/HTML/Element/hr /ar/docs/HTML/Element/hr +/ar/docs/Web/HTML/Element/i /ar/docs/HTML/Element/i +/ar/docs/Web/HTML/Element/main /ar/docs/HTML/Element/main +/ar/docs/Web/HTML/Element/span /ar/docs/HTML/Element/span +/ar/docs/Web/HTML/Element/tt /ar/docs/HTML/Element/tt +/ar/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Complete_list_of_MIME_types /ar/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types +/ar/docs/Web/JavaScript/Reference/Global_Objects/%D8%B1%D9%8A%D8%A7%D8%B6%D9%8A%D8%A7%D8%AA /ar/docs/Web/JavaScript/Reference/Global_Objects/Math +/ar/docs/en /en-US/ diff --git a/files/ar/_wikihistory.json b/files/ar/_wikihistory.json new file mode 100644 index 0000000000..b3c0700665 --- /dev/null +++ b/files/ar/_wikihistory.json @@ -0,0 +1,1866 @@ +{ + "Games": { + "modified": "2019-09-11T08:38:03.462Z", + "contributors": [ + "SphinxKnight", + "aminezouhair", + "wbamberg" + ] + }, + "Games/Techniques": { + "modified": "2019-01-17T03:24:22.867Z", + "contributors": [ + "wbamberg" + ] + }, + "Games/Techniques/3D_on_the_web": { + "modified": "2019-03-18T21:28:51.724Z", + "contributors": [ + "wbamberg" + ] + }, + "Games/Techniques/3D_on_the_web/Basic_theory": { + "modified": "2019-03-18T21:28:59.194Z", + "contributors": [ + "HusseinYounis" + ] + }, + "Glossary": { + "modified": "2019-03-23T23:11:22.322Z", + "contributors": [ + "wbamberg", + "ahmadnourallah", + "teoli" + ] + }, + "Glossary/API": { + "modified": "2020-08-25T20:10:54.712Z", + "contributors": [ + "duduindo", + "mcqueen10pr" + ] + }, + "Glossary/Accessibility": { + "modified": "2019-03-18T21:35:58.833Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Glossary/Algorithm": { + "modified": "2019-03-18T21:36:28.768Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Glossary/Argument": { + "modified": "2019-03-18T21:36:51.297Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Glossary/Attribute": { + "modified": "2019-03-18T21:36:29.428Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Glossary/Bandwidth": { + "modified": "2019-06-11T03:12:16.122Z", + "contributors": [ + "aminezouhair" + ] + }, + "Glossary/Blink": { + "modified": "2019-03-18T21:35:41.170Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Glossary/Boolean": { + "modified": "2019-03-18T21:31:11.758Z", + "contributors": [ + "mestoo" + ] + }, + "Glossary/Browser": { + "modified": "2019-03-18T21:36:31.049Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Glossary/Compile": { + "modified": "2019-03-18T21:23:37.200Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Glossary/Computer_Programming": { + "modified": "2019-03-18T21:16:51.875Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Glossary/Cookie": { + "modified": "2019-03-18T21:36:16.444Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Glossary/Copyleft": { + "modified": "2019-03-18T21:35:36.953Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Glossary/DOM": { + "modified": "2019-03-18T20:40:48.174Z", + "contributors": [ + "moussagigawatt" + ] + }, + "Glossary/DOS_attack": { + "modified": "2019-03-18T21:36:23.407Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Glossary/Data_structure": { + "modified": "2019-03-18T21:36:26.711Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Glossary/Decryption": { + "modified": "2019-03-18T21:36:31.371Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Glossary/Denial_of_Service": { + "modified": "2019-01-17T02:56:58.044Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Glossary/Forbidden_header_name": { + "modified": "2020-06-22T06:31:52.598Z", + "contributors": [ + "AboAeqab" + ] + }, + "Glossary/Function": { + "modified": "2019-03-18T21:36:11.164Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Glossary/GPL": { + "modified": "2019-03-18T21:35:39.106Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Glossary/Google_Chrome": { + "modified": "2019-03-23T23:11:25.083Z", + "contributors": [ + "ahmadnourallah", + "billhiba" + ] + }, + "Glossary/Grid_Areas": { + "modified": "2020-06-28T15:51:15.774Z", + "contributors": [ + "mos528884" + ] + }, + "Glossary/Hyperlink": { + "modified": "2019-03-18T21:35:47.475Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Glossary/Identifier": { + "modified": "2019-03-18T21:36:09.613Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Glossary/Mozilla_Firefox": { + "modified": "2019-03-18T21:36:31.912Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Glossary/OOP": { + "modified": "2019-03-18T21:17:28.449Z", + "contributors": [ + "HeSoKa05" + ] + }, + "Glossary/PHP": { + "modified": "2019-06-12T12:19:18.205Z", + "contributors": [ + "aminezouhair" + ] + }, + "Glossary/Parameter": { + "modified": "2019-03-18T21:36:56.678Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Glossary/Recursion": { + "modified": "2019-03-18T21:36:11.837Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Glossary/Rendering_engine": { + "modified": "2019-03-18T21:35:46.725Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Glossary/Search_engine": { + "modified": "2019-03-18T21:36:28.244Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Glossary/Semantics": { + "modified": "2020-08-29T02:02:08.247Z", + "contributors": [ + "M.M.J", + "ahmadnourallah" + ] + }, + "Glossary/Server": { + "modified": "2019-03-18T21:36:23.269Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Glossary/String": { + "modified": "2019-03-18T21:36:08.991Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Glossary/Tag": { + "modified": "2019-03-18T21:35:59.869Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Glossary/Variable": { + "modified": "2019-03-18T21:36:36.155Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Glossary/WAI": { + "modified": "2019-03-18T21:35:55.598Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Glossary/Wrapper": { + "modified": "2019-03-18T21:36:15.120Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Glossary/array": { + "modified": "2019-03-18T21:36:12.215Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Glossary/الحروف": { + "modified": "2019-03-18T20:41:14.582Z", + "contributors": [ + "moussagigawatt" + ] + }, + "Glossary/الخاصية": { + "modified": "2019-03-18T20:41:18.902Z", + "contributors": [ + "moussagigawatt" + ] + }, + "Glossary/الدوال_من_الدرجة_الأولى": { + "modified": "2019-03-18T21:43:51.692Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Glossary/الكائنات": { + "modified": "2019-03-18T21:23:58.693Z", + "contributors": [ + "ahmadnourallah", + "yagoub76" + ] + }, + "Glossary/المجالات": { + "modified": "2019-03-18T20:58:54.465Z", + "contributors": [ + "laloshify" + ] + }, + "HTML/Element": { + "modified": "2019-09-11T08:42:21.522Z", + "contributors": [ + "SphinxKnight", + "moaz_osama_okasha", + "elzoz531", + "teoli", + "HelmiHB" + ] + }, + "HTML/Element/article": { + "modified": "2020-10-15T22:31:03.274Z", + "contributors": [ + "M.M.J", + "a01273477051" + ] + }, + "HTML/Element/bdo": { + "modified": "2020-10-15T22:02:29.578Z", + "contributors": [ + "SphinxKnight", + "zidanlab" + ] + }, + "HTML/Element/headings_elements": { + "modified": "2020-10-15T22:08:39.845Z", + "contributors": [ + "SphinxKnight", + "Alhakem" + ] + }, + "HTML/Element/span": { + "modified": "2020-10-15T22:05:54.978Z", + "contributors": [ + "SphinxKnight", + "moaz_osama_okasha" + ] + }, + "HTML/Element/tt": { + "modified": "2020-10-15T22:05:53.553Z", + "contributors": [ + "SphinxKnight", + "moaz_osama_okasha" + ] + }, + "Learn": { + "modified": "2020-07-16T22:43:37.457Z", + "contributors": [ + "waleed5544", + "svarlamov", + "ahmadnourallah", + "yaser-alazem", + "atefBB", + "AbuShelbayeh", + "Andrew_Pfeiffer" + ] + }, + "Learn/Accessibility": { + "modified": "2020-07-16T22:39:55.334Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Learn/Accessibility/What_is_accessibility": { + "modified": "2020-07-16T22:40:02.857Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Learn/CSS": { + "modified": "2020-07-16T22:25:31.838Z", + "contributors": [ + "MOTZ79567", + "abdallahelmalawy", + "ashrafreda", + "chrisdavidmills" + ] + }, + "Learn/CSS/Building_blocks": { + "modified": "2020-07-16T22:28:06.517Z", + "contributors": [ + "salutis" + ] + }, + "Learn/CSS/Building_blocks/Selectors": { + "modified": "2020-07-16T22:28:34.404Z", + "contributors": [ + "mr0111240" + ] + }, + "Learn/CSS/Building_blocks/Selectors/Type_Class_and_ID_Selectors": { + "modified": "2020-07-16T22:28:38.491Z", + "contributors": [ + "Emory" + ] + }, + "Learn/CSS/CSS_layout": { + "modified": "2020-07-16T22:26:28.954Z", + "contributors": [ + "kalalmohammad", + "MNizam0802" + ] + }, + "Learn/CSS/First_steps": { + "modified": "2020-07-16T22:27:38.309Z", + "contributors": [ + "wasim1772" + ] + }, + "Learn/Common_questions": { + "modified": "2020-07-16T22:35:21.349Z", + "contributors": [ + "ahmadnourallah", + "stephaniehobson" + ] + }, + "Learn/Common_questions/What_is_a_web_server": { + "modified": "2020-07-16T22:35:31.003Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Learn/Common_questions/كيفية_عمل": { + "modified": "2020-09-14T10:55:57.301Z", + "contributors": [ + "hichamikka", + "mestoo" + ] + }, + "Learn/Front-end_web_developer": { + "modified": "2020-09-23T10:36:40.672Z", + "contributors": [ + "Ghaith_Qublan", + "mohamedalisaleh501" + ] + }, + "Learn/Getting_started_with_the_web": { + "modified": "2020-07-16T22:33:48.981Z", + "contributors": [ + "EngMoathOmar", + "ahmadnourallah", + "cloudresourcemanagergoogleapis", + "chrisdavidmills" + ] + }, + "Learn/Getting_started_with_the_web/Dealing_with_files": { + "modified": "2020-07-16T22:34:31.389Z", + "contributors": [ + "ahmadnourallah", + "jwhitlock" + ] + }, + "Learn/Getting_started_with_the_web/HTML_basics": { + "modified": "2020-07-16T22:34:41.479Z", + "contributors": [ + "aminezouhair", + "ahmadnourallah", + "jwhitlock" + ] + }, + "Learn/Getting_started_with_the_web/How_the_Web_works": { + "modified": "2020-09-01T21:08:17.715Z", + "contributors": [ + "fahad43926375", + "EngMoathOmar", + "ipfinder", + "aminezouhair" + ] + }, + "Learn/Getting_started_with_the_web/Installing_basic_software": { + "modified": "2020-07-16T22:34:05.245Z", + "contributors": [ + "ahmadnourallah", + "jwhitlock" + ] + }, + "Learn/Getting_started_with_the_web/JavaScript_basics": { + "modified": "2020-07-16T22:35:07.787Z", + "contributors": [ + "Mohd-PH", + "zidanlab" + ] + }, + "Learn/Getting_started_with_the_web/What_will_your_website_look_like": { + "modified": "2020-07-16T22:34:13.678Z", + "contributors": [ + "ahmadnourallah", + "jwhitlock" + ] + }, + "Learn/Getting_started_with_the_web/أساسيات_صفحات_الطرز_المتراصة": { + "modified": "2020-07-16T22:34:55.259Z", + "contributors": [ + "aminezouhair", + "sami-assasa", + "ahmadnourallah" + ] + }, + "Learn/HTML": { + "modified": "2020-07-16T22:22:14.487Z", + "contributors": [ + "aminezouhair", + "wasem1772", + "Alihoday", + "Andrew_Pfeiffer" + ] + }, + "Learn/HTML/Forms": { + "modified": "2020-12-06T05:54:22.728Z", + "contributors": [ + "coderclouds2018" + ] + }, + "Learn/HTML/Introduction_to_HTML": { + "modified": "2020-07-16T22:22:44.780Z", + "contributors": [ + "aminezouhair", + "ahmadnourallah", + "jwhitlock" + ] + }, + "Learn/HTML/Introduction_to_HTML/Getting_started": { + "modified": "2020-07-16T22:22:56.623Z", + "contributors": [ + "aminezouhair", + "ahmadnourallah", + "jwhitlock" + ] + }, + "Learn/HTML/Introduction_to_HTML/HTML_text_fundamentals": { + "modified": "2020-07-16T22:23:29.319Z", + "contributors": [ + "jwhitlock", + "ahmadnourallah" + ] + }, + "Learn/HTML/Multimedia_and_embedding": { + "modified": "2020-07-16T22:24:23.909Z", + "contributors": [ + "MOTZ79567", + "ezrinjaz" + ] + }, + "Learn/HTML/الجداول": { + "modified": "2020-07-16T22:25:09.678Z", + "contributors": [ + "aminezouhair" + ] + }, + "Learn/HTML/بسيطة_HTML_إنشاء_صفحة": { + "modified": "2020-07-16T22:22:26.344Z", + "contributors": [ + "wbamberg", + "mubarak823", + "mhmdiaa" + ] + }, + "Learn/How_to_contribute": { + "modified": "2020-07-16T22:33:42.427Z", + "contributors": [ + "SphinxKnight", + "ahmadnourallah" + ] + }, + "Learn/JavaScript": { + "modified": "2020-07-16T22:29:36.627Z", + "contributors": [ + "Mohd-PH", + "Roadsky", + "amirmekk", + "chrisdavidmills" + ] + }, + "Learn/JavaScript/First_steps": { + "modified": "2020-07-16T22:29:47.870Z", + "contributors": [ + "Mohd-PH", + "SphinxKnight" + ] + }, + "Learn/JavaScript/First_steps/A_first_splash": { + "modified": "2020-11-17T07:52:07.930Z", + "contributors": [ + "heshamali", + "ibrahim.ham" + ] + }, + "Learn/JavaScript/First_steps/Useful_string_methods": { + "modified": "2020-11-07T10:08:34.284Z", + "contributors": [ + "heshamali", + "GawiSh97" + ] + }, + "Learn/JavaScript/Objects": { + "modified": "2020-07-16T22:31:47.619Z", + "contributors": [ + "aminezouhair", + "ALSULTAN", + "moatazalshabuo", + "chrisdavidmills" + ] + }, + "Learn/JavaScript/Objects/Basics": { + "modified": "2020-07-16T22:31:55.874Z", + "contributors": [ + "Youssef-Belmeskine", + "atefBB" + ] + }, + "Learn/JavaScript/Objects/Inheritance": { + "modified": "2020-07-16T22:32:11.167Z", + "contributors": [ + "Youssef-Belmeskine", + "AbrahemAlhofe", + "MohammedAlaa88" + ] + }, + "Learn/JavaScript/Objects/Object-oriented_JS": { + "modified": "2020-07-16T22:32:04.348Z", + "contributors": [ + "Youssef-Belmeskine", + "atefBB" + ] + }, + "Learn/JavaScript/Objects/Object_prototypes": { + "modified": "2020-07-16T22:32:18.432Z", + "contributors": [ + "Youssef-Belmeskine", + "MohammedAlaa88", + "atefBB" + ] + }, + "Learn/Server-side": { + "modified": "2020-07-16T22:35:55.037Z", + "contributors": [ + "moussagigawatt" + ] + }, + "Learn/Server-side/Django": { + "modified": "2020-07-18T13:31:54.614Z", + "contributors": [ + "tawfik123", + "kruschk" + ] + }, + "Learn/Server-side/Express_Nodejs": { + "modified": "2020-07-16T22:37:50.857Z", + "contributors": [ + "ckashby" + ] + }, + "MDN": { + "modified": "2020-02-19T19:23:57.984Z", + "contributors": [ + "jswisher", + "SphinxKnight", + "aminezouhair", + "wbamberg", + "ahmadnourallah", + "Jeremie", + "MoniV", + "ziyunfei" + ] + }, + "MDN/About": { + "modified": "2019-09-10T08:50:08.705Z", + "contributors": [ + "SphinxKnight", + "wbamberg", + "ahmadnourallah" + ] + }, + "MDN/Community": { + "modified": "2019-03-23T22:39:46.468Z", + "contributors": [ + "wbamberg", + "ahmadnourallah", + "Jeremie", + "1071432726" + ] + }, + "MDN/Community/Whats_happening": { + "modified": "2019-06-11T03:43:32.787Z", + "contributors": [ + "aminezouhair" + ] + }, + "MDN/Contribute": { + "modified": "2019-03-23T23:16:50.906Z", + "contributors": [ + "wbamberg", + "ahmadnourallah", + "Jeremie", + "Mars" + ] + }, + "MDN/Contribute/Feedback": { + "modified": "2020-09-30T17:50:14.200Z", + "contributors": [ + "chrisdavidmills", + "SphinxKnight", + "aminezouhair", + "wbamberg", + "ahmadnourallah" + ] + }, + "MDN/Contribute/Getting_started": { + "modified": "2020-09-30T17:08:48.786Z", + "contributors": [ + "chrisdavidmills", + "wbamberg", + "ahmadnourallah", + "Abu3safeer", + "ihanafieh", + "T9nf" + ] + }, + "MDN/Contribute/Howto": { + "modified": "2019-01-16T19:20:51.257Z", + "contributors": [ + "wbamberg", + "Jeremie", + "Sheppy" + ] + }, + "MDN/Contribute/Howto/Do_a_technical_review": { + "modified": "2019-06-10T14:47:38.844Z", + "contributors": [ + "aminezouhair", + "wbamberg", + "ashqaljnoob" + ] + }, + "MDN/Contribute/Howto/Do_an_editorial_review": { + "modified": "2019-06-15T16:26:58.954Z", + "contributors": [ + "aminezouhair" + ] + }, + "MDN/Contribute/Howto/Report_a_problem": { + "modified": "2020-01-07T12:21:22.751Z", + "contributors": [ + "peterbe", + "aminezouhair" + ] + }, + "MDN/Contribute/Howto/Set_the_summary_for_a_page": { + "modified": "2020-02-14T19:30:29.921Z", + "contributors": [ + "a0m0rajab", + "maherv" + ] + }, + "MDN/Contribute/Howto/Tag": { + "modified": "2019-09-10T11:04:17.206Z", + "contributors": [ + "wasim1772", + "wasem1772" + ] + }, + "MDN/Contribute/Howto/Write_a_new_entry_in_the_Glossary": { + "modified": "2019-06-15T16:35:07.831Z", + "contributors": [ + "aminezouhair" + ] + }, + "MDN/Contribute/Howto/Write_an_article_to_help_learn_about_the_Web": { + "modified": "2020-02-28T22:26:02.885Z", + "contributors": [ + "aminezouhair" + ] + }, + "MDN/Contribute/Howto/إنشاء_حساب_على_شبكة_مطوري_موزيلا": { + "modified": "2019-06-11T03:35:08.931Z", + "contributors": [ + "aminezouhair", + "wbamberg", + "ahmadnourallah", + "mhmdiaa", + "Syrian-Guy" + ] + }, + "MDN/Contribute/Howto/كيفية_إنشاء_وتحرير_الصفحات": { + "modified": "2019-03-18T21:28:07.470Z", + "contributors": [ + "AhmedElhatem" + ] + }, + "MDN/Contribute/Localize": { + "modified": "2019-01-16T18:57:05.647Z", + "contributors": [ + "wbamberg", + "Sheppy" + ] + }, + "MDN/Contribute/Localize/صفحات_الترجمة": { + "modified": "2019-12-17T21:16:51.749Z", + "contributors": [ + "wbamberg", + "ahmadnourallah", + "MoniV", + "iamaro", + "MohamedDZ", + "moncef.hammou" + ] + }, + "MDN/Guidelines": { + "modified": "2020-09-30T15:27:52.369Z", + "contributors": [ + "chrisdavidmills", + "wbamberg" + ] + }, + "MDN/Guidelines/Writing_style_guide": { + "modified": "2020-09-30T15:27:53.353Z", + "contributors": [ + "chrisdavidmills", + "jswisher", + "maherv" + ] + }, + "MDN/Kuma": { + "modified": "2019-09-09T15:51:34.712Z", + "contributors": [ + "SphinxKnight", + "wbamberg", + "ahmadnourallah", + "dr-m1991" + ] + }, + "MDN/Tools": { + "modified": "2020-09-30T16:47:53.767Z", + "contributors": [ + "chrisdavidmills", + "wbamberg", + "Jeremie", + "Sheppy" + ] + }, + "MDN/Tools/Deleting_pages": { + "modified": "2020-09-30T16:47:53.745Z", + "contributors": [ + "chrisdavidmills", + "wbamberg", + "Jeremie", + "Bettr", + "iii59300" + ] + }, + "MDN_at_ten": { + "modified": "2019-03-23T22:44:47.432Z", + "contributors": [ + "M.IRAQY999" + ] + }, + "Mozilla": { + "modified": "2019-03-23T23:28:10.569Z", + "contributors": [ + "Daef32", + "Sheppy" + ] + }, + "Mozilla/Add-ons": { + "modified": "2019-09-09T13:12:40.993Z", + "contributors": [ + "SphinxKnight", + "asromre1", + "MGWVc", + "mazenaliyane", + "google", + "hamada7-ym1403", + "viiiiiip123", + "Sheppy" + ] + }, + "Mozilla/Add-ons/WebExtensions": { + "modified": "2020-01-01T18:00:38.391Z", + "contributors": [ + "Anonymous", + "ahmadnourallah", + "ahmedhemada", + "mconca" + ] + }, + "Mozilla/Add-ons/WebExtensions/API": { + "modified": "2019-11-26T22:20:07.365Z", + "contributors": [ + "wbamberg", + "stephaniehobson" + ] + }, + "Mozilla/Add-ons/WebExtensions/API/browsingData": { + "modified": "2020-10-15T22:33:14.238Z", + "contributors": [ + "namma2012" + ] + }, + "Mozilla/Add-ons/WebExtensions/API/contentScripts": { + "modified": "2020-10-15T22:02:46.821Z", + "contributors": [ + "tikooooo" + ] + }, + "Mozilla/Add-ons/WebExtensions/Match_patterns": { + "modified": "2019-03-18T21:03:12.955Z", + "contributors": [ + "kremx80" + ] + }, + "Mozilla/Add-ons/WebExtensions/manifest.json": { + "modified": "2020-10-15T21:59:58.901Z", + "contributors": [ + "wbamberg" + ] + }, + "Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts": { + "modified": "2020-10-15T21:59:55.952Z", + "contributors": [ + "wbamberg", + "ralshammrei" + ] + }, + "Mozilla/Add-ons/WebExtensions/ما_هي_امتدادات_الويب": { + "modified": "2020-01-01T17:57:33.756Z", + "contributors": [ + "Anonymous" + ] + }, + "Mozilla/Developer_guide": { + "modified": "2019-03-23T22:03:05.275Z", + "contributors": [ + "glasserc" + ] + }, + "Mozilla/Developer_guide/Adding_APIs_to_the_navigator_object": { + "modified": "2020-08-11T20:05:10.710Z", + "contributors": [ + "shykhalwadym01" + ] + }, + "Mozilla/Developer_guide/Source_Code": { + "modified": "2020-06-23T10:39:42.136Z", + "contributors": [ + "mohameddz010203" + ] + }, + "Mozilla/Firefox": { + "modified": "2019-09-10T14:57:18.485Z", + "contributors": [ + "SphinxKnight", + "wbamberg", + "ahmadnourallah", + "Benseidseid", + "XMKMX_1937_XMKMX", + "3Li", + "asd996" + ] + }, + "Mozilla/Firefox/Releases": { + "modified": "2020-07-19T01:50:20.887Z", + "contributors": [ + "chrisdavidmills" + ] + }, + "Tools": { + "modified": "2020-07-16T22:44:13.280Z", + "contributors": [ + "SphinxKnight", + "aminezouhair", + "irenesmith", + "hamoody", + "Rami055302" + ] + }, + "Tools/Browser_Console": { + "modified": "2020-07-16T22:35:41.935Z", + "contributors": [ + "ssa918362" + ] + }, + "Tools/Page_Inspector": { + "modified": "2020-08-05T15:30:36.106Z", + "contributors": [ + "jswisher" + ] + }, + "Tools/Page_Inspector/How_to": { + "modified": "2020-08-05T15:30:36.225Z" + }, + "Tools/Storage_Inspector": { + "modified": "2020-07-16T22:36:09.328Z", + "contributors": [ + "7to328" + ] + }, + "Tools/Web_Console": { + "modified": "2020-07-16T22:34:03.927Z", + "contributors": [ + "HeSoKa05" + ] + }, + "Tools/Web_Console/The_command_line_interpreter": { + "modified": "2020-07-16T22:34:18.356Z", + "contributors": [ + "fasol1f" + ] + }, + "Web": { + "modified": "2020-04-16T08:53:18.820Z", + "contributors": [ + "ahmadnourallah", + "hayamgamil26", + "Anonymous", + "alktub", + "aminezouhair", + "mohamed7afezz", + "walidamriou", + "antaraz", + "kadimi", + "ethertank", + "fusionchess" + ] + }, + "Web/API": { + "modified": "2019-03-23T23:12:32.062Z", + "contributors": [ + "ahmadnourallah", + "SafaAlfulaij", + "jehad1123", + "iii59300", + "Ab_sahb2011", + "nickwong" + ] + }, + "Web/API/Attr": { + "modified": "2020-10-15T22:29:41.057Z", + "contributors": [ + "joree20003" + ] + }, + "Web/API/Canvas_API": { + "modified": "2019-03-18T21:38:39.416Z", + "contributors": [ + "SafaAlfulaij" + ] + }, + "Web/API/DOMTokenList": { + "modified": "2020-10-15T22:07:40.998Z", + "contributors": [ + "xfq" + ] + }, + "Web/API/DOMTokenList/length": { + "modified": "2020-10-15T22:07:42.370Z", + "contributors": [ + "GawiSh97" + ] + }, + "Web/API/Document": { + "modified": "2019-07-30T13:32:03.743Z", + "contributors": [ + "alwayslearnedstuff" + ] + }, + "Web/API/Document/designMode": { + "modified": "2019-03-23T22:02:58.144Z", + "contributors": [ + "khaled3afan" + ] + }, + "Web/API/Element": { + "modified": "2019-03-18T21:09:03.057Z", + "contributors": [ + "fscholz", + "fvsch" + ] + }, + "Web/API/Element/className": { + "modified": "2019-03-23T22:07:01.121Z", + "contributors": [ + "Abu3safeer" + ] + }, + "Web/API/Element/closest": { + "modified": "2020-10-15T22:31:36.454Z", + "contributors": [ + "suqbit" + ] + }, + "Web/API/Element/insertAdjacentHTML": { + "modified": "2020-10-15T22:31:15.283Z", + "contributors": [ + "suqbit" + ] + }, + "Web/API/Event": { + "modified": "2019-03-23T23:00:25.185Z", + "contributors": [ + "teoli" + ] + }, + "Web/API/Geolocation": { + "modified": "2019-03-23T22:48:52.907Z", + "contributors": [ + "fscholz" + ] + }, + "Web/API/Geolocation/Using_geolocation": { + "modified": "2019-08-31T16:04:10.213Z", + "contributors": [ + "1043465747", + "elsisi" + ] + }, + "Web/API/Geolocation/Using_geolocation/Using_the_Geolocation_API": { + "modified": "2020-03-22T20:37:24.802Z", + "contributors": [ + "i7cn" + ] + }, + "Web/API/HTMLElement": { + "modified": "2019-03-23T23:00:29.058Z", + "contributors": [ + "teoli" + ] + }, + "Web/API/HTMLElement/contentEditable": { + "modified": "2019-03-23T23:12:35.618Z", + "contributors": [ + "teoli", + "Syrian-Guy" + ] + }, + "Web/API/History_API": { + "modified": "2019-03-23T22:22:50.858Z", + "contributors": [ + "SphinxKnight", + "iJianHuang" + ] + }, + "Web/API/History_API/مثال": { + "modified": "2019-03-23T22:22:46.391Z", + "contributors": [ + "atefBB" + ] + }, + "Web/API/Navigator": { + "modified": "2019-03-23T22:15:21.162Z", + "contributors": [ + "Sheppy" + ] + }, + "Web/API/Navigator.battery": { + "modified": "2019-03-23T23:12:40.096Z", + "contributors": [ + "jsx", + "Syrian-Guy" + ] + }, + "Web/API/Node": { + "modified": "2020-10-15T22:29:49.949Z", + "contributors": [ + "Sheppy" + ] + }, + "Web/API/Node/removeChild": { + "modified": "2020-10-15T22:29:47.795Z", + "contributors": [ + "SphinxKnight", + "bodykabetano" + ] + }, + "Web/API/Window": { + "modified": "2020-10-15T22:32:14.260Z", + "contributors": [ + "ANH25" + ] + }, + "Web/API/Window/DOMContentLoaded_event": { + "modified": "2020-10-15T22:33:25.719Z", + "contributors": [ + "katbi89" + ] + }, + "Web/API/Window/alert": { + "modified": "2020-10-15T22:31:54.660Z", + "contributors": [ + "Sultan-Alrefaei" + ] + }, + "Web/API/XSLTProcessor": { + "modified": "2020-10-15T22:07:58.558Z", + "contributors": [ + "ExE-Boss" + ] + }, + "Web/API/XSLTProcessor/Basic_Example": { + "modified": "2019-03-18T21:28:33.053Z", + "contributors": [ + "EnasMahdy" + ] + }, + "Web/Accessibility": { + "modified": "2020-03-18T03:39:58.995Z", + "contributors": [ + "SphinxKnight", + "ahmadnourallah", + "hasabonassor" + ] + }, + "Web/CSS": { + "modified": "2019-09-11T03:31:55.318Z", + "contributors": [ + "SphinxKnight", + "ahmadnourallah", + "Qlbaz" + ] + }, + "Web/CSS/Attribute_selectors": { + "modified": "2020-10-15T22:10:15.383Z", + "contributors": [ + "zidanlab" + ] + }, + "Web/CSS/CSS_Flexible_Box_Layout": { + "modified": "2020-03-28T04:45:36.291Z", + "contributors": [ + "vnctdj" + ] + }, + "Web/CSS/CSS_Flexible_Box_Layout/المفاهيم_الأساسية_للصندوق_المرن": { + "modified": "2020-03-28T05:18:29.446Z", + "contributors": [ + "Mutazalhawash" + ] + }, + "Web/CSS/CSS_Grid_Layout": { + "modified": "2019-03-18T21:35:22.946Z", + "contributors": [ + "AmineBelmili", + "rachelandrew" + ] + }, + "Web/CSS/CSS_Grid_Layout/Relationship_of_Grid_Layout_arabic": { + "modified": "2019-03-18T21:35:18.134Z", + "contributors": [ + "harchaoui" + ] + }, + "Web/CSS/CSS_Writing_Modes": { + "modified": "2019-03-23T22:03:16.266Z", + "contributors": [ + "Micro-Shadi" + ] + }, + "Web/CSS/Reference": { + "modified": "2019-06-30T14:40:59.845Z", + "contributors": [ + "ESlam247" + ] + }, + "Web/CSS/align-content": { + "modified": "2020-10-17T19:46:08.545Z", + "contributors": [ + "chouaib" + ] + }, + "Web/CSS/order": { + "modified": "2020-10-15T22:25:59.036Z", + "contributors": [ + "CU1KNIGHT" + ] + }, + "Web/CSS/pointer-events": { + "modified": "2020-10-15T22:16:23.258Z", + "contributors": [ + "duduindo", + "AF555" + ] + }, + "Web/CSS/التحول": { + "modified": "2020-10-15T22:06:18.420Z", + "contributors": [ + "mohamadlounnas" + ] + }, + "Web/CSS/التعليقات": { + "modified": "2019-03-23T22:09:00.996Z", + "contributors": [ + "Abu3safeer" + ] + }, + "Web/CSS/العناصر_التي_يمكن_تحريكها_باستخدام_CSS_Transitions": { + "modified": "2019-03-23T22:09:06.742Z", + "contributors": [ + "Abu3safeer" + ] + }, + "Web/Events": { + "modified": "2020-07-05T11:11:44.298Z", + "contributors": [ + "suqbit" + ] + }, + "Web/Guide": { + "modified": "2019-03-23T23:26:08.829Z", + "contributors": [ + "NadhirBoukhenifra", + "kadimi", + "Sheppy" + ] + }, + "Web/Guide/CSS": { + "modified": "2019-03-23T23:26:10.869Z", + "contributors": [ + "Sheppy" + ] + }, + "Web/Guide/CSS/Getting_started": { + "modified": "2019-03-23T22:26:23.175Z", + "contributors": [ + "wjinca" + ] + }, + "Web/Guide/CSS/Getting_started/Readable_CSS": { + "modified": "2019-03-23T22:26:15.891Z", + "contributors": [ + "atefBB", + "Muhnad" + ] + }, + "Web/Guide/CSS/Getting_started/القوائم": { + "modified": "2019-03-23T22:26:05.454Z", + "contributors": [ + "atefBB", + "EmanShaltoutTrend" + ] + }, + "Web/Guide/HTML/HTML5": { + "modified": "2020-10-19T18:49:26.722Z", + "contributors": [ + "moussa32", + "teoli", + ".1234waleed", + "ess_a25", + "John.Smith" + ] + }, + "Web/Guide/HTML/HTML5/HTML5_element_list": { + "modified": "2019-03-23T23:14:56.560Z", + "contributors": [ + "Abu3safeer", + "atefBB", + "mohamedmahmoud", + "teoli", + "Ali.Talib" + ] + }, + "Web/Guide/الرسومات": { + "modified": "2019-03-18T21:43:50.204Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Web/HTML": { + "modified": "2019-09-11T08:59:54.831Z", + "contributors": [ + "SphinxKnight" + ] + }, + "Web/HTML/Element/input": { + "modified": "2020-10-15T22:35:12.617Z", + "contributors": [ + "chrisdavidmills" + ] + }, + "Web/HTML/Element/input/radio": { + "modified": "2020-10-15T22:35:10.964Z", + "contributors": [ + "mhayajneh" + ] + }, + "Web/HTML_لغة_ترميز_النص_الفائق": { + "modified": "2019-09-11T08:10:23.337Z", + "contributors": [ + "SphinxKnight", + "aminezouhair", + "ahmadnourallah", + "antaraz" + ] + }, + "Web/HTTP": { + "modified": "2019-12-23T16:16:43.680Z", + "contributors": [ + "syednomanfaakhir", + "aminezouhair", + "ahmadnourallah", + "ahmadmayahi" + ] + }, + "Web/HTTP/Basics_of_HTTP": { + "modified": "2019-03-18T21:20:43.883Z", + "contributors": [ + "ExE-Boss" + ] + }, + "Web/HTTP/Basics_of_HTTP/MIME_types": { + "modified": "2019-03-18T21:20:43.648Z", + "contributors": [ + "sideshowbarker" + ] + }, + "Web/HTTP/Basics_of_HTTP/MIME_types/Common_types": { + "modified": "2020-02-28T13:10:36.312Z", + "contributors": [ + "chrisdavidmills", + "SphinxKnight", + "bz-a" + ] + }, + "Web/HTTP/Connection_management_in_HTTP_1.x": { + "modified": "2020-06-22T06:07:59.299Z", + "contributors": [ + "semsm128" + ] + }, + "Web/HTTP/Headers": { + "modified": "2019-12-03T06:31:26.128Z", + "contributors": [ + "Malvoz" + ] + }, + "Web/HTTP/Overview": { + "modified": "2020-10-30T02:06:11.197Z", + "contributors": [ + "gms.2000.9.12" + ] + }, + "Web/JavaScript": { + "modified": "2020-05-08T07:16:04.132Z", + "contributors": [ + "joree20003", + "SphinxKnight", + "abdu56", + "ahmadnourallah", + "zidanlab", + "Boukhtam", + "maherv", + "DevOsamaMohamed", + "Benseidseid", + "kadimi", + "walidov", + "riva7", + "ralshammrei2", + "NISHANTSHRESHTH" + ] + }, + "Web/JavaScript/About_JavaScript": { + "modified": "2020-03-12T19:47:47.486Z", + "contributors": [ + "HeSoKa05" + ] + }, + "Web/JavaScript/Guide": { + "modified": "2020-03-12T19:42:18.289Z", + "contributors": [ + "Benseidseid", + "Naaman", + "SphinxKnight" + ] + }, + "Web/JavaScript/Guide/Control_flow_and_error_handling": { + "modified": "2020-03-12T19:45:33.664Z", + "contributors": [ + "Youssef-Belmeskine" + ] + }, + "Web/JavaScript/Guide/Grammar_and_types": { + "modified": "2020-03-12T19:42:15.788Z", + "contributors": [ + "atefBB", + "Youssef-Belmeskine", + "Benseidseid", + "Naaman", + "jwasily" + ] + }, + "Web/JavaScript/Guide/Introduction": { + "modified": "2020-03-12T19:42:21.553Z", + "contributors": [ + "Youssef-Belmeskine", + "Benseidseid", + "Naaman" + ] + }, + "Web/JavaScript/Guide/Loops_and_iteration": { + "modified": "2020-03-12T19:45:31.602Z", + "contributors": [ + "Youssef-Belmeskine" + ] + }, + "Web/JavaScript/Guide/Regular_Expressions": { + "modified": "2020-03-12T19:47:23.942Z", + "contributors": [ + "Youssef-Belmeskine", + "SafaAlfulaij" + ] + }, + "Web/JavaScript/Guide/Working_with_Objects": { + "modified": "2020-03-12T19:45:29.171Z", + "contributors": [ + "Youssef-Belmeskine", + "SphinxKnight" + ] + }, + "Web/JavaScript/Guide/الدوال": { + "modified": "2020-03-12T19:44:03.918Z", + "contributors": [ + "Youssef-Belmeskine", + "Benseidseid" + ] + }, + "Web/JavaScript/Introduction_to_Object-Oriented_JavaScript": { + "modified": "2020-03-12T19:44:59.681Z", + "contributors": [ + "HeSoKa05", + "Youssef-Belmeskine", + "mustafasalah" + ] + }, + "Web/JavaScript/Reference": { + "modified": "2020-03-12T19:39:44.947Z", + "contributors": [ + "maherv", + "LJHarb" + ] + }, + "Web/JavaScript/Reference/Classes": { + "modified": "2020-10-15T22:05:06.152Z", + "contributors": [ + "rwaldron" + ] + }, + "Web/JavaScript/Reference/Classes/constructor": { + "modified": "2020-10-15T22:05:06.518Z", + "contributors": [ + "MohammedAlaa88" + ] + }, + "Web/JavaScript/Reference/Errors": { + "modified": "2020-03-12T19:48:15.925Z", + "contributors": [ + "Sheppy" + ] + }, + "Web/JavaScript/Reference/Errors/Unexpected_type": { + "modified": "2020-03-12T19:48:14.682Z", + "contributors": [ + "mohamadlounnas" + ] + }, + "Web/JavaScript/Reference/Global_Objects": { + "modified": "2020-03-12T19:39:41.981Z", + "contributors": [ + "SphinxKnight", + "fscholz" + ] + }, + "Web/JavaScript/Reference/Global_Objects/Array": { + "modified": "2019-03-23T22:26:28.438Z", + "contributors": [ + "DevOsamaMohamed" + ] + }, + "Web/JavaScript/Reference/Global_Objects/Array/isArray": { + "modified": "2019-06-23T15:06:41.749Z", + "contributors": [ + "GawiSh97", + "DevOsamaMohamed" + ] + }, + "Web/JavaScript/Reference/Global_Objects/Array/join": { + "modified": "2019-03-23T22:26:12.736Z", + "contributors": [ + "Abu3safeer", + "DevOsamaMohamed" + ] + }, + "Web/JavaScript/Reference/Global_Objects/Array/pop": { + "modified": "2019-03-23T22:26:21.251Z", + "contributors": [ + "Dr-Rakcha" + ] + }, + "Web/JavaScript/Reference/Global_Objects/Array/reverse": { + "modified": "2019-03-23T22:26:07.581Z", + "contributors": [ + "DevOsamaMohamed" + ] + }, + "Web/JavaScript/Reference/Global_Objects/Array/slice": { + "modified": "2020-10-15T22:31:18.515Z", + "contributors": [ + "suqbit" + ] + }, + "Web/JavaScript/Reference/Global_Objects/Date": { + "modified": "2019-03-23T23:09:44.322Z", + "contributors": [ + "GawiSh97", + "bekti", + "fscholz" + ] + }, + "Web/JavaScript/Reference/Global_Objects/Date/UTC": { + "modified": "2020-10-15T22:07:16.359Z", + "contributors": [ + "GawiSh97" + ] + }, + "Web/JavaScript/Reference/Global_Objects/Date/getDate": { + "modified": "2020-10-15T22:07:16.005Z", + "contributors": [ + "GawiSh97" + ] + }, + "Web/JavaScript/Reference/Global_Objects/Date/now": { + "modified": "2020-10-15T21:56:36.366Z", + "contributors": [ + "GawiSh97", + "Abu3safeer" + ] + }, + "Web/JavaScript/Reference/Global_Objects/Date/parse": { + "modified": "2020-10-15T22:07:15.028Z", + "contributors": [ + "GawiSh97" + ] + }, + "Web/JavaScript/Reference/Global_Objects/Date/setDate": { + "modified": "2020-10-15T22:07:16.408Z", + "contributors": [ + "GawiSh97" + ] + }, + "Web/JavaScript/Reference/Global_Objects/Function": { + "modified": "2020-10-15T22:05:05.412Z", + "contributors": [ + "danielsamuels" + ] + }, + "Web/JavaScript/Reference/Global_Objects/Function/call": { + "modified": "2020-10-15T22:05:04.168Z", + "contributors": [ + "ViNoS-ab", + "Youssef-Belmeskine", + "MohammedAlaa88" + ] + }, + "Web/JavaScript/Reference/Global_Objects/JSON": { + "modified": "2019-03-23T23:01:55.663Z", + "contributors": [ + "Mingun" + ] + }, + "Web/JavaScript/Reference/Global_Objects/Map": { + "modified": "2020-10-15T22:31:39.296Z", + "contributors": [ + "mohamed.yahya.zakria73" + ] + }, + "Web/JavaScript/Reference/Global_Objects/Math": { + "modified": "2020-10-15T22:14:04.029Z", + "contributors": [ + "SphinxKnight", + "ALSULTAN" + ] + }, + "Web/JavaScript/Reference/Global_Objects/Object": { + "modified": "2020-10-15T22:05:05.541Z", + "contributors": [ + "stmoreau" + ] + }, + "Web/JavaScript/Reference/Global_Objects/Object/constructor": { + "modified": "2020-10-15T22:05:03.728Z", + "contributors": [ + "MohammedAlaa88" + ] + }, + "Web/JavaScript/Reference/Global_Objects/String": { + "modified": "2020-10-15T21:56:27.422Z", + "contributors": [ + "Qrsan", + "fscholz" + ] + }, + "Web/JavaScript/Reference/Global_Objects/String/startsWith": { + "modified": "2020-10-15T22:22:14.192Z", + "contributors": [ + "Mourad_Ouchane" + ] + }, + "Web/JavaScript/Reference/Global_Objects/الارقام": { + "modified": "2020-10-10T09:54:31.841Z", + "contributors": [ + "Flemer" + ] + }, + "Web/JavaScript/Reference/Operators": { + "modified": "2020-12-07T20:30:16.758Z", + "contributors": [ + "Arous" + ] + }, + "Web/JavaScript/Reference/Operators/Destructuring_assignment": { + "modified": "2020-10-15T22:30:09.713Z", + "contributors": [ + "hasheemeg" + ] + }, + "Web/JavaScript/Reference/Operators/Object_initializer": { + "modified": "2020-03-12T19:45:32.164Z", + "contributors": [ + "poode", + "Youssef-Belmeskine" + ] + }, + "Web/JavaScript/Reference/Operators/Operator_Precedence": { + "modified": "2020-03-12T19:49:40.482Z", + "contributors": [ + "suqbit" + ] + }, + "Web/JavaScript/Reference/Operators/new": { + "modified": "2020-10-15T22:33:30.546Z", + "contributors": [ + "noqp312" + ] + }, + "Web/JavaScript/Reference/Operators/this": { + "modified": "2020-10-15T22:29:18.195Z", + "contributors": [ + "h6t9m205" + ] + }, + "Web/JavaScript/Reference/Statements": { + "modified": "2020-03-12T19:44:08.522Z", + "contributors": [ + "fscholz" + ] + }, + "Web/JavaScript/Reference/Statements/return": { + "modified": "2020-11-23T19:27:26.302Z", + "contributors": [ + "skarfstri" + ] + }, + "Web/JavaScript/Reference/الدوال": { + "modified": "2020-03-12T19:44:04.047Z", + "contributors": [ + "Benseidseid" + ] + }, + "Web/JavaScript/Reference/الدوال/get": { + "modified": "2020-10-15T22:32:22.148Z", + "contributors": [ + "abdwfawzy985" + ] + }, + "Web/MathML": { + "modified": "2019-03-23T22:01:47.703Z", + "contributors": [ + "ahmadnourallah" + ] + }, + "Web/SVG": { + "modified": "2019-03-23T23:09:34.687Z", + "contributors": [ + "plgatto" + ] + }, + "Web/SVG/Attribute": { + "modified": "2019-03-23T23:09:27.790Z", + "contributors": [ + "stevenvachon" + ] + }, + "Web/Tutorials": { + "modified": "2019-03-23T22:49:35.256Z", + "contributors": [ + "sami-assasa", + "ahmadnourallah", + "jwhitlock", + "hamza-mostafa", + "antaraz" + ] + }, + "Web/حماية": { + "modified": "2019-09-10T16:31:27.104Z", + "contributors": [ + "SphinxKnight", + "aminezouhair" + ] + }, + "Web/مرجع.": { + "modified": "2020-09-14T07:03:21.633Z", + "contributors": [ + "coderclouds2018", + "ashqaljnoob07", + "Syrian-Guy" + ] + }, + "Web_Development": { + "modified": "2019-03-23T23:25:33.143Z", + "contributors": [ + "ethertank" + ] + }, + "Web_Development/Mobile": { + "modified": "2019-03-23T23:25:26.627Z", + "contributors": [ + "BenB" + ] + }, + "heesfoord007": { + "modified": "2019-03-23T22:50:44.174Z", + "contributors": [ + "heesfoord007" + ] + }, + "أحداث_مكتبة_jQuery": { + "modified": "2019-03-23T23:08:54.898Z", + "contributors": [ + "Syrian-Guy" + ] + }, + "مكتبة_جي_كويري": { + "modified": "2019-03-23T23:08:46.056Z", + "contributors": [ + "Syrian-Guy" + ] + }, + "واصفة_SpellCheck_الجديدة_في_HTML5": { + "modified": "2019-03-23T23:11:43.327Z", + "contributors": [ + "Syrian-Guy" + ] + }, + "واصفة_العنوان_في_HTML": { + "modified": "2019-03-23T23:11:41.974Z", + "contributors": [ + "Syrian-Guy" + ] + } +}
\ No newline at end of file diff --git a/files/ar/archive/beginner_tutorials/index.html b/files/ar/archive/beginner_tutorials/index.html new file mode 100644 index 0000000000..ea5374f1e3 --- /dev/null +++ b/files/ar/archive/beginner_tutorials/index.html @@ -0,0 +1,11 @@ +--- +title: Beginner tutorials +slug: Archive/Beginner_tutorials +tags: + - NeedsTranslation + - TopicStub +translation_of: Archive/Beginner_tutorials +--- +<p class="summary">This page includes archived beginners tutorials, from various places around MDN.</p> + +<dl><dt class="landingPageList"><a href="/en-US/docs/Archive/Beginner_tutorials/Using_XBL_from_stylesheets">Creating reusable content with CSS and XBL</a></dt><dd class="landingPageList">This page illustrates how you can use <a href="/en-US/docs/Web/CSS">CSS</a> in Mozilla to improve the structure of complex applications, making code and resources more easily reusable.</dd><dt class="landingPageList"><a href="/en-US/docs/Archive/Beginner_tutorials/Underscores_in_class_and_ID_Names">Underscores in class and ID Names</a></dt><dd class="landingPageList"><span class="comment">Summary: The use of the underscore character in CSS can lead to major display problems in multiple browsers. Learn why this is so, and how to keep your sites from being bitten by this problem.</span> This technical note examines the use of underscores in CSS, and why they should be generally avoided in most circumstances.</dd><dt class="landingPageList"><a href="/en-US/docs/Archive/Beginner_tutorials/XML_data">XML data</a></dt><dd class="landingPageList">This page contains an example of how you can use CSS with XML data.</dd><dt class="landingPageList"><a href="/en-US/docs/Archive/Beginner_tutorials/XUL_user_interfaces">XUL user interfaces</a></dt><dd class="landingPageList">This page illustrates Mozilla's specialized language for creating user interfaces.</dd></dl> diff --git a/files/ar/archive/beginner_tutorials/underscores_in_class_and_id_names/index.html b/files/ar/archive/beginner_tutorials/underscores_in_class_and_id_names/index.html new file mode 100644 index 0000000000..9cb8cb0874 --- /dev/null +++ b/files/ar/archive/beginner_tutorials/underscores_in_class_and_id_names/index.html @@ -0,0 +1,61 @@ +--- +title: الشرطات السفلية (_) في اسماء محددات الاصناف والمعرفات (Class & ID) +slug: Archive/Beginner_tutorials/Underscores_in_class_and_ID_Names +translation_of: Archive/Beginner_tutorials/Underscores_in_class_and_ID_Names +--- +<div class="note" dir="rtl"> +<p><strong>ملاحظة: </strong>لقد تم تحسين دعم المتصفح للشرطة السفلية (_) في CSS بشكل كبير منذ تاريخ نشر هذه المقالة في عام 2001 ولم تعد التوصية التالية دقيقة بالنسبة لمعظم الظروف</p> +</div> + +<p dir="rtl"><span class="comment">Summary: The use of the underscore character in CSS can lead to major display problems in multiple browsers. Learn why this is so, and how to keep your sites from being bitten by this problem.</span> تدرس هذه المذكرة التقنية استخدام الشرطات السفلية (_) في CSS ، ولماذا يجب تجنب استخدامها في معظم الظؤوف</p> + +<p dir="rtl">يعد استخدام الشرطة السفلية (_) في اسماء المتغيرات والدوال (الوظائف) امراً شائعاَ نوعا ما في العديد من لغات البرمجة. على سبيل المثال دالة وظيفتها "الحصول على طول سلسلة نصية" قد تتم تسميتها <code>get_string_length</code> او متحول يمثل عدد الاشخاص الذين قالمو بالتصويت قد يسمى <code>voted_Republican</code> </p> + +<p dir="rtl">نظرا لهذه الحقيقة، غالبا مايحاول المطورين الذين يكتبون CSS استخدام الشرطة السفلية باسلوب مماثل في تسمية المعرفات ومحددات الاصناف (Class & ID). <strong>ولا ينبغي القيام بذلك. </strong>على الرغم من ان الشرطة السفلية (_) مسموح بها تقنيا في اسماء المعرفات ومحددات الاصناف حتى تاريخ كتابة هذه السطور، هناك العديد من الاسباب التاريخة والعملية التي توضح اسباب وجوب تجنب استخدام الشرطة السفلية (_)</p> + +<p dir="rtl">مواصفات CSS1 التي تم اصدرت في شكلها النهائي عام 1996 لا تسمح باستخدام الشرطة السفلية (_) في اسماء المعرفات ومحددات الاصناف مالم تستخدم حرف الهروب (escaped) على النحو التالي:</p> + +<pre>p.urgent\_note {color: maroon;}</pre> + +<p dir="rtl">هذا لم يكن مدعوما جيدا من المتصفحات في ذلك الوقت ومع ذلك هذه الممارسة لم يسبق لها مثيل. </p> + +<p dir="rtl">CSS2 التي تم اصدرت في عام 1998 ايضا منعت استخدام الشرطة السفلية (_) في أسماء المعرفات ومحددات الاصناف ومع ذلك فان تصحيح الاخطاء في المواصفات التي تم اصدارها عام 2001 جعلت استخدام الشرطة السفلية مسموحاً لاول مرة. مما ادى للاسف لتعقيد المشهد المعقد بالفعل </p> + +<h3 dir="rtl" id="Support_realities" name="Support_realities">دعم الحقائق</h3> + +<p dir="rtl">بين الاخطاء في التفيذ والتغيرات في المواصفات، سلوك المتصفحات في ما يتعلق باستخدام الشرطات السفلية معقد الى حد ما.</p> + +<ul dir="rtl"> + <li>Netscape 6.x يسمح بالشرطات السفلية والشرطات السفلية الهاربة (escaped)</li> + <li>Navigator 4.X قام بدعم فرض قيود على استخدام الشرطات السفلية وبالتالي سيقوم بتجاهل اي اسماء معرفات او محددات اصناف تحتوي شرطة سفلية وبذلك لن يتم تطبيق انماط CSS المرتبطة بها. كما انه يتجاهل الشرطات السفلية الهاربة (escaped)</li> + <li>Internet Explorer 4.x and 5.x للويندوز (Microsoft Windows) سمح باستخدام الشرطة السفلية عن طريق الخطأ وكذلك كلا الاصدارين غير متوافقين في هذه النقطة حتى تم نشر تصحيح الاخطاء. وكذلك ينطبق الامر نفسه على كلا الاصدراين للماكنتوش (Mac)</li> + <li>Internet Explorer 6 للويندوز (Microsoft Windows) تم اصداره بعد تصحيح الاخطاء، يسمح بالشرطات السفلية والشرطات السفلية الهاربة (escaped)</li> + <li> + <p>Opera 3.x الى Opera 5.x لا يعترف بالشرطة السفلية ولا الشرطة السفلية الهاربة (ecsaped) حيث انه يتصرف مثل Navigator 4.x في هذا الصدد</p> + </li> +</ul> + +<h3 dir="rtl" id="Recommendation" name="Recommendation">التوصية</h3> + +<p dir="rtl">لان دعم الشرطة السفلية غير متناسق للغاية في المتصفحات الحالية وكذلك الاصدارات القديمة منها، ينصح المؤلفون بشدة بتجبن استخدام الشرطة السفلية في اسماء المعرفات ومحددات الاصناف.</p> + +<p dir="rtl">البديل الشائع لها هو الحرف الواصلة (<code>-</code>) كما في:</p> + +<pre>p.urgent-note {color: maroon;}</pre> + +<p dir="rtl"> يختار العديد من المطورين الكتابة بطريقة حالة الجمل (Camle Case) مثال:</p> + +<pre>p.urgentNote {color: maroon;}</pre> + +<p>If the initial-cap approach is used, however, remember that class and ID names are also supposed to be case-sensitive. See the tech note "<a href="/en-US/docs/Case_Sensitivity_in_class_and_id_Names">Case Sensitivity in <code>class</code> and <code>id</code> Names</a>" for more details.</p> + +<div class="originaldocinfo"> +<h3 dir="rtl" id="Original_Document_Information" name="Original_Document_Information">Original Document Information</h3> + +<ul> + <li>Author(s): Eric A. Meyer, Netscape Communications</li> + <li>Last Updated Date: Published 05 Mar 2001</li> + <li>Copyright Information: Copyright © 2001-2003 Netscape. All rights reserved.</li> + <li>Note: This reprinted article was originally part of the DevEdge site.</li> +</ul> +</div> diff --git a/files/ar/archive/css3/index.html b/files/ar/archive/css3/index.html new file mode 100644 index 0000000000..6314a611f9 --- /dev/null +++ b/files/ar/archive/css3/index.html @@ -0,0 +1,976 @@ +--- +title: CSS3 +slug: Archive/CSS3 +translation_of: Archive/CSS3 +--- +<p><span class="seoSummary"><strong>Css3 </strong>هو أحدث تطوير للغة أوراق الأنماط المتتالية و تهدف لتوسيع لغة CSS2.1<strong>.</strong></span></p> + +<p>فيها العديد من التحديثات الجديدة المنتظرة ، مثل الزوايا المدورة ، الظلال، تدرج الألوان ، و التحريك، بالأضافة إلى تخطيطات جديدة كالتخطيط المتعدد الأعمدة و تخطيط الصندوق المرن ، و تخطيط الشبكة.</p> + +<p>الأجزاء الاختبارية التي لها سابقة خاصة بالمستعرض يجب إزالتها أو تجنبها في المنتج النهائي، أو استعمالها بحذر لأنه يمكن أن تتغير صيغتها بالمستقبل .</p> + +<h2 id="Modules_and_the_standardization_process">Modules and the standardization process</h2> + +<p>CSS Level 2 needed 9 years, from August 2002 to June 2011 to reach the Recommendation status. This was due to the fact that a few secondary features hold back the whole specification. In order to accelerate the standardization of non-problematic features, the <a class="external" href="http://www.w3.org/blog/CSS/" title="http://www.w3.org/blog/CSS/">CSS Working Group</a> of the W3C, in a decision referred as the <a class="external" href="http://fantasai.inkedblade.net/weblog/2011/inside-csswg/modules" title="http://fantasai.inkedblade.net/weblog/2011/inside-csswg/modules">Beijing doctrine</a>, divided CSS in smaller components called <em>modules</em> . Each of these modules is now an independent part of the language and moves towards standardization at its own pace. While some modules are already W3C Recommendations, other still are early Working Drafts. New modules are also added when new needs are identified.</p> + +<p><a href="/@api/deki/files/6120/=CSS_Modules_and_Snapshots.png" title="CSS_Modules_and_Snapshots.png"><img alt="CSS Modules and Snapshots as defined since CSS3" class="internal lwrap" src="/files/3623/CSS_Modules_and_Snapshots.png" style="float: left; width: 550px;"> </a> Formally, there is no CSS3 standard <em>per se</em> . Each module being standardized independently, the standard CSS consists of CSS2.1 amended and extended by the completed modules, not necessary all with the same level number. At each point of time, a snapshot of the CSS standard can be defined, listing CSS2.1 and the mature modules.</p> + +<p>The W3 consortium periodically publishes such snapshots, like in <a class="external" href="http://www.w3.org/TR/css-beijing/" title="http://www.w3.org/TR/css-beijing/">2007</a> or <a class="external" href="http://www.w3.org/TR/css-2010/" title="http://www.w3.org/TR/css-2010/">2010.</a></p> + +<p>Though today no module with a level greater than 3 is standardized, this will change in the future. Some modules, like Selectors 4 or CSS Borders and Backgrounds Level 4 already have an Editor's Draft, though they haven't yet reached the First Published Working Draft status.</p> + +<h2 id="CSS_modules_status" style="">CSS modules status</h2> + +<h3 id="Stable_modules">Stable modules</h3> + +<p>A few CSS modules are already fairly stable and have reached one of the three recommendation level of the CSSWG: Candidate Recommendation, Proposed Recommendation or Recommendation. These can be used without prefix and are pretty stable, though a few features can still be dropped at the Candidate Recommendation stage.</p> + +<p>These modules extend and amend the CSS2.1 specification which build the core of the specification. Together with it, they are the current snapshot of the CSS specification.</p> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td class="thirdColumn greenBg"><strong>{{ SpecName("CSS3 Colors", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Colors") }} since June 7th, 2011</td> + </tr> + <tr> + <td colspan="2"> + <p>Adds the {{ cssxref("opacity") }} property, and the <code>hsl</code><code>()</code>, <code>hsla()</code>, <code>rgba()</code> and <code>rgb()</code> functions to create {{cssxref("<color>")}} values. It also defines the <code>currentColor</code> keyword as a valid color.</p> + + <p>The <code>transparent</code> color is now a real color (thanks to the support for the alpha channel) and is a now an alias for <code>rgba(0,0,0,0.0)</code> .</p> + + <p>It deprecates the <a href="http://www.w3.org/TR/CSS2/ui.html#system-colors">system-color keywords that shouldn't be used in a production environment anymore</a>.</p> + </td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(128,255,128);"><strong>{{ SpecName("CSS3 Selectors", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Selectors") }} since September 29th, 2011</td> + </tr> + <tr> + <td colspan="2"> + <p>Adds:</p> + + <ul> + <li>Substring matching attribute selectors, <code>E[attribute^="value"]</code>, <code>E[attribute$="value"]</code>, <code>E[attribute*="value"]</code> .</li> + <li>New pseudo-classes: {{ cssxref(":target") }}, {{ cssxref(":enabled") }} and {{ cssxref(":disabled") }}, {{ cssxref(":checked") }}, {{ cssxref(":indeterminate") }}, {{ cssxref(":root") }}, {{ cssxref(":nth-child") }} and {{ cssxref(":nth-last-child") }}, {{ cssxref(":nth-of-type") }} and {{ cssxref(":nth-last-of-type") }}, {{ cssxref(":last-child") }}, {{ cssxref(":first-of-type") }} and {{ cssxref(":last-of-type") }}, {{ cssxref(":only-child") }} and {{ cssxref(":only-of-type") }},{{ cssxref(":empty") }}, and {{ cssxref(":not") }}.</li> + <li>Pseudo-elements are now characterized by two colons rather then one: <code>:after</code> becomes {{ cssxref("::after") }}, <code>:before</code> becomes {{ cssxref("::before") }}, <code>:first-letter</code> becomes {{ cssxref("::first-letter") }}, and <code>:first-line</code> becomes {{ cssxref("::first-line") }}.</li> + <li>The new <em>general sibling combinator</em> ( <code>h1~pre</code> ).</li> + </ul> + </td> + </tr> + </tbody> +</table> + +<p>The <a class="external" href="http://dev.w3.org/csswg/selectors4/" title="http://dev.w3.org/csswg/selectors4/">next iteration of the Selectors specification</a> is already in progress, though it still hasn't reached the First Public Working Draft stage.</p> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(128,255,128);"><strong>{{ SpecName("CSS3 Namespaces", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Namespaces") }} since September 29th, 2011</td> + </tr> + <tr> + <td colspan="2"> + <p>Adds the support for the XML Namespaces by defining the notion of <em>CSS qualified name</em>, using the ' <code>|</code> ' syntax and adding the {{ cssxref("@namespace") }} CSS at-rule.</p> + </td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(128,255,128);"><strong>{{ SpecName("CSS3 Media Queries", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Media Queries") }} since June 19th, 2012</td> + </tr> + <tr> + <td colspan="2"> + <p>Extends the former media type ( <code>print</code>, <code>screen</code>, <code>…</code> ) to a full language allowing <a href="/en/CSS/Media_queries" title="en/CSS/Media_queries">queries on the device media capabilities</a> like <code>only screen and (color)</code> .</p> + + <p>Media queries are not only used in CSS document but also in some attributes of HTML Elements, like the {{ htmlattrxref("media","link") }} attribute of the {{ HTMLElement("link") }} element.</p> + </td> + </tr> + </tbody> +</table> + +<p>The <a href="http://dev.w3.org/csswg/mediaqueries4" title="http://dev.w3.org/csswg/mediaqueries4">next iteration of this specification</a> is in the work, allowing to tailor a Web site regarding the input methods available on the user agent, with new media features like <code>hover</code> or <code>pointer</code>. Detection of EcmaScript support, using the <code>script</code> media features is also proposed.</p> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(128,255,128);"><strong>{{ SpecName("CSS3 Style", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Style") }} since November 7th, 2013</td> + </tr> + <tr> + <td colspan="2">Formally defines the syntax of the content of the HTML <a href="/en/HTML/Global_attributes#attr-style" title="en/HTML/Global_attributes#attr-style"> <code>style</code> </a> global attribute.</td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(220,255,220);"><strong>{{ SpecName("CSS3 Backgrounds", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Backgrounds") }}</td> + </tr> + <tr> + <td colspan="2"> + <p>Adds:</p> + + <ul> + <li>Support, on backgrounds, for any type of {{cssxref("<image>")}}, and not only for <code>uri()</code> defined ones.</li> + <li>Support for multiple background images.</li> + <li>The {{ cssxref("background-repeat") }} <code>space</code> and <code>round</code> values, and for the 2-value syntax of this CSS property.</li> + <li>The {{ cssxref("background-attachment") }} <code>local</code> value.</li> + <li>The CSS {{ cssxref("background-origin") }}, {{ cssxref("background-size") }}, and {{ cssxref("background-clip") }} properties.</li> + <li>Support for curved border corners, with the CSS {{ cssxref("border-radius") }}, {{ cssxref("border-top-left-radius") }}, {{ cssxref("border-top-right-radius") }}, {{ cssxref("border-bottom-left-radius") }}, and {{ cssxref("border-bottom-right-radius") }} properties.</li> + <li>Support for the use of an {{cssxref("<image>")}} as the border with the CSS {{ cssxref("border-image") }}, {{ cssxref("border-image-source") }}, {{ cssxref("border-image-slice") }}, {{ cssxref("border-image-width") }}, {{ cssxref("border-image-outset") }}, and {{ cssxref("border-image-repeat") }} properties.</li> + <li>Support for shadows of the element with the CSS {{ cssxref("box-shadow") }} property.</li> + </ul> + </td> + </tr> + </tbody> +</table> + +<p>The <a class="external" href="http://dev.w3.org/csswg/css4-background/" title="http://dev.w3.org/csswg/css4-background/">CSS4 iteration of the Backgrounds and Borders specification</a> is already in progress, though it still hasn't reached the First Public Working Draft stage, it plans to add the ability to clip a border (with the CSS {{ cssxref("border-clip") }}, {{ cssxref("border-clip-top") }}, {{ cssxref("border-clip-right") }}, {{ cssxref("border-clip-bottom") }}, and {{ cssxref("border-clip-left") }} properties) or to control the shape of the border in a corner (using the CSS {{ cssxref("border-corner-shape") }} property).</p> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(220,255,220);"><strong>{{ SpecName("CSS3 Multicol", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Multicol") }}</td> + </tr> + <tr> + <td colspan="2">Adds support for easy multi-column layouts using the CSS {{ cssxref("columns") }}, {{ cssxref("column-count") }}, {{ cssxref("column-fill") }}, {{ cssxref("column-gap") }}, {{ cssxref("column-rule") }}, {{ cssxref("column-rule-color") }}, {{ cssxref("column-rule-style") }}, {{ cssxref("column-rule-width") }}, {{ cssxref("column-span") }}, {{ cssxref("column-width") }}, {{ cssxref("break-after") }}, {{ cssxref("break-before") }}, and {{ cssxref("break-inside") }}.</td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table" style="width: 100%;"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(220,255,220);"><strong>{{ SpecName("CSS3 Speech", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Speech") }}</td> + </tr> + <tr> + <td colspan="2">Defines the <code>speech</code> media type, an aural formatting model and numerous properties specific for speech-rendering user agents.</td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(220,255,220);"><strong>{{ SpecName("CSS3 Images", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Images") }}</td> + </tr> + <tr> + <td colspan="2"> + <p>Defines the {{cssxref("<image>")}} data type.</p> + + <p>Extends the <code>url()</code> syntax to support image slices using media fragments.</p> + + <p>Adds:</p> + + <ul> + <li>The <code>dppx</code> unit to the {{cssxref("<resolution>")}} data type.</li> + <li>The <code>image()</code> function as a more flexible alternative to <code>url()</code> to define an image from an url.<br> + <em><strong>At risk</strong> </em> <strong> <em>:</em> </strong> <em> due to insufficient browser support, standardization of the <code>image()</code> function may be postponed to </em> <em>the next iteration of this module</em> <em>.</em></li> + <li>Support for <code>linear-gradient()</code>, <code>repeating-linear-gradient()</code>, <code>radial-gradient()</code> and <code>repeating-radial-gradient()</code>.</li> + <li>The ability to define how a replaced element should fit in its element, using the CSS {{ cssxref("object-fit") }} property.<br> + <em><strong>At risk</strong> </em> <strong> <em>:</em> </strong> <em> due to insufficient browser support, standardization of the {{ cssxref("object-fit") }} and property may be postponed to </em> <em>the next iteration of this module</em> <em>.</em></li> + <li>The ability to override the resolution and orientation of an external image using the CSS {{ cssxref("image-resolution") }} and {{ cssxref("image-orientation") }} properties.<br> + <em><strong>At risk</strong> </em> <strong> <em>:</em> </strong> <em> due to insufficient browser support, standardization of the {{ cssxref("image-resolution") }} and {{ cssxref("image-orientation") }} properties may be postponed to </em> <em>the next iteration of this module</em> <em>.</em></li> + </ul> + </td> + </tr> + </tbody> +</table> + +<p>The <a href="#Images_(Level_4)">CSS Image Values and Replaced Content Level 4</a> which will supersede CSS Image Level 3 is in development and is a {{Spec2("CSS4 Images")}}.</p> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(220, 255, 220);"><strong>{{ SpecName("CSS3 Values", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Values") }}</td> + </tr> + <tr> + <td colspan="2"> + <p>Makes <code>initial</code> and <code>inherit</code> keywords usable on any CSS property.</p> + + <p>Formally defines the CSS data types of CSS 2.1, that were implicitely defined by their grammar token and some textual precisions.</p> + + <p>Adds:</p> + + <ul> + <li>Definition for new font-relative length units: <code>rem</code> and <code>ch</code> .</li> + <li>Definition for viewport-relative length units: <code>vw</code>, <code>vh</code>, <code>vmax</code>, and <code>vmin</code> .</li> + <li>Precision about the real size of the absolute length units, which are not really absolute, but defined in relation with the <em>reference pixel</em> .</li> + <li>Definition for {{ cssxref("<angle>") }}, {{cssxref("<time>")}}, {{cssxref("<frequency>")}}, {{cssxref("<resolution>")}}.</li> + <li>Normative value to the definition of {{cssxref("<color>")}}, {{cssxref("<image>")}}, and {{ cssxref("<position>") }}.</li> + <li>Definition for the {{ cssxref("calc", "calc()") }}, {{ cssxref("attr", "attr()")}}, and <code>toggle()</code> functional notations.<br> + <em><strong>At risk:</strong> due to insufficient browser support, standardization of the <code>calc()</code>, <code>attr()</code>, and <code>toggle()</code> functional notations may be postponed to </em> <em>the next iteration of this module</em><em>.</em></li> + </ul> + </td> + </tr> + </tbody> +</table> + +<p>Several types definition, like <code><ident></code> and <code><custom-ident></code>, have been deferred to CSS Values and Units Module Level 4.</p> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(220,255,220);"><strong>{{ SpecName("CSS3 Flexbox", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Flexbox") }}</td> + </tr> + <tr> + <td colspan="2">Add a flexbox layout to the CSS {{ cssxref("display") }} property and several new CSS properties to control it: {{ cssxref("flex") }}, {{ cssxref("flex-align") }}, {{ cssxref("flex-direction") }}, {{ cssxref("flex-flow") }}, {{ cssxref("flex-item-align") }}, {{ cssxref("flex-line-pack") }}, {{ cssxref("flex-order") }}, {{ cssxref("flex-pack") }}, and {{ cssxref("flex-wrap") }}.</td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(220, 255, 220);"><strong>{{ SpecName("CSS3 Conditional", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Conditional") }}</td> + </tr> + <tr> + <td colspan="2">Adds features for conditional processing of parts of style sheets, conditioned on capabilities of the browser or the document the style sheet is being applied to. It consists mainly in allowing nested at-rules inside {{ cssxref("@media") }} and the adding of a new CSS at-rule, {{ cssxref("@supports") }}, and a new DOM method {{domxref("CSS.supports()")}}.</td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(220, 255, 220);"><strong>{{ SpecName("CSS3 Text Decoration", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Text Decoration") }}</td> + </tr> + <tr> + <td colspan="2"> + <p>Extends:</p> + + <ul> + <li>the CSS {{ cssxref("text-decoration") }} property by making it a shorthand for the CSS {{ cssxref("text-decoration-line") }}, {{ cssxref("text-decoration-color") }}, and {{ cssxref("text-decoration-style") }} properties. And adds the {{ cssxref("text-decoration-skip") }}, and {{ cssxref("text-underline-position") }} properties.</li> + </ul> + + <p>Adds:</p> + + <ul> + <li>Support for East-Asian-script emphasis marks with the CSS {{ cssxref("text-emphasis") }}, {{ cssxref("text-emphasis-style") }}, {{ cssxref("text-emphasis-color") }}, and {{ cssxref("text-emphasis-position") }} properties.</li> + <li>Support for script shadows with the CSS {{ cssxref("text-shadow") }} property.</li> + </ul> + + <p>Precises:</p> + + <ul> + <li>The paint order of the decorations.</li> + </ul> + + <p><em><strong>At risk:</strong> due to insufficient browser support, standardization of the <code>text-decoration-skip</code>, line positioning rules and the ability to place both emphasis marks and ruby above the same base text may be postponed to </em> <em>the next iteration of this module</em><em>.</em></p> + </td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(220,255,220);"><strong>{{ SpecName("CSS3 Fonts", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Fonts") }}</td> + </tr> + <tr> + <td colspan="2"> + <p>Amends the CSS2.1 Font matching algorithm to be closer to what is really implemented.</p> + + <p>Adds:</p> + + <ul> + <li>Support for downloadable fonts via the CSS {{ cssxref("@font-face") }} at-rule.</li> + <li>The control of the contextual inter-glyph spacing via the CSS {{ cssxref("font-kerning") }} property.</li> + <li>The choice of language-specific glyphs via the CSS {{ cssxref("font-language-override") }} property.</li> + <li>The choice of glyphs with specific OpenType features via the CSS {{ cssxref("font-feature-settings") }} property.</li> + <li>The control of the aspect ratio to use when fallback fonts are selected via the CSS {{ cssxref("font-size-adjust") }} property.</li> + <li>The choice of alternative font faces using the CSS {{ cssxref("font-stretch") }}, {{ cssxref("font-variant-alternates") }}, {{ cssxref("font-variant-caps") }}, {{ cssxref("font-variant-east-asian") }}, {{ cssxref("font-variant-ligatures") }}, {{ cssxref("font-variant-numeric") }}, and {{ cssxref("font-variant-position") }} properties. It also extends the related CSS {{ cssxref("font-variant") }} shorthand property and introduces the {{ cssxref("@font-features-values") }} at-rule.</li> + <li>The control of the automatic generation of an oblique or bold face when none are found via the CSS {{ cssxref("font-synthesis") }} property.</li> + </ul> + </td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(220,255,220);"><strong>{{ SpecName("CSS3 Cascade", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Cascade") }}</td> + </tr> + <tr> + <td colspan="2"> + <p>Adds:</p> + + <ul> + <li>The <code>initial</code>, <code>unset</code> values for properties.</li> + <li>The CSS {{ cssxref("all") }} property.</li> + <li>The scoping mechanism.</li> + </ul> + + <p>Precises:</p> + + <ul> + <li>Interaction of media-dependent @import statements and style sheet loading requirements.</li> + </ul> + </td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(220,255,220);"><strong>{{ SpecName("CSS3 Writing Modes", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Writing Modes") }}</td> + </tr> + <tr> + <td colspan="2">Defines the writing modes of both horizontal and vertical scripts and precises how the CSS {{ cssxref("direction") }} and {{ cssxref("unicode-bidi") }} properties interact with the new CSS {{ cssxref("text-orientation") }} property, and extends them where needed.</td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(220,255,220);"><strong>{{ SpecName("CSS Shapes", "", "") }}</strong></td> + <td>{{ Spec2("CSS Shapes") }}</td> + </tr> + <tr> + <td colspan="2">Defines geometric shapes, which can be applied to floats. These shapes describe areas, around which inline content wraps instead of wrapping around the bounding box.</td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(220,255,220);"><strong>{{ SpecName("CSS Masks", "", "") }}</strong></td> + <td>{{ Spec2("CSS Masks") }}</td> + </tr> + <tr> + <td colspan="2">Defines a way for partially or fully hiding portions of visual elements. It describes how to use another graphical element or image as a luminance or alpha mask.</td> + </tr> + </tbody> +</table> + +<h3 id="Modules_in_the_refining_phase">Modules in the refining phase</h3> + +<p>Specifications that are deemed to be in the <em>refining phase</em> are already fairly stable. Though changes are still expected, they shouldn't create incompatibilities with current implementations; they should mainly define behavior in edge cases.</p> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(255,255,220);"><strong>{{ SpecName("Web Animations", "", "") }}</strong></td> + <td>{{ Spec2("Web Animations") }}</td> + </tr> + <tr> + <td colspan="2"> </td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(255,255,220);"><strong>{{ SpecName("CSS3 Counter Styles", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Counter Styles") }}</td> + </tr> + <tr> + <td colspan="2"> </td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(255,255,220);"><strong>{{ SpecName("Compositing", "", "") }}</strong></td> + <td>{{ Spec2("Compositing") }}</td> + </tr> + <tr> + <td colspan="2"> </td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(255,255,220);"><strong>{{ SpecName("CSS3 Syntax", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Syntax") }}</td> + </tr> + <tr> + <td colspan="2">Precises how charsets are determined; minor changes in parsing and tokenization algorithms.</td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(255,255,220);"><strong>{{ SpecName("CSS Will Change", "", "") }}</strong></td> + <td>{{ Spec2("CSS Will Change") }}</td> + </tr> + <tr> + <td colspan="2"> </td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(255,255,220);"><strong>{{ SpecName("CSS3 Transitions", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Transitions") }}</td> + </tr> + <tr> + <td colspan="2">Allows the definition of transitions effects between two properties values by adding the CSS {{ cssxref("transition") }}, {{ cssxref("transition-delay") }}, {{ cssxref("transition-duration") }}, {{ cssxref("transition-property") }}, and {{ cssxref("transition-timing-function") }} properties.</td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(255,255,220);"><strong>{{ SpecName("CSS3 Animations", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Animations") }}</td> + </tr> + <tr> + <td colspan="2">Allows the definition of animations effects by adding the CSS {{ cssxref("animation") }}, {{ cssxref("animation-delay") }},{{ cssxref("animation-direction") }}, {{ cssxref("animation-duration") }}, {{ cssxref("animation-fill-mode") }}, {{ cssxref("animation-iteration-count") }}, {{ cssxref("animation-name") }}, {{ cssxref("animation-play-state") }}, and {{ cssxref("animation-timing-function") }} properties, as well as the {{ cssxref("@keyframes") }} at-rule.</td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(255,255,220);"><strong>{{ SpecName("CSS3 Transforms", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Transforms") }}</td> + </tr> + <tr> + <td colspan="2"> + <p>Adds:</p> + + <ul> + <li>the support of bi-dimensional transforms to be applied to any element using the CSS {{ cssxref("transform") }} and {{ cssxref("transform-origin") }} properties. The supported transforms are: <code>matrix</code><code>()</code>, <code>translate()</code>, <code>translateX()</code>, <code>translateY()</code>, <code>scale()</code>, <code>scaleX()</code>, <code>scaleY()</code>, <code>rotate()</code>, <code>skewX()</code>, and <code>skewY()</code>.</li> + <li>the support of tri-dimensional transforms to be applied to any element by adding the CSS {{ cssxref("transform-style") }}, {{ cssxref("perspective") }}, {{ cssxref("perspective-origin") }}, and {{ cssxref("backface-visibility") }} properties and extended the {{ cssxref("transform") }} property with the following transforms are: <code>matrix</code> <code>3d()</code>, <code>translate3d()</code>, <code>translateZ()</code>, <code>scale3d()</code>, <code>scaleZ()</code>, <code>rotate3d()</code>, <code>rotateX</code><code>()</code>, <code>rotateY</code><code>()</code>, <code>rotateZ()</code>, and <code>perspective()</code>.</li> + </ul> + + <p><em><strong>Note:</strong> this specification is a merge of CSS 2D-Transforms, CSS 3D-Transforms and SVG transforms. </em></p> + </td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(255, 255, 220);"><strong>{{ SpecName("CSS3 Fragmentation", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Fragmentation") }}</td> + </tr> + <tr> + <td colspan="2">Defines how partitions of a Web page should happen, that is page, column breaks, and widows and orphans handling. + <p>Adds:</p> + + <ul> + <li>Support for defining the behavior of decorations, that is borders and background colors or images, when a box is breaked (at a page, column or line-break) with the CSS {{ cssxref("box-decoration-break") }} property.</li> + </ul> + </td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(255,255,220);"><strong>{{ SpecName("CSS3 Text", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Text") }}</td> + </tr> + <tr> + <td colspan="2"> + <p>Extends:</p> + + <ul> + <li>the CSS {{ cssxref("text-transform") }} property with the value <code>full-width</code>.</li> + <li>the CSS {{ cssxref("text-align") }} property with the value <code>start</code>, <code>end</code>, <code>start end</code>, and <code>match-parent</code> for a better support of documents with multiple directionalities of text.</li> + <li>the CSS {{ cssxref("text-align") }} property with a {{cssxref("<string>")}} value to align on that character. This is useful to align number on the decimal point.</li> + <li>the CSS {{ cssxref("word-spacing") }} and {{ cssxref("letter-spacing") }} properties with range constraints to control flexibility in justification.</li> + </ul> + + <p>Adds:</p> + + <ul> + <li>Control on how whitespaces are displayed using the CSS {{ cssxref("text-space-collapse") }} and {{ cssxref("tab-size") }} properties.</li> + <li>Control on line breaks and word boundaries using the CSS {{ cssxref("line-break") }}, {{ cssxref("word-break") }}, {{ cssxref("hyphens") }}, {{ cssxref("text-wrap") }}, {{ cssxref("overflow-wrap") }}, and {{ cssxref("text-align-last") }} properties.</li> + <li>Control on how justification is happening, in order to support more type of scripts, using the CSS {{ cssxref("text-justify") }} property.</li> + <li>Control on edge effect using the CSS {{ cssxref("text-indent") }} and {{ cssxref("hanging-punctuation") }} properties.</li> + </ul> + </td> + </tr> + </tbody> +</table> + +<p>A few features present in early CSS Text Level 3 draft have being <a class="external" href="http://dev.w3.org/csswg/css3-text/#recent-changes" title="http://dev.w3.org/csswg/css3-text/#recent-changes">postponed to the next iteration of this module</a> .</p> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(255,255,220);"><strong>{{ SpecName("CSS3 Variables", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Variables") }}</td> + </tr> + <tr> + <td colspan="2">Defines a mechanism allowing to define variables in CSS.</td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(255,255,220);"><strong>{{ SpecName("Compositing", "", "") }}</strong></td> + <td>{{ Spec2("Compositing") }}</td> + </tr> + <tr> + <td colspan="2"> </td> + </tr> + </tbody> +</table> + +<h3 id="Modules_in_the_revising_phase">Modules in the revising phase</h3> + +<p>Modules that are in the revising phase are much less stable than those in the refining phase. Often the syntax is still under scrutiny and may evolve a lot, in a non-compatible way. Alternative syntaxes are tested and often implemented.</p> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(255,160,100);"><strong>{{ SpecName("CSS3 Basic UI", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Basic UI") }}</td> + </tr> + <tr> + <td colspan="2"> + <p>Adds:</p> + + <ul> + <li>The ability to tweak the box model using the CSS {{ cssxref("box-sizing") }} property.<br> + <strong><em>At risk:</em> </strong> <em> due to insufficient browser support, standardization of the <code>padding</code><code>-box</code> value may be postponed to </em> <em>the next iteration of this module</em> <em>.</em></li> + <li>Allow the styling of forms according their content using the CSS {{ cssxref(":indeterminate") }}, {{ cssxref(":default") }}, {{ cssxref(":valid") }}, {{ cssxref(":invalid") }}, {{ cssxref(":in-range") }}, {{ cssxref(":out-of-range") }}, {{ cssxref(":required") }}, {{ cssxref(":optional") }}, {{ cssxref(":read-only") }}, and {{ cssxref(":read-write") }} pseudo-classes and the {{ cssxref("::value") }}, {{ cssxref("::choices") }}, {{ cssxref("::repeat-item") }}, and {{ cssxref("::repeat-index") }} pseudo-elements.<br> + <em><strong>At risk:</strong> due to insufficient browser support, standardization of the pseudo-elements {{ cssxref("::value") }}, {{ cssxref("::choices") }}, {{ cssxref("::repeat-item") }}, and {{ cssxref("::repeat-index") }} may be postponed to </em> <em>the next iteration of this module</em> <em>.</em></li> + <li>Support for icons, defined by the CSS {{ cssxref("icon") }} property simultaneously with the new <code>icon</code> value of the CSS {{ cssxref("content") }} property.<br> + <em><strong>At risk:</strong> due to insufficient browser support, standardization of the {{ cssxref("icon") }} property and the <code>icon</code> value may be postponed to CSS4. </em></li> + <li>Support for the CSS {{ cssxref("outline-offset") }} property giving more control on the position of the outline.</li> + <li>Support for the CSS {{ cssxref("resize") }} property allowing Web authors to control if and how elements should be resized.</li> + <li>Support for the CSS {{ cssxref("text-overflow") }} property defining how text overflows, if needed.<br> + <em><strong>At risk:</strong> due to insufficient browser support, the 2-value syntax of this property as well as the support for {{cssxref("<string>")}} values may be postponed to </em> <em>the next iteration of this module</em> <em>.</em></li> + <li>The ability to define the hotspot of a cursor as well as the new <code>none</code>, <code>context-menu</code>, <code>cell</code>, <code>vertical-text</code>, <code>alias</code>, <code>copy</code>, <code>no-drop</code>, <code>not-allowed</code>, <code>nesw-</code><code>resize</code>, <code>nwse-</code><code>resize</code>, <code>col-resize</code>, <code>row-resize</code>, <code>all-scroll</code>, <code>zoom-in</code>, <code>zoom-out</code>, extending the {{ cssxref("cursor") }} property.</li> + <li>The ability to specify the sequential navigation order (that is the <em>tabbing order</em> ) using the CSS {{ cssxref("nav-index") }}, {{ cssxref("nav-up") }}, {{ cssxref("nav-right") }}, {{ cssxref("nav-left") }}, {{ cssxref("nav-down") }} properties.<br> + <em><strong>At risk:</strong> due to insufficient browser support, standardization of the navigation properties may be postponed to </em> <em>the next iteration of this module</em> <em>.</em></li> + <li>The ability to control the usage of an IME editor, using the CSS {{ cssxref("ime-mode") }} property.<br> + <em><strong>At risk:</strong> due to insufficient browser support, standardization of the {{ cssxref("ime-mode") }} property may be postponed to </em> <em>the next iteration of this module</em> <em>.</em></li> + </ul> + </td> + </tr> + </tbody> +</table> + +<p>An early list of what could be in the next iteration of the CSS Basic User Interface Module is <a class="external" href="http://wiki.csswg.org/spec/css4-ui" title="http://wiki.csswg.org/spec/css4-ui">available</a>.</p> + +<table class="fullwidth-table" style="width: 100%;"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(255,160,100);"><strong>{{ SpecName("CSS3 Grid", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Grid") }}</td> + </tr> + <tr> + <td colspan="2">Add a grid layout to the CSS <a href="https://developer.mozilla.org/en-US/docs/Web/CSS/display" title=""><code>display</code></a> property and several new CSS properties to control it: {{cssxref("grid")}}, {{cssxref("grid-area")}}, {{cssxref("grid-auto-columns")}}, {{cssxref("grid-auto-flow")}}, {{cssxref("grid-auto-position")}}, {{cssxref("grid-auto-rows")}}, {{cssxref("grid-column")}}, {{cssxref("grid-column-start")}}, {{cssxref("grid-column-end")}}, {{cssxref("grid-row")}}, {{cssxref("grid-row-start")}}, {{cssxref("grid-row-end")}}, {{cssxref("grid-template")}}, {{cssxref("grid-template-areas")}}, {{cssxref("grid-template-rows")}}, and {{cssxref("grid-template-columns")}}.</td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table" style="width: 100%;"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(255,160,100);"><strong>{{ SpecName("CSS3 Box Alignment", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Box Alignment") }}</td> + </tr> + <tr> + <td colspan="2"> </td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table" style="width: 100%;"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(255,160,100);"><strong>{{ SpecName("CSS3 Paged Media", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Paged Media") }}</td> + </tr> + <tr> + <td colspan="2"> </td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table" style="width: 100%;"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(255,160,100);"><strong>{{ SpecName("CSSOM View", "", "") }}</strong></td> + <td>{{ Spec2("CSSOM View") }}</td> + </tr> + <tr> + <td colspan="2"> </td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table" style="width: 100%;"> + <tbody> + <tr> + <td style="width: 30%; background-color: rgb(255,160,100);"><strong>{{ SpecName("CSS4 Selectors", "", "") }}</strong></td> + <td>{{ Spec2("CSS4 Selectors") }}</td> + </tr> + <tr> + <td colspan="2"> </td> + </tr> + </tbody> +</table> + +<h3 id="Modules_in_the_exploring_phase">Modules in the exploring phase</h3> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: #F66;"><strong>{{ SpecName("CSS4 Images", "", "") }}</strong></td> + <td>{{ Spec2("CSS4 Images") }}</td> + </tr> + <tr> + <td colspan="2"> + <p>Extends:</p> + + <ul> + <li>the <code>image()</code> functional notation to describe the directionality of the image (<code>rtl</code> or <code>ltr</code>), allowing for bidi-sensitive images.</li> + <li>the {{ cssxref("image-orientation") }} property by adding the keyword <code>from-image</code>, allowing to follow EXIF data stored into images to be considered.</li> + </ul> + + <p>Adds:</p> + + <ul> + <li>the <code>image-set()</code> functional notation to allow the definition to equivalent images at different resolution allowing for resolution-negotiated selection of images.</li> + <li>the <code>element()</code> functional notation allowing the use of part of the page as image.</li> + <li>the <code>cross-fade()</code> functional notation allowing to refer to intermediate images when transitioning between two images and defines the interpolation between two images.</li> + <li>the <code>conic-gradient()</code> and <code>repeating-conic-gradient()</code> functional notation describing a new type of gradient.</li> + <li>the {{cssxref("image-rendering")}} property that allow to define how resize of the object should be handled.</li> + </ul> + </td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table" style="width: 100%;"> + <tbody> + <tr> + <td style="width: 30%; background-color: #F66;"><strong>{{ SpecName("CSS3 Device", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Device") }}</td> + </tr> + <tr> + <td colspan="2">Adds a new at-rule, {{ cssxref("@viewport") }}, allowing to specify the size, zoom factor, and orientation of the viewport that is used as the base for the initial containing block.</td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: #F66;"><strong>{{ SpecName("CSS3 GCPM", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 GCPM") }}</td> + </tr> + <tr> + <td colspan="2">Adds the ability to tailor printed version of a document by allowing to control header, footer but also references tables like indexes or tables of content.</td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: #F66;"><strong>{{ SpecName("CSS Exclusions", "", "") }}</strong></td> + <td>{{ Spec2("CSS Exclusions") }}</td> + </tr> + <tr> + <td colspan="2">Extends the floats mechanism to define exclusion regions in any positioning scheme. Adds the notion of shapes, in which content must flows.</td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: #F66;"><strong>{{ SpecName("CSS3 Lists", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Lists") }}</td> + </tr> + <tr> + <td colspan="2">Extends the list counter mechanism so that list markers can be styled and Web developers can define new list counter schemes.</td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table"> + <tbody> + <tr> + <td style="width: 30%; background-color: #F66;"><strong>{{ SpecName("CSS3 Regions", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Regions") }}</td> + </tr> + <tr> + <td colspan="2">Defines a new mechanism allowing content to flow across, eventually non-contiguous, multiple areas called regions.</td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table" style="width: 100%;"> + <tbody> + <tr> + <td style="width: 30%; background-color: #F66;"><strong>{{ SpecName("CSS3 Device", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Device") }}</td> + </tr> + <tr> + <td colspan="2">Adds a new at-rule, {{ cssxref("@viewport") }}, allowing to specify the size, zoom factor, and orientation of the viewport that is used as the base for the initial containing block.</td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table" style="width: 100%;"> + <tbody> + <tr> + <td style="width: 30%; background-color: #F66;"><strong>{{ SpecName("Filters 1.0", "", "") }}</strong></td> + <td>{{ Spec2("Filters 1.0") }}</td> + </tr> + <tr> + <td colspan="2"> </td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table" style="width: 100%;"> + <tbody> + <tr> + <td style="width: 30%; background-color: #F66;"><strong>{{ SpecName("CSS3 Template", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Template") }}</td> + </tr> + <tr> + <td colspan="2"> </td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table" style="width: 100%;"> + <tbody> + <tr> + <td style="width: 30%; background-color: #F66;"><strong>{{ SpecName("CSS3 Sizing", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Sizing") }}</td> + </tr> + <tr> + <td colspan="2"> </td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table" style="width: 100%;"> + <tbody> + <tr> + <td style="width: 30%; background-color: #F66;"><strong>{{ SpecName("CSS Line Grid", "", "") }}</strong></td> + <td>{{ Spec2("CSS Line Grid") }}</td> + </tr> + <tr> + <td colspan="2"> </td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table" style="width: 100%;"> + <tbody> + <tr> + <td style="width: 30%; background-color: #F66;"><strong>{{ SpecName("CSS3 Positioning", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Positioning") }}</td> + </tr> + <tr> + <td colspan="2"> </td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table" style="width: 100%;"> + <tbody> + <tr> + <td style="width: 30%; background-color: #F66;"><strong>{{ SpecName("CSS3 Ruby", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Ruby") }}</td> + </tr> + <tr> + <td colspan="2"> </td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table" style="width: 100%;"> + <tbody> + <tr> + <td style="width: 30%; background-color: #F66;"><strong>{{ SpecName("CSSOM", "", "") }}</strong></td> + <td>{{ Spec2("CSSOM") }}</td> + </tr> + <tr> + <td colspan="2"> </td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table" style="width: 100%;"> + <tbody> + <tr> + <td style="width: 30%; background-color: #F66;"><strong>{{ SpecName("CSS3 Overflow", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Overflow") }}</td> + </tr> + <tr> + <td colspan="2"> </td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table" style="width: 100%;"> + <tbody> + <tr> + <td style="width: 30%; background-color: #F66;"><strong>{{ SpecName("CSS3 Font Loading", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Font Loading") }}</td> + </tr> + <tr> + <td colspan="2"> </td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table" style="width: 100%;"> + <tbody> + <tr> + <td style="width: 30%; background-color: #F66;"><strong>{{ SpecName("CSS3 Display", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Display") }}</td> + </tr> + <tr> + <td colspan="2"> </td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table" style="width: 100%;"> + <tbody> + <tr> + <td style="width: 30%; background-color: #F66;"><strong>{{ SpecName("CSS Scope", "", "") }}</strong></td> + <td>{{ Spec2("CSS Scope") }}</td> + </tr> + <tr> + <td colspan="2"> </td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table" style="width: 100%;"> + <tbody> + <tr> + <td style="width: 30%; background-color: #F66;"><strong>{{ SpecName("CSS4 Media Queries", "", "") }}</strong></td> + <td>{{ Spec2("CSS4 Media Queries") }}</td> + </tr> + <tr> + <td colspan="2"> </td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table" style="width: 100%;"> + <tbody> + <tr> + <td style="width: 30%; background-color: #F66;"><strong>{{ SpecName("CSS Non-element Selectors", "", "") }}</strong></td> + <td>{{ Spec2("CSS Non-element Selectors") }}</td> + </tr> + <tr> + <td colspan="2"> </td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table" style="width: 100%;"> + <tbody> + <tr> + <td style="width: 30%; background-color: #F66;"><strong>{{ SpecName("Geometry Interfaces", "", "") }}</strong></td> + <td>{{ Spec2("Geometry Interfaces") }}</td> + </tr> + <tr> + <td colspan="2"> </td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table" style="width: 100%;"> + <tbody> + <tr> + <td style="width: 30%; background-color: #F66;"><strong>{{ SpecName("CSS3 Inline", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Inline") }}</td> + </tr> + <tr> + <td colspan="2"> </td> + </tr> + </tbody> +</table> + +<h3 id="Modules_in_the_rewriting_phase">Modules in the rewriting phase</h3> + +<p>Modules that are in the rewriting phase are outdated and require to be rewritten. The syntax is still under scrutiny and may evolve a lot, in a non-compatible way. Alternative syntaxes are tested and often implemented.</p> + +<table class="fullwidth-table" style="width: 100%;"> + <tbody> + <tr> + <td style="width: 30%; background-color: #F33;"><strong>{{ SpecName("CSS3 Box", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Box") }}</td> + </tr> + <tr> + <td colspan="2"> </td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table" style="width: 100%;"> + <tbody> + <tr> + <td style="width: 30%; background-color: #F33;"><strong>{{ SpecName("CSS3 Content", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Content") }}</td> + </tr> + <tr> + <td colspan="2"> </td> + </tr> + </tbody> +</table> + +<table class="fullwidth-table" style="width: 100%;"> + <tbody> + <tr> + <td style="width: 30%; background-color: #F33;"><strong>{{ SpecName("CSS3 Inline Layout", "", "") }}</strong></td> + <td>{{ Spec2("CSS3 Inline Layout") }}</td> + </tr> + <tr> + <td colspan="2"> </td> + </tr> + </tbody> +</table> + +<p> </p> diff --git a/files/ar/archive/index.html b/files/ar/archive/index.html new file mode 100644 index 0000000000..4f4a70c023 --- /dev/null +++ b/files/ar/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/ar/archive/mdn/index.html b/files/ar/archive/mdn/index.html new file mode 100644 index 0000000000..9e550840e3 --- /dev/null +++ b/files/ar/archive/mdn/index.html @@ -0,0 +1,20 @@ +--- +title: MDN Archive +slug: Archive/MDN +tags: + - Archive + - MDN + - NeedsTranslation + - TopicStub +translation_of: Archive/MDN +--- +<p>{{MDNSidebar}}</p> + +<div class="blockIndicator obsolete"> +<p><strong>Obsolete</strong><br> + This documentation is obsolete.</p> +</div> + +<p>The documentation listed below is archived, obsolete material about MDN itself.</p> + +<p>{{LandingPageListSubpages}}</p> diff --git a/files/ar/archive/meta_docs/index.html b/files/ar/archive/meta_docs/index.html new file mode 100644 index 0000000000..52de2c8447 --- /dev/null +++ b/files/ar/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/ar/archive/mozilla/index.html b/files/ar/archive/mozilla/index.html new file mode 100644 index 0000000000..132253aacf --- /dev/null +++ b/files/ar/archive/mozilla/index.html @@ -0,0 +1,8 @@ +--- +title: Archived Mozilla and build documentation +slug: Archive/Mozilla +translation_of: Archive/Mozilla +--- +<p>In progress. These articles are archived, obsolete documents about Mozilla, Gecko, and the process of building Mozilla projects.</p> + +<p>{{SubpagesWithSummaries}}</p> diff --git a/files/ar/archive/mozilla/marketplace/index.html b/files/ar/archive/mozilla/marketplace/index.html new file mode 100644 index 0000000000..ded4fbc136 --- /dev/null +++ b/files/ar/archive/mozilla/marketplace/index.html @@ -0,0 +1,161 @@ +--- +title: Firefox Marketplace +slug: Archive/Mozilla/Marketplace +tags: + - Apps + - Beginner + - Firefox OS + - Intro + - Landing + - Marketplace + - NeedsTranslation + - TopicStub + - 'l10n:priority' +translation_of: Archive/Mozilla/Marketplace +--- +<p class="summary">The Firefox Marketplace is an open and non-proprietary online marketplace for web apps. <span class="seoSummary">In this zone you'll find all the information you need to prepare and publish apps on the Firefox Marketplace. Find guidance on how to make apps successful, delivery options, publishing and updating apps, and the libraries and APIs to make use of Marketplace features.</span></p> + +<p>Mozilla is bringing its core values — openness, freedom, user choice — to the world of app publishing.</p> + +<p>Using standard Web technologies, languages, and tools, the <a href="https://marketplace.firefox.com/">Firefox Marketplace</a> enables you to publish <a href="/en-US/Apps">Open Web Apps</a>. These apps can be packaged, running within Firefox OS, or hosted on your own web server. Published apps are available to users of Firefox OS phones wherever they are in the world. Users discover your apps easily in Firefox Marketplace using the featured apps section, app categories, and powerful search. Users are then able to install free apps instantly, or buy paid apps with the growing support for credit card payments and operator billing.</p> + +<div class="topicpage-table"> +<div class="section"> +<h2 id="Preparing_for_success"><a href="/en-US/Marketplace/Prepare">Preparing for success</a></h2> + +<p>Whether you're creating apps for pleasure or profit, you'll want people to discover, use, and enjoy them. This section explains how to spread the word and build communities of satisfied users.</p> + +<h2 id="Publication_options"><a href="/en-US/Marketplace/Options">Publication options</a></h2> + +<p>Packaged or Hosted, that is the question. Find out about delivering your app content and the options for making your apps available on Android devices and desktops, in addition to Firefox OS.</p> + +<h2 id="Publishing_apps"><a href="/en-US/Marketplace/Publishing/Introduction">Publishing apps</a></h2> + +<p>Unleash your apps on the waiting world. Find out how to get your apps on Firefox Marketplace, including the processes for submitting your apps, the review process, updating your apps, monitoring their performance, and reviewing user feedback.</p> +</div> + +<div class="section"> +<h2 id="Tools_for_app_development">Tools for app development</h2> + +<dl> + <dt><a href="/en-US/Marketplace/APIs">Firefox Marketplace Libraries and APIs</a></dt> + <dd>Get an overview and find links to the libraries and APIs available to add features to your Marketplace apps.</dd> + <dt><a href="/en-US/Apps/Tools_and_frameworks/App_developer_tools">App developer tools</a></dt> + <dd>Find a complete list of the tools you can use to make Open Web App development efficient and fun.</dd> + <dt><a href="/en-US/docs/Tools/WebIDE">WebIDE</a></dt> + <dd>Your primary tool to test, deploy, and debug <a href="https://developer.mozilla.org/en-US/Firefox_OS">Firefox OS</a> apps using the <a href="https://developer.mozilla.org/en-US/docs/Tools/Firefox_OS_Simulator">Firefox OS Simulator</a> or a real Firefox OS device.</dd> +</dl> +</div> +</div> + +<div class="blockIndicator communitybox" dir="ltr"> +<div class="column-container"> +<h2 id="Join_the_Marketplace_community">Join the Marketplace community</h2> + +<div class="column-half"> +<div class="communitysubhead">Choose your preferred method for joining the discussion:</div> + +<ul class="communitymailinglist"> + <li><a href="https://lists.mozilla.org/listinfo/dev-marketplace">Mailing list</a></li> + <li><a href="https://twitter.com/Boot2Gecko">Twitter</a></li> + <li><a href="http://stackoverflow.com/questions/tagged/firefox-os">Stack Overflow</a></li> + <li><a href="http://groups.google.com/group/mozilla.dev.marketplace">Newsgroup</a></li> + <li><a href="http://groups.google.com/group/mozilla.dev.marketplace/feeds">RSS feed</a></li> +</ul> +</div> + +<div class="column-half"> +<ul class="communitycontact"> + <li><strong>IRC: </strong><a href="irc://irc.mozilla.org/marketplace">#marketplace</a> <span class="smaller">(<a href="https://wiki.mozilla.org/IRC">learn more</a>)</span></li> + <li><strong>Contribute: </strong><a href="https://wiki.mozilla.org/Marketplace/Contributing/ThisMonth" title="Discover what you can do to contribute regularly to the Marketplace project">Marketplace this month</a></li> +</ul> +</div> +</div> +</div> + +<h2 id="Subnav">Subnav</h2> + +<section id="Quick_Links"> +<ol> + <li class="toggle"> + <details><summary><a href="/en-US/Marketplace/Prepare">Prepare for success</a></summary> + + <ol> + <li><a href="/en-US/Marketplace/Prepare/Introduction">Introduction</a></li> + <li><a href="/en-US/Marketplace/Prepare/Deciding_what_to_build">Deciding what to build</a></li> + <li><a href="/en-US/Marketplace/Prepare/Getting_to_know_your_users">Getting to know your users</a></li> + <li><a href="/en-US/Marketplace/Prepare/Choosing_your_business_model">Choosing your business model</a></li> + <li><a href="/en-US/Marketplace/Prepare/Localizing_your_apps">Localizing your apps</a></li> + <li><a href="/en-US/Marketplace/Prepare/Promoting_your_app">Promoting your app</a></li> + <li><a href="/en-US/Marketplace/Prepare/Creating_your_community">Creating your community</a></li> + </ol> + </details> + </li> + <li class="toggle"> + <details><summary><a href="/en-US/Marketplace/Options">Your publication options</a></summary> + <ol> + <li><a href="/en-US/Marketplace/Options/Introduction">Introduction</a></li> + <li><a href="/en-US/Marketplace/Options/Packaged_apps">Packaged apps</a></li> + <li><a href="/en-US/Marketplace/Options/Hosted_apps">Hosted apps</a></li> + <li><a href="/en-US/Marketplace/Options/Packaged_or_hosted">Packaged or hosted?</a></li> + <li><a href="/en-US/Marketplace/Options/Mobile_optimized_websites">Mobile-optimized websites</a></li> + <li><a href="/en-US/Marketplace/Options/Self_publishing">Publish apps yourself</a></li> + </ol> + </details> + </li> + <li class="toggle"> + <details><summary><a href="/en-US/Marketplace/Publishing">App publishing overview</a></summary> + <ol> + <li><a href="/en-US/Marketplace/Publishing/Introduction">Introduction</a></li> + <li><a href="/en-US/Marketplace/Publishing/Submission_checklist">Submission checklist</a></li> + <li><a href="/en-US/Marketplace/Publishing/Marketplace_review_criteria" title="An explanation of the criteria an app must meet in order to be published on the Firefox Marketplace">Marketplace review criteria</a></li> + <li><a href="/en-US/Marketplace/Publishing/Marketplace_showcase_criteria">Marketplace showcase criteria</a></li> + <li><a href="/en-US/Marketplace/Publishing/Adding_a_subdomain" title="For security reasons, each app must have its own domain (or subdomain) on the Web. This article covers how to go about creating a subdomain for your app.">Adding a subdomain for an app</a></li> + <li><a href="/en-US/Marketplace/Publishing/Policies_and_Guidelines">Policies and Guidelines</a> + <ol> + <li><a href="/en-US/Marketplace/Publishing/Policies_and_Guidelines/Introduction">Introduction</a></li> + <li><a href="/en-US/Marketplace/Publishing/Policies_and_Guidelines/Marketplace_screenshot_criteria" title="Some guidelines on how to create an effective screenshot for marketplace submission">Marketplace screenshot criteria</a></li> + <li><a href="/en-US/Marketplace/Publishing/Policies_and_Guidelines/Privacy_policies" title="Your users' privacy is very important, so you need to develop and adhere to a reasonable privacy policy to engender their trust. This article provides a guide to developing privacy policies.">Privacy policy</a></li> + <li><a href="/en-US/Marketplace/Publishing/Policies_and_Guidelines/Testing_and_troubleshooting">App testing and troubleshooting</a></li> + </ol> + </li> + </ol> + </details> + </li> + <li class="toggle"> + <details><summary><a href="/en-US/Marketplace/Publishing/Submit">Submit your app</a></summary> + <ol> + <li><a href="/en-US/Marketplace/Publishing/Submit/Overview">Overview</a></li> + <li><a href="/en-US/Marketplace/Publishing/Submit/Sign-in_to_your_developer_account" title="This step-by-step guide will help you successfully submit your app to the Firefox Marketplace.">Step 1: Sign-in</a></li> + <li><a href="/en-US/Marketplace/Publishing/Submit/Load_your_app">Step 2: Load app</a></li> + <li><a href="/en-US/Marketplace/Publishing/Submit/Enter_your_apps_details">Step 3: Listing details</a></li> + <li><a href="/en-US/Marketplace/Publishing/Submit/Next_steps">Step 4: Next steps</a></li> + <li><a href="/en-US/Marketplace/Publishing/Submit/Rating_Your_Content">Step 5: App rating</a></li> + <li><a href="/en-US/Marketplace/Publishing/Submit/Define_your_team">Step 6: Define team members</a></li> + <li><a href="/en-US/Marketplace/Publishing/Submit/View_your_listing">Step 7: View listing</a></li> + <li><a href="/en-US/Marketplace/Publishing/Submit/Edit_other_localizations">Step 8: Edit other localizations</a></li> + </ol> + </details> + </li> + <li class="toggle"> + <details><summary><a href="/en-US/Marketplace/Publishing/Managing_your_apps">Managing and updating published apps</a></summary> + <ol> + <li><a href="/en-US/Marketplace/Publishing/Managing_your_apps/Introduction_Managing_your_apps">Introduction</a></li> + <li><a href="/en-US/Marketplace/Publishing/Managing_your_apps/Status___Versions">Your app's status</a></li> + <li><a href="/en-US/Marketplace/Publishing/Updating_apps" title="Information about how both hosted and packaged app updates are handled, and what you need to do to ensure that your app properly supports updating.">Updating apps</a></li> + <li><a href="/en-US/Marketplace/Publishing/Managing_your_apps/App_Statistics">App Stats</a></li> + </ol> + </details> + </li> + <li class="toggle"> + <details><summary><a href="/en-US/docs/Mozilla/Marketplace/Add-on_submission">Add-on submission</a></summary> + <ol> + <li><a href="/en-US/docs/Mozilla/Marketplace/Add-on_submission">Add-on submission overview</a></li> + <li><a href="/en-US/docs/Mozilla/Marketplace/Add-on_submission/Review_criteria">Add-on review criteria</a></li> + </ol> + </details> + </li> + <li><a href="/en-US/Marketplace/APIs">Libraries and APIs</a></li> + <li><a href="/en-US/Marketplace/FAQ">Firefox Marketplace FAQ</a></li> +</ol> +</section> diff --git a/files/ar/archive/mozilla/marketplace/publishing/submit/index.html b/files/ar/archive/mozilla/marketplace/publishing/submit/index.html new file mode 100644 index 0000000000..a6e3468169 --- /dev/null +++ b/files/ar/archive/mozilla/marketplace/publishing/submit/index.html @@ -0,0 +1,10 @@ +--- +title: Submit +slug: Archive/Mozilla/Marketplace/Publishing/Submit +tags: + - NeedsTranslation + - TopicStub +translation_of: Archive/Mozilla/Marketplace/Publishing/Submit +--- +<p>This section describes the process for submitting an app to Firefox Marketplace</p> +<p>Residual details: <a href="/en-US/Marketplace/Publishing/Submit/Submitting_an_app">https://developer.mozilla.org/en-US/Marketplace/Publishing/Submit/Submitting_an_app</a></p> diff --git a/files/ar/archive/mozilla/marketplace/publishing/submit/rating_your_content/index.html b/files/ar/archive/mozilla/marketplace/publishing/submit/rating_your_content/index.html new file mode 100644 index 0000000000..8e4fbb5d91 --- /dev/null +++ b/files/ar/archive/mozilla/marketplace/publishing/submit/rating_your_content/index.html @@ -0,0 +1,121 @@ +--- +title: Obtaining a rating for your app +slug: Archive/Mozilla/Marketplace/Publishing/Submit/Rating_Your_Content +translation_of: Archive/Mozilla/Marketplace/Publishing/Submit/Rating_Your_Content +--- +<div class="warning"> +<p><font><font>هذه الصفحة يخضع للصيانة.</font></font></p> +</div> + +<div class="summary"> +<p><font><font>تمت موزيلا شراكة مع </font></font><a href="http://globalratings.com"><font><font>التقييم التحالف العمر الدولي</font></font></a><font><font> (IARC) لتشمل تصنيفات المحتوى المرتبط بالعمر جنبا إلى جنب مع جميع التطبيقات. </font><font>لأن موزيلا يهتم المستخدمين ويعتقد أن المستخدمين يجب أن تتاح الفرصة لتقرر أي محتوى غير مناسب لهم سيطلب من جميع التطبيقات في السوق فايرفوكس ليكون لها تصنيف IARC. </font><font>بينما نحن نحب كل من التطبيقات، التزامنا لهذه المبادرة يتطلب أي التطبيق أو اللعبة التي لم يكن لديك هذا التصنيف لشطبها من السوق بعد الموعد النهائي. </font><font>موزيلا قد مدد dealine إلى 15 مايو 2014 للسماح للمطورين متسع من الوقت لتحديث التطبيقات عبر حرة IARC أداة التصنيف.</font></font></p> +</div> + +<h2 id="حول_أداة_IARC_التقييم"><font><font>حول أداة IARC التقييم</font></font></h2> + +<p><font><font>IARC، وهو جهد تعاوني بين لوحات التصنيف الدولية، أدخلت أداة تقييم كحل لتعيين تصنيفات المحتوى إلى العالمية، وتطبيقات موزعة رقميا والألعاب. </font><font>عن طريق ملء استمارة بسيطة، يمكنك الحصول على التسميات تصنيف الفورية لجميع لوحات التصنيف المشاركة. </font><font>هذا لا يساعد فقط على تثقيف المستخدمين حول المحتوى، ولكن أيضا يقلل بشكل كبير من التكاليف والمتاعب المرتبطة بالحصول على مختلف تصنيفات المحتوى العالمي بشكل فردي.</font></font></p> + +<h2 id="أنظمة_التصنيف_الدولية_المعتمدة"><font><font>أنظمة التصنيف الدولية المعتمدة</font></font></h2> + +<p><font><font>باستخدام معالج تصنيف واحد، يتم إنشاء تصنيفات المحتوى للأنظمة والدول تصنيف متعددة والمناطق.</font></font></p> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col"><font><font>نظام التقييم</font></font></th> + <th scope="col"><font><font>الدول المعتمدة</font></font></th> + </tr> + </thead> + <tbody> + <tr> + <td><a href="http://culturadigital.br/classind/"><font><font>Classificação Indicativa </font></font></a></td> + <td><font><font>البرازيل</font></font></td> + </tr> + <tr> + <td><a href="http://www.esrb.org/"><font><font>ESRB</font></font></a></td> + <td><font><font>كندا، المكسيك، الولايات المتحدة الأمريكية</font></font></td> + </tr> + <tr> + <td><a href="http://www.pegi.info"><font><font>PEGI</font></font></a></td> + <td><font><font>النمسا، الدنمارك، هنغاريا، لاتفيا، والنرويج، وسلوفينيا، بلجيكا، استونيا، أيسلندا، ليتوانيا، بولندا، اسبانيا، بلغاريا، فنلندا، ايرلندا، لوكسمبورغ، البرتغال، السويد، قبرص، فرنسا، إسرائيل، مالطا، رومانيا، سويسرا، الجمهورية التشيكية ، اليونان، إيطاليا، هولندا، جمهورية سلوفاكيا، المملكة المتحدة</font></font></td> + </tr> + <tr> + <td><a href="http://usk.de/"><font><font>USK</font></font></a></td> + <td><font><font>ألمانيا</font></font></td> + </tr> + <tr> + <td><a href="https://www.globalratings.com/ratings_guide.aspx"><font><font>عام</font></font></a></td> + <td><font><font>تستخدم لجميع دول أخرى</font></font></td> + </tr> + </tbody> +</table> + +<h2 id="ماذا_في_تقييم_المحتوى؟"><font><font>ماذا في تقييم المحتوى؟</font></font></h2> + +<p><font><font>يوفر نظام تصنيف المستخدمين مع ثلاثة أنواع من المعلومات:</font></font></p> + +<ul> + <li><font><font>الحد الأدنى لسن الموصى بها - وهذا قد تختلف من بلد وثقافة.</font></font></li> + <li><font><font>واصفات المحتوى - وهذا يوفر معلومات حول أي محتوى يتضمن التطبيق التي قد تكون مصدر قلق لبعض المستخدمين. </font><font>ويمكن أن تشمل هذه المعلومات على العنف، ما يشير إلى تعاطي الكحول أو المخدرات، وعناصر مخيفة، والقمار حقيقية أو بالمحاكاة، الخ</font></font></li> + <li><font><font>عناصر تفاعلية - وهذا يوفر تفاصيل أي تفاعل المستخدم ميزات يحتوي التطبيق، مثل تبادل المعلومات الشخصية، وتقاسم مواقعها، ضمن التطبيق مشتريات وتحميل المحتوى أو مرافق الشبكات الاجتماعية.</font></font></li> +</ul> + +<p><font><font>عملية تقييم مجانية للمطورين، ويستغرق سوى بضع دقائق، وتتكامل مع عملية تقديم فايرفوكس السوق ومطور لوحة أجهزة القياس. </font><font>قبل أن يعاد النظر في التطبيق، يجب أن يكون لديها تصنيف. </font><font>للمستخدمين رؤية تقييم ملائم التطبيق لمنطقتهم على صفحة تفاصيل التطبيق، ويمكن معرفة المزيد من المعلومات ينبغي لها أن تختار لمعرفة المزيد.</font></font></p> + +<h2 id="الحصول_على_تقييم_المحتوى_للتطبيق_الخاص_بك"><font><font>الحصول على تقييم المحتوى للتطبيق الخاص بك</font></font></h2> + +<p><font><font>وقد وفرت IARC أداة مجانية لعبة التقييم التي هي بسيطة وبالنسبة لمعظم التطبيقات، ويأخذ أقل من خمس دقائق. </font><font>في هذا القسم سوف نستعرض هذه العملية.</font></font></p> + +<div class="note"> +<p><strong><font><font>ملاحظة</font></font></strong><font><font> : نحن للأسف لا يمكن أن تقبل شهادات تقدير من الأنظمة الأخرى. </font><font>إذا التطبيق الخاص بك بالفعل على تقييم عام من نظام آخر سوف لا تزال بحاجة للذهاب من خلال عملية شهادة IARC.</font></font></p> +</div> + +<ol> + <li><font><font>تسجيل الدخول إلى الموقع المطور فايرفوكس السوق. </font><font>لا يجوز الوصول إلى أداة تقييم عند تسجيل الدخول في كمطور.</font></font></li> + <li> + <p><font><font>الوصول إلى أداة IARC التقييم خلال عملية التقديم:</font></font></p> + + <p><img alt="يوضح مكان في تدفق تقديم التطبيق حيث التقييم يمكن إدخالها." src="https://mdn.mozillademos.org/files/6579/submission_flow.png" style="border-style: solid; border-width: 1px; height: 239px; width: 200px;"></p> + + <p><font><font>أو من لوحة ديف:</font></font></p> + + <p><img alt="" src="https://mdn.mozillademos.org/files/6623/from_nav_bar.png" style="border-style: solid; border-width: 1px; height: 199px; width: 200px;"></p> + </li> + <li> + <p><font><font>بدء عملية التقييم:</font></font></p> + + <p><img alt="" src="https://mdn.mozillademos.org/files/6583/start_the_rating_process.png" style="border-style: solid; border-width: 1px; height: 242px; width: 600px;"></p> + + <p><font><font>أو إدخال المعلومات الخاصة بك للحصول على تصنيف القائمة:</font></font></p> + + <p><img alt="" src="https://mdn.mozillademos.org/files/6585/enter_existing_rating_info.png" style="border-style: solid; border-width: 1px; height: 276px; width: 600px;"></p> + </li> + <li> + <p><font><font>ملء استبيان قصير:</font></font></p> + + <p><img alt="" src="https://mdn.mozillademos.org/files/6587/questions.png" style="border-style: solid; border-width: 1px; height: 725px; width: 600px;"></p> + </li> + <li> + <p><font><font>إضافة معلومات إضافية حول التطبيق الخاص بك:</font></font></p> + + <p><img alt="" src="https://mdn.mozillademos.org/files/6589/additional_info.png" style="height: 637px; width: 589px;"></p> + </li> + <li> + <p><font><font>المعاينة والتأكد من المعلومات تصويتك:</font></font></p> + + <p><img alt="" src="https://mdn.mozillademos.org/files/6591/confirm_info.png" style="border-style: solid; border-width: 1px; height: 865px; width: 400px;"></p> + </li> + <li> + <p><font><font>العودة إلى لوحة القيادة المطور ويجب أن نرى من المعلومات تصويتك. </font><font>كنت على استعداد للذهاب!</font></font></p> + </li> +</ol> + +<div class="note"> +<p><strong><font><font>ملاحظة</font></font></strong><font><font> : سوف تتلقى رسالة بريد إلكتروني مع شهادة التصنيف الخاص بك ورمز الأمان. </font><font>يرجى الاحتفاظ بنسخة لسجلاتك.</font></font></p> +</div> + +<h2 id="المزيد_من_المعلومات"><font><font>المزيد من المعلومات</font></font></h2> + +<p><font><font>إذا كان لديك أسئلة حول عملية التصنيف، وكيفية الإجابة، أو إذا كنت تعتقد تصويتك غير صحيح، يرجى إرسال بريد إلكتروني فريق IARC في </font></font><a href="mailto:dev-questions@globalratings.com"><font><font>dev-questions@globalratings.com</font></font></a><font><font> . </font><font>تتوفر معلومات إضافية حول أيضا </font></font><a href="http://globalratings.com/"><font><font>تصنيفات الموقع العالمي</font></font></a><font><font> .</font></font></p> + +<p><font><font>إذا كان لديك أي أسئلة أخرى، يمكنك الحصول على اتصال مع فريق الاستعراض التطبيق موزيلا في </font></font><a href="https://groups.google.com/forum/#!forum/mozilla.appreview" title="appreview@lists.mozilla.org"><font><font>mozilla.appreview</font></font></a><font><font> .</font></font></p> diff --git a/files/ar/archive/mozilla/xul/index.html b/files/ar/archive/mozilla/xul/index.html new file mode 100644 index 0000000000..7aa892890b --- /dev/null +++ b/files/ar/archive/mozilla/xul/index.html @@ -0,0 +1,82 @@ +--- +title: XUL +slug: Archive/Mozilla/XUL +translation_of: Archive/Mozilla/XUL +--- +<div class="callout-box"><strong><a href="/en-US/docs/XUL_Tutorial" title="en-US/docs/XUL_Tutorial">XUL Tutorial</a></strong><br> +A guided tutorial that will help you get started with XUL, originally from XULPlanet.</div> + +<div> +<p><span id="result_box" lang="ar"><span class="hps">XML</span></span><span lang="ar"> <span class="hps">(واجهة</span> <span class="hps">XML</span> <span class="hps">العضو</span> <span class="hps">اللغة</span><span>) هو</span> <span class="hps">القائم على اللغة</span> <span class="hps">XML</span> <span class="hps">موزيلا</span> <span class="hps">لبناء واجهات</span> <span class="hps">المستخدم</span> <span class="hps">من التطبيقات</span> <span class="hps">مثل فايرفوكس</span><span>.</span> <span class="hps">يستخدم مصطلح</span> <span class="hps">كسول</span> <span class="hps">أحيانا للإشارة</span> <span class="hps">إلى منصة</span> <span class="hps">موزيلا</span> <span class="atn hps">كاملة (</span><span>تطبيقات</span> <span class="hps">مثل</span> <span class="hps">XUL</span> <span class="hps">هي</span> <span class="hps">التطبيقات التي تستخدم</span> <span class="hps">كسول</span> <span class="hps">والمكونات الأخرى</span> <span class="hps">من</span> <span class="hps">النظام الأساسي</span><span>)</span><span>.</span></span></p> + +<p><a href="/en-US/docs/XUL_controls" title="en-US/docs/XUL_controls">XUL Controls</a> lists some of the common controls provided by XUL.</p> +</div> + +<table class="topicpage-table"> + <tbody> + <tr> + <td> + <h2 class="Documentation" id="Documentation">Documentation</h2> + + <dl> + <dt><strong><a href="/en-US/docs/XUL_Tutorial" title="en-US/docs/XUL_Tutorial">XUL Tutorial</a></strong></dt> + <dd>A guided tutorial that will help you get started with XUL, originally from XULPlanet.</dd> + <dt><a href="/en-US/docs/XUL_Reference" title="en-US/docs/XUL_Reference">XUL Reference</a></dt> + <dd>XUL elements, attributes, properties, methods, and event handlers.</dd> + <dt><a href="/en-US/docs/XUL_controls" title="en-US/docs/XUL_controls">XUL Controls</a></dt> + <dd>A quick list of all of the available XUL controls.</dd> + <dt><a href="/en-US/docs/The_Joy_of_XUL" title="en-US/docs/The_Joy_of_XUL">The Joy of XUL</a></dt> + <dd>Describes the key features and components of XUL.</dd> + <dt><a href="/en-US/docs/XUL/PopupGuide" title="en-US/docs/XUL/PopupGuide">Menus and Popups Guide</a></dt> + <dd>A guide on using menus and popup panels.</dd> + <dt><a href="/en-US/docs/XUL/Template_Guide" title="en-US/docs/XUL/Template_Guide">Template Guide</a></dt> + <dd>A detailed guide on XUL templates, which is a means of generating content from a datasource.</dd> + <dt><a href="/en-US/docs/DragDrop/Drag_and_Drop" title="Drag and Drop">Drag and Drop</a></dt> + <dd>How to perform drag and drop operations.</dd> + <dt><a href="/en-US/docs/XUL_Overlays" title="en-US/docs/XUL_Overlays">Overlays</a></dt> + <dd>Overlays are used to describe extra content for the UI. They provide a powerful mechanism for extending and customizing existing XUL applications.</dd> + </dl> + + <dl> + <dt>XUL Periodic Table</dt> + <dd>This collection of XUL demos used to be available as a web page, but can no longer be viewed in Firefox since support for <a href="/en-US/docs/Remote_XUL" title="/en-US/docs/Remote_XUL">Remote XUL</a> was disabled. There is a XULRunner application containing the XUL Periodic Table which can be opened with Gecko based browsers. <a href="https://github.com/matthewkastor/XULRunner-Examples" title="https://github.com/matthewkastor/XULRunner-Examples">You can get it here</a>. See: <a href="/en-US/docs/XULRunner_tips#Using_Firefox_3_to_run_XULRunner_applications" title="/en-US/docs/XULRunner_tips#Using_Firefox_3_to_run_XULRunner_applications">XULRunner_tips#Using_Firefox_3_to_run_XULRunner_applications</a> for instructions on running XULRunner apps in Firefox.</dd> + <dt>Changes to XUL</dt> + <dd>New XUL features and changes to existing features are included in the <a href="/en-US/docs/Mozilla/Firefox/Releases" title="/en-US/docs/Mozilla/Firefox/Releases">Firefox developer release notes</a>.</dd> + </dl> + + <p><span class="alllinks"><a href="/en-US/docs/tag/XUL" title="tag/XUL">View All...</a></span></p> + </td> + <td> + <h2 class="Community" id="Community">Community</h2> + + <ul> + <li>View Mozilla forums...{{ DiscussionList("dev-tech-xul", "mozilla.dev.tech.xul") }}</li> + <li><a class="link-irc" href="irc://irc.mozilla.org/xul">#xul on irc.mozilla.org</a></li> + </ul> + + <h2 class="Tools" id="Tools">Tools</h2> + + <ul> + <li><a class="external" href="/en-US/docs/XUL_Explorer" title="en-US/docs/XUL_Explorer">XUL Explorer</a> (a lightweight XUL IDE)</li> + <li><a href="https://github.com/matthewkastor/XULExplorer" title="https://github.com/matthewkastor/XULExplorer">XULExplorer</a> (Patched version of XUL explorer)</li> + <li><a class="external" href="http://ted.mielczarek.org/code/mozilla/extensiondev/">Extension developer's extension</a> (featuring a Live XUL Editor)</li> + <li><a class="external" href="http://forum.addonsmirror.net/index.php?showtopic=751" title="http://forum.addonsmirror.net/index.php?showtopic=751">XULRef sidebar</a></li> + <li><a class="external" href="http://www.getfirebug.com/">Firebug</a></li> + <li><a href="/en-US/docs/DOM_Inspector" title="en-US/docs/DOM_Inspector">DOM Inspector</a></li> + <li><a class="external" href="http://www.spket.com/">Spket IDE</a>, IDE for XUL/XBL</li> + <li><a class="external" href="http://www.amplesdk.com" title="http://www.amplesdk.com/">Ample SDK</a>, (Cross-browser XUL renderer in JavaScript/HTML)</li> + </ul> + + <p><span class="alllinks"><a href="/en-US/docs/tag/tools" title="tag/tools">View All...</a></span></p> + + <h2 class="Related_Topics" id="Related_Topics">Related Topics</h2> + + <ul> + <li><a href="/en-US/docs/JavaScript" title="en-US/docs/JavaScript">JavaScript</a>, <a href="/en-US/docs/XBL" title="en-US/docs/XBL">XBL</a>, <a href="/en-US/docs/CSS" title="en-US/docs/CSS">CSS</a>, <a href="/en-US/docs/RDF" title="en-US/docs/RDF">RDF</a>, <a href="/en-US/docs/Extensions" title="en-US/docs/Extensions">Extensions</a>, <a href="/en-US/docs/XULRunner" title="en-US/docs/XULRunner">XULRunner</a></li> + </ul> + </td> + </tr> + </tbody> +</table> + +<p> </p> diff --git a/files/ar/archive/mozilla/xulrunner/getting_started_with_xulrunner/index.html b/files/ar/archive/mozilla/xulrunner/getting_started_with_xulrunner/index.html new file mode 100644 index 0000000000..558d7c8163 --- /dev/null +++ b/files/ar/archive/mozilla/xulrunner/getting_started_with_xulrunner/index.html @@ -0,0 +1,266 @@ +--- +title: الشروع في العمل مع XULRunner +slug: Archive/Mozilla/XULRunner/Getting_started_with_XULRunner +translation_of: Archive/Mozilla/XULRunner/Getting_started_with_XULRunner +--- +<p>{{ Next("Windows and menus in XULRunner") }}</p> + +<p><span class="short_text" id="result_box" lang="ar"><span class="hps">يستكشف هذا المقال </span></span><a href="https://developer.mozilla.org/en-US/docs/The_Mozilla_platform" title="/en-US/docs/The_Mozilla_platform">منصة موزيلا </a><span id="result_box" lang="ar"><span class="hps">من خلال بناء</span> <span class="hps">تطبيقات سطح المكتب</span> <span class="hps">الأساسي</span> <span class="hps">باستخدام</span> </span><a href="https://developer.mozilla.org/en-US/docs/XULRunner" title="/en-US/docs/XULRunner">XULRunner</a><span lang="ar"><span>. </span></span><span class="short_text" id="result_box" lang="ar"><span class="hps">وبالنظر إلى أن</span> <span class="hps">فايرفوكس</span><span>، طائر الرعد، </span></span>وغيرها من التطبيقات المتعددة المكتوبة باستخدام المنصة، فهي رهان آمن أنه يمكن استخدامها لبناء التطبيق الأساسي. <span id="result_box" lang="ar"><span class="hps">هناك</span> <span class="hps">مقال</span> <span class="hps">مع اتباع نهج</span> <span class="hps">أكثر تعقيدا ل</span><span>بناء تطبيقات</span> <span class="hps">XULRunner</span> <span class="hps">في </span></span><a href="https://developer.mozilla.org/en-US/docs/Creating_XULRunner_Apps_with_the_Mozilla_Build_System">إنشاء تطبيقات XULRunner مع موزيلا بناء النظام. </a><span id="result_box" lang="ar"><span class="hps">إذا</span> <span class="hps">كنت بحاجة إلى تغيير</span> <span class="hps">XULRunner</span> <span class="hps">نفسه</span> <span class="hps">أو</span> <span class="hps">دمجه</span> <span class="hps">مع</span> <span class="hps">ثنائيات</span> <span class="hps">الخارجية</span> <span class="hps">قد تحتاج إلى</span> <span class="hps">قراءة</span> <span class="hps">هذه المقال.</span></span><span lang="ar"><span> </span></span><span class="short_text" lang="ar"><span class="hps"> </span></span></p> + +<h2 id="Step_1:_Download_XULRunner" name="Step_1:_Download_XULRunner"><span class="short_text" id="result_box" lang="ar"><span class="hps">الخطوة 1</span><span>: تحميل</span> <span class="hps">XULRunner</span></span></h2> + +<p><span id="result_box" lang="ar"><span class="hps">يمكنك العثور على</span> <span class="hps">رابط التحميل</span> <span class="hps">في الصفحة</span> <span class="hps">الرئيسية</span> <a href="https://developer.mozilla.org/en-US/docs/XULRunner">XULRunner</a> <span class="hps">هنا</span> <span class="hps">على</span> <span class="hps">MDN</span><span>. </span></span>ومنذ حين أننا لا نخلق أي مكون من مكونات XPCOM الثنائية، نحن بحاجة فقط لتنزيل وتثبيت حزمة وقت التشغيل XULRunner، وليس <a href="https://developer.mozilla.org/en-US/docs/Gecko_SDK">SDK</a>.</p> + +<p>تحميل XULRunner لـ ويندوز هو ملف مضغوط، ليس مناسباً تثبيته. كمطور، أنا أحب فكرة أن XULRunner يكون فقط ملفات غير مضغوطة على الجهاز الخاص بي. وأنا على افتراض أنها لا تحتاج إلى ربط في نظام ويندوز الخاص بي، وهذا شيء جيد. وهذا يعني أيضا أن XULRunner هو قابل للحمل كذلك، إذا كنت طورت التطبيقات الخاصة بك لتكون محمولة يمكنك أن تحملها وتحولها على محرك أقراص أو مزامنتها في السحابة.</p> + +<p><span id="result_box" lang="ar"><span class="hps">يتم توزيع</span> <span class="hps">نسخة ماك</span> <span class="hps">من</span> <span class="hps">XULRunner</span> <span class="hps">كأرشيف</span> <span class="hps">tar.bz2</span><span>.</span> <span class="hps">يمكنك استخراج</span> <span class="hps">هذه</span> <span class="hps">إلى أي مكان</span> <span class="hps">تريد، </span></span>لكن هناك العديد من المواضيع في الوثائق التي من شأنها أن نفترض أن لديك هذا مثبت في <code>\Library\Frameworks</code>.</p> + +<p>في أوبونتو سطح المكتب ومشتقاته (Xubuntu, Kubuntu, ...)، من الإصدار 11.10 (Oneiric Ocelot)، لم تعد تحتفظ بـ XULRunner وغير موجود في مستودع أوبونتو. لذلك، ربما تحتاج إلى تجميع XULRunner يدوياً أو تحميل الأفراج ثنائي من خادم FTP موزيلا. ولتحقيق ذلك، يجب تشغيل السكربيت التالي في كل مرة ترغب بتثبيت نسخة جديدة:</p> + +<div class="note"><code>FIREFOX_VERSION=`grep -Po "\d{2}\.\d+" /usr/lib/firefox/platform.ini`<br> +ARCH=`uname -p`<br> +XURL=https://ftp.mozilla.org/pub/mozilla.org/xulrunner/releases/$FIREFOX_VERSION/runtimes/xulrunner-$FIREFOX_VERSION.en-US.linux-$ARCH.tar.bz2<br> +cd /opt<br> +sudo sh -c "wget -O- $XURL | tar -xj"<br> +sudo ln -s /opt/xulrunner/xulrunner /usr/bin/xulrunner<br> +sudo ln -s /opt/xulrunner/xpcshell /usr/bin/xpcshell </code></div> + +<p>يمكنك أيضاً حفظ السكربيت إلى ملف لتوفير العناء عليك. ملاحظة: إذا كنت تستخدم Firefox build من مستودع Ubuntuzilla، استبدال <code>/usr/lib/firefox/platform.ini مع </code> <code>/opt/firefox/platform.ini</code>.</p> + +<h2 id="Step_2:__Install_XULRunner" name="Step_2:__Install_XULRunner"><span class="short_text" id="result_box" lang="ar"><span class="hps">الخطوة 2</span><span>: تثبيت</span> <span class="hps">XULRunner</span></span></h2> + +<p>على ويندوز، فك الأرشيف في مكان معقول. I فكه إلى ملف جديد في (<code>C:\program files\xulrunner</code> folder).</p> + +<p>على ماك، استخراج الأرشيف tar.bz2، الذي يحتوي على XULRunner كما XUL.Framework. نسخ هذا إلى ( <code>/Library/Frameworks</code> directory)، أو موقع آخر من اختيارك.</p> + +<p>على لينكس، تحتاج فقط إلى فك الأرشيف إذا كنت تستخدم ما قبل الأفراج XULRunner.</p> + +<div class="note"> +<p>في جميع النظم يجب عليك فك الملف <a href="https://developer.mozilla.org/en-US/docs/Mozilla/About_omni.ja_(formerly_omni.jar)">omni.ja</a> إلى الدليل على سبيل المثال وألقاء نظرة عبى محتوياته لترى كم هي مدهشة! ولفعل ذلك عليك تغير أمتداد الملف إلى (zip) و أستخدام أداة الضفط العادية لأستخراج الملفات وفتحه. محتويات omni.ja المتاحة لتطبيقات XULRunner هي التي تجعل من الممكن لبناء تطبيقات مذهلة بسهولة!</p> +</div> + +<h2 id="Step_3:_Create_the_application_folder_structure" name="Step_3:_Create_the_application_folder_structure"><span class="short_text" id="result_box" lang="ar"><span class="hps">الخطوة 3</span><span>:</span> <span class="hps">إنشاء هيكل</span> <span class="hps">مجلد التطبيق</span></span></h2> + +<p>حان الوقت للبدء بمثال بسيط وكشف هيكل التطبيق shell. ونسميها XUL "مرحباً بالعالم" <span id="result_box" lang="ar"><span class="hps">إذا كنت تريد. وكل ما تراه أدناه</span> <span class="hps">يمكن العثور عليها في</span> <span class="hps">وثائق</span> <a href="https://developer.mozilla.org/en-US/docs/XULRunner">XULRunner</a> <span class="hps">هنا</span> <span class="hps">على</span> <span class="hps">MDN</span> <span class="hps">بمزيد</span> <span class="hps">من التفاصيل</span><span>.</span></span></p> + +<div class="note"> +<p><strong>تلميح</strong>: تخطي إلى الأمام وتحميل نموذج التطبيق، يمكنك تجربة ذلك و أنت تتابع هذا البرنامج التعليمي. يمكنك تنزيل عينة التطبيق من <a href="https://github.com/matthewkastor/XULRunner-Examples" title="https://github.com/matthewkastor/XULRunner-Examples">https://github.com/matthewkastor/XULRunner-Examples</a>. يرجى مواصلة القراءة لمعرفة "ما"، "لماذا" و "كيف" بناء أجزاء التطبيق في XULRunner.</p> +</div> + +<p>On Windows, I created the root in a new <code>c:\program files\myapp</code> folder, but you can create it wherever you like, using whatever OS you like. The same application structure is used on Windows, Mac and Linux. Here is the subfolder structure:</p> + +<pre>+ myapp/ +| ++-+ chrome/ +| | +| +-+ content/ +| | | +| | +-- main.xul +| | | +| | +-- main.js +| | +| +-- chrome.manifest +| ++-+ defaults/ +| | +| +-+ preferences/ +| | +| +-- prefs.js +| ++-- application.ini +| ++-- chrome.manifest +</pre> + +<p>Notice that there are 5 files in the folder structure: <code>application.ini</code>, <code>chrome.manifest (2)</code>, <code>prefs.js</code>, and <code>main.xul</code>. The <code>/chrome/chrome.manifest</code> file is optional, but might be useful for backward compatibility. See the note below.</p> + +<div class="note"> +<p>For more details on the structure of installable bundles in general see: <a href="/en-US/docs/Bundles" title="/en-US/docs/Bundles">Structure of an installable bundle</a>.</p> +</div> + +<div class="note"><strong>Note:</strong> In XULRunner 2.0, the chrome.manifest is now used to register XPCOM components in addition to its previous uses. Part of this change means the <code>/chrome/chrome.manifest</code> is no longer considered the "root" manifest. XULRunner will not check that folder location for a root-level <code>chrome.manifest</code>. You need to move your existing chrome.manifest to the application root folder, remembering to update the relative paths within the file. You could also just create a new application root-level manifest that includes the <code>/chrome/chrome.manifest</code>, which is what this tutorial will do.</div> + +<h2 id="Step_4:_Set_up_application.ini" name="Step_4:_Set_up_application.ini">Step 4: <code>Set up application.ini</code></h2> + +<p>The<code> <a href="/en-US/docs/XUL_Application_Packaging" title="/en-US/docs/XUL_Application_Packaging">application.ini</a> </code>file acts as the XULRunner entry point for your application. It specifies how your application intends to use the XULRunner platform as well as configure some information that XULRunner uses to run your application. Here is mine:</p> + +<pre>[App] +Vendor=XULTest +Name=myapp +Version=1.0 +BuildID=20100901 +ID=xulapp@xultest.org + +[Gecko] +MinVersion=1.8 +MaxVersion=200.* +</pre> + +<div class="note"><strong>Note:</strong> The <code>MinVersion</code> and <code>MaxVersion</code> fields indicate the range of Gecko versions your application is compatible with; make sure that you set them so that the version of XULRunner you're using is in that range, or your application won't work.</div> + +<div class="note"><strong>Note</strong>: Make sure your application name is lowercase and longer than 3 characters</div> + +<h2 id="Step_5:_Set_up_the_chrome_manifest" name="Step_5:_Set_up_the_chrome_manifest">Step 5: Set up the chrome manifest</h2> + +<p>The <a href="/en-US/docs/Chrome_Registration" title="/en-US/docs/Chrome_Registration">chrome manifest</a> file is used by XULRunner to define specific URIs which in turn are used to locate application resources. This will become clearer when we see how the “chrome://” URI is used. Application chrome can be in a single or a few JAR files or uncompressed as folders and files. I am using the uncompressed method for now. Here is the <code>chrome/chrome.manifest</code>:</p> + +<pre class="eval"> content myapp content/ +</pre> + +<p>As mentioned in Step 3, the default location of the <code>chrome.manifest</code> has changed in XULRunner 2.0, so we also need a simple <code>chrome.manifest</code> in the <strong>application</strong> root which will include the the manifest in our <strong>chrome</strong> root. Here is the application root <code>chrome.manifest</code>:</p> + +<pre>manifest chrome/chrome.manifest</pre> + +<h2 id="Step_6:_Set_up_preferences" name="Step_6:_Set_up_preferences">Step 6: Set up preferences</h2> + +<p>The <a href="/en-US/docs/Mozilla/Preferences/A_brief_guide_to_Mozilla_preferences" title="/en-US/docs/Mozilla/Preferences/A_brief_guide_to_Mozilla_preferences">prefs.js</a> file tells XULRunner the name of the XUL file to use as the main window. Here is mine:</p> + +<pre class="eval">pref("toolkit.defaultChromeURI", "<span class="external">chrome://myapp/content/main.xul</span>"); + +/* debugging prefs, disable these before you deploy your application! */ +pref("browser.dom.window.dump.enabled", true); +pref("javascript.options.showInConsole", true); +pref("javascript.options.strict", true); +pref("nglayout.debug.disable_xul_cache", true); +pref("nglayout.debug.disable_xul_fastload", true); +</pre> + +<p>XULRunner specific preferences include:</p> + +<dl> + <dt><code><a href="/en-US/docs/toolkit.defaultChromeURI" title="/en-US/docs/toolkit.defaultChromeURI">toolkit.defaultChromeURI</a></code></dt> + <dd>Specifies the default window to open when the application is launched.</dd> + <dt><code><a href="/en-US/docs/toolkit.defaultChromeFeatures" title="/en-US/docs/toolkit.defaultChromeFeatures">toolkit.defaultChromeFeatures</a></code></dt> + <dd>Specifies the features passed to <code><a href="/en-US/docs/DOM:window.open" title="/en-US/docs/DOM:window.open">window.open()</a></code> when the main application window is opened.</dd> + <dt><code><a href="/en-US/docs/toolkit.singletonWindowType" title="/en-US/docs/toolkit.singletonWindowType">toolkit.singletonWindowType</a></code></dt> + <dd>Allows configuring the application to allow only one instance at a time.</dd> +</dl> + +<div class="note"> +<p>The toolkit preferences are described in further detail in <a href="/en-US/docs/XULRunner/Specifying_Startup_Chrome_Window" title="/en-US/docs/XULRunner/Specifying_Startup_Chrome_Window">XULRunner:Specifying Startup Chrome Window</a>.</p> + +<p>The debugging preferences are discussed in <a href="/en-US/docs/Debugging_a_XULRunner_Application" title="/en-US/docs/Debugging_a_XULRunner_Application">Debugging a XULRunner Application</a></p> +</div> + +<h2 id="Step_7:_Create_some_XUL" name="Step_7:_Create_some_XUL">Step 7: Create some XUL</h2> + +<p>Finally, we need to create a simple <a href="/en-US/docs/XUL/window" title="/en-US/docs/XUL/window">XUL window</a>, which is described in the file <code>main.xul</code>. Nothing fancy here, just the minimum we need to make a window. No menus or anything.</p> + +<p>main.xul:</p> + +<pre><?xml version="1.0"?> + +<?xml-stylesheet href="chrome://global/skin/" type="text/css"?> + +<window id="main" title="My App" width="300" height="300" xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"> + + <script type="application/javascript" src="chrome://myapp/content/main.js"/> + + <caption label="Hello World"/> + <separator/> + <button label="More >>" oncommand="showMore();"/> + <separator/> + <description id="more-text" hidden="true">This is a simple XULRunner application. XUL is simple to use and quite powerful and can even be used on mobile devices.</description> + +</window> +</pre> + +<div class="note"><strong>Note:</strong> Make sure there is no extra whitespace at the beginning of the XML/XUL file</div> + +<p>The application also has a JavaScript file. Most XUL applications will include some external JavaScript, so the sample application does too, just to show how to include it into the XUL file.</p> + +<p>main.js:</p> + +<pre>function showMore() { + document.getElementById("more-text").hidden = false; +} +</pre> + +<div class="note"> +<p>For more information about XUL see: <a href="/en-US/docs/XUL" title="/en-US/docs/XUL">XUL</a>.</p> + +<p>For information about mixing HTML elements into your XUL read <a href="/en-US/docs/XUL/Tutorial/Adding_HTML_Elements" title="/en-US/docs/XUL/Tutorial/Adding_HTML_Elements">Adding HTML Elements</a>.</p> +</div> + +<h2 id="Step_8:_Run_the_application" name="Step_8:_Run_the_application">Step 8: Run the application</h2> + +<p>The moment of truth. We need to get XULRunner to launch the bare-bones application.</p> + +<h3 id="Windows">Windows</h3> + +<p>From a Windows command prompt opened to the <code>myapp</code> folder, we should be able to execute this:</p> + +<pre class="eval"> C:\path\to\xulrunner.exe application.ini +</pre> + +<p>Of course, if you opted to install xulrunner then you could simply do</p> + +<pre><span style="font-family: courier new,andale mono,monospace; line-height: normal;">%ProgramFiles%\xulrunner.exe application.ini</span></pre> + +<p><span style="font-size: 14px; line-height: 1.572;">or on 64 bit systems</span></p> + +<pre><span style="font-family: courier new,andale mono,monospace; line-height: normal;">%ProgramFiles(x86)%\xulrunner.exe application.ini</span></pre> + +<div class="note"> +<p><span style="font-size: 14px; line-height: 1.572;"><strong>Note</strong>: you can also install your application when you're finished debugging it. See <a href="/en-US/docs/XUL_Application_Packaging" title="/en-US/docs/XUL_Application_Packaging">XUL Application Packaging</a> for details.</span></p> +</div> + +<h3 id="Mac">Mac</h3> + +<p>On the Mac, before you can run a XULRunner application with everything intact, you must install it using the <code>--install-app</code> xulrunner commandline flag. Installing the application creates an OS X application bundle:</p> + +<pre class="eval"> /Library/Frameworks/XUL.framework/xulrunner-bin --install-app /<path>/<to>/myapp.zip +</pre> + +<p>Once installed, you can run the application:</p> + +<pre class="eval"> /Library/Frameworks/XUL.framework/xulrunner-bin "/Applications/Finkle/TestApp.app/Contents/Resources/application.ini" +</pre> + +<p>You may run it without installing (but with the menu bar and dock icon missing) in OS X by typing:</p> + +<pre>/Library/Frameworks/XUL.framework/xulrunner-bin "/<full path>/TestApp/application.ini" +</pre> + +<div class="note"> +<p>Note: The full path is required or a "Error: couldn't parse application.ini."-message will be returned.</p> +</div> + +<p>This might also be simplified using a very simple shell script (i call mine "run.sh"):</p> + +<pre>#!/bin/sh +/Library/Frameworks/XUL.framework/xulrunner-bin `pwd`/application.ini +</pre> + +<h3 id="Linux">Linux</h3> + +<p>On Ubuntu, you can run the application from a terminal. First change into the <code>\myapp</code> folder, then start the application by:</p> + +<pre class="eval"> xulrunner application.ini +</pre> + +<p>You should now see a window that looks something like this. This particular screenshot is from Ubuntu 10.</p> + +<p><img alt="myapp-screenshot.png" class="default internal" src="/@api/deki/files/4679/=myapp-screenshot.png"></p> + +<h3 id="Alternative:_Use_Firefox3_-app_to_run_XUL_apps" name="Alternative:_Use_Firefox3_-app_to_run_XUL_apps">Alternative: Run XUL apps with Firefox</h3> + +<p>With Firefox 3 and later, you can tell the Firefox executable to run a XUL application from the command line. The XUL application will run instead of the Firefox browser that normally starts. This is similar to starting a XUL app using XULRunner. See <a href="/en/XULRunner_tips#Using_Firefox_to_run_XULRunner_applications" title="en/XULRunner_tips#Using_Firefox_to_run_XULRunner_applications">Using Firefox to run XULRunner applications</a>. This does not work if Firefox itself was installed as a XUL app - you need to use the installed XULRunner directly.</p> + +<h2 id="Further_Reading">Further Reading:</h2> + +<p>There are many things you can do with XULRunner. Before you get too far into things you might want to read the <a href="/en-US/docs/XULRunner_tips" title="/en-US/docs/XULRunner_tips">XULRunner tips</a> article. Also, throughout this tutorial you've been introduced to various bits of the <a href="/en-US/docs/Toolkit_API" title="/en-US/docs/Toolkit_API">Toolkit API</a> and it may help you to get familiar with it. Once you've got an application that's ready for the world you'll love our article titled <a href="/en-US/docs/XULRunner/Deploying_XULRunner_1.8" title="/en-US/docs/XULRunner/Deploying_XULRunner_1.8">Deploying XULRunner</a>.</p> + +<p>For now, click the "next" link to learn about windows and menus in XULRunner!</p> + +<p>{{ Next("Windows and menus in XULRunner") }}</p> + +<div class="originaldocinfo"> +<h2 id="Original_Document_Information" name="Original_Document_Information">Original Document Information</h2> + +<ul> + <li>Author: Mark Finkle, October 2, 2006</li> +</ul> +</div> + +<p>{{ languages( { "ja": "ja/Getting_started_with_XULRunner", "ko": "ko/Getting_started_with_XULRunner" } ) }}</p> diff --git a/files/ar/archive/mozilla/xulrunner/index.html b/files/ar/archive/mozilla/xulrunner/index.html new file mode 100644 index 0000000000..76fc75584f --- /dev/null +++ b/files/ar/archive/mozilla/xulrunner/index.html @@ -0,0 +1,88 @@ +--- +title: XULRunner +slug: Archive/Mozilla/XULRunner +tags: + - NeedsTranslation + - NeedsUpdate + - TopicStub + - XUL + - XULRunner +translation_of: Archive/Mozilla/XULRunner +--- +<div class="callout-box"><strong><a href="/en-US/docs/Getting_started_with_XULRunner" title="Getting_started_with_XULRunner">Getting Started with XULRunner</a></strong><br> +A short introduction to XULRunner.</div> + +<div><span class="seoSummary"><strong>XULRunner</strong> is a Mozilla runtime package that can be used to bootstrap <a href="/en-US/docs/XUL" title="XUL">XUL</a>+<a href="/en-US/docs/XPCOM" title="XPCOM">XPCOM</a> applications that are as rich as Firefox and Thunderbird. It provides mechanisms for installing, upgrading, and uninstalling these applications.</span> XULRunner also provides <code>libxul</code>, a solution which allows the embedding of Mozilla technologies in other projects and products.</div> + +<table class="topicpage-table"> + <tbody> + <tr> + <td> + <h2 id="Releases" name="Releases">Releases</h2> + + <div class="note"> + <p>Until version 41, XULRunner could be <a class="external" href="http://ftp.mozilla.org/pub/mozilla.org/xulrunner/releases/latest" title="http://ftp.mozilla.org/pub/mozilla.org/xulrunner/releases/">downloaded from ftp.mozilla.org</a>.</p> + + <p>Firefox (from version 3) ships with a private XULRunner package, which can run any compatible XULRunner application using the <code>-app</code> switch: <em><code>firefox -app application.ini</code> is equivalent to <code>xulrunner -app application.ini</code></em></p> + + <p><a href="/en-US/docs/XULRunner/Old_Releases" title="XULRunner/Old_Releases">Older builds</a> are also available.</p> + </div> + + <h2 id="Overview" name="Overview">Overview</h2> + + <ul> + <li>{{ interwiki('wikimo', 'XULRunner', 'Development Plan') }}</li> + <li><a href="/en-US/docs/XULRunner/What_XULRunner_Provides" title="XULRunner/What_XULRunner_Provides">What XULRunner Provides</a></li> + <li><a href="/en-US/docs/XULRunner_FAQ" title="XULRunner_FAQ">XULRunner FAQ</a></li> + <li>Nightly builds: <a class="external" href="http://ftp.mozilla.org/pub/mozilla.org/xulrunner/nightly/latest-trunk/">unstable-trunk</a></li> + </ul> + + <h2 class="Documentation" id="Documentation" name="Documentation">Documentation</h2> + + <dl> + <dt><a href="/en-US/docs/Getting_started_with_XULRunner" title="Getting_started_with_XULRunner">Getting Started with XULRunner</a></dt> + <dd>Short tutorial on building desktop applications with XULRunner.</dd> + <dt><a href="/en-US/docs/XUL_Tutorial" title="XUL Tutorial">XUL Tutorial</a></dt> + <dd>Once you have a working XULRunner application, use the XUL tutorial to expand it into a fantastic XUL application.</dd> + <dt><a href="/en-US/docs/XULRunner_tips" title="XULRunner_tips">XULRunner tips</a></dt> + <dd>A collection of tips for working with XULRunner.</dd> + <dt><a href="/en-US/docs/XULRunner/Deploying_XULRunner_1.8" title="XULRunner/Deploying_XULRunner_1.8">Deploying XULRunner</a></dt> + <dd>An introduction on how to package your application with XULRunner.</dd> + <dt><a href="/en-US/docs/XULRunner_Hall_of_Fame" title="XULRunner_Hall_of_Fame">XULRunner Hall of Fame</a></dt> + <dd>Tracks all available applications based on XULRunner.</dd> + <dt><a href="/en-US/docs/Developer_Guide/Build_Instructions" title="Build_Documentation">Build Documentation</a></dt> + <dd>Learn how to get the source and build it.</dd> + <dt><a href="/en-US/docs/Debugging_a_XULRunner_Application" title="Debugging_a_XULRunner_Application">Debug Documentation</a></dt> + <dd>Steps to configure Venkman to debug your App</dd> + <dt><a class="external" href="http://zenit.senecac.on.ca/wiki/index.php/XULRunner_Guide">XULRunner Guide</a></dt> + <dd>A fairly complete, but outdated, introduction and tutorial for XULRunner which collates much of the documentation found here.</dd> + </dl> + + <p><span class="alllinks"><a href="/en-US/docs/tag/XULRunner" title="tag/XULRunner">View all...</a></span></p> + </td> + <td> + <h2 class="Community" id="Community" name="Community">Community</h2> + + <ul> + <li>View Mozilla forums... {{ DiscussionList("dev-platform", "mozilla.dev.platform") }}</li> + <li><a class="link-irc" href="irc://irc.mozilla.org/#xulrunner">#xulrunner on irc.mozilla.org</a></li> + <li><a href="/en-US/docs/XULRunner/Community" title="XULRunner/Community">Other community links...</a></li> + </ul> + + <h2 class="Related_Topics" id="Related_Topics" name="Related_Topics">Related topics</h2> + + <ul> + <li><a href="/en-US/docs/XUL" title="XUL">XUL</a></li> + </ul> + + <h2 id="See_also" name="See_also">See also</h2> + + <ul> + <li><a class="external" href="http://www.kodewerx.org/wiki/A_Brief_Introduction_To_XULRunner:_Part_1" title="http://www.kodewerx.org/wiki/A_Brief_Introduction_To_XULRunner:_Part_1">A brief introduction to XULRunner</a></li> + </ul> + </td> + </tr> + </tbody> +</table> + +<p> </p> diff --git a/files/ar/archive/themes/index.html b/files/ar/archive/themes/index.html new file mode 100644 index 0000000000..a440be2e7a --- /dev/null +++ b/files/ar/archive/themes/index.html @@ -0,0 +1,11 @@ +--- +title: Themes +slug: Archive/Themes +tags: + - NeedsTranslation + - TopicStub +translation_of: Archive/Themes +--- +<p>Archived theme documentation.</p> + +<p>{{Listsubpages("/en-US/docs/Archive/Themes", 10)}}</p> diff --git a/files/ar/building_a_theme/index.html b/files/ar/building_a_theme/index.html new file mode 100644 index 0000000000..e254bb4ce8 --- /dev/null +++ b/files/ar/building_a_theme/index.html @@ -0,0 +1,189 @@ +--- +title: Building a Theme +slug: Building_a_Theme +translation_of: Archive/Themes/Building_a_Theme +--- +<h3 class="editable" dir="rtl" id="مقدمة"><strong>مقدمة</strong></h3> +<h4 dir="rtl" id="هذه_الدورة_ستقدم_لكم_الخطوات_المطلوبة_لبناء_نموذجية_لمتصفح_فيرافوكس._واحد_سيقوم_بتحديثات_لون_الخلفية_وشريط_الأدوات_في_فيرافوكس.">هذه الدورة ستقدم لكم الخطوات المطلوبة لبناء نموذجية لمتصفح فيرافوكس. واحد سيقوم بتحديثات لون الخلفية وشريط الأدوات في فيرافوكس.</h4> +<div class="note" dir="rtl"> + <p><strong>ملاحظة: هذه الدورة مخصصة حول بناء سمة لإصدارات فيرافوكس 29 وأعلى، وهناك محاور أخرى لبناء الإصدارات السابقة من فيرافوكس. إنظر:</strong></p> + <p style="text-align: center;"><a class="internal" href="https://developer.mozilla.org/docs/Creating_a_Skin_for_Firefox_Getting_Started" title="en/Creating a Skin for Firefox//Getting Started">Creating a Skin for Firefox</a></p> +</div> +<div id="section_2"> + <h4 class="editable" dir="rtl" id="إعداد_بيئة_التطوير"><strong>إعداد بيئة التطوير</strong></h4> + <p dir="rtl">السمات وملحقات الحزم والموزعة في ملفات ZIP أو <a href="https://developer.mozilla.org/docs/Bundles" rel="internal">Bundles</a> ،من خلال ملف الملحقة XPI (تقرأ"<em>zippy") </em></p> + <p dir="rtl">مثال عن المحتوى داخل ملف نموذجي لـ XPI الخاص بسمة نموذجية:</p> + <pre class="eval">example.xpi: + /<a href="/Add-ons/Install_Manifests" rel="internal">install.rdf</a> + /<a href="/docs/Chrome_Registration" rel="internal">chrome.manifest</a> + /preview.png + /icon.png + /chrome/ + browser/ + communicator/ + global/ + mozapps/ + +</pre> + <p dir="rtl">سنقوم ببناء</p> + <p dir="rtl">We'll want to create a file structure similar to the one above for our tutorial, so let's begin by creating a folder for your theme somewhere on your hard disk (e.g. <code>C:\themes\my_theme\</code> or <code>~/themes/my_theme/</code>). Inside your new theme folder, create two new empty text files, one called <code>chrome.manifest</code> and the other called <code>install.rdf</code>. The file <code>preview.png</code> is shown as a preview of the theme in the themes panel of the add-ons window. The file <code>icon.png</code> is used as an icon in the same panel. We'll leave both of them out for now, unless you have something picked out that you want to use.</p> + <p>The remaining directories will be extracted from the default theme. First, you'll want to create a directory somewhere. <strong>Copy</strong> your Firefox installation's <code>omni.ja</code> into this directory. The location differs by operating system:</p> + <p><strong>Linux:</strong> <code>/usr/lib/MozillaFirefox/chrome/classic.jar</code> <em>or</em> <code>/usr/lib/firefox-*.*.*/omni.ja</code></p> + <p><strong>Windows:</strong> <code>\Program Files\Mozilla Firefox\omni.ja</code></p> + <p><strong>Mac OS X: </strong><code>/Applications/Firefox.app/Contents/MacOS/omni.ja</code></p> + <p>Now, open (or unzip) this file into the directory you created. It contains several folders, <code>modules</code>, <code>jssubloader</code> and others. The files we will be needing are located under the <code>chrome\toolkit\skin\classic</code> folder.</p> + <p>Create a folder called <code>chrome</code>in your theme's folder. Next, the contents of the following directories to their respective folders into the folder.</p> + <ol> + <li><code>global</code> to <code>chrome/global</code></li> + <li><code>mozapps</code> to <code>chrome/mozapps</code></li> + </ol> + <p>Now that you've copied the <code>global</code> and <code>mozapps</code> folders, a handful of other folders from the <code>browser/omni.ja</code> archive are required. It is located in the browser folder in the location mentioned above. The files we will be needing from the browser/omni.ja archive are located under <code>chrome/browser/skin/classic</code>.</p> + <p>Copy the contents of the following directories to their respective folders. This gives us a base set of styles to work with.</p> + <ol> + <li><code>browser</code> to <code>chrome/browser/</code></li> + <li><code>communicator</code> to <code>chrome/communicator/</code></li> + </ol> + <p>You should end up with this directory structure:</p> + <pre><ext path>/ + /install.rdf + /chrome.manifest + /chrome/ + browser/ + communicator/ + global/ + mozapps/ +</pre> + <p>After this, it would be a good idea to read the article <a href="/Add-ons/Setting_up_extension_development_environment" rel="internal">Setting up extension development environment</a> and follow the directions there. It's especially important to install the <a class="internal" href="/en/DOM_Inspector" title="en/DOM Inspector">DOM Inspector</a>, which we'll be using in later steps.</p> +</div> +<div id="section_3"> + <h4 class="editable" id="Create_the_Install_Manifest"><span>Create the Install Manifest</span></h4> + <p>Open the file called <code><a href="/Add-ons/Install_Manifests" rel="internal">install.rdf</a></code> that you created at the top of your extension's folder hierarchy and put this inside:</p> + <pre class="eval"><?xml version="1.0"?> + +<RDF xmlns="<a class="external" href="http://www.w3.org/1999/02/22-rdf-syntax-ns#" rel="freelink">http://www.w3.org/1999/02/22-rdf-syntax-ns#</a>" + xmlns:em="<a class="external" href="http://www.mozilla.org/2004/em-rdf#" rel="freelink">http://www.mozilla.org/2004/em-rdf#</a>"> + + <Description about="urn:mozilla:install-manifest"> + <em:id><strong><a class="link-mailto" href="mailto:sample@example.net" rel="external nofollow" title="mailto:sample@example.net">sample@example.net</a></strong></em:id> + <em:version><strong>1.0</strong></em:version> + <em:type><strong>4</strong></em:type> + + <!-- Target Application this theme can install into, + with minimum and maximum supported versions. --> + <em:targetApplication> + <Description> + <em:id><strong>{ec8030f7-c20a-464f-9b0e-13a3a9e97384}</strong></em:id> + <em:minVersion><strong>29.0</strong></em:minVersion> + <em:maxVersion>32<strong>.*</strong></em:maxVersion> + </Description> + </em:targetApplication> + + <!-- Front End MetaData --> + <em:name><strong>My Theme</strong></em:name> + <em:internalName><strong>sample</strong></em:internalName> + <em:description><strong>A test extension</strong></em:description> + <em:creator><strong>Your Name Here</strong></em:creator> + <em:homepageURL><strong><a class="external" href="http://www.example.com/" rel="freelink">http://www.example.com/</a></strong></em:homepageURL> + </Description> +</RDF> +</pre> + <ul> + <li><strong><a class="link-mailto" href="mailto:sample@example.net" rel="external nofollow" title="mailto:sample@example.net">sample@example.net</a></strong> - the ID of the extension. This is a value you come up with to identify your extension in email address format (note that it should not be <em>your</em> email). Make it unique. You could also use a GUID. NOTE: This parameter MUST be in the format of an email address, although it does NOT have to be a valid email address. (example.example.example)</li> + <li><strong>4</strong> - the type of the add-on. '4' declares that it is installing a theme. If you were to install an extension it would be 2 (see <a href="/Add-ons/Install_Manifests#type" rel="internal">Install Manifests#type</a> for other type codes).</li> + <li><strong>{ec8030f7-c20a-464f-9b0e-13a3a9e97384}</strong> - Firefox's application ID.</li> + <li><strong>29.0</strong> - the exact version number of the earliest version of Firefox you're saying this extension will work with. Never use a * in a minVersion, it almost certainly will not do what you expect it to.</li> + <li><strong>32.*</strong> - the maximum version of Firefox you're saying this extension will work with. Set this to be no newer than the newest currently available version! In this case, "32.*" indicates that the extension works with Firefox 32 and any subsequent 32.x release. Themes are compatible by default, unless you set strict compatibility mode for your theme.</li> + </ul> + <p>If you get a message that the install.rdf is malformed, it is helpful to load it into firefox using the File->Open File command and it will report XML errors to you.</p> + <p>See <a href="/Add-ons/Install_Manifests" rel="internal">Install Manifests</a> for a complete listing of the required and optional properties.</p> + <p>Save the file.</p> +</div> +<div id="section_4"> + <h4 class="editable" id="Styling_the_Browser's_UI_with_CSS">Styling the Browser's UI with CSS</h4> + <p>Firefox's user interface is written in XUL and JavaScript. <a href="/docs/Mozilla/Tech/XUL" rel="internal">XUL</a> is an XML grammar that provides user interface widgets like buttons, menus, toolbars, trees, etc. User actions are bound to functionality using JavaScript. These XUL elements are styled using <a class="internal" href="/en/CSS" title="en/CSS">CSS</a>. If you don't know CSS, it's going to be a steep learning curve, and you may want to try some HTML-based tutorials to start with.</p> + <p>The browser UI has absolutely no styling on its own - if you try to start up with an empty theme, Firefox will be unusable, as the button elements will be drawn as plain text. This is why we copied the default styles in the setup step.</p> + <p>When writing a theme, the easiest way to determine what CSS selectors you need to write is to use the DOM Inspector which you should have installed in the setup step. You can use this to inspect any element in a web page or an XUL document, which makes it invaluable for themes.</p> + <h4 class="editable" id="Updating_the_toolbar's_Styling">Updating the toolbar's Styling</h4> + <div class="note"> + <p><strong>Note</strong> In Firefox 4.0 and up, the highlight feature of DOM Inspector is broken. To workaround this, disable Hardware Acceleration in Firefox' Options.</p> + </div> + <p>Open up the DOM Inspector now (located under the "Tools" menu), and go to "File->Inspect Chrome Document". This will be a menu containing all the XUL documents currently open in Firefox.<br> + Pick the first document with a web page title, like "Firefox Start Page" and select it.</p> + <p>For this tutorial, we're going to update the background color of the toolbars. Select the node finding tool (the arrow-plus-box in the top-left corner of the DOM Inspector), and click on any unused space on a toolbar. This should select a node of type "xul:toolbar" in the DOM Inspector.</p> + <p>From here, you can play around with various different stylings for the toolbar and associated elements. By default, the right pane should show the DOM node, which has useful styling information like the CSS class and node id. The element itself is of id <code>navigator-toolbox</code>, with no idea. To change its style within our theme, we need to write a selector rule to select this class.</p> + <p>Open up the file <code>chrome/browser/browser.css</code> in your theme. Search this file for the <code>#navigator-toolbox</code> selector, and add a<code> background: orange; </code>rule to it.</p> + <p>Save the file.</p> +</div> +<div id="section_6"> + <h4 class="editable" id="Chrome_URIs"><span>Chrome URIs</span></h4> + <p>Next, we have to tell Firefox where to find the theme files for your theme. CSS, XUL, and other files are part of "<a href="/docs/Chrome_Registration" rel="internal">Chrome Packages</a>" - bundles of user interface components which are loaded via <code><a class="external" rel="external nofollow" title="chrome://">chrome://</a></code> URIs. Rather than load the browser from disk using a <code><a class="external" rel="external nofollow" title="file://">file://</a></code> URI (since the location of Firefox on the system can change from platform to platform and system to system), Mozilla developers came up with a solution for creating URIs to content that the installed add-on knows about.</p> + <p>The browser window is: <code><a class="external" rel="external nofollow" title="chrome://browser/content/browser.xul">chrome://browser/content/browser.xul</a></code>. Try typing this URL into the location bar in Firefox!</p> + <p>Chrome URIs consist of several components:</p> + <ul> + <li>Firstly, the <strong>URI scheme</strong> (<code>chrome</code>) which tells Firefox's networking library that this is a Chrome URI. It indicates that the content of the URI should be handled as a (<code>chrome</code>). Compare (<code>chrome</code>) to (<code>http</code>) which tells Firefox to treat the URI as a web page.</li> + <li>Secondly, a package name (in the example above, <code><strong>browser</strong></code>) which identifies the bundle of user interface components.</li> + <li>Thirdly, the type of data being requested. There are three types: <code>content</code> (XUL, JavaScript, XBL bindings, etc. that form the structure and behavior of an application UI), <code>locale</code> (DTD, .properties files etc that contain strings for the UI's <a href="/docs/Glossary/Localization" rel="internal">localization</a>), and <code>skin</code> (CSS and images that form the <a href="/Add-ons/Themes" rel="internal">theme</a> of the UI)</li> + <li>Finally, the path of a file to load.</li> + </ul> + <p>So, <code><a class="external" rel="external nofollow" title="chrome://foo/skin/bar.png">chrome://foo/skin/bar.png</a></code> loads the file <code>bar.png</code> from the <code>foo</code> theme's <code>skin</code> section.</p> + <p>When you load content using a Chrome URI, Firefox uses the Chrome Registry to translate these URIs into the actual source files on disk (or in JAR packages).</p> +</div> +<div id="section_7"> + <h4 class="editable" id="Create_a_Chrome_Manifest"><span>Create a Chrome Manifest</span></h4> + <p>The Chrome Manifest is the file that maps these Chrome URIs to your theme's files. For more information on Chrome Manifests and the properties they support, see the <a href="/docs/Chrome_Registration" rel="internal">Chrome Manifest</a> Reference.</p> + <p>Open the file called <strong>chrome.manifest</strong> that you created alongside the <code>chrome</code> directory at the root of your extension's source folder hierarchy.</p> + <p>Add in this code:</p> + <pre class="eval">skin browser sample chrome/browser/ +skin communicator sample chrome/communicator/ +skin global sample chrome/global/ +skin mozapps sample chrome/mozapps/ +</pre> + <p><strong>Don't forget the</strong><strong> trailing slash, "<code>/</code>"!</strong> Without it, the package won't be registered. The third column needs to match your theme's <strong>internalName</strong> value from the install manifest above.</p> + <p>This maps skin directories to locations within your theme. For example, the line <code>skin browser sample skin/browser/</code> means "when the user has the <code>sample</code> theme selected, use the directory <code>browser/</code> to look up skins for the <code>browser</code> package." More concisely, this means that the URL <a class="external" title="chrome://browser/skin/some/path/file.css">chrome://browser/skin/some/path/file.css</a> will look for a file <code>browser/some/path/file.css</code> in your theme's root directory.</p> + <p>Save the file.</p> +</div> +<div id="section_9"> + <h4 class="editable" id="Test"><span>Test</span></h4> + <p>First, we need to tell Firefox about your theme. During the development phase for Firefox versions 2.0 and higher, you can point Firefox to the folder where you are developing the theme, and it'll load it up every time you restart Firefox.</p> + <ol> + <li>Locate your <a class="external" href="http://kb.mozillazine.org/Profile_folder" rel="external nofollow" title="http://kb.mozillazine.org/Profile_folder">profile folder</a> and beneath it the profile you want to work with (e.g. <code>Firefox/Profiles/<profile_id>.default/</code>).</li> + <li>Open the <code>extensions/</code> folder, creating it if need be.</li> + <li>Create a new text file and put the full path to your development folder inside (e.g. <code>C:\themes\my_theme\</code> or <code>~/themes/my_theme/)</code>. Windows users should retain the OS' slash direction, and <em>everyone</em> should remember to <strong>include</strong> a closing slash and <strong>remove</strong> any trailing spaces.</li> + <li>Save the file with the id of your theme as its name (e.g. <code><a class="link-mailto" href="mailto:sample@example.net" rel="external nofollow" title="mailto:sample@example.net">sample@example.net</a></code>). No file extension.</li> + </ol> + <p>Now you should be ready to test your theme!</p> + <p>Start Firefox. Firefox will detect the text link to your theme directory and install the theme. Your theme will not be active the first time you install, and you will need to click "Enable" and restart before you can see your change. After it restarts this second time, you should see the background color of the toolbars is displayed in orange now.</p> + <p>You can now go back and make additional changes to your css files, close and restart Firefox, and see the updates.</p> +</div> +<div id="section_10"> + <h4 class="editable" id="Package"><span>Package</span></h4> + <p>Now that your theme works, you can <a href="/Add-ons/Extension_Packaging" rel="internal">package</a> it for deployment and installation.</p> + <p>Zip up the <strong>contents</strong> of your theme's folder (not the theme folder itself), and rename the zip file to have a .xpi extension. In Windows, you can do this easily by selecting all the files and subfolders in your extension folder, right click and choose "Send To -> Compressed (Zipped) Folder". A .zip file will be created for you. Just rename it and you're done!</p> + <p>On Mac OS or Linux, you can use the command-line zip tool:</p> + <pre class="eval">zip -r my_theme.xpi install.rdf chrome.manifest browser communicator global mozapps +</pre> + <p>Or, if you have 7-Zip installed, you can use that for zipping it up:</p> + <pre class="eval">7z a -tzip my_theme.xpi chrome chrome.manifest +</pre> + <p><strong>Note:</strong> The command-line tool will <strong>update</strong> an existing zip file, not replace it - so if you have files you've deleted from your theme, be sure to remove the <code>.xpi </code>file before running the zip command again.</p> + <p>Now upload the .xpi file to your server, making sure it's served as <code>application/x-xpinstall</code>. You can link to it and allow people to download and install it. For the purposes of just testing our .xpi file we can just drag it into the Add-ons Manager via "Tools -> Add-ons Manager", or open it using "File -> Open File...".</p> + <div id="section_11"> + <h5 class="editable" id="Installing_from_a_web_page"><span>Installing from a web page</span></h5> + <p>There are a variety of ways you can install extensions from web pages, including direct linking to the XPI files and using the InstallTrigger object. Extension and web authors are encouraged to use the <a href="/docs/Installing_Extensions_and_Themes_From_Web_Pages" rel="internal"> InstallTrigger method</a> to install XPIs, as it provides the best experience to users.</p> + </div> + <div id="section_12"> + <h5 class="editable" id="Using_addons.mozilla.org"><span>Using addons.mozilla.org</span></h5> + <p>Mozilla Add-ons is a distribution site where you can host your theme for free. Your theme will be hosted on Mozilla's mirror network to guarantee your download even though it might be very popular. Mozilla's site also provides users easier installation, and will automatically make your newer versions available to users of your existing versions when you upload them. In addition, Mozilla Add-ons allows users to comment and provide feedback on your theme. It is highly recommended that you use Mozilla Add-ons to distribute your themes!</p> + <p>Visit <a class="external" href="https://addons.mozilla.org/developers/" rel="external nofollow" title="http://addons.mozilla.org/developers/">https://addons.mozilla.org/developers/</a> to create an account and begin distributing your themes!</p> + <p><em>Note:</em> Your theme will be passed faster and downloaded more if you have a good description and some screenshots of the theme in action.</p> + </div> +</div> +<div id="section_21"> + <div id="section_23"> + <ul> + <li><a class="internal" href="/Add-ons/Themes" title="en/Themes">Themes</a></li> + </ul> + <p>______________________________</p> + </div> +</div> +<p> </p> diff --git a/files/ar/games/index.html b/files/ar/games/index.html new file mode 100644 index 0000000000..8bf9ec3ff9 --- /dev/null +++ b/files/ar/games/index.html @@ -0,0 +1,98 @@ +--- +title: Games development +slug: Games +tags: + - Apps + - Game Development + - Gamedev + - Games + - HTML5 Games + - JavaScript Games + - NeedsTranslation + - TopicStub + - Web +translation_of: Games +--- +<div>{{GamesSidebar}}</div> + +<div class="summary"> +<p dir="rtl"><span class="seoSummary">الألعاب هي واحدة من أكثر أنشطة الكمبيوتر شعبية.تصل التقنيات الحديثة باستمرار لتتمكن من تطوير ألعاب أفضل وأكثر قوة حيث يمكن تشغيلها في أي متصفح ويب متوافق مع المعايير.</span></p> +</div> + +<div>{{EmbedGHLiveSample("web-tech-games/index.html", '100%', 820)}}</div> + +<div class="column-container"> +<div class="column-half"> +<h2 dir="rtl" id="تطوير_ألعاب_الويب">تطوير ألعاب الويب</h2> + +<p dir="rtl"></p> + +<p dir="rtl">مرحبًا بك في مركز تطوير ألعاب MDN! في هذا المجال من الموقع ، نوفر موارد لمطوري الويب الراغبين في تطوير الألعاب. ستجد العديد من البرامج التعليمية والمقالات المفيدة في القائمة الرئيسية على اليسار ، لذلك لا تتردد في الاستكشاف.</p> + +<p dir="rtl">لقد قمنا أيضًا بتضمين قسم مرجعي حتى تتمكن من العثور بسهولة على معلومات حول جميع واجهات برمجة التطبيقات الأكثر شيوعًا المستخدمة في تطوير اللعبة.</p> + +<p dir="rtl"></p> + + + +<div class="note" dir="rtl">ملاحظة: يعتمد إنشاء الألعاب على الويب على عدد من تقنيات الويب الأساسية مثل HTML و CSS و JavaScript. تعتبر <a href="https://developer.mozilla.org/en-US/docs/Learn">منطقة التعلم</a> مكانًا جيدًا للبدء في الأساسيات.</div> +</div> + +<div class="column-half"> +<h2 id="Port_native_games_to_the_Web">Port native games to the Web</h2> + +<p>If you are a native developer (for example writing games in C++), and you are interested in how you can port your games over to the Web, you should learn more about our <a href="http://kripken.github.io/emscripten-site/index.html">Emscripten</a> tool — this is an LLVM to JavaScript compiler, which takes LLVM bytecode (e.g. generated from C/C++ using Clang, or from another language) and compiles that into <a href="/en-US/docs/Games/Tools/asm.js">asm.js</a>, which can be run on the Web.</p> + +<p>To get started, see:</p> + +<ul> + <li><a href="http://kripken.github.io/emscripten-site/docs/introducing_emscripten/about_emscripten.html">About Emscripten</a> for an introduction including high-level details.</li> + <li><a href="http://kripken.github.io/emscripten-site/docs/getting_started/downloads.html">Download and Install</a> for installing the toolchain.</li> + <li><a href="http://kripken.github.io/emscripten-site/docs/getting_started/Tutorial.html">Emscripten Tutorial</a> for a tutorial to teach you how to get started.</li> +</ul> +</div> +</div> + +<div class="column-container"> +<div class="column-half"> +<h2 dir="rtl" id="أمثلة">أمثلة</h2> + +<p dir="rtl">للحصول على قائمة من أمثلة ألعاب الويب. انظر <a href="https://developer.mozilla.org/en-US/docs/Games/Examples">صفحة الأمثلة</a> لدينا. أيضا تحقق من <a href="https://games.mozilla.org/">games.mozilla.org</a> لمزيد من الموارد المفيدة!</p> +</div> +</div> + +<h2 id="See_also">See also</h2> + +<div class="column-container"> +<div class="column-half"> +<dl> + <dt><a href="http://buildnewgames.com/">Build New Games</a></dt> + <dd>A collaborative site featuring a large number of open web game development tutorials. Has not been very active recently, but still holds some nice resources.</dd> + <dt><a href="http://creativejs.com/">Creative JS</a></dt> + <dd>A collection of impressive JavaScript techniques and experiments, not specific to games, but helpful nonetheless. Has not been very active recently, but still holds some nice resources.</dd> + <dt><a href="http://gameprogrammingpatterns.com/">Game programming patterns</a></dt> + <dd>An online book, written by Bob Nystrom, which discusses programming patterns in the context of game development with the aim of helping game developers produce more effective and efficient code.</dd> + <dt><a href="http://gamedevjsweekly.com/">Gamedev.js Weekly</a></dt> + <dd>Weekly newsletter about HTML5 game development, sent every Friday. Contains the latest articles, tutorials, tools and resources.</dd> + <dt><a href="http://www.html5gamedevs.com/">HTML5 Game Devs Forum</a></dt> + <dd>Forums for developers, framework creators and publishers. Ask questions, get feedback and help others.</dd> +</dl> +</div> + +<div class="column-half"> +<dl> + <dt><a href="http://html5gameengine.com/">HTML5 Game Engine</a></dt> + <dd>List of the most popular HTML5 game frameworks along with their rating, features and samples.</dd> + <dt><a href="http://www.jsbreakouts.org/">JSBreakouts</a></dt> + <dd>Compare JavaScript Breakout clones in different frameworks to help you choose the right one for you.</dd> + <dt><a href="http://gamedevelopment.tutsplus.com/">Tuts+ Game Development</a></dt> + <dd>Tutorials and articles about game development in general.</dd> + <dt><a href="http://html5devstarter.enclavegames.com/">HTML5 Gamedev Starter</a></dt> + <dd>Starter for the new game developers, a curated list of links to various, useful resources around the web.</dd> + <dt><a href="http://js13kgames.com/">js13kGames</a></dt> + <dd>JavaScript coding competition for HTML5 game developers with the file size limit set to 13 kilobytes. All the submitted games are available in a readable form on GitHub.</dd> + <dt><a href="https://hacks.mozilla.org/category/games/">Mozilla Hacks blog</a></dt> + <dd>Games category on the Mozilla Hacks blog containing interesting gamedev related articles.</dd> +</dl> +</div> +</div> diff --git a/files/ar/games/techniques/3d_on_the_web/basic_theory/index.html b/files/ar/games/techniques/3d_on_the_web/basic_theory/index.html new file mode 100644 index 0000000000..502a63c9f9 --- /dev/null +++ b/files/ar/games/techniques/3d_on_the_web/basic_theory/index.html @@ -0,0 +1,126 @@ +--- +title: شرح نظرية ثلاثية الابعاد الأساسية +slug: Games/Techniques/3D_on_the_web/Basic_theory +translation_of: Games/Techniques/3D_on_the_web/Basic_theory +--- +<div dir="rtl">{{GamesSidebar}}</div> + +<p dir="rtl">This article explains all of the basic theory that's useful to know when you are getting started working with 3D.</p> + +<h2 dir="rtl" id="نظام_الاحداثيات_الديكارتي"><a name="_Toc522014861">نظام الاحداثيات الديكارتي</a></h2> + +<p dir="rtl">ثلاثي الابعاد بشكل أساسي هو عبارة عن تمثيل للأشكال في مساحة ثلاثية الابعاد مع نظام احداثي يستخدم لحساب موضع الاشكال.</p> + +<p dir="rtl">يستخدم <span dir="LTR">WebGL</span> نظام الاحداثيات الديكارتي حيث يشير <span dir="LTR">x</span> الى محور السينات (اليمين) ويشير <span dir="LTR">y</span> الى محور الصادات (للأعلى) ويشير <span dir="LTR">z</span> الى محور الزينات (خارج الشاشة) كما هو موضح بالشكل التالي:<img alt="Coordinate system" src="https://mdn.mozillademos.org/files/13326/mdn-games-3d-coordinate-system.png" style="height: 338px; width: 600px;"></p> + +<h2 dir="rtl" id="الكائنات"><a name="_Toc522014862">الكائنات </a></h2> + +<p dir="rtl">تسمى النقطة التي تمثل الكائن في الفضاء بـِ الرأس <span dir="LTR">vertices</span> والتي تمثل موقع الكائن. كل نقطة لها عدة سمات وهي:</p> + +<ol dir="rtl"> + <li>الموقع: يحدد من خلال نقطة ثلاثية الابعاد <span dir="LTR">x y z</span>.</li> + <li>اللون: يحمل قيمة مكونة من أربعة خانات وهي: قيمة اللون الأحمر وقيمة اللون الأخضر وقيمة اللون الأزرق وقيمة الشفافية التي تتراوح ما بين 0.0 و1.0.</li> + <li>الاتجاه.</li> + <li>البنية <span dir="LTR">texture</span>: وهي عبارة عن صورة ثنائية الابعاد تستخدم لتعبئة أحد السطوح بدلا من اللون.</li> +</ol> + +<p dir="rtl"> </p> + +<p dir="rtl"><img alt="Cube" src="https://mdn.mozillademos.org/files/13324/mdn-games-3d-cube.png" style="height: 265px; width: 600px;"></p> + +<p dir="rtl"> </p> + +<p dir="RTL">فمثلا: الكائن أعلاه (مكعب) يحتوي على 8 رؤوس مختلفة في الفضاء <span dir="LTR">v<sub>0</sub>,v<sub>1</sub>,v<sub>2</sub>,v<sub>3</sub>,v<sub>4</sub>,v<sub>5</sub>,v<sub>6</sub>,v<sub>7</sub></span> وعلى 6 سطوح (أوجه) كل منها مكون من 4 نقاط.</p> + +<ul dir="rtl"> + <li>عندما نقوم بتوصيل النقاط فإننا نقوم على انشاء حواف <span dir="LTR">edge</span> المكعب.</li> + <li>الهندسة <span dir="LTR">geometry</span> تبنى من خلال الرؤوس <span dir="LTR">vertices</span> والسطوح <span dir="LTR">faces</span> بينما المادة <span dir="LTR">materials</span> تتمثل في البنية <span dir="LTR">texture</span> والتي تكون اما لون أو صورة.</li> + <li>عندما نقوم بتوصيل الهندسة بالمادة فإننا نحصل على الشبكة <span dir="LTR">mesh</span>.</li> +</ul> + +<p dir="rtl"> </p> + +<h2 dir="rtl" id="Rendering_pipeline">Rendering pipeline</h2> + +<p dir="rtl">يتم معالجة الجرافيك من خلال أخذ الكائنات ثلاثية الابعاد والتي يتم انشاءها من العناصر الأولية (نقطة، مثلث، خط) باستخدام الرؤوس ومن ثم حساب الأجزاء <span dir="LTR">fragments</span> وعرضها على الشاشة (ثنائية الابعاد) بوحدة البيكسل <span dir="LTR">pixel</span>.</p> + +<p dir="rtl"><img alt="Rendering pipeline" src="https://mdn.mozillademos.org/files/13334/mdn-games-3d-rendering-pipeline.png" style="height: 225px; width: 600px;"></p> + +<p dir="rtl"> </p> + +<p dir="RTL">المصطلحات المستخدمة في الرسمة أعلاه هي كالتالي:</p> + +<ol dir="rtl"> + <li>العنصر البدائي <span dir="LTR">primitive</span>: والذي يتكون من الرؤوس والتي تكون اما مثلث أو نقطة أو خط.</li> + <li>الجزء <span dir="LTR">fragment</span>: وهو اسقاط ثلاثي الابعاد لبيكسل والذي يحمل نفس السمات المميزة لكل بيكسل.</li> + <li>البيكسل <span dir="LTR">pixel</span>: نقطة على الشاشة ثنائية الابعاد والتي تحمل قيمة لون <span dir="LTR">RGBA</span>.</li> +</ol> + +<p dir="rtl"> </p> + +<h2 dir="rtl" id="معالجة_الرؤوس">معالجة الرؤوس</h2> + +<p dir="rtl">يتم معالجة الرؤوس من خلال جمع المعلومات حول كل رأس على حدا في العنصر البدائي وتعيين احداثياتها في المساحة ثلاثية الابعاد للمشاهد ليراها. وتشبه المعالجة طريقة أخذ صورة لمشهد أنت قمت باعداه (وضع الأشياء بمكانها المناسب ومن ثم تهيئة الكمرة ومن ثم أخذ الصورة).<img alt="Vertex processing" src="https://mdn.mozillademos.org/files/13336/mdn-games-3d-vertex-processing.png" style="height: 338px; width: 600px;"></p> + +<p dir="rtl"> </p> + +<p dir="RTL">هناك أربع مراحل لهذه العملية:</p> + +<ol dir="rtl"> + <li>ترتيب المكونات <span dir="LTR">objects</span> والتي تسمى تحويل النموذج <span dir="LTR">modal transformation</span>.</li> + <li><span dir="RTL">تحويل العرض </span>view transformation<span dir="RTL"> والذي يعتني بالموضع وتحديد اتجاه الكمرة في الفضاء ثلاثي الابعاد حيث يتم ضبط الكمرة من خلال ثلاثة متغيرات وهي الموقع والاتجاه والتوجيه.</span><br> + </li> +</ol> + +<p dir="rtl"><img alt="Camera" src="https://mdn.mozillademos.org/files/13322/mdn-games-3d-camera.png" style="height: 225px; width: 600px;"></p> + +<ol dir="rtl" start="3"> + <li>تحويل الاسقاط projection transformation والذي يدعى أيضا تحويل المنظور perspective transformation حيث يعتني بإعداد ما يمكن رؤيته بواسطة الكمرة من خلال اعداد مجال الرؤية ونسبة العرض الى الارتفاع aspect ratio والقرب والبعد.</li> +</ol> + +<p dir="rtl"><img alt="Camera settings" src="https://mdn.mozillademos.org/files/13320/mdn-games-3d-camera-settings.png" style="height: 338px; width: 600px;"></p> + +<p dir="rtl"> </p> + +<ol dir="rtl" start="4"> + <li> تحويل إطار العرض <span dir="LTR">viewport transformation</span> والذي يهتم بكل المخرجات في طريقة عرض الجرافيك على الشاشة.</li> +</ol> + +<p dir="rtl"> </p> + +<p dir="rtl"> </p> + +<h2 dir="rtl" id="المسح_المجالي">المسح المجالي</h2> + +<p dir="rtl">يتم بالمسح المجالي تحويل الاشكال الأولية الناتجة عن توصيل الرؤوس الى مجموعة من الأجزاء fragments (اسقاطات ثلاثية الابعاد للبيكسلات ثنائية الابعاد) حيث يتم محاذاتها مع شبكة البيكسل.<img alt="Rasterization" src="https://mdn.mozillademos.org/files/13332/mdn-games-3d-rasterization.png" style="height: 338px; width: 600px;"></p> + +<p dir="rtl"> </p> + +<h2 dir="rtl" id="معالجة_الجزء">معالجة الجزء</h2> + +<p dir="rtl">ترتكز معالجة الأجزاء على البنية <span dir="LTR">texture</span> والإضاءة حيث تقوم بحساب الألوان النهائية استنادًا إلى المعلمات المحددة.</p> + +<p dir="rtl"><img alt="Fragment processing" src="https://mdn.mozillademos.org/files/13328/mdn-games-3d-fragment-processing.png" style="height: 338px; width: 600px;"></p> + +<h3 dir="rtl" id="الإضاءة">الإضاءة</h3> + +<p dir="rtl">الألوان التي نراها على الشاشة هي نتيجة تفاعل مصدر ضوء مع ألوان سطح مادة الكائن. الضوء قد يمتص أو قد ينعكس تبعا لذلك.</p> + +<p dir="rtl"> </p> + +<p dir="RTL">هناك أربع أنواع أساسية من الإضاءة:</p> + +<ul dir="rtl"> + <li dir="RTL">ضوء اتجاهي <span dir="LTR">Diffuse</span> بعيد مثل الشمس.</li> + <li dir="RTL">نقطة ضوئية <span dir="LTR">Specular</span> مثل مصباح الإضاءة في الغرفة.</li> + <li dir="RTL">ضوء محيطي <span dir="LTR">Ambient</span> وهو ضوء ثابت ينعكس على كل شيء.</li> + <li dir="RTL">ضوء اشعاعي <span dir="LTR">Emissive</span> وهو الضوء المنبعث مباشرة من الكائن.</li> +</ul> + +<h2 dir="rtl" id="مخرجات_الدمج">مخرجات الدمج</h2> + +<p dir="rtl">أثناء مرحلة معالجة المخرجات يتم تحويل جميع أجزاء الأوليات من الفضاء ثلاثي الابعاد الى شبكة ثنائية الابعاد من البيكسلات ثم تطبع على الشاشة. أيضا يتم تطبيق بعض المعالجات من أجل تجاهل بعض المعلومات الغير مطلوبة مثل الكائنات الغير مرئية أو الأجزاء خارج الشاشة أو الكائنات التي تقع خلف كائنات أخرى.</p> + +<p dir="rtl"><img alt="Output merging" src="https://mdn.mozillademos.org/files/13330/mdn-games-3d-output-merging.png" style="height: 338px; width: 600px;"></p> + +<p dir="rtl"> </p> diff --git a/files/ar/games/techniques/3d_on_the_web/index.html b/files/ar/games/techniques/3d_on_the_web/index.html new file mode 100644 index 0000000000..3944c617c6 --- /dev/null +++ b/files/ar/games/techniques/3d_on_the_web/index.html @@ -0,0 +1,113 @@ +--- +title: 3D games on the Web +slug: Games/Techniques/3D_on_the_web +tags: + - Games + - Graphics + - NeedsContent + - NeedsExample + - NeedsTranslation + - TopicStub + - WebGL + - WebVR + - three.js +translation_of: Games/Techniques/3D_on_the_web +--- +<div>{{GamesSidebar}}</div><p class="summary">For rich gaming experiences on the Web the weapon of choice is WebGL, which is rendered on HTML {{htmlelement("canvas")}}. WebGL is basically an OpenGL ES 2.0 for the Web — it's a JavaScript API providing tools to build rich interactive animations and of course also games. You can generate and render dynamic 3D graphics with JavaScript that is hardware accelerated.</p> + +<h2 id="Documentation_and_browser_support">Documentation and browser support</h2> + +<p>The <a href="/en-US/docs/Web/API/WebGL_API">WebGL</a> project documentation and specification is maintained by the <a href="https://www.khronos.org/">Khronos Group</a>, not the W3C as with most of the Web APIs. Support on modern browsers is very good, even on mobile, so you don't have to worry about that too much. The main browsers are all supporting WebGL and all you need to focus on is optimizing the performance on the devices you use.</p> + +<p>There's an ongoing effort on releasing WebGL 2.0 (based on OpenGL ES 3.0) in the near future, which will bring many improvements and will help developers build games for the modern Web using current, powerful hardware.</p> + +<h2 id="Explaining_basic_3D_theory">Explaining basic 3D theory</h2> + +<p>The basics of 3D theory centers around shapes represented in a 3D space, with a coordinate system being used to calculate their positions. See our <a href="https://developer.mozilla.org/en-US/docs/Games/Techniques/3D_on_the_web/Basic_theory">Explaining basic 3D theory</a> article for all the information you need.</p> + +<h2 id="Advanced_concepts">Advanced concepts</h2> + +<p>You can do a lot more with WebGL. There are some advanced concepts which you should dive into and learn more about — like shaders, collision detection, or the latest hot topic — virtual reality on the web.</p> + +<h3 id="Shaders">Shaders</h3> + +<p>It's worth mentioning shaders, which are a separate story on their own. Shaders use GLSL, a special OpenGL Shading Language with syntax similar to C that is executed directly by the graphics pipeline. They can be split into Vertex Shaders and Fragment Shaders (or Pixel Shaders) — the former transforms shape positions to real 3D drawing coordinates, while the latter computes rendering colors and other attributes. You should definitely check out <a href="/en-US/docs/Games/Techniques/3D_on_the_web/GLSL_Shaders">GLSL Shaders</a> article to learn more about them.</p> + +<h3 id="Collision_Detection">Collision Detection</h3> + +<p>It's hard to imagine a game without the collision detection — we always need to work out when something is hitting something else. We have information available for your to learn from:</p> + +<ul> + <li><a href="/en-US/docs/Games/Techniques/2D_collision_detection">2D collision detection</a></li> + <li><a href="/en-US/docs/Games/Techniques/3D_collision_detection">3D collision detection</a></li> +</ul> + +<h3 id="WebVR">WebVR</h3> + +<p>The concept of virtual reality is not new, but it's storming onto the web thanks to hardware advancements such as the <a href="https://www.oculus.com/en-us/rift/">Oculus Rift</a>, and the (currently experimental) <a href="/en-US/docs/Web/API/WebVR_API">WebVR API</a> for capturing information form VR hardware and making it available for use in JavaScript applications. For more, read <a href="/en-US/docs/Games/Techniques/3D_on_the_web/WebVR">WebVR — Virtual Reality for the Web</a>.</p> + +<p>There's also the <a href="/en-US/docs/Games/Techniques/3D_on_the_web/Building_up_a_basic_demo_with_A-Frame">Building up a basic demo with A-Frame</a> article showing you how easy it is to build 3D environments for virtual reality using the <a href="http://aframe.io/">A-Frame</a> framework.</p> + +<h2 id="The_rise_of_libraries_and_frameworks">The rise of libraries and frameworks</h2> + +<p>Coding raw WebGL is fairly complex, but you'll want to get to grips with it in the long run, as your projects get more advanced (see our <a href="/en-US/docs/Web/API/WebGL_API">WebGL documentation</a> to get started.) For real world projects you'll probably also make use of a framework to speed up development and help you manage the project you're working on. Using a framework for 3D games also helps optimize the performance as a lot is taken care of by the tools you use, so you can focus on building the game itself.</p> + +<p>The most popular JavaScript 3D library is <a href="http://threejs.org/">Three.js</a>, a multi-purpose tool that makes common 3D techniques simpler to implement. There are other popular game development libraries and frameworks worth checking too; <a href="https://aframe.io">A-Frame</a>, <a href="https://playcanvas.com/">PlayCanvas</a> and <a href="http://www.babylonjs.com/">Babylon.js</a> are among the most recognizable ones with rich documentation, online editors and active communities.</p> + +<h3 id="Building_up_a_basic_demo_with_A-Frame">Building up a basic demo with A-Frame</h3> + +<p>A-Frame is a web framework for building 3D and VR experiences. Under the hood, it is a three.js framework with a declarative entity-component pattern, meaning we can build scenes with just HTML. See the <a href="/en-US/docs/Games/Techniques/3D_on_the_web/Building_up_a_basic_demo_with_A-Frame">Building up a basic demo with A-Frame</a> subpage for the step-by-step process of creating the demo.</p> + +<h3 id="Building_up_a_basic_demo_with_Babylon.js">Building up a basic demo with Babylon.js</h3> + +<p><span class="seosummary">Babylon.js is one of the most popular 3D game engines used by developers. As with any other 3D library it provides built-in functions to help you implement common 3D functionality more quickly. See the <a href="/en-US/docs/Games/Techniques/3D_on_the_web/Building_up_a_basic_demo_with_Babylon.js">Building up a basic demo with Babylon.js</a> subpage for the basics of using Babylon.js, including setting up a development environment, structuring the necessary HTML, and writing the JavaScript code.</span></p> + +<h3 id="Building_up_a_basic_demo_with_PlayCanvas">Building up a basic demo with PlayCanvas</h3> + +<p>PlayCanvas is a popular 3D WebGL game engine open sourced on GitHub, with an editor available online and good documentation. See the <a href="/en-US/docs/Games/Techniques/3D_on_the_web/Building_up_a_basic_demo_with_PlayCanvas">Building up a basic demo with PlayCanvas</a> subpage for high level details, and further articles showing how to create demos using the PlayCanvas library, and the online editor.</p> + +<h3 id="Building_up_a_basic_demo_with_Three.js">Building up a basic demo with Three.js</h3> + +<p>Three.js, as any other library, gives you a huge advantage: instead of writing hundreds of lines of WebGL code to build anything interesting you can use built-in helper functions to do it a lot easier and faster. See the <a href="https://developer.mozilla.org/en-US/docs/Games/Techniques/3D_on_the_web/Building_up_a_basic_demo_with_Three.js">Building up a basic demo with Three.js</a> subpage for the step-by-step process of creating the demo.</p> + +<h3 id="Other_tools">Other tools</h3> + +<p>Both <a href="http://unity3d.com/">Unity</a> and <a href="https://www.unrealengine.com/">Unreal</a> can export your game to <a href="/en-US/docs/Web/API/WebGL_API">WebGL</a> with <a href="/en-US/docs/Games/Tools/asm.js">asm.js</a>, so you're free to use their tools and techniques to build games that will be exported to the web.</p> + +<p><img alt="" src="http://end3r.github.io/MDN-Games-3D/A-Frame/img/shapes.png" style="border-style: solid; border-width: 1px; display: block; margin: 0px auto;"></p> + +<h2 id="Where_to_go_next">Where to go next</h2> + +<p>With this article we just scratched the surface of what's possible with currently available technologies. You can build immersive, beautiful and fast 3D games on the Web using WebGL, and the libraries and frameworks build on top of it.</p> + +<h3 id="Source_code">Source code</h3> + +<p>You can find all the source code for this series <a href="http://end3r.github.io/MDN-Games-3D/">demos on GitHub</a>.</p> + +<h3 id="APIs">APIs</h3> + +<ul> + <li><a href="/en-US/docs/Web/API/Canvas_API">Canvas API</a></li> + <li><a href="/en-US/docs/Web/API/WebGL_API">WebGL API</a></li> + <li><a href="/en-US/docs/Web/API/WebVR_API">WebVR API</a></li> +</ul> + +<h3 id="Frameworks">Frameworks</h3> + +<ul> + <li><a href="http://threejs.org/">Three.js</a></li> + <li><a href="https://github.com/WhitestormJS/whs.js">Whitestorm.js</a> (based on Three.js)</li> + <li><a href="https://playcanvas.com/">PlayCanvas</a></li> + <li><a href="http://www.babylonjs.com/">Babylon.js</a></li> + <li><a href="http://aframe.io/">A-Frame</a></li> +</ul> + +<h3 id="Tutorials">Tutorials</h3> + +<ul> + <li><a href="https://developer.mozilla.org/en-US/docs/Games/Techniques/3D_on_the_web/Building_up_a_basic_demo_with_Three.js">Building up a basic demo with Three.js</a></li> + <li><a href="https://developer.mozilla.org/en-US/docs/Games/Techniques/3D_on_the_web/Building_up_a_basic_demo_with_Whitestorm.js">Building up a basic demo with Whitestorm.js</a></li> + <li><a href="/en-US/docs/Games/Techniques/3D_on_the_web/Building_up_a_basic_demo_with_PlayCanvas">Building up a basic demo with PlayCanvas</a></li> + <li><a href="/en-US/docs/Games/Techniques/3D_on_the_web/Building_up_a_basic_demo_with_Babylon.js">Building up a basic demo with Babylon.js</a></li> + <li><a href="/en-US/docs/Games/Techniques/3D_on_the_web/Building_up_a_basic_demo_with_A-Frame">Building up a basic demo with A-Frame</a></li> +</ul> diff --git a/files/ar/games/techniques/index.html b/files/ar/games/techniques/index.html new file mode 100644 index 0000000000..66edeebd82 --- /dev/null +++ b/files/ar/games/techniques/index.html @@ -0,0 +1,32 @@ +--- +title: Techniques for game development +slug: Games/Techniques +tags: + - Games + - Guide + - NeedsTranslation + - TopicStub +translation_of: Games/Techniques +--- +<div>{{GamesSidebar}}</div><div>{{IncludeSubnav("/en-US/docs/Games")}}</div> + +<div class="summary"> +<p><span class="seoSummary">This page lists essential core techniques for anyone wanting to develop games using open web technologies.</span></p> +</div> + +<dl> + <dt><a href="/en-US/docs/Games/Techniques/Async_scripts">Using async scripts for asm.js</a></dt> + <dd>Especially when creating medium to large-sized games, async scripts are an essential technique to take advantage of, so that your game's JavaScript can be compiled off the main thread and be cached for future game running, resulting in a significant performance improvement for your users. This article explains how.</dd> + <dt><a href="/en-US/docs/Apps/Developing/Optimizing_startup_performance" title="/en-US/docs/Apps/Developing/Optimizing_startup_performance">Optimizing startup performance</a></dt> + <dd>How to make sure your game starts up quickly, smoothly, and without appearing to lock up the user's browser or device.</dd> + <dt><a href="/en-US/docs/Games/WebRTC_data_channels" title="/en-US/docs/Games/WebRTC_data_channels">Using WebRTC peer-to-peer data channels</a></dt> + <dd>In addition to providing support for audio and video communication, WebRTC lets you set up peer-to-peer data channels to exchange text or binary data actively between your players. This article explains what this can do for you, and shows how to use libraries that make this easy.</dd> + <dt><a href="/en-US/docs/Games/Techniques/Efficient_animation_for_web_games">Efficient animation for web games</a></dt> + <dd>This article covers techniques and advice for creating efficient animation for web games, with a slant towards supporting lower end devices such as mobile phones. We touch on CSS transitions and CSS animations, and JavaScript loops involving {{ domxref("window.requestAnimationFrame") }}.</dd> + <dt><a href="/en-US/docs/Games/Techniques/Audio_for_Web_Games">Audio for Web Games</a></dt> + <dd>Audio is an important part of any game — it adds feedback and atmosphere. Web-based audio is maturing fast, but there are still many browser differences to negotiate. This article provides a detailed guide to implementing audio for web games, looking at what works currently across as wide a range of platforms as possible.</dd> + <dt><a href="/en-US/docs/Games/Techniques/2D_collision_detection">2D collision detection</a></dt> + <dd>A concise introduction to collision detection in 2D games.</dd> + <dt><a href="/en-US/docs/Games/Techniques/Tilemaps">Tilemaps</a></dt> + <dd>Tiles are a very popular technique in 2D games for building the game world. These articles provide an introduction to tilemaps and how to implement them with the Canvas API.</dd> +</dl> diff --git a/files/ar/glossary/accessibility/index.html b/files/ar/glossary/accessibility/index.html new file mode 100644 index 0000000000..38f2f02832 --- /dev/null +++ b/files/ar/glossary/accessibility/index.html @@ -0,0 +1,32 @@ +--- +title: إتاحة +slug: Glossary/Accessibility +tags: + - إتاحة + - مسرد +translation_of: Glossary/Accessibility +--- +<p dir="rtl">تشير <em><a href="https://ar.wikipedia.org/wiki/%D8%A5%D8%AA%D8%A7%D8%AD%D8%A9">الإتاحة</a> الويبيّة</em> (Web Accessibility) إلى أفضل الممارسات المُستخدمة لإبقاء المواقع قابلة للاستخدام بغض النظر عن الإعاقات (أو القيود) الجسديّة والتقنيّة. عُرِفَت ونُقِشَت الإتاحة الويبيّة رسمياً في رابطة الويب العالمية (W3C) خلال {{Glossary("WAI","مبادرة الإتاحة الويبيّة")}} (WAI).</p> + +<h2 dir="rtl" id="المزيد_من_التفاصيل">المزيد من التفاصيل</h2> + +<h3 dir="rtl" id="معلومات_عامة">معلومات عامة</h3> + +<ul dir="rtl"> + <li><a href="/ar/docs/Web/Accessibility">مصادر عن الإتاحة في شبكة مطوري موزيلا</a></li> + <li>مقالة عن <a href="https://ar.wikipedia.org/wiki/%D8%B3%D9%87%D9%88%D9%84%D8%A9_%D8%A7%D9%84%D8%AA%D8%B5%D9%81%D8%AD">سهولة التصفح</a> في الموسوعة الحرَّة</li> +</ul> + +<h3 dir="rtl" id="تعلم_الإتاحة">تعلم الإتاحة</h3> + +<ul dir="rtl"> + <li>موقع "<a href="http://webaim.org/" rel="external">Web Accessibility In Mind</a>"</li> +</ul> + +<h3 dir="rtl" id="مراجع_تقنية">مراجع تقنية</h3> + +<ul dir="rtl"> + <li><a href="/ar/docs/Web/Accessibility/ARIA">توثيقات تقنية ARIA في شبكة مطوري موزيلا</a></li> + <li><a href="http://www.w3.org/WAI/">الصفحة الرئيسية لمبادرة الإتاحة الويبيّة</a></li> + <li><a href="http://www.w3.org/TR/wai-aria/">توثيقات تقنية WAI-ARIA</a></li> +</ul> diff --git a/files/ar/glossary/algorithm/index.html b/files/ar/glossary/algorithm/index.html new file mode 100644 index 0000000000..e3dbdbfd5f --- /dev/null +++ b/files/ar/glossary/algorithm/index.html @@ -0,0 +1,32 @@ +--- +title: خوارزمية +slug: Glossary/Algorithm +tags: + - مسرد +translation_of: Glossary/Algorithm +--- +<p dir="rtl">الخوارزميّة هي مجموعة من الخطوات المتكاملة لتنفيذ مهمة معينة.</p> + +<p dir="rtl">بتعبير آخر، الخوارزميّة هي وسيلة لوصف طريقة (أسلوب) لحل مشكلة ما ليُمكِن حلها، لاحقاً، بشكل متكرر (أي مهما تكررت المشكلة يُمكِن استخدام هذه الخوارزميّة لحلها دوماً) سواءً من قبل الآلات أو البشر. يقيّم علماء الحاسوب كفاءة الخوارزميّة من خلال مفهوم "<a href="https://www.cs.cmu.edu/~adamchik/15-121/lectures/Algorithmic%20Complexity/complexity.html">التعقيد الخوارزمي</a>" أو "Big O".</p> + +<p dir="rtl">على سبيل المثال:</p> + +<ul dir="rtl"> + <li>وصفة الطعام هي مثال بسيط على خوارزميّة يُمكِن تنفيذها من قبل البشر.</li> + <li>غالباً ما تُستخدم خوارزميّة الفرز (sorting algorithm) في البرمجة لشرح كيفيّة فرز الآلات للبيانات.</li> +</ul> + +<h2 dir="rtl" id="المزيد_من_التفاصيل">المزيد من التفاصيل</h2> + +<h3 dir="rtl" id="معلومات_عامة">معلومات عامة</h3> + +<ul dir="rtl"> + <li>مقالة عن <a href="https://ar.wikipedia.org/wiki/%D8%AE%D9%88%D8%A7%D8%B1%D8%B2%D9%85%D9%8A%D8%A9">الخوارزمية</a> في الموسوعة الحرَّة</li> +</ul> + +<h3 dir="rtl" id="مراجع_تقنيّة">مراجع تقنيّة</h3> + +<ul dir="rtl"> + <li><a href="https://www.toptal.com/developers/sorting-algorithms">شروحات عن خوارزميات الفرز</a></li> + <li><a href="http://bigocheatsheet.com/">شروحات عن التعقيد الخوارزمي</a> (algorithmic complexity)</li> +</ul> diff --git a/files/ar/glossary/api/index.html b/files/ar/glossary/api/index.html new file mode 100644 index 0000000000..84fa067677 --- /dev/null +++ b/files/ar/glossary/api/index.html @@ -0,0 +1,23 @@ +--- +title: API +slug: Glossary/API +translation_of: Glossary/API +--- +<p>API (واجهة برمجة التطبيقات) هي مجموعة من الميزات والقواعد الموجودة داخل برنامج (التطبيق) مما يتيح التفاعل معها من خلال البرامج - بدلاً من واجهة مستخدم بشرية. يمكن اعتبار واجهة برمجة التطبيقات عقد بسيط (الواجهة) بين التطبيق الذي يقدمها والعناصر الأخرى، مثل برامج أو أجهزة خارجية.</p> + +<p>في تطوير الويب، تعد واجهة برمجة التطبيقات عادةً مجموعة من ميزات التعليمات البرمجية (على سبيل المثال. {{glossary("method","methods")}}، {{Glossary("property","properties")}}، events and {{Glossary("URL", "URLS")}} التي يمكن للمطور استخدامها في تطبيقاتها للتفاعل مع مكونات مستعرض ويب الخاص بالمستخدم، أو البرامج/الأجهزة الأخرى على كمبيوتر المستخدم، أو مواقع ويب أو خدمات خارجية.</p> + +<p>على سبيل المثال:</p> + +<p>يمكن استخدام getUserMedia API للاستيلاء على الصوت والفيديو من كاميرا ويب للمستخدم ، والتي يمكن استخدامها بعد ذلك بأي طريقة يحبها المطور ، على سبيل المثال ، تسجيل الفيديو والصوت ، وبثه إلى مستخدم آخر في مؤتمر عبر الهاتف ، أو التقاط الصور الثابتة من الفيديو.<br> + يمكن استخدام واجهة برمجة تطبيقات تحديد الموقع الجغرافي لاسترداد معلومات الموقع من أي خدمة متاحة للمستخدم على أجهزتهم (مثل GPS) ، والتي يمكن استخدامها بعد ذلك بالاقتران مع واجهات برمجة التطبيقات لخرائط Google لرسم موقع المستخدم على خريطة مخصصة على سبيل المثال وإظهارها لما هي مناطق الجذب السياحي في منطقتهم.<br> + يمكن استخدام واجهات برمجة تطبيقات تويتر لاسترداد البيانات من حسابات المستخدم على تويتر، على سبيل المثال، لعرض أحدث تغريداتهم على صفحة ويب.<br> + يمكن استخدام واجهة برمجة تطبيقات "رسوم الويب" لتحريك أجزاء صفحة ويب — على سبيل المثال، لجعل الصور تتحرك أو تستدير.</p> + +<h5 id="التعرف_على_المزيد_المعرفة_العامة">التعرف على المزيد المعرفة العامة</h5> + +<p>{{Interwiki("wikipedia", "Application_programming_interface", "API")}} على ويكيبيديا</p> + +<h5 id="المرجع_التقني">المرجع التقني</h5> + +<p>مرجع واجهة برمجة تطبيقات ويب</p> diff --git a/files/ar/glossary/argument/index.html b/files/ar/glossary/argument/index.html new file mode 100644 index 0000000000..18c1671651 --- /dev/null +++ b/files/ar/glossary/argument/index.html @@ -0,0 +1,23 @@ +--- +title: مُعطى +slug: Glossary/Argument +tags: + - جافاسكربت + - مسرد +translation_of: Glossary/Argument +--- +<p dir="rtl"><strong>المُعطى</strong> (بالإنجليزيَّة: Argument)هو {{glossary("value", "قيمة")}} ({{Glossary("primitive", "أوليَّة")}} أو {{Glossary("object", "كائنيَّة")}}) تُمرَّر إلى الدالة كمُدخَل.</p> + +<h2 dir="rtl" id="المزيد_من_التفاصيل">المزيد من التفاصيل</h2> + +<h3 dir="rtl" id="معلومات_عامة">معلومات عامة</h3> + +<ul dir="rtl"> + <li><a class="external external-icon" href="http://en.wikipedia.org/wiki/Parameter_%28computer_programming%29#Parameters_and_arguments" rel="noopener">الفرق بين الوسيط والمُعطى</a> في الموسوعة الحرَّة</li> +</ul> + +<h3 dir="rtl" id="مراجع_تقنيّة">مراجع تقنيّة</h3> + +<ul dir="rtl"> + <li>الكائن {{jsxref("Functions/arguments","arguments")}} في لغة {{glossary("JavaScript", "الجافاسكربت")}}</li> +</ul> diff --git a/files/ar/glossary/array/index.html b/files/ar/glossary/array/index.html new file mode 100644 index 0000000000..f250d38a45 --- /dev/null +++ b/files/ar/glossary/array/index.html @@ -0,0 +1,31 @@ +--- +title: مصفوفة +slug: Glossary/array +tags: + - جافاسكربت + - مسرد +translation_of: Glossary/array +--- +<p dir="rtl"><strong>المصفوفة</strong> هي مجموعة مرتبة من البيانات (إما {{Glossary("primitive", "بدائية")}} أو {{Glossary("object", "شيئيّة")}} هذا يعتمد على اللغة المُستخدمة). تُستخدَم المصفوفات لتخزين عدَّة قيم في متغيّر واحد مقارنةً بالمتغيّر العادي الذي لا يمكن أن يُخزِّن سوى قيمة واحدة.</p> + +<p dir="rtl">لكل عنصر في المصفوفة رقم يدل عليه، يدعى بالرقم الفهرسي، يسمح هذا الرقم بالوصول إلى قيمة العنصر. تبدأ الفهرسة في لغة الجافاسكربت (كما في معظم اللغات) من الرقم صفر ويمكن التلاعب بعناصر المصفوفة باستخدام العديد من {{Glossary("Method", "الدوالة الصنفيّة")}}.</p> + +<p dir="rtl">تكون للمصفوفات الشكل التالي في لغة الجافاسكربت:</p> + +<pre dir="rtl">var myArray = [1, 2, 3, 4]; +var catNamesArray = ["Jacqueline", "Sophia", "Autumn"]; +//يمكن أن تحتوي المصفوفات في لغة الجافاسكربت على أنواع مختلفة من البيانات كما هو موضَّح أعلاه</pre> + +<h2 dir="rtl" id="المزيد_من_التفاصيل">المزيد من التفاصيل</h2> + +<h3 dir="rtl" id="معلومات_عامة">معلومات عامة</h3> + +<ul dir="rtl"> + <li>مقالة عن <a href="https://ar.wikipedia.org/wiki/%D9%85%D8%B5%D9%81%D9%88%D9%81%D8%A9_(%D8%AD%D9%88%D8%B3%D8%A8%D8%A9)">المصفوفة</a> في الموسوعة الحرَّة</li> +</ul> + +<h3 dir="rtl" id="مراجع_تقنيّة">مراجع تقنيّة</h3> + +<ul dir="rtl"> + <li>توثيقات الكائن {{jsxref("Array")}} في لغة الجافاسكربت.</li> +</ul> diff --git a/files/ar/glossary/attribute/index.html b/files/ar/glossary/attribute/index.html new file mode 100644 index 0000000000..522ffb8f91 --- /dev/null +++ b/files/ar/glossary/attribute/index.html @@ -0,0 +1,18 @@ +--- +title: خاصية +slug: Glossary/Attribute +tags: + - لغة ترميز النص الفائق + - مسرد +translation_of: Glossary/Attribute +--- +<p dir="rtl">تُعزِّز الخاصيّة (أو السمة أو الخاصة) الوسم، وتُعدِل من وظيفته أو تضيف بيانات وصفيّة له (metadata). تُعرَّف الخواص دوماً بالصيغة <code>اسم الخاصيّة=القيمة</code> (اسم الخاصيّة متبوعاً بالقيمة المُسندة لها).</p> + +<h2 dir="rtl" id="المزيد_من_التفاصيل">المزيد من التفاصيل</h2> + +<h3 dir="rtl" id="مراجع_تقنيّة"><span style="font-size: 1.71429rem;">مراجع تقنيّة</span></h3> + +<ul dir="rtl"> + <li><a href="/ar/docs/Web/HTML/Attributes">مرجع سِمات لغة ترميز النص الفائق</a></li> + <li>معلومات عن <a href="/ar/docs/Web/HTML/Global_attributes">سِمات لغة ترميز النص الفائق العموميّة</a> (global attributes)</li> +</ul> diff --git a/files/ar/glossary/bandwidth/index.html b/files/ar/glossary/bandwidth/index.html new file mode 100644 index 0000000000..bfbadfce0f --- /dev/null +++ b/files/ar/glossary/bandwidth/index.html @@ -0,0 +1,19 @@ +--- +title: Bandwidth +slug: Glossary/Bandwidth +tags: + - Bandwidth + - بنية تحتية + - قاموس مصطلحات + - معجم +translation_of: Glossary/Bandwidth +--- +<p dir="rtl">النطاق الترددي (Bandwidth) هو مقياس مقدار المعلومات التي يمكن أن تمر عبر اتصال بيانات في فترة زمنية محددة. يتم قياسه عادة بمضاعفات بت في الثانية (bps)، على سبيل المثال ميغابت في الثانية (Mbps) أو غيغابت في الثانية (Gbps).</p> + +<h2 dir="rtl" id="اعرف_أكثر">اعرف أكثر</h2> + +<ul> + <li>{{Interwiki("wikipedia", "Bandwidth")}} على ويكيبيديا</li> +</ul> + +<div id="eJOY__extension_root"> </div> diff --git a/files/ar/glossary/blink/index.html b/files/ar/glossary/blink/index.html new file mode 100644 index 0000000000..9637f62c04 --- /dev/null +++ b/files/ar/glossary/blink/index.html @@ -0,0 +1,18 @@ +--- +title: بلينك +slug: Glossary/Blink +tags: + - مسرد +translation_of: Glossary/Blink +--- +<p dir="rtl">يعد بلينك (Blink) محرِّك تنسيق (أو مُحرِّك تخطيط أو مُحرِّك تموضع - layout engine) مفتوح المصدر طوِّر من شركة جوجل كجزء من مشروع كروميوم (وبالتالي من مشروع كروم أيضاً كونه مبنياً على كروميوم). بلينك هو بالأصل اشتقاق من مكتبة {{glossary("WebKit", "ويب كيت")}} التي تقوم بعملية موضَعِة وعرض الأشكال، وتتعامل مع {{glossary("DOM", "نموذج كائن المستند")}} (DOM).</p> + +<h2 dir="rtl" id="المزيد_من_التفاصيل">المزيد من التفاصيل</h2> + +<h3 dir="rtl" id="معلومات_عامة">معلومات عامة</h3> + +<ul dir="rtl"> + <li><a href="http://www.chromium.org/blink">الصفحة الرئيسيّة</a> لمشروع بلينك</li> + <li>مقالة عن <a href="https://ar.wikipedia.org/wiki/%D8%A8%D9%84%D9%8A%D9%86%D9%83">بلينك</a> في الموسوعة الحرَّة</li> + <li>أسئلة شائعة عن <a href="http://www.chromium.org/blink/developer-faq">بلينك</a></li> +</ul> diff --git a/files/ar/glossary/boolean/index.html b/files/ar/glossary/boolean/index.html new file mode 100644 index 0000000000..b050bb3d8d --- /dev/null +++ b/files/ar/glossary/boolean/index.html @@ -0,0 +1,48 @@ +--- +title: متغير بولياني +slug: Glossary/Boolean +tags: + - أنواع البيانات + - جافاسكربت + - شيفرة المكتوب + - لغات برمجية + - مسرد +translation_of: Glossary/Boolean +--- +<p dir="rtl">المتغير البولياني هو نوع من البيانات، يأخذ فقط القيمة <code>صحيح</code> أو <code>خطأ</code>. مثلا في جافاسكربت، الشروط البوليانية تستعمل عادة لتحديد أي جزء من الشيفرة سينفذ (كالتعبير الشرطي if) أو سيكرر (كحلقة التكرار for).</p> + +<pre class="brush: js">/* التعبير الشرطي الجافاسكربتي */ +if (الشرط البولياني) { + // ما سينفذ في حالة الشرط صحيح +} + +if (الشرط البولياني) { + console.log("الشرط البولياني صحيح"); +} else { + console.log("الشرط البولياني خاطئ"); +} + + +/* حلقة التكرار الجافاسكربتية */ +for (متغير التحكم; الشرط البولياني; counter) { + // ما سيكرر في حالة الشرط صحيح + +for (var i=0; i < 4; i++) { + console.log("أطبع فقط إذا الشرط صحيح"); +} +</pre> + +<h2 id="المزيد">المزيد</h2> + +<h3 id="المركز_المعرفي">المركز المعرفي</h3> + +<ul> + <li>{{Interwiki("wikipedia", "Boolean data type", "Boolean")}} on Wikipedia</li> +</ul> + +<h3 id="المرجع_التقني">المرجع التقني</h3> + +<ul> + <li>The JavaScript global object: {{jsxref("Boolean")}}</li> + <li><a href="/en-US/docs/Web/JavaScript/Data_structures">JavaScript data types and data structures</a></li> +</ul> diff --git a/files/ar/glossary/browser/index.html b/files/ar/glossary/browser/index.html new file mode 100644 index 0000000000..8ce6faac33 --- /dev/null +++ b/files/ar/glossary/browser/index.html @@ -0,0 +1,26 @@ +--- +title: متصفح +slug: Glossary/Browser +tags: + - مسرد +translation_of: Glossary/Browser +--- +<p dir="rtl"><em>مُتصفِح الويب</em> هو برنامج يُستخدَم لاستقبال وعرض الصفحات من {{Glossary("World Wide Web","الشابكة")}}، كما يُمكِّن المستخدمين من الولوج إلى صفحات أخرى عبر {{Glossary("hyperlink","الوصلات")}}.</p> + +<h2 dir="rtl" id="المزيد_من_التفاصيل">المزيد من التفاصيل</h2> + +<h3 dir="rtl" id="معلومات_عامة">معلومات عامة</h3> + +<ul dir="rtl"> + <li>مقالة عن <a href="https://ar.wikipedia.org/wiki/%D9%85%D8%AA%D8%B5%D9%81%D8%AD_(%D9%88%D9%8A%D8%A8)">متصفح الويب</a> في الموسوعة الحرَّة</li> + <li>موقع <a href="http://www.evolutionoftheweb.com/">تطوُّر الشابكة</a></li> +</ul> + +<h3 dir="rtl" id="متصفحات_للتنزيل">متصفحات للتنزيل</h3> + +<ul dir="rtl"> + <li><a href="http://www.mozilla.org/ar/firefox/features/">متصفح فايرفوكس</a></li> + <li><a href="http://www.google.com/chrome/">متصفح جوجل كروم</a></li> + <li><a href="https://www.microsoft.com/en-us/download/internet-explorer.aspx">متصفح إنترنت إكسبلورر</a></li> + <li><a href="http://www.opera.com/">متصفح أوبرا</a></li> +</ul> diff --git a/files/ar/glossary/compile/index.html b/files/ar/glossary/compile/index.html new file mode 100644 index 0000000000..dd841b3e04 --- /dev/null +++ b/files/ar/glossary/compile/index.html @@ -0,0 +1,28 @@ +--- +title: تصريف +slug: Glossary/Compile +tags: + - مسرد +translation_of: Glossary/Compile +--- +<p><strong>التصريف</strong> (بالإنجليزيَّة: Compiling) هو عمليَّة تحويل برنامج حاسوبي مكتوب {{Glossary("computer programming", "بلغة برمجة")}} إلى برنامجٍ مُكافِئ مكتوب بلغةٍ أخرى (<strong>المُصرِّف</strong> هو البرمجيَّة التي تؤدي هذه المهمة). تُسمَّى أحيانًا هذه العمليَّة "بالتجميع (بالإنجليزيَّة: Assembling)" أو "البناء (بالإنجليزيَّة: Build)"، ما يوضِّح عادةً وجود المزيد من الخطوات بعد التصريف (كتحزيم البرنامج في صيغة ثنائيَّة تنفيذيَّة).</p> + +<p>يُحوِّل المُصرِّف عادةً لغةً عالية المُستوى (مثل سي أو {{Glossary("Java", "جافا")}})، المفهومة من البشر، إلى لغة الآلة (كلغة التجميع)، المفهومة من المعالِج. تتُرجِم بعض المُصرِّفات بين لُغتين من نفس المستوى، فتُسمَّى مُصبرِفات (نحتًا من مُصرِّف بيني) أو مُصعرِفات (نحتًا من مُصرِّف تقاطعي)، كتصريف لغة التايب سكربت إلى {{Glossary("JavaScript", "الجافاسكربت")}}.</p> + +<p>مُعظَم المُصرِّفات إمّا قبليَّة (تُصرِّف البرنامج قبل تشغيله، بالإنجليزيَّة: Ahead of time) وإمّا آنيَّة (تُصرِّف البرنامج أثناء تشغيله، بالإنجليزيَّة: Just in time). عادةً ما يستخدم المُطوِّر المُصرِّفات القبليَّة الاعتياديَّة من سطر الأوامر أو من {{Glossary("IDE", "بيئته البرمجيَّة")}}. من أشهر مُصرِّفات هذا النوع هو مُصرِّف جنو GCC. هذا بالنسبة للمُصرِّفات القبليَّة، أم المُصرِّفات الآنية فهي عادةً شفّافة بالنسبة لك، وتُستخدَم لأداءٍ أفضل. يحوي مُحرِّك الجافاسكربت <a href="https://developer.mozilla.org/en-US/docs/Mozilla/Projects/SpiderMonkey">SpiderMonkey</a> لمُتصفِّح فايرفوكس كمثال مُصرِّفًا آنيًّا مُضمّنًا فيه، يُصرِّف هذا المُصرِّف أكواد الجافاسكربت في المواقع العنكبوتيَّة إلى لغة الآلة أثناء تصفُّحِكَ لها، ما يُحسِّن الأداء ويزيده سُرعة. تعمل مشاريع مثل <a href="ar/docs/WebAssembly/">لغة التجميع العنكبوتيَّة</a> (بالإنجليزيَّة: WebAssembly) على جعل الأداء أفضل من ذلك حتّى.</p> + +<h2 id="المزيد_من_التفاصيل">المزيد من التفاصيل</h2> + +<h3 id="معلومات_عامة">معلومات عامة</h3> + +<ul> + <li dir="rtl">مقالة عن <a href="https://ar.wikipedia.org/wiki/%D9%85%D8%AD%D9%88%D9%84_%D8%A8%D8%B1%D9%85%D8%AC%D9%8A">المُصرِّف</a> في الموسوعة الحرَّة</li> + <li dir="rtl"><a href="https://gcc.gnu.org/">مجموعة مُصرِّفات جنو</a> (GCC)</li> +</ul> + +<h3 id="موارد_تعليميَّة">موارد تعليميَّة</h3> + +<ul> + <li><a href="https://medium.com/basecs/a-deeper-inspection-into-compilation-and-interpretation-d98952ebc842">مقدمة في المُصرِّفات (بالإنجليزيَّة)</a></li> + <li><a href="http://stackoverflow.com/a/1672/133203">قائمة ضخمة من موارد تعلُّم المُصرِّفات في موقع StackOverflow</a></li> +</ul> diff --git a/files/ar/glossary/computer_programming/index.html b/files/ar/glossary/computer_programming/index.html new file mode 100644 index 0000000000..c497bed929 --- /dev/null +++ b/files/ar/glossary/computer_programming/index.html @@ -0,0 +1,21 @@ +--- +title: برمجة +slug: Glossary/Computer_Programming +tags: + - برمجة + - لغات برمجة + - مسرد +translation_of: Glossary/Computer_Programming +--- +<p dir="rtl">تُعرَّف <strong>البرمجة</strong> (أو برمجة الحاسب الآلي) بأنَّها عمليّة إنشاء وتنظيم مجموعة من التعليمات. تُخبِر هذه التعليمات الحاسوب بما عليه فعله باللغة التي يفهمها. تأتي هذه التعليمات بأشكال لغات مختلفة مثل جافا، جافاسكربت، بايثون، روبي ...إلخ.</p> + +<p dir="rtl">يمكنك، باستخدام اللغة المناسبة، إنشاء جميع أنواع البرمجيات. على سبيل المثال، برنامج يساعد العلماء على حل المعادلات المُعقدة، قاعدة بيانات تُخزِن كميّة هائلة من البيانات، موقع يتيح للناس تحميل الأغاني، أو برنامج يتيح للناس إنشاء أفلام رسوم متحركة.</p> + +<h2 dir="rtl" id="المزيد_من_التفاصيل">المزيد من التفاصيل</h2> + +<h3 dir="rtl" id="معلومات_عامة">معلومات عامة</h3> + +<ul dir="rtl"> + <li>مقالة عن {{Interwiki("wikipedia", "برمجة", "البرمجة")}} في الموسوعة الحرَّة</li> + <li>مقالة عن {{Interwiki("wikipedia", "قائمة_لغات_البرمجة", "قائمة بلغات البرمجة")}} في الموسوعة الحرَّة</li> +</ul> diff --git a/files/ar/glossary/cookie/index.html b/files/ar/glossary/cookie/index.html new file mode 100644 index 0000000000..05e0621c77 --- /dev/null +++ b/files/ar/glossary/cookie/index.html @@ -0,0 +1,20 @@ +--- +title: كعكة +slug: Glossary/Cookie +tags: + - مسرد +translation_of: Glossary/Cookie +--- +<p dir="rtl">الكعكة (ملف تعريف الارتباط) هي قدر صغير من المعلومات يُترَك على حواسيب الزوار من قبل الموقع بواسطة {{ Glossary("browser", "المُتصفِح") }}.</p> + +<p dir="rtl">تُستخدَم الكعكات لتخصيص تجربة المُستخدِم مع الموقع. قد تحتوي هذه الكعكات على تفضيلات أو مدخلات المُستخدِم عند دخوله لهذا الموقع. يستطيع المُستخدمِين تعديل متصفحاتِهم لقبول، أو رفض، أو حذف هذه الكعكات.</p> + +<p dir="rtl">يُمكِن وضع الكعكات وتعديلها من جهة الخادم باستخدام <a href="/ar/docs/Web/HTTP/Cookies">الترويسة</a> <code>Set-Cookie</code>، أو بواسطة الجافاسكربت باستخدام الخاصيّة <code><a href="/en-US/docs/Web/API/Document/cookie">document.cookie</a></code>.</p> + +<h2 dir="rtl" id="المزيد_من_التفاصيل">المزيد من التفاصيل</h2> + +<h3 dir="rtl" id="معلومات_عامة">معلومات عامة</h3> + +<ul dir="rtl"> + <li>مقالة عن <a href="https://ar.wikipedia.org/wiki/%D9%85%D9%84%D9%81_%D8%AA%D8%B9%D8%B1%D9%8A%D9%81_%D8%A7%D8%B1%D8%AA%D8%A8%D8%A7%D8%B7">ملف تعريف الارتباط</a> في الموسوعة الحرَّة</li> +</ul> diff --git a/files/ar/glossary/copyleft/index.html b/files/ar/glossary/copyleft/index.html new file mode 100644 index 0000000000..5b44cfb6ad --- /dev/null +++ b/files/ar/glossary/copyleft/index.html @@ -0,0 +1,17 @@ +--- +title: حقوق متروكة +slug: Glossary/Copyleft +tags: + - ترخيص + - مسرد +translation_of: Glossary/Copyleft +--- +<p dir="rtl">يشير مصطلح الحقوق المتروكة (copyleft)، في سياق التراخيص القانونيّة، إلى نوع الرخص التي تفرض ترخيص إعادة توزيع العمل المُرخَص بها بالرخصة الأصل. يمكننا أخذ {{Glossary("GPL", "رخصة جنو العموميّة")}} كمثال على تراخيص الحقوق المتروكة للبرمجيات <a href="https://ar.wikipedia.org/wiki/%D8%B1%D8%AE%D8%B5_%D8%A7%D9%84%D9%85%D8%B4%D8%A7%D8%B9_%D8%A7%D9%84%D8%A5%D8%A8%D8%AF%D8%A7%D8%B9%D9%8A">ورخص المشاع الإبداعي</a> من فئة الترخيص بالمثل كمثال على تراخيص الحقوقة المتروكة للأعمال الفنيّة.</p> + +<h2 dir="rtl" id="المزيد_من_التفاصيل">المزيد من التفاصيل</h2> + +<h3 dir="rtl" id="معلومات_عامة">معلومات عامة</h3> + +<ul dir="rtl"> + <li>مقالة عن <a href="https://ar.wikipedia.org/wiki/%D8%AD%D9%82%D9%88%D9%82_%D9%85%D8%AA%D8%B1%D9%88%D9%83%D8%A9">الحقوق المتروكة</a> في الموسوعة الحرَّة</li> +</ul> diff --git a/files/ar/glossary/data_structure/index.html b/files/ar/glossary/data_structure/index.html new file mode 100644 index 0000000000..49529d5852 --- /dev/null +++ b/files/ar/glossary/data_structure/index.html @@ -0,0 +1,17 @@ +--- +title: هيكل بيانات +slug: Glossary/Data_structure +tags: + - مسرد + - هياكل-البيانات +translation_of: Glossary/Data_structure +--- +<p dir="rtl"><strong>هيكل البيانات</strong> (بالإنجليزيَّة: Data Structure) هو طريقة مُعينة لتخزين وتنظيم البيانات ما يُمكِّن استخدامها بكفاءة.</p> + +<h2 dir="rtl" id="المزيد_من_التفاصيل">المزيد من التفاصيل</h2> + +<h3 dir="rtl" id="معلومات_عامة">معلومات عامة</h3> + +<ul dir="rtl"> + <li>مقالة عن <a href="https://ar.wikipedia.org/wiki/%D8%A8%D9%86%D9%8A%D8%A9_%D8%A8%D9%8A%D8%A7%D9%86%D8%A7%D8%AA">هيكل البيانات</a> في الموسوعة الحرَّة</li> +</ul> diff --git a/files/ar/glossary/decryption/index.html b/files/ar/glossary/decryption/index.html new file mode 100644 index 0000000000..fc8c14de60 --- /dev/null +++ b/files/ar/glossary/decryption/index.html @@ -0,0 +1,25 @@ +--- +title: فك التشفير +slug: Glossary/Decryption +tags: + - حماية + - مسرد +translation_of: Glossary/Decryption +--- +<p dir="rtl"><strong>فك التشفير</strong>، في علم التشفير، هو تحويل {{glossary("ciphertext", "نص مُشفَر")}} إلى {{glossary("cleartext", "نص مقروء")}}.</p> + +<p dir="rtl">فك التشفير هو من مبادئ عمليّة التشفير، فهو يحوِّل النص المُشفَر (كما يسمى النص المُعمَّى أيضاً) إلى نص مقروء باستخدام خوارزميّة تشفير تُسمى {{glossary("cipher", "الشيفرة")}}. كما في التشفير، تجري عمليّة فك التشفير في الخوارزميات الحديثة باستخدام خوارزميّة وكلمة سريّة معينة، تدعى {{glossary("key", "المفتاح")}}. في حين أنَّ الخوارزميات غالباً ما تُنشَر للعامة، فالمفتاح ينبغي أن يبقى سرياً مادام النص المُشفَر يجب أن يبقى سرياً.</p> + +<p dir="rtl"> </p> + +<p><img alt="مبدأ عمليّة فك التشفير." src="https://mdn.mozillademos.org/files/15899/Decryption-ar.png" style="height: 81px; width: 485px;"></p> + +<p dir="rtl">فك التشفير هو العمليّة المعاكسة {{glossary("encryption", "للتشفير")}}. تكون عمليّة فك التشفير صعبة الإجراء حسابياً إن كان المفتاح السري غير ملعوم. يتوقف مدى الصعوبة على قوَّة الخوارزميّة المُختارة وعلى التقدُم في عمليّة تحليلها (أي كُلما عُلِمَت تفاصيل أكثر عن آلية التشفير المُستخدمة وضَعُفَت قوة الخوارزميّة سهل كسرها).</p> + +<h2 dir="rtl" id="المزيد_من_التفاصيل">المزيد من التفاصيل</h2> + +<h3 class="highlight-spanned" dir="rtl" id="مراجع_تقنيّة">مراجع تقنيّة</h3> + +<ul dir="rtl"> + <li><a href="/ar/docs/Encryption_and_Decryption">التشفير وفك التشفير</a></li> +</ul> diff --git a/files/ar/glossary/denial_of_service/index.html b/files/ar/glossary/denial_of_service/index.html new file mode 100644 index 0000000000..4fe7c06334 --- /dev/null +++ b/files/ar/glossary/denial_of_service/index.html @@ -0,0 +1,9 @@ +--- +title: حجب الخدمة +slug: Glossary/Denial_of_Service +tags: + - حماية + - مسرد +translation_of: Glossary/Denial_of_Service +--- +<p>{{page("/ar/docs/Glossary/DOS_attack")}}</p> diff --git a/files/ar/glossary/dom/index.html b/files/ar/glossary/dom/index.html new file mode 100644 index 0000000000..11757b223f --- /dev/null +++ b/files/ar/glossary/dom/index.html @@ -0,0 +1,35 @@ +--- +title: DOM +slug: Glossary/DOM +tags: + - CodingScripting + - DOM + - Glossary +translation_of: Glossary/DOM +--- +<p dir="rtl"> </p> + +<p dir="rtl">DOM (نموذج كائن المستند) هو {{glossary("API")}} يمثل ويتفاعل مع أي مستند {{glossary("HTML")}} أو {{glossary("XML")}} .</p> + +<p dir="rtl">DOM عبارة عن نموذج مستند تم تحميله في {{glossary("browser")}} ويمثل المستند على شكل شجرة عقدة ، حيث تمثل كل عقدة جزءًا من المستند (على سبيل المثال ، {{Glossary("element")}} ، سلسلة نصية ، أو تعليق).</p> + +<p dir="rtl">يُعد DOM واحدًا من أكثر {{Glossary("API")}} المستخدم في {{glossary("World Wide Web","Web")}} لأنه يسمح بتشغيل التعليمات البرمجية في المتصفح للوصول و التفاعل مع كل عقدة في الوثيقة. يمكن إنشاء العقد ونقلها وتغييرها. يمكن إضافة مستمعي الحدث إلى العقد وتشغيله عند وقوع حدث معين.</p> + +<p dir="rtl">لم يتم تحديد DOM في الأصل - فقد جاء عندما بدأت المتصفحات في تنفيذ {{Glossary("JavaScript")}}. يطلق على هذا DOM القديم أحيانًا اسم DOM 0. واليوم ، يحافظ WHATWG على معيار DOM .</p> + +<p dir="rtl"> </p> + +<h2 dir="rtl" id="أعرف_أكثر">أعرف أكثر</h2> + +<h3 dir="rtl" id="معرفة_عامة">معرفة عامة</h3> + +<ul> + <li>{{interwiki("wikipedia", "Document_Object_Model", "The Document Object Model")}} على Wikipedia</li> +</ul> + +<h3 dir="rtl" id="معلومات_تقنية">معلومات تقنية</h3> + +<ul> + <li dir="rtl"><a href="/en-US/docs/DOM">وثائق DOM على MDN</a></li> + <li dir="rtl"><a href="https://dom.spec.whatwg.org/" rel="external">معيار DOM</a></li> +</ul> diff --git a/files/ar/glossary/dos_attack/index.html b/files/ar/glossary/dos_attack/index.html new file mode 100644 index 0000000000..4ab372752a --- /dev/null +++ b/files/ar/glossary/dos_attack/index.html @@ -0,0 +1,33 @@ +--- +title: هجمة حجب الخدمة +slug: Glossary/DOS_attack +tags: + - حماية + - مسرد +translation_of: Glossary/DOS_attack +--- +<p dir="rtl"><strong>هجوم حجب الخدمة</strong> (أو هجوم الحرمان من الخدمة - Dos) هي هجمة شبكيّة تمنَع الاستخدام الشرعي (العادي) لموارد {{glossary("server", "الخادم")}} عن طريق إغراقه بالطلبات.</p> + +<p dir="rtl">تمتلك الحواسيب حد معين من الموارد، كالقدرة الحسابيّة أو الذاكرة. عندما تُستهلَك هذه الموارد قد يتجمد أو يتعطل البرنامج، مما يجعله غير متوفراً. تتألف هجمة حجب الخدمة من تقنيات متنوعة لجعل لاستنفاذ هذه الموارد وجعل الخادمة أو الشبكة غير متاحة لمستخدميها الشرعيين، أو على الأقل لإبطاء أداء الخادم.</p> + +<h3 dir="rtl" id="أنواع_هجمات_حجب_الخدمة">أنواع هجمات حجب الخدمة</h3> + +<p dir="rtl">هجمات حجب الخدمة هي تصنيف أكثر من أن تكون نوع معين من الهجمات. أدناه توجد قائمة غير شاملة لأنواع هجمات حجب الخدمة:</p> + +<ul dir="rtl"> + <li>هجوم النطاق الترددي (bandwidth attack)</li> + <li>هجوم إغراق الخدمة بالطلبات (service request flood)</li> + <li>هجوم الغمر التزامني (SYN flooding attack)</li> + <li>هجوم الغمر بطلبات ميثاق<span class="CLPzrc Y0NH2b"> رسائل التحكم في الإنترنت</span> (ICMP flood attack)</li> + <li>هجوم الند للند (peer-to-peer attack)</li> + <li>هجوم حجب الخدمة المُستمِر (permanent DoS attack)</li> + <li>هجوم الغمر على مستوى طبقة التطبيقات (application level flood attack)</li> +</ul> + +<h2 dir="rtl" id="المزيد_من_المعلومات">المزيد من المعلومات</h2> + +<ul dir="rtl"> + <li>مقالة <a href="https://ar.wikipedia.org/wiki/%D9%87%D8%AC%D9%85%D8%A7%D8%AA_%D8%A7%D9%84%D8%AD%D8%B1%D9%85%D8%A7%D9%86_%D9%85%D9%86_%D8%A7%D9%84%D8%AE%D8%AF%D9%85%D8%A7%D8%AA">هجمة الحرمان من الخدمات</a> في الموسوعة الحرَّة</li> + <li>مقالة <a href="https://www.owasp.org/index.php/Denial_of_Service">حجب الخدمة في موسوعة أواسب</a></li> + <li>{{Glossary("Distributed Denial of Service","هجمة حجب الخدمة الموزَّعة")}}</li> +</ul> diff --git a/files/ar/glossary/forbidden_header_name/index.html b/files/ar/glossary/forbidden_header_name/index.html new file mode 100644 index 0000000000..12776e896f --- /dev/null +++ b/files/ar/glossary/forbidden_header_name/index.html @@ -0,0 +1,51 @@ +--- +title: Forbidden header name +slug: Glossary/Forbidden_header_name +translation_of: Glossary/Forbidden_header_name +--- +<p>A <dfn>forbidden header name</dfn> is the name of any <a href="/en-US/docs/Web/HTTP/Headers">HTTP header</a> that cannot be modified programmatically; specifically, an HTTP <strong>request</strong> header name (in contrast with a {{Glossary("Forbidden response header name")}}).</p> + +<p>Modifying such headers is forbidden because the user agent retains full control over them. Names starting with `<code title="">Sec-</code>` are reserved for creating new headers safe from {{glossary("API","APIs")}} using <a href="/en-US/docs/Web/API/Fetch_API">Fetch</a> that grant developers control over headers, such as {{domxref("XMLHttpRequest")}}.</p> + +<p>Forbidden header names start with <code>Proxy-</code> or <code>Sec-</code>, or are one of the following names:</p> + +<ul class="brief"> + <li><code title="">Accept-Charset</code></li> + <li><code title="">Accept-Encoding</code></li> + <li><code title="">Access-Control-Request-Headers</code></li> + <li><code title="">Access-Control-Request-Method</code></li> + <li><code title="">Connection</code></li> + <li><code title="">Content-Length</code></li> + <li><code title="">Cookie</code></li> + <li><code title="">Cookie2</code></li> + <li><code title="">Date</code></li> + <li><code title="">DNT</code></li> + <li><code title="">Expect</code></li> + <li><code title="">Feature-Policy</code></li> + <li><code title="">Host</code></li> + <li><code title="">Keep-Alive</code></li> + <li><code title="http-origin">Origin</code></li> + <li><code title="http-origin">Proxy-</code></li> + <li><code title="http-origin">Sec-</code></li> + <li><code title="">Referer</code></li> + <li><code title="">TE</code></li> + <li><code title="">Trailer</code></li> + <li><code title="">Transfer-Encoding</code></li> + <li><code title="">Upgrade</code></li> + <li><code title="">Via</code></li> +</ul> + +<div class="note"> +<p><strong>Note</strong>: The <code>User-Agent</code> header is no longer forbidden, <a href="https://fetch.spec.whatwg.org/#terminology-headers">as per spec</a> — see forbidden header name list (this was implemented in Firefox 43) — it can now be set in a Fetch <a href="/en-US/docs/Web/API/Headers">Headers</a> object, or via XHR <a href="/en-US/docs/Web/API/XMLHttpRequest#setRequestHeader%28%29">setRequestHeader()</a>. However, Chrome will silently drop the header from Fetch requests (see <a href="https://bugs.chromium.org/p/chromium/issues/detail?id=571722">Chromium bug 571722</a>).</p> +</div> + +<section class="Quick_links" id="Quick_Links"> +<ol> + <li><a href="/en-US/docs/Glossary">MDN Web Docs Glossary</a> + + <ol> + <li>{{Glossary("Forbidden response header name")}}</li> + </ol> + </li> +</ol> +</section> diff --git a/files/ar/glossary/function/index.html b/files/ar/glossary/function/index.html new file mode 100644 index 0000000000..169997f62c --- /dev/null +++ b/files/ar/glossary/function/index.html @@ -0,0 +1,87 @@ +--- +title: دالة +slug: Glossary/Function +tags: + - جافاسكربت + - مسرد +translation_of: Glossary/Function +--- +<p dir="rtl"><strong>الدالة</strong> (بالإنجليزيَّة: Function) هي قطعة من الكود يُمكِن استدعاؤها من جزء آخر أو من قبل نفسها، أو هي {{Glossary("variable", "مُتغيِّر")}} يشير إلى دالة. عندما تُستدعى الدالة، تُمرَّر {{Glossary("Argument", "المُعطيات")}} إلى الدالة كمُدخلات، كما يُمكِن للدالة - اختياريًا - أن تُعيد مُخرجًا. تُصنَّف الدوال في لغة {{glossary("JavaScript", "الجافاسكربت")}} على أنهَّا {{glossary("object", "كائنات")}}.</p> + +<p dir="rtl">اسم الدالة هو {{Glossary("identifier", "مُعرِّف")}} يُصرَّح عنه كجزء من كود التصريح عن الدالة. يعتمد {{Glossary("scope", "مجال")}} اسم الدالة على ما إذا كان اسمها تصريحًا أم تعبيرًا (حيث إذا كان تصريحًا سيُحمَّل قبل تنفيذ الكود، أما إذا كان تعبيرًا سيُحمَّل عند وصول المُفسِّر إليه. طالع <a href="https://stackoverflow.com/questions/1013385/what-is-the-difference-between-a-function-expression-vs-declaration-in-javascrip">هذا السؤال</a> للمزيد من المعلومات).</p> + +<h3 dir="rtl" id="الأنواع_المختلفة_للدوال">الأنواع المختلفة للدوال</h3> + +<p dir="rtl"><strong>الدالة المجهولة </strong>(بالإنجليزيَّة: Anonymous function) هي دالة لا تملك اسمًا:</p> + +<pre class="brush: js">function () {}; +// أو باستخدام الأسهم في إصدار EMAScript 2015 +() => {}; +</pre> + +<p dir="rtl"><strong>الدالة المُسمّاة</strong> (بالإنجليزيَّة: Named function) هي دالة تملك اسمًا:</p> + +<pre class="brush: js">function foo() {}; +// أو باستخدام الأسهم في إصدار EMAScript 2015 +const foo = () => {}; +</pre> + +<p dir="rtl"><strong>الدالة المُحاطة</strong> (بالإنجليزيَّة: Inner function) هي دالة بداخل أخرى (الدالة <code>square</code> كما في مثالنا أدناه). <strong>الدالة المُحيطة</strong> (outer function) هي دالة (الدالة <code>addSquares</code> كما في مثالنا أدناه) تُحيط بأخرى:</p> + +<pre class="brush: js">function addSquares(a,b) { + function square(x) { + return x * x; + } + return square(a) + square(b); +}; +//باستخدام الأسهم في إصدار ECMAScript 2015 +const addSquares = (a,b) => { + const square = x => x*x; + return square(a) + square(b); +}; +</pre> + +<p dir="rtl"><strong>الدالة العوديّة</strong> (بالإنجليزيَّة: Recursive function) هي دالة تستدعي نفسها. طالع {{Glossary("Recursion", "المعاودة")}} للمزيد من التفاصيل.</p> + +<pre class="brush: js">function loop(x) { + if (x >= 10) + return; + loop(x + 1); +}; +//باستخدام الأسهم في إصدار ECMAScript 2015 +const loop = x => { + if (x >= 10) + return; + loop(x + 1); +}; +</pre> + +<p dir="rtl"><strong>التعبيرات الداليَّة المُستحضرة فوريًا</strong> (بالإنجليزيَّة: Immediately Invoked Function Expressions) هي دوال تُستدعى مباشرةً بعد أنْ تُحمَّل إلى {{glossary("Compiler", "مُصرِّف")}} المُتصفِّح. يُعرَّف هذا النوع من الدوال عبر إضافة قوسان: يساري ويميني إضافيان في نهاية تصريح الدالة (انظر أدناه).</p> + +<pre class="brush: js">// Error (https://en.wikipedia.org/wiki/Immediately-invoked_function_expression) +/* +function foo() { + console.log('Hello Foo'); +}(); +*/ + +(function foo() { + console.log("Hello Foo"); +}()); + +(function food() { + console.log("Hello Food"); +})(); + +</pre> + +<p dir="rtl">اقرأ <a href="https://en.wikipedia.org/wiki/Immediately-invoked_function_expression">هذه المقالة</a> في الموسوعة الحرَّة للمزيد عن هذا النوع من الدوال.</p> + +<h2 dir="rtl" id="المزيد_من_التفاصيل">المزيد من التفاصيل</h2> + +<h3 dir="rtl" id="مراجع_تقنيّة">مراجع تقنيّة</h3> + +<ul dir="rtl"> + <li><a href="/ar/docs/Web/JavaScript/Guide/Functions">توثيق الدوال</a> في شبكة مطوري موزيلا</li> + <li><a href="/ar/docs/Web/JavaScript/Guide/Functions">الدوال السهميّة</a></li> +</ul> diff --git a/files/ar/glossary/google_chrome/index.html b/files/ar/glossary/google_chrome/index.html new file mode 100644 index 0000000000..02a62dc468 --- /dev/null +++ b/files/ar/glossary/google_chrome/index.html @@ -0,0 +1,35 @@ +--- +title: جوجل كروم +slug: Glossary/Google_Chrome +tags: + - مسرد +translation_of: Glossary/Google_Chrome +--- +<p dir="rtl">جوجل كروم هو {{glossary("browser", "مُتصفِح")}} ويب مجاني طوِّر بواسطة شركة جوجل. يعد هذا المتصفح مبنياً على مشروع <a href="http://www.chromium.org/">كروميوم</a> مفتوح المصدر. يوجد بضعة اختلافات رئيسيّة بينهما (كروم وكروميوم) مشروحة في <a href="https://code.google.com/p/chromium/wiki/ChromiumBrowserVsGoogleChrome">موسوعة مشروع كروميوم</a>. يستخدم كلا المشروعين مُحرِّك عرض مُشتَق من {{glossary("WebKit", "ويب كيت")}} يسمى {{glossary("Blink", "بلينك")}}. من الجدير بالذكر أنَّ نسخة كروم لهواتف ال<span>آي أو إس</span> لا تستخدم بلينك وإنما تستخدم مُحرِّك عرض نظام التشغيل الأساسي.</p> + +<h2 dir="rtl" id="المزيد_من_التفاصيل" style="line-height: 30px;">المزيد من التفاصيل</h2> + +<h3 dir="rtl" id="معلومات_عامة" style="line-height: 24px;">معلومات عامة</h3> + +<ul dir="rtl"> + <li>مقالة عن <a href="https://ar.wikipedia.org/wiki/%D8%AC%D9%88%D8%AC%D9%84_%D9%83%D8%B1%D9%88%D9%85">جوجل كروم</a> في الموسوعة الحرَّة</li> +</ul> + +<h3 dir="rtl" id="تنزيل_كروم_للمستخدمين" style="line-height: 24px;">تنزيل كروم للمستخدمين</h3> + +<p dir="rtl">استخدم الرابط المناسب لمنصتك لتنزيل نسخة كروم للمستخدمين العاديين:</p> + +<ul dir="rtl"> + <li><a href="https://play.google.com/store/apps/details?id=com.android.chrome">نسخة الأندرويد</a></li> + <li><a href="https://itunes.apple.com/us/app/chrome-web-browser-by-google/id535886823?mt=8">نسخة الآي أو إس</a></li> + <li><a href="https://www.google.com.sa/intl/ar/chrome/">نسخة سطح المكتب</a></li> +</ul> + +<h3 dir="rtl" id="تنزيل_كروم_للمطورين">تنزيل كروم للمطورين</h3> + +<p dir="rtl">إذا كنت راغباً بتجربة أحدث مزايا كروم قيد الاختبار، قم بتثبيت النسخ ما قبل المستقرة (الغير مستقرة). تدفع جوجل التحديثات دورياً ليتم تجربتها، كما صُمِمَت هذه النسخ لتعمل جنباً إلى جنب مع النسخ المستقرة بلا مشاكل. قم بزيارة <a href="https://www.google.com.sa/intl/ar/chrome/browser/canary.html">مدونة أخبار الإصدارات الخاصة بكروم</a> لمعرفة آخر التفاصيل.</p> + +<ul dir="rtl"> + <li><a href="https://play.google.com/store/apps/details?id=com.chrome.dev">نسخة كروم التطويريّة للأندرويد</a></li> + <li><a href="https://www.google.com/chrome/browser/canary.html">نسخة كروم كناري لسطح المكتب</a></li> +</ul> diff --git a/files/ar/glossary/gpl/index.html b/files/ar/glossary/gpl/index.html new file mode 100644 index 0000000000..a7d73de893 --- /dev/null +++ b/files/ar/glossary/gpl/index.html @@ -0,0 +1,19 @@ +--- +title: رخصة جنو العمومية +slug: Glossary/GPL +tags: + - ترخيص + - مسرد +translation_of: Glossary/GPL +--- +<p dir="rtl">رخصة جنو العموميّة (GPL) هي رخصة للبرمجيات الحرَّة من نوع رخص {{Glossary("copyleft", "الحقوق المتروكة")}} نُشِرَت من قبل مؤسسة البرمجيات الحرَّة (FSF). يُمنَح مستخدمين البرمجيات المُرخصة بهذه الرخصة حريّة استخدامها، وقراءة شيفرتها المصدرية، وتعديلها وإعادة توزيع التغييرات التي أجروها (الحريات الأربعة) بشرط توفير نسختهم الموزَّعة من البرمجيّة (سواءً كانت معدلة أم غير معدلة) تحت بنود نفس الرخصة (ولهذا تُعرَف بالرخصة الجرثوميّة أو الفيروسيّة لأنها تصيب جميع البرمجيات المشتقة منها "بالعدوة").</p> + +<h2 dir="rtl" id="المزيد_من_التفاصيل">المزيد من التفاصيل</h2> + +<h3 dir="rtl" id="معلومات_عامة">معلومات عامة</h3> + +<ul dir="rtl"> + <li><a href="http://www.gnu.org/licenses/gpl-faq.html">أسئلة شائعة</a> عن رخص جنو</li> + <li>مقالة عن <a href="https://ar.wikipedia.org/wiki/%D8%B1%D8%AE%D8%B5%D8%A9_%D8%AC%D9%86%D9%88_%D8%A7%D9%84%D8%B9%D9%85%D9%88%D9%85%D9%8A%D8%A9">رخصة جنو العمومية</a> في الموسوعة الحرَّة</li> + <li>نص <a href="https://www.gnu.org/licenses/gpl-3.0.ar.html">رخصة جنو العموميّة</a> (<a href="https://ar.wikipedia.org/wiki/%D9%88%D9%8A%D9%83%D9%8A%D8%A8%D9%8A%D8%AF%D9%8A%D8%A7:%D9%86%D8%B5_%D8%B1%D8%AE%D8%B5%D8%A9_%D8%AC%D9%86%D9%88_%D8%A7%D9%84%D8%B9%D9%85%D9%88%D9%85%D9%8A%D8%A9">النسخة العربيّة</a> الغير رسميّة)</li> +</ul> diff --git a/files/ar/glossary/grid_areas/index.html b/files/ar/glossary/grid_areas/index.html new file mode 100644 index 0000000000..5e89defe39 --- /dev/null +++ b/files/ar/glossary/grid_areas/index.html @@ -0,0 +1,78 @@ +--- +title: Grid Areas +slug: Glossary/Grid_Areas +translation_of: Glossary/Grid_Areas +--- +<p>A <strong>grid area</strong> is one or more {{glossary("grid cell", "grid cells")}} that make up a rectangular area on the grid. Grid areas are created when you place an item using <a href="/en-US/docs/Web/CSS/CSS_Grid_Layout/Line-based_Placement_with_CSS_Grid">line-based placement</a> or when defining areas using <a href="/en-US/docs/Web/CSS/CSS_Grid_Layout/Grid_Template_Areas">named grid areas</a>.</p> + +<p><img alt="Image showing a highlighted grid area" src="https://mdn.mozillademos.org/files/14771/1_Grid_Area.png" style="height: 253px; width: 380px;"></p> + +<p>Grid areas <em>must</em> be rectangular in nature; it is not possible to create, for example, a T- or L-shaped grid area.</p> + +<p>In the example below I have a grid container with two grid items. I have named these with the {{cssxref("grid-area")}} property and then laid them out on the grid using {{cssxref("grid-template-areas")}}. This creates two grid areas, one covering four grid cells, the other two.</p> + +<div id="example_1"> +<div class="hidden"> +<pre class="brush: css notranslate">* {box-sizing: border-box;} + +.wrapper { + border: 2px solid #f76707; + border-radius: 5px; + background-color: #fff4e6; +} + +.wrapper > div { + border: 2px solid #ffa94d; + border-radius: 5px; + background-color: #ffd8a8; + padding: 1em; + color: #d9480f; +} +</pre> +</div> + +<pre class="brush: css notranslate">.wrapper { + display: grid; + grid-template-columns: repeat(3,1fr); + grid-template-rows: 100px 100px; + grid-template-areas: + "a a b" + "a a b"; +} +.item1 { + grid-area: a; +} +.item2 { + grid-area: b; +} +</pre> + +<pre class="brush: html notranslate"><div class="wrapper"> + <div class="item1">Item</div> + <div class="item2">Item</div> +</div> +</pre> + +<p>{{ EmbedLiveSample('example_1', '300', '280') }}</p> +</div> + +<h2 id="Learn_More">Learn More</h2> + +<h3 id="Property_reference">Property reference</h3> + +<ul> + <li>{{cssxref("grid-template-columns")}}</li> + <li>{{cssxref("grid-template-rows")}}</li> + <li>{{cssxref("grid-auto-rows")}}</li> + <li>{{cssxref("grid-auto-columns")}}</li> + <li>{{cssxref("grid-template-areas")}}</li> + <li>{{cssxref("grid-area")}}</li> +</ul> + +<h3 id="Further_reading">Further reading</h3> + +<ul> + <li>CSS Grid Layout Guide: <em><a href="/en-US/docs/Web/CSS/CSS_Grid_Layout/Basic_Concepts_of_Grid_Layout">Basic concepts of grid layout</a></em></li> + <li>CSS Grid Layout Guide: <em><a href="https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Grid_Layout/Grid_Template_Areas">Grid template areas</a></em></li> + <li><a href="https://drafts.csswg.org/css-grid/#grid-area-concept">Definition of Grid Areas in the CSS Grid Layout specification</a></li> +</ul> diff --git a/files/ar/glossary/hyperlink/index.html b/files/ar/glossary/hyperlink/index.html new file mode 100644 index 0000000000..c2aff9a198 --- /dev/null +++ b/files/ar/glossary/hyperlink/index.html @@ -0,0 +1,33 @@ +--- +title: رابط +slug: Glossary/Hyperlink +tags: + - ل.ت.ن.ف + - لغة توصيف النص الفائق + - مسرد +translation_of: Glossary/Hyperlink +--- +<p dir="rtl">تَربُط <strong>الروابط</strong> (أو الوصلات) الصفحات العنكبوتيَّة أو عناصر البيانات مع بعضها البعض. يُستخدَم العنصر {{HTMLElement("a")}}، في {{glossary("HTML", "لغة توصيف النص الفائق")}}، لتعريف رابط من نقطة في الصفحة (كنص أو صورة) إلى نقطة في صفحة أخرى (أو حتى في نفس الصفحة).</p> + +<h2 dir="rtl" id="المزيد_من_التفاصيل">المزيد من التفاصيل</h2> + +<h3 dir="rtl" id="معلومات_عامة">معلومات عامة</h3> + +<ul dir="rtl"> + <li>مقالة عن <a href="https://ar.wikipedia.org/wiki/%D8%B1%D8%A7%D8%A8%D8%B7_%D8%AA%D8%B4%D8%B9%D8%A8%D9%8A">الرابط الفائِق</a> في الموسوعة الحرَّة</li> + <li>مقالة عن <a href="/ar/docs/Web/Guide/HTML/Hyperlink">إنشاء الرابط</a> في شبكة مطوري موزيلا</li> +</ul> + +<h3 dir="rtl" id="مراجعة_تقنيّة">مراجعة تقنيّة</h3> + +<ul dir="rtl"> + <li><a href="https://www.w3.org/TR/1999/REC-html401-19991224/struct/links.html">الروابط في مستندات لغة توصيف النص الفائق - رابطة الويب العالميّة</a></li> + <li><a href="https://w3c.github.io/html-reference/a.html">العنصر a في لغة توصيف النص الفائق الإصدار الخامس - الروابط - رابطة الويب العالميّة</a></li> +</ul> + +<h3 dir="rtl" id="تعلَّم_المزيد_عن_الروابط">تعلَّم المزيد عن الروابط</h3> + +<ul dir="rtl"> + <li><a href="/ar/docs/Web/HTML/Element/a">توثيق العنصر <code><a></code> في شبكة مطوري موزيلا</a></li> + <li><a href="/ar/docs/Web/HTML/Element/link">توثيق العنصر <code><link></code> في شبكة مطوري موزيلا</a></li> +</ul> diff --git a/files/ar/glossary/identifier/index.html b/files/ar/glossary/identifier/index.html new file mode 100644 index 0000000000..da321dbda0 --- /dev/null +++ b/files/ar/glossary/identifier/index.html @@ -0,0 +1,18 @@ +--- +title: مُعرِّف +slug: Glossary/Identifier +tags: + - مسرد +translation_of: Glossary/Identifier +--- +<p dir="rtl"><strong>المُعرِّف</strong> (Identifier) هو مجموعة من {{glossary("character", "المحارف")}} تُعرِّف (تُعبِر عن، تُسمي) {{glossary("variable", "متغيّر")}}، {{glossary("function", "دالة")}}، أو {{glossary("property", "خاصيّة")}}.</p> + +<p dir="rtl">في لغة {{glossary("JavaScript", "الجافاسكربت")}}، يُمكِن أن تحتوي المُعرِّفات على أحرف أبجديّة فقط (أو "$" أو "_")، ولايمكن أن تبدأ برقم. يختلف المُعرِّف عن السلسلة النصيّة، بأنَّ الأخيرة عبارة نوع من البيانات، بينما المُعرِّف هو جزء من الشيفرة. لا توجد أيّة طريقة لتحويل المُعرِّفات إلى سلاسل نصيّة في الجافاسكربت، ولكن في بعض الأحيان من الممكن {{glossary("parse", "تحليل")}} السلاسل النصيّة إلى مُعرِّفات.</p> + +<h2 dir="rtl" id="المزيد_من_التفاصيل">المزيد من التفاصيل</h2> + +<h3 dir="rtl" id="معلومات_عامة">معلومات عامة</h3> + +<ul dir="rtl"> + <li>مقالة عن <a href="https://en.wikipedia.org/wiki/Identifier#In_computer_science">المُعرَّف</a> في الموسوعة الحرَّة</li> +</ul> diff --git a/files/ar/glossary/index.html b/files/ar/glossary/index.html new file mode 100644 index 0000000000..39ad063caf --- /dev/null +++ b/files/ar/glossary/index.html @@ -0,0 +1,18 @@ +--- +title: المعجم +slug: Glossary +tags: + - صفحة هبوط + - مبتدئين + - مسرد +translation_of: Glossary +--- +<div class="translate-buttons"> </div> + +<div dir="rtl" style="max-width: 300px; float: left; margin: 0px 1em 0.5em 0px;">{{LearnBox({"title":"تعلَّم مُصطلحاً جديداً:"})}}</div> + +<p dir="rtl"><span class="seoSummary">تحتوي تقنيات الويب على قائمة ضخمة من المصطلحات والاختصارات التي تستخدم في التوثيقات والبرمجة. يهدف المسرد (معجم المصطلحات) إلى توفير تعريفات للكلمات والاختصارات التي تحتاج معرفتها لبناء فهم صحيح للويب وتطويره.</span></p> + +<p><strong><a href="/ar/docs/new?parent=4391">أضف مصطلحاً جديداً إلى المسرد</a></strong></p> + +<p>{{GlossaryList({"split":"h3", "css":"multiColumnList"})}}</p> diff --git a/files/ar/glossary/mozilla_firefox/index.html b/files/ar/glossary/mozilla_firefox/index.html new file mode 100644 index 0000000000..4d23e8e6ab --- /dev/null +++ b/files/ar/glossary/mozilla_firefox/index.html @@ -0,0 +1,26 @@ +--- +title: موزيلا فايرفوكس +slug: Glossary/Mozilla_Firefox +tags: + - فايرفوكس + - مسرد + - موزيلا +translation_of: Glossary/Mozilla_Firefox +--- +<p dir="rtl">موزيلا فايرفوكس هو <span style="line-height: 1.5;">{{Glossary("browser","متصفح")}}</span> حر ومفتوح المصدر، يطوَّر بإشراف مؤسسة موزيلا. يعمل فايرفوكس على أنظمة ويندوز، ماك، لينُكس، وأندوريد.</p> + +<p dir="rtl">أُصدِر فايرفوكس لأوَّل مرَّة في شهر تشرين الثاني عام 2004، فايرفوكس قابل للتخصيص كليّاً بواسطة السِمات (themes)، المُلحقات (plug-ins)، والإضافات (add-تons). يستخدم فايرفوكس مُحرِّك <span style="line-height: 1.5;">{{glossary("Gecko","جيكو")}} لعرض صفحات الويب</span>، ولتطبيق معايير الويب الحاليّة والقادمة.</p> + +<h2 dir="rtl" id="المزيد_من_التفاصيل">المزيد من التفاصيل</h2> + +<h3 dir="rtl" id="معلومات_عامة">معلومات عامة</h3> + +<ul dir="rtl"> + <li><a href="https://www.firefox.com/">الموقع الرسمي لمتصفح موزيلا فايرفوكس</a></li> +</ul> + +<h3 dir="rtl" id="مراجع_تقنيّة">مراجع تقنيّة</h3> + +<ul dir="rtl"> + <li><a href="/ar/Firefox">توثيقات المُتصفح للمطورين على شبكة مطوري موزيلا</a></li> +</ul> diff --git a/files/ar/glossary/oop/index.html b/files/ar/glossary/oop/index.html new file mode 100644 index 0000000000..96cbc24aa9 --- /dev/null +++ b/files/ar/glossary/oop/index.html @@ -0,0 +1,21 @@ +--- +title: OOP +slug: Glossary/OOP +tags: + - شيفرة برمجية + - قاموس المصطلحات + - مبتدئ +translation_of: Glossary/OOP +--- +<p><strong>OOP </strong>(البرمجة الكائنية التوجه) هو نهج في البرمجة حيث يتم تغليف البيانات داخل <strong>{{glossary("كائن","كائنات")}}</strong> ويتم تشغيل الكائن نفسه بدلاً من الأجزاء المكونة له.</p> + +<p>{{glossary("جافا سكريبت")}} كائنية التوجه بشكل كبير. تعتمد على النماذج الأولية' (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Details_of_the_Object_Model#Class-based_vs._prototype-based_languages">بدلا من الأصناف</a>).</p> + +<h2 id="تعلم_المزيد">تعلم المزيد</h2> + +<h3 id="معرفة_عامة">معرفة عامة</h3> + +<ul> + <li>{{Interwiki("wikipedia", "البرمجة الكائنية التوجه")}} على ويكيبيديا</li> + <li><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Introduction_to_Object-Oriented_JavaScript">مقدمة إلى جافا سكريبت كائنية التوجه</a></li> +</ul> diff --git a/files/ar/glossary/parameter/index.html b/files/ar/glossary/parameter/index.html new file mode 100644 index 0000000000..97eda429cf --- /dev/null +++ b/files/ar/glossary/parameter/index.html @@ -0,0 +1,42 @@ +--- +title: وسيط +slug: Glossary/Parameter +tags: + - جافاسكربت + - مسرد +translation_of: Glossary/Parameter +--- +<p dir="rtl"><strong>الوسيط</strong> (بالإنجليزيَّة: Parameter) هو مُتغيِّر مُسمَّى يُمرَّر للدالة {{Glossary("function", "للدالة")}}. تُستخدم الوسيطات (أو الوسطاء) لإرسال المُعطيات إلى الدوال.</p> + +<p dir="rtl">الفرق بين الوسيطات و{{Glossary("argument","المعطيات")}}:</p> + +<ul dir="rtl"> + <li>وسيطات الدالة هي أسماء تُدرَج عند تعريفها.</li> + <li>مُعطيات الدالة هي القيمة الفعليَّة المُمرَّرة إلى الدالة.</li> + <li>تُسنَد للوسيطات قيم المُعطيات المُمرَّرة.</li> +</ul> + +<p dir="rtl">يوجد نوعين من الوسيطات:</p> + +<dl> + <dt dir="rtl">وسيطات الإدخال</dt> + <dd dir="rtl">وهي أكثر الأنواع شيوعًا. تُمرِّر هذه الوسيطات القيم إلى الدوال. اعتمادًا على لغة البرمجة المُستخدمة، تتعدّد طُرُق تمرير وسيطات الإدخال (كالاستدعاء عبر القيمة أو العنوان أو المرجع).</dd> + <dt dir="rtl">معاملات الإخراج أو الإعادة</dt> + <dd dir="rtl">مهمتها الأساسيّة إعادة عدّة قيم من الدالة، إلّا أنَّه لا يُحبَّذ فعل ذلك لِما يُسبِّب من مشكلات.</dd> +</dl> + +<h2 dir="rtl" id="المزيد_من_التفاصيل">المزيد من التفاصيل</h2> + +<h3 dir="rtl" id="معلومات_عامة">معلومات عامة</h3> + +<ul dir="rtl"> + <li><a href="http://en.wikipedia.org/wiki/Parameter_%28computer_programming%29#Parameters_and_arguments">الفرق بين الوسيط والمُعطى</a> في الموسوعة الحرَّة</li> +</ul> + +<h3 dir="rtl" id="مراجع_تقنيّة">مراجع تقنيّة</h3> + +<ul dir="rtl"> + <li><a href="http://pages.cs.wisc.edu/~hasti/cs368/CppTutorial/NOTES/PARAMS.html">أوضاع تمرير الوسيطات</a></li> + <li><a href="http://www.ryerson.ca/JavaScript/lectures/functions/passByValueOrReference.html">وسيطات الدوال في الجافاسكربت</a></li> + <li><a href="http://javascript.about.com/library/bltut08.htm">تمرير الوسيطات في الجافاسكربت</a></li> +</ul> diff --git a/files/ar/glossary/php/index.html b/files/ar/glossary/php/index.html new file mode 100644 index 0000000000..158a3223ae --- /dev/null +++ b/files/ar/glossary/php/index.html @@ -0,0 +1,49 @@ +--- +title: PHP +slug: Glossary/PHP +tags: + - PHP + - المعجم +translation_of: Glossary/PHP +--- +<p class="simple-translate-result" dir="rtl" style="color: rgb(0, 0, 0);">تعد لغة PHP بدائية متكررة (PHP: Hypertext Preprocessor) لغة برمجة نصية من جانب الخادم مفتوحة المصدر (open-source server-side scripting language) يمكن تضمينها في HTML لإنشاء تطبيقات الويب والمواقع الديناميكية.</p> + +<h2 dir="rtl" id="أمثلة">أمثلة</h2> + +<h3 dir="rtl" id="بناء_الجملة_الأساسية">بناء الجملة الأساسية</h3> + +<pre class="brush: php"> // start of PHP code +<?php + // PHP code goes here + ?> +// end of PHP code</pre> + +<h3 dir="rtl" id="طباعة_البيانات_على_الشاشة">طباعة البيانات على الشاشة</h3> + +<pre class="brush: php"><?php + echo "Hello World!"; +?></pre> + +<h3 dir="rtl" id="متغيرات_PHP">متغيرات PHP</h3> + +<pre class="brush: php"><?php + // variables + $nome='Danilo'; + $sobrenome='Santos'; + $pais='Brasil'; + $email='danilocarsan@gmailcom'; + + // printing the variables + echo $nome; + echo $sobrenome; + echo $pais; + echo $email; +?></pre> + +<h2 dir="rtl" id="أعرف_أكثر">أعرف أكثر</h2> + +<ul> + <li><a href="http://php.net/">الموقع الرسمي</a></li> + <li>{{Interwiki("wikipedia", "PHP")}} على ويكيبيديا</li> + <li><a href="https://en.wikibooks.org/wiki/PHP_Programming">PHP</a> on Wikibooks</li> +</ul> diff --git a/files/ar/glossary/recursion/index.html b/files/ar/glossary/recursion/index.html new file mode 100644 index 0000000000..6c6e98a0ac --- /dev/null +++ b/files/ar/glossary/recursion/index.html @@ -0,0 +1,17 @@ +--- +title: معاودة +slug: Glossary/Recursion +tags: + - مسرد +translation_of: Glossary/Recursion +--- +<p dir="rtl"><strong>المعاودة</strong> (أو الاستدعاء الذاتي) هي إجراء استدعاء الدالة لنفسها. تُستخدم المعاودة لحل مشاكل تحتوي مشاكل فرعيّة أصغر. يمكن أن تستقبل الدالة العوديّة نوعين من المدخلات: المدخلات الأساسيّة (عندما ينتهي التكرار - المعاودة -) ومدخلات عوديّة (عندما يكون التكرار سارياً).</p> + +<h2 dir="rtl" id="المزيد_من_التفاصيل">المزيد من التفاصيل</h2> + +<h3 dir="rtl" id="معلومات_عامة">معلومات عامة</h3> + +<ul dir="rtl"> + <li>مقالة عن <a href="https://ar.wikipedia.org/wiki/%D8%A7%D8%B3%D8%AA%D8%AF%D8%B9%D8%A7%D8%A1_%D8%B0%D8%A7%D8%AA%D9%8A_(%D8%B9%D9%84%D9%85_%D8%A7%D9%84%D8%AD%D8%A7%D8%B3%D9%88%D8%A8)">الاستدعاء الذاتي</a> في الموسوعة الحرَّة</li> + <li><a href="/ar/docs/Web/JavaScript/Guide/Functions#Recursion">المزيد من التفاصيل عن المعاودة في لغة الجافاسكربت</a></li> +</ul> diff --git a/files/ar/glossary/rendering_engine/index.html b/files/ar/glossary/rendering_engine/index.html new file mode 100644 index 0000000000..de82aa4114 --- /dev/null +++ b/files/ar/glossary/rendering_engine/index.html @@ -0,0 +1,23 @@ +--- +title: محرك العرض +slug: Glossary/Rendering_engine +tags: + - مسرد +translation_of: Glossary/Rendering_engine +--- +<p dir="rtl"><strong>مُحرِّك العرض</strong> هو البرمجيّة التي ترسم النصوص والصور على الشاشة. يرسم المُحرِّك النص المُنظَم من مستند (مثل مستند {{glossary("HTML", "لغة ترميز النص الفائق")}}) ويقوم بتنسيقه بناءً على التصميم المُعرَّف من قبل المطوَّر (باستخدام تقنيّة مثل {{glossary("CSS", "صفحات الأنماط الانسيابية")}}). أمثلة على محركات العرض: {{glossary("Blink", "بلينك")}}، و{{glossary("Gecko", "جيكو")}}، وإيدج (edge)، و{{glossary("WebKit", "ويب كيت")}}.</p> + +<h2 dir="rtl" id="المزيد_من_التفاصيل">المزيد من التفاصيل</h2> + +<h3 dir="rtl" id="معلومات_عامة">معلومات عامة</h3> + +<ul dir="rtl"> + <li>مقالة عن <a href="https://ar.wikipedia.org/wiki/%D9%85%D8%AD%D8%B1%D9%83_%D8%AA%D8%B5%D9%85%D9%8A%D9%85">محرك التصميم</a> في الموسوعة الحرَّة</li> +</ul> + +<h3 dir="rtl" id="مراجع_تقنيّة">مراجع تقنيّة</h3> + +<ul dir="rtl"> + <li><a href="/ar/docs/Mozilla/Gecko">توثيق مُحرِّك القوالب جيكو</a></li> + <li><a href="https://medium.com/@ramsunvtech/behind-browser-basics-part-1-b733e9f3c0e6">مقالة ما وراء الستار في المُتصفحات (الجزء الأوّل، الأساسيات)</a></li> +</ul> diff --git a/files/ar/glossary/search_engine/index.html b/files/ar/glossary/search_engine/index.html new file mode 100644 index 0000000000..a914aefd11 --- /dev/null +++ b/files/ar/glossary/search_engine/index.html @@ -0,0 +1,29 @@ +--- +title: باحوث +slug: Glossary/Search_engine +tags: + - باحوث + - مسرد +translation_of: Glossary/Search_engine +--- +<p dir="rtl"><strong>الباحوث</strong> (اسم الآلة من الفعل بحثَ على زِنة فاعول، أو مُحرِّك البحث) هو منظومة برمجيّة تجمع البيانات من {{Glossary("World Wide Web", "الشبكة العنكبوتيَّة")}} وتعرضها للمستخدمين الباحثين عن معلومات معينة.</p> + +<p dir="rtl">يُجري الباحوث العمليات التالية لتأدية عمله:</p> + +<ul dir="rtl"> + <li><strong>تمشيط الشبكة</strong> (crawling): البحث في المواقع عبر تصفُّح {{Glossary("Hyperlinks", "الروابط")}} في داخل الصفحات العنكبوتيَّة وبينها. بإمكان مالك الموقع مَنع المُمشِّطات العنكبوتيَّة (أو العناكِب) من دخول بعض المناطِق في موقعه، وذلك عبر التعليمة "robot exclusion" في الملف <code>robots.txt</code>.</li> + <li><strong>الفهرسة</strong>: ربط كلمات مفتاحيَّو ومعلومات أخرى بالصفحات التي مُشِّطَت. هذا يُمكِّن المُستخدمين من إيجاد صفحات مُتعلقة بأقصى سرعة ممكنة.</li> + <li><strong>البحث</strong>: إيجاد الصفحات المتعلقة اعتمادًا على الاستعلامات المؤلفة من الكلمات المفتاحيّة وغيرها من الأوامر المُدخلة إلى الباحوث. يعثر<span id="result_box" lang="ar"><span> الباحوث عن روابط الصفحات المطابقة للاستعلام، ويرتبها حسب مدى ملاءمتها،</span> <span>ومن ثم يعرض النتائج للمستخدم مُرتَّبةً.</span></span></li> +</ul> + +<p dir="rtl">يعد جوجل أكثر البواحيث شعبيّةً. توجد كذلك بواحيث أخرى مشهورة، كياهو وبينج.</p> + +<h2 id="المزيد_من_التفاصيل">المزيد من التفاصيل</h2> + +<h3 id="معلومات_عامة">معلومات عامة</h3> + +<ul dir="rtl"> + <li>مقالة عن <a href="https://en.wikipedia.org/wiki/Web_search_engine">الباحوث</a> في الموسوعة الحرَّة</li> + <li>مقالة عن <a href="http://www.webopedia.com/TERM/S/search_engine.html">الباحوث</a> في ويبوبيديا</li> + <li>مقالة "<a href="https://computer.howstuffworks.com/internet/basics/search-engine.htm">كيف تعمل البواحيث</a>" في موقع HowStuffWorks</li> +</ul> diff --git a/files/ar/glossary/semantics/index.html b/files/ar/glossary/semantics/index.html new file mode 100644 index 0000000000..699c9192c9 --- /dev/null +++ b/files/ar/glossary/semantics/index.html @@ -0,0 +1,75 @@ +--- +title: دلالات semantics +slug: Glossary/Semantics +tags: + - لغة ترميز النص الفائق + - مسرد +translation_of: Glossary/Semantics +--- +<p dir="rtl">في البرمجة فأن كلمة semantics تشير الى معنى قطعه من الكود code. اليوم نتحدث عن معنى العناصر وليس مظهرها. هذا الموضوع الشيق يأخذنا الى ابعد من ذلك من خلال تركيز على معنى كتابة الكود code. وطرح تسائل مهم هو "ماهو تأثير هذا السطر عندما نقوم بتنفيذ الايعاز؟" وربما يأخذنا الى ابعد من ذلك بقليل "ماهو الغرض او الدور الذي يلعبة هذا العنصر في الـ html ؟".</p> + +<p dir="rtl">دعنا نأخذ العنصر {{htmlelement("h1")}} كمثال تطبيقي، فهو عنصر دلالي semantics يقوم بإعطاء النص الذي يحيطه القدرة على أن يؤدي دور (أو وظيفة) "مستوى العنونة الأوّل في صفحتك" (أي أوَّل عنوان رئيسي في الصفحة).</p> + +<pre class="brush: html notranslate"><h1>هذا مستوى العنونة الأوّل</h1></pre> + +<p dir="rtl">يُنسَّق العنصر السابق، إفتراضياً، بحجم خط كبير لجعله عنواناً (بالرغم من أنَّه يمكنك إعادة تصميمه وتنسيقه لتغيير شكله جذرياً)، ولكن الأكثر أهميّة من شكله هو القيمة الدلاليّة (semantic) التي يحملها هذا العنصر ويمكن استخدامها في طرق متعددة، كاستخدامها من قبل محركات البحث عبر اعتبار هذا الجزء من المحتوى (العنوان) كلمة مفتاحيّة مهمة ستُؤثِر على ترتيب الموقع في نتائج البحث (طالع مصطلح {{Glossary("SEO", "تحسين محركات البحث")}})، أو كاستخدام قيمة العنوان الدلاليّة من قبل قارئِات الشاشة كإشارة (أو ما يسمى بعلامة الإرشاد) لمساعدة المستخدمين المتضررين بصرياً على التنقل بين محتويات الصفحة.</p> + +<p dir="rtl">على الرغم من كل ما سبق، يمكنك جعل أي عنصر <em>يبدو</em> كعنوان ذو درجة عنونة أولى. دعنا نأخذ المثال أدناه على سبيل المثال:</p> + +<pre class="brush: html notranslate"><span style="font-size: 32px; margin: 21px 0;">هل هذا مستوى العنونة الأوّل؟</span></pre> + +<p dir="rtl">سيُعرَض هذا العنصر في المتصفح كعنوان من الدرجة الأولى، ولكنه لن يحمل أي قيمة دلاليّة، وبالتالي لن تستفيد من الفوائد الإضافيّة التي تضفيها هذه القيمة كما شُرِحَ أعلاه. وبالتالي، من الأفضل استخدام عنصر ل.ت.ن.ف الصحيح في المكان الصحيح لإنجاز المهمة المخصص لها.</p> + +<p dir="rtl"></p> + +<h2 dir="rtl" id="الـ_semantics_و_الجافا_سكربت_javaScript">الـ semantics و الجافا سكربت javaScript</h2> + +<p dir="rtl">لنفهم الـ semantics في الجافا سكربت javaScript علينا ان نأخذ مثال يقوم بانشاء عنصر ولنقل مثلا عنصر <a href="/en-US/docs/docs/Web/HTML/Element/li"><li></a>. الدالة function التي تقوم بهذا الامر تقوم بأرجاع هذا العنصر ونحن نقوم فقط بارسال محتوى العنصر textContent. حسناً اذا اسمينا الدالة باسم build وقمنا باستخدامها : </p> + +<pre dir="rtl">build('Peach'); +</pre> + +<p dir="rtl">بالتأكيد لم تسطيع فهم عمل هذه الدالة الى في حالة رؤية الكود الداخلي الخاص بها. او البعض يحل المشكلة باستخدام التعليقات comments . وهذا حل ليس مثاليا. </p> + +<p dir="rtl">الحال المثالي ان تجعل اسم الدالة يدعى على عملها. بهذا حققت غالية الـ semantics ولا تحتاج الى سطر اضافي لتعليقات comments: </p> + +<pre class="notranslate">createLiWithContent('Peach') +</pre> + +<p dir="rtl">برأيك من هو الاحلى والافضل الدالة build او createLiWithContent ؟!!! </p> + +<h2 dir="rtl" id="عناصر_دلاليّة">عناصر دلاليّة</h2> + +<p dir="rtl">يوجد أدناه بعض من عناصر ل.ت.ن.ف الدلاليّة (مأخوذة <a href="http://www.w3schools.com/html/html5_semantic_elements.asp">من هنا</a>):</p> + +<ul> + <li>{{htmlelement("article")}}</li> + <li>{{htmlelement("aside")}}</li> + <li>{{htmlelement("details")}}</li> + <li>{{htmlelement("figcaption")}}</li> + <li>{{htmlelement("figure")}}</li> + <li>{{htmlelement("footer")}}</li> + <li>{{htmlelement("header")}}</li> + <li>{{htmlelement("main")}}</li> + <li>{{htmlelement("mark")}}</li> + <li>{{htmlelement("nav")}}</li> + <li>{{htmlelement("section")}}</li> + <li>{{htmlelement("summary")}}</li> + <li>{{htmlelement("time")}}</li> +</ul> + +<h2 dir="rtl" id="المزيد_من_التفاصيل">المزيد من التفاصيل</h2> + +<h3 dir="rtl" id="معلومات_عامة">معلومات عامة</h3> + +<ul dir="rtl"> + <li>مقالة عن <a href="https://ar.wikipedia.org/wiki/%D8%B9%D9%84%D9%85_%D8%A7%D9%84%D9%85%D8%B9%D8%A7%D9%86%D9%8A_(%D9%84%D8%B3%D8%A7%D9%86%D9%8A%D8%A7%D8%AA)#%D9%81%D9%8A_%D8%A7%D9%84%D8%A8%D8%B1%D9%85%D8%AC%D8%A9">علم المعاني</a> في الموسوعة الحرَّة</li> +</ul> + +<h3 dir="rtl" id="مراجع_تقنيّة">مراجع تقنيّة</h3> + +<ul dir="rtl"> + <li><a href="/ar/docs/Web/HTML/Element#Inline_text_semantics">مرجع عناصر ل.ت.ن.ف</a> في شبكة مطوري موزيلا</li> + <li>مقالة "<a href="/ar/docs/Web/Guide/HTML/Using_HTML_sections_and_outlines#Problems_solved_by_HTML5">استخدام الحدود والأقسام في ل.ت.ن.ف</a>" في شبكة مطوري موزيلا</li> + <li>مقالة "<a href="http://www.w3schools.com/html/html5_semantic_elements.asp">عناصر ل.ت.ن.ف الدلاليّة</a>" من موقع w3schools</li> +</ul> diff --git a/files/ar/glossary/server/index.html b/files/ar/glossary/server/index.html new file mode 100644 index 0000000000..9e99905209 --- /dev/null +++ b/files/ar/glossary/server/index.html @@ -0,0 +1,30 @@ +--- +title: خادم +slug: Glossary/Server +tags: + - خادم + - خادوم + - شبكات + - مسرد +translation_of: Glossary/Server +--- +<p dir="rtl"><strong>الخادِم</strong> (ويُقال عن الجهاز <strong>خادوم</strong>) هو برمجيّة تُقدِّم خدمة للمستخدم، أو ما يُسمى بالزبون. الخادوم هو حاسوب مُشترَك على الشبكة، يُشغَّل ويُستضاف غالبًا في مراكز البيانات. الخادم هو برنامج يُقدِم الخدمات لبرامج الزئائِن أو {{glossary("UI","واجهة مُستخدم")}} للزبائِن من البشر.</p> + +<p dir="rtl">تُقدَم هذه الخدمات عامةً عبر الشبكات المحليّة أو الشبكات واسعة النطاق مثل الشابكة العالميَّة. يتواصل برنامج الزبون والخادم عبر إرسال رسائل مُرمَّزِة بواسطة {{glossary("protocol", "ميثاق")}} من خلال {{glossary("API", "واجهة برمجيّة")}}.</p> + +<p dir="rtl">أمثلة على الخوادم والخواديم:</p> + +<ul dir="rtl"> + <li>تُرسِل الخوادم العنكبوتيَّة ملفات {{glossary("HTML", "لغة توصيف النص الفائق")}} إلى {{glossary("browser", "مُتصفِحَك")}} حتّى تتمكن من قراءتها.</li> + <li>خوادم الشبكة المحليّة للملفات والبريد والطباعة والناسوخ.</li> + <li>الحواسيب الصغيرة والكبيرة والفائقة في مراكز البيانات.</li> +</ul> + +<h2 dir="rtl" id="المزيد_من_التفاصيل">المزيد من التفاصيل</h2> + +<h3 dir="rtl" id="معلومات_عامة">معلومات عامة</h3> + +<ul dir="rtl"> + <li><a href="/ar/Learn/What_is_a_web_server">مقدمة عن الخوادم</a></li> + <li>مقالة عن <a href="https://ar.wikipedia.org/wiki/%D8%AE%D8%A7%D8%AF%D9%85_(%D8%AD%D9%88%D8%B3%D8%A8%D8%A9)">الخادم</a> في الموسوعة الحرَّة</li> +</ul> diff --git a/files/ar/glossary/string/index.html b/files/ar/glossary/string/index.html new file mode 100644 index 0000000000..e14d0150fe --- /dev/null +++ b/files/ar/glossary/string/index.html @@ -0,0 +1,20 @@ +--- +title: سلسلة نصيّة +slug: Glossary/String +tags: + - مبتدئين + - مسرد +translation_of: Glossary/String +--- +<p dir="rtl" id="Summary">في أيّة لغة برمجة، <strong>السلسلة النصيّة</strong> (string) هي عبارة عن مجموعة من {{Glossary("character","المحارف")}} تُستخَدم لتمثيل نص ما.</p> + +<p dir="rtl">في لغة الجافاسكربت، السلسلة النصيّة هي إحدى {{Glossary("Primitive", "القيم البدائيّة")}} والكائن {{jsxref("String")}} هو {{Glossary("wrapper", "غلاف")}} لهذا النوع البدائي.</p> + +<h2 dir="rtl" id="المزيد_من_التفاصيل">المزيد من التفاصيل</h2> + +<h3 dir="rtl" id="معلومات_عامة">معلومات عامة</h3> + +<ul dir="rtl"> + <li>مقالة عن <a href="https://ar.wikipedia.org/wiki/%D8%B3%D9%84%D8%B3%D9%84%D8%A9_(%D8%B9%D9%84%D9%85_%D8%A7%D9%84%D8%AD%D8%A7%D8%B3%D9%88%D8%A8)">السلسلة</a> في الموسوعة الحرَّة</li> + <li><a href="/ar/docs/Web/JavaScript/Data_structures#String_type">أنواع وهياكل البيانات في لغة الجافاسكربت</a></li> +</ul> diff --git a/files/ar/glossary/tag/index.html b/files/ar/glossary/tag/index.html new file mode 100644 index 0000000000..65f3e0fc21 --- /dev/null +++ b/files/ar/glossary/tag/index.html @@ -0,0 +1,24 @@ +--- +title: وسم +slug: Glossary/Tag +tags: + - لغة ترميز النص الفائق + - مسرد +translation_of: Glossary/Tag +--- +<p dir="rtl">في سياق {{Glossary("HTML", "لغة ترميز النص الفائق")}}، يُستخدَم الوسم لإنشاء {{Glossary("element", "العنصر")}}. اسم العنصر هو الاسم الذي يُستخدم بين قوسين معقوفين، كمثال، الوسم `<p>` الذي يُستخدم لإنشاء الفقرات. لاحظ أنَّ الاسم في وسم الإغلاق مسبوق بمائلة (`<p/>`). لا يجب وضع وسم إغلاق في الوسوم المفردة (ذاتية الإغلاق - التي تتكون من وسم واحد). إذا كانت {{Glossary("Attribute", "خاصيات")}} الوسم غير مذكورة عند تعريفه، ستستخدم القيمة الإفتراضية لكل خاصية.</p> + +<h2 dir="rtl" id="المزيد_من_التفاصيل"><strong>المزيد من التفاصيل</strong></h2> + +<h3 dir="rtl" id="معلومات_عامة">معلومات عامة</h3> + +<ul dir="rtl"> + <li>مقالة عن <a href="https://ar.wikipedia.org/wiki/%D9%88%D8%B3%D9%85_(%D9%84%D8%BA%D8%A9_%D8%AA%D8%B1%D9%85%D9%8A%D8%B2_%D8%A7%D9%84%D9%86%D8%B5_%D8%A7%D9%84%D9%81%D8%A7%D8%A6%D9%82)">العنصر</a> في الموسوعة الحرَّة</li> + <li><a href="http://www.w3.org/History/19921103-hypertext/hypertext/WWW/MarkUp/Tags.html">وسوم لغة ترميز النص الفائق في رابطة الويب العالمية</a></li> +</ul> + +<h3 dir="rtl" id="مراجع_تقنيّة">مراجع تقنيّة</h3> + +<ul dir="rtl"> + <li><a href="/ar/docs/Learn/HTML/Introduction_to_HTML">مقدمة إلى لغة ترميز النص الفائق</a></li> +</ul> diff --git a/files/ar/glossary/variable/index.html b/files/ar/glossary/variable/index.html new file mode 100644 index 0000000000..bece718d50 --- /dev/null +++ b/files/ar/glossary/variable/index.html @@ -0,0 +1,24 @@ +--- +title: متغيّر +slug: Glossary/Variable +tags: + - جافاسكربت + - مسرد +translation_of: Glossary/Variable +--- +<p dir="rtl">المتغيّر هو مكان في الذاكرة لتخزين {{Glossary("Value", "القيم")}} (البيانات). باستخدام هذه التقنيّة يُمكِن الوصول لقيمة مُتقلِّبة (متغيّرة) من خلال اسم مذكور سلفاً.</p> + +<h2 dir="rtl" id="المزيد_من_التفاصيل">المزيد من التفاصيل</h2> + +<h3 dir="rtl" id="معلومات_عامة">معلومات عامة</h3> + +<ul dir="rtl"> + <li>مقالة عن <a href="https://ar.wikipedia.org/wiki/متغير_(علم_الحاسوب)">المتغيّر</a> في الموسوعة الحرَّة</li> +</ul> + +<h3 dir="rtl" id="مراجع_تقنيّة">مراجع تقنيّة</h3> + +<ul dir="rtl"> + <li><a href="/ar/docs/Web/JavaScript/Guide/Grammar_and_types#Declarations">تعريف المتغيّرات في الجافاسكربت</a></li> + <li><a href="/ar/docs/Web/JavaScript/Reference/Statements/var">العبارة var في الجافاسكربت</a></li> +</ul> diff --git a/files/ar/glossary/wai/index.html b/files/ar/glossary/wai/index.html new file mode 100644 index 0000000000..5d0e1bf329 --- /dev/null +++ b/files/ar/glossary/wai/index.html @@ -0,0 +1,18 @@ +--- +title: مبادرة الإتاحة الويبية +slug: Glossary/WAI +tags: + - إتاحة + - مسرد +translation_of: Glossary/WAI +--- +<p dir="rtl">مبادرة الإتاحة الويبيّة (أو WAI كاختصار) هي مبادرة تقودها رابطة الويب العالمية لتحسين الإتاحة (accessibility) للأشخاص ذوي الحالات الخاصة المتنوعة، والذين قد يحتاجون إلى {{Glossary("browser", "متصفحات")}} أو أجهزة مخصصة (غير قياسية).</p> + +<h2 dir="rtl" id="المزيد_من_التفاصيل">المزيد من التفاصيل</h2> + +<h3 dir="rtl" id="معلومات_عامة">معلومات عامة</h3> + +<ul dir="rtl"> + <li><a href="http://www.w3.org/WAI/">موقع المبادرة</a></li> + <li>مقالة عن <a href="https://en.wikipedia.org/wiki/Web_Accessibility_Initiative">المبادرة</a> في الموسوعة الحرَّة (باللغة الإنجليزية. يرجى النظر بالمساهمة بترجمتها).</li> +</ul> diff --git a/files/ar/glossary/wrapper/index.html b/files/ar/glossary/wrapper/index.html new file mode 100644 index 0000000000..ebfecad2ff --- /dev/null +++ b/files/ar/glossary/wrapper/index.html @@ -0,0 +1,17 @@ +--- +title: غلاف +slug: Glossary/Wrapper +tags: + - غلاف + - مسرد +translation_of: Glossary/Wrapper +--- +<p dir="rtl">في لغات البرمجة المشابهة للجافاسكربت، الغلاف (wrapper) هو دالة تهدف إلى استدعاء دالة أو أكثر أخرى، أحياناً لتسهيل عملها (أي راحة أكثر بالتعامل)، وأحياناً لتعديلها لكي تجري مهمة مختلفة قليلاً أثناء عملها.</p> + +<p dir="rtl">بمعنى آخر، يُستخدَم الغلاف لاستدعاء دالة من أجل تعديل شيء فيها، سواءً كان هذا الشيء متعلقاً بسهولة استخدامها، أو بوظيفتها.</p> + +<h2 dir="rtl" id="المزيد_من_التفاصيل">المزيد من التفاصيل</h2> + +<h3 dir="rtl" id="معلومات_عامة">معلومات عامة</h3> + +<p dir="rtl">مقالة عن <a href="https://en.wikipedia.org/wiki/Wrapper_function">الدوال المُغلِّفة</a> في الموسوعة الحرَّة (باللغة الإنجليزيّة، يرجى النظر بالمساهمة)</p> diff --git a/files/ar/glossary/الحروف/index.html b/files/ar/glossary/الحروف/index.html new file mode 100644 index 0000000000..47443563a1 --- /dev/null +++ b/files/ar/glossary/الحروف/index.html @@ -0,0 +1,20 @@ +--- +title: الحروف +slug: Glossary/الحروف +translation_of: Glossary/Character +--- +<p dir="rtl">الحرف هي إما "رمز" (حروف ، أرقام ، علامات ترقيم) أو "تحكم" غير طباعي (على سبيل المثال ، رمز الإرجاع أوخطّ وصل).</p> + +<p dir="rtl">{{glossary ("UTF-8")}} هي مجموعة الأحرف الأكثر شيوعًا وتتضمن حروفًا لغوية من أشهر اللغات البشرية.</p> + +<h2 dir="rtl" id="لمعرفة_المزيد">لمعرفة المزيد</h2> + +<h3 dir="rtl" id="معلومات_عامة">معلومات عامة</h3> + +<ul> + <li dir="rtl">{{interwiki("wikipedia", "Character (computing)")}} على Wikipedia</li> + <li dir="rtl">{{interwiki("wikipedia", "Character encoding")}} على Wikipedia</li> + <li dir="rtl">{{interwiki("wikipedia", "ASCII")}} على Wikipedia</li> + <li dir="rtl">{{interwiki("wikipedia", "UTF-8")}} على Wikipedia</li> + <li dir="rtl">{{interwiki("wikipedia", "Unicode")}} على Wikipedia</li> +</ul> diff --git a/files/ar/glossary/الخاصية/index.html b/files/ar/glossary/الخاصية/index.html new file mode 100644 index 0000000000..3d197d0c39 --- /dev/null +++ b/files/ar/glossary/الخاصية/index.html @@ -0,0 +1,20 @@ +--- +title: الخاصية +slug: Glossary/الخاصية +translation_of: Glossary/property +--- +<p dir="rtl"><span class="tlid-translation translation"><span title="">يمكن أن يكون لمصطلح ال</span></span>خاصية<span class="tlid-translation translation"><span title=""> عدة معاني حسب السياق.</span> <span title="">قد يشير إلى:</span></span></p> + +<ul dir="rtl"> + <li><strong><span class="tlid-translation translation"><span title="">خاصية (CSS)</span></span></strong></li> +</ul> + +<p dir="rtl"><span class="tlid-translation translation"> <strong> ال</strong><span title=""><strong>خاصية CSS</strong> هي خاصية مميزة (مثل اللون) تحدد القيمة المرتبطة بها جانبًا واحدًا من كيفية عرض المتصفح للعنصر.</span></span></p> + +<ul dir="rtl"> + <li><strong><span title="">خاصية (JavaScript)</span></strong></li> +</ul> + +<p dir="rtl"><span class="tlid-translation translation"> <span title="">تعد<strong> خاصية JavaScript</strong> إحدى خصائص الكائن ، وغالبًا ما تصف السمات المرتبطة ببنية البيانات.</span></span></p> + +<p>{{GlossaryDisambiguation}}</p> diff --git a/files/ar/glossary/الدوال_من_الدرجة_الأولى/index.html b/files/ar/glossary/الدوال_من_الدرجة_الأولى/index.html new file mode 100644 index 0000000000..405e49ea6b --- /dev/null +++ b/files/ar/glossary/الدوال_من_الدرجة_الأولى/index.html @@ -0,0 +1,14 @@ +--- +title: الدوال من الدرجة الأولى +slug: Glossary/الدوال_من_الدرجة_الأولى +translation_of: Glossary/First-class_Function +--- +<p dir="rtl">يقال عن لغة البرمجة أنها تملك <strong>دوال من الدرجة الأولى</strong> عندما تعامل هذه الدوال في تلك اللغة كأي متغير أخر. على سبيل المثال، في تلك اللغات، يمكن أن تمرر الدالة كمعامل لدالة أخرى، ويمكن أن يتم إرجاعها من قبل دالة أخرى، ويمكن تعيينها كقيمة لمتغير.</p> + +<h2 dir="rtl" id="تعلم_المزيد">تعلم المزيد</h2> + +<h3 dir="rtl" id="معلومات_عامة">معلومات عامة</h3> + +<ul dir="rtl"> + <li>مقالة <a href="https://en.wikipedia.org/wiki/First-class_function">الدوال من الدرجة الأولى</a> في ويكيبيديا.</li> +</ul> diff --git a/files/ar/glossary/الكائنات/index.html b/files/ar/glossary/الكائنات/index.html new file mode 100644 index 0000000000..01f15f9478 --- /dev/null +++ b/files/ar/glossary/الكائنات/index.html @@ -0,0 +1,24 @@ +--- +title: كائن +slug: Glossary/الكائنات +tags: + - كائن + - مسرد +translation_of: Glossary/Object +--- +<p><strong>الكائِن</strong> (بالإنجليزيَّة: Object) يشير إلى هيكل بيانات يحوي بيانات وتعليمات للتعامل مع البيانات. تُشير الكائِنات أحيانًا إلى أشياء حقيقيَّة، كالكائِن <code>car</code> أو <code>map</code> المُعرَّف في لعبة سباق. تُعد لغة {{glossary("JavaScript", "الجافاسكربت")}} والجافا والسي++ وبايثون وروبي من الأمثلة على لغات {{glossary("OOP","البرمجة الكائنيَّة")}}.</p> + +<h2 id="المزيد_من_التفاصيل">المزيد من التفاصيل</h2> + +<h3 id="معلومات_عامة">معلومات عامة</h3> + +<ul> + <li dir="rtl">مقالة عن البرمجة الكائنيَّة في الموسوعة الحرَّة</li> +</ul> + +<h3 id="مراجع_تقنيَّة">مراجع تقنيَّة</h3> + +<ul> + <li>البانية {{jsxref("Object")}} في <a href="/en-US/docs/Web/JavaScript/Reference">مرجع لغة الجافاسكربت </a></li> + <li><a href="/en-US/docs/Web/JavaScript/Data_structures#Objects">الكائِن كهيكل بيانات في لغة الجافاسكربت</a></li> +</ul> diff --git a/files/ar/glossary/المجالات/index.html b/files/ar/glossary/المجالات/index.html new file mode 100644 index 0000000000..b2c80924a5 --- /dev/null +++ b/files/ar/glossary/المجالات/index.html @@ -0,0 +1,43 @@ +--- +title: المجالات +slug: Glossary/المجالات +translation_of: Glossary/Scope +--- +<p>تعبر عن سياق التنفيذ الحالي للبرنامج والذي يمكنك فيه الوصول لقيم المتغيرات والتوابع واستعمالها. فإذا تم البحث عن متغير او تابع خارج المجال (أو سياق التنفيذ) الحالي وتبين أنّه غير موجود فلن تستطيع الوصول إليه واستعماله. وتتشكل هذه المجالات بشكل هرمي (أو دائري بشرط لايوجد دائرتين متقاطعتين وكل الدوائر محتواة في بعضها البعض) بحيث ان المجال الداخلي (أو الدائرة الداخلية) الابن يستطيع الوصول لمجال الأب (الدائرة التي تحتويه) ولكن العكس غير ممكن.</p> + +<p><img alt="nested scopes intro in javascript" src="https://mdn.mozillademos.org/files/16465/nestedScopesInJS.png" style="height: 498px; width: 461px;"></p> + +<p>التوابع (<strong>{{glossary("function")}})</strong> في {{glossary("JavaScript")}} تستعمل لإنشاء مجالات جديدة (كل تابع يمثل مجال جديد خاص به) فعلى سبيل المثال,إن تعريف متغير داخل التابع لن يمكنك من استعماله داخل تابع آخر او من اي مجال خارج هذا التابع, وهذا مثال يوضح لك الفكرة:</p> + +<pre class="syntaxbox">function exampleFunction() { + + // هذا المتغير لا يمكن استعماله إلا ضمن التابع الحالي فقط + // او أي تابع محتوى داخله + var x = "متغير داخل التابع"; + console.log("داخل التابع"); + console.log(x); +} + +console.log(x); // لا يمكن الوصول للمتغير من الخارج</pre> + +<p>بينما يستطيع التابع الوصول للمتغيرات المعرفة في مجال يقع خارجه او في المجال العام للبرنامج الخاص بك</p> + +<pre class="syntaxbox">var x = "انا متغير مُعرف خارج التابع"; + +exampleFunction(); + +function exampleFunction() { + console.log("انا داخل التابع"); + console.log(x); // يمكن لمجال داخلي ابن ان يصل لمتغيرات مجال خارجي أب +} + +console.log("انا خارج التابع في المجال العام"); +console.log(x);</pre> + +<h2 id="Learn_more">Learn more</h2> + +<h3 id="General_knowledge">General knowledge</h3> + +<ul> + <li>{{Interwiki("wikipedia", "Scope (computer science)")}} في ويكبيديا</li> +</ul> diff --git a/files/ar/heesfoord007/index.html b/files/ar/heesfoord007/index.html new file mode 100644 index 0000000000..18fb17ee5d --- /dev/null +++ b/files/ar/heesfoord007/index.html @@ -0,0 +1,54 @@ +--- +title: heesfoord007 +slug: heesfoord007 +tags: + - Landing + - NeedsTranslation + - TopicStub + - Web +--- +<pre>The open Web presents incredible opportunities for developers. To take full advantage of these technologies, you need to know how to use them. Below you'll find links to our Web technology documentation.</pre> + +<div class="row topicpage-table"> +<div class="section"> +<h2 class="Documentation" id="Docs_for_add-on_developers" name="Docs_for_add-on_developers">Documentation for Web developers</h2> + +<dl> + <dt><a href="/en-US/docs/Web/Reference">Web Developer Reference</a></dt> + <dd>A list of all references for Web technologies, including those for HTML, CSS, and so on.</dd> + <dt><a href="/en-US/docs/Web/Guide">Web Developer Guide</a></dt> + <dd>The Web Developer Guide provides useful how-to content to help you actually use Web technologies to do what you want or need to do.</dd> + <dt><a href="/en-US/docs/Web/Tutorials">Tutorials for Web developers</a></dt> + <dd>A list of tutorials to take you step-by-step through learning APIs, technologies, or broad topic areas.</dd> + <dt><a href="/en-US/docs/Web/Apps">Developing Web applications</a></dt> + <dd>Documentation for Web application developers; Web apps are true write-once, deploy anywhere apps for mobile, desktop, and Firefox OS.</dd> + <dt><a href="/en-US/docs/Code_snippets">Code snippets</a></dt> + <dd>This is a quick list of useful code snippets (small code samples) available for developers of extensions for the various Mozilla applications. Many of these samples can also be used in <a href="/en-US/docs/XULRunner">XULRunner</a> applications, as well as in actual Mozilla code itself.</dd> +</dl> + +<p><span class="alllinks"><a href="/en-US/docs/tag/Web">View All...</a></span></p> +</div> + +<div class="section"> +<h2 class="Documentation" id="Docs_for_add-on_developers" name="Docs_for_add-on_developers">Web technology references</h2> + +<dl> + <dt><a href="/en-US/docs/Web/API">Web APIs</a></dt> + <dd>Reference material for each of the interfaces that comprise the Web's APIs, including the DOM and all of the related APIs and interfaces you can use to build Web content and apps.</dd> + <dt><a href="/en-US/docs/Web/HTML">HTML</a></dt> + <dd>HyperText Markup Language is the language used to describe and define the content of a Web page.</dd> + <dt><a href="/en-US/docs/Web/CSS">CSS</a></dt> + <dd>Cascading Style Sheets are used to describe the appearance of Web content.</dd> + <dt><a href="/en-US/docs/SVG">SVG</a></dt> + <dd>Scalable Vector Graphics let you describe images as sets of vectors and shapes in order to allow them to scale smoothly regardless of the size at which they're drawn.</dd> + <dt><a href="/en-US/docs/Web/MathML">MathML</a></dt> + <dd>The Mathematical Markup Language makes it possible to display complex mathematical equations and syntax.</dd> +</dl> +</div> +</div> + +<h3 id="Temporary" name="Temporary">Temporary</h3> + +<p>The stuff below here is temporary to help keep track of things while organization work is ongoing. Pay it no mind.</p> + +<div>{{ListSubpages}}</div> diff --git a/files/ar/html/element/article/index.html b/files/ar/html/element/article/index.html new file mode 100644 index 0000000000..4ffbdbe80a --- /dev/null +++ b/files/ar/html/element/article/index.html @@ -0,0 +1,153 @@ +--- +title: عنصر المقالة <article> +slug: HTML/Element/article +translation_of: Web/HTML/Element/article +--- +<div>{{HTMLRef}}</div> + +<p dir="rtl">عنصر الـ <article> الموجود في الـ html فهو مفهوم من عنوانه والذي يعني (مقال) ونعرف جميعنا ان المقالات بنية مستقلة بذاتها. وتوجد في الوثائق, الصفحات, التطبيقات او المواقع. ما نتحدث عنه اليوم هو كيف نكتب عناصر الـ html لصفحة تحتوي على مقالات مثل : منشور المنتديات, مقالات الصفحات و المجلات. حتى منشورات المدونات blogs تعتبر مقالة. </p> + +<p dir="rtl">في حالة اردت ان تبرمج صفحة تختص بالمقالات لابد لك ان تقوم باستخدام تاك او عنصر <article>. المثال التالي يوضع استخدام المقالة بابسط صوره لها: </p> + +<div>{{EmbedInteractiveExample("pages/tabbed/article.html", "tabbed-standard")}}</div> + +<div></div> + +<div class="hidden" dir="rtl">مصدر هذا المثال موجود في موقع GitHub ويمكنك المشاركة من خلال نسخ المثال الموجود في الرابط ادناه <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples </a>بعدها يمكن ان ترسل لنا طلبا.</div> + +<p dir="rtl">يمكن لصفحة الواحدة ان تحتوي على الكثير من المقالات. وهذا المثال دليل على ذلك. ليس هذا فحسب, فيمكن ان يكون عنصر المقالة يحتوي على عناصر مقالة بداخله ( تسمى nested element اي العناصر المتداخلة ).</p> + +<p dir="rtl">اليك معلومات خاطفة عن هذا العنصر:</p> + +<table class="properties" dir="rtl"> + <tbody> + <tr> + <th scope="row"><a href="/en-US/docs/Web/HTML/Content_categories">فئة المكون </a></th> + <td> + <p><a href="/en-US/docs/Web/HTML/Content_categories#Flow_content">Flow content</a>, <a href="/en-US/docs/Web/HTML/Content_categories#Sectioning_content">sectioning content</a>, <a href="/en-US/docs/Web/HTML/Content_categories#Palpable_content">palpable content</a></p> + </td> + </tr> + <tr> + <th scope="row">Permitted content</th> + <td><a href="/en-US/docs/HTML/Content_categories#Flow_content">Flow content</a>.</td> + </tr> + <tr> + <th scope="row">Tag omission</th> + <td>{{no_tag_omission}}</td> + </tr> + <tr> + <th scope="row">Permitted parents</th> + <td>Any element that accepts <a href="/en-US/docs/HTML/Content_categories#Flow_content">flow content</a>. Note that an <code><article></code> element must not be a descendant of an {{HTMLElement("address")}} element.</td> + </tr> + <tr> + <th scope="row">Implicit ARIA role</th> + <td><code><a href="/en-US/docs/Web/Accessibility/ARIA/Roles/Article_Role">article</a></code></td> + </tr> + <tr> + <th scope="row">Permitted ARIA roles</th> + <td>{{ARIARole("application")}}, {{ARIARole("document")}}, {{ARIARole("feed")}}, {{ARIARole("main")}}, {{ARIARole("none")}}, {{ARIARole("presentation")}}, {{ARIARole("region")}}</td> + </tr> + <tr> + <th scope="row">DOM interface</th> + <td>{{domxref("HTMLElement")}}</td> + </tr> + </tbody> +</table> + +<h2 dir="rtl" id="الخصائص">الخصائص</h2> + +<p dir="rtl">هذا العنصر يحتوي على الخصائص العامة فقط.<a href="/ar/docs/docs/HTML/Global_attributes"> يمكنك زيارتها من هنا</a></p> + +<h2 dir="rtl" id="ملاحظات_الاستخدام">ملاحظات الاستخدام</h2> + +<p dir="rtl">انت حر في استخدام هذا العنصر. ولكننا نفضل ان تقوم بمراعات هذه النقاط على الاقل.</p> + +<ul> + <li dir="rtl">كل عنصر <article> يجب ان يتم تعريفه من خلال تضمين عناوين heading باستخدام <a href="/ar/docs/Web/HTML/Element/Heading_Elements">h1-h6 </a>وتكون هذه العناصر بداخل هذا العنصر</li> + <li dir="rtl">عندما تحاول ان تكتب عنصر <article> (اي عندما تحول كتابة nested element) عليك مراعاة ان يكون العنصر الداخلي متصل بالعنصر الخارجي. مثلا تعليقات المنشور يجب ان تكون article . </li> + <li dir="rtl">معلومات مؤلف المنشور اذا امكن ان تكون في عنصر الـ <address> </li> + <li dir="rtl">التواريخ الخاص بالمقالة مثل تاريخ النشر وغيرها يجب ان تكون من اختصاص العنصر <a href="/ar/docs/Web/HTML/Element/time#attr-datetime"><time> ويمكنك الاطلاع على هذا العنصر من هنا</a></li> +</ul> + +<p dir="rtl">المثال التالي يلخص لك هذه النقاط:</p> + +<pre class="brush: html notranslate"><article class="film_review"> + <header> + <h2>Jurassic Park</h2> + </header> + <section class="main_review"> + <p>Dinos were great!</p> + </section> + <section class="user_reviews"> + <article class="user_review"> + <p>Way too scary for me.</p> + <footer> + <p> + Posted on + <time datetime="2015-05-16 19:00">May 16</time> + by Lisa. + </p> + </footer> + </article> + <article class="user_review"> + <p>I agree, dinos are my favorite.</p> + <footer> + <p> + Posted on + <time datetime="2015-05-17 19:00">May 17</time> + by Tom. + </p> + </footer> + </article> + </section> + <footer> + <p> + Posted on + <time datetime="2015-05-15 19:00">May 15</time> + by Staff. + </p> + </footer> +</article> +</pre> + +<h2 id="Specifications">Specifications</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('HTML WHATWG', 'semantics.html#the-article-element', '<article>')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td></td> + </tr> + <tr> + <td>{{SpecName('HTML5.1', 'sections.html#the-article-element', '<article>')}}</td> + <td>{{Spec2('HTML5.1')}}</td> + <td></td> + </tr> + <tr> + <td>{{SpecName('HTML5 W3C', 'sections.html#the-article-element', '<article>')}}</td> + <td>{{Spec2('HTML5 W3C')}}</td> + <td></td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Browser compatibility</h2> + + + +<p>{{Compat("html.elements.article")}}</p> + +<h2 dir="rtl" id="يمكنك_زيارة_التالي">يمكنك زيارة التالي:</h2> + +<ul> + <li dir="rtl">العناصر المرتبطة بهذا العنصر - او ربما تستخدمها معه: {{HTMLElement("body")}}, {{HTMLElement("nav")}}, {{HTMLElement("section")}}, {{HTMLElement("aside")}}, {{HTMLElement("h1")}}, {{HTMLElement("h2")}}, {{HTMLElement("h3")}}, {{HTMLElement("h4")}}, {{HTMLElement("h5")}}, {{HTMLElement("h6")}}, {{HTMLElement("hgroup")}}, {{HTMLElement("header")}}, {{HTMLElement("footer")}}, {{HTMLElement("address")}}</li> + <li><a href="/en-US/docs/Web/Guide/HTML/Using_HTML_sections_and_outlines">Using HTML sections and outlines</a></li> +</ul> diff --git a/files/ar/html/element/bdo/index.html b/files/ar/html/element/bdo/index.html new file mode 100644 index 0000000000..ee154b30c1 --- /dev/null +++ b/files/ar/html/element/bdo/index.html @@ -0,0 +1,108 @@ +--- +title: '<bdo>: عنصر تجاوز النص ثنائي الاتجاه' +slug: HTML/Element/bdo +translation_of: Web/HTML/Element/bdo +--- +<div>{{HTMLRef}}</div> + +<p dir="rtl"><span class="seoSummary"><strong>HTML </strong>عنصر تجاوز النص ثنائي الاتجاه(<strong><code><bdo></code></strong>) يتجاوز الاتجاه الحالي للنص، بحيث يتم تقديم النص داخل في اتجاه مختلف. يتم رسم أحرف النص من نقطة البداية في الاتجاه المحدد. لا يتأثر اتجاه الحروف الفردية (حتى لا تحصل على أحرف إلى الوراء، على سبيل المثال).</span></p> + +<table class="properties"> + <tbody> + <tr> + <th scope="row"><a href="/en-US/docs/HTML/Content_categories">يحتوي الفئات</a></th> + <td><a href="/en-US/docs/HTML/Content_categories#Flow_content">Flow content</a>, <a href="/en-US/docs/HTML/Content_categories#Phrasing_content">phrasing content</a>, palpable content.</td> + </tr> + <tr> + <th scope="row">المحتوى المسموح به</th> + <td><a href="/en-US/docs/HTML/Content_categories#Phrasing_content">Phrasing content</a>.</td> + </tr> + <tr> + <th scope="row">وسم الإقفال</th> + <td>{{no_tag_omission}}</td> + </tr> + <tr> + <th scope="row">يسمح الآباء</th> + <td>أي عنصر يقبل <a href="/en-US/docs/HTML/Content_categories#Phrasing_content">صياغة المحتوى.</a></td> + </tr> + <tr> + <th scope="row">قواعد ARIA مسموح</th> + <td>الكل</td> + </tr> + <tr> + <th scope="row">DOM واجهة</th> + <td>{{domxref("HTMLElement")}} Up to Gecko 1.9.2 (Firefox 4) inclusive, Firefox implements the <code><a href="/en-US/docs/Web/API/HTMLSpanElement">HTMLSpanElement</a></code> interface for this element.</td> + </tr> + </tbody> +</table> + +<h2 dir="rtl" id="السِمات">السِمات</h2> + +<p dir="rtl">تتضمن سمات هذه العناصر <a href="/en-US/docs/HTML/Global_attributes">السمات العامة.</a></p> + +<dl> + <dt dir="rtl">{{htmlattrdef("dir")}}</dt> + <dd dir="rtl">الاتجاه الذي يجب أن يظهر فيه النص في محتويات هذا العنصر.</dd> + <dd dir="rtl">القيم المحتملة هي:</dd> + <dd> + <ul> + <li dir="rtl"><code>ltr</code>: يشير إلى أن النص يجب أن يسير في الاتجاه من اليسار إلى اليمين.</li> + <li dir="rtl"><code>rtl</code>:يشير إلى أن النص يجب أن يكون في الاتجاه من اليمين إلى اليسار.</li> + </ul> + </dd> +</dl> + +<h2 dir="rtl" id="الأمثلة">الأمثلة</h2> + +<pre class="brush: html"><!-- Switch text direction --> +<p>This text will go left to right.</p> +<p><bdo dir="rtl">This text will go right +to left.</bdo></p> +</pre> + +<h3 id="النتيجة">النتيجة</h3> + +<p> </p> + +<p>{{EmbedLiveSample('Examples')}}</p> + +<p> </p> + +<h2 dir="rtl" id="ملاحظات">ملاحظات</h2> + +<p dir="rtl">مواصفات HTML 4 لم تحدد أحداث لهذا العنصر؛ تمت إضافتها في XHTML. وهذا على الأرجح سهو.</p> + +<h2 dir="rtl" id="مميزات">مميزات</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">المميزات</th> + <th scope="col">الحالة</th> + <th scope="col">تعليق</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('HTML WHATWG', 'semantics.html#the-bdo-element', '<bdo>')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td> </td> + </tr> + <tr> + <td>{{SpecName('HTML5 W3C', 'textlevel-semantics.html#the-bdo-element', '<bdo>')}}</td> + <td>{{Spec2('HTML5 W3C')}}</td> + <td> </td> + </tr> + <tr> + <td>{{SpecName('HTML4.01', 'dirlang.html#h-8.2.4', '<bdo>')}}</td> + <td>{{Spec2('HTML4.01')}}</td> + <td> </td> + </tr> + </tbody> +</table> + +<h2 dir="rtl" id="التكامل(دعم)_مع_المتصفح">التكامل(دعم) مع المتصفح</h2> + + + +<p>{{Compat("html.elements.bdo")}}</p> diff --git a/files/ar/html/element/headings_elements/index.html b/files/ar/html/element/headings_elements/index.html new file mode 100644 index 0000000000..acd3267d37 --- /dev/null +++ b/files/ar/html/element/headings_elements/index.html @@ -0,0 +1,244 @@ +--- +title: '<h1>–<h6>: عناصر العناوين' +slug: HTML/Element/headings_elements +translation_of: Web/HTML/Element/Heading_Elements +--- +<p dir="rtl"> عناصر <span class="seoSummary"><strong><code><h1></code>–<code><h6></code></strong></span> تقدم لنا سته مستويات من عناوين الأقسام. حيث أن العنصر<span class="seoSummary"><code><h1></code> يمثل العنوان الأعلى مستوى في الأهمية بينما العنصر <code><h2></code> هو الأقل.</span></p> + +<table class="properties"> + <tbody> + <tr> + <th scope="row"><a href="/en-US/docs/Web/HTML/Content_categories">فئات المحتوى </a></th> + <td><a href="/en-US/docs/Web/HTML/Content_categories#Flow_content">Flow content</a>, heading content, palpable content.</td> + </tr> + <tr> + <th scope="row">المحتوى المسموح به</th> + <td><a href="/en-US/docs/Web/HTML/Content_categories#Phrasing_content">Phrasing content</a>.</td> + </tr> + <tr> + <th scope="row">إغفال الوسوم</th> + <td>لا شئ، كلاً من وسمّي الفتح والإقفال إجباري</td> + </tr> + <tr> + <th scope="row">الأباء المسموح بهم للعنصر</th> + <td>Any element that accepts <a href="/en-US/docs/Web/HTML/Content_categories#Flow_content">flow content</a>; don't use an heading element as a child of the {{HTMLElement("hgroup")}} element — it is now deprecated.</td> + </tr> + <tr> + <th scope="row">Permitted ARIA roles</th> + <td>{{ARIARole("tab")}}, {{ARIARole("presentation")}}</td> + </tr> + <tr> + <th scope="row">DOM interface</th> + <td>{{domxref("HTMLHeadingElement")}}</td> + </tr> + </tbody> +</table> + +<h2 dir="rtl" id="السمات">السمات</h2> + +<p dir="rtl">هذه العناصر تتضمن <a href="/en-US/docs/Web/HTML/Global_attributes">السمات العامة</a>.</p> + +<div class="note" dir="rtl"> +<p>السمة <code>align</code> عفاء عنها الزمن، لا تستخدمها</p> +</div> + +<h2 id="ملاحظات_الإستخدام" style="direction: rtl;">ملاحظات الإستخدام</h2> + +<ul> + <li dir="rtl">يمكن إستخدام معلومات العناوين من قبل الـ user agents, على سبيل المثال لإنشاء جدول المحتويات لمستند بشكل تلقائي.</li> + <li dir="rtl">لا تستخدم عناوين بمستويات منخفضة لتقليل حجم خط العناوين: إستخدم خاصية لغة CSS المسؤولة عن التحكم بأحجام الخطوط <a href="https://developer.mozilla.org/en-US/docs/Web/CSS/font-size">font-size</a> بدلاً من ذلك.</li> + <li dir="rtl"> تجنب تخطي مستويات العناوين: دائماً إبدا من <code><h1></code>، من ثم إستخدم <code><h2></code> وهكذا.</li> + <li dir="rtl">يجب أن تأخذ بعين الإعتبار تجنب إستخدام العنصر <h1> أكثر من مرة في الصفحة. إطلع على <a href="https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Using_HTML_sections_and_outlines#Defining_sections">تعريف الأقسام</a> في <a href="https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Using_HTML_sections_and_outlines">إستخدام الأقسام و وتسلسل العناوين في الـ HTML</a> لمعلومات أكثر.</li> +</ul> + +<h2 id="أمثلة" style="direction: rtl;">أمثلة</h2> + +<h3 id="جميع_العناوين" style="direction: rtl;">جميع العناوين</h3> + +<p style="direction: rtl;">الكود التالي يظهر كل مستويات العناوين، قيد الإستخدام.</p> + +<pre class="brush: html"><h1>Heading level 1</h1> +<h2>Heading level 2</h2> +<h3>Heading level 3</h3> +<h4>Heading level 4</h4> +<h5>Heading level 5</h5> +<h6>Heading level 6</h6> +</pre> + +<p style="direction: rtl;">هنا نتيجة هذا الكود:</p> + +<p>{{ EmbedLiveSample('All_headings', '280', '300', '') }}</p> + +<h3 id="مثال_لصفحة" style="direction: rtl;">مثال لصفحة</h3> + +<p style="direction: rtl;">الكود التالي يظهر بعض العناوين مع بعض المحتوى بأسفلها.</p> + +<pre class="brush: html"><h1>Heading elements</h1> +<h2>Summary</h2> +<p>Some text here...</p> + +<h2>Examples</h2> +<h3>Example 1</h3> +<p>Some text here...</p> + +<h3>Example 2</h3> +<p>Some text here...</p> + +<h2>See also</h2> +<p>Some text here...</p> +</pre> + +<p style="direction: rtl;">هنا نتيجة هذا الكود:</p> + +<p>{{ EmbedLiveSample('Example_page', '280', '480', '') }}</p> + +<h2 id="سهولة_الوصول" style="direction: rtl;">سهولة الوصول</h2> + +<h3 id="التنقل_بين_الأجزاء_والصفحات" style="direction: rtl;">التنقل بين الأجزاء والصفحات</h3> + +<p style="direction: rtl;">من الأساليب الشائعة للتنقل بين أجزاء الصفحة من قبل مستخدمي قارئات الشاشات هو القفز من عنوان لأخر لتحديد محتوى الصفحة بشكل سريع. </p> + +<p style="direction: rtl;">لهذا السبب، من المهم عدم تخطي أحد مستويات العناوين فالقيام بذلك قد يسبب ارتباك للشخص الذي يقوم بالتنقل بين أجزاء الموقع بهذه الطريقة وربما يترك لدية نوع من الحيرة عن أين هو العنوان المفقود.</p> + +<h4 id="لا_تقم_بالتالي" style="direction: rtl;">لا تقم بالتالي:</h4> + +<pre class="brush: html example-bad"><h1>Heading level 1</h1> +<h3>Heading level 3</h3> +<h4>Heading level 4</h4> +</pre> + +<h4 id="قم_بالتالي" style="direction: rtl;">قم بالتالي:</h4> + +<pre class="brush: html example-good"><h1>Heading level 1</h1> +<h2>Heading level 2</h2> +<h3>Heading level 3</h3> +</pre> + +<h4 id="تسلسل_العناوين_-_Nesting" style="direction: rtl;">تسلسل العناوين - Nesting</h4> + +<p style="direction: rtl;">قد يتم عمل تسلسل لبعض العناوين لتبدو كعناوين أقسام فرعية لعكس تنظيم محتوى الصفحة. أغلب قارئات الشاشات تستطيع أيضا تكوين قائمة مرتبة لكل العناوين التي في الصفحة، ما قد يساعد الشخص لتحديد التسلسل الهرمي للمحتوى بسرعة :</p> + +<ol> + <li><code>h1</code> Beetles + + <ol> + <li><code>h2</code> Etymology</li> + <li><code>h2</code> Distribution and Diversity</li> + <li><code>h2</code> Evolution + <ol> + <li><code>h3</code> Late Paleozoic</li> + <li><code>h3</code> Jurassic</li> + <li><code>h3</code> Cretaceous</li> + <li><code>h3</code> Cenozoic</li> + </ol> + </li> + <li><code>h2</code> External Morphology + <ol> + <li><code>h3</code> Head + <ol> + <li><code>h4</code> Mouthparts</li> + </ol> + </li> + <li><code>h3</code> Thorax + <ol> + <li><code>h4</code> Prothorax</li> + <li><code>h4</code> Pterothorax</li> + </ol> + </li> + <li><code>h3</code> Legs</li> + <li><code>h3</code> Wings</li> + <li><code>h3</code> Abdomen</li> + </ol> + </li> + </ol> + </li> +</ol> + +<p>When headings are nested, heading levels may be "skipped" when closing a subsection.</p> + +<ul> + <li><a href="https://www.w3.org/WAI/tutorials/page-structure/headings/">Headings • Page Structure • WAI Web Accessibility Tutorials</a></li> + <li><a href="/en-US/docs/Web/Accessibility/Understanding_WCAG/Perceivable#Guideline_1.3_—_Create_content_that_can_be_presented_in_different_ways">MDN Understanding WCAG, Guideline 1.3 explanations</a></li> + <li><a href="https://www.w3.org/TR/UNDERSTANDING-WCAG20/content-structure-separation-programmatic.html">Understanding Success Criterion 1.3.1 | W3C Understanding WCAG 2.0</a></li> + <li><a href="/en-US/docs/Web/Accessibility/Understanding_WCAG/Operable#Guideline_2.4_—_Navigable_Provide_ways_to_help_users_navigate_find_content_and_determine_where_they_are">MDN Understanding WCAG, Guideline 2.4 explanations</a></li> + <li><a href="https://www.w3.org/TR/UNDERSTANDING-WCAG20/navigation-mechanisms-skip.html">Understanding Success Criterion 2.4.1 | W3C Understanding WCAG 2.0</a></li> + <li><a href="https://www.w3.org/TR/UNDERSTANDING-WCAG20/navigation-mechanisms-descriptive.html">Understanding Success Criterion 2.4.6 | W3C Understanding WCAG 2.0</a></li> + <li><a href="https://www.w3.org/TR/UNDERSTANDING-WCAG20/navigation-mechanisms-headings.html">Understanding Success Criterion 2.4.10 | W3C Understanding WCAG 2.0</a></li> +</ul> + +<h3 id="Labeling_section_content">Labeling section content</h3> + +<p>Another common navigation technique for users of screen reading software is to generate a list of <a href="/en-US/docs/Web/HTML/Element#Content_sectioning">sectioning content</a> and use it to determine the page's layout.</p> + +<p>Sectioning content can be labeled using a combination of the <code><a href="/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-labelledby_attribute">aria-labelledby</a></code> and {{htmlattrxref("id")}} attributes, with the label concisely describing the purpose of the section. This technique is useful for situations where there is more than one sectioning element on the same page.</p> + +<h4 id="Example">Example</h4> + +<pre class="brush: html"><header> + <nav aria-labelledby="primary-navigation"> + <h2 id="primary-navigation">Primary navigation</h2> + <!-- navigation items --> + </nav> +</header> + +<!-- page content --> + +<footer> + <nav aria-labelledby="footer-navigation"> + <h2 id="footer-navigation">Footer navigation</h2> + <!-- navigation items --> + </nav> +</footer> +</pre> + +<p>In this example, screen reading technology would announce that there are two {{HTMLElement("nav")}} sections, one called "Primary navigation" and one called "Footer navigation". If labels were not provided, the person using screen reading software may have to investigate each <code>nav</code> element's contents to determine their purpose.</p> + +<ul> + <li><a href="/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-labelledby_attribute">Using the aria-labelledby attribute</a></li> + <li><a href="https://www.w3.org/WAI/tutorials/page-structure/labels/#using-aria-labelledby">Labeling Regions • Page Structure • W3C WAI Web Accessibility Tutorials</a></li> +</ul> + +<h2 id="Specifications">Specifications</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('HTML WHATWG', 'sections.html#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements', '<h1>, <h2>, <h3>, <h4>, <h5>, and <h6>')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td> </td> + </tr> + <tr> + <td>{{SpecName('HTML5 W3C', 'sections.html#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements', '<h1>, <h2>, <h3>, <h4>, <h5>, and <h6>')}}</td> + <td>{{Spec2('HTML5 W3C')}}</td> + <td> </td> + </tr> + <tr> + <td>{{SpecName('HTML4.01', 'struct/global.html#h-7.5.5', '<h1>, <h2>, <h3>, <h4>, <h5>, and <h6>')}}</td> + <td>{{Spec2('HTML4.01')}}</td> + <td> </td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Browser compatibility</h2> + + + +<p>{{Compat("html.elements.h1")}}</p> + +<h2 id="See_also">See also</h2> + +<ul> + <li>{{HTMLElement("p")}}</li> + <li>{{HTMLElement("div")}}</li> + <li>{{HTMLElement("section")}}</li> +</ul> + +<div>{{HTMLRef}}</div> diff --git a/files/ar/html/element/index.html b/files/ar/html/element/index.html new file mode 100644 index 0000000000..a2fb5187e7 --- /dev/null +++ b/files/ar/html/element/index.html @@ -0,0 +1,239 @@ +--- +title: HTML element reference +slug: HTML/Element +translation_of: Web/HTML/Element +--- +<p><font><font>يسرد مرجع HTML هذا جميع </font></font><strong><font><font>عناصر HTML</font></font></strong><font><font> ، المحددة في HTML5 أو في مواصفات سابقة. </font><font>عند تضمينها داخل أقواس زاوية ، فإنها تشكل </font></font><em><font><font>علامات HTML</font></font></em><font><font> : </font></font><code><elementname>.</code><font><font>العناصر عبارة عن كيانات تحدد كيفية إنشاء مستندات HTML ، ونوع المحتوى الذي يجب وضعه في أي جزء من </font><font>مستند </font></font><a href="https://developer.mozilla.org/en-US/docs/HTML" title="/ EN-US / مستندات / HTML"><font><font>HTML</font></font></a><font><font> .</font></font></p> + +<p><font><font>تسرد هذه الصفحة جميع علامات HTML5 القياسية ، ولكنها تحتوي أيضًا على العلامات القديمة والبالية والمهملة ، بالإضافة إلى العلامات غير القياسية التي قد تدعمها المتصفحات. </font><font>غالبًا ما يشار إلى </font><font>العناصر التي تم تقديمها في </font></font><a href="https://developer.mozilla.org/en-US/docs/HTML/HTML5" title="/ EN-US / مستندات / HTML / HTML5"><font><font>HTML5</font></font></a><font><font> على أنها عناصر HTML5 الجديدة ، على الرغم من أن العناصر القياسية الأخرى صالحة أيضًا في HTML5.</font></font></p> + +<p><font><font>في مستند HTML ، يتم تعريف عنصر بواسطة </font></font><em><font><font>علامة البداية</font></font></em><font><font> . </font><font>إذا احتوى عنصر المحتويات الأخرى، وينتهي مع </font></font><em><font><font>علامة إغلاق</font></font></em><font><font>، حيث يسبق اسم العنصر بواسطة خط مائل: </font></font><code></elementname></code><font><font>. </font><font>لا تحتاج إلى إغلاق بعض العناصر ، مثل عناصر الصورة.</font><font>هذه هي المعروفة باسم </font><font>العناصر </font></font><em><font><font>باطلة</font></font></em><font><font> . </font><font>تحتوي مستندات HTML على شجرة من هذه العناصر. </font><font>يدعى كل لتمثيل ما يفعله. </font><font>على سبيل المثال ، </font></font><code><title></code><font><font>يمثل العنصر عنوان المستند. </font><font>فيما يلي قائمة أبجدية بعناصر HTML.</font></font></p> + +<p><a href="https://developer.mozilla.org/en-US/docs/HTML/HTML5"><img alt="تمت إضافة هذا العنصر في HTML5" src="https://developer.mozilla.org/files/3843/HTML5_Badge_32.png" title="تمت إضافة هذا العنصر في HTML5"></a><font><font>يشير </font><font>الرمز </font><font>إلى أنه تمت إضافة العنصر في HTML5. </font><font>لاحظ أنه ربما تم تعديل أو توسيع العناصر الأخرى المدرجة هنا حسب مواصفات HTML5. </font><font>العناصر البعدية غير قياسية أو قديمة أو متوقفة ؛ </font><font>يجب عدم استخدامها في مواقع ويب جديدة ، ويجب إزالتها بشكل تدريجي من المواقع الحالية لتجنب النتائج غير المرغوب فيها.</font></font></p> + +<p>يشير الرمز Ⓒ إلى أن العنصر معرف في مجموعة المواصفات Web Components.</p> + +<div class="index widgeted"><span id="A">A</span> + +<ul> + <li>{{ HTMLElement("a") }}</li> + <li>{{ HTMLElement("abbr") }}</li> + <li><s class="obsoleteElement">{{ HTMLElement("acronym") }}</s></li> + <li>{{ HTMLElement("address") }}</li> + <li><s class="deprecatedElement obsoleteElement">{{ HTMLElement("applet") }}</s></li> + <li>{{ HTMLElement("area") }}</li> + <li class="html5">{{ HTMLElement("article") }}</li> + <li class="html5">{{ HTMLElement("aside") }}</li> + <li class="html5">{{ HTMLElement("audio") }}</li> +</ul> +<span id="B">B</span> + +<ul> + <li>{{ HTMLElement("b") }}</li> + <li>{{ HTMLElement("base") }}</li> + <li><s class="deprecatedElement obsoleteElement">{{ HTMLElement("basefont") }}</s></li> + <li class="html5">{{ HTMLElement("bdi") }}</li> + <li>{{ HTMLElement("bdo") }}</li> + <li><s class="nonStdElement">{{ HTMLElement("bgsound") }}</s></li> + <li><s class="obsoleteElement">{{ HTMLElement("big") }}</s></li> + <li><s class="nonStdElement">{{ HTMLElement("blink") }}</s></li> + <li>{{ HTMLElement("blockquote") }}</li> + <li>{{ HTMLElement("body") }}</li> + <li>{{ HTMLElement("br") }}</li> + <li>{{ HTMLElement("button") }}</li> +</ul> +<span id="C">C</span> + +<ul> + <li class="html5">{{ HTMLElement("canvas") }}</li> + <li>{{ HTMLElement("caption") }}</li> + <li><s class="deprecatedElement obsoleteElement">{{ HTMLElement("center") }}</s></li> + <li>{{ HTMLElement("cite") }}</li> + <li>{{ HTMLElement("code") }}</li> + <li>{{ HTMLElement("col") }}</li> + <li>{{ HTMLElement("colgroup") }}</li> +</ul> +<span id="D">D</span> + +<ul> + <li class="html5">{{ HTMLElement("data") }}</li> + <li class="html5">{{ HTMLElement("datalist") }}</li> + <li>{{ HTMLElement("dd") }}</li> + <li class="webcomp">{{ HTMLElement("decorator")}}</li> + <li>{{ HTMLElement("del") }}</li> + <li class="html5">{{ HTMLElement("details") }}</li> + <li>{{ HTMLElement("dfn") }}</li> + <li><s class="deprecatedElement obsoleteElement">{{ HTMLElement("dir") }}</s></li> + <li>{{ HTMLElement("div") }}</li> + <li>{{ HTMLElement("dl") }}</li> + <li>{{ HTMLElement("dt") }}</li> +</ul> +<span id="E">E</span> + +<ul> + <li>{{HTMLElement("em") }}</li> + <li class="html5">{{ HTMLElement("embed") }}</li> +</ul> +<span id="F">F</span> + +<ul> + <li>{{ HTMLElement("fieldset") }}</li> + <li class="html5">{{ HTMLElement("figcaption") }}</li> + <li class="html5">{{ HTMLElement("figure") }}</li> + <li><s class="deprecatedElement obsoleteElement">{{ HTMLElement("font") }}</s></li> + <li class="html5">{{ HTMLElement("footer") }}</li> + <li>{{ HTMLElement("form") }}</li> + <li><s class="obsoleteElement">{{ HTMLElement("frame") }}</s></li> + <li><s class="obsoleteElement">{{ HTMLElement("frameset") }}</s></li> +</ul> +<span id="G">G H</span> + +<ul> + <li>{{ HTMLElement("h1") }}</li> + <li>{{ HTMLElement("h2") }}</li> + <li>{{ HTMLElement("h3") }}</li> + <li>{{ HTMLElement("h4") }}</li> + <li>{{ HTMLElement("h5") }}</li> + <li>{{ HTMLElement("h6") }}</li> + <li>{{ HTMLElement("head") }}</li> + <li class="html5">{{ HTMLElement("header") }}</li> + <li class="html5"><s class="deprecatedElement obsoleteElement">{{ HTMLElement("hgroup") }}</s></li> + <li>{{ HTMLElement("hr") }}</li> + <li>{{ HTMLElement("html") }}</li> +</ul> +<span id="I">I</span> + +<ul> + <li>{{ HTMLElement("i") }}</li> + <li>{{ HTMLElement("iframe") }}</li> + <li>{{ HTMLElement("img") }}</li> + <li>{{ HTMLElement("input") }}</li> + <li>{{ HTMLElement("ins") }}</li> + <li><s class="deprecatedElement obsoleteElement">{{ HTMLElement("isindex") }}</s></li> +</ul> +<span id="J">J K</span> + +<ul> + <li>{{ HTMLElement("kbd") }}</li> + <li class="html5">{{ HTMLElement("keygen") }}</li> +</ul> +<span id="L">L</span> + +<ul> + <li>{{ HTMLElement("label") }}</li> + <li>{{ HTMLElement("legend") }}</li> + <li>{{ HTMLElement("li") }}</li> + <li>{{ HTMLElement("link") }}</li> + <li><s class="deprecatedElement obsoleteElement">{{ HTMLElement("listing") }}</s></li> +</ul> +<span id="M">M</span> + +<ul> + <li class="html5">{{HTMLElement("main")}}</li> + <li>{{ HTMLElement("map") }}</li> + <li class="html5">{{ HTMLElement("mark") }}</li> + <li><s class="nonStdElement">{{ HTMLElement("marquee") }}</s></li> + <li class="html5">{{ HTMLElement("menu") }}</li> + <li class="html5">{{ HTMLElement("menuitem") }}</li> + <li>{{ HTMLElement("meta") }}</li> + <li class="html5">{{ HTMLElement("meter") }}</li> +</ul> +<span id="N">N</span> + +<ul> + <li class="html5">{{ HTMLElement("nav") }}</li> + <li><s class="nonStdElement">{{ HTMLElement("nobr") }}</s></li> + <li><s class="deprecatedElement obsoleteElement">{{ HTMLElement("noframes") }}</s></li> + <li>{{ HTMLElement("noscript") }}</li> +</ul> +<span id="O">O</span> + +<ul> + <li>{{ HTMLElement("object") }}</li> + <li>{{ HTMLElement("ol") }}</li> + <li>{{ HTMLElement("optgroup") }}</li> + <li>{{ HTMLElement("option") }}</li> + <li class="html5">{{ HTMLElement("output") }}</li> +</ul> +<span id="P">P</span> + +<ul> + <li>{{ HTMLElement("p") }}</li> + <li>{{ HTMLElement("param") }}</li> + <li><s class="deprecatedElement obsoleteElement">{{ HTMLElement("plaintext") }}</s></li> + <li>{{ HTMLElement("pre") }}</li> + <li class="html5">{{ HTMLElement("progress") }}</li> +</ul> +<span id="Q">Q</span> + +<ul> + <li>{{ HTMLElement("q") }}</li> +</ul> +<span id="R">R</span> + +<ul> + <li class="html5">{{ HTMLElement("rp") }}</li> + <li class="html5">{{ HTMLElement("rt") }}</li> + <li class="html5">{{ HTMLElement("ruby") }}</li> +</ul> +<span id="S">S</span> + +<ul> + <li>{{ HTMLElement("s") }}</li> + <li>{{ HTMLElement("samp") }}</li> + <li>{{ HTMLElement("script") }}</li> + <li class="html5">{{ HTMLElement("section") }}</li> + <li>{{ HTMLElement("select") }}</li> + <li>{{ HTMLElement("small") }}</li> + <li class="html5">{{ HTMLElement("source") }}</li> + <li><s class="nonStdElement">{{ HTMLElement("spacer") }}</s></li> + <li>{{ HTMLElement("span") }}</li> + <li><s class="deprecatedElement obsoleteElement">{{ HTMLElement("strike") }}</s></li> + <li>{{ HTMLElement("strong") }}</li> + <li>{{ HTMLElement("style") }}</li> + <li>{{ HTMLElement("sub") }}</li> + <li class="html5">{{ HTMLElement("summary") }}</li> + <li>{{ HTMLElement("sup") }}</li> +</ul> +<span id="T">T</span> + +<ul> + <li>{{ HTMLElement("table") }}</li> + <li>{{ HTMLElement("tbody") }}</li> + <li>{{ HTMLElement("td") }}</li> + <li class="webcomp">{{ HTMLElement("template")}}</li> + <li>{{ HTMLElement("textarea") }}</li> + <li>{{ HTMLElement("tfoot") }}</li> + <li>{{ HTMLElement("th") }}</li> + <li>{{ HTMLElement("thead") }}</li> + <li class="html5">{{ HTMLElement("time") }}</li> + <li>{{ HTMLElement("title") }}</li> + <li>{{ HTMLElement("tr") }}</li> + <li class="html5">{{ HTMLElement("track") }}</li> + <li><s class="obsoleteElement">{{ HTMLElement("tt") }}</s></li> +</ul> +<span id="U">U</span> + +<ul> + <li>{{ HTMLElement("u") }}</li> + <li>{{ HTMLElement("ul") }}</li> +</ul> +<span id="V">V</span> + +<ul> + <li>{{ HTMLElement("var") }}</li> + <li class="html5">{{ HTMLElement("video") }}</li> +</ul> +<span id="W">W</span> + +<ul> + <li class="html5">{{ HTMLElement("wbr") }}</li> +</ul> +<span id="X">X Y Z </span> + +<ul> + <li><span id="X"><s class="deprecatedElement obsoleteElement">{{ HTMLElement("xmp") }}</s></span></li> +</ul> +</div> + +<p> </p> diff --git a/files/ar/html/element/span/index.html b/files/ar/html/element/span/index.html new file mode 100644 index 0000000000..79a265b804 --- /dev/null +++ b/files/ar/html/element/span/index.html @@ -0,0 +1,122 @@ +--- +title: <span> +slug: HTML/Element/span +translation_of: Web/HTML/Element/span +--- +<p><font><font>و </font></font><strong><font><font>HTML </font></font><code><span></code><font><font>العنصر</font></font></strong><font><font> هو حاوية مضمنة عامة لمحتوى الصيغة، التي لا تمثل في حد ذاتها أي شيء. </font><font>يمكن استخدامه لتجميع العناصر لأغراض التصميم (باستخدام </font></font><code>class</code><font><font>أو </font></font><code>id</code><font><font>السمات) ، أو لأنها تتشارك في قيم السمات ، مثل </font></font><code>lang</code><font><font>. </font></font><font><font>يجب استخدامه فقط عندما يكون أي عنصر دلالي آخر مناسبًا. </font></font><code><span></code><font><font>تشبه إلى حد كبير على </font></font><a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/div" title="عنصر قسم محتويات HTML (<div>) هو الحاوية العامة لمحتوى التدفق. ليس له تأثير على المحتوى أو التخطيط حتى يتم تصميمه باستخدام CSS."><code><div></code></a><font><font>عنصر، ولكن </font></font><a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/div" title="عنصر قسم محتويات HTML (<div>) هو الحاوية العامة لمحتوى التدفق. ليس له تأثير على المحتوى أو التخطيط حتى يتم تصميمه باستخدام CSS."><code><div></code></a><font><font>هو </font></font><a href="https://developer.mozilla.org/en-US/docs/HTML/Block-level_elements"><font><font>عنصر على مستوى الكتلة</font></font></a><font><font> في حين أن </font></font><code><span></code><font><font>هو </font></font><a href="https://developer.mozilla.org/en-US/docs/HTML/Inline_elements"><font><font>عنصر المضمنة</font></font></a><font><font> .</font></font></p> + +<table class="properties"> + <tbody> + <tr> + <th scope="row"> + <table> + <tbody> + <tr> + <th scope="row"><a href="https://developer.mozilla.org/en-US/docs/HTML/Content_categories"><font><font>فئات المحتوى</font></font></a></th> + </tr> + </tbody> + </table> + </th> + <td><a href="https://developer.mozilla.org/en-US/docs/HTML/Content_categories#Flow_content"><font><font>محتوى التدفق</font></font></a><font><font> ، </font></font><a href="https://developer.mozilla.org/en-US/docs/HTML/Content_categories#Phrasing_content"><font><font>محتوى الصياغة</font></font></a><font><font> .</font></font></td> + </tr> + <tr> + <th scope="row">المحتوى المسموح به</th> + <td> + <table> + <tbody> + <tr> + <td><a href="https://developer.mozilla.org/en-US/docs/HTML/Content_categories#Phrasing_content"><font><font>محتوى الصياغة</font></font></a></td> + </tr> + </tbody> + </table> + </td> + </tr> + <tr> + <th scope="row">إغفال العلامة</th> + <td>الآباء المسموح بهم</td> + </tr> + <tr> + <td><font><font>أي عنصر يقبل </font></font><a href="https://developer.mozilla.org/en-US/docs/HTML/Content_categories#Phrasing_content"><font><font>محتوى الصياغة</font></font></a><font><font> ، أو أي عنصر يقبل </font></font><a href="https://developer.mozilla.org/en-US/docs/HTML/Content_categories#Flow_content"><font><font>محتوى التدفق</font></font></a><font><font> .</font></font></td> + </tr> + <tr> + <th scope="row">يسمح أدوار ARIA</th> + <td>أي</td> + </tr> + <tr> + <th scope="row">واجهة DOM</th> + <td><a href="https://developer.mozilla.org/en-US/docs/Web/API/HTMLSpanElement" title="تمثل واجهة HTMLSpanElement عنصر <span> وتستمد من واجهة HTMLElement ، ولكن دون تنفيذ أي خصائص أو طرق إضافية."><code>HTMLSpanElement</code></a><font><font>(قبل HTML 5 ، كانت الواجهة </font></font><a href="https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement" title="تمثل واجهة HTMLElement أي عنصر HTML. تقوم بعض العناصر بتنفيذ هذه الواجهة مباشرة ، بينما يقوم بعضها الآخر بتنفيذها من خلال واجهة توارثها."><code>HTMLElement</code></a><font><font>)</font></font></td> + </tr> + </tbody> +</table> + +<h2 id="السمات"><font><font>السمات</font></font></h2> + +<p><font><font>هذا العنصر يشمل فقط </font></font><a href="https://developer.mozilla.org/en-US/docs/HTML/Global_attributes"><font><font>السمات العالمية</font></font></a><font><font> .</font></font></p> + +<h2 id="المثال_1"><font><font>المثال 1</font></font></h2> + +<pre class="brush:html;gutter:false"><p><span>Some text</span></p></pre> + +<h3 id="نتيجة"><font><font>نتيجة</font></font></h3> + +<p><font><font>بعض النصوص</font></font></p> + +<p> </p> + +<h2 id="المثال_2"><font><font>المثال 2</font></font></h2> + +<pre class="brush:html;gutter:false"><li><span> + <a href="portfolio.html" target="_blank">See my portfolio</a> +</span></li> +</pre> + +<h3 id="CSS">CSS:</h3> + +<div class="note"> +<p>li span {<br> + background: gold;<br> + }</p> +</div> + +<h2 id="مواصفات"><font><font>مواصفات</font></font></h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">تخصيص</th> + <th scope="col">الحالة</th> + <th scope="col">تعليق</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('HTML WHATWG', 'semantics.html#the-span-element', '<span>')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td> </td> + </tr> + <tr> + <td>{{SpecName('HTML5 W3C', 'text-level-semantics.html#the-span-element', '<span>')}}</td> + <td>{{Spec2('HTML5 W3C')}}</td> + <td>واجهة DOM هي الآن {{domxref("HTMLSpanElement")}}.</td> + </tr> + <tr> + <td>{{SpecName('HTML4.01', 'struct/global.html#edef-SPAN', '<span>')}}</td> + <td>{{Spec2('HTML4.01')}}</td> + <td> </td> + </tr> + </tbody> +</table> + +<h2 id="توافق_التصفح">توافق التصفح</h2> + + + +<p>{{Compat("html.elements.span")}}</p> + +<h2 id="انظر_أيضا"><font><font>انظر أيضا</font></font></h2> + +<ul> + <li>HTML {{HTMLElement("div")}} عنصر </li> +</ul> + +<div>{{HTMLRef}}</div> diff --git a/files/ar/html/element/tt/index.html b/files/ar/html/element/tt/index.html new file mode 100644 index 0000000000..30cfcc09f9 --- /dev/null +++ b/files/ar/html/element/tt/index.html @@ -0,0 +1,161 @@ +--- +title: '<tt>: The Teletype Text element (obsolete)' +slug: HTML/Element/tt +translation_of: Web/HTML/Element/tt +--- +<div>{{ obsolete_header() }}</div> + +<p><font><font>وعفا عليها الزمن </font></font><strong><font><font>HTML المبرقة الكاتبة عنصر نص</font></font></strong><font><font> ( </font></font><strong><code><tt></code></strong><font><font>) بإنشاء النص المضمن الذي يقدم باستخدام </font></font><a href="https://developer.mozilla.org/en-US/docs/Glossary/user_agent" title="وكيل المستخدم: وكيل المستخدم هو برنامج كمبيوتر يمثل الشخص ، على سبيل المثال ، متصفح في سياق الويب."><font><font>وكيل المستخدم</font></font></a><font><font> وجه الافتراضي أحادي المسافة الخط. </font></font><font><font>تم إنشاء هذا العنصر لغرض تقديم نص كما سيتم عرضه على شاشة عرض ثابت مثل نمط teletype أو نص فقط أو طابعة خط</font></font></p> + +<p><font><font>تُستخدم المصطلحات </font></font><strong><font><font>غير المتناسبة</font></font></strong><font><font> ، </font></font><strong><font><font>والنمط الأحادي</font></font></strong><font><font> ، </font></font><strong><font><font>والمونوسبيس</font></font></strong><font><font> بشكل تبادلي ولها نفس المعنى العام: فهي تصف حرفًا محرفًا تكون جميع أحرفه هي نفس عدد وحدات البكسل على نطاق واسع.</font></font></p> + +<p><font><font>هذا العنصر عفا عليه الزمن ، ومع ذلك. </font><font>يجب عليك استخدام أكثر مفيدة لغويا </font></font><a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/code" title="يعرض عنصر <code> HTML محتوياته بطريقة مصممة للإشارة إلى أن النص عبارة عن جزء قصير من رمز الكمبيوتر."><code><code></code></a><font><font>، </font></font><a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/kbd" title="يمثل عنصر إدخال لوحة مفاتيح HTML (<kbd>) امتدادًا للنص المضمن يشير إلى إدخال المستخدم النصي من لوحة المفاتيح أو الإدخال الصوتي أو أي جهاز إدخال نص آخر."><code><kbd></code></a><font><font>، </font></font><a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/var" title="يمثل عنصر HTML متغير (<var>) اسم متغير في تعبير رياضي أو سياق برمجة."><code><var></code></a><font><font>، أو</font></font><a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/samp" title="يتم استخدام عنصر عينة HTML (<samp>) لإحاطة النص المضمن الذي يمثل عينة (أو اقتباس) من برنامج كمبيوتر."><code><samp></code></a><font><font>عناصر النص المضمن الذي يحتاج إلى أن تقدم في نوع أحادي المسافة، أو </font></font><a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/pre" title="يمثل عنصر <pre> HTML النص المنسق مسبقًا والذي سيقدم بالضبط كما هو مكتوب في ملف HTML."><code><pre></code></a><font><font>شعارا لالمحتوى الذي ينبغي أن تقدم ككتلة منفصل.</font></font></p> + +<div class="note"><font><font>إذا لم يكن أي من العناصر الدلالية مناسبًا لحالة الاستخدام الخاصة بك (على سبيل المثال ، إذا كنت تحتاج ببساطة إلى عرض بعض المحتوى بخط غير تناسبي) ، فيجب أن تفكر في استخدام </font></font><a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/span" title="عنصر HTML <span> عبارة عن حاوية مضمنة عامة لمحتوى الصياغة ، والتي لا تمثل أي شيء بطبيعته. يمكن استخدامه لتجميع العناصر لأغراض التصميم (باستخدام صفات الصف أو الهوية) ، أو لأنها تتشارك في قيم السمات ، مثل lang."><code><span></code></a><font><font>العنصر ، وأن تصممه كما تريد باستخدام CSS. </font><font>و </font></font><a href="https://developer.mozilla.org/en-US/docs/Web/CSS/font-family" title="تحدد الخاصية CSS لعائلة الخط قائمة ذات أولوية من اسم عائلة خط واحد أو أكثر و / أو أسماء عامة للعنصر المحدد."><code>font-family</code></a><font><font>الخاصية هي مكان جيد للبدء</font></font></div> + +<table class="properties"> + <tbody> + <tr> + <th scope="row"><a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Content_categories"><font><font>فئات المحتوى</font></font></a></th> + <td> + <table> + <tbody> + <tr> + <td><a href="https://developer.mozilla.org/en-US/docs/HTML/Content_categories#Flow_content"><font><font>محتوى التدفق</font></font></a><font><font> ، </font><a href="https://developer.mozilla.org/en-US/docs/HTML/Content_categories#Flow_content"><font>ومحتوى </font></a></font><a href="https://developer.mozilla.org/en-US/docs/HTML/Content_categories#Phrasing_content"><font><font>الصياغة</font></font></a><font><font> ، ومحتوى واضح</font></font></td> + </tr> + </tbody> + </table> + </td> + </tr> + <tr> + <th scope="row">المحتوى المسموح به</th> + <td><a href="https://developer.mozilla.org/en-US/docs/HTML/Content_categories#Phrasing_content"><font><font>محتوى الصياغة</font></font></a><font><font> .</font></font></td> + </tr> + <tr> + <th scope="row">إغفال العلامة</th> + <td>لا شيء ، كل من علامة البداية والنهاية إلزامية.</td> + </tr> + <tr> + <th scope="row">الآباء المسموح بهم</th> + <td><font><font>ي عنصر يقبل </font></font><a href="https://developer.mozilla.org/en-US/docs/HTML/Content_categories#Phrasing_content"><font><font>محتوى الصياغة</font></font></a></td> + </tr> + <tr> + <th scope="row">يسمح أدوار ARIA</th> + <td>أي</td> + </tr> + <tr> + <th scope="row"> + <table> + <tbody> + <tr> + <th scope="row"><font><font>واجهة DOM</font></font></th> + </tr> + </tbody> + </table> + </th> + <td><a href="https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement" title="تمثل واجهة HTMLElement أي عنصر HTML. تقوم بعض العناصر بتنفيذ هذه الواجهة مباشرة ، بينما يقوم بعضها الآخر بتنفيذها من خلال واجهة توارثها."><code>HTMLElement</code></a></td> + </tr> + </tbody> +</table> + +<h2 id="السمات"><font><font>السمات</font></font></h2> + +<p><font><font>هذا العنصر يشمل فقط </font></font><a href="https://developer.mozilla.org/en-US/docs/Web/HTML/global_attributes"><font><font>السمات العالمية</font></font></a></p> + +<h2 id="أمثلة"><font><font>أمثلة</font></font></h2> + +<h3 id="المثال_الأساسي"><font><font>المثال الأساسي</font></font></h3> + +<p><font><font>يستخدم هذا المثال </font></font><code><tt></code><font><font>لإظهار النص الذي تم إدخاله والإخراج بواسطة تطبيق طرفي.</font></font></p> + +<pre class="brush:html"><p>Enter the following at the telnet command prompt: <code>set localecho</code><br /> + +The telnet client should display: <tt>Local Echo is on</tt></p> +</pre> + +<h4 id="نتيجة"><font><font>نتيجة</font></font></h4> + +<p>{{EmbedLiveSample("Basic_example", 650, 80)}}</p> + +<h3 id="تجاوز_الخط_الافتراضي"><font><font>تجاوز الخط الافتراضي</font></font></h3> + +<p>يمكنك تجاوز الخط الافتراضي للمتصفح - إذا كان المتصفح يسمح لك بذلك ، وهو أمر غير مطلوب - باستخدام CSS:</p> + +<h4 id="CSS">CSS</h4> + +<pre class="brush: css">tt { + font-family: "Lucida Console", "Menlo", "Monaco", "Courier", + monospace; +}</pre> + +<h4 id="HTML">HTML</h4> + +<pre class="brush: html"><p>Enter the following at the telnet command prompt: <code>set localecho</code><br /> + +The telnet client should display: <tt>Local Echo is on</tt></p></pre> + +<h4 id="نتيجة_2"><font><font>نتيجة</font></font></h4> + +<p>{{EmbedLiveSample("Overriding_the_default_font", 650, 80)}}</p> + +<h2 id="ملاحظات_الاستخدام"><a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/tt$edit#Usage_notes" rel="nofollow, noindex"><font><font>ملاحظات الاستخدام</font></font></a></h2> + +<p> </p> + +<p><font><font>يتم تقديم </font></font><code><tt></code><font><font>العنصر افتراضيًا باستخدام الخط الافتراضي غير المتناسب في المستعرض. </font><font>يمكنك إلغاء ذلك باستخدام CSS عن طريق إنشاء قاعدة باستخدام </font></font><code>tt</code><font><font>المحدد ، كما هو موضح في المثال </font></font><a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/tt#Overriding_the_default_font"><font><font>تجاوز الخط الافتراضي</font></font></a><font><font> أعلاه.</font></font></p> + +<p> </p> + +<div class="note"> +<p> </p> + +<p><font><font>التغييرات التي تمت تهيئتها بواسطة المستخدم على إعداد خط أحادي المسافة الافتراضي قد تكون لها الأسبقية على CSS الخاص بك.</font></font></p> + +<p> </p> +</div> + +<p><font><font>على الرغم من أن هذا العنصر لم يتم إهماله رسميًا في HTML 4.01 ، إلا أنه تم تثبيط استخدامه بسبب العناصر الدلالية و / أو CSS. </font><font>و </font></font><code><tt></code><font><font>العنصر عفا عليه الزمن في HTML 5.</font></font></p> + +<h2 id="مواصفات"><a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/tt$edit#Specifications" rel="nofollow, noindex"><font><font>مواصفات</font></font></a></h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('HTML WHATWG', 'obsolete.html#tt', '<tt>')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td> </td> + </tr> + <tr> + <td>{{SpecName('HTML5 W3C', 'obsolete.html#elementdef-tt', '<tt>')}}</td> + <td>{{Spec2('HTML5 W3C')}}</td> + <td> </td> + </tr> + <tr> + <td>{{SpecName('HTML4.01', 'present/graphics.html#h-15.2.1', '<tt>')}}</td> + <td>{{Spec2('HTML4.01')}}</td> + <td> </td> + </tr> + </tbody> +</table> + +<h2 id="التوافق_المتصفح"><a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/tt$edit#Browser_compatibility" rel="nofollow, noindex"><font><font>التوافق المتصفح</font></font></a></h2> + + + +<p>{{Compat("html.elements.tt")}}</p> + +<h2 id="See_also" name="See_also"><a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/tt$edit#See_also" rel="nofollow, noindex"><font><font>انظر أيضا</font></font></a></h2> + +<ul> + <li>The semantic {{HTMLElement("code")}}, {{HTMLElement("var")}}, {{HTMLElement("kbd")}}, and {{HTMLElement("samp")}} elements</li> + <li> |