From f9dc719aef899896bebc92d5423ed53badf80f92 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?David=20Ord=C3=A1s?= <3125580+davorpa@users.noreply.github.com> Date: Thu, 4 Nov 2021 21:17:29 +0100 Subject: [PATCH] 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] --- CONTRIBUTING-de.md | 80 ++++++++++++++++++++-------------------- CONTRIBUTING-el.md | 86 ++++++++++++++++++++++--------------------- CONTRIBUTING-es.md | 84 +++++++++++++++++++++--------------------- CONTRIBUTING-fa_IR.md | 80 ++++++++++++++++++++-------------------- CONTRIBUTING-fil.md | 86 ++++++++++++++++++++++--------------------- CONTRIBUTING-fr.md | 80 ++++++++++++++++++++-------------------- CONTRIBUTING-it.md | 86 ++++++++++++++++++++++--------------------- CONTRIBUTING-ko.md | 80 ++++++++++++++++++++-------------------- CONTRIBUTING-pt_BR.md | 80 ++++++++++++++++++++-------------------- CONTRIBUTING-ru.md | 80 ++++++++++++++++++++-------------------- CONTRIBUTING-vi.md | 80 ++++++++++++++++++++-------------------- CONTRIBUTING-zh.md | 78 +++++++++++++++++++-------------------- CONTRIBUTING-zh_TW.md | 84 +++++++++++++++++++++--------------------- CONTRIBUTING.md | 86 ++++++++++++++++++++++--------------------- 14 files changed, 587 insertions(+), 563 deletions(-) diff --git a/CONTRIBUTING-de.md b/CONTRIBUTING-de.md index 415046181..53c397d6c 100644 --- a/CONTRIBUTING-de.md +++ b/CONTRIBUTING-de.md @@ -73,63 +73,65 @@ Folgende Formatierungsregeln sollten eingehalten werden: Beispiel: - [...] - * [Ein tolles Buch](http://example.com/example.html) - (Leerzeile) - (Leerzeile) - ### Beispiel - (Leerzeile) - * [Noch ein tolles Buch](http://example.com/book.html) - * [Ein anderes Buch](http://example.com/other.html) +```text +[...] +* [Ein tolles Buch](http://example.com/example.html) + (Leerzeile) + (Leerzeile) +### 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: -``` -FALSCH : * [Noch ein tolles Buch] (http://example.com/book.html) -RICHTIG: * [Noch ein tolles Buch](http://example.com/book.html) -``` + ```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): -``` -FALSCH : * [Noch ein tolles Buch](http://example.com/book.html)- John Doe -RICHTIG: * [Noch ein tolles Buch](http://example.com/book.html) - John Doe -``` + ```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: -``` -FALSCH : * [Ein sehr tolles Buch](https://example.org/book.pdf)(PDF) -RICHTIG: * [Ein sehr tolles Buch](https://example.org/book.pdf) (PDF) -``` + ```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: -``` -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) -``` + ```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: -``` -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) -``` + ```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) + ``` - Nenne das Jahr der Veröffentlichung im Titel bei älteren Publikationen: -``` -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 -``` + ```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 + ``` - Bücher in Bearbeitung: -``` -RICHTIG: * [Wird bald ein tolles Buch sein](http://example.com/book2.html) - John Doe (HTML) (:construction: *in Bearbeitung*) -``` + ```text + RICHTIG: * [Wird bald ein tolles Buch sein](http://example.com/book2.html) - John Doe (HTML) (:construction: *in Bearbeitung*) + ``` ### Hinweise @@ -228,9 +230,9 @@ 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. - Bei Angabe von mehr als einer Datei basiert das Ergebnis des Builds auf dem Ergebnis der letzten geprüften Datei. Du solltest Dir darüber im Klaren sein, dass dies zu gültigen Builds führen kann und daher das Build Protokoll am Ende des Pull Request durch Klick auf "Show all checks" -> "Details" genau geprüft werden sollte. diff --git a/CONTRIBUTING-el.md b/CONTRIBUTING-el.md index 03d752818..ac2b24481 100644 --- a/CONTRIBUTING-el.md +++ b/CONTRIBUTING-el.md @@ -79,69 +79,71 @@ Παράδειγμα: - [...] - * [Ένα Φοβερό Βιβλίο](http://example.com/example.html) - (κενή γραμμή) - (κενή γραμμή) - ### Παράδειγμα - (κενή γραμμή) - * [Άλλο Φοβερό Βιβλίο](http://example.com/book.html) - * [Κάποιο Άλλο Βιβλίο](http://example.com/other.html) +```text +[...] +* [Ένα Φοβερό Βιβλίο](http://example.com/example.html) + (κενή γραμμή) + (κενή γραμμή) +### Παράδειγμα + (κενή γραμμή) +* [Άλλο Φοβερό Βιβλίο](http://example.com/book.html) +* [Κάποιο Άλλο Βιβλίο](http://example.com/other.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)- John Doe -ΚΑΛΟ: * [Άλλο Φοβερό Βιβλίο](http://example.com/book.html) - John Doe -``` + ```text + ΚΑΚΟ: * [Άλλο Φοβερό Βιβλίο](http://example.com/book.html)- John Doe + ΚΑΛΟ: * [Άλλο Φοβερό Βιβλίο](http://example.com/book.html) - John Doe + ``` - Εισάγετε ένα κενό μεταξύ του συνδέσμου και του format του: -``` -ΚΑΚΟ: * [Ένα Πολύ Φοβερό Βιβλίο](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) + ``` - Ο συγγραφέας μπαίνει πριν το format -``` -ΚΑΚΟ: * [Ένα Πολύ Φοβερό Βιβλίο](https://example.org/book.pdf)- (PDF) Jane Roe -ΚΑΛΟ: * [Ένα Πολύ Φοβερό Βιβλίο](https://example.org/book.pdf) - Jane Roe (PDF) -``` + ```text + ΚΑΚΟ: * [Ένα Πολύ Φοβερό Βιβλίο](https://example.org/book.pdf)- (PDF) Jane Roe + ΚΑΛΟ: * [Ένα Πολύ Φοβερό Βιβλίο](https://example.org/book.pdf) - Jane Roe (PDF) + ``` - Πολλαπλά formats: -``` -ΚΑΚΟ: * [Ένα Πολύ Φοβερό Βιβλίο](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) -``` + ```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) + ``` - Συμπεριλαμβάνετε χρονιά δημοσιεύσης στον τίτλο για παλαιότερα βιβλία: -``` -ΚΑΚΟ: * [Ένα Πολύ Φοβερό Βιβλίο](https://example.org/book.html) - Jane Roe - 1970 -ΚΑΛΟ: * [Ένα Πολύ Φοβερό Βιβλίο (1970)](https://example.org/book.html) - Jane Roe -``` + ```text + ΚΑΚΟ: * [Ένα Πολύ Φοβερό Βιβλίο](https://example.org/book.html) - Jane Roe - 1970 + ΚΑΛΟ: * [Ένα Πολύ Φοβερό Βιβλίο (1970)](https://example.org/book.html) - Jane Roe + ``` - Βιβλία σε εξέλιξη: -``` -ΚΑΛΟ: * [Θα Είναι Σύντομα Ένα Φοβερό Βιβλίο](http://example.com/book2.html) - John Doe (HTML) (:construction: *σε εξέλιξη*) -``` + ```text + ΚΑΛΟ: * [Θα Είναι Σύντομα Ένα Φοβερό Βιβλίο](http://example.com/book2.html) - John Doe (HTML) (:construction: *σε εξέλιξη*) + ``` - Αρχειοθετημένοι σύνδεσμοι: -``` -ΚΑΛΟ: * [Ένα Ενδιαφέρον Way-backed Βιβλίο](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: αρχειοθετημένο)* -``` + ```text + ΚΑΛΟ: * [Ένα Ενδιαφέρον Way-backed Βιβλίο](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: αρχειοθετημένο)* + ``` @@ -243,9 +245,9 @@ - Η επικύρωση των 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 + ``` - Μπορείτε να προσδιορίσετε πάνω από ένα αρχείο για έλεγχο, χρησιμοποιώντας ένα κενό για να ξεχωρίσετε κάθε καταχώρηση. - Αν προσδιορίσετε πάνω από ένα αρχείο, τα αποτελέσματα του build βασίζονται στα αποτελέσματα του τελευταίου αρχείου που ελέγχθηκε. Θα πρέπει να γνωρίζετε ότι ενδέχεται να πάρετε επικυρωμένα builds εξαιτίας αυτού οπότε να είστε σίγουροι ότι επιβλέπετε το αρχείο του build στο τέλος του pull request πατώντας στο "Show all checks" -> "Details". diff --git a/CONTRIBUTING-es.md b/CONTRIBUTING-es.md index 29f0d8508..ee2670ce6 100644 --- a/CONTRIBUTING-es.md +++ b/CONTRIBUTING-es.md @@ -79,69 +79,71 @@ La idea es tener: Ejemplo: - [...] - * [Un libro increíble](http://example.com/example.html) - (línea en blanco) - (línea en blanco) - ### Sección de ejemplo - (línea en blanco) - * [Otro libro fascinante](http://example.com/book.html) - * [Otro libro más](http://example.com/other.html) +```text +[...] +* [Un libro increíble](http://example.com/example.html) + (línea en blanco) + (línea en blanco) +### Sección de 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 `(`: - ``` - INCORRECTO : * [Otro libro fascinante] (http://example.com/book.html) - CORRECTO : * [Otro libro fascinante](http://example.com/book.html) - ``` + ```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: - ``` - INCORRECTO : * [Un libro sencillamente fabuloso](http://example.com/book.html)- John Doe - CORRECTO : * [Un libro sencillamente fabuloso](http://example.com/book.html) - John Doe - ``` + ```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: - ``` - INCORRECTO : * [Un libro muy interesante](https://example.org/book.pdf)(PDF) - CORRECTO : * [Un libro muy interesante](https://example.org/book.pdf) (PDF) - ``` + ```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: - ``` - 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) - ``` + ```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: - ``` - 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) - ``` + ```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) + ``` - Incluya el año de publicación como parte del título de los libros más antiguos: - ``` - 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 - ``` + ```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 + ``` - Libros en proceso / no acabados aún: - ``` - CORRECTO: * [A punto de ser un libro fascinante](http://example.com/book2.html) - John Doe (HTML) (:construction: *en proceso*) - ``` + ```text + CORRECTO : * [A punto de ser un libro fascinante](http://example.com/book2.html) - John Doe (HTML) (:construction: *en proceso*) + ``` - Enlaces archivados: - ``` - 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)* - ``` + ```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. diff --git a/CONTRIBUTING-fa_IR.md b/CONTRIBUTING-fa_IR.md index 1010e1f70..8d2e98d3a 100644 --- a/CONTRIBUTING-fa_IR.md +++ b/CONTRIBUTING-fa_IR.md @@ -75,63 +75,65 @@ مثال: - [...] - * [یک کتاب عالی](http://example.com/example.html) - (خط خالی) - (خط خالی) - ### مثال - (خط خالی) - * [یک کتاب عالی دیگر](http://example.com/book.html) - * [یک کتاب دیگر](http://example.com/other.html) +```text +[...] +* [یک کتاب عالی](http://example.com/example.html) + (خط خالی) + (خط خالی) +### مثال + (خط خالی) +* [یک کتاب عالی دیگر](http://example.com/book.html) +* [یک کتاب دیگر](http://example.com/other.html) +``` * بین `]` و `(` space نگذارید: -``` -بد : * [یک کتاب عالی دیگر] (http://example.com/book.html) -خوب: * [یک کتاب عالی دیگر](http://example.com/book.html) -``` + ```text + بد : * [یک کتاب عالی دیگر] (http://example.com/book.html) + خوب: * [یک کتاب عالی دیگر](http://example.com/book.html) + ``` * اگر اسم نویسنده را اضافه می‌کنید، از ` - ` استفاده کنید (یک dash با دو single space): -``` -بد : * [یک کتاب عالی دیگر](http://example.com/book.html)- نام نویسنده -خوب: * [یک کتاب عالی دیگر](http://example.com/book.html) - نام نویسنده -``` + ```text + بد : * [یک کتاب عالی دیگر](http://example.com/book.html)- نام نویسنده + خوب: * [یک کتاب عالی دیگر](http://example.com/book.html) - نام نویسنده + ``` * یک single space بین لینک و فرمت قرار دهید: -``` -بد : * [یک کتاب خیلی عالی](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 + بد : * [یک کتاب خیلی عالی](https://example.org/book.pdf)- (PDF) نام نویسنده + خوب: * [یک کتاب خیلی عالی](https://example.org/book.pdf) - یک نویسنده دیگر (PDF) + ``` * چند فرمتی‌ها: -``` -بد : * [یک کتاب عالی دیگر](http://example.com/)- نام نویسنده (HTML) -بد : * [یک کتاب عالی دیگر](https://downloads.example.org/book.html)- نام نویسنده (download site) -خوب: * [یک کتاب عالی دیگر](http://example.com/) - نام نویسنده (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html) -``` + ```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) + ``` * سال انتشار برای کتاب‌های قدیمی را در عنوان ینویسید: -``` -بد : * [یک کتاب خیلی عالی](https://example.org/book.html) - نام نویسنده - 1970 -خوب: * [یک کتاب خیلی عالی (1970)](https://example.org/book.html) - نام نویسنده -``` + ```text + بد : * [یک کتاب خیلی عالی](https://example.org/book.html) - نام نویسنده - 1970 + خوب: * [یک کتاب خیلی عالی (1970)](https://example.org/book.html) - نام نویسنده + ``` * کتاب‌های در دست تالیف: -``` -خوب: * [کتابی که عالی خواهدشد](http://example.com/book2.html) - نام نویسنده (HTML) (:construction: *in process*) -``` + ```text + خوب: * [کتابی که عالی خواهدشد](http://example.com/book2.html) - نام نویسنده (HTML) (:construction: *in process*) + ``` ### خودکارسازی @@ -140,9 +142,9 @@ * اعتبارسنجی لینک‌ها با استفاده از [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 برای جدا کردن هر ورودی، می‌توانید بیشتر از یک فایل را برای بررسی مشخص کنید. * اگر بیش از یک فایل را مشخص کردید، نتایج بیلد بر اساس نتیجه آخرین فایل بررسی‌شده خواهد بود. دقت کنید که ممکن است به همین علت، نتیجه سبز را ببینید. پس برای اطمینان لاگ بیلد را با کلیک روی "Show all checks" -> "Details" در پایان پول ریکوئست ببینید. diff --git a/CONTRIBUTING-fil.md b/CONTRIBUTING-fil.md index e17853be0..ec130f22c 100644 --- a/CONTRIBUTING-fil.md +++ b/CONTRIBUTING-fil.md @@ -76,69 +76,71 @@ The idea is to have: Halimbawa: - [...] - * [An Awesome Book](http://example.com/example.html) - (blank line) - (blank line) - ### Example - (blank line) - * [Another Awesome Book](http://example.com/book.html) - * [Some Other Book](http://example.com/other.html) +```text +[...] +* [An Awesome Book](http://example.com/example.html) + (blank line) + (blank line) +### Example + (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 `(`: -``` -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) + GOOD: * [Another Awesome Book](http://example.com/book.html) + ``` - Kung isasama mo ang may-akda, gamitin ` - ` (isang gitling na napapalibutan ng mga solong espasyo): -``` -BAD : * [Another Awesome Book](http://example.com/book.html)- John Doe -GOOD: * [Another Awesome Book](http://example.com/book.html) - John Doe -``` + ```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: -``` -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) + GOOD: * [A Very Awesome Book](https://example.org/book.pdf) (PDF) + ``` - Nauna ang may-akda sa format: -``` -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 : * [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: -``` -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) -``` + ```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) + ``` - Isama ang taon ng publikasyon sa pamagat para sa mga mas lumang aklat: -``` -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 -``` + ```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 + ``` - In-process books: -``` -GOOD: * [Will Be An Awesome Book Soon](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*) -``` + ```text + GOOD: * [Will Be An Awesome Book Soon](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*) + ``` - Archived link: -``` -GOOD: * [A Way-backed Interesting Book](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: archived)* -``` + ```text + GOOD: * [A Way-backed Interesting Book](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: archived)* + ``` ### Mga Tala @@ -237,9 +239,9 @@ 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. - Kung tumukoy ka ng higit sa isang file, ang mga resulta ng build ay batay sa resulta ng huling file na nasuri. Dapat mong malaman na maaari kang makapasa sa mga berdeng build dahil dito kaya siguraduhing suriin ang build log sa dulo ng pull request sa pamamagitan ng pag-click sa "Show all checks" -> "Details". diff --git a/CONTRIBUTING-fr.md b/CONTRIBUTING-fr.md index 11c6f7862..db32ae525 100644 --- a/CONTRIBUTING-fr.md +++ b/CONTRIBUTING-fr.md @@ -73,63 +73,65 @@ l'idée est d'avoir: Exemple: - [...] - * [Un Livre Génial](http://exemple.com/exemple.html) - (ligne blanche) - (ligne blanche) - ### Exemple - (ligne blanche) - * [Un Autre Livre Génial](http://exemple.com/livre.html) - * [Un Autre Livre](http://exemple.com/autre.html) +```text +[...] +* [Un Livre Génial](http://exemple.com/exemple.html) + (ligne blanche) + (ligne blanche) +### Exemple + (ligne blanche) +* [Un Autre Livre Génial](http://exemple.com/livre.html) +* [Un Autre Livre](http://exemple.com/autre.html) +``` - Mettez pas des espaces entre `]` et `(`: -``` -MAUVAIS : * [Un Autre Livre Génial] (http://exemple.com/livre.html) -BIEN : * [Un Autre Livre Génial](http://exemple.com/livre.html) -``` + ```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): -``` -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 -``` + ```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: -``` -MAUVAIS : * [Un Autre Livre Génial](https://exemple.org/livre.pdf)(PDF) -BIEN : * [Un Autre Livre Génial](https://exemple.org/livre.pdf) (PDF) -``` + ```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: -``` -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) -``` + ```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: -``` -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) -``` + ```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) + ``` - Inclure l'année de publication dans le titre pour les livres plus anciens : -``` -MAUVAIS : * [Un Autre Livre Génial](https://exemple.org/livre.html) - Jane Roe - 1970 -BIEN : * [Un Autre Livre Génial (1970)](https://exemple.org/livre.html) - Jane Roe -``` + ```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 + ``` - Livres en cours : -``` -BIEN : * [Sera bientôt un livre génial](http://exemple.com/livre2.html) - John Doe (HTML) (:construction: *in process*) -``` + ``` + BIEN : * [Sera bientôt un livre génial](http://exemple.com/livre2.html) - John Doe (HTML) (:construction: *in process*) + ``` ### Remarques @@ -228,9 +230,9 @@ 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 - Si vous spécifiez plus d'un fichier, les résultats de la construction sont basés sur le résultat du dernier fichier vérifié. Vous devez savoir que vous pouvez obtenir des versions vertes de réussite à cause de cela, alors assurez-vous d'inspecter le journal de construction à la fin de la demande d'extraction en cliquant sur "Show all checks" -> "Details". diff --git a/CONTRIBUTING-it.md b/CONTRIBUTING-it.md index 29d4f070e..550d1c3e8 100644 --- a/CONTRIBUTING-it.md +++ b/CONTRIBUTING-it.md @@ -76,69 +76,71 @@ L'idea è di avere: Esempi: - [...] - * [An Awesome Book](http://example.com/example.html) - (linea vuota) - (linea vuota) - ### Esempio - (linea vuota) - * [Another Awesome Book](http://example.com/book.html) - * [Some Other Book](http://example.com/other.html) +```text +[...] +* [An Awesome Book](http://example.com/example.html) + (linea vuota) + (linea vuota) +### Esempio + (linea vuota) +* [Another Awesome Book](http://example.com/book.html) +* [Some Other Book](http://example.com/other.html) +``` - Non mettere uno spazio tra `]` e `(`: -``` -SCORRETTO : * [Another Awesome Book] (http://example.com/book.html) -CORRETTO: * [Another Awesome Book](http://example.com/book.html) -``` + ```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): -``` -SCORRETTO : * [Another Awesome Book](http://example.com/book.html)- John Doe -CORRETTO: * [Another Awesome Book](http://example.com/book.html) - John Doe -``` + ```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: -``` -SCORRETTO : * [A Very Awesome Book](https://example.org/book.pdf)(PDF) -CORRETTO: * [A Very Awesome Book](https://example.org/book.pdf) (PDF) -``` + ```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: -``` -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) -``` + ```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: -``` -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) -``` + ```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) + ``` - Includi l'anno di pubblicazione nel titolo per i libri più vecchi: -``` -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 -``` + ```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 + ``` - Libri in sviluppo: -``` -CORRETTO: * [Will Be An Awesome Book Soon](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*) -``` + ```text + CORRETTO : * [Will Be An Awesome Book Soon](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*) + ``` - Link archiviato: -``` -CORRETTO: * [A Way-backed Interesting Book](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: archived)* -``` + ```text + CORRETTO : * [A Way-backed Interesting Book](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: archived)* + ``` ### Note @@ -237,9 +239,9 @@ 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. - Se specifichi più di un file, i risultati della build si basano sul risultato dell'ultimo file controllato. Dovresti essere consapevole che potresti ottenere il passaggio di build verdi a causa di ciò, quindi assicurati di ispezionare il registro di build alla fine della richiesta pull facendo clic su "Show all checks" -> "Details". diff --git a/CONTRIBUTING-ko.md b/CONTRIBUTING-ko.md index 868f4423d..445029f3c 100644 --- a/CONTRIBUTING-ko.md +++ b/CONTRIBUTING-ko.md @@ -69,63 +69,65 @@ 예시: - [...] - * [An Awesome Book](http://example.com/example.html) - (blank line) - (blank line) - ### Example - (blank line) - * [Another Awesome Book](http://example.com/book.html) - * [Some Other Book](http://example.com/other.html) +```text +[...] +* [An Awesome Book](http://example.com/example.html) + (blank line) + (blank line) +### Example + (blank line) +* [Another Awesome Book](http://example.com/book.html) +* [Some Other Book](http://example.com/other.html) +``` - `]` 와 `(` 사이에 공백을 넣지 마십시오: -``` -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) + GOOD: * [Another Awesome Book](http://example.com/book.html) + ``` - 저자를 표시할 경우, ` - `를 사용하십시오 (띄어쓰기 - 띄어쓰기): -``` -BAD : * [Another Awesome Book](http://example.com/book.html)- John Doe -GOOD: * [Another Awesome Book](http://example.com/book.html) - John Doe -``` + ```text + BAD : * [Another Awesome Book](http://example.com/book.html)- John Doe + GOOD: * [Another Awesome Book](http://example.com/book.html) - John Doe + ``` - 바로가기와 형식 사이에는 공백을 삽입 하십시오: -``` -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) + GOOD: * [A Very Awesome Book](https://example.org/book.pdf) (PDF) + ``` - 저자는 형식 전에 옵니다: -``` -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 : * [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) + ``` - 여러가지의 파일 형식이 존재할떄: -``` -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) -``` + ```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) + ``` - 오래된 책들은 출판 년도를 포함하세요: -``` -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 -``` + ```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 + ``` - 작성중인 책: -``` -GOOD: * [Will Be An Awesome Book Soon](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*) -``` + ```text + GOOD: * [Will Be An Awesome Book Soon](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*) + ``` ### 노트(쪽지) @@ -224,9 +226,9 @@ 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 + ``` - 각 입력을 공백으로 구문하여 하나 이상의 파일을 검사 할 수 있습니다. - 만약 하나 이상의 파일을 검사한다면, 검사 결과는 마지막 파일의 검사 결과가 표시됩니다. 이 특성으로 인하여 통과를 받았더라도 관리자에 의하여 최종 승인이 보류 될 수 있습니다. 정확한 결과를 확인 하려면, "Show all checks" -> "Details"로 가세요. diff --git a/CONTRIBUTING-pt_BR.md b/CONTRIBUTING-pt_BR.md index b0dc906b7..19cae88fd 100644 --- a/CONTRIBUTING-pt_BR.md +++ b/CONTRIBUTING-pt_BR.md @@ -73,63 +73,65 @@ A ideia é ter: Exemplo: - [...] - * [Um Livro Incrível](http://exemplo.com/exemplo.html) - (linha em branco) - (linha em branco) - ### Exemplo - (linha em branco) - * [Outro Livro Incrível](http://exemplo.com/livro.html) - * [Outro Livro Qualquer](http://exemplo.com/outro.html) +```text +[...] +* [Um Livro Incrível](http://exemplo.com/exemplo.html) + (linha em branco) + (linha em branco) +### 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 `(`: -``` -RUIM : * [Outro Livro Incrível] (http://exemplo.com/livro.html) -BOM : * [Outro Livro Incrível](http://exemplo.com/livro.html) -``` + ```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): -``` -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 -``` + ```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: -``` -RUIM : * [Um Livro Muito Incrível](https://exemplo.org/livro.pdf)(PDF) -BOM : * [Um Livro Muito Incrível](https://exemplo.org/livro.pdf) (PDF) -``` + ```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: -``` -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) -``` + ```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: -``` -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) -``` + ```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) + ``` - Inclua o ano de publicação no título de livros antigos: -``` -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 -``` + ```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 + ``` - Livros em processo: -``` -BOM : * [Será Um Livro Incrível Em Breve](http://exemplo.com/livro2.html) - Fulano de Tal (HTML) (:construction: *em processo*) -``` + ```text + BOM : * [Será Um Livro Incrível Em Breve](http://exemplo.com/livro2.html) - Fulano de Tal (HTML) (:construction: *em processo*) + ``` ### Observações @@ -228,9 +230,9 @@ 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`: -``` -check_urls=free-programming-books.md free-programming-books-pt_BR.md -``` + ```properties + check_urls=free-programming-books.md free-programming-books-pt_BR.md + ``` - Você pode especificar mais de um arquivo para checagem, usando um espaço simples para separar cada entrada. - Se você especificar mais de um arquivo, os resultados de _build_ serão baseados no resultado do último arquivo verificado. Você deve se atentar para o fato de que pode obter um _build_ com verde de sucesso devido a isso. Então, certifique-se de inspecionar o _build log_ ao final de cada _pull request_ clicando em "Show all checks" -> "Details". diff --git a/CONTRIBUTING-ru.md b/CONTRIBUTING-ru.md index 5e000319e..6c1b4998d 100644 --- a/CONTRIBUTING-ru.md +++ b/CONTRIBUTING-ru.md @@ -78,63 +78,65 @@ Пример: - [...] - * [Шикарная книга](http://example.com/example.html) - (пустая строка) - (пустая строка) - ### Пример - (пустая строка) - * [Другая шикарная книга](http://example.com/book.html) - * [Ещё одна другая книга](http://example.com/other.html) +```text +[...] +* [Шикарная книга](http://example.com/example.html) + (пустая строка) + (пустая строка) +### Пример + (пустая строка) +* [Другая шикарная книга](http://example.com/book.html) +* [Ещё одна другая книга](http://example.com/other.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 + ПЛОХО : * [Другая шикарная книга](http://example.com/book.html)- Джон Доу + ХОРОШО: * [Другая шикарная книга](http://example.com/book.html) - Джон Доу + ``` - Отбейте ссылку и её формат пробелом: -``` -ПЛОХО : * [Очень хорошая книга](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 + ПЛОХО : * [Очень хорошая книга](https://example.org/book.pdf)- (PDF) Джейн Роу + ХОРОШО: * [Очень хорошая книга](https://example.org/book.pdf) - Джейн Роу (PDF) + ``` - Несколько форматов: -``` -ПЛОХО : * [Другая шикарная книга](http://example.com/)- Джон Доу (HTML) -ПЛОХО : * [Другая шикарная книга](https://downloads.example.org/book.html)- Джон Доу (cайт для загрузки) -ХОРОШО: * [Другая шикарная книга](http://example.com/) - Джон Доу (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html) -``` + ```text + ПЛОХО : * [Другая шикарная книга](http://example.com/)- Джон Доу (HTML) + ПЛОХО : * [Другая шикарная книга](https://downloads.example.org/book.html)- Джон Доу (cайт для загрузки) + ХОРОШО: * [Другая шикарная книга](http://example.com/) - Джон Доу (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html) + ``` - Включите год публикации в заголовок для старых книг: -``` -ПЛОХО : * [Очень хорошая книга](https://example.org/book.html) - Джейн Роу - 1970 -ХОРОШО: * [Очень хорошая книга (1970)](https://example.org/book.html) - Джейн Роу -``` + ```text + ПЛОХО : * [Очень хорошая книга](https://example.org/book.html) - Джейн Роу - 1970 + ХОРОШО: * [Очень хорошая книга (1970)](https://example.org/book.html) - Джейн Роу + ``` - Незавершенные книги: -``` -ХОРОШО: * [Скоро будет отличная книга](http://example.com/book2.html) - Джон Доу (HTML) (:construction: *in process*) -``` + ```text + ХОРОШО: * [Скоро будет отличная книга](http://example.com/book2.html) - Джон Доу (HTML) (:construction: *in process*) + ``` @@ -245,9 +247,9 @@ - Для проверки 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 + ``` - Вы можете указать более одного файла для проверки, используя один пробел для разделения каждой записи. - Если вы укажете более одного файла, результаты сборки будут основаны на результате последнего проверенного файла. Вы должны знать, что из-за этого вы можете получить проходящие зеленые сборки, поэтому обязательно проверьте журнал сборки в конце пулреквеста, нажав "Show all checks" -> "Details". diff --git a/CONTRIBUTING-vi.md b/CONTRIBUTING-vi.md index a203c9d10..f8c87af8e 100644 --- a/CONTRIBUTING-vi.md +++ b/CONTRIBUTING-vi.md @@ -83,63 +83,65 @@ Bằng cách đóng góp, bạn đồng ý tôn trọng [Quy Tắc Ứng Xử](h Ví dụ: - [...] - * [Một cuốn sách tuyệt vời](http://example.com/example.html) - (dòng trống) - (dòng trống) - ### 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) +```text +[...] +* [Một cuốn sách tuyệt vời](http://example.com/example.html) + (dòng trống) + (dòng trống) +### 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 `]` và `(`: -``` -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 + ``` - 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*) + ``` ### Ghi Chú @@ -238,9 +240,9 @@ 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. - Nếu bạn chỉ định nhiều hơn một tệp, kết quả của việc xây dựng sẽ dựa trên kết quả của tệp cuối cùng được kiểm tra. Bạn nên biết rằng bạn có thể nhận được bản xây dựng thành công, vì vậy hãy đảm bảo kiểm tra log ở cuối pull request bằng cách nhấp vào "Show all checks" -> "Details". diff --git a/CONTRIBUTING-zh.md b/CONTRIBUTING-zh.md index e8ca3ebc0..a0fe609ad 100644 --- a/CONTRIBUTING-zh.md +++ b/CONTRIBUTING-zh.md @@ -73,7 +73,7 @@ 举例: -``` +```text [...] * [一本很有用的书](http://example.com/example.html) (空行) @@ -86,65 +86,65 @@ * 在 `]` 和 `(` 之间不要留有空格: -``` -错误:* [一本很有用的书] (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 + 错误:* [一本很有用的书](http://example.com/book.html)- 张显宗 + 正确:* [一本很有用的书](http://example.com/book.html) - 张显宗 + ``` * 在链接和电子书格式之间放一个空格: -``` -错误:* [一本很有用的书](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) (繁体中文) -正确:* [一本很有用的书](https://example.org/book.pdf) (繁体中文) -``` + ```text + 错误:* [一本很有用的书](https://example.org/book.pdf) (繁体中文) + 正确:* [一本很有用的书](https://example.org/book.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) + ``` * 多重格式: -``` -错误:* [一本很有用的书](http://example.com/)- 张显宗 (HTML) -错误:* [一本很有用的书](https://downloads.example.org/book.html)- 张显宗 (download site) -正确:* [一本很有用的书](http://example.com/) - 张显宗 (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html) -``` + ```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) + ``` * 多作者,多译者时,请使用中文 `、` 进行分隔,在译者名字后请使用英文半角括号包围的 `(翻译)`,可以用 “等” 缩短作者列表: -``` -错误:* [一本很有用的书](https://example.org/book.pdf) - 张显宗,岳绮罗 -正确:* [一本很有用的书](https://example.org/book.pdf) - 张显宗、岳绮罗(翻译) -正确:* [一本很有用的书](https://example.org/book.pdf) - 张显宗、岳绮罗、顾玄武、出尘子 等 -``` + ```text + 错误:* [一本很有用的书](https://example.org/book.pdf) - 张显宗,岳绮罗 + 正确:* [一本很有用的书](https://example.org/book.pdf) - 张显宗、岳绮罗(翻译) + 正确:* [一本很有用的书](https://example.org/book.pdf) - 张显宗、岳绮罗、顾玄武、出尘子 等 + ``` * 在旧书的标题中包括出版年份: -``` -错误:* [一本很有用的书](https://example.org/book.html) - 张显宗 - 1970 -正确:* [一本很有用的书 (1970)](https://example.org/book.html) - 张显宗 -``` + ```text + 错误:* [一本很有用的书](https://example.org/book.html) - 张显宗 - 1970 + 正确:* [一本很有用的书 (1970)](https://example.org/book.html) - 张显宗 + ``` * 编写(翻译)中的书籍: -``` -正确:* [马上出版的一本书](http://example.com/book2.html) - 张显宗 (HTML) (:construction: *编写中*) -正确:* [马上出版的一本书](http://example.com/book2.html) - 张显宗 (HTML) (:construction: *翻译中*) -``` + ```text + 正确:* [马上出版的一本书](http://example.com/book2.html) - 张显宗 (HTML) (:construction: *编写中*) + 正确:* [马上出版的一本书](http://example.com/book2.html) - 张显宗 (HTML) (:construction: *翻译中*) + ``` diff --git a/CONTRIBUTING-zh_TW.md b/CONTRIBUTING-zh_TW.md index c4853e4f3..aa50ef985 100644 --- a/CONTRIBUTING-zh_TW.md +++ b/CONTRIBUTING-zh_TW.md @@ -73,7 +73,7 @@ 舉例: -``` +```text [...] * [一本很有用的書](http://example.com/example.html) (空行) @@ -86,68 +86,68 @@ * 在 `]` 和 `(` 之間不要留有空格: -``` -錯誤:* [一本很有用的書] (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 + 錯誤:* [一本很有用的書](http://example.com/book.html)- 張顯宗 + 正確:* [一本很有用的書](http://example.com/book.html) - 張顯宗 + ``` * 在連結和電子書格式之間放一個空格: -``` -錯誤:* [一本很有用的書](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) (繁體中文) -正確:* [一本很有用的書](https://example.org/book.pdf) (繁體中文) -``` + ```text + 錯誤:* [一本很有用的書](https://example.org/book.pdf) (繁體中文) + 正確:* [一本很有用的書](https://example.org/book.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) + ``` * 多重格式: -``` -錯誤:* [一本很有用的書](http://example.com/)- 張顯宗 (HTML) -錯誤:* [一本很有用的書](https://downloads.example.org/book.html)- 張顯宗 (download site) -正確:* [一本很有用的書](http://example.com/) - 張顯宗 (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html) -``` + ```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) + ``` * 多作者,多譯者時,請使用中文 `、` 進行分隔,在譯者名字後請使用英文半型括號包圍的 `(翻譯)`,可以用 “等” 縮短作者列表: -``` -錯誤:* [一本很有用的書](https://example.org/book.pdf) - 張顯宗,岳綺羅 -正確:* [一本很有用的書](https://example.org/book.pdf) - 張顯宗、岳綺羅(翻譯) -正確:* [一本很有用的書](https://example.org/book.pdf) - 張顯宗、岳綺羅、顧玄武、出塵子 等 -``` + ```text + 錯誤:* [一本很有用的書](https://example.org/book.pdf) - 張顯宗,岳綺羅 + 正確:* [一本很有用的書](https://example.org/book.pdf) - 張顯宗、岳綺羅(翻譯) + 正確:* [一本很有用的書](https://example.org/book.pdf) - 張顯宗、岳綺羅、顧玄武、出塵子 等 + ``` * 在舊書的標題中包括出版年份: -``` -錯誤:* [一本很有用的書](https://example.org/book.html) - 張顯宗 - 1970 -正確:* [一本很有用的書 (1970)](https://example.org/book.html) - 張顯宗 -``` + ```text + 錯誤:* [一本很有用的書](https://example.org/book.html) - 張顯宗 - 1970 + 正確:* [一本很有用的書 (1970)](https://example.org/book.html) - 張顯宗 + ``` * 編寫(翻譯)中的書籍: -``` -正確:* [即將出版的一本書](http://example.com/book2.html) - 張顯宗 (HTML) (:construction: *編寫中*) -正確:* [即將出版的一本書](http://example.com/book2.html) - 張顯宗 (HTML) (:construction: *翻譯中*) -``` + ```text + 正確:* [即將出版的一本書](http://example.com/book2.html) - 張顯宗 (HTML) (:construction: *編寫中*) + 正確:* [即將出版的一本書](http://example.com/book2.html) - 張顯宗 (HTML) (:construction: *翻譯中*) + ``` ### 自動化測試 @@ -156,9 +156,9 @@ - 使用 [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 + ``` - 您可以以一個空白區隔出想要進行驗證的檔案名稱來一次驗證多個檔案。 - 如果您一次驗證多個檔案,自動化測試的結果會是基於最後一個驗證的檔案。您的測試可能會因此通過,因此請詳加確認測試日誌。可以在 pull request 結果中點選"Show all checks" -> "Details" 來查看。 diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index e56236cea..ed372cf37 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -74,69 +74,71 @@ The idea is to have: Example: - [...] - * [An Awesome Book](http://example.com/example.html) - (blank line) - (blank line) - ### Example - (blank line) - * [Another Awesome Book](http://example.com/book.html) - * [Some Other Book](http://example.com/other.html) +```text +[...] +* [An Awesome Book](http://example.com/example.html) + (blank line) + (blank line) +### 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 `(`: -``` -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) + GOOD: * [Another Awesome Book](http://example.com/book.html) + ``` - If you include the author, use ` - ` (a dash surrounded by single spaces): -``` -BAD : * [Another Awesome Book](http://example.com/book.html)- John Doe -GOOD: * [Another Awesome Book](http://example.com/book.html) - John Doe -``` + ```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: -``` -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) + GOOD: * [A Very Awesome Book](https://example.org/book.pdf) (PDF) + ``` - Author comes before format: -``` -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 : * [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: -``` -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) -``` + ```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) + ``` - Include publication year in title for older books: -``` -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 -``` + ```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 + ``` - In-process books: -``` -GOOD: * [Will Be An Awesome Book Soon](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*) -``` + ```text + GOOD: * [Will Be An Awesome Book Soon](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*) + ``` - Archived link: -``` -GOOD: * [A Way-backed Interesting Book](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: archived)* -``` + ```text + GOOD: * [A Way-backed Interesting Book](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: archived)* + ``` ### Notes @@ -235,9 +237,9 @@ 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`: -``` -check_urls=free-programming-books.md free-programming-books-en.md -``` + ```properties + check_urls=free-programming-books.md free-programming-books-en.md + ``` - You may specify more than one file to check, using a single space to separate each entry. - If you specify more than one file, results of the build are based on the result of the last file checked. You should be aware that you may get passing green builds due to this so be sure to inspect the build log at the end of the pull request by clicking on "Show all checks" -> "Details".