diff --git a/CONTRIBUTING-es.md b/CONTRIBUTING-es.md index 6ebad5a0c172ac3c98012981ab848b90539a4d4c..dfb7f4b50b449f3a99f68dbeab2f89847ef0dc0d 100644 --- a/CONTRIBUTING-es.md +++ b/CONTRIBUTING-es.md @@ -1,4 +1,4 @@ -*Lea esto en otros idiomas: [English](CONTRIBUTING.md), [简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh-TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md).* +*Lea esto en otros idiomas: [English](CONTRIBUTING.md), [Français](CONTRIBUTING-fr.md), [简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh-TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md).* ## Acuerdo de Licencia diff --git a/CONTRIBUTING-fa_IR.md b/CONTRIBUTING-fa_IR.md index 2f9c38da4eb9168bc5c31611c6f6f7a672591baa..d29c19b2984897b5be4c810c565ef7a08b93fb9a 100644 --- a/CONTRIBUTING-fa_IR.md +++ b/CONTRIBUTING-fa_IR.md @@ -1,4 +1,4 @@ -*این متن را در زبان‌های دیگر بخوانید: [English](CONTRIBUTING.md), [Español](CONTRIBUTING-es.md), [简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh-TW.md), [Tiếng Việt](CONTRIBUTING-vn.md).* +*این متن را در زبان‌های دیگر بخوانید: [English](CONTRIBUTING.md), [Français](CONTRIBUTING-fr.md), [Español](CONTRIBUTING-es.md), [简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh-TW.md), [Tiếng Việt](CONTRIBUTING-vn.md).*
## توافقنامه‌ی مجوز همکاری diff --git a/CONTRIBUTING-fr.md b/CONTRIBUTING-fr.md new file mode 100644 index 0000000000000000000000000000000000000000..d50471caa3715ed45e7391d61a8bb8aec294374f --- /dev/null +++ b/CONTRIBUTING-fr.md @@ -0,0 +1,217 @@ +*Lisez ceci dans d'autres langues: [English](CONTRIBUTING.md), [Español](CONTRIBUTING-es.md), [简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh-TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md).* + +## Contrat de Licence des Contributeurs +En contribuant, vous acceptez la [LICENCE](https://github.com/ElivreFoundation/free-programming-livres/blob/master/LICENSE) de ce repositoire. + +## Code de conduite des contributeurs +En contribuant, vous acceptez de respecter le [Code de Contrat](https://github.com/ElivreFoundation/free-programming-livres/blob/master/CODE_OF_CONDUCT.md) de ce repositoire. + +## En bref + +1. "Un lien pour télécharger facilement un livre" n'est pas toujours un lien vers un livre *gratuit*. Merci de ne contribuer qu'à du contenu gratuit. Assurez-vous que c'est gratuit. Nous n'acceptons pas les liens vers des pages qui *nécessitent* des adresses e-mail valides pour obtenir des livres, mais nous accueillons les annonces qui en font la demande. + +2. Vous n'êtes pas obligé de connaître Git : si vous avez trouvé quelque chose d'intéressant qui n'est *pas déjà dans ce repositoire*, veuillez ouvrir un [Problème](https://github.com/ElivreFoundation/free-programming-livres/issues) avec vos propositions de liens. + - Si vous savez Git, Forkez le repo et envoyez vos pull requests. +3. Nous avons 5 types de listes. Choisissez le bon: + + - *Livres* : PDF, HTML, ePub, un site basé sur gitlivre.io, un repositoire Git, etc. + - *Cours* : Un cours est un matériel d'apprentissage qui n'est pas un livre. [Ceci est un cours](http://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/). + - *Tutoriels interactifs* : Un site Web interactif qui permet à l'utilisateur de saisir du code ou des commandes et d'évaluer le résultat (par "évaluer" nous ne voulons pas dire "noter"). par exemple : [Essayez Haskell](http://tryhaskell.org), [Essayez Github](http://try.github.io). + - *Podcasts et Screencasts* : Podcasts et screencasts. + - *Ensembles de Problèmes et Programmation Compétitive* : Un site Web ou un logiciel qui vous permet d'évaluer vos compétences en programmation en résolvant des problèmes simples ou complexes, avec ou sans revue de code, avec ou sans comparaison des résultats avec d'autres utilisateurs. + +4. Assurez-vous de suivre les [directives ci-dessous](#directrices) et de respecter [la format Markdown](#formatage) des fichers. + +5. Travis CI exécutera des tests pour s'assurer que vos listes sont classées par ordre alphabétique et que les règles de formatage sont respectées. Assurez-vous de vérifier que vos modifications passent les tests. + +### Directrices +- assurez-vous qu'un livre est gratuit. Vérifiez si nécessaire. Cela aide les administrateurs si vous commentez dans le PR pourquoi vous pensez que le livre est gratuit. +- nous n'acceptons pas les fichiers hébergés sur google drive, dropbox, mega, scribd, issuu et autres plateformes de téléchargement de fichiers similaires. +- insérez vos liens par ordre alphabétique. Si vous voyez un lien égaré, veuillez le réorganiser et soumettre un PR +- utiliser le lien avec la source la plus autoritaire (c'est-à-dire que le site de l'auteur est meilleur que le site de l'éditeur, qui est meilleur qu'un site tiers) + + pas de services d'hébergement de fichiers (cela inclut (mais n'est pas limité à) les liens Dropbox et Google Drive) +- préférez toujours un lien `https` à un `http` - tant qu'ils sont sur le même domaine et servent le même contenu +- sur les domaines root, supprimez la barre oblique finale: `http://exemple.com` au lieu de `http://exemple.com/` +- préférez toujours le lien le plus court : `http://exemple.com/dir/` est préférable à `http://exemple.com/dir/index.html` + + pas de liens de raccourcissement d'URL +- préférez généralement le lien "actuel" à celui de "version": `http://exemple.com/dir/livre/current/` est meilleur que `http://exemple.com/dir/livre/v1.0.0 /index.html` +- si un lien a un certificat expiré/certificat auto-signé/problème SSL de toute autre nature: + 1. *remplacez-le* par son équivalent `http` si possible (car accepter les exceptions peut être compliqué sur les appareils mobiles) + 2. *laissez-le* si aucune version `http` n'est disponible mais que le lien est toujours accessible via `https` en ajoutant une exception au navigateur ou en ignorant l'avertissement. + 3. *supprimez-le* sinon. +- si un lien existe dans plusieurs formats, ajoutez un lien séparé avec une note sur chaque format +- si une ressource existe à différents endroits sur Internet + + utiliser le lien avec la source la plus autoritaire (c'est-à-dire que le site de l'auteur est meilleur que le site de l'éditeur, qui est meilleur qu'un site tiers) + + s'ils renvoient à des éditions différentes et que vous jugez que ces éditions sont suffisamment différentes pour qu'elles valent la peine d'être conservées, ajoutez un lien séparé avec une note sur chaque édition (voir [Problème #2353](https://github.com/ElivreFoundation/free-programming-livres/issues/2353) pour contribuer à la discussion sur le formatage.)) +- préférer les commits atomiques (un commit par ajout/suppression/modification) aux plus gros commits. Pas besoin d'écraser vos commits avant de soumettre un PR. (Nous n'appliquerons jamais cette règle car c'est juste une question de commodité pour les responsables) +- si le livre est plus ancien, indiquez la date de parution avec le titre. +- incluez le ou les noms de l'auteur, le cas échéant. Vous pouvez raccourcir les listes d'auteurs avec "et al." +- si le livre n'est pas terminé, et est toujours en cours de travail, ajoutez la notation "en cours", comme décrit [ci-dessous.](#in_process) +- si une adresse e-mail ou la configuration d'un compte est demandée avant l'activation du téléchargement, ajoutez des notes adaptées à la langue entre parenthèses, par exemple: `(adresse e-mail *demandée*, non obligatoire)` + +### Formatage +- Toutes les listes sont des fichiers `.md`. Essayez d'apprendre la syntaxe [Markdown](https://guides.github.com/features/mastering-markdown/). C'est simple! +- Toutes les listes commencent par un Index. L'idée est d'y lister et de lier toutes les sections et sous-sections. Gardez-le par ordre alphabétique. +- Les sections utilisent des titres de niveau 3 (`###`) et les sous-sections sont des titres de niveau 4 (`####`). + +l'idée est d'avoir: +- `2` lignes vides entre le dernier lien et la nouvelle section +- `1` ligne vide entre le titre et le premier lien de sa section +- `0` ligne vide entre deux liens +- `1` ligne vide à la fin de chaque fichier `.md` + +Exemple: + + [...] + * [Un Livre Génial](http://exemple.com/exemple.html) + (ligne blanche) + (ligne blanche) + ### Exemple + (ligne blanche) + * [Un Autre Livre Génial](http://exemple.com/livre.html) + * [Un Autre Livre](http://exemple.com/autre.html) + +- Mettez pas des espaces entre `]` et `(`: + +``` +MAUVAIS : * [Un Autre Livre Génial] (http://exemple.com/livre.html) +BIEN : * [Un Autre Livre Génial](http://exemple.com/livre.html) +``` + +- Si vous incluez l'auteur, utilisez ` - ` (un tiret entouré d'un espaces): + +``` +MAUVAIS : * [Un Autre Livre Génial](http://exemple.com/livre.html)- John Doe +BIEN : * [Un Autre Livre Génial](http://exemple.com/livre.html) - John Doe +``` + +- Mettez un seul espace entre le lien et son format: + +``` +MAUVAIS : * [Un Autre Livre Génial](https://exemple.org/livre.pdf)(PDF) +BIEN : * [Un Autre Livre Génial](https://exemple.org/livre.pdf) (PDF) +``` + +- L'auteur vient avant le format: + +``` +MAUVAIS : * [Un Autre Livre Génial](https://exemple.org/livre.pdf)- (PDF) Jane Roe +BIEN : * [Un Autre Livre Génial](https://exemple.org/livre.pdf) - Jane Roe (PDF) +``` + +- Formats multiples: + +``` +MAUVAIS : * [Un Autre Livre Génial](http://exemple.com/)- John Doe (HTML) +MAUVAIS : * [Un Autre Livre Génial](https://downloads.exemple.org/livre.html)- John Doe (site de téléchargement) +BIEN : * [Un Autre Livre Génial](http://exemple.com/) - John Doe (HTML) [(PDF, EPUB)](https://downloads.exemple.org/livre.html) +``` + +- Inclure l'année de publication dans le titre pour les livres plus anciens : + +``` +MAUVAIS : * [Un Autre Livre Génial](https://exemple.org/livre.html) - Jane Roe - 1970 +BIEN : * [Un Autre Livre Génial (1970)](https://exemple.org/livre.html) - Jane Roe +``` + + +- Livres en cours : + +``` +BIEN : * [Sera bientôt un livre génial](http://exemple.com/livre2.html) - John Doe (HTML) (:construction: *in process*) +``` + +### Remarques + +Bien que les bases soient relativement simples, il existe une grande diversité dans les ressources que nous répertorions. Voici quelques notes sur la façon dont nous gérons cette diversité. + +#### Métadonnées + +Nos listes fournissent un ensemble minimal de métadonnées : titres, URL, créateurs, plateformes et notes d'accès. + +##### Titres + +- Pas de titres inventés. Nous essayons de prendre les titres des ressources elles-mêmes ; les contributeurs sont avertis de ne pas inventer de titres ou de ne pas les utiliser éditorialement si cela peut être évité. Une exception est pour les œuvres plus anciennes; s'ils présentent principalement un intérêt historique, une année entre parenthèses ajoutée au titre aide les utilisateurs à savoir s'ils présentent un intérêt. +- Pas de titres TOUTES EN MAJUSCULES. Habituellement, la casse du titre est appropriée, mais en cas de doute, utilisez la majuscule de la source + +##### URLs + +- Nous n'autorisons pas les URL raccourcies. +- Les codes de suivi doivent être supprimés de l'URL. +- Les URL internationales doivent être échappées. Les barres du navigateur les rendent généralement en Unicode, mais utilisez le copier-coller, s'il vous plaît. +- Les URL sécurisées (https) sont toujours préférées aux URL non sécurisées (http) où https a été implémenté. +- Nous n'aimons pas les URL qui pointent vers des pages Web qui n'hébergent pas la ressource répertoriée, mais pointent plutôt ailleurs. + +##### Créateurs + +- Nous voulons créditer les créateurs de ressources gratuites le cas échéant, y compris les traducteurs ! +- Pour les œuvres traduites, l'auteur original doit être crédité. +- Nous n'autorisons pas les liens pour les créateurs. +- Pour les compilations ou les travaux remixés, le "créateur" peut avoir besoin d'une description. Par exemple, les livres "GoalKicker" sont crédités comme "Compilé à partir de la documentation StackOverflow" + +##### Plateformes et notes d'accès + +- Cours. Surtout pour nos listes de cours, la plateforme est une partie importante de la description de la ressource. En effet, les plates-formes de cours ont des options et des modèles d'accès différents. Bien que nous ne répertoriions généralement pas un livre nécessitant une inscription, de nombreuses plateformes de cours ont des options qui ne fonctionnent pas sans une sorte de compte. Des exemples de plates-formes de cours incluent Coursera, EdX, Udacity et Udemy. Lorsqu'un cours dépend d'une plateforme, le nom de la plate-forme doit être indiqué entre parenthèses. +- Youtube. Nous avons de nombreux cours qui se composent de listes de lecture YouTube. Nous ne répertorions pas Youtube comme plateforme, nous essayons de répertorier le créateur Youtube, qui est souvent une sous-plateforme. +- Vidéos youtube. Nous ne créons généralement pas de liens vers des vidéos YouTube individuelles, sauf si elles durent plus d'une heure et sont structurées comme un cours ou un didacticiel. +- Leanpub. Leanpub héberge des livres avec une variété de modèles d'accès. Parfois, un livre peut être lu sans inscription ; parfois un livre nécessite un compte Leanpub pour un accès gratuit. Compte tenu de la qualité des livres et du mélange et de la fluidité des modèles d'accès Leanpub, nous autorisons l'inscription de ces derniers avec la note d'accès *(compte Leanpub ou email valide demandé)* + +#### Genres + +La première règle pour décider à quelle liste appartient une ressource est de voir comment la ressource se décrit. S'il s'appelle un livre, alors c'est peut-être un livre. + +##### Genres que nous ne listons pas + +Parce qu'Internet est vaste, nous n'incluons pas dans nos listes: + +- les blogs +- articles de blog +- des articles +- des sites Web (à l'exception de ceux qui hébergent BEAUCOUP d'articles que nous répertorions.) +- des vidéos qui ne sont pas des cours ou des screencasts. +- les chapitres du livre +- échantillons teaser de livres +- Canaux IRC ou Telegram +- Slacks ou listes de diffusion + +Nos listes de programmation compétitive ne sont pas aussi strictes sur ces exclusions. La portée du repo est déterminée par la communauté ; si vous souhaitez suggérer un changement ou un ajout à la portée, veuillez utiliser un issue pour faire la suggestion. + +##### Livres vs. autres choses + +Nous ne sommes pas si pointilleux sur la livreté. Voici quelques attributs qui signifient qu'une ressource est un livre : + +- il a un ISBN (International Standard Book Number) +- il a une table des matières +- une version téléchargée, notamment ePub, est proposée +- il a des éditions +- cela ne dépend pas du contenu interactif ou des vidéos +- il essaie de couvrir un sujet de manière exhaustive +- il est autonome + +Il y a beaucoup de livres que nous listons qui n'ont pas ces attributs ; cela peut dépendre du contexte. + + +##### Livres vs. cours + +Parfois, ceux-ci peuvent être difficiles à distinguer! + +Les cours ont souvent des livres de texte associés, que nous énumérerions dans nos listes de livres. Les cours comportent des exposés, des exercices, des tests, des notes ou d'autres supports didactiques. Une seule conférence ou vidéo en soi n'est pas un cours. Un powerpoint n'est pas un cours. + + +##### Tutoriels interactifs vs. autres trucs + +Si vous pouvez l'imprimer et conserver son essence, ce n'est pas un didacticiel interactif. + + +### Automatisation + +- L'application des règles de formatage est automatisée via [Travis CI](https://travis-ci.com) en utilisant [fpb-lint](https://github.com/vhf/free-programming-livres-lint) (voir [ .travis.yml](.travis.yml)) +- La validation d'URL utilise [awesome_bot](https://github.com/dkhamsing/awesome_bot) +- Pour déclencher la validation d'URL, poussez un commit qui inclut un message de commit contenant `check_urls=file_to_check` : + +``` +check_urls=free-programming-livres.md free-programming-livres-en.md +``` + +- Vous pouvez spécifier plus d'un fichier à vérifier, en utilisant un seul espace pour séparer chaque entrée +- Si vous spécifiez plus d'un fichier, les résultats de la construction sont basés sur le résultat du dernier fichier vérifié. Vous devez savoir que vous pouvez obtenir des versions vertes de réussite à cause de cela, alors assurez-vous d'inspecter le journal de construction à la fin de la demande d'extraction en cliquant sur "Show all checks" -> "Details". diff --git a/CONTRIBUTING-vn.md b/CONTRIBUTING-vn.md index 0daabfa281aca62b9ca06357103895fb1a396c04..9c72c3830a46066cda9d75b3aad7c28d40f39368 100644 --- a/CONTRIBUTING-vn.md +++ b/CONTRIBUTING-vn.md @@ -1,4 +1,4 @@ -*Đọc bằng ngôn ngữ khác: [English](CONTRIBUTING.md), [Español](CONTRIBUTING-es.md), [体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh-TW.md), [فارسی](CONTRIBUTING-fa_IR.md).* +*Đọc bằng ngôn ngữ khác: [English](CONTRIBUTING.md), [Français](CONTRIBUTING-fr.md), [Español](CONTRIBUTING-es.md), [体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh-TW.md), [فارسی](CONTRIBUTING-fa_IR.md).* Bản dịch Tiếng Việt: @@ -28,7 +28,7 @@ Bằng cách đóng góp, bạn đồng ý tôn trọng [Quy Tắc Ứng Xử](h - *Podcasts and Screencasts* : Podcasts và screencasts. - *Đặt Vấn Đề & Cuộc Thi Lập Trình* : Trang web hoặc phần mềm cho phép bạn đánh giá kỹ năng lập trình của mình bằng cách giải quyết các vấn đề đơn giản hoặc phức tạp, có hoặc không có đánh giá Code, có hoặc không so sánh kết quả với những người khác. -4. Đảm bảo tuân thủ theo [những nguyên tắc bên dưới](#guidelines) và đảm bảo sử dụng đúng những [định dạng Markdown](#formatting). +4. Đảm bảo tuân thủ theo [những nguyên tắc bên dưới](#Những Nguyên Tắc) và đảm bảo sử dụng đúng những [định dạng Markdown](#Định Dạng). 5. Travis CI sẽ chạy các test để đảm bảo danh sách của bạn được sắp xếp theo thứ tự bảng chữ cái và các quy tắc định dạng được tuân thủ. Đảm bảo kiểm tra xem các thay đổi của bạn có vượt qua các bài test hay không. diff --git a/CONTRIBUTING-zh-TW.md b/CONTRIBUTING-zh-TW.md index 11ff7638da0a9f2bb12e593f79adce857d2f2d9f..bd17b2164690c03b3c6aa1c04865675eedaf0224 100644 --- a/CONTRIBUTING-zh-TW.md +++ b/CONTRIBUTING-zh-TW.md @@ -1,4 +1,4 @@ -*閱讀其他語言版本的文件:[English](CONTRIBUTING.md), [Español](CONTRIBUTING-es.md), [简体中文](CONTRIBUTING-zh.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md).* +*閱讀其他語言版本的文件:[English](CONTRIBUTING.md), [Français](CONTRIBUTING-fr.md), [Español](CONTRIBUTING-es.md), [简体中文](CONTRIBUTING-zh.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md).* ## 貢獻者許可協議 diff --git a/CONTRIBUTING-zh.md b/CONTRIBUTING-zh.md index 94565d6c9dfe2c8e966ba468bfc8630c7e950edc..f23a4692bf16b01d2b471e27dd8659b45b5a32d0 100644 --- a/CONTRIBUTING-zh.md +++ b/CONTRIBUTING-zh.md @@ -1,4 +1,4 @@ -*阅读本文的其他语言版本:[English](CONTRIBUTING.md), [Español](CONTRIBUTING-es.md), [繁體中文](CONTRIBUTING-zh-TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md).* +*阅读本文的其他语言版本:[English](CONTRIBUTING.md), [Français](CONTRIBUTING-fr.md), [Español](CONTRIBUTING-es.md), [繁體中文](CONTRIBUTING-zh-TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md).* ## 贡献者许可协议 diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 6c7936c2631bf19a1a68034e4fa705f8365d692f..404675fb36f8327783a9b78ed150de45dc45486a 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,4 +1,4 @@ -*Read this in other languages: [Español](CONTRIBUTING-es.md), [简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh-TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md).* +*Read this in other languages: [Français](CONTRIBUTING-fr.md), [Español](CONTRIBUTING-es.md), [简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh-TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md).* ## Contributor License Agreement By contributing you agree to the [LICENSE](https://github.com/EbookFoundation/free-programming-books/blob/master/LICENSE) of this repository. @@ -26,7 +26,7 @@ By contributing you agree to respect the [Code of Conduct](https://github.com/Eb - make sure a book is free. Double-check if needed. It helps the admins if you comment in the PR as to why you think the book is free. - we don't accept files hosted on google drive, dropbox, mega, scribd, issuu and other similar file upload platforms - insert your links in alphabetical order. If you see a misplaced link, please reorder it and submit a PR -- use the link with the most authoritative source (meaning author's website is better than editor's website is better than third party website) +- use the link with the most authoritative source (meaning the author's website is better than the editor's website, which is better than a third party website) + no file hosting services (this includes (but is not limited to) Dropbox and Google Drive links) - always prefer a `https` link over a `http` one -- as long as they are on the same domain and serve the same content - on root domains, strip the trailing slash: `http://example.com` instead of `http://example.com/` @@ -34,9 +34,9 @@ By contributing you agree to respect the [Code of Conduct](https://github.com/Eb + no URL shortener links - usually prefer the "current" link over the "version" one: `http://example.com/dir/book/current/` is better than `http://example.com/dir/book/v1.0.0/index.html` - if a link has an expired certificate/self-signed certificate/SSL issue of any other kind: - 1. *replace it* with its `http` counterpart if possible (because accepting exceptions can be complicated on mobile devices) - 2. *leave it* if no `http` version but link still accessible through `https` by adding an exception to the browser or ignoring the warning - 3. *remove it* otherwise + 1. *replace it* with its `http` counterpart if possible (because accepting exceptions can be complicated on mobile devices). + 2. *leave it* if no `http` version is available but the link is still accessible through `https` by adding an exception to the browser or ignoring the warning. + 3. *remove it* otherwise. - if a link exists in multiple format, add a separate link with a note about each format - if a resource exists at different places on the Internet + use the link with the most authoritative source (meaning author's website is better than editor's website is better than third party website) @@ -52,11 +52,11 @@ By contributing you agree to respect the [Code of Conduct](https://github.com/Eb - All the lists start with an Index. The idea is to list and link all sections and subsections there. Keep it in alphabetical order. - Sections are using level 3 headings (`###`), and subsections are level 4 headings (`####`). -The idea is to have -- `2` empty lines between last link and new section -- `1` empty line between heading & first link of its section -- `0` empty line between two links -- `1` empty line at the end of each `.md` file +The idea is to have: +- `2` empty lines between last link and new section. +- `1` empty line between heading & first link of its section. +- `0` empty line between two links. +- `1` empty line at the end of each `.md` file. Example: @@ -116,7 +116,7 @@ GOOD: * [A Very Awesome Book (1970)](https://example.org/book.html) - Jane Roe - In-process books: ``` -GOOD: * [Will Be Awesome Soon Book](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*) +GOOD: * [Will Be An Awesome Book Soon](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*) ``` ### Notes @@ -179,7 +179,7 @@ Our competitive programming lists are not as strict about these exclusions. The We're not that fussy about book-ness. Here are some attributes that signify that a resource is a book: -- it has an ISBN +- it has an ISBN (International Standard Book Number) - it has a Table of Contents - a downloaded version, especially ePub, is offered - it has editions diff --git a/HOWTO-es.md b/HOWTO-es.md index 10be262598e76001a8d08e885c0cb2c3b81f09a2..56664c72f84e700913da157e7f4c177b4eef1f1f 100644 --- a/HOWTO-es.md +++ b/HOWTO-es.md @@ -1,4 +1,4 @@ -Lea esto en otros idiomas: [English](HOWTO.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh-TW.md), [Português (BR)](HOWTO.pt_BR.md), [فارسی](HOWTO-fa_IR.md) +Lea esto en otros idiomas: [English](HOWTO.md), [Français](HOWTO-fr.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh-TW.md), [Português (BR)](HOWTO.pt_BR.md), [فارسی](HOWTO-fa_IR.md) Sea bienvenido a *Free-Programming-Books*! Damos una calurosa bienvenida a los nuevos colaboradores; incluso a aquellos que realizan su primera Pull Request (PR) en Github. Si es usted uno de ellos, aquí van algunos recursos que quizás le pueden ayudar: diff --git a/HOWTO-fa_IR.md b/HOWTO-fa_IR.md index 4b3eb658f3586c18f12c0d320a703b4fad3117b5..fe65e5595e334c810386871c58ef029aa0adb80a 100644 --- a/HOWTO-fa_IR.md +++ b/HOWTO-fa_IR.md @@ -1,4 +1,4 @@ -این متن را در زبان‌های دیگر بخوانید: [English](HOWTO.md), [Español](HOWTO-es.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh-TW.md), [Português (BR)](HOWTO.pt_BR.md) +این متن را در زبان‌های دیگر بخوانید: [English](HOWTO.md), [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh-TW.md), [Português (BR)](HOWTO.pt_BR.md)
به Free-Programming-Books خوش آمدید! ما به مشارکت‌کنندگان جدید خوش‌آمد می‌گوییم. حتی آنهایی که اولین پول‌ریکوئست خود را در گیت‌هاب می‌گذارند. اگر شما هم یکی از آنهایید، منابع زیر می‌توانند به شما کمک کنند. diff --git a/HOWTO-fr.md b/HOWTO-fr.md index 5ed84f26260ed32fe5133666b9dc88eb8a1eaf47..3be18d7a9130d18007f22c5b715039fc1c93013d 100644 --- a/HOWTO-fr.md +++ b/HOWTO-fr.md @@ -1,4 +1,4 @@ -Lisez ceci dans d'autres langues::[简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh-TW.md), [Português (BR)](HOWTO.pt_BR.md), [فارسی](HOWTO-fa_IR.md), [English](HOWTO.md) +Lisez ceci dans d'autres langues: [English](HOWTO.md), [Español](HOWTO-es.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh-TW.md), [Português (BR)](HOWTO.pt_BR.md), [فارسی](HOWTO-fa_IR.md) Bienvenue à Free-Programming-Books! Nous souhaitons la bienvenue aux nouveaux contributeurs; même ceux qui font leur toute première pull request sur Github. Si vous faites partie de ceux-ci, voici quelques ressources qui pourraient vous aider: diff --git a/HOWTO-hi.md b/HOWTO-hi.md index 6785d9f3f83be1cdebd6fcb438d2c9fcf8864460..ca9d4cb2e37e1a7cb417f90505c6db0e0b7d29b4 100644 --- a/HOWTO-hi.md +++ b/HOWTO-hi.md @@ -1,4 +1,4 @@ -इस लेख को अन्य भाषाओं में पढ़ें: [English](HOWTO.md), [Español](HOWTO-es.md), [简体中文](HOWTO-zh.md), [繁體中文](HOWTO-zh-TW.md), [Português (BR)](HOWTO.pt_BR.md), [فارسی](HOWTO-fa_IR.md) +इस लेख को अन्य भाषाओं में पढ़ें: [English](HOWTO.md), [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [简体中文](HOWTO-zh.md), [繁體中文](HOWTO-zh-TW.md), [Português (BR)](HOWTO.pt_BR.md), [فارسی](HOWTO-fa_IR.md) फ्री-प्रोग्रामिंग-पुस्तकों में आपका स्वागत है! हम नए योगदानकर्ताओं का स्वागत करते हैं; यहां तक ​​कि उन लोगों के लिए जो गिथब पर अपना पहला पुल अनुरोध करते हैं। यदि आप उनमें से एक हैं, तो यहां कुछ संसाधन हैं जो मदद कर सकते हैं: * [About Pull Requests](https://help.github.com/articles/about-pull-requests/) diff --git a/HOWTO-zh-TW.md b/HOWTO-zh-TW.md index 88be7387b8432e89f18428392b9f9e762748502c..3bce671a14b64badc5aaab02b8258a804bca5c1a 100644 --- a/HOWTO-zh-TW.md +++ b/HOWTO-zh-TW.md @@ -1,4 +1,4 @@ -閱讀本文的其他語言版本: [English](HOWTO.md), [Español](HOWTO-es.md), [हिन्दी](HOWTO-hi.md), [简体中文](HOWTO-zh.md), [Português (BR)](HOWTO.pt_BR.md), [فارسی](HOWTO-fa_IR.md) +閱讀本文的其他語言版本: [English](HOWTO.md), [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [Português (BR)](HOWTO.pt_BR.md), [فارسی](HOWTO-fa_IR.md) 歡迎使用 Free-Programming-Books!我們歡迎新的貢獻者;即使是在Github上首次提出 pull request 的人。如果您是其中之一,那麼以下資源可能會對你有所幫助: diff --git a/HOWTO-zh.md b/HOWTO-zh.md index 20ca448a96952193ead1674f00e87d7c547e9a68..5a475b0f72ac42923ba774e6208a04d5c5a513d1 100644 --- a/HOWTO-zh.md +++ b/HOWTO-zh.md @@ -1,4 +1,4 @@ -阅读本文的其他语言版本:[English](HOWTO.md), [Español](HOWTO-es.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh-TW.md), [Português (BR)](HOWTO.pt_BR.md), [فارسی](HOWTO-fa_IR.md) +阅读本文的其他语言版本:[English](HOWTO.md), [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh-TW.md), [Português (BR)](HOWTO.pt_BR.md), [فارسی](HOWTO-fa_IR.md) 欢迎使用 Free-Programming-Books(免费编程书籍)!我们欢迎新的贡献者;即使是在 Github 上首次提出拉取请求的人。如果您是其中之一,那么以下资源可能会有所帮助: diff --git a/HOWTO.md b/HOWTO.md index 3965c3261f7638697337ab3babbf9aca0b6a9d95..89696b3ebc1e529bce503c42ad4b0f6ce4d738bf 100644 --- a/HOWTO.md +++ b/HOWTO.md @@ -1,4 +1,4 @@ -Read this in other languages: [Español](HOWTO-es.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh-TW.md), [Português (BR)](HOWTO.pt_BR.md), [فارسی](HOWTO-fa_IR.md) +Read this in other languages: [Français](CONTRIBUTING-fr.md), [Español](HOWTO-es.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh-TW.md), [Português (BR)](HOWTO.pt_BR.md), [فارسی](HOWTO-fa_IR.md) Welcome to Free-Programming-Books! We welcome new contributors; even those making their very first pull request on Github. If you're one of those, here are some resources that might help: diff --git a/HOWTO.pt_BR.md b/HOWTO.pt_BR.md index aaa039c7ce44e1e0fbbebd10add5a37e14f4a19b..59d7061e108c43eb8c70bb4f1ac5dfa5307dac0a 100644 --- a/HOWTO.pt_BR.md +++ b/HOWTO.pt_BR.md @@ -1,4 +1,4 @@ -Leia em outras linguagens: [English](HOWTO.md), [Español](HOWTO-es.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh-TW.md) +Leia em outras linguagens: [English](HOWTO.md), [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh-TW.md), [فارسی](HOWTO-fa_IR.md) Seja bem-vindo(a) ao Free-Programming-Books (Livros de Programação Grátis)! Novos contribuidores são bem-vindos para nós; até mesmo aqueles fazendo seu primeiro pull request no Github. Se você é um deles, nós temos alguns recursos que podem ajudar: diff --git a/books/free-programming-books.md b/books/free-programming-books.md index d5f0256843683a01f2abef3b70e0c3acc88274aa..34f88488dc7e8975d7e9227ca49a01657e3233ed 100644 --- a/books/free-programming-books.md +++ b/books/free-programming-books.md @@ -15,6 +15,7 @@ * [Assembly Language](#assembly-language) * [Non-X86](#non-x86) * [AutoHotkey](#autohotkey) +* [AutoIt](#autoit) * [Autotools](#autotools) * [Awk](#awk) * [Bash](#bash) @@ -1092,6 +1093,11 @@ Kerridge (PDF) (email address *requested*, not required) * [AutoHotkey Official Documentation](https://autohotkey.com/docs/AutoHotkey.htm) ([CHM](https://autohotkey.com/download/1.1/AutoHotkeyHelp.zip)) +### AutoIt + +* [AutoIt Docs](https://www.autoitscript.com/autoit3/docs/) - Jonathan Bennett (HTML) + + ### Autotools * [Autotools Mythbuster](https://autotools.io/index.html) diff --git a/courses/free-courses-en.md b/courses/free-courses-en.md index 22bf9c81e9142e4923e5867f61d2856e3dfbe1c6..78a59b683e87e13084b1379146d904f7386a1b5b 100644 --- a/courses/free-courses-en.md +++ b/courses/free-courses-en.md @@ -3,6 +3,7 @@ * [Algorithms & Data Structures](#algorithms--data-structures) * [Android](#android) * [Assembly](#assembly) +* [AutoIt](#autoit) * [Bash / Shell](#bash--shell) * [Bootstrap](#bootstrap) * [C](#c) @@ -125,6 +126,11 @@ * [Introductory Intel x86: Architecture, Assembly, Applications, & Alliteration](http://opensecuritytraining.info/IntroX86.html) +### AutoIt + +* [AutoIt Scripting Tutorial](https://www.youtube.com/playlist?list=PL4Jcq5zn02jKpjX0nqI1_fS7mEEb5tw6z) - TutsTeach (HTML) + + ### Bash / Shell * [Bento Shell Track](https://bento.io/topic/shell) (Bento)