docs(contributing): Homogenize format & indent of code blocks

- Format using fenced style.
- Well indent in those placed inside list enumerations.
- Simulate `Good` - `Bad` monospace double colon indent inside each one.

- Examples highlighting as `text-plain`. The `md, markdown` style doesn't work very well since blocks has mixed syntax.
- `check_urls` code block highlighted as `properties` style (key-value pair).

Solves markdownlint rules:
- MD040/fenced-code-language: Fenced code blocks should have a language specified
- MD046/code-block-style: Code block style [Expected: indented; Actual: fenced]
pull/6625/head
David Ordás 3 years ago
parent 31c776cb52
commit f9dc719aef
  1. 20
      CONTRIBUTING-de.md
  2. 22
      CONTRIBUTING-el.md
  3. 22
      CONTRIBUTING-es.md
  4. 20
      CONTRIBUTING-fa_IR.md
  5. 22
      CONTRIBUTING-fil.md
  6. 18
      CONTRIBUTING-fr.md
  7. 22
      CONTRIBUTING-it.md
  8. 20
      CONTRIBUTING-ko.md
  9. 18
      CONTRIBUTING-pt_BR.md
  10. 20
      CONTRIBUTING-ru.md
  11. 48
      CONTRIBUTING-vi.md
  12. 20
      CONTRIBUTING-zh.md
  13. 24
      CONTRIBUTING-zh_TW.md
  14. 20
      CONTRIBUTING.md

@ -73,6 +73,7 @@ Folgende Formatierungsregeln sollten eingehalten werden:
Beispiel:
```text
[...]
* [Ein tolles Buch](http://example.com/example.html)
(Leerzeile)
@ -81,38 +82,39 @@ Beispiel:
(Leerzeile)
* [Noch ein tolles Buch](http://example.com/book.html)
* [Ein anderes Buch](http://example.com/other.html)
```
- Keine Leerzeichen zwischen `]` und `(` einfügen:
```
```text
FALSCH : * [Noch ein tolles Buch] (http://example.com/book.html)
RICHTIG: * [Noch ein tolles Buch](http://example.com/book.html)
```
- Wenn Du den Autor nennst, nutze ` - ` (einen mit Leerzeichen eingefassten Gedankenstrich):
```
```text
FALSCH : * [Noch ein tolles Buch](http://example.com/book.html)- John Doe
RICHTIG: * [Noch ein tolles Buch](http://example.com/book.html) - John Doe
```
- Füge ein einzelnes Leerzeichen zwischen dem Link und seinem Dateiformat ein:
```
```text
FALSCH : * [Ein sehr tolles Buch](https://example.org/book.pdf)(PDF)
RICHTIG: * [Ein sehr tolles Buch](https://example.org/book.pdf) (PDF)
```
- Der Autor wird vor dem Format genannt:
```
```text
FALSCH : * [Ein sehr tolles Buch](https://example.org/book.pdf)- (PDF) Jane Roe
RICHTIG: * [Ein sehr tolles Buch](https://example.org/book.pdf) - Jane Roe (PDF)
```
- Verschiedene Formate:
```
```text
FALSCH : * [Noch ein tolles Buch](http://example.com/)- John Doe (HTML)
FALSCH : * [Noch ein tolles Buch](https://downloads.example.org/book.html)- John Doe (download site)
RICHTIG: * [Noch ein tolles Buch](http://example.com/) - John Doe (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html)
@ -120,14 +122,14 @@ RICHTIG: * [Noch ein tolles Buch](http://example.com/) - John Doe (HTML) [(PDF,
- Nenne das Jahr der Veröffentlichung im Titel bei älteren Publikationen:
```
```text
FALSCH : * [Ein sehr tolles Buch](https://example.org/book.html) - Jane Roe - 1970
RICHTIG: * [Ein sehr tolles Buch (1970)](https://example.org/book.html) - Jane Roe
```
- <a name="in_process"></a>Bücher in Bearbeitung:
```
```text
RICHTIG: * [Wird bald ein tolles Buch sein](http://example.com/book2.html) - John Doe (HTML) (:construction: *in Bearbeitung*)
```
@ -228,8 +230,8 @@ Wenn etwas ausgedruckt werden kann, ohne dass es seinen Nutzen verliert, ist es
- Die URLs werden über [awesome_bot](https://github.com/dkhamsing/awesome_bot) validiert.
- Um die URL-Validierung auszulösen, kann ein Commit abgeschickt werden, der `check_urls=file_to_check` enthält:
```
check_urls=free-programming-books.md free-programming-books-en.md
```properties
check_urls=free-programming-books.md free-programming-books-de.md
```
- Man kann mehr als eine zu überprüfende Datei angeben, wobei die Einträge mit einem einzelnen Leerzeichen getrennt werden.

@ -79,6 +79,7 @@
Παράδειγμα:
```text
[...]
* [Ένα Φοβερό Βιβλίο](http://example.com/example.html)
(κενή γραμμή)
@ -87,38 +88,39 @@
(κενή γραμμή)
* [Άλλο Φοβερό Βιβλίο](http://example.com/book.html)
* [Κάποιο Άλλο Βιβλίο](http://example.com/other.html)
```
- Μη βάζετε κενό μεταξύ `]` και `(`:
```
```text
ΚΑΚΟ: * [Άλλο Φοβερό Βιβλίο] (http://example.com/book.html)
ΚΑΛΟ: * [Άλλο Φοβερό Βιβλίο](http://example.com/book.html)
```
- Αν συμπεριλαμβάνετε συγγραφέα, χρησιμοποιήστε ` - ` (μια παύλα που περιβάλλεται από κενά):
```
```text
ΚΑΚΟ: * [Άλλο Φοβερό Βιβλίο](http://example.com/book.html)- John Doe
ΚΑΛΟ: * [Άλλο Φοβερό Βιβλίο](http://example.com/book.html) - John Doe
```
- Εισάγετε ένα κενό μεταξύ του συνδέσμου και του format του:
```
```text
ΚΑΚΟ: * [Ένα Πολύ Φοβερό Βιβλίο](https://example.org/book.pdf)(PDF)
ΚΑΛΟ: * [Ένα Πολύ Φοβερό Βιβλίο](https://example.org/book.pdf) (PDF)
```
- Ο συγγραφέας μπαίνει πριν το format
```
```text
ΚΑΚΟ: * [Ένα Πολύ Φοβερό Βιβλίο](https://example.org/book.pdf)- (PDF) Jane Roe
ΚΑΛΟ: * [Ένα Πολύ Φοβερό Βιβλίο](https://example.org/book.pdf) - Jane Roe (PDF)
```
- Πολλαπλά formats:
```
```text
ΚΑΚΟ: * [Ένα Πολύ Φοβερό Βιβλίο](http://example.com/)- John Doe (HTML)
ΚΑΚΟ: * [Ένα Πολύ Φοβερό Βιβλίο](https://downloads.example.org/book.html)- John Doe (download site)
ΚΑΛΟ: * [Ένα Πολύ Φοβερό Βιβλίο](http://example.com/) - John Doe (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html)
@ -126,20 +128,20 @@
- Συμπεριλαμβάνετε χρονιά δημοσιεύσης στον τίτλο για παλαιότερα βιβλία:
```
```text
ΚΑΚΟ: * [Ένα Πολύ Φοβερό Βιβλίο](https://example.org/book.html) - Jane Roe - 1970
ΚΑΛΟ: * [Ένα Πολύ Φοβερό Βιβλίο (1970)](https://example.org/book.html) - Jane Roe
```
- <a name="in_process"></a>Βιβλία σε εξέλιξη:
```
```text
ΚΑΛΟ: * [Θα Είναι Σύντομα Ένα Φοβερό Βιβλίο](http://example.com/book2.html) - John Doe (HTML) (:construction: *σε εξέλιξη*)
```
- <a name="archived"></a>Αρχειοθετημένοι σύνδεσμοι:
```
```text
ΚΑΛΟ: * [Ένα Ενδιαφέρον Way-backed Βιβλίο](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: αρχειοθετημένο)*
```
@ -243,8 +245,8 @@
- Η επικύρωση των URL χρησιμοποιεί το [awesome_bot](https://github.com/dkhamsing/awesome_bot)
- Για να ενεργοποιήσετε την επικύρωση του URL, κάντε push ένα commit που περιέχει ένα μήνυμα στο οποίο υπάρχει το `check_urls=file_to_check`:
```
check_urls=free-programming-books.md free-programming-books-en.md
```properties
check_urls=free-programming-books.md free-programming-books-el.md
```
- Μπορείτε να προσδιορίσετε πάνω από ένα αρχείο για έλεγχο, χρησιμοποιώντας ένα κενό για να ξεχωρίσετε κάθε καταχώρηση.

@ -79,6 +79,7 @@ La idea es tener:
Ejemplo:
```text
[...]
* [Un libro increíble](http://example.com/example.html)
(línea en blanco)
@ -87,38 +88,39 @@ Ejemplo:
(línea en blanco)
* [Otro libro fascinante](http://example.com/book.html)
* [Otro libro más](http://example.com/other.html)
```
- Omita los espacios entre `]` y `(`:
```
```text
INCORRECTO: * [Otro libro fascinante] (http://example.com/book.html)
CORRECTO : * [Otro libro fascinante](http://example.com/book.html)
```
- Si en el registro decide incluir al autor, emplee ` - ` (un guión rodeado de espacios simples) como separador:
```
```text
INCORRECTO: * [Un libro sencillamente fabuloso](http://example.com/book.html)- John Doe
CORRECTO : * [Un libro sencillamente fabuloso](http://example.com/book.html) - John Doe
```
- Ponga un solo espacio entre el enlace al contenido y su formato:
```
```text
INCORRECTO: * [Un libro muy interesante](https://example.org/book.pdf)(PDF)
CORRECTO : * [Un libro muy interesante](https://example.org/book.pdf) (PDF)
```
- El autor se antepone al formato:
```
```text
INCORRECTO: * [Un libro muy interesante](https://example.org/book.pdf)- (PDF) Jane Roe
CORRECTO : * [Un libro muy interesante](https://example.org/book.pdf) - Jane Roe (PDF)
```
- Múltiples formatos:
```
```text
INCORRECTO: * [Otro libro interesante](http://example.com/) - John Doe (HTML)
INCORRECTO: * [Otro libro interesante](https://downloads.example.org/book.html) - John Doe (sitio de descarga)
CORRECTO : * [Otro libro interesante](http://example.com/) - John Doe (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html)
@ -126,20 +128,20 @@ Ejemplo:
- Incluya el año de publicación como parte del título de los libros más antiguos:
```
```text
INCORRECTO: * [Un libro bastante especial](https://example.org/book.html) - Jane Roe - 1970
CORRECTO : * [Un libro bastante especial (1970)](https://example.org/book.html) - Jane Roe
```
- <a name="in_process"></a>Libros en proceso / no acabados aún:
```
```text
CORRECTO : * [A punto de ser un libro fascinante](http://example.com/book2.html) - John Doe (HTML) (:construction: *en proceso*)
```
- <a name="archived"></a>Enlaces archivados:
```
```text
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)*
```
@ -252,8 +254,8 @@ Si es posible imprimirlo y conservar su esencia, no es un Tutorial Interactivo.
- La validación de URLs se realiza mediante [awesome_bot](https://github.com/dkhamsing/awesome_bot)
- Para activar esta validación de URL, envíe un commit que incluya como mensaje de confirmación `check_urls=fichero_a_comprobar`:
```
check_urls=free-programming-books.md free-programming-books-en.md
```properties
check_urls=free-programming-books.md free-programming-books-es.md
```
- Es posible especificar más de un fichero a comprobar. Simplemente use un espacio para separar cada entrada.

@ -75,6 +75,7 @@
مثال:
```text
[...]
* [یک کتاب عالی](http://example.com/example.html)
(خط خالی)
@ -83,38 +84,39 @@
(خط خالی)
* [یک کتاب عالی دیگر](http://example.com/book.html)
* [یک کتاب دیگر](http://example.com/other.html)
```
* بین `]` و `(` space نگذارید:
```
```text
بد : * [یک کتاب عالی دیگر] (http://example.com/book.html)
خوب: * [یک کتاب عالی دیگر](http://example.com/book.html)
```
* اگر اسم نویسنده را اضافه میکنید، از ` - ` استفاده کنید (یک dash با دو single space):
```
```text
بد : * [یک کتاب عالی دیگر](http://example.com/book.html)- نام نویسنده
خوب: * [یک کتاب عالی دیگر](http://example.com/book.html) - نام نویسنده
```
* یک single space بین لینک و فرمت قرار دهید:
```
```text
بد : * [یک کتاب خیلی عالی](https://example.org/book.pdf)(PDF)
خوب: * [یک کتاب خیلی عالی](https://example.org/book.pdf) (PDF)
```
* نویسنده قبل از فرمت میآید:
```
```text
بد : * [یک کتاب خیلی عالی](https://example.org/book.pdf)- (PDF) نام نویسنده
خوب: * [یک کتاب خیلی عالی](https://example.org/book.pdf) - یک نویسنده دیگر (PDF)
```
* چند فرمتیها:
```
```text
بد : * [یک کتاب عالی دیگر](http://example.com/)- نام نویسنده (HTML)
بد : * [یک کتاب عالی دیگر](https://downloads.example.org/book.html)- نام نویسنده (download site)
خوب: * [یک کتاب عالی دیگر](http://example.com/) - نام نویسنده (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html)
@ -122,14 +124,14 @@
* سال انتشار برای کتابهای قدیمی را در عنوان ینویسید:
```
```text
بد : * [یک کتاب خیلی عالی](https://example.org/book.html) - نام نویسنده - 1970
خوب: * [یک کتاب خیلی عالی (1970)](https://example.org/book.html) - نام نویسنده
```
* <a name="in_process"></a>کتابهای در دست تالیف:
```
```text
خوب: * [کتابی که عالی خواهدشد](http://example.com/book2.html) - نام نویسنده (HTML) (:construction: *in process*)
```
@ -140,8 +142,8 @@
* اعتبارسنجی لینکها با استفاده از [awesome_bot](https://github.com/dkhamsing/awesome_bot) انجام میشود.
* برای اجرای اعتبارسنجی لینکها، کامیتی پوش کنید که در بدنهی آن `check_urls=file_to_check` نوشته شده باشد:
```
check_urls=free-programming-books.md free-programming-books-en.md
```properties
check_urls=free-programming-books.md free-programming-books-fa_IR.md
```
* با استفاده از single space برای جدا کردن هر ورودی، میتوانید بیشتر از یک فایل را برای بررسی مشخص کنید.

@ -76,6 +76,7 @@ The idea is to have:
Halimbawa:
```text
[...]
* [An Awesome Book](http://example.com/example.html)
(blank line)
@ -84,38 +85,39 @@ Halimbawa:
(blank line)
* [Another Awesome Book](http://example.com/book.html)
* [Some Other Book](http://example.com/other.html)
```
- Huwag maglagay ng mga puwang sa pagitan `]` at `(`:
```
```text
BAD : * [Another Awesome Book] (http://example.com/book.html)
GOOD: * [Another Awesome Book](http://example.com/book.html)
```
- Kung isasama mo ang may-akda, gamitin ` - ` (isang gitling na napapalibutan ng mga solong espasyo):
```
```text
BAD : * [Another Awesome Book](http://example.com/book.html)- John Doe
GOOD: * [Another Awesome Book](http://example.com/book.html) - John Doe
```
- Maglagay ng isang puwang sa pagitan ng link at ang format nito:
```
```text
BAD : * [A Very Awesome Book](https://example.org/book.pdf)(PDF)
GOOD: * [A Very Awesome Book](https://example.org/book.pdf) (PDF)
```
- Nauna ang may-akda sa format:
```
```text
BAD : * [A Very Awesome Book](https://example.org/book.pdf)- (PDF) Jane Roe
GOOD: * [A Very Awesome Book](https://example.org/book.pdf) - Jane Roe (PDF)
```
- Maramihang format:
```
```text
BAD : * [Another Awesome Book](http://example.com/)- John Doe (HTML)
BAD : * [Another Awesome Book](https://downloads.example.org/book.html)- John Doe (download site)
GOOD: * [Another Awesome Book](http://example.com/) - John Doe (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html)
@ -123,20 +125,20 @@ GOOD: * [Another Awesome Book](http://example.com/) - John Doe (HTML) [(PDF, EPU
- Isama ang taon ng publikasyon sa pamagat para sa mga mas lumang aklat:
```
```text
BAD : * [A Very Awesome Book](https://example.org/book.html) - Jane Roe - 1970
GOOD: * [A Very Awesome Book (1970)](https://example.org/book.html) - Jane Roe
```
- <a name="in_process"></a>In-process books:
```
```text
GOOD: * [Will Be An Awesome Book Soon](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*)
```
- <a name="archived"></a>Archived link:
```
```text
GOOD: * [A Way-backed Interesting Book](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: archived)*
```
@ -237,8 +239,8 @@ Kung maaari mong i-print ito at panatilihin ang kakanyahan nito, hindi ito isang
- Gumagamit ng pagpapatunay ng URL [awesome_bot](https://github.com/dkhamsing/awesome_bot)
- Upang ma-trigger ang pagpapatunay ng URL, mag-push ng commit na may kasamang commit na mensahe na naglalaman `check_urls=file_to_check`:
```
check_urls=free-programming-books.md free-programming-books-en.md
```properties
check_urls=free-programming-books.md free-programming-books-fil.md
```
- Maaari kang tumukoy ng higit sa isang file na susuriin, gamit ang isang puwang upang paghiwalayin ang bawat entry.

@ -73,6 +73,7 @@ l'idée est d'avoir:
Exemple:
```text
[...]
* [Un Livre Génial](http://exemple.com/exemple.html)
(ligne blanche)
@ -81,38 +82,39 @@ 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 `(`:
```
```text
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):
```
```text
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:
```
```text
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:
```
```text
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:
```
```text
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)
@ -120,7 +122,7 @@ BIEN : * [Un Autre Livre Génial](http://exemple.com/) - John Doe (HTML) [(PD
- Inclure l'année de publication dans le titre pour les livres plus anciens :
```
```text
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
```
@ -228,8 +230,8 @@ Si vous pouvez l'imprimer et conserver son essence, ce n'est pas un didacticiel
- 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
```properties
check_urls=free-programming-books.md free-programming-books-fr.md
```
- Vous pouvez spécifier plus d'un fichier à vérifier, en utilisant un seul espace pour séparer chaque entrée

@ -76,6 +76,7 @@ L'idea è di avere:
Esempi:
```text
[...]
* [An Awesome Book](http://example.com/example.html)
(linea vuota)
@ -84,38 +85,39 @@ Esempi:
(linea vuota)
* [Another Awesome Book](http://example.com/book.html)
* [Some Other Book](http://example.com/other.html)
```
- Non mettere uno spazio tra `]` e `(`:
```
```text
SCORRETTO: * [Another Awesome Book] (http://example.com/book.html)
CORRETTO : * [Another Awesome Book](http://example.com/book.html)
```
- Se includi gli autori, usa ` - ` (un trattino circondato da spazi singoli):
```
```text
SCORRETTO: * [Another Awesome Book](http://example.com/book.html)- John Doe
CORRETTO : * [Another Awesome Book](http://example.com/book.html) - John Doe
```
- Metti uno spazio tra il link e il formato:
```
```text
SCORRETTO: * [A Very Awesome Book](https://example.org/book.pdf)(PDF)
CORRETTO : * [A Very Awesome Book](https://example.org/book.pdf) (PDF)
```
- Gli autori vanno prima del formato:
```
```text
SCORRETTO: * [A Very Awesome Book](https://example.org/book.pdf)- (PDF) Jane Roe
CORRETTO : * [A Very Awesome Book](https://example.org/book.pdf) - Jane Roe (PDF)
```
- Formati multipli:
```
```text
SCORRETTO: * [Another Awesome Book](http://example.com/)- John Doe (HTML)
SCORRETTO: * [Another Awesome Book](https://downloads.example.org/book.html)- John Doe (download site)
CORRETTO : * [Another Awesome Book](http://example.com/) - John Doe (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html)
@ -123,20 +125,20 @@ CORRETTO: * [Another Awesome Book](http://example.com/) - John Doe (HTML) [(PDF,
- Includi l'anno di pubblicazione nel titolo per i libri più vecchi:
```
```text
SCORRETTO: * [A Very Awesome Book](https://example.org/book.html) - Jane Roe - 1970
CORRETTO : * [A Very Awesome Book (1970)](https://example.org/book.html) - Jane Roe
```
- <a name="in_process"></a>Libri in sviluppo:
```
```text
CORRETTO : * [Will Be An Awesome Book Soon](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*)
```
- <a name="archived"></a>Link archiviato:
```
```text
CORRETTO : * [A Way-backed Interesting Book](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: archived)*
```
@ -237,8 +239,8 @@ Se riesci a stamparlo e conservarne l'essenza, non è un tutorial interattivo.
- La validazione dell'URL usa [awesome_bot](https://github.com/dkhamsing/awesome_bot)
- Per attivare la convalida dell'URL, invia un commit che includa un messaggio di commit contenente `check_urls=file_to_check`:
```
check_urls=free-programming-books.md free-programming-books-en.md
```properties
check_urls=free-programming-books.md free-programming-books-it.md
```
- È possibile specificare più di un file da controllare, utilizzando un singolo spazio per separare ogni voce.

@ -69,6 +69,7 @@
예시:
```text
[...]
* [An Awesome Book](http://example.com/example.html)
(blank line)
@ -77,38 +78,39 @@
(blank line)
* [Another Awesome Book](http://example.com/book.html)
* [Some Other Book](http://example.com/other.html)
```
- `]``(` 사이에 공백을 넣지 마십시오:
```
```text
BAD : * [Another Awesome Book] (http://example.com/book.html)
GOOD: * [Another Awesome Book](http://example.com/book.html)
```
- 저자를 표시할 경우, ` - `를 사용하십시오 (띄어쓰기 - 띄어쓰기):
```
```text
BAD : * [Another Awesome Book](http://example.com/book.html)- John Doe
GOOD: * [Another Awesome Book](http://example.com/book.html) - John Doe
```
- 바로가기와 형식 사이에는 공백을 삽입 하십시오:
```
```text
BAD : * [A Very Awesome Book](https://example.org/book.pdf)(PDF)
GOOD: * [A Very Awesome Book](https://example.org/book.pdf) (PDF)
```
- 저자는 형식 전에 옵니다:
```
```text
BAD : * [A Very Awesome Book](https://example.org/book.pdf)- (PDF) Jane Roe
GOOD: * [A Very Awesome Book](https://example.org/book.pdf) - Jane Roe (PDF)
```
- 여러가지의 파일 형식이 존재할떄:
```
```text
BAD : * [Another Awesome Book](http://example.com/)- John Doe (HTML)
BAD : * [Another Awesome Book](https://downloads.example.org/book.html)- John Doe (download site)
GOOD: * [Another Awesome Book](http://example.com/) - John Doe (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html)
@ -116,14 +118,14 @@ GOOD: * [Another Awesome Book](http://example.com/) - John Doe (HTML) [(PDF, EPU
- 오래된 책들은 출판 년도를 포함하세요:
```
```text
BAD : * [A Very Awesome Book](https://example.org/book.html) - Jane Roe - 1970
GOOD: * [A Very Awesome Book (1970)](https://example.org/book.html) - Jane Roe
```
- <a name="in_process"></a>작성중인 책:
```
```text
GOOD: * [Will Be An Awesome Book Soon](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*)
```
@ -224,8 +226,8 @@ GOOD: * [Will Be An Awesome Book Soon](http://example.com/book2.html) - John Doe
- 바로가기 주소 검증은 [awesome_bot](https://github.com/dkhamsing/awesome_bot)를 이용합니다
- 바로가기 주소 검증을 위해 커밋 메시지에 `check_urls=file_to_check`을 포함해 주세요:
```
check_urls=free-programming-books.md free-programming-books-en.md
```properties
check_urls=free-programming-books.md free-programming-books-ko.md
```
- 각 입력을 공백으로 구문하여 하나 이상의 파일을 검사 할 수 있습니다.

@ -73,6 +73,7 @@ A ideia é ter:
Exemplo:
```text
[...]
* [Um Livro Incrível](http://exemplo.com/exemplo.html)
(linha em branco)
@ -81,38 +82,39 @@ Exemplo:
(linha em branco)
* [Outro Livro Incrível](http://exemplo.com/livro.html)
* [Outro Livro Qualquer](http://exemplo.com/outro.html)
```
- Não coloque espaços entre `]` e `(`:
```
```text
RUIM: * [Outro Livro Incrível] (http://exemplo.com/livro.html)
BOM : * [Outro Livro Incrível](http://exemplo.com/livro.html)
```
- Se incluir o autor, use ` - ` (um traço envolto por espaços simples):
```
```text
RUIM: * [Outro Livro Incrível](http://exemplo.com/livro.html)- Fulano de Tal
BOM : * [Outro Livro Incrível](http://exemplo.com/livro.html) - Fulano de Tal
```
- Coloque um espaço simples entre o _link_ e seu formato:
```
```text
RUIM: * [Um Livro Muito Incrível](https://exemplo.org/livro.pdf)(PDF)
BOM : * [Um Livro Muito Incrível](https://exemplo.org/livro.pdf) (PDF)
```
- Autor vem antes do formato:
```
```text
RUIM: * [Um Livro Muito Incrível](https://exemplo.org/livro.pdf)- (PDF) Fulana de Tal
BOM : * [Um Livro Muito Incrível](https://exemplo.org/livro.pdf) - Fulana de Tal (PDF)
```
- Múltiplos formatos:
```
```text
RUIM: * [Outro Livro Incrível](http://exemplo.com/)- Fulano de Tal (HTML)
RUIM: * [Outro Livro Incrível](https://downloads.exemplo.org/livro.html)- Fulano de Tal (download site)
BOM : * [Outro Livro Incrível](http://exemplo.com/) - Fulano de Tal (HTML) [(PDF, EPUB)](https://downloads.exemplo.org/livro.html)
@ -120,14 +122,14 @@ BOM : * [Outro Livro Incrível](http://exemplo.com/) - Fulano de Tal (HTML) [(P
- Inclua o ano de publicação no título de livros antigos:
```
```text
RUIM: * [Um Livro Muito Incrível](https://exemplo.org/livro.html) - Fulana de Tal - 1970
BOM : * [Um Livro Muito Incrível (1970)](https://exemplo.org/livro.html) - Fulana de Tal
```
- <a name="in_process"></a>Livros em processo:
```
```text
BOM : * [Será Um Livro Incrível Em Breve](http://exemplo.com/livro2.html) - Fulano de Tal (HTML) (:construction: *em processo*)
```
@ -228,7 +230,7 @@ Se você pode capturar a tela ou imprimí-la e reter sua essência, então não
- Validação de URL usa [awesome_bot](https://github.com/dkhamsing/awesome_bot)
- Para ativar a validação de URL, dê _push_ num _commit_ que inclua uma mensagem de _commit_ contendo `check_urls=file_to_check`:
```
```properties
check_urls=free-programming-books.md free-programming-books-pt_BR.md
```

@ -78,6 +78,7 @@
Пример:
```text
[...]
* [Шикарная книга](http://example.com/example.html)
(пустая строка)
@ -86,38 +87,39 @@
(пустая строка)
* [Другая шикарная книга](http://example.com/book.html)
* [Ещё одна другая книга](http://example.com/other.html)
```
- Не вставляйте пробел между `]` и `(`:
```
```text
ПЛОХО : * [Другая шикарная книга] (http://example.com/book.html)
ХОРОШО: * [Другая шикарная книга](http://example.com/book.html)
```
- Если вы указываете автора, используйте ` - ` (тире, окруженное одиночными пробелами):
```
```text
ПЛОХО : * [Другая шикарная книга](http://example.com/book.html)- Джон Доу
ХОРОШО: * [Другая шикарная книга](http://example.com/book.html) - Джон Доу
```
- Отбейте ссылку и её формат пробелом:
```
```text
ПЛОХО : * [Очень хорошая книга](https://example.org/book.pdf)(PDF)
ХОРОШО: * [Очень хорошая книга](https://example.org/book.pdf) (PDF)
```
- Сперва автор, потом формат:
```
```text
ПЛОХО : * [Очень хорошая книга](https://example.org/book.pdf)- (PDF) Джейн Роу
ХОРОШО: * [Очень хорошая книга](https://example.org/book.pdf) - Джейн Роу (PDF)
```
- Несколько форматов:
```
```text
ПЛОХО : * [Другая шикарная книга](http://example.com/)- Джон Доу (HTML)
ПЛОХО : * [Другая шикарная книга](https://downloads.example.org/book.html)- Джон Доу (cайт для загрузки)
ХОРОШО: * [Другая шикарная книга](http://example.com/) - Джон Доу (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html)
@ -125,14 +127,14 @@
- Включите год публикации в заголовок для старых книг:
```
```text
ПЛОХО : * [Очень хорошая книга](https://example.org/book.html) - Джейн Роу - 1970
ХОРОШО: * [Очень хорошая книга (1970)](https://example.org/book.html) - Джейн Роу
```
- <a name="in_process"></a>Незавершенные книги:
```
```text
ХОРОШО: * [Скоро будет отличная книга](http://example.com/book2.html) - Джон Доу (HTML) (:construction: *in process*)
```
@ -245,8 +247,8 @@
- Для проверки URL используется [awesome_bot](https://github.com/dkhamsing/awesome_bot)
- Чтобы запустить проверку URL, нажмите фиксацию, которая включает сообщение фиксации, содержащее `check_urls = ссылка_для_проверки`:
```
check_urls=free-programming-books.md free-programming-books-en.md
```properties
check_urls=free-programming-books.md free-programming-books-ru.md
```
- Вы можете указать более одного файла для проверки, используя один пробел для разделения каждой записи.

@ -83,6 +83,7 @@ Bằng cách đóng góp, bạn đồng ý tôn trọng [Quy Tắc Ứng Xử](h
Ví dụ:
```text
[...]
* [Một cuốn sách tuyệt vời](http://example.com/example.html)
(dòng trống)
@ -91,54 +92,55 @@ Ví dụ:
(dòng trống)
* [Một cuốn sách tuyệt vời khác](http://example.com/book.html)
* [Một số sách khác](http://example.com/other.html)
```
- Không đặt dấu cách giữa `]``(`:
```
Tệ : * [Một cuốn sách tuyệt vời khác] (http://example.com/book.html)
Tốt: * [Một cuốn sách tuyệt vời khác](http://example.com/book.html)
```text
TỆ : * [Một cuốn sách tuyệt vời khác] (http://example.com/book.html)
TỐT: * [Một cuốn sách tuyệt vời khác](http://example.com/book.html)
```
- Nếu bao gồm tác giả, hãy sử dụng ` - ` (dấu gạch ngang được bao quanh bởi các khoảng trắng):
```
Tệ : * [Một cuốn sách tuyệt vời khác](http://example.com/book.html)- John Doe
Tốt: * [Một cuốn sách tuyệt vời khác](http://example.com/book.html) - John Doe
```text
TỆ : * [Một cuốn sách tuyệt vời khác](http://example.com/book.html)- John Doe
TỐT: * [Một cuốn sách tuyệt vời khác](http://example.com/book.html) - John Doe
```
- Đặt một khoảng trắng giữa liên kết và định dạng của nó:
```
Tệ : * [Một cuốn sách rất tuyệt vời](https://example.org/book.pdf)(PDF)
Tốt: * [Một cuốn sách rất tuyệt vời](https://example.org/book.pdf) (PDF)
```text
TỆ : * [Một cuốn sách rất tuyệt vời](https://example.org/book.pdf)(PDF)
TỐT: * [Một cuốn sách rất tuyệt vời](https://example.org/book.pdf) (PDF)
```
- Tác giả đặt trước định dạng:
```
Tệ : * [Một cuốn sách rất tuyệt vời](https://example.org/book.pdf)- (PDF) Jane Roe
Tốt: * [Một cuốn sách rất tuyệt vời](https://example.org/book.pdf) - Jane Roe (PDF)
```text
TỆ : * [Một cuốn sách rất tuyệt vời](https://example.org/book.pdf)- (PDF) Jane Roe
TỐT: * [Một cuốn sách rất tuyệt vời](https://example.org/book.pdf) - Jane Roe (PDF)
```
- Nhiều định dạng:
```
Tệ : * [Một cuốn sách tuyệt vời khác](http://example.com/)- John Doe (HTML)
Tệ : * [Một cuốn sách tuyệt vời khác](https://downloads.example.org/book.html)- John Doe (download site)
Tốt: * [Một cuốn sách tuyệt vời khác](http://example.com/) - John Doe (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html)
```text
TỆ : * [Một cuốn sách tuyệt vời khác](http://example.com/)- John Doe (HTML)
TỆ : * [Một cuốn sách tuyệt vời khác](https://downloads.example.org/book.html)- John Doe (download site)
TỐT: * [Một cuốn sách tuyệt vời khác](http://example.com/) - John Doe (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html)
```
- Bao gồm năm xuất bản trong tiêu đề cho các sách cũ hơn:
```
Tệ : * [Một cuốn sách rất tuyệt vời](https://example.org/book.html) - Jane Roe - 1970
Tốt: * [Một cuốn sách rất tuyệt vời (1970)](https://example.org/book.html) - Jane Roe
```text
TỆ : * [Một cuốn sách rất tuyệt vời](https://example.org/book.html) - Jane Roe - 1970
TỐT: * [Một cuốn sách rất tuyệt vời (1970)](https://example.org/book.html) - Jane Roe
```
- <a name="in_process"></a>Sách đang trong quá trình viết:
```
Tốt: * [Sách sẽ sớm trở nên tuyệt vời](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*)
```text
TỐT: * [Sách sẽ sớm trở nên tuyệt vời](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*)
```
@ -238,8 +240,8 @@ Nếu bạn có thể in nó ra và giữ lại bản chất của nó, thì đ
- Sử dụng xác thực liên kết [awesome_bot](https://github.com/dkhamsing/awesome_bot)
- Để kích hoạt xác thực liên kết, hãy push một commit bao gồm một commit message chứa `check_urls=file_to_check`:
```
check_urls=free-programming-books.md free-programming-books-en.md
```properties
check_urls=free-programming-books.md free-programming-books-vi.md
```
- Bạn có thể chỉ định nhiều tệp để kiểm tra, sử dụng một khoảng trắng duy nhất để tách từng mục nhập.

@ -73,7 +73,7 @@
举例:
```
```text
[...]
* [一本很有用的书](http://example.com/example.html)
(空行)
@ -86,42 +86,42 @@
* 在 `]``(` 之间不要留有空格:
```
```text
错误:* [一本很有用的书] (http://example.com/book.html)
正确:* [一本很有用的书](http://example.com/book.html)
```
* 如果包括作者,请使用' - '(由单个空格(英文半角)包围的破折号):
```
```text
错误:* [一本很有用的书](http://example.com/book.html)- 张显宗
正确:* [一本很有用的书](http://example.com/book.html) - 张显宗
```
* 在链接和电子书格式之间放一个空格:
```
```text
错误:* [一本很有用的书](https://example.org/book.pdf)(PDF)
正确:* [一本很有用的书](https://example.org/book.pdf) (PDF)
```
* 如需备注或注解,请使用英文半角括号`( )`:
```
```text
错误:* [一本很有用的书](https://example.org/book.pdf) (繁体中文)
正确:* [一本很有用的书](https://example.org/book.pdf) (繁体中文)
```
* 作者在电子书格式之前:
```
```text
错误:* [一本很有用的书](https://example.org/book.pdf)- (PDF) 张显宗
正确:* [一本很有用的书](https://example.org/book.pdf) - 张显宗 (PDF)
```
* 多重格式:
```
```text
错误:* [一本很有用的书](http://example.com/)- 张显宗 (HTML)
错误:* [一本很有用的书](https://downloads.example.org/book.html)- 张显宗 (download site)
正确:* [一本很有用的书](http://example.com/) - 张显宗 (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html)
@ -129,7 +129,7 @@
* 多作者,多译者时,请使用中文 `、` 进行分隔,在译者名字后请使用英文半角括号包围的 `(翻译)`,可以用 “等” 缩短作者列表:
```
```text
错误:* [一本很有用的书](https://example.org/book.pdf) - 张显宗,岳绮罗
正确:* [一本很有用的书](https://example.org/book.pdf) - 张显宗、岳绮罗(翻译)
正确:* [一本很有用的书](https://example.org/book.pdf) - 张显宗、岳绮罗、顾玄武、出尘子 等
@ -137,14 +137,14 @@
* 在旧书的标题中包括出版年份:
```
```text
错误:* [一本很有用的书](https://example.org/book.html) - 张显宗 - 1970
正确:* [一本很有用的书 (1970)](https://example.org/book.html) - 张显宗
```
* <a name="in_process"></a>编写(翻译)中的书籍:
```
```text
正确:* [马上出版的一本书](http://example.com/book2.html) - 张显宗 (HTML) (:construction: *编写中*)
正确:* [马上出版的一本书](http://example.com/book2.html) - 张显宗 (HTML) (:construction: *翻译中*)
```

@ -73,7 +73,7 @@
舉例:
```
```text
[...]
* [一本很有用的書](http://example.com/example.html)
(空行)
@ -86,42 +86,42 @@
* 在 `]``(` 之間不要留有空格:
```
```text
錯誤:* [一本很有用的書] (http://example.com/book.html)
正確:* [一本很有用的書](http://example.com/book.html)
```
* 如果包括作者,請使用' - '(由單個空格(英文半型)包圍的破折號):
```
```text
錯誤:* [一本很有用的書](http://example.com/book.html)- 張顯宗
正確:* [一本很有用的書](http://example.com/book.html) - 張顯宗
```
* 在連結和電子書格式之間放一個空格:
```
```text
錯誤:* [一本很有用的書](https://example.org/book.pdf)(PDF)
正確:* [一本很有用的書](https://example.org/book.pdf) (PDF)
```
* 如需備注或注解,請使用英文半型括號`( )`:
```
```text
錯誤:* [一本很有用的書](https://example.org/book.pdf) (繁體中文)
正確:* [一本很有用的書](https://example.org/book.pdf) (繁體中文)
```
* 作者在電子書格式之前:
```
```text
錯誤:* [一本很有用的書](https://example.org/book.pdf)- (PDF) 張顯宗
正確:* [一本很有用的書](https://example.org/book.pdf) - 張顯宗 (PDF)
```
* 多重格式:
```
```text
錯誤:* [一本很有用的書](http://example.com/)- 張顯宗 (HTML)
錯誤:* [一本很有用的書](https://downloads.example.org/book.html)- 張顯宗 (download site)
正確:* [一本很有用的書](http://example.com/) - 張顯宗 (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html)
@ -129,7 +129,7 @@
* 多作者,多譯者時,請使用中文 `、` 進行分隔,在譯者名字後請使用英文半型括號包圍的 `(翻譯)`,可以用 “等” 縮短作者列表:
```
```text
錯誤:* [一本很有用的書](https://example.org/book.pdf) - 張顯宗,岳綺羅
正確:* [一本很有用的書](https://example.org/book.pdf) - 張顯宗、岳綺羅(翻譯)
正確:* [一本很有用的書](https://example.org/book.pdf) - 張顯宗、岳綺羅、顧玄武、出塵子 等
@ -137,14 +137,14 @@
* 在舊書的標題中包括出版年份:
```
```text
錯誤:* [一本很有用的書](https://example.org/book.html) - 張顯宗 - 1970
正確:* [一本很有用的書 (1970)](https://example.org/book.html) - 張顯宗
```
* <a name="in_process"></a>編寫(翻譯)中的書籍:
```
```text
正確:* [即將出版的一本書](http://example.com/book2.html) - 張顯宗 (HTML) (:construction: *編寫中*)
正確:* [即將出版的一本書](http://example.com/book2.html) - 張顯宗 (HTML) (:construction: *翻譯中*)
```
@ -156,8 +156,8 @@
- 使用 [awesome_bot](https://github.com/dkhamsing/awesome_bot) 進行連結驗證。
- 可以藉由提交一個內容包含`check_urls=file_to_check`來觸發連結驗證:
```
check_urls=free-programming-books.md free-programming-books-en.md
```properties
check_urls=free-programming-books.md free-programming-books-zh.md
```
- 您可以以一個空白區隔出想要進行驗證的檔案名稱來一次驗證多個檔案。

@ -74,6 +74,7 @@ The idea is to have:
Example:
```text
[...]
* [An Awesome Book](http://example.com/example.html)
(blank line)
@ -82,38 +83,39 @@ Example:
(blank line)
* [Another Awesome Book](http://example.com/book.html)
* [Some Other Book](http://example.com/other.html)
```
- Don't put spaces between `]` and `(`:
```
```text
BAD : * [Another Awesome Book] (http://example.com/book.html)
GOOD: * [Another Awesome Book](http://example.com/book.html)
```
- If you include the author, use ` - ` (a dash surrounded by single spaces):
```
```text
BAD : * [Another Awesome Book](http://example.com/book.html)- John Doe
GOOD: * [Another Awesome Book](http://example.com/book.html) - John Doe
```
- Put a single space between the link and its format:
```
```text
BAD : * [A Very Awesome Book](https://example.org/book.pdf)(PDF)
GOOD: * [A Very Awesome Book](https://example.org/book.pdf) (PDF)
```
- Author comes before format:
```
```text
BAD : * [A Very Awesome Book](https://example.org/book.pdf)- (PDF) Jane Roe
GOOD: * [A Very Awesome Book](https://example.org/book.pdf) - Jane Roe (PDF)
```
- Multiple formats:
```
```text
BAD : * [Another Awesome Book](http://example.com/)- John Doe (HTML)
BAD : * [Another Awesome Book](https://downloads.example.org/book.html)- John Doe (download site)
GOOD: * [Another Awesome Book](http://example.com/) - John Doe (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html)
@ -121,20 +123,20 @@ GOOD: * [Another Awesome Book](http://example.com/) - John Doe (HTML) [(PDF, EPU
- Include publication year in title for older books:
```
```text
BAD : * [A Very Awesome Book](https://example.org/book.html) - Jane Roe - 1970
GOOD: * [A Very Awesome Book (1970)](https://example.org/book.html) - Jane Roe
```
- <a name="in_process"></a>In-process books:
```
```text
GOOD: * [Will Be An Awesome Book Soon](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*)
```
- <a name="archived"></a>Archived link:
```
```text
GOOD: * [A Way-backed Interesting Book](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: archived)*
```
@ -235,7 +237,7 @@ If you can print it out and retain its essence, it's not an Interactive Tutorial
- URL validation uses [awesome_bot](https://github.com/dkhamsing/awesome_bot)
- To trigger URL validation, push a commit that includes a commit message containing `check_urls=file_to_check`:
```
```properties
check_urls=free-programming-books.md free-programming-books-en.md
```

Loading…
Cancel
Save