mirror of
https://github.com/EbookFoundation/free-programming-books.git
synced 2025-01-22 02:18:51 +00:00
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
parent
31c776cb52
commit
f9dc719aef
@ -73,6 +73,7 @@ Folgende Formatierungsregeln sollten eingehalten werden:
|
||||
|
||||
Beispiel:
|
||||
|
||||
```text
|
||||
[...]
|
||||
* [Ein tolles Buch](http://example.com/example.html)
|
||||
(Leerzeile)
|
||||
@ -81,38 +82,39 @@ Beispiel:
|
||||
(Leerzeile)
|
||||
* [Noch ein tolles Buch](http://example.com/book.html)
|
||||
* [Ein anderes Buch](http://example.com/other.html)
|
||||
```
|
||||
|
||||
- Keine Leerzeichen zwischen `]` und `(` einfügen:
|
||||
|
||||
```
|
||||
```text
|
||||
FALSCH : * [Noch ein tolles Buch] (http://example.com/book.html)
|
||||
RICHTIG: * [Noch ein tolles Buch](http://example.com/book.html)
|
||||
```
|
||||
|
||||
- Wenn Du den Autor nennst, nutze ` - ` (einen mit Leerzeichen eingefassten Gedankenstrich):
|
||||
|
||||
```
|
||||
```text
|
||||
FALSCH : * [Noch ein tolles Buch](http://example.com/book.html)- John Doe
|
||||
RICHTIG: * [Noch ein tolles Buch](http://example.com/book.html) - John Doe
|
||||
```
|
||||
|
||||
- Füge ein einzelnes Leerzeichen zwischen dem Link und seinem Dateiformat ein:
|
||||
|
||||
```
|
||||
```text
|
||||
FALSCH : * [Ein sehr tolles Buch](https://example.org/book.pdf)(PDF)
|
||||
RICHTIG: * [Ein sehr tolles Buch](https://example.org/book.pdf) (PDF)
|
||||
```
|
||||
|
||||
- Der Autor wird vor dem Format genannt:
|
||||
|
||||
```
|
||||
```text
|
||||
FALSCH : * [Ein sehr tolles Buch](https://example.org/book.pdf)- (PDF) Jane Roe
|
||||
RICHTIG: * [Ein sehr tolles Buch](https://example.org/book.pdf) - Jane Roe (PDF)
|
||||
```
|
||||
|
||||
- Verschiedene Formate:
|
||||
|
||||
```
|
||||
```text
|
||||
FALSCH : * [Noch ein tolles Buch](http://example.com/)- John Doe (HTML)
|
||||
FALSCH : * [Noch ein tolles Buch](https://downloads.example.org/book.html)- John Doe (download site)
|
||||
RICHTIG: * [Noch ein tolles Buch](http://example.com/) - John Doe (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html)
|
||||
@ -120,14 +122,14 @@ RICHTIG: * [Noch ein tolles Buch](http://example.com/) - John Doe (HTML) [(PDF,
|
||||
|
||||
- Nenne das Jahr der Veröffentlichung im Titel bei älteren Publikationen:
|
||||
|
||||
```
|
||||
```text
|
||||
FALSCH : * [Ein sehr tolles Buch](https://example.org/book.html) - Jane Roe - 1970
|
||||
RICHTIG: * [Ein sehr tolles Buch (1970)](https://example.org/book.html) - Jane Roe
|
||||
```
|
||||
|
||||
- <a name="in_process"></a>Bücher in Bearbeitung:
|
||||
|
||||
```
|
||||
```text
|
||||
RICHTIG: * [Wird bald ein tolles Buch sein](http://example.com/book2.html) - John Doe (HTML) (:construction: *in Bearbeitung*)
|
||||
```
|
||||
|
||||
@ -228,8 +230,8 @@ Wenn etwas ausgedruckt werden kann, ohne dass es seinen Nutzen verliert, ist es
|
||||
- Die URLs werden über [awesome_bot](https://github.com/dkhamsing/awesome_bot) validiert.
|
||||
- Um die URL-Validierung auszulösen, kann ein Commit abgeschickt werden, der `check_urls=file_to_check` enthält:
|
||||
|
||||
```
|
||||
check_urls=free-programming-books.md free-programming-books-en.md
|
||||
```properties
|
||||
check_urls=free-programming-books.md free-programming-books-de.md
|
||||
```
|
||||
|
||||
- Man kann mehr als eine zu überprüfende Datei angeben, wobei die Einträge mit einem einzelnen Leerzeichen getrennt werden.
|
||||
|
||||
@ -79,6 +79,7 @@
|
||||
|
||||
Παράδειγμα:
|
||||
|
||||
```text
|
||||
[...]
|
||||
* [Ένα Φοβερό Βιβλίο](http://example.com/example.html)
|
||||
(κενή γραμμή)
|
||||
@ -87,38 +88,39 @@
|
||||
(κενή γραμμή)
|
||||
* [Άλλο Φοβερό Βιβλίο](http://example.com/book.html)
|
||||
* [Κάποιο Άλλο Βιβλίο](http://example.com/other.html)
|
||||
```
|
||||
|
||||
- Μη βάζετε κενό μεταξύ `]` και `(`:
|
||||
|
||||
```
|
||||
```text
|
||||
ΚΑΚΟ: * [Άλλο Φοβερό Βιβλίο] (http://example.com/book.html)
|
||||
ΚΑΛΟ: * [Άλλο Φοβερό Βιβλίο](http://example.com/book.html)
|
||||
```
|
||||
|
||||
- Αν συμπεριλαμβάνετε συγγραφέα, χρησιμοποιήστε ` - ` (μια παύλα που περιβάλλεται από κενά):
|
||||
|
||||
```
|
||||
```text
|
||||
ΚΑΚΟ: * [Άλλο Φοβερό Βιβλίο](http://example.com/book.html)- John Doe
|
||||
ΚΑΛΟ: * [Άλλο Φοβερό Βιβλίο](http://example.com/book.html) - John Doe
|
||||
```
|
||||
|
||||
- Εισάγετε ένα κενό μεταξύ του συνδέσμου και του format του:
|
||||
|
||||
```
|
||||
```text
|
||||
ΚΑΚΟ: * [Ένα Πολύ Φοβερό Βιβλίο](https://example.org/book.pdf)(PDF)
|
||||
ΚΑΛΟ: * [Ένα Πολύ Φοβερό Βιβλίο](https://example.org/book.pdf) (PDF)
|
||||
```
|
||||
|
||||
- Ο συγγραφέας μπαίνει πριν το format
|
||||
|
||||
```
|
||||
```text
|
||||
ΚΑΚΟ: * [Ένα Πολύ Φοβερό Βιβλίο](https://example.org/book.pdf)- (PDF) Jane Roe
|
||||
ΚΑΛΟ: * [Ένα Πολύ Φοβερό Βιβλίο](https://example.org/book.pdf) - Jane Roe (PDF)
|
||||
```
|
||||
|
||||
- Πολλαπλά formats:
|
||||
|
||||
```
|
||||
```text
|
||||
ΚΑΚΟ: * [Ένα Πολύ Φοβερό Βιβλίο](http://example.com/)- John Doe (HTML)
|
||||
ΚΑΚΟ: * [Ένα Πολύ Φοβερό Βιβλίο](https://downloads.example.org/book.html)- John Doe (download site)
|
||||
ΚΑΛΟ: * [Ένα Πολύ Φοβερό Βιβλίο](http://example.com/) - John Doe (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html)
|
||||
@ -126,20 +128,20 @@
|
||||
|
||||
- Συμπεριλαμβάνετε χρονιά δημοσιεύσης στον τίτλο για παλαιότερα βιβλία:
|
||||
|
||||
```
|
||||
```text
|
||||
ΚΑΚΟ: * [Ένα Πολύ Φοβερό Βιβλίο](https://example.org/book.html) - Jane Roe - 1970
|
||||
ΚΑΛΟ: * [Ένα Πολύ Φοβερό Βιβλίο (1970)](https://example.org/book.html) - Jane Roe
|
||||
```
|
||||
|
||||
- <a name="in_process"></a>Βιβλία σε εξέλιξη:
|
||||
|
||||
```
|
||||
```text
|
||||
ΚΑΛΟ: * [Θα Είναι Σύντομα Ένα Φοβερό Βιβλίο](http://example.com/book2.html) - John Doe (HTML) (:construction: *σε εξέλιξη*)
|
||||
```
|
||||
|
||||
- <a name="archived"></a>Αρχειοθετημένοι σύνδεσμοι:
|
||||
|
||||
```
|
||||
```text
|
||||
ΚΑΛΟ: * [Ένα Ενδιαφέρον Way-backed Βιβλίο](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: αρχειοθετημένο)*
|
||||
```
|
||||
|
||||
@ -243,8 +245,8 @@
|
||||
- Η επικύρωση των URL χρησιμοποιεί το [awesome_bot](https://github.com/dkhamsing/awesome_bot)
|
||||
- Για να ενεργοποιήσετε την επικύρωση του URL, κάντε push ένα commit που περιέχει ένα μήνυμα στο οποίο υπάρχει το `check_urls=file_to_check`:
|
||||
|
||||
```
|
||||
check_urls=free-programming-books.md free-programming-books-en.md
|
||||
```properties
|
||||
check_urls=free-programming-books.md free-programming-books-el.md
|
||||
```
|
||||
|
||||
- Μπορείτε να προσδιορίσετε πάνω από ένα αρχείο για έλεγχο, χρησιμοποιώντας ένα κενό για να ξεχωρίσετε κάθε καταχώρηση.
|
||||
|
||||
@ -79,6 +79,7 @@ La idea es tener:
|
||||
|
||||
Ejemplo:
|
||||
|
||||
```text
|
||||
[...]
|
||||
* [Un libro increíble](http://example.com/example.html)
|
||||
(línea en blanco)
|
||||
@ -87,38 +88,39 @@ Ejemplo:
|
||||
(línea en blanco)
|
||||
* [Otro libro fascinante](http://example.com/book.html)
|
||||
* [Otro libro más](http://example.com/other.html)
|
||||
```
|
||||
|
||||
- Omita los espacios entre `]` y `(`:
|
||||
|
||||
```
|
||||
```text
|
||||
INCORRECTO: * [Otro libro fascinante] (http://example.com/book.html)
|
||||
CORRECTO : * [Otro libro fascinante](http://example.com/book.html)
|
||||
```
|
||||
|
||||
- Si en el registro decide incluir al autor, emplee ` - ` (un guión rodeado de espacios simples) como separador:
|
||||
|
||||
```
|
||||
```text
|
||||
INCORRECTO: * [Un libro sencillamente fabuloso](http://example.com/book.html)- John Doe
|
||||
CORRECTO : * [Un libro sencillamente fabuloso](http://example.com/book.html) - John Doe
|
||||
```
|
||||
|
||||
- Ponga un solo espacio entre el enlace al contenido y su formato:
|
||||
|
||||
```
|
||||
```text
|
||||
INCORRECTO: * [Un libro muy interesante](https://example.org/book.pdf)(PDF)
|
||||
CORRECTO : * [Un libro muy interesante](https://example.org/book.pdf) (PDF)
|
||||
```
|
||||
|
||||
- El autor se antepone al formato:
|
||||
|
||||
```
|
||||
```text
|
||||
INCORRECTO: * [Un libro muy interesante](https://example.org/book.pdf)- (PDF) Jane Roe
|
||||
CORRECTO : * [Un libro muy interesante](https://example.org/book.pdf) - Jane Roe (PDF)
|
||||
```
|
||||
|
||||
- Múltiples formatos:
|
||||
|
||||
```
|
||||
```text
|
||||
INCORRECTO: * [Otro libro interesante](http://example.com/) - John Doe (HTML)
|
||||
INCORRECTO: * [Otro libro interesante](https://downloads.example.org/book.html) - John Doe (sitio de descarga)
|
||||
CORRECTO : * [Otro libro interesante](http://example.com/) - John Doe (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html)
|
||||
@ -126,20 +128,20 @@ Ejemplo:
|
||||
|
||||
- Incluya el año de publicación como parte del título de los libros más antiguos:
|
||||
|
||||
```
|
||||
```text
|
||||
INCORRECTO: * [Un libro bastante especial](https://example.org/book.html) - Jane Roe - 1970
|
||||
CORRECTO : * [Un libro bastante especial (1970)](https://example.org/book.html) - Jane Roe
|
||||
```
|
||||
|
||||
- <a name="in_process"></a>Libros en proceso / no acabados aún:
|
||||
|
||||
```
|
||||
```text
|
||||
CORRECTO : * [A punto de ser un libro fascinante](http://example.com/book2.html) - John Doe (HTML) (:construction: *en proceso*)
|
||||
```
|
||||
|
||||
- <a name="archived"></a>Enlaces archivados:
|
||||
|
||||
```
|
||||
```text
|
||||
CORRECTO : * [Un recurso recuperado a partir de su línea de tiempo](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: archivado)*
|
||||
```
|
||||
|
||||
@ -252,8 +254,8 @@ Si es posible imprimirlo y conservar su esencia, no es un Tutorial Interactivo.
|
||||
- La validación de URLs se realiza mediante [awesome_bot](https://github.com/dkhamsing/awesome_bot)
|
||||
- Para activar esta validación de URL, envíe un commit que incluya como mensaje de confirmación `check_urls=fichero_a_comprobar`:
|
||||
|
||||
```
|
||||
check_urls=free-programming-books.md free-programming-books-en.md
|
||||
```properties
|
||||
check_urls=free-programming-books.md free-programming-books-es.md
|
||||
```
|
||||
|
||||
- Es posible especificar más de un fichero a comprobar. Simplemente use un espacio para separar cada entrada.
|
||||
|
||||
@ -75,6 +75,7 @@
|
||||
|
||||
مثال:
|
||||
|
||||
```text
|
||||
[...]
|
||||
* [یک کتاب عالی](http://example.com/example.html)
|
||||
(خط خالی)
|
||||
@ -83,38 +84,39 @@
|
||||
(خط خالی)
|
||||
* [یک کتاب عالی دیگر](http://example.com/book.html)
|
||||
* [یک کتاب دیگر](http://example.com/other.html)
|
||||
```
|
||||
|
||||
* بین `]` و `(` space نگذارید:
|
||||
|
||||
```
|
||||
```text
|
||||
بد : * [یک کتاب عالی دیگر] (http://example.com/book.html)
|
||||
خوب: * [یک کتاب عالی دیگر](http://example.com/book.html)
|
||||
```
|
||||
|
||||
* اگر اسم نویسنده را اضافه میکنید، از ` - ` استفاده کنید (یک dash با دو single space):
|
||||
|
||||
```
|
||||
```text
|
||||
بد : * [یک کتاب عالی دیگر](http://example.com/book.html)- نام نویسنده
|
||||
خوب: * [یک کتاب عالی دیگر](http://example.com/book.html) - نام نویسنده
|
||||
```
|
||||
|
||||
* یک single space بین لینک و فرمت قرار دهید:
|
||||
|
||||
```
|
||||
```text
|
||||
بد : * [یک کتاب خیلی عالی](https://example.org/book.pdf)(PDF)
|
||||
خوب: * [یک کتاب خیلی عالی](https://example.org/book.pdf) (PDF)
|
||||
```
|
||||
|
||||
* نویسنده قبل از فرمت میآید:
|
||||
|
||||
```
|
||||
```text
|
||||
بد : * [یک کتاب خیلی عالی](https://example.org/book.pdf)- (PDF) نام نویسنده
|
||||
خوب: * [یک کتاب خیلی عالی](https://example.org/book.pdf) - یک نویسنده دیگر (PDF)
|
||||
```
|
||||
|
||||
* چند فرمتیها:
|
||||
|
||||
```
|
||||
```text
|
||||
بد : * [یک کتاب عالی دیگر](http://example.com/)- نام نویسنده (HTML)
|
||||
بد : * [یک کتاب عالی دیگر](https://downloads.example.org/book.html)- نام نویسنده (download site)
|
||||
خوب: * [یک کتاب عالی دیگر](http://example.com/) - نام نویسنده (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html)
|
||||
@ -122,14 +124,14 @@
|
||||
|
||||
* سال انتشار برای کتابهای قدیمی را در عنوان ینویسید:
|
||||
|
||||
```
|
||||
```text
|
||||
بد : * [یک کتاب خیلی عالی](https://example.org/book.html) - نام نویسنده - 1970
|
||||
خوب: * [یک کتاب خیلی عالی (1970)](https://example.org/book.html) - نام نویسنده
|
||||
```
|
||||
|
||||
* <a name="in_process"></a>کتابهای در دست تالیف:
|
||||
|
||||
```
|
||||
```text
|
||||
خوب: * [کتابی که عالی خواهدشد](http://example.com/book2.html) - نام نویسنده (HTML) (:construction: *in process*)
|
||||
```
|
||||
|
||||
@ -140,8 +142,8 @@
|
||||
* اعتبارسنجی لینکها با استفاده از [awesome_bot](https://github.com/dkhamsing/awesome_bot) انجام میشود.
|
||||
* برای اجرای اعتبارسنجی لینکها، کامیتی پوش کنید که در بدنهی آن `check_urls=file_to_check` نوشته شده باشد:
|
||||
|
||||
```
|
||||
check_urls=free-programming-books.md free-programming-books-en.md
|
||||
```properties
|
||||
check_urls=free-programming-books.md free-programming-books-fa_IR.md
|
||||
```
|
||||
|
||||
* با استفاده از single space برای جدا کردن هر ورودی، میتوانید بیشتر از یک فایل را برای بررسی مشخص کنید.
|
||||
|
||||
@ -76,6 +76,7 @@ The idea is to have:
|
||||
|
||||
Halimbawa:
|
||||
|
||||
```text
|
||||
[...]
|
||||
* [An Awesome Book](http://example.com/example.html)
|
||||
(blank line)
|
||||
@ -84,38 +85,39 @@ Halimbawa:
|
||||
(blank line)
|
||||
* [Another Awesome Book](http://example.com/book.html)
|
||||
* [Some Other Book](http://example.com/other.html)
|
||||
```
|
||||
|
||||
- Huwag maglagay ng mga puwang sa pagitan `]` at `(`:
|
||||
|
||||
```
|
||||
```text
|
||||
BAD : * [Another Awesome Book] (http://example.com/book.html)
|
||||
GOOD: * [Another Awesome Book](http://example.com/book.html)
|
||||
```
|
||||
|
||||
- Kung isasama mo ang may-akda, gamitin ` - ` (isang gitling na napapalibutan ng mga solong espasyo):
|
||||
|
||||
```
|
||||
```text
|
||||
BAD : * [Another Awesome Book](http://example.com/book.html)- John Doe
|
||||
GOOD: * [Another Awesome Book](http://example.com/book.html) - John Doe
|
||||
```
|
||||
|
||||
- Maglagay ng isang puwang sa pagitan ng link at ang format nito:
|
||||
|
||||
```
|
||||
```text
|
||||
BAD : * [A Very Awesome Book](https://example.org/book.pdf)(PDF)
|
||||
GOOD: * [A Very Awesome Book](https://example.org/book.pdf) (PDF)
|
||||
```
|
||||
|
||||
- Nauna ang may-akda sa format:
|
||||
|
||||
```
|
||||
```text
|
||||
BAD : * [A Very Awesome Book](https://example.org/book.pdf)- (PDF) Jane Roe
|
||||
GOOD: * [A Very Awesome Book](https://example.org/book.pdf) - Jane Roe (PDF)
|
||||
```
|
||||
|
||||
- Maramihang format:
|
||||
|
||||
```
|
||||
```text
|
||||
BAD : * [Another Awesome Book](http://example.com/)- John Doe (HTML)
|
||||
BAD : * [Another Awesome Book](https://downloads.example.org/book.html)- John Doe (download site)
|
||||
GOOD: * [Another Awesome Book](http://example.com/) - John Doe (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html)
|
||||
@ -123,20 +125,20 @@ GOOD: * [Another Awesome Book](http://example.com/) - John Doe (HTML) [(PDF, EPU
|
||||
|
||||
- Isama ang taon ng publikasyon sa pamagat para sa mga mas lumang aklat:
|
||||
|
||||
```
|
||||
```text
|
||||
BAD : * [A Very Awesome Book](https://example.org/book.html) - Jane Roe - 1970
|
||||
GOOD: * [A Very Awesome Book (1970)](https://example.org/book.html) - Jane Roe
|
||||
```
|
||||
|
||||
- <a name="in_process"></a>In-process books:
|
||||
|
||||
```
|
||||
```text
|
||||
GOOD: * [Will Be An Awesome Book Soon](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*)
|
||||
```
|
||||
|
||||
- <a name="archived"></a>Archived link:
|
||||
|
||||
```
|
||||
```text
|
||||
GOOD: * [A Way-backed Interesting Book](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: archived)*
|
||||
```
|
||||
|
||||
@ -237,8 +239,8 @@ Kung maaari mong i-print ito at panatilihin ang kakanyahan nito, hindi ito isang
|
||||
- Gumagamit ng pagpapatunay ng URL [awesome_bot](https://github.com/dkhamsing/awesome_bot)
|
||||
- Upang ma-trigger ang pagpapatunay ng URL, mag-push ng commit na may kasamang commit na mensahe na naglalaman `check_urls=file_to_check`:
|
||||
|
||||
```
|
||||
check_urls=free-programming-books.md free-programming-books-en.md
|
||||
```properties
|
||||
check_urls=free-programming-books.md free-programming-books-fil.md
|
||||
```
|
||||
|
||||
- Maaari kang tumukoy ng higit sa isang file na susuriin, gamit ang isang puwang upang paghiwalayin ang bawat entry.
|
||||
|
||||
@ -73,6 +73,7 @@ l'idée est d'avoir:
|
||||
|
||||
Exemple:
|
||||
|
||||
```text
|
||||
[...]
|
||||
* [Un Livre Génial](http://exemple.com/exemple.html)
|
||||
(ligne blanche)
|
||||
@ -81,38 +82,39 @@ Exemple:
|
||||
(ligne blanche)
|
||||
* [Un Autre Livre Génial](http://exemple.com/livre.html)
|
||||
* [Un Autre Livre](http://exemple.com/autre.html)
|
||||
```
|
||||
|
||||
- Mettez pas des espaces entre `]` et `(`:
|
||||
|
||||
```
|
||||
```text
|
||||
MAUVAIS: * [Un Autre Livre Génial] (http://exemple.com/livre.html)
|
||||
BIEN : * [Un Autre Livre Génial](http://exemple.com/livre.html)
|
||||
```
|
||||
|
||||
- Si vous incluez l'auteur, utilisez ` - ` (un tiret entouré d'un espaces):
|
||||
|
||||
```
|
||||
```text
|
||||
MAUVAIS: * [Un Autre Livre Génial](http://exemple.com/livre.html)- John Doe
|
||||
BIEN : * [Un Autre Livre Génial](http://exemple.com/livre.html) - John Doe
|
||||
```
|
||||
|
||||
- Mettez un seul espace entre le lien et son format:
|
||||
|
||||
```
|
||||
```text
|
||||
MAUVAIS: * [Un Autre Livre Génial](https://exemple.org/livre.pdf)(PDF)
|
||||
BIEN : * [Un Autre Livre Génial](https://exemple.org/livre.pdf) (PDF)
|
||||
```
|
||||
|
||||
- L'auteur vient avant le format:
|
||||
|
||||
```
|
||||
```text
|
||||
MAUVAIS: * [Un Autre Livre Génial](https://exemple.org/livre.pdf)- (PDF) Jane Roe
|
||||
BIEN : * [Un Autre Livre Génial](https://exemple.org/livre.pdf) - Jane Roe (PDF)
|
||||
```
|
||||
|
||||
- Formats multiples:
|
||||
|
||||
```
|
||||
```text
|
||||
MAUVAIS: * [Un Autre Livre Génial](http://exemple.com/)- John Doe (HTML)
|
||||
MAUVAIS: * [Un Autre Livre Génial](https://downloads.exemple.org/livre.html)- John Doe (site de téléchargement)
|
||||
BIEN : * [Un Autre Livre Génial](http://exemple.com/) - John Doe (HTML) [(PDF, EPUB)](https://downloads.exemple.org/livre.html)
|
||||
@ -120,7 +122,7 @@ BIEN : * [Un Autre Livre Génial](http://exemple.com/) - John Doe (HTML) [(PD
|
||||
|
||||
- Inclure l'année de publication dans le titre pour les livres plus anciens :
|
||||
|
||||
```
|
||||
```text
|
||||
MAUVAIS: * [Un Autre Livre Génial](https://exemple.org/livre.html) - Jane Roe - 1970
|
||||
BIEN : * [Un Autre Livre Génial (1970)](https://exemple.org/livre.html) - Jane Roe
|
||||
```
|
||||
@ -228,8 +230,8 @@ Si vous pouvez l'imprimer et conserver son essence, ce n'est pas un didacticiel
|
||||
- La validation d'URL utilise [awesome_bot](https://github.com/dkhamsing/awesome_bot)
|
||||
- Pour déclencher la validation d'URL, poussez un commit qui inclut un message de commit contenant `check_urls=file_to_check` :
|
||||
|
||||
```
|
||||
check_urls=free-programming-livres.md free-programming-livres-en.md
|
||||
```properties
|
||||
check_urls=free-programming-books.md free-programming-books-fr.md
|
||||
```
|
||||
|
||||
- Vous pouvez spécifier plus d'un fichier à vérifier, en utilisant un seul espace pour séparer chaque entrée
|
||||
|
||||
@ -76,6 +76,7 @@ L'idea è di avere:
|
||||
|
||||
Esempi:
|
||||
|
||||
```text
|
||||
[...]
|
||||
* [An Awesome Book](http://example.com/example.html)
|
||||
(linea vuota)
|
||||
@ -84,38 +85,39 @@ Esempi:
|
||||
(linea vuota)
|
||||
* [Another Awesome Book](http://example.com/book.html)
|
||||
* [Some Other Book](http://example.com/other.html)
|
||||
```
|
||||
|
||||
- Non mettere uno spazio tra `]` e `(`:
|
||||
|
||||
```
|
||||
```text
|
||||
SCORRETTO: * [Another Awesome Book] (http://example.com/book.html)
|
||||
CORRETTO : * [Another Awesome Book](http://example.com/book.html)
|
||||
```
|
||||
|
||||
- Se includi gli autori, usa ` - ` (un trattino circondato da spazi singoli):
|
||||
|
||||
```
|
||||
```text
|
||||
SCORRETTO: * [Another Awesome Book](http://example.com/book.html)- John Doe
|
||||
CORRETTO : * [Another Awesome Book](http://example.com/book.html) - John Doe
|
||||
```
|
||||
|
||||
- Metti uno spazio tra il link e il formato:
|
||||
|
||||
```
|
||||
```text
|
||||
SCORRETTO: * [A Very Awesome Book](https://example.org/book.pdf)(PDF)
|
||||
CORRETTO : * [A Very Awesome Book](https://example.org/book.pdf) (PDF)
|
||||
```
|
||||
|
||||
- Gli autori vanno prima del formato:
|
||||
|
||||
```
|
||||
```text
|
||||
SCORRETTO: * [A Very Awesome Book](https://example.org/book.pdf)- (PDF) Jane Roe
|
||||
CORRETTO : * [A Very Awesome Book](https://example.org/book.pdf) - Jane Roe (PDF)
|
||||
```
|
||||
|
||||
- Formati multipli:
|
||||
|
||||
```
|
||||
```text
|
||||
SCORRETTO: * [Another Awesome Book](http://example.com/)- John Doe (HTML)
|
||||
SCORRETTO: * [Another Awesome Book](https://downloads.example.org/book.html)- John Doe (download site)
|
||||
CORRETTO : * [Another Awesome Book](http://example.com/) - John Doe (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html)
|
||||
@ -123,20 +125,20 @@ CORRETTO: * [Another Awesome Book](http://example.com/) - John Doe (HTML) [(PDF,
|
||||
|
||||
- Includi l'anno di pubblicazione nel titolo per i libri più vecchi:
|
||||
|
||||
```
|
||||
```text
|
||||
SCORRETTO: * [A Very Awesome Book](https://example.org/book.html) - Jane Roe - 1970
|
||||
CORRETTO : * [A Very Awesome Book (1970)](https://example.org/book.html) - Jane Roe
|
||||
```
|
||||
|
||||
- <a name="in_process"></a>Libri in sviluppo:
|
||||
|
||||
```
|
||||
```text
|
||||
CORRETTO : * [Will Be An Awesome Book Soon](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*)
|
||||
```
|
||||
|
||||
- <a name="archived"></a>Link archiviato:
|
||||
|
||||
```
|
||||
```text
|
||||
CORRETTO : * [A Way-backed Interesting Book](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: archived)*
|
||||
```
|
||||
|
||||
@ -237,8 +239,8 @@ Se riesci a stamparlo e conservarne l'essenza, non è un tutorial interattivo.
|
||||
- La validazione dell'URL usa [awesome_bot](https://github.com/dkhamsing/awesome_bot)
|
||||
- Per attivare la convalida dell'URL, invia un commit che includa un messaggio di commit contenente `check_urls=file_to_check`:
|
||||
|
||||
```
|
||||
check_urls=free-programming-books.md free-programming-books-en.md
|
||||
```properties
|
||||
check_urls=free-programming-books.md free-programming-books-it.md
|
||||
```
|
||||
|
||||
- È possibile specificare più di un file da controllare, utilizzando un singolo spazio per separare ogni voce.
|
||||
|
||||
@ -69,6 +69,7 @@
|
||||
|
||||
예시:
|
||||
|
||||
```text
|
||||
[...]
|
||||
* [An Awesome Book](http://example.com/example.html)
|
||||
(blank line)
|
||||
@ -77,38 +78,39 @@
|
||||
(blank line)
|
||||
* [Another Awesome Book](http://example.com/book.html)
|
||||
* [Some Other Book](http://example.com/other.html)
|
||||
```
|
||||
|
||||
- `]` 와 `(` 사이에 공백을 넣지 마십시오:
|
||||
|
||||
```
|
||||
```text
|
||||
BAD : * [Another Awesome Book] (http://example.com/book.html)
|
||||
GOOD: * [Another Awesome Book](http://example.com/book.html)
|
||||
```
|
||||
|
||||
- 저자를 표시할 경우, ` - `를 사용하십시오 (띄어쓰기 - 띄어쓰기):
|
||||
|
||||
```
|
||||
```text
|
||||
BAD : * [Another Awesome Book](http://example.com/book.html)- John Doe
|
||||
GOOD: * [Another Awesome Book](http://example.com/book.html) - John Doe
|
||||
```
|
||||
|
||||
- 바로가기와 형식 사이에는 공백을 삽입 하십시오:
|
||||
|
||||
```
|
||||
```text
|
||||
BAD : * [A Very Awesome Book](https://example.org/book.pdf)(PDF)
|
||||
GOOD: * [A Very Awesome Book](https://example.org/book.pdf) (PDF)
|
||||
```
|
||||
|
||||
- 저자는 형식 전에 옵니다:
|
||||
|
||||
```
|
||||
```text
|
||||
BAD : * [A Very Awesome Book](https://example.org/book.pdf)- (PDF) Jane Roe
|
||||
GOOD: * [A Very Awesome Book](https://example.org/book.pdf) - Jane Roe (PDF)
|
||||
```
|
||||
|
||||
- 여러가지의 파일 형식이 존재할떄:
|
||||
|
||||
```
|
||||
```text
|
||||
BAD : * [Another Awesome Book](http://example.com/)- John Doe (HTML)
|
||||
BAD : * [Another Awesome Book](https://downloads.example.org/book.html)- John Doe (download site)
|
||||
GOOD: * [Another Awesome Book](http://example.com/) - John Doe (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html)
|
||||
@ -116,14 +118,14 @@ GOOD: * [Another Awesome Book](http://example.com/) - John Doe (HTML) [(PDF, EPU
|
||||
|
||||
- 오래된 책들은 출판 년도를 포함하세요:
|
||||
|
||||
```
|
||||
```text
|
||||
BAD : * [A Very Awesome Book](https://example.org/book.html) - Jane Roe - 1970
|
||||
GOOD: * [A Very Awesome Book (1970)](https://example.org/book.html) - Jane Roe
|
||||
```
|
||||
|
||||
- <a name="in_process"></a>작성중인 책:
|
||||
|
||||
```
|
||||
```text
|
||||
GOOD: * [Will Be An Awesome Book Soon](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*)
|
||||
```
|
||||
|
||||
@ -224,8 +226,8 @@ GOOD: * [Will Be An Awesome Book Soon](http://example.com/book2.html) - John Doe
|
||||
- 바로가기 주소 검증은 [awesome_bot](https://github.com/dkhamsing/awesome_bot)를 이용합니다
|
||||
- 바로가기 주소 검증을 위해 커밋 메시지에 `check_urls=file_to_check`을 포함해 주세요:
|
||||
|
||||
```
|
||||
check_urls=free-programming-books.md free-programming-books-en.md
|
||||
```properties
|
||||
check_urls=free-programming-books.md free-programming-books-ko.md
|
||||
```
|
||||
|
||||
- 각 입력을 공백으로 구문하여 하나 이상의 파일을 검사 할 수 있습니다.
|
||||
|
||||
@ -73,6 +73,7 @@ A ideia é ter:
|
||||
|
||||
Exemplo:
|
||||
|
||||
```text
|
||||
[...]
|
||||
* [Um Livro Incrível](http://exemplo.com/exemplo.html)
|
||||
(linha em branco)
|
||||
@ -81,38 +82,39 @@ Exemplo:
|
||||
(linha em branco)
|
||||
* [Outro Livro Incrível](http://exemplo.com/livro.html)
|
||||
* [Outro Livro Qualquer](http://exemplo.com/outro.html)
|
||||
```
|
||||
|
||||
- Não coloque espaços entre `]` e `(`:
|
||||
|
||||
```
|
||||
```text
|
||||
RUIM: * [Outro Livro Incrível] (http://exemplo.com/livro.html)
|
||||
BOM : * [Outro Livro Incrível](http://exemplo.com/livro.html)
|
||||
```
|
||||
|
||||
- Se incluir o autor, use ` - ` (um traço envolto por espaços simples):
|
||||
|
||||
```
|
||||
```text
|
||||
RUIM: * [Outro Livro Incrível](http://exemplo.com/livro.html)- Fulano de Tal
|
||||
BOM : * [Outro Livro Incrível](http://exemplo.com/livro.html) - Fulano de Tal
|
||||
```
|
||||
|
||||
- Coloque um espaço simples entre o _link_ e seu formato:
|
||||
|
||||
```
|
||||
```text
|
||||
RUIM: * [Um Livro Muito Incrível](https://exemplo.org/livro.pdf)(PDF)
|
||||
BOM : * [Um Livro Muito Incrível](https://exemplo.org/livro.pdf) (PDF)
|
||||
```
|
||||
|
||||
- Autor vem antes do formato:
|
||||
|
||||
```
|
||||
```text
|
||||
RUIM: * [Um Livro Muito Incrível](https://exemplo.org/livro.pdf)- (PDF) Fulana de Tal
|
||||
BOM : * [Um Livro Muito Incrível](https://exemplo.org/livro.pdf) - Fulana de Tal (PDF)
|
||||
```
|
||||
|
||||
- Múltiplos formatos:
|
||||
|
||||
```
|
||||
```text
|
||||
RUIM: * [Outro Livro Incrível](http://exemplo.com/)- Fulano de Tal (HTML)
|
||||
RUIM: * [Outro Livro Incrível](https://downloads.exemplo.org/livro.html)- Fulano de Tal (download site)
|
||||
BOM : * [Outro Livro Incrível](http://exemplo.com/) - Fulano de Tal (HTML) [(PDF, EPUB)](https://downloads.exemplo.org/livro.html)
|
||||
@ -120,14 +122,14 @@ BOM : * [Outro Livro Incrível](http://exemplo.com/) - Fulano de Tal (HTML) [(P
|
||||
|
||||
- Inclua o ano de publicação no título de livros antigos:
|
||||
|
||||
```
|
||||
```text
|
||||
RUIM: * [Um Livro Muito Incrível](https://exemplo.org/livro.html) - Fulana de Tal - 1970
|
||||
BOM : * [Um Livro Muito Incrível (1970)](https://exemplo.org/livro.html) - Fulana de Tal
|
||||
```
|
||||
|
||||
- <a name="in_process"></a>Livros em processo:
|
||||
|
||||
```
|
||||
```text
|
||||
BOM : * [Será Um Livro Incrível Em Breve](http://exemplo.com/livro2.html) - Fulano de Tal (HTML) (:construction: *em processo*)
|
||||
```
|
||||
|
||||
@ -228,7 +230,7 @@ Se você pode capturar a tela ou imprimí-la e reter sua essência, então não
|
||||
- Validação de URL usa [awesome_bot](https://github.com/dkhamsing/awesome_bot)
|
||||
- Para ativar a validação de URL, dê _push_ num _commit_ que inclua uma mensagem de _commit_ contendo `check_urls=file_to_check`:
|
||||
|
||||
```
|
||||
```properties
|
||||
check_urls=free-programming-books.md free-programming-books-pt_BR.md
|
||||
```
|
||||
|
||||
|
||||
@ -78,6 +78,7 @@
|
||||
|
||||
Пример:
|
||||
|
||||
```text
|
||||
[...]
|
||||
* [Шикарная книга](http://example.com/example.html)
|
||||
(пустая строка)
|
||||
@ -86,38 +87,39 @@
|
||||
(пустая строка)
|
||||
* [Другая шикарная книга](http://example.com/book.html)
|
||||
* [Ещё одна другая книга](http://example.com/other.html)
|
||||
```
|
||||
|
||||
- Не вставляйте пробел между `]` и `(`:
|
||||
|
||||
```
|
||||
```text
|
||||
ПЛОХО : * [Другая шикарная книга] (http://example.com/book.html)
|
||||
ХОРОШО: * [Другая шикарная книга](http://example.com/book.html)
|
||||
```
|
||||
|
||||
- Если вы указываете автора, используйте ` - ` (тире, окруженное одиночными пробелами):
|
||||
|
||||
```
|
||||
```text
|
||||
ПЛОХО : * [Другая шикарная книга](http://example.com/book.html)- Джон Доу
|
||||
ХОРОШО: * [Другая шикарная книга](http://example.com/book.html) - Джон Доу
|
||||
```
|
||||
|
||||
- Отбейте ссылку и её формат пробелом:
|
||||
|
||||
```
|
||||
```text
|
||||
ПЛОХО : * [Очень хорошая книга](https://example.org/book.pdf)(PDF)
|
||||
ХОРОШО: * [Очень хорошая книга](https://example.org/book.pdf) (PDF)
|
||||
```
|
||||
|
||||
- Сперва автор, потом формат:
|
||||
|
||||
```
|
||||
```text
|
||||
ПЛОХО : * [Очень хорошая книга](https://example.org/book.pdf)- (PDF) Джейн Роу
|
||||
ХОРОШО: * [Очень хорошая книга](https://example.org/book.pdf) - Джейн Роу (PDF)
|
||||
```
|
||||
|
||||
- Несколько форматов:
|
||||
|
||||
```
|
||||
```text
|
||||
ПЛОХО : * [Другая шикарная книга](http://example.com/)- Джон Доу (HTML)
|
||||
ПЛОХО : * [Другая шикарная книга](https://downloads.example.org/book.html)- Джон Доу (cайт для загрузки)
|
||||
ХОРОШО: * [Другая шикарная книга](http://example.com/) - Джон Доу (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html)
|
||||
@ -125,14 +127,14 @@
|
||||
|
||||
- Включите год публикации в заголовок для старых книг:
|
||||
|
||||
```
|
||||
```text
|
||||
ПЛОХО : * [Очень хорошая книга](https://example.org/book.html) - Джейн Роу - 1970
|
||||
ХОРОШО: * [Очень хорошая книга (1970)](https://example.org/book.html) - Джейн Роу
|
||||
```
|
||||
|
||||
- <a name="in_process"></a>Незавершенные книги:
|
||||
|
||||
```
|
||||
```text
|
||||
ХОРОШО: * [Скоро будет отличная книга](http://example.com/book2.html) - Джон Доу (HTML) (:construction: *in process*)
|
||||
```
|
||||
|
||||
@ -245,8 +247,8 @@
|
||||
- Для проверки URL используется [awesome_bot](https://github.com/dkhamsing/awesome_bot)
|
||||
- Чтобы запустить проверку URL, нажмите фиксацию, которая включает сообщение фиксации, содержащее `check_urls = ссылка_для_проверки`:
|
||||
|
||||
```
|
||||
check_urls=free-programming-books.md free-programming-books-en.md
|
||||
```properties
|
||||
check_urls=free-programming-books.md free-programming-books-ru.md
|
||||
```
|
||||
|
||||
- Вы можете указать более одного файла для проверки, используя один пробел для разделения каждой записи.
|
||||
|
||||
@ -83,6 +83,7 @@ Bằng cách đóng góp, bạn đồng ý tôn trọng [Quy Tắc Ứng Xử](h
|
||||
|
||||
Ví dụ:
|
||||
|
||||
```text
|
||||
[...]
|
||||
* [Một cuốn sách tuyệt vời](http://example.com/example.html)
|
||||
(dòng trống)
|
||||
@ -91,54 +92,55 @@ Ví dụ:
|
||||
(dòng trống)
|
||||
* [Một cuốn sách tuyệt vời khác](http://example.com/book.html)
|
||||
* [Một số sách khác](http://example.com/other.html)
|
||||
```
|
||||
|
||||
- Không đặt dấu cách giữa `]` 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
|
||||
```
|
||||
|
||||
- <a name="in_process"></a>Sách đang trong quá trình viết:
|
||||
|
||||
```
|
||||
Tốt: * [Sách sẽ sớm trở nên tuyệt vời](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*)
|
||||
```text
|
||||
TỐT: * [Sách sẽ sớm trở nên tuyệt vời](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*)
|
||||
```
|
||||
|
||||
|
||||
@ -238,8 +240,8 @@ Nếu bạn có thể in nó ra và giữ lại bản chất của nó, thì đ
|
||||
- Sử dụng xác thực liên kết [awesome_bot](https://github.com/dkhamsing/awesome_bot)
|
||||
- Để kích hoạt xác thực liên kết, hãy push một commit bao gồm một commit message chứa `check_urls=file_to_check`:
|
||||
|
||||
```
|
||||
check_urls=free-programming-books.md free-programming-books-en.md
|
||||
```properties
|
||||
check_urls=free-programming-books.md free-programming-books-vi.md
|
||||
```
|
||||
|
||||
- Bạn có thể chỉ định nhiều tệp để kiểm tra, sử dụng một khoảng trắng duy nhất để tách từng mục nhập.
|
||||
|
||||
@ -73,7 +73,7 @@
|
||||
|
||||
举例：
|
||||
|
||||
```
|
||||
```text
|
||||
[...]
|
||||
* [一本很有用的书](http://example.com/example.html)
|
||||
(空行)
|
||||
@ -86,42 +86,42 @@
|
||||
|
||||
* 在 `]` 和 `(` 之间不要留有空格：
|
||||
|
||||
```
|
||||
```text
|
||||
错误：* [一本很有用的书] (http://example.com/book.html)
|
||||
正确：* [一本很有用的书](http://example.com/book.html)
|
||||
```
|
||||
|
||||
* 如果包括作者，请使用' - '(由单个空格(英文半角)包围的破折号)：
|
||||
|
||||
```
|
||||
```text
|
||||
错误：* [一本很有用的书](http://example.com/book.html)- 张显宗
|
||||
正确：* [一本很有用的书](http://example.com/book.html) - 张显宗
|
||||
```
|
||||
|
||||
* 在链接和电子书格式之间放一个空格：
|
||||
|
||||
```
|
||||
```text
|
||||
错误：* [一本很有用的书](https://example.org/book.pdf)(PDF)
|
||||
正确：* [一本很有用的书](https://example.org/book.pdf) (PDF)
|
||||
```
|
||||
|
||||
* 如需备注或注解，请使用英文半角括号`( )`：
|
||||
|
||||
```
|
||||
```text
|
||||
错误：* [一本很有用的书](https://example.org/book.pdf) （繁体中文）
|
||||
正确：* [一本很有用的书](https://example.org/book.pdf) (繁体中文)
|
||||
```
|
||||
|
||||
* 作者在电子书格式之前：
|
||||
|
||||
```
|
||||
```text
|
||||
错误：* [一本很有用的书](https://example.org/book.pdf)- (PDF) 张显宗
|
||||
正确：* [一本很有用的书](https://example.org/book.pdf) - 张显宗 (PDF)
|
||||
```
|
||||
|
||||
* 多重格式：
|
||||
|
||||
```
|
||||
```text
|
||||
错误：* [一本很有用的书](http://example.com/)- 张显宗 (HTML)
|
||||
错误：* [一本很有用的书](https://downloads.example.org/book.html)- 张显宗 (download site)
|
||||
正确：* [一本很有用的书](http://example.com/) - 张显宗 (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html)
|
||||
@ -129,7 +129,7 @@
|
||||
|
||||
* 多作者，多译者时，请使用中文 `、` 进行分隔，在译者名字后请使用英文半角括号包围的 `(翻译)`，可以用 “等” 缩短作者列表：
|
||||
|
||||
```
|
||||
```text
|
||||
错误：* [一本很有用的书](https://example.org/book.pdf) - 张显宗，岳绮罗
|
||||
正确：* [一本很有用的书](https://example.org/book.pdf) - 张显宗、岳绮罗(翻译)
|
||||
正确：* [一本很有用的书](https://example.org/book.pdf) - 张显宗、岳绮罗、顾玄武、出尘子 等
|
||||
@ -137,14 +137,14 @@
|
||||
|
||||
* 在旧书的标题中包括出版年份：
|
||||
|
||||
```
|
||||
```text
|
||||
错误：* [一本很有用的书](https://example.org/book.html) - 张显宗 - 1970
|
||||
正确：* [一本很有用的书 (1970)](https://example.org/book.html) - 张显宗
|
||||
```
|
||||
|
||||
* <a name="in_process"></a>编写(翻译)中的书籍：
|
||||
|
||||
```
|
||||
```text
|
||||
正确：* [马上出版的一本书](http://example.com/book2.html) - 张显宗 (HTML) (:construction: *编写中*)
|
||||
正确：* [马上出版的一本书](http://example.com/book2.html) - 张显宗 (HTML) (:construction: *翻译中*)
|
||||
```
|
||||
|
||||
@ -73,7 +73,7 @@
|
||||
|
||||
舉例：
|
||||
|
||||
```
|
||||
```text
|
||||
[...]
|
||||
* [一本很有用的書](http://example.com/example.html)
|
||||
(空行)
|
||||
@ -86,42 +86,42 @@
|
||||
|
||||
* 在 `]` 和 `(` 之間不要留有空格：
|
||||
|
||||
```
|
||||
```text
|
||||
錯誤：* [一本很有用的書] (http://example.com/book.html)
|
||||
正確：* [一本很有用的書](http://example.com/book.html)
|
||||
```
|
||||
|
||||
* 如果包括作者，請使用' - '(由單個空格(英文半型)包圍的破折號)：
|
||||
|
||||
```
|
||||
```text
|
||||
錯誤：* [一本很有用的書](http://example.com/book.html)- 張顯宗
|
||||
正確：* [一本很有用的書](http://example.com/book.html) - 張顯宗
|
||||
```
|
||||
|
||||
* 在連結和電子書格式之間放一個空格：
|
||||
|
||||
```
|
||||
```text
|
||||
錯誤：* [一本很有用的書](https://example.org/book.pdf)(PDF)
|
||||
正確：* [一本很有用的書](https://example.org/book.pdf) (PDF)
|
||||
```
|
||||
|
||||
* 如需備注或注解，請使用英文半型括號`( )`：
|
||||
|
||||
```
|
||||
```text
|
||||
錯誤：* [一本很有用的書](https://example.org/book.pdf) （繁體中文）
|
||||
正確：* [一本很有用的書](https://example.org/book.pdf) (繁體中文)
|
||||
```
|
||||
|
||||
* 作者在電子書格式之前：
|
||||
|
||||
```
|
||||
```text
|
||||
錯誤：* [一本很有用的書](https://example.org/book.pdf)- (PDF) 張顯宗
|
||||
正確：* [一本很有用的書](https://example.org/book.pdf) - 張顯宗 (PDF)
|
||||
```
|
||||
|
||||
* 多重格式：
|
||||
|
||||
```
|
||||
```text
|
||||
錯誤：* [一本很有用的書](http://example.com/)- 張顯宗 (HTML)
|
||||
錯誤：* [一本很有用的書](https://downloads.example.org/book.html)- 張顯宗 (download site)
|
||||
正確：* [一本很有用的書](http://example.com/) - 張顯宗 (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html)
|
||||
@ -129,7 +129,7 @@
|
||||
|
||||
* 多作者，多譯者時，請使用中文 `、` 進行分隔，在譯者名字後請使用英文半型括號包圍的 `(翻譯)`，可以用 “等” 縮短作者列表：
|
||||
|
||||
```
|
||||
```text
|
||||
錯誤：* [一本很有用的書](https://example.org/book.pdf) - 張顯宗，岳綺羅
|
||||
正確：* [一本很有用的書](https://example.org/book.pdf) - 張顯宗、岳綺羅(翻譯)
|
||||
正確：* [一本很有用的書](https://example.org/book.pdf) - 張顯宗、岳綺羅、顧玄武、出塵子 等
|
||||
@ -137,14 +137,14 @@
|
||||
|
||||
* 在舊書的標題中包括出版年份：
|
||||
|
||||
```
|
||||
```text
|
||||
錯誤：* [一本很有用的書](https://example.org/book.html) - 張顯宗 - 1970
|
||||
正確：* [一本很有用的書 (1970)](https://example.org/book.html) - 張顯宗
|
||||
```
|
||||
|
||||
* <a name="in_process"></a>編寫(翻譯)中的書籍：
|
||||
|
||||
```
|
||||
```text
|
||||
正確：* [即將出版的一本書](http://example.com/book2.html) - 張顯宗 (HTML) (:construction: *編寫中*)
|
||||
正確：* [即將出版的一本書](http://example.com/book2.html) - 張顯宗 (HTML) (:construction: *翻譯中*)
|
||||
```
|
||||
@ -156,8 +156,8 @@
|
||||
- 使用 [awesome_bot](https://github.com/dkhamsing/awesome_bot) 進行連結驗證。
|
||||
- 可以藉由提交一個內容包含`check_urls=file_to_check`來觸發連結驗證:
|
||||
|
||||
```
|
||||
check_urls=free-programming-books.md free-programming-books-en.md
|
||||
```properties
|
||||
check_urls=free-programming-books.md free-programming-books-zh.md
|
||||
```
|
||||
|
||||
- 您可以以一個空白區隔出想要進行驗證的檔案名稱來一次驗證多個檔案。
|
||||
|
||||
@ -74,6 +74,7 @@ The idea is to have:
|
||||
|
||||
Example:
|
||||
|
||||
```text
|
||||
[...]
|
||||
* [An Awesome Book](http://example.com/example.html)
|
||||
(blank line)
|
||||
@ -82,38 +83,39 @@ Example:
|
||||
(blank line)
|
||||
* [Another Awesome Book](http://example.com/book.html)
|
||||
* [Some Other Book](http://example.com/other.html)
|
||||
```
|
||||
|
||||
- Don't put spaces between `]` and `(`:
|
||||
|
||||
```
|
||||
```text
|
||||
BAD : * [Another Awesome Book] (http://example.com/book.html)
|
||||
GOOD: * [Another Awesome Book](http://example.com/book.html)
|
||||
```
|
||||
|
||||
- If you include the author, use ` - ` (a dash surrounded by single spaces):
|
||||
|
||||
```
|
||||
```text
|
||||
BAD : * [Another Awesome Book](http://example.com/book.html)- John Doe
|
||||
GOOD: * [Another Awesome Book](http://example.com/book.html) - John Doe
|
||||
```
|
||||
|
||||
- Put a single space between the link and its format:
|
||||
|
||||
```
|
||||
```text
|
||||
BAD : * [A Very Awesome Book](https://example.org/book.pdf)(PDF)
|
||||
GOOD: * [A Very Awesome Book](https://example.org/book.pdf) (PDF)
|
||||
```
|
||||
|
||||
- Author comes before format:
|
||||
|
||||
```
|
||||
```text
|
||||
BAD : * [A Very Awesome Book](https://example.org/book.pdf)- (PDF) Jane Roe
|
||||
GOOD: * [A Very Awesome Book](https://example.org/book.pdf) - Jane Roe (PDF)
|
||||
```
|
||||
|
||||
- Multiple formats:
|
||||
|
||||
```
|
||||
```text
|
||||
BAD : * [Another Awesome Book](http://example.com/)- John Doe (HTML)
|
||||
BAD : * [Another Awesome Book](https://downloads.example.org/book.html)- John Doe (download site)
|
||||
GOOD: * [Another Awesome Book](http://example.com/) - John Doe (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html)
|
||||
@ -121,20 +123,20 @@ GOOD: * [Another Awesome Book](http://example.com/) - John Doe (HTML) [(PDF, EPU
|
||||
|
||||
- Include publication year in title for older books:
|
||||
|
||||
```
|
||||
```text
|
||||
BAD : * [A Very Awesome Book](https://example.org/book.html) - Jane Roe - 1970
|
||||
GOOD: * [A Very Awesome Book (1970)](https://example.org/book.html) - Jane Roe
|
||||
```
|
||||
|
||||
- <a name="in_process"></a>In-process books:
|
||||
|
||||
```
|
||||
```text
|
||||
GOOD: * [Will Be An Awesome Book Soon](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*)
|
||||
```
|
||||
|
||||
- <a name="archived"></a>Archived link:
|
||||
|
||||
```
|
||||
```text
|
||||
GOOD: * [A Way-backed Interesting Book](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: archived)*
|
||||
```
|
||||
|
||||
@ -235,7 +237,7 @@ If you can print it out and retain its essence, it's not an Interactive Tutorial
|
||||
- URL validation uses [awesome_bot](https://github.com/dkhamsing/awesome_bot)
|
||||
- To trigger URL validation, push a commit that includes a commit message containing `check_urls=file_to_check`:
|
||||
|
||||
```
|
||||
```properties
|
||||
check_urls=free-programming-books.md free-programming-books-en.md
|
||||
```
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user