Skip to content

Commit

Permalink
Merge pull request #20079 from hassanMuhamad/dev
Browse files Browse the repository at this point in the history 
Docs: Added more pages
  • Loading branch information
@mrdoob
mrdoob committed Aug 16, 2020
2 parents f119b45 + 6671b86 commit 1c09e7d
Show file tree
Hide file tree
Showing 6 changed files with 578 additions and 1 deletion.
6 changes: 5 additions & 1 deletion docs/list.js
View file
Original file line number Diff line number Diff line change
Expand Up @@ -466,7 +466,11 @@ var list = {

"البدء": {
"إنشاء مشهد": "manual/ar/introduction/Creating-a-scene",
"التنصيب": "manual/ar/introduction/Installation",
"التثبيت": "manual/ar/introduction/Installation",
"دعم المتصفح": "manual/ar/introduction/Browser-support",
"WebGL فحص توافق": "manual/ar/introduction/WebGL-compatibility-check",
"كيف تدير الأشياء محليًا": "manual/ar/introduction/How-to-run-things-locally",
"Typescript إعدادات": "manual/ar/introduction/Typescript-setup",
},

},
Expand Down
135 changes: 135 additions & 0 deletions docs/manual/ar/introduction/Browser-support.html
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,135 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<base href="../../../" />
<script src="list.js"></script>
<script src="page.js"></script>
<link type="text/css" rel="stylesheet" href="page.css" />
<style>
h1,
h2,
h3,
h4,
p,
ul,
table {
direction: rtl !important;
}
</style>
</head>
<body>
<h1>([name]) دعم المتصفح</h1>

<h2>نظرة عامة</h2>
<div>
<p>
يمكن لـ Three.js استخدام WebGL لعرض المشاهد الخاصة بك على جميع المتصفحات الحديثة. بالنسبة إلى المتصفحات الأقدم ، وخاصة Internet Explorer 10 والإصدارات الأقدم ، قد تضطر إلى الرجوع إلى أحد المستعرضات الأخرى [link:https://github.com/mrdoob/three.js/tree/master/examples/jsm/renderers renderers] (CSS2DRenderer و CSS3DRenderer و SVGRenderer). بالإضافة إلى ذلك ، قد تضطر إلى تضمين بعض polyfills ، بالأخص إذا كنت تستخدم ملفات من المجلد [link:https://github.com/mrdoob/three.js/tree/master/examples /examples].
</p>
<p>
ملاحظة: إذا لم تكن بحاجة إلى دعم هذه المتصفحات القديمة ، فلا يوصى باستخدام برامج العارض الأخرى لأنها أبطأ وتدعم ميزات أقل من WebGLRenderer.
</p>
</div>

<h2>المتصفحات التي تدعم WebGL</h2>
<div>
<p>
Google Chrome 9+, Firefox 4+, Opera 15+, Safari 5.1+, Internet Explorer 11 و Microsoft Edge.<br/>
يمكنك العثور على المتصفحات التي تدعم WebGL في [link:https://caniuse.com/#feat=webgl Can I use WebGL].
</p>
</div>

<h2>ميزات لغة JavaScript أو واجهات الويب البرمجية المستخدمة في three.js</h2>
<div>
<p>
فيما يلي بعض الميزات المستخدمة في three.js. قد يتطلب بعض منهم polyfills إضافية.
</p>
<table>
<thead>
<tr>
<th>الخاصية</th>
<th>نطاق الاستخدم</th>
<th>الوحدات</th>
</tr>
</thead>
<tbody>
<tr>
<td>Typed Arrays</td>
<td>Source</td>
<td>BufferAttribute, BufferGeometry, etc.</td>
</tr>
<tr>
<td>Web Audio API</td>
<td>Source</td>
<td>Audio, AudioContext, AudioListener, etc.</td>
</tr>
<tr>
<td>WebXR Device API</td>
<td>Source</td>
<td>WebXRManager</td>
</tr>
<tr>
<td>Blob</td>
<td>Source</td>
<td>FileLoader, etc.</td>
</tr>
<tr>
<td>Promise</td>
<td>Examples</td>
<td>GLTFLoader, DRACOLoader, BasisTextureLoader, GLTFExporter, VRButton, ARButton, etc.</td>
</tr>
<tr>
<td>Fetch</td>
<td>Examples</td>
<td>ImageBitmapLoader, etc.</td>
</tr>
<tr>
<td>File API</td>
<td>Examples</td>
<td>GLTFExporter, etc.</td>
</tr>
<tr>
<td>URL API</td>
<td>Examples</td>
<td>GLTFLoader, etc.</td>
</tr>
<tr>
<td>Pointer Lock API</td>
<td>Examples</td>
<td>PointerLockControls</td>
</tr>
</tbody>
</table>
</div>

<h2>Polyfills</h2>
<div>
<p>فقط قم باستيراد polyfills بناءً على متطلباتك. إذا أخذنا IE9 كمثال ، فأنت بحاجة إلى ملء هذه الميزات على الأقل:</p>
<ul>
<li>Typed Arrays</li>
<li>Blob</li>
</ul>
</div>

<h3>مقترح polyfills</h3>
<div>
<ul>
<li>
[link:https://github.com/zloirock/core-js core-js]
</li>
<li>
[link:https://github.com/inexorabletash/polyfill/blob/master/typedarray.js typedarray.js]
</li>
<li>
[link:https://github.com/stefanpenner/es6-promise/ ES6-Promise]
</li>
<li>
[link:https://github.com/eligrey/Blob.js Blob.js]
</li>
<li>
[link:https://github.com/github/fetch fetch]
</li>
</ul>
</div>
</body>
</html>
151 changes: 151 additions & 0 deletions docs/manual/ar/introduction/How-to-run-things-locally.html
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,151 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<base href="../../../" />
<script src="list.js"></script>
<script src="page.js"></script>
<link type="text/css" rel="stylesheet" href="page.css" />
<style>
h1,
h2,
h3,
h4,
p,
div {
direction: rtl !important;
}
</style>
</head>
<body>
<h1>كيف تدير الأشياء محليًا</h1>
<p>
إذا كنت تستخدم الأشكال الهندسية الإجرائية فقط ولا تقوم بتحميل أي مواد ، فيجب أن تعمل صفحات الويب مباشرة من نظام الملفات ، فقط انقر نقرًا مزدوجًا فوق ملف HTML في مدير الملفات
يجب أن يعرض محتوى الصفحة في المتصفح (سترى <em>file:///yourFile.html</em> في شريط العناوين).
</p>

<h2>المحتوى الذي تم تحميله من ملفات خارجية</h2>
<div>
<p>
إذا قمت بتحميل نماذج وأنسجة من ملفات خارجية ، نظرًا لقيود أمان المتصفحات [link:http://en.wikipedia.org/wiki/Same_origin_policy same origin policy] ، فسيفشل التحميل من نظام الملفات مع استثناء أمان.
</p>

<p>هناك طريقتان لحل هذا:</p>

<ol>
<li>
قم بتغيير أمان الملفات المحلية في المستعرض. يتيح لك ذلك الوصول إلى صفحتك على النحو التالي: <code>file:///yourFile.html</code>
</li>
<li>
قم بتشغيل الملفات من خادم ويب محلي. يتيح لك هذا الوصول إلى صفحتك على النحو التالي: <code>http://localhost/yourFile.html</code>
</li>
</ol>

<p>
إذا كنت تستخدم الخيار 1 ، فاعلم أنك قد تفتح نفسك لبعض نقاط الضعف إذا كنت تستخدم نفس المتصفح لتصفح الويب. قد ترغب في إنشاء ملف تعريف / اختصار متصفح منفصل يستخدم فقط للتطور لتكون في مأمن. دعنا نمر إلى كل خيار على حدة.
</p>
</div>


<h2>قم بتشغيل خادم محلي</h2>
<div>
<p>
تحتوي العديد من لغات البرمجة على خوادم HTTP بسيطة مضمنة فيها. فهي ليست كاملة الميزات مثل خوادم الإنتاج مثل [link:https://www.apache.org/ Apache] أو [link:https://nginx.org NGINX] ، ولكن يجب أن تكون كافية لاختبار تطبيق three.js الخاص بك.
</p>

<h3>إضافات لمحررات الأكواد الأكثر إستعمالا</h3>
<div>
<p>تحتوي بعض برامج تحرير الأكواد على مكونات إضافية والتي ستنتج خادمًا بسيطًا عند الطلب.</p>
<ul>
<li>[link:https://marketplace.visualstudio.com/items?itemName=ritwickdey.LiveServer Live Server] لـ Visual Studio Code.</li>
<li>[link:https://atom.io/packages/atom-live-server Live Server] لـ Atom.</li>
</ul>
</div>

<h3>Servez</h3>
<div>
<p>
[link:https://greggman.github.io/servez Servez] هو خادم بسيط مع واجهة المستخدم.
</p>
</div>

<h3>Node.js http-server</h3>
<div>
<p>يحتوي Node.js على حزمة خادم HTTP بسيطة. لتثبيت:</p>
<code>npm install http-server -g</code>

<p>للتشغيل (من دليلك المحلي):</p>
<code>http-server . -p 8000</code>
</div>

<h3>خادم Python</h3>
<div>
<p>
إذا كان لديك [link:http://python.org/ Python] مثبتًا ، فيجب أن يكون كافيًا لتشغيل هذا من سطر أوامر (من دليل العمل الخاص بك):
</p>
<code>
//Python 2.x
python -m SimpleHTTPServer

//Python 3.x
python -m http.server
</code>

<p>سيخدم هذا الملفات من الدليل الحالي في المضيف المحلي تحت المنفذ 8000 ، كمثال في شريط العنوان اكتب:</p>

<code>http://localhost:8000/</code>
</div>

<h3>خادم Ruby</h3>
<div>
<p>إذا قمت بتثبيت Ruby ، فيمكنك الحصول على نفس النتيجة بتشغيل هذا بدلاً من ذلك:</p>
<code>
ruby -r webrick -e "s = WEBrick::HTTPServer.new(:Port => 8000, :DocumentRoot => Dir.pwd); trap('INT') { s.shutdown }; s.start"
</code>
</div>

<h3>خادم PHP</h3>
<div>
<p>تحتوي PHP أيضًا على خادم ويب مدمج ، بدءًا من php 5.4.0:</p>
<code>php -S localhost:8000</code>
</div>

<h3>Lighttpd</h3>
<div>
<p>
Lighttpd هو خادم ويب خفيف الوزن للغاية للأغراض العامة. سنغطي تثبيته على OSX مع HomeBrew هنا. على عكس الخوادم الأخرى التي تمت مناقشتها هنا ، فإن lighttpd هو خادم جاهز للإنتاج الكامل.
</p>

<ol>
<li>
تثبيته بواسطة homebrew
<code>brew install lighttpd</code>
</li>
<li>
قم بإنشاء ملف ترتيب (configuration) يسمى lighttpd.conf في المجلد حيث تريد تشغيل خادم الويب الخاص بك. يوجد نموذج [link:http://redmine.lighttpd.net/projects/lighttpd/wiki/TutorialConfiguration here].
</li>
<li>
في ملف conf ، قم بتغيير server.document-root إلى الدليل الذي تريد خدمة الملفات منه.
</li>
<li>
شغله من خلال الأمر التالي:
<code>lighttpd -f lighttpd.conf</code>
</li>
<li>
انتقل إلى http://localhost:3000 وسيخدم الملفات الثابتة من الدليل الذي تختاره.
</li>
</ol>
</div>
<h3>IIS</h3>
<div>
<p>إذا كنت تستخدم Microsoft IIS كخادم ويب. الرجاء إضافة إعدادات نوع MIME فيما يتعلق بامتداد .fbx قبل التحميل.</p>
<code>File name extension: fbx MIME Type: text/plain</code>
<p>بشكل تلقائي ، يقوم IIS بحظر تنزيل ملفات .fbx و .obj. يجب عليك تعديل IIS لتمكين تنزيل هذا النوع من الملفات.</p>
</div>
<p>
تمت مناقشة البدائل البسيطة الأخرى هنا [link:http://stackoverflow.com/q/12905426/24874 here] على Stack Overflow.
</p>
</div>

</body>
</html>
Loading

0 comments on commit 1c09e7d

Please sign in to comment.