Freely available programming books
View the Project on GitHub EbookFoundation/free-programming-books
Contribuendo tu accetti alla LICENZA di questa repository.
I collaboratori accettano di rispettare il Codice di Comportamento di questa repository. (translations)
“Un link per scaricare facilmente un libro” non è sempre un link per scaricare un libro gratuito. Per favore contribuisci solo con contenuti gratuiti. Assicurati che sia gratuito. Non accettiamo link a pagine che richiedono email funzionanti per ottenere il libro, ma diamo il benvenuto agli annunci che li richiedono.
Abbiamo 6 tipi di liste. Scegli quella giusta:
Assicurati di seguire le linee guida qui sotto e rispettare la formattazione Markdown dei file.
https
rispetto ad un http
– purché si trovino sullo stesso dominio e contengano lo stesso contenutohttp://example.com
invece di http://example.com/
http://example.com/dir/
è migliore di http://example.com/dir/index.html
http://example.com/dir/book/current/
è migliore di http://example.com/dir/book/v1.0.0/index.html
http
se possibile (perché accettare eccezione può essere complicato sui dispositivi mobile).http
ma la versione https
è ancora accessibile aggiungendo l’eccezione al browser o ignorando l’avviso.et al.
”.in process
”, come descritto qui sotto. Seleziona sempre l’ultima versione disponibile in questi siti.archived
”, come descritto qui sotto. La versione migliore da utilizzare è quella più recente/completa.(email address *requested*, not required)
..md
. Prova ad imparare la sintassi Markdown. È semplice!###
), e le sottosezioni utilizzano il livello 4 di heading (####
).L’idea è di avere:
2
linee vuote tra l’ultimo link e la nuova sezione.1
linea vuota tra il titolo e il primo link della sezione.0
linee vuote tra due link.1
linea vuota alla fine di ogni file .md
.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)
Non mettere uno spazio tra ]
e (
:
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
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)
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)
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)
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
CORRETTO : * [Will Be An Awesome Book Soon](http://example.com/book2.html) - John Doe (HTML) *(:construction: in process)*
CORRETTO : * [A Way-backed Interesting Book](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: archived)*
aa
viene prima di ab
.one two
viene prima di onetwo
Se vedi un link messo male, controlla gli errori dati dal linter per scoprire quali linee devi scambiare.
Mentre le basi sono relativamente semplici, c’è una notevole differenza tra le risorse che inseriamo nelle liste. Qui ci sono alcuni appunti su come affrontiamo queste diversità.
I nostri elenchi forniscono un set minimo di metadati: titoli, URLs, autori, piattaforme e note di accesso.
https
) sono preferibili al posto dei link non sicuri (http
), dove l’HTTPS è stato implementato.Per i lavori tradotti, l’autore originale dovrebbe essere incluso. Consigliamo di usare MARC relators per accreditare autori diversi dal creatore, per esempio:
* [Un libro tradotto](http://example.com/book-it.html) - John Doe, `trl.:` Mike The Translator
qui, l’annotazione trl.:
usa il codice MARC relativo ai “traduttori”.
,
per separare ogni elemento nella lista degli autoriet al.
” (e altri).Compiled from StackOverflow documentation
”.*(Leanpub account or valid email requested)*
.La prima regola è decidere a quale lista appartiene di più una risorsa. Se si definisce un libro, allora forse è un libro.
Essendo che internet è vasto, noi non accettiamo:
I nostri elenchi di programmi competitivi non sono così severi riguardo a queste esclusioni. L’ambito del repo è determinato dalla comunità; se desideri suggerire una modifica o un’aggiunta all’ambito, utilizza un problema per suggerire.
Non siamo così esigenti riguardo al libro. Ecco alcuni attributi che indicano che una risorsa è un libro:
Ci sono molti libri che abbiamo aggiunto che però non hanno questi attributi; dipende dal contesto.
A volte questi possono essere difficili da distinguere!
I corsi hanno spesso libri di testo associati, che elencheremo nei nostri elenchi di libri. I corsi prevedono lezioni, esercitazioni, test, appunti o altri supporti didattici. Una singola lezione o video di per sé non è un corso. Un powerpoint non è un corso.
Se riesci a stamparlo e conservarne l’essenza, non è un tutorial interattivo.
.github/workflows/fpb-lint.yml
)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-it.md
Se viene eseguito il linter RTL/LTR Markdown Linter (sui file *-ar.md
, *-he.md
, *-fa.md
, *-ur.md
) e si vedono errori o warning:
‏
immediatamente dopo ogni segmento LTR;‎
immediatamente dopo ogni simbolo LTR;SCORRETTO
<div dir="rtl" markdown="1">
* [كتاب الأمثلة في R](URL) - John Doe (PDF)
</div>
CORRETTO
<div dir="rtl" markdown="1">
* [كتاب الأمثلة في R‏](URL) - John Doe‏ (PDF)
</div>
SCORRETTO
<div dir="rtl" markdown="1">
* [Tech Podcast - بودكاست المثال](URL) – Ahmad Hasan, محمد علي
</div>
CORRETTO
<div dir="rtl" markdown="1">
* [Tech Podcast - بودكاست المثال](URL) – Ahmad Hasan,‏ محمد علي
</div>
SCORRETTO
<div dir="rtl" markdown="1">
* [أساسيات C#](URL)
</div>
CORRETTO
<div dir="rtl" markdown="1">
* [أساسيات C#‎](URL)
</div>