سلام
داشتم پروژههای موجود در گیتهاب رُ جستجو میکردم که به یه پروژه رسیدم به اسم
free-programming-booksاما خب کار این پروژه چیه؟
هدفش جمعآوری کلیه منابع آموزشی مرتبط به کامپیوتر توی یه جای واحد
تا حالا پروژه به زبونهای مختلفی مثل انگلیسی ،فرانسوی،آلمانی،ایتالیایی ،ژاپنی،روسی،چینی،پرتغالی و از امروز فارسی منتشر میشه
همونطور که گفتم تنها کار این پروژه جمعاوری تمامی منابع مرتبط به کامپیوتر به زبون موردنظر ما(فارسی) در یکجاست
خب پروژه خوبیه
هدف من اینه که اول پروژهی فارسی رُ تا یه جایی پیش ببریم و بعدش جداش کنیم و به کمک برنچ gh-pages یه صفحه جدا ازش درست کنیم
اما خب برای تکمیل و رسیدن به هدف بالا نیاز به همیاری شماست.
اما چجوری؟
###################راهنمای استفاده از گیتهاب###################
اول اینکه توی
گیتهاب ثبتنام کنین
به کمک این دوتا راهنما خودتونو به گیتهاب بشناسونین
کار بعدی اینه که به این صفحه برین و از اون بالا روی fork کلیک کنین
اینم راهنماش
فورک کردن یعنی اینکه یه نسخه از پروژه روی ریپوزیتوریهای شما کپی میشه تا شما توسعهاش بدین
بعد به صفحهی زیر برین تا مطمئن شید که عملیات فورک به درستی انجام شده
https://github.com/your_name/free-programming-books
your_name رُ با نام کاربری گیتهابتون عوض کنین
اگه درست بود توی ترمینال این دستور رُ بزنین تا یه نسخه از پروژه رُ توی کامپیوترتون داشته باشین
git clone https://github.com/your_name/free-programming-books.git
دوباره میگم که از این راهنما میتونین استفاده کنین
کار بعدی اینه که ویرایش هاتونو انجام بدین توی کامپیوترتون و با کمک لینک زیر اونو بفرستین به گیت هاب
و به صفحهی خودتون برید که میشه این
https://github.com/your_name/free-programming-books
و pull request رُ بزنین تا فرستاده بشه برای پروژه اصلی
به همین سادگی
البته یادتون نره که داکیومنتهای خود گیتهاب رُ هم مطالعه کنین
#####################ویرایش و قالب بندی فایل####################
چیزی که مهمه اینه که شما باید فایل
free-programming-books-fa.md رُ ویرایش کنین و با بقیهی فایلها کاری نداشته باشین چون به ما مربوط نیستن
اما قالب بندی چطوریه؟
بخش اول که شامل زیر مجموعهی Index### هست و تایتلها و سابتایتلهای موجود تو فایله
که قالب بندی اون به شکل زیر هست
Index###
* [JavaScript](#javascript)
* [Backbone.js](#backbonejs)
* [D3.js](#d3js)
* [jQuery](#jquery)
* [Knockout.js](#knockout.js)
* [Node.js](#nodejs)
همونطور که ملاحظه میکنین موضوع اصلی مربوط به جاوا اسکریپت هست و ایندنتگذاری زیر شاخههاش به چه صورته
پس اول یه * می زاریم بعدش یه فاصله و بعدش اسم موضوع داخل [ ] و بلافاصله بعد از اون پرانتز باز و بعدش # (برای لینک دهی به اون موضوع) و اسم موضوع و پرانتز بسته
البته یادتون نره که اسمها باید به زبون فارسی باشه
درست مثل مثال زیر
Index###
* [گنو/لینوکس](#گنو/لینوکس)
*[آرچ لینوکس](#آرچ-لینوکس)
(البته نمیدونم چرا انجمن بههم ریخته نشونش میده .فایل رُ باز که بکنین شیوه صحیح فارسی رُ میبینین داخلش)
که گنو/لینوکس موضوع اصلی و آرچ لینوکس زیر موضوع نام داره
بخش دوم که شامل موضوع اصلی هست
این بخش بعد از اتمام Index### شروع شده و فراخوانیش اینجوریه
JavaScript###
بعد از اون میتونین لینکها تونو بزارین
به سادگی مثل روشی که بالا گفتم
اونم باز به مثال زیر توجه کنین
###JavaScript
* [Crockford's JavaScript](http://www.crockford.com/javascript/) - Douglas Crockford
* [Eloquent JavaScript](http://eloquentjavascript.net/) - Marijn Haverbeke
* [Learning JavaScript Design Patterns](http://www.addyosmani.com/resources/essentialjsdesignpatterns/book/) - Addy Osmani
* [JavaScript Bible](http://media.wiley.com/product_ancillary/28/07645334/DOWNLOAD/all.pdf) (PDF)
* [JavaScript Essentials](http://www.techotopia.com/index.php/JavaScript_Essentials)
با تایتل موضوع اصلی آغاز شده که اینجا javascript هست
ستاره و بعدش اسم کتاب داخل [ ] و بلافاصله پرانتز و لینک اون آموزش داخل پرانتز و اگر فرمت خاصی داشت ( مثل پیدیاف ) اسم اون فرمت داخت پرانتز دیگه ای و با یه فاصله بعد از اون
به همین سادگی
بخش سوم که شامل ریز موضوع هست.
یادتونه بالا گفتم که ریز موضوع ها ایندنت گذاری میشن اینم باز همون مثال
* [JavaScript](#javascript)
* [Backbone.js](#backbonejs)
* [D3.js](#d3js)
* [jQuery](#jquery)
* [Knockout.js](#knockout.js)
* [Node.js](#nodejs)
که backbone.js و jQuery و ... زیر مجموعههای java script هستن
باز خونی زیر موضوعها به همین سادگی هست که به جای سهتا شارپ # از ۴ تا استفاده میکنیم
یه مثال برای درک بهتر
###JavaScript
* [Crockford's JavaScript](http://www.crockford.com/javascript/) - Douglas Crockford
* [Eloquent JavaScript](http://eloquentjavascript.net/) - Marijn Haverbeke
* [Learning JavaScript Design Patterns](http://www.addyosmani.com/resources/essentialjsdesignpatterns/book/) - Addy Osmani
* [JavaScript Bible](http://media.wiley.com/product_ancillary/28/07645334/DOWNLOAD/all.pdf) (PDF)
* [JavaScript Essentials](http://www.techotopia.com/index.php/JavaScript_Essentials)
* [jQuery Fundamentals](http://jqfundamentals.com/book/) (starts with JavaScript basics)
* [Mozilla Developer Network's JavaScript Guide](https://developer.mozilla.org/en/JavaScript/Guide)
* [JavaScript Allongé](https://leanpub.com/javascript-allonge/read)
* [O'Reilly Programming JavaScript Applications - Early Release](http://chimera.labs.oreilly.com/books/1234000000262/index.html)
* [The JavaScript Tutorial](http://javascript.info/)
* [AngularJS in 60 Minutes](http://fastandfluid.com/publicdownloads/AngularJSIn60MinutesIsh_DanWahlin_May2013.pdf) (PDF)
* [Dev Docs](http://devdocs.io/)
* [Managing Space and Time with JavaScript - Book 1: The Basics](http://www.noelrappin.com/) - Noel Rappin
####Backbone.js
* [Developing Backbone.js Applications](http://addyosmani.github.io/backbone-fundamentals/)
* [A Complete guide for learning Backbone.js](http://www.codebeerstartups.com/2012/12/a-complete-guide-for-learning-backbone-js/)
####D3.js
* [Interactive Data Visualization for the Web](http://chimera.labs.oreilly.com/books/1230000000345/index.html)
* [D3 Tips and Tricks](https://leanpub.com/D3-Tips-and-Tricks)
به همین سادگی و خوشمزگی
###########################نکات############################
۱-سعی کنین قالببندی کاملاً حفظ بشه
۲-اسم موضوع و زیر موضوعها که با ### یا #### فراخوانی میشن باید با اونی که توی Index### گذاشته بودین (همونی که اولش # داشت) همخونی داشته باشه
۳-سعی کنین لینکهای ولید بدین و اگه پیدیاف هست لینک مستقیم باشه نه لینکی به یه آپلود سنتر دیگه
۴- اگه حرفهای نیستین میتونین ریپوزیتوری منو فورک و کلون کنین تا اگه pull request فرستادین و فایل ایراد داشت مستقیم نرسه به پروژه اصلی و من ویرایشش کنم و بعد بفرستم ( چون پروژه اصلی مسلماً فارسی بلد نیستن و همینطوری اوکی میکنن که اگه خرابی توش باشه نمیتونن بغهمم چی به چیه چون فایل به زبون فارسیه)
کلون کردن از ریپوزیتوری من
git clone https://github.com/numb95/free-programming-books.git
همچنین لینک ریپوی من برای فورک کردن
https://github.com/numb95/free-programming-books۵-پروژههای دیگهبه زبونهای دیگه رُ کار نداشته باشین
۶- دموی کار
۷-توصیه اکید من فورک کردن از ریپوی من هست اینجوری راحت تر میشه بهش سر و سامان داد ولی میتونین از پروژه اصلی فورک کنین
۸- اگه دسترسی به گیتهاب ندارین تو این تاپیک لینکهاتونو بدین تا من بفرستم
۹-بحث و تبادل نظر در همین تاپیک و سعی بشه که تاپیک به گمراهه نکشه
۱۰-لیست کتابها اگه اضافه بشن توی همین تاپیک خواهد بود
Happy Hacking
#################### لیست کتابها و آموزشها####################
لیست کتابها و آموزشها که به مرور زمان تکمیل میشه
یه نسخه از این فایل رُ میتونین
اینجا ببینین
گنو/لینوکس توزیعهای گنو/لینوکس
آرچ لینوکس
آرچبوک (pdf)