Skip to content

Commit 6a3a909

Browse files
authored
Merge branch 'EbookFoundation:master' into Translation-in-progress
2 parents ed4b22f + c15d291 commit 6a3a909

24 files changed

+134
-31
lines changed

Diff for: CONTRIBUTING-es.md

+10-1
Original file line numberDiff line numberDiff line change
@@ -56,6 +56,7 @@ Al contribuir, acepta respetar el [Código de Conducta][coc] presente en el repo
5656
- Si se trata de un libro más antiguo, incluya su fecha de publicación dentro del título.
5757
- Incluya el nombre o nombres de autor/es cuando corresponda. Puede valerse de "`et al.`" para acortar esa enumeración de autores.
5858
- Si el libro no está terminado y aún se está trabajando en él, agregue la anotación de "`en proceso`", tal y como se describe [a continuación][in_process].
59+
- En el caso de que decida recuperar un recurso usando servicios como [*Internet Archive's Wayback Machine*](https://web.archive.org), anexe la anotación "`archived`" (en consonancia con el idioma) tal y como se describe [a continuación][archived]. Use como mejor versión aquella que sea la más reciente y completa.
5960
- Si se solicita una dirección de correo electrónico o configuración de cuenta antes de habilitar la descarga, agregue entre paréntesis dichas notas y en consonancia con el idioma. Por ejemplo: `(*se solicita* email, no requerido...)`.
6061

6162

@@ -133,6 +134,13 @@ Ejemplo:
133134
CORRECTO: * [A punto de ser un libro fascinante](http://example.com/book2.html) - John Doe (HTML) (:construction: *en proceso*)
134135
```
135136

137+
<a name="archived"></a>
138+
- Enlaces archivados:
139+
140+
```
141+
CORRECTO: * [Un recurso recuperado a partir de su línea de tiempo](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: archivado)*
142+
```
143+
136144

137145
<a name="notes"></a>
138146
### Anotaciones
@@ -165,7 +173,7 @@ Nuestros listados proporcionan un conjunto mínimo de metadatos: títulos, URL,
165173
- Queremos dar crédito a los creadores de recursos gratuitos cuando sea apropiado, ¡incluso traductores!
166174
- En el caso de obras traducidas, se debe acreditar también al autor original.
167175
- No permitimos enlaces directos al creador.
168-
- En el caso de recopilaciones u obras remezcladas, el "creador" puede necesitar una descripción. Por ejemplo, los libros de "GoalKicker" se acreditan como "Creado a partir de la documentación de StackOverflow".
176+
- En el caso de recopilaciones u obras remezcladas, el "creador" puede necesitar una descripción. Por ejemplo, los libros de "GoalKicker" o "RIP Tutorial" se acreditan como "`Creado a partir de la documentación de StackOverflow`" (en inglés: "`Compiled from StackOverflow documentation`").
169177

170178
<a name="platforms-and-access-notes"></a>
171179
##### Plataformas y Notas de Acceso
@@ -246,5 +254,6 @@ Si es posible imprimirlo y conservar su esencia, no es un Tutorial Interactivo.
246254
[formatting]: #formato-normalizado
247255
[guidelines]: #pautas
248256
[in_process]: #in_process
257+
[archived]: #archived
249258
[markdown_guide]: https://guides.github.com/features/mastering-markdown/
250259
[programming_playgrounds_list]: (https://github.com/EbookFoundation/free-programming-books/blob/master/more/free-programming-playgrounds.md)

Diff for: CONTRIBUTING-it.md

+10-2
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,8 @@ I collaboratori accettano di rispettare il [Codice di Comportamento](https://git
4545
- preferisci gli atomic commits (un commit per aggiunta/modifica/eliminazione) rispetto ai grandi commit. Non c'è bisogno di raggruppare i commit per inviarli in una sola PR. (Non applichiamo mai questa regola, è solo per comodità dei moderatori)
4646
- se il libro è più vecchio, includi la data di pubblicazione assieme al titolo.
4747
- includi il nome o i nomi degli autori se è il caso. Puoi accorciare il nome degli autori con "et al."
48-
- se il libro non è ancora finito, e ci stanno ancora lavorando su, aggiungi "in process", come descritto [qui sotto.](#in_process)
48+
- se il libro non è ancora finito, e ci stanno ancora lavorando su, aggiungi "in process", come descritto [qui sotto](#in_process). Seleziona sempre l'ultima versione disponibile in questi siti.
49+
- se una risorsa è archiviata usando la Wayback Machine di Internet Archive (o simili), aggiungi la notazione "archived", come descritto [qui sotto](#archived). La versione migliore da utilizzare è quella più recente/completa.
4950
- se è richiesto un indirizzo email o un account per poter scaricare il libro, aggiungilo tra parentesi, esempio: `(email address *requested*, not required)`
5051

5152
<a name="formatting"></a>
@@ -121,6 +122,13 @@ CORRETTO: * [A Very Awesome Book (1970)](https://example.org/book.html) - Jane R
121122
CORRETTO: * [Will Be An Awesome Book Soon](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*)
122123
```
123124

125+
<a name="archived"></a>
126+
- Link archiviato:
127+
128+
```
129+
CORRETTO: * [A Way-backed Interesting Book](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: archived)*
130+
```
131+
124132
### Note
125133

126134
Mentre le basi sono relativamente semplici, c'è una notevole differenza tra le risorse che inseriamo nelle liste. Qui ci sono alcuni appunti su come affrontiamo queste diversità.
@@ -147,7 +155,7 @@ I nostri elenchi forniscono un set minimo di metadati: titoli, URLs, autori, pia
147155
- Vogliamo dare i crediti agli autori ove appropriato, anche ai traduttori!
148156
- Per i lavori tradotti, l'autore originale dovrebbe essere incluso.
149157
- Non permettiamo collegamenti per gli autori.
150-
- Per le compilation o remix, il "creatore" potrebbe aver bisogno di una descrizione. Ad esempio, i libri "GoalKicker" sono accreditati come "Compiled from StackOverflow documentation"
158+
- Per le compilation o remix, il "creatore" potrebbe aver bisogno di una descrizione. Ad esempio, i libri "GoalKicker" o "RIP Tutorial" sono accreditati come "Compiled from StackOverflow documentation"
151159

152160
##### Piattaforme e note di accesso
153161

Diff for: CONTRIBUTING.md

+9-1
Original file line numberDiff line numberDiff line change
@@ -45,6 +45,7 @@ By contributing you agree to respect the [Code of Conduct](https://github.com/Eb
4545
- if the book is older, include the publication date with the title.
4646
- include the author name or names where appropriate. You can shorten author lists with "et al."
4747
- if the book is not finished, and is still being worked on, add the "in process" notation, as described [below.](#in_process)
48+
- if a resource is restored using the Internet Archive's Wayback Machine (or similar), add the "archived" notation, as described [below](#archived). The best versions to use are recent and complete.
4849
- if an email address or account setup is requested before download is enabled, add language-appropriate notes in parentheses, e.g.: `(email address *requested*, not required)`
4950

5051
### Formatting
@@ -119,6 +120,13 @@ GOOD: * [A Very Awesome Book (1970)](https://example.org/book.html) - Jane Roe
119120
GOOD: * [Will Be An Awesome Book Soon](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*)
120121
```
121122

123+
<a name="archived"></a>
124+
- Archived link:
125+
126+
```
127+
GOOD: * [A Way-backed Interesting Book](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: archived)*
128+
```
129+
122130
### Notes
123131

124132
While the basics are relatively simple, there is a great diversity in the resources we list. Here are some notes on how we deal with this diversity.
@@ -145,7 +153,7 @@ Our lists provide a minimal set of metadata: titles, URLs, creators, platforms,
145153
- We want to credit the creators of free resources where appropriate, including translators!
146154
- For translated works the original author should be credited.
147155
- We do not permit links for Creators.
148-
- For compilation or remixed works, the "creator" may need a description. For example, "GoalKicker" books are credited as "Compiled from StackOverflow documentation"
156+
- For compilation or remixed works, the "creator" may need a description. For example, "GoalKicker" or "RIP Tutorial" books are credited as "Compiled from StackOverflow documentation"
149157

150158
##### Platforms and Access Notes
151159

Diff for: HOWTO-th.md

+16
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
อ่านไฟล์นี้ในภาษาอื่น: [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), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), [Bahasa Indonesia](HOWTO-id.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), **ไทย**.
2+
3+
ขอต้อนรับเข้าสู่ Free-Programming-Books! พวกเราขอต้อนรับ contributors ใหม่ทุกคน แม้ว่าคุณพึ่งจะเคยสร้าง pull request เป็นครั้งแรกบน Github หากคุณคือหนึ่งในนั้น ด้านล่างนี้คือแหล่งข้อมูลที่อาจจะเป็นประโยชน์:
4+
5+
* [About Pull Requests](https://help.github.com/articles/about-pull-requests/)
6+
* [Creating a pull request](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request)
7+
* [Github Hello World](https://guides.github.com/activities/hello-world/)
8+
* [Youtube - Github Tutorial For Beginners](https://www.youtube.com/watch?v=0fKg7e37bQE)
9+
* [Youtube - How To Fork A GitHub Repo and Submit A Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw)
10+
* [Youtube - Markdown Crash Course](https://www.youtube.com/watch?v=HUBNt18RFbo)
11+
12+
อย่าลังเลที่จะถามคำถาม ทุกคนมี PR แรกกันทั้งนั้น คุณอาจจะเป็นหนึ่งในผู้ช่วยของเรา
13+
14+
แม้ว่าคุณจะเป็นคนที่มีประสบการณ์ในการร่วมพัฒนา Open Source แต่อาจจะมีบางเรื่องที่คุณยังไม่รู้ก็เป็นได้ เมื่อใดก็ตามที่คุณได้สร้าง PR ขึ้น GitHub Actions จะทำการตรวจสอบโค้ดด้วย linter สิ่งที่จะพบเจอได้บ่อยจะเป็นการเว้นช่องว่างหรือการเรียงลำดับอักษรที่ไม่ถูกต้อง หากคุณเห็นปุ่มสีเขียวหมายความว่าทุกอย่างพร้อมสำหรับการตรวจตรา แต่หากไม่ได้เป็นเช่นนั้น ให้กดที่ "Details" เพื่ิอดูว่าผิดพลาดที่จุดไหนจากการรัน linter แล้วทำการแก้ปัญหานั้นเพื่อดึง PR ขึ้นไปใหม่
15+
16+
สุดท้ายนี้ หากคุณไม่แน่ใจว่าแหล่งข้อมูลเหล่านั้นจะเหมาะสมกับ Free-Programming-Books หรือไม่ ให้อ่านไกด์ไลน์จากในนี้ [CONTRIBUTING](CONTRIBUTING.md).

Diff for: HOWTO-zh.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -10,8 +10,8 @@
1010
* [Youtube —— Markdown 速成课程](https://www.youtube.com/watch?v=HUBNt18RFbo)
1111

1212

13-
不要犹豫,提问题。每个贡献者都从第一个 PR 开始。你可能是我们的千分之一!
13+
不要犹豫,提问题。每个贡献者都从第一个拉取请求开始。你可能是我们的千分之一!
1414

15-
即使您是经验丰富的开源贡献者,也有一些事情可能会让您绊倒。提交您的 PR 后,GitHub Actions 会运行一个 linter(代码风格检测工具),经常发现间距或字母顺序方面的小问题。如果您获得绿色按钮,则说明一切准备就绪,但如果没有,请单击 "更多" 链接以查找 linter 不满意的地方。解决此问题并新增 commit 到您的 PR
15+
即使您是经验丰富的开源贡献者,也有一些事情可能会让您绊倒。提交您的拉取请求后,GitHub Actions 会运行一个 linter(代码风格检测工具),经常发现间距或字母顺序方面的小问题。如果您获得绿色按钮,则说明一切准备就绪,但如果没有,请单击 "更多" 链接以查找 linter 不满意的地方。解决此问题并新增 commit 到您的拉取请求
1616

1717
最后,如果不确定要添加的资源是否适用于 Free-Programming-Books(免费编程书籍),请通读 [CONTRIBUTING](CONTRIBUTING-zh.md) 中的基本准则。

Diff for: books/free-programming-books-bn.md

+6
Original file line numberDiff line numberDiff line change
@@ -35,6 +35,7 @@
3535
* [Android Firebase Bangla Tutorials](https://www.youtube.com/playlist?list=PLgH5QX0i9K3oDurEmECb5U_BZ1hrLaHx-) - Anisul Islam
3636
* [Android SQLite Database Bangla Tutorials](https://www.youtube.com/playlist?list=PLgH5QX0i9K3oJBRutwsFgUKrKJCjv9K3p) - Anisul Islam
3737
* [Android Tutorials Material Design](https://www.youtube.com/playlist?list=PLgH5QX0i9K3ru-TfN-YsRWKe4EEOLrWjn) - Anisul Islam
38+
* [Java, OOP & Android tutorials for beginners in Bengali](https://www.youtube.com/playlist?list=PLV3rqOvr9vgkmELwlSouvJtROQ6MWRbIH) - Zulkarnine Mahmud
3839

3940

4041
### Bootstrap
@@ -101,6 +102,7 @@
101102

102103
* [Java Bangla Tutorials | CORE Java | Complete OOP](https://www.youtube.com/playlist?list=PLgH5QX0i9K3oAZUB2QXR-dZac0c9HNyRa) - Anisul Islam
103104
* [Java Swing Bangla Tutorials](https://www.youtube.com/playlist?list=PLgH5QX0i9K3rAHKr6IteF5kdgN6BorH9l) - Anisul Islam
105+
* [জাভা প্রোগ্রামিং](http://java.howtocode.dev) - Bazlur Rahman, et al. (howtocode.dev) (gitbook)
104106

105107

106108
### JavaScript
@@ -113,6 +115,9 @@
113115
* [JavaScript Full Playlist With Order](https://www.youtube.com/playlist?list=PL_XxuZqN0xVAJTV_1ZXwB1XIiFkK0ddZA) - Stack Learner
114116
* [Make Fun of JavaScript Array](https://www.youtube.com/playlist?list=PL_XxuZqN0xVDr08QgQHljCecWtA4jBLnS) - Stack Learner
115117
* [হাতেকলমে জাভাস্ক্রিপ্ট](https://zonayed.js.org) - Zonayed Ahmed
118+
* [JS Bangla Tutorial Series for Beginners](https://www.youtube.com/playlist?list=PLHiZ4m8vCp9OkrURufHpGUUTBjJhO9Ghy) - Learn with Sumit
119+
* [Modern JavaScript ES6 Bangla Tutorial](https://www.youtube.com/playlist?list=PLHiZ4m8vCp9MFjMRp9EEHWKArbi0wdgXG) - Learn with Sumit
120+
* [Play with DOM - Bangla](https://www.youtube.com/playlist?list=PLHiZ4m8vCp9MJDxMOzhYVuTrO1b5n-Tq_) - Learn with Sumit
116121

117122

118123
### jQuery
@@ -177,6 +182,7 @@
177182
* [React - Redux Complete Course](https://www.youtube.com/playlist?list=PL_XxuZqN0xVAvcGzTEAyPSOqgUQA08rNB) - Stack Learner
178183
* [Understand ReactJS Advanced Features](https://www.youtube.com/playlist?list=PL_XxuZqN0xVBaeF3qUyvr2AxoXGwDd5cx) - Stack Learner
179184
* [Understand ReactJS Core Features](https://www.youtube.com/playlist?list=PL_XxuZqN0xVBANld2gDEE6_0G886zavUs) - Stack Learner
185+
* [React JS Tutorial Bangla Series for Beginners](https://www.youtube.com/playlist?list=PLHiZ4m8vCp9M6HVQv7a36cp8LKzyHIePr) - Learn with Sumit
180186

181187

182188
### Svelte

Diff for: books/free-programming-books-id.md

+2
Original file line numberDiff line numberDiff line change
@@ -79,6 +79,8 @@
7979
* [Belajar HTML dan CSS](http://www.ariona.net/ebook-belajar-html-dan-css/)
8080
* [Ebook Belajar HTML Dan CSS Dasar](https://www.malasngoding.com/download-ebook-belajar-html-dan-css-dasar-gratis/)
8181
* [HTML & CSS: Buat Websitemu Sendiri ](https://leanpub.com/html-css--buat-webistemu-sendiri) *(Membutuhkan akun Leanpub atau email yang valid)*
82+
* [Tutorial Dasar CSS untuk Pemula](https://www.petanikode.com/tutorial/css/) - Ahmad Muhardian (Petani Kode) *(:construction: Dalam Proses)*
83+
* [Tutorial HTML untuk Pemula](https://www.petanikode.com/tutorial/html/) - Ahmad Muhardian (Petani Kode)
8284

8385

8486
### Java

Diff for: books/free-programming-books-ko.md

+1
Original file line numberDiff line numberDiff line change
@@ -161,6 +161,7 @@
161161
* [점프 투 파이썬 - Python 3](https://wikidocs.net/book/1)
162162
* [중급 파이썬: 파이썬 팁들](https://ddanggle.gitbooks.io/interpy-kr/content/)
163163
* [파이썬 라이브러리](https://wikidocs.net/book/5445) - 박응용
164+
* [파이썬 헤엄치기](https://wikidocs.net/book/5148) - 해달 프로그래밍
164165
* [파이썬을 여행하는 히치하이커를 위한 안내서!](https://python-guide-kr.readthedocs.io/ko/latest/)
165166
* [파이썬을 이용한 비트코인 자동매매](https://wikidocs.net/book/1665) - 조대표
166167
* [A Byte of Python 한글 번역 by Jeongbin Park](http://byteofpython-korean.sourceforge.net/byte_of_python.pdf) (PDF)

0 commit comments

Comments
 (0)