مساء السعادة،
اقترحت عليّ الأستاذة نوف هذا الموضوع، فبارك الله فيها.
لننقل هنا السؤال نصيًا ونجيب عليه بعون الله:
كيف يتم كتابه الكتب التقنية بالعربي
مثل كتب لغات البرمجةترجمه المصطلحات بطريقة يسهل على أي شخص فهمها أمر
صعب 😅و كيف يتم تقسيم هيكل الكتاب اذا كان موجه للمبتدئين
جدول المحتويات
- جدول المحتويات
- كيف تؤلِّف كتابًا تقنيًا؟
- اللغات البرمجية لغات مستقلة عن اللغات الطبيعية
- كيفية هيكلة كتاب تقني موجّه للمبتدئين؟
كيف تؤلِّف كتابًا تقنيًا؟
لنبدأ بالقسم الأول من السؤال:
كيف يتم كتابه الكتب التقنية بالعربي
مثل كتب لغات البرمجة
لديّ صديق اسمه عبد الهادي الأندلسي هو نفسه مطوّر موقع رديف، أصدر في وقت غير بعيد كتابًا عنوانه سلسلة تعلم Next.js بالعربية، صحيح أنه ترجمة لأصل إنجليزي لكن فيه إضافات منها ما كتبه في المقدمة:
هذا الكتيّب يحوي 120 صفحة بعد ترخيص من كاتبها فلافيُو كوبس. كان قد شرحها مطلع سنة 2019 بنسخة Next.js إصدار 9 القديم. والآن وصل إصدار الإطار العمل إلى النسخة 10+ وقد ألغيت العديد من الخصائص والأدوات. فعمدت إلى تنقيحها وتحديثها من جديد كما عمدت إلى تعريف وشرح مصطلحات إضافية مثل “built-in” مثلا لم يشرحها الكاتب لمعرفتي بعدم توفّرها باللغة العربية.
سلسلة تعلم Next.js بالعربية [مدونة عبدالهادي الأندلسي] التغميق مني
إذًا المختصر: تُؤلّف الكتب التقنية باللغة العربية مثل كتب لغات البرمجة وأُطرها بعدة طرق منها:
- مشاركة تجربتك الشخصية في تعلم تلك التقنية والعمل بها وهنا يكون الكتاب عرضًا لكيف تعلمت اللغة المعنية، وما أفضل سبل ومصادر لتعلمها، ثم كيف عملت بها وما المشاريع التي أنجزتها بها وكيف طوّرتها بالتفصيل ثم نصائح ختامية ليبقى قارئ الكتاب مطلعًا
- ترجمتها من أصل إنجليزي بإذن مؤلّفها والزيادة عليها من خبرتك إن رأيت الحاجة لذلك
وسبب الترجمة أن 99 بالمئة الآن من المعرفة التقنية تُنتج في الغرب ولا ننتجها نحن، إلا إن اخترعتَ لغة برمجية من نفسك وحتى هذه ستحتاج للترجمة فيها لأنه لكي تعمل لا بد أن تبنيها على بُنى برمجية غربية بنهاية المطاف.
بالتالي لا مناص من الترجمة في هذا الموضوع ما يؤدينا إلى الشقّ التالي من سؤالك:
ترجمه المصطلحات بطريقة يسهل على أي شخص فهمها أمر
صعب 😅
مرّة أخرى كَتب الأستاذ عبدالهادي الأندلسي تجربته القيّمة جدًا في ترجمة المصطلحات في هذا المقال الذي أصنّفه بخمس نجوم والذي لا بدّ أن تطالعيه كاملًا: لماذا نحتاج إلى تعريب المراجع البرمجية قبل شرحها؟ تجربتي في ترجمة التوثيقات البرمجية إلى العربية.
وهو مقال لم يترك لي ما أضيفه أساسًا في هذا المنحى لأنه ذكر مصادره وتجربته العملية وكل شيء بارك الله فيه.
بالتالي ما يمكن إضافته هو سرد لائحة للمصادر التي تساعدك على التعريب وترجمة المصطلحات، وهي:
- موسوعة حسوب وهي مكتبة عربية للتوثيق البرمجي فيها كثير من المصطلحات المعرّبة وغالبًا ستجدين فيها ضالتك
- القاموس التقني من عربآيز
- مسرد المصطلحات التقنية من إم آي تي تكنولوجي ريفيو
- معجم المصطلحات التقنية من ThinkTech
- اجتهادات من سبقك من المطوّرين مثل جهود عبدالهادي الأندلسي وغيره
- سؤال التقنيين مثل:
- بعد هذا يمكنك الاجتهاد شخصيًا على ضوء توصيات عبدالهادي جعفر في مقاله الممتاز عن التعريب التقني
اللغات البرمجية لغات مستقلة عن اللغات الطبيعية
لَفَتَ انتباهي تعبير للأستاذة نوف ما يستلزم مني توضيحًا هو
يسهل على أي شخص فهمها
والحقيقة أن اللغات البرمجية لغات مختلفة مستقلة عن اللغة الأم. يظن البعض أن كل ناطق بالإنجليزية فهو مؤهل أن يفهم البرمجة ولغاتها وأُطرها مثلما يشرب الماء. لأنه وفق هذا المنطق والتفكير: حسنًا… هي بلغته صح؟
الجواب: لا. هي بلغة أخرى. لغة برمجية لديها اسم ونحوُ ونظام خاصّ بها. وهي تختلف عن اللغات الطبيعية.
صحيح أن الإنجليزي يتمتع بمصادر وفيرة بلغته الأم يمتحُ منها ما يشاء ويرتع في حدائقها المعرفية؛ لكن كما قال نافال رافيكانت ذات مرة:
ليس في هذا العصر أكثر من مصادر التعلّم المجانية ولا أقلّ من الرغبة في التعلّم
ما يقصده أنه وحتى لما ترى المبرمجين فنادرًا ما ترى إنجليزيًا أصيلًا أمريكيًا قُحًّا يبرمج بمستوى عالٍ؛ ولو فعل فسيبرمج لفترة محدودة فحسب؛ لأنه سيؤسس شركة ويوظف ما لا حصر له من المبرمجين العباقرة من مختلف أنحاء العالم غالبًا ما يكونون من خارج أمريكا أو مهاجرين لها.
السبب أنه لصعوبة المجال وقلّة من يصبر عليه أصبح كأنه طريق مضمون لأن تُوظّف ولا يصبر على تعلّم البرمجة إلا قلّة قليلة وقد عدّوهم فوجدوا أنه نسبتهم لا تتجاوز 0.3 % من مجموع البشر!
فمثلًا وأنا أكتب لك هذا الآن لو شرعتُ شخصيًا في تعلّم بايثون وتقدّمت فيها ولو قليلًا فسأنضم لنخبة قليلة العدد جدًا ممن يتقنها مقارنة بإجمالي سكان العالم. يعني سأكون ومع أني في هذه الفرضية لم أتقنها كليًا- من الـ0.1 بالمئة من سكان العالم الذين لديهم تلك الخبرة التقنية.
بالتالي اللغات البرمجية ليس مشكلتها لغوية. إنما في صعوبة تعلّمها على الجميع. ففكّري في ذلك مليًّا.
البرمجةُ بأي لغة علم ليس سهلًا بالتالي سهولة الفهم ليست في شرح المصطلح. لماذا؟
لأن المصطلح -في أي لغة- لا يعطي مفهومهُ وما هو من نفسه بمجرد تسميته.
مثل: تيّار الوعي وهو مصطلح في النقد الأدبي، أنت عربية تفهمين ما معنى تيّار وما معنى وعي. لكن لا تعرفين ما هو تيّار الوعي معًا. لأن هذه العبارة مثل مصطلحات أخرى في أي لغة بشرية. لا بد أن تُشرح.
وهناك من سيشرحها لك بتعقيد وهناك من يقرّبها لفهمك. فأدركنا الآن أن الشارح والمعلّم هو الحجر الأساس لتقريب المفاهيم لا المصطلحات وبراعة ترجمتها. فركّزي على تسهيل عملية نقل المعلومات لقارئك أو المتلقي.
فلا تسعي بارك الله فيك لترجمة المصطلحات بحيث تشرح المصطلحات نفسها للقارئ دون شرح منك وتعلّم من المُتعلِّم لأن ذلك مُتعذّر.
يعني لا تتصوّري أنه لو أجرينا استبيانًا الآن وسألنا الإنجليزي:
في سياق برمجي ما الذي يعنيه بفكرك -حتى لو لم تدرس البرمجة- مصطلح Static Pre-Rendering؟
فصدّقيني لن يأتي أحد منهم بجواب صحيح. سيتمكنون من شرح كل كلمة على حدة مثل ستاتك وتعني ساكن أو ثابت؛ لكن مجموع العبارة لن يدلّهم من نفسه على ماذا يعنيه في سياق البرمجة.
والسبب في ذلك أن المصطلحات مُحددات وُضعت لتمييز الأمور عن بعضها لكن لم توضع لكي يَفهم منها كل قارئ لها أو مستمع ما تعنيه بدقة.
لأنه لو كان ذلك كذلك لتعلّم الجميع عن بكرة أبيهم البرمجة. وهذا لم يحصل. ولن يحصل.
كيفية هيكلة كتاب تقني موجّه للمبتدئين؟
والآن للشق الأخير من السؤال:
و كيف يتم تقسيم هيكل الكتاب اذا كان موجه للمبتدئين
كلّ كتاب في العالم مكوّن مما يلي:
- مقدمة
- أبواب أو أقسام مثل:
- الباب الأول/القسم الأول
- فصول
- فصل 1
- فصل 2
- فصل …
- الباب الثاني/القسم الثاني
- الفصل 1
- الفصل 2
- الفصل ….
- الباب الأول/القسم الأول
- الخاتمة
وحتى إن فقد بعض عناصره سيظل كتابًا لكننا سنقول أنه كتاب دون مقدمة مثل الموطأ.
نقطة مهمة للكتب التقنية
يستحسن وضع الكتب التقنية بهيئة كتاب لكن بصورة موقع رقمي. يمكنك استخدام ميزة كتب غت هب كما فعل عبدالهادي في توثيق AlpineJs بالعربية لأنه يَسهُل وقتها تحديثها والزيادة عليها واستقبال الدعم المادي والمعنويّ. عكس الكتب الورقية أو الرقمية الثابتة يصعب الإضافة لها ويكسل المرء عن تحديثها.
في مثال حديث قد ينفعك من ناحية كيف أعدّ المبرمج كتابه رقميًا وما الأدوات التي استخدمها مثل Tailwind Ulysses وNetlify وGumroad…وأنه يحدّثه كل أسبوعين وربح منه: طالعي هذه التجربة الحديثة على موقع هاكر نيوز (Hacker News) الوصول المبكّر لكتابي عن iOS جنى لي 120 ألف دولار في عام واحدٍ. طالعي كذلك التعليقات فهي نافعة للغاية.
كيف تعدّين الكتاب للمبتدئين؟
- سخّري حسابك وحسابات أصدقائك على الشبكات الاجتماعية لطرح الأسئلة من مثل:
أعتزم تأليف كتاب رقمي عن تقنية كذا. ماذا تريد أن أتناوله؟ ساهم بردّك من فضلك
- ابحثي بعبارة التقنية نفسها في يوتيوب بالعربي والإنجليزي وحتى بلغات أخرى (الترجمة متاحة بترجمة غوغل) لأن الغرض ليس ترجمة احترافية هنا إنما معرفة ما يسأل عنه المبتدئون حول تلك التقنية
- لما تبحثين وتجدين الفيديوهات اذهبي لقسم التعليقات واقرأي أكبر عدد منها وسجلي الأسئلة المتكررة
- ابحثي بعبارة التقنية نفسها في كورا وفي قسم الأسئلة طالعي ما يسأل عنه الناس هناك. مثال بالصورة أدناه
ملاحظة: يمكنك البحث بالإنجليزية في كورا الإنجليزية كذلك لأن المبتدئين موجودون بكل اللغات بل هناك ستجدين أسئلة أكثر. لكن لأن جمهورك عربي فكورا عربي ممتازة.
بعد جمع الأسئلة من هذه المصادر. حاولي جمع أكبر عدد ممكن من الأسئلة. وسجلي المكرر منها.
ابحثي عن كتب بالإنجليزية في نفس التقنية. اختاري منها من 3 لـ5 وتمعّني في فهارسها لأخذ فكرة عن هياكلها.
والتوصية هنا لإنشاء هيكل كتاب تقني ممتاز أن تهندسي عكسيًا.
كيف ذلك؟
تجيبين عن هذا السؤال: ما النتيجة والثمرة التي سيجنيها من يُكمل الكتاب؟
ثم تقولين لنفسك:
ما هي الخطوات اللازمة للوصول إلى هذه النتيجة؟
من ثم انطلاقًا من النهاية/النتيجة تنشئين الخطوات المؤدية لها.
مثال:
أريد كتابة كتابة عن بايثون للمبتدئين.
أسأل: ما النتيجة التي سيخرج بها والثمرة التي سيجنيها من أكمل قرائته وتطبيقه؟
فيكون الجواب مثلًا: إنشاء أول سكربت برمجي يعمل ببايثون لإنجاز مهمة روتينية.
هنا أسأل نفسي: كيف يصل المرء لتلك المرحلة؟
ويكون الجواب:
- لا بد أن يعرف المرء أولًا ما هي بايثون
- ويعرف لماذا هي مهمة ولماذا نختارها لإنشاء السكربت المؤتمت دون غيرها؟
- ثم يعرف نحو هذه اللغة بما يساعده على التطبيق دون تشتيته بما لا يحتاجه
- ثم يعرف كيف يثبت بايثون على حاسوبه
- …
ثم من الاستلهام مما سبقك من هياكل الكتب والأسئلة التي يطرحها المبتدئون من المصادر التي أعلمتك بها. يمكن أن نخلص إلى قالب عامٍ مثل هذا المبيّن في الجدول أدناه لتأليف كتابة تقني.
طالع أيضًا…
ما هي المصادر التي تعينك على التدرّب في مجال الترجمة التقنية (سؤال وجواب)
السلام عليكم ومرحباً بكم جمعة مباركة عليكم يا ربّ. وصلني هذا السؤال من الأستاذ محمد عادل على البريد الإلكتروني: انا مترجم مبتدىء (مشروع مترجم) وفي اهدافي بإذن الله أن أتخصص في الترجمة التقنية فأريد أن أعرف كيف أبني نفسي بنفسي في هذا المجال خصوصًا ياريت تضيفلي بعض المصادر أو الكتب أو المواقع في هذا المجال…
| العنصر | ملاحظات |
| المقدمة | اكتبي فيها: سبب تأليف الكتاب أهمية هذه التقنية (استشهاد بأرقام طلبها في السوق مثلًا وانتشار استخدامها…) شكر من أعانك على التأليف |
| الأساسيات | * ما يحتاج القارئ أن يعرفه عن التقنية * ما يحتاج القارئ أن يحضِّره من معدات وبرمجيات للاستفادة من التقنية أو العمل بها |
| الأخطاء الشائعة وكيفية تجاوزها | إن كانت هناك معلومات شائعة خاطئة أو مشاكل شائعة تعترض كل من يرغب في استخدام التقنية المعنية أو تعلمها اجمعيها في فصل وضعي حلولها |
| إجابة سؤال 1 مما يسأله المبتدئون | هنا تختار من الأسئلة المكررة التي جمعتها في مرحلة الإعداد والتحضير وتجعل إجابتها فصلًا كاملًا أي مقالًا يلمّ بكل أبعاد الإجابة بحيث لا مزيد عليها |
| إجابة سؤال 2 مما يسأله المبتدئون | هنا تختار من الأسئلة المكررة التي جمعتها في مرحلة الإعداد والتحضير وتجعل إجابتها فصلًا كاملًا أي مقالًا يلمّ بكل أبعاد الإجابة بحيث لا مزيد عليها |
| إجابة سؤال…. مما يسأله المبتدئون | هنا تختار من الأسئلة المكررة التي جمعتها في مرحلة الإعداد والتحضير وتجعل إجابتها فصلًا كاملًا أي مقالًا يلمّ بكل أبعاد الإجابة بحيث لا مزيد عليها |
| تمارين وتطبيقات وحلولها | ضع بعض التمرينات والتطبيقات العملية ليحس القارئ بالإنجاز لما يكملها بنجاح. اجعلها يسيرة الحل ومتدرجة في الصعوبة |
| ملفات وقوالب للتحميل | وفّر تحميلات جاهزة لما يحتاجه القارئ الراغب في التعلم مثل الأكواد البرمجية القابلة للنسخ |
| الخاتمة | مصادر للاستزادة ودعوة لمشاركة الكتاب وإبداء الملاحظات لتحسينه مستقبلًا وأين يجد القارئ التحديثات وكيف يتابعك |
آمل أن المقال أجاب عن سؤالك، إن أعجبك شاركه ولك الأجر؛ أو شاركه واشترك في رديف ولك أجران.
أعجبك ما أصنعه من محتوى؟ تواصل معي الآن عبر واتساب. اضغط على الزرّ الأخضر
يونس يسأل: ما الكتب التقنية التي طالعتها؟
حقوق الصورة البارزة: Photo by Lorenzo Herrera on Unsplash
يونس بن عمارة 