From e629db6b05a72fd64a6b33feeeebbe830641cf10 Mon Sep 17 00:00:00 2001
From: nonce <77142078+Existential-nonce@users.noreply.github.com>
Date: Mon, 27 Sep 2021 02:01:07 +0100
Subject: [PATCH] Added AutoIt, language updates and support (#5554)
* Added AutoIt, French translation and miscellaneous language support
* Added missing indications
* Added missing indications
* Fixed build issue
* Fixed course build
---
CONTRIBUTING-es.md | 2 +-
CONTRIBUTING-fa_IR.md | 2 +-
CONTRIBUTING-fr.md | 217 ++++++++++++++++++++++++++++++++
CONTRIBUTING-vn.md | 4 +-
CONTRIBUTING-zh-TW.md | 2 +-
CONTRIBUTING-zh.md | 2 +-
CONTRIBUTING.md | 24 ++--
HOWTO-es.md | 2 +-
HOWTO-fa_IR.md | 2 +-
HOWTO-fr.md | 2 +-
HOWTO-hi.md | 2 +-
HOWTO-zh-TW.md | 2 +-
HOWTO-zh.md | 2 +-
HOWTO.md | 2 +-
HOWTO.pt_BR.md | 2 +-
books/free-programming-books.md | 6 +
courses/free-courses-en.md | 6 +
17 files changed, 255 insertions(+), 26 deletions(-)
create mode 100644 CONTRIBUTING-fr.md
diff --git a/CONTRIBUTING-es.md b/CONTRIBUTING-es.md
index 6ebad5a0c172a..dfb7f4b50b449 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 2f9c38da4eb91..d29c19b298489 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 0000000000000..d50471caa3715
--- /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 0daabfa281aca..9c72c3830a460 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 11ff7638da0a9..bd17b2164690c 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 94565d6c9dfe2..f23a4692bf16b 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 6c7936c2631bf..404675fb36f83 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 10be262598e76..56664c72f84e7 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 4b3eb658f3586..fe65e5595e334 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 5ed84f26260ed..3be18d7a9130d 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 6785d9f3f83be..ca9d4cb2e37e1 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 88be7387b8432..3bce671a14b64 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 20ca448a96952..5a475b0f72ac4 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 3965c3261f763..89696b3ebc1e5 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 aaa039c7ce44e..59d7061e108c4 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 d5f0256843683..34f88488dc7e8 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 22bf9c81e9142..78a59b683e87e 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)