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]
This commit is contained in:
David Ordás 2021-11-04 21:17:29 +01:00
parent 31c776cb52
commit f9dc719aef
14 changed files with 587 additions and 563 deletions

View File

@ -73,6 +73,7 @@ Folgende Formatierungsregeln sollten eingehalten werden:
Beispiel: Beispiel:
```text
[...] [...]
* [Ein tolles Buch](http://example.com/example.html) * [Ein tolles Buch](http://example.com/example.html)
(Leerzeile) (Leerzeile)
@ -81,38 +82,39 @@ Beispiel:
(Leerzeile) (Leerzeile)
* [Noch ein tolles Buch](http://example.com/book.html) * [Noch ein tolles Buch](http://example.com/book.html)
* [Ein anderes Buch](http://example.com/other.html) * [Ein anderes Buch](http://example.com/other.html)
```
- Keine Leerzeichen zwischen `]` und `(` einfügen: - Keine Leerzeichen zwischen `]` und `(` einfügen:
``` ```text
FALSCH : * [Noch ein tolles Buch] (http://example.com/book.html) FALSCH : * [Noch ein tolles Buch] (http://example.com/book.html)
RICHTIG: * [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): - Wenn Du den Autor nennst, nutze ` - ` (einen mit Leerzeichen eingefassten Gedankenstrich):
``` ```text
FALSCH : * [Noch ein tolles Buch](http://example.com/book.html)- John Doe FALSCH : * [Noch ein tolles Buch](http://example.com/book.html)- John Doe
RICHTIG: * [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: - Füge ein einzelnes Leerzeichen zwischen dem Link und seinem Dateiformat ein:
``` ```text
FALSCH : * [Ein sehr tolles Buch](https://example.org/book.pdf)(PDF) FALSCH : * [Ein sehr tolles Buch](https://example.org/book.pdf)(PDF)
RICHTIG: * [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: - Der Autor wird vor dem Format genannt:
``` ```text
FALSCH : * [Ein sehr tolles Buch](https://example.org/book.pdf)- (PDF) Jane Roe 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) RICHTIG: * [Ein sehr tolles Buch](https://example.org/book.pdf) - Jane Roe (PDF)
``` ```
- Verschiedene Formate: - Verschiedene Formate:
``` ```text
FALSCH : * [Noch ein tolles Buch](http://example.com/)- John Doe (HTML) 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) 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) 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: - 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 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 RICHTIG: * [Ein sehr tolles Buch (1970)](https://example.org/book.html) - Jane Roe
``` ```
- <a name="in_process"></a>Bücher in Bearbeitung: - <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*) 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. - 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: - Um die URL-Validierung auszulösen, kann ein Commit abgeschickt werden, der `check_urls=file_to_check` enthält:
``` ```properties
check_urls=free-programming-books.md free-programming-books-en.md 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. - Man kann mehr als eine zu überprüfende Datei angeben, wobei die Einträge mit einem einzelnen Leerzeichen getrennt werden.

View File

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

View File

@ -79,6 +79,7 @@ La idea es tener:
Ejemplo: Ejemplo:
```text
[...] [...]
* [Un libro increíble](http://example.com/example.html) * [Un libro increíble](http://example.com/example.html)
(línea en blanco) (línea en blanco)
@ -87,38 +88,39 @@ Ejemplo:
(línea en blanco) (línea en blanco)
* [Otro libro fascinante](http://example.com/book.html) * [Otro libro fascinante](http://example.com/book.html)
* [Otro libro más](http://example.com/other.html) * [Otro libro más](http://example.com/other.html)
```
- Omita los espacios entre `]` y `(`: - Omita los espacios entre `]` y `(`:
``` ```text
INCORRECTO: * [Otro libro fascinante] (http://example.com/book.html) INCORRECTO: * [Otro libro fascinante] (http://example.com/book.html)
CORRECTO : * [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: - 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 INCORRECTO: * [Un libro sencillamente fabuloso](http://example.com/book.html)- John Doe
CORRECTO : * [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: - Ponga un solo espacio entre el enlace al contenido y su formato:
``` ```text
INCORRECTO: * [Un libro muy interesante](https://example.org/book.pdf)(PDF) INCORRECTO: * [Un libro muy interesante](https://example.org/book.pdf)(PDF)
CORRECTO : * [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: - El autor se antepone al formato:
``` ```text
INCORRECTO: * [Un libro muy interesante](https://example.org/book.pdf)- (PDF) Jane Roe 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) CORRECTO : * [Un libro muy interesante](https://example.org/book.pdf) - Jane Roe (PDF)
``` ```
- Múltiples formatos: - Múltiples formatos:
``` ```text
INCORRECTO: * [Otro libro interesante](http://example.com/) - John Doe (HTML) 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) 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) 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: - 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 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 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: - <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*) 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: - <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)* 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) - 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`: - Para activar esta validación de URL, envíe un commit que incluya como mensaje de confirmación `check_urls=fichero_a_comprobar`:
``` ```properties
check_urls=free-programming-books.md free-programming-books-en.md 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. - Es posible especificar más de un fichero a comprobar. Simplemente use un espacio para separar cada entrada.

View File

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

View File

@ -76,6 +76,7 @@ The idea is to have:
Halimbawa: Halimbawa:
```text
[...] [...]
* [An Awesome Book](http://example.com/example.html) * [An Awesome Book](http://example.com/example.html)
(blank line) (blank line)
@ -84,38 +85,39 @@ Halimbawa:
(blank line) (blank line)
* [Another Awesome Book](http://example.com/book.html) * [Another Awesome Book](http://example.com/book.html)
* [Some Other Book](http://example.com/other.html) * [Some Other Book](http://example.com/other.html)
```
- Huwag maglagay ng mga puwang sa pagitan `]` at `(`: - Huwag maglagay ng mga puwang sa pagitan `]` at `(`:
``` ```text
BAD : * [Another Awesome Book] (http://example.com/book.html) BAD : * [Another Awesome Book] (http://example.com/book.html)
GOOD: * [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): - 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 BAD : * [Another Awesome Book](http://example.com/book.html)- John Doe
GOOD: * [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: - Maglagay ng isang puwang sa pagitan ng link at ang format nito:
``` ```text
BAD : * [A Very Awesome Book](https://example.org/book.pdf)(PDF) BAD : * [A Very Awesome Book](https://example.org/book.pdf)(PDF)
GOOD: * [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: - Nauna ang may-akda sa format:
``` ```text
BAD : * [A Very Awesome Book](https://example.org/book.pdf)- (PDF) Jane Roe 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) GOOD: * [A Very Awesome Book](https://example.org/book.pdf) - Jane Roe (PDF)
``` ```
- Maramihang format: - Maramihang format:
``` ```text
BAD : * [Another Awesome Book](http://example.com/)- John Doe (HTML) BAD : * [Another Awesome Book](http://example.com/)- John Doe (HTML)
BAD : * [Another Awesome Book](https://downloads.example.org/book.html)- John Doe (download site) 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) 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: - 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 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 GOOD: * [A Very Awesome Book (1970)](https://example.org/book.html) - Jane Roe
``` ```
- <a name="in_process"></a>In-process books: - <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*) GOOD: * [Will Be An Awesome Book Soon](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*)
``` ```
- <a name="archived"></a>Archived link: - <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)* 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) - 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`: - Upang ma-trigger ang pagpapatunay ng URL, mag-push ng commit na may kasamang commit na mensahe na naglalaman `check_urls=file_to_check`:
``` ```properties
check_urls=free-programming-books.md free-programming-books-en.md 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. - Maaari kang tumukoy ng higit sa isang file na susuriin, gamit ang isang puwang upang paghiwalayin ang bawat entry.

View File

@ -73,6 +73,7 @@ l'idée est d'avoir:
Exemple: Exemple:
```text
[...] [...]
* [Un Livre Génial](http://exemple.com/exemple.html) * [Un Livre Génial](http://exemple.com/exemple.html)
(ligne blanche) (ligne blanche)
@ -81,38 +82,39 @@ Exemple:
(ligne blanche) (ligne blanche)
* [Un Autre Livre Génial](http://exemple.com/livre.html) * [Un Autre Livre Génial](http://exemple.com/livre.html)
* [Un Autre Livre](http://exemple.com/autre.html) * [Un Autre Livre](http://exemple.com/autre.html)
```
- Mettez pas des espaces entre `]` et `(`: - Mettez pas des espaces entre `]` et `(`:
``` ```text
MAUVAIS: * [Un Autre Livre Génial] (http://exemple.com/livre.html) MAUVAIS: * [Un Autre Livre Génial] (http://exemple.com/livre.html)
BIEN : * [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): - 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 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 BIEN : * [Un Autre Livre Génial](http://exemple.com/livre.html) - John Doe
``` ```
- Mettez un seul espace entre le lien et son format: - Mettez un seul espace entre le lien et son format:
``` ```text
MAUVAIS: * [Un Autre Livre Génial](https://exemple.org/livre.pdf)(PDF) MAUVAIS: * [Un Autre Livre Génial](https://exemple.org/livre.pdf)(PDF)
BIEN : * [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: - L'auteur vient avant le format:
``` ```text
MAUVAIS: * [Un Autre Livre Génial](https://exemple.org/livre.pdf)- (PDF) Jane Roe 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) BIEN : * [Un Autre Livre Génial](https://exemple.org/livre.pdf) - Jane Roe (PDF)
``` ```
- Formats multiples: - Formats multiples:
``` ```text
MAUVAIS: * [Un Autre Livre Génial](http://exemple.com/)- John Doe (HTML) 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) 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) 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 : - 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 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 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) - 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` : - Pour déclencher la validation d'URL, poussez un commit qui inclut un message de commit contenant `check_urls=file_to_check` :
``` ```properties
check_urls=free-programming-livres.md free-programming-livres-en.md 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 - Vous pouvez spécifier plus d'un fichier à vérifier, en utilisant un seul espace pour séparer chaque entrée

View File

@ -76,6 +76,7 @@ L'idea è di avere:
Esempi: Esempi:
```text
[...] [...]
* [An Awesome Book](http://example.com/example.html) * [An Awesome Book](http://example.com/example.html)
(linea vuota) (linea vuota)
@ -84,38 +85,39 @@ Esempi:
(linea vuota) (linea vuota)
* [Another Awesome Book](http://example.com/book.html) * [Another Awesome Book](http://example.com/book.html)
* [Some Other Book](http://example.com/other.html) * [Some Other Book](http://example.com/other.html)
```
- Non mettere uno spazio tra `]` e `(`: - Non mettere uno spazio tra `]` e `(`:
``` ```text
SCORRETTO: * [Another Awesome Book] (http://example.com/book.html) SCORRETTO: * [Another Awesome Book] (http://example.com/book.html)
CORRETTO : * [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): - Se includi gli autori, usa ` - ` (un trattino circondato da spazi singoli):
``` ```text
SCORRETTO: * [Another Awesome Book](http://example.com/book.html)- John Doe SCORRETTO: * [Another Awesome Book](http://example.com/book.html)- John Doe
CORRETTO : * [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: - Metti uno spazio tra il link e il formato:
``` ```text
SCORRETTO: * [A Very Awesome Book](https://example.org/book.pdf)(PDF) SCORRETTO: * [A Very Awesome Book](https://example.org/book.pdf)(PDF)
CORRETTO : * [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: - Gli autori vanno prima del formato:
``` ```text
SCORRETTO: * [A Very Awesome Book](https://example.org/book.pdf)- (PDF) Jane Roe 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) CORRETTO : * [A Very Awesome Book](https://example.org/book.pdf) - Jane Roe (PDF)
``` ```
- Formati multipli: - Formati multipli:
``` ```text
SCORRETTO: * [Another Awesome Book](http://example.com/)- John Doe (HTML) SCORRETTO: * [Another Awesome Book](http://example.com/)- John Doe (HTML)
SCORRETTO: * [Another Awesome Book](https://downloads.example.org/book.html)- John Doe (download site) 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) 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: - 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 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 CORRETTO : * [A Very Awesome Book (1970)](https://example.org/book.html) - Jane Roe
``` ```
- <a name="in_process"></a>Libri in sviluppo: - <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*) CORRETTO : * [Will Be An Awesome Book Soon](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*)
``` ```
- <a name="archived"></a>Link archiviato: - <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)* 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) - 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`: - Per attivare la convalida dell'URL, invia un commit che includa un messaggio di commit contenente `check_urls=file_to_check`:
``` ```properties
check_urls=free-programming-books.md free-programming-books-en.md 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. - È possibile specificare più di un file da controllare, utilizzando un singolo spazio per separare ogni voce.

View File

@ -69,6 +69,7 @@
예시: 예시:
```text
[...] [...]
* [An Awesome Book](http://example.com/example.html) * [An Awesome Book](http://example.com/example.html)
(blank line) (blank line)
@ -77,38 +78,39 @@
(blank line) (blank line)
* [Another Awesome Book](http://example.com/book.html) * [Another Awesome Book](http://example.com/book.html)
* [Some Other Book](http://example.com/other.html) * [Some Other Book](http://example.com/other.html)
```
- `]``(` 사이에 공백을 넣지 마십시오: - `]``(` 사이에 공백을 넣지 마십시오:
``` ```text
BAD : * [Another Awesome Book] (http://example.com/book.html) BAD : * [Another Awesome Book] (http://example.com/book.html)
GOOD: * [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 BAD : * [Another Awesome Book](http://example.com/book.html)- John Doe
GOOD: * [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) BAD : * [A Very Awesome Book](https://example.org/book.pdf)(PDF)
GOOD: * [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 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) 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](http://example.com/)- John Doe (HTML)
BAD : * [Another Awesome Book](https://downloads.example.org/book.html)- John Doe (download site) 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) 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 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 GOOD: * [A Very Awesome Book (1970)](https://example.org/book.html) - Jane Roe
``` ```
- <a name="in_process"></a>작성중인 책: - <a name="in_process"></a>작성중인 책:
``` ```text
GOOD: * [Will Be An Awesome Book Soon](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*)
``` ```
@ -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)를 이용합니다 - 바로가기 주소 검증은 [awesome_bot](https://github.com/dkhamsing/awesome_bot)를 이용합니다
- 바로가기 주소 검증을 위해 커밋 메시지에 `check_urls=file_to_check`을 포함해 주세요: - 바로가기 주소 검증을 위해 커밋 메시지에 `check_urls=file_to_check`을 포함해 주세요:
``` ```properties
check_urls=free-programming-books.md free-programming-books-en.md check_urls=free-programming-books.md free-programming-books-ko.md
``` ```
- 각 입력을 공백으로 구문하여 하나 이상의 파일을 검사 할 수 있습니다. - 각 입력을 공백으로 구문하여 하나 이상의 파일을 검사 할 수 있습니다.

View File

@ -73,6 +73,7 @@ A ideia é ter:
Exemplo: Exemplo:
```text
[...] [...]
* [Um Livro Incrível](http://exemplo.com/exemplo.html) * [Um Livro Incrível](http://exemplo.com/exemplo.html)
(linha em branco) (linha em branco)
@ -81,38 +82,39 @@ Exemplo:
(linha em branco) (linha em branco)
* [Outro Livro Incrível](http://exemplo.com/livro.html) * [Outro Livro Incrível](http://exemplo.com/livro.html)
* [Outro Livro Qualquer](http://exemplo.com/outro.html) * [Outro Livro Qualquer](http://exemplo.com/outro.html)
```
- Não coloque espaços entre `]` e `(`: - Não coloque espaços entre `]` e `(`:
``` ```text
RUIM: * [Outro Livro Incrível] (http://exemplo.com/livro.html) RUIM: * [Outro Livro Incrível] (http://exemplo.com/livro.html)
BOM : * [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): - 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 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 BOM : * [Outro Livro Incrível](http://exemplo.com/livro.html) - Fulano de Tal
``` ```
- Coloque um espaço simples entre o _link_ e seu formato: - Coloque um espaço simples entre o _link_ e seu formato:
``` ```text
RUIM: * [Um Livro Muito Incrível](https://exemplo.org/livro.pdf)(PDF) RUIM: * [Um Livro Muito Incrível](https://exemplo.org/livro.pdf)(PDF)
BOM : * [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: - Autor vem antes do formato:
``` ```text
RUIM: * [Um Livro Muito Incrível](https://exemplo.org/livro.pdf)- (PDF) Fulana de Tal 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) BOM : * [Um Livro Muito Incrível](https://exemplo.org/livro.pdf) - Fulana de Tal (PDF)
``` ```
- Múltiplos formatos: - Múltiplos formatos:
``` ```text
RUIM: * [Outro Livro Incrível](http://exemplo.com/)- Fulano de Tal (HTML) 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) 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) 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: - 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 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 BOM : * [Um Livro Muito Incrível (1970)](https://exemplo.org/livro.html) - Fulana de Tal
``` ```
- <a name="in_process"></a>Livros em processo: - <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*) 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) - 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`: - 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 check_urls=free-programming-books.md free-programming-books-pt_BR.md
``` ```

View File

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

View File

@ -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ụ: Ví dụ:
```text
[...] [...]
* [Một cuốn sách tuyệt vời](http://example.com/example.html) * [Một cuốn sách tuyệt vời](http://example.com/example.html)
(dòng trống) (dòng trống)
@ -91,54 +92,55 @@ Ví dụ:
(dòng trống) (dòng trống)
* [Một cuốn sách tuyệt vời khác](http://example.com/book.html) * [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) * [Một số sách khác](http://example.com/other.html)
```
- Không đặt dấu cách giữa `]``(`: - Không đặt dấu cách giữa `]``(`:
``` ```text
Tệ : * [Một cuốn sách tuyệt vời khác] (http://example.com/book.html) 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) 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): - 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):
``` ```text
Tệ : * [Một cuốn sách tuyệt vời khác](http://example.com/book.html)- John Doe 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Ố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 khoảng trắng giữa liên kết và định dạng của nó:
``` ```text
Tệ : * [Một cuốn sách rất tuyệt vời](https://example.org/book.pdf)(PDF) 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Ố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ác giả đặt trước định dạng:
``` ```text
Tệ : * [Một cuốn sách rất tuyệt vời](https://example.org/book.pdf)- (PDF) Jane Roe 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) 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: - Nhiều định dạng:
``` ```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](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Ệ : * [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) 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: - Bao gồm năm xuất bản trong tiêu đề cho các sách cũ hơn:
``` ```text
Tệ : * [Một cuốn sách rất tuyệt vời](https://example.org/book.html) - Jane Roe - 1970 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 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: - <a name="in_process"></a>Sách đang trong quá trình viết:
``` ```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*) 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) - 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`: - Để 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`:
``` ```properties
check_urls=free-programming-books.md free-programming-books-en.md 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. - 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.

View File

@ -73,7 +73,7 @@
举例: 举例:
``` ```text
[...] [...]
* [一本很有用的书](http://example.com/example.html) * [一本很有用的书](http://example.com/example.html)
(空行) (空行)
@ -86,42 +86,42 @@
* 在 `]``(` 之间不要留有空格: * 在 `]``(` 之间不要留有空格:
``` ```text
错误:* [一本很有用的书] (http://example.com/book.html) 错误:* [一本很有用的书] (http://example.com/book.html)
正确:* [一本很有用的书](http://example.com/book.html) 正确:* [一本很有用的书](http://example.com/book.html)
``` ```
* 如果包括作者,请使用' - '(由单个空格(英文半角)包围的破折号) * 如果包括作者,请使用' - '(由单个空格(英文半角)包围的破折号)
``` ```text
错误:* [一本很有用的书](http://example.com/book.html)- 张显宗 错误:* [一本很有用的书](http://example.com/book.html)- 张显宗
正确:* [一本很有用的书](http://example.com/book.html) - 张显宗 正确:* [一本很有用的书](http://example.com/book.html) - 张显宗
``` ```
* 在链接和电子书格式之间放一个空格: * 在链接和电子书格式之间放一个空格:
``` ```text
错误:* [一本很有用的书](https://example.org/book.pdf)(PDF) 错误:* [一本很有用的书](https://example.org/book.pdf)(PDF)
正确:* [一本很有用的书](https://example.org/book.pdf) (PDF) 正确:* [一本很有用的书](https://example.org/book.pdf) (PDF)
``` ```
* 如需备注或注解,请使用英文半角括号`( )` * 如需备注或注解,请使用英文半角括号`( )`
``` ```text
错误:* [一本很有用的书](https://example.org/book.pdf) (繁体中文) 错误:* [一本很有用的书](https://example.org/book.pdf) (繁体中文)
正确:* [一本很有用的书](https://example.org/book.pdf) (繁体中文) 正确:* [一本很有用的书](https://example.org/book.pdf) (繁体中文)
``` ```
* 作者在电子书格式之前: * 作者在电子书格式之前:
``` ```text
错误:* [一本很有用的书](https://example.org/book.pdf)- (PDF) 张显宗 错误:* [一本很有用的书](https://example.org/book.pdf)- (PDF) 张显宗
正确:* [一本很有用的书](https://example.org/book.pdf) - 张显宗 (PDF) 正确:* [一本很有用的书](https://example.org/book.pdf) - 张显宗 (PDF)
``` ```
* 多重格式: * 多重格式:
``` ```text
错误:* [一本很有用的书](http://example.com/)- 张显宗 (HTML) 错误:* [一本很有用的书](http://example.com/)- 张显宗 (HTML)
错误:* [一本很有用的书](https://downloads.example.org/book.html)- 张显宗 (download site) 错误:* [一本很有用的书](https://downloads.example.org/book.html)- 张显宗 (download site)
正确:* [一本很有用的书](http://example.com/) - 张显宗 (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html) 正确:* [一本很有用的书](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) - 张显宗、岳绮罗(翻译) 正确:* [一本很有用的书](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 错误:* [一本很有用的书](https://example.org/book.html) - 张显宗 - 1970
正确:* [一本很有用的书 (1970)](https://example.org/book.html) - 张显宗 正确:* [一本很有用的书 (1970)](https://example.org/book.html) - 张显宗
``` ```
* <a name="in_process"></a>编写(翻译)中的书籍: * <a name="in_process"></a>编写(翻译)中的书籍:
``` ```text
正确:* [马上出版的一本书](http://example.com/book2.html) - 张显宗 (HTML) (:construction: *编写中*) 正确:* [马上出版的一本书](http://example.com/book2.html) - 张显宗 (HTML) (:construction: *编写中*)
正确:* [马上出版的一本书](http://example.com/book2.html) - 张显宗 (HTML) (:construction: *翻译中*) 正确:* [马上出版的一本书](http://example.com/book2.html) - 张显宗 (HTML) (:construction: *翻译中*)
``` ```

View File

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

View File

@ -74,6 +74,7 @@ The idea is to have:
Example: Example:
```text
[...] [...]
* [An Awesome Book](http://example.com/example.html) * [An Awesome Book](http://example.com/example.html)
(blank line) (blank line)
@ -82,38 +83,39 @@ Example:
(blank line) (blank line)
* [Another Awesome Book](http://example.com/book.html) * [Another Awesome Book](http://example.com/book.html)
* [Some Other Book](http://example.com/other.html) * [Some Other Book](http://example.com/other.html)
```
- Don't put spaces between `]` and `(`: - Don't put spaces between `]` and `(`:
``` ```text
BAD : * [Another Awesome Book] (http://example.com/book.html) BAD : * [Another Awesome Book] (http://example.com/book.html)
GOOD: * [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): - If you include the author, use ` - ` (a dash surrounded by single spaces):
``` ```text
BAD : * [Another Awesome Book](http://example.com/book.html)- John Doe BAD : * [Another Awesome Book](http://example.com/book.html)- John Doe
GOOD: * [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: - Put a single space between the link and its format:
``` ```text
BAD : * [A Very Awesome Book](https://example.org/book.pdf)(PDF) BAD : * [A Very Awesome Book](https://example.org/book.pdf)(PDF)
GOOD: * [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: - Author comes before format:
``` ```text
BAD : * [A Very Awesome Book](https://example.org/book.pdf)- (PDF) Jane Roe 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) GOOD: * [A Very Awesome Book](https://example.org/book.pdf) - Jane Roe (PDF)
``` ```
- Multiple formats: - Multiple formats:
``` ```text
BAD : * [Another Awesome Book](http://example.com/)- John Doe (HTML) BAD : * [Another Awesome Book](http://example.com/)- John Doe (HTML)
BAD : * [Another Awesome Book](https://downloads.example.org/book.html)- John Doe (download site) 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) 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: - Include publication year in title for older books:
``` ```text
BAD : * [A Very Awesome Book](https://example.org/book.html) - Jane Roe - 1970 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 GOOD: * [A Very Awesome Book (1970)](https://example.org/book.html) - Jane Roe
``` ```
- <a name="in_process"></a>In-process books: - <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*) GOOD: * [Will Be An Awesome Book Soon](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*)
``` ```
- <a name="archived"></a>Archived link: - <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)* 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) - 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`: - 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 check_urls=free-programming-books.md free-programming-books-en.md
``` ```