GitBook è uno strumento da riga di comando basato su Node.js che supporta i formati sintattici Markdown e AsciiDoc, e può generare eBook in HTML, PDF, eBook e altri formati.
Installa node.js
Prima di usare lo strumento gitbook, il computer deve installare node.js ambiente e, dopo l'installazione, puoi controllare il comando versione per verificare se l'installazione ha successo:
Installa Gitbook
Gitbook è installato con npm, riga di comando:
Esegui il comando qui sotto per vedere la versione GitBook e verificare che l'installazione sia stata buona.
Installa le versioni storiche
gitbook-cli rende facile scaricare e installare altre versioni di GitBook per testare i tuoi libri:
Usando gitbook ls-remote, si enumerano le versioni che possono essere scaricate.
Editor Markdown
Qui usiamo la sintassi Markdown come linguaggio di scrittura per i nostri documenti, dobbiamo preparare un editor Markdown, possiamo trovare molti editor Markdown sul mercato, come Typora, MacDown, Bear, MarkdownPad, MarkdownX, l'IDE di JetBrains (richiede l'installazione di plugin), Atom, Jianshu, CSDN e quello di GitBook GitBook Editor e così via.
Ho gli strumenti di sviluppo di codice VS installati sul mio computer, VS Code supporta markdown di default, devo solo installare un artefatto plugin di anteprima: Markdown Preview Enhanced, e lo userò!
Consigliato da amici Editor battora, indirizzo:Il login del link ipertestuale è visibile.
Inizializzare un libro
GitBook può impostare un boilerplate:
Se desideri creare un libro in una nuova directory, puoi farlo eseguendo gitbook init ./directory.
Dopo l'esecuzione, vedrai altri due file - README.md e SUMMARY.md, che fanno quanto segue:
README.md - L'introduzione del libro è scritta in questo documento
SUMMARY.md - La struttura del catalogo del libro è configurata qui
Non conosco la sintassi markdown, quindi scrivi solo qualche frase!
Genera pagine web statiche
Genera pagine web statiche ed esegue server
Tutto ciò sopra sarà generato nel catalogo di libri _book.
Il comando serve può anche specificare la porta:
Quando generi, specifica la versione di gitbook e non verrà scaricato localmente per primo
Elenca tutte le versioni locali di gitbook
Elenca le versioni di gitbook disponibili da remoto
Installa la versione corrispondente su gitbook
Aggiornamento all'ultima versione di gitbook
Disinstalla la versione corrispondente di Gitbook
Specifica il livello di logaritmo.
Messaggio di errore in uscita
Sommario
GitBook utilizza SUMMARY.md file per definire la struttura dei capitoli e dei sottocapitoli del libro. SUMMARY.md file viene utilizzato per generare l'indice del libro.
Il formato di SUMMARY.md è un elenco di link. Il titolo del link fungerà da titolo del capitolo, e il link sarà indirizzato al percorso verso quel file del capitolo.
Aggiungere una lista annidata al capitolo genitore crea un capitolo figlio.
Esempio semplice:
Poi torniamo alla riga di comando ed eseguiamo di nuovo il comando init di gitbook nella cartella mybook. GitBook cerca directory e file descritti in SUMMARY.md file,Se no, viene creato。
Output file PDF, ePub o mobi
Se vuoi generare una versione pdf, puoi eseguire gitbook pdf, allo stesso modo, se esporti formato epub, gitbook epub, se è formato mobi, gitbook mobi va bene.
Se vuoi esportare un e-book in formato PDF, ePub o mobi,Richiede il lettore/gestore di eBook Calibre e strumenti da riga di comando, altrimenti può essere segnalato un errore "EbookError: Errore durante la generazione dell'ebook: 'ebook-convert'".
Caratteristiche dei file speciali di GitBook:
file | descrizione | | book.json | Dati di configurazione (opzionali) | | README.md | Prefazione o introduzione all'eBook (obbligatorio) | | SUMMARY.md | Catalogo e-book (opzionale) | | GLOSSARY.md | Elenco di termini di vocabolario/annotazione (opzionale) |
Impostazioni generali di Gitbook
GitBook ti permette di personalizzare il tuo ebook con configurazioni flessibili.
Queste opzioni sono specificate nel file book.json. Per gli autori che non conoscono la sintassi JSON, puoi verificare la sintassi usando strumenti come JSONlint.
variabile | descrizione | | radice | Il percorso verso la cartella radice che contiene tutti i file dei libri, tranne book.json | | Struttura | Specifica i percorsi per readme, abstract, glossari, ecc | | Titolo | Il titolo del tuo libro, il valore predefinito viene estratto dal README. A GitBook.com, questo campo è pre-popolato. | | descrip{filter}tion | La descrizione del tuo libro, il valore predefinito, è estratta dal README. A GitBook.com, questo campo è pre-popolato. | | Autore | Nome dell'autore. A GitBook.com, questo campo è pre-popolato. | | ISBN | ISBN | | Lingua | Il tipo di linguaggio di questo libro è il codice ISO. Il valore predefinito è en | | Regia | Ordine di lettura del testo. Può essere RTL (da destra a sinistra) o LTR (da sinistra a destra), e il valore predefinito dipende dal valore del linguaggio. | | gitbook | Dovrebbe essere utilizzata la versione GitBook. Usa la specifica SemVer e accetta condizioni simili a "> = 3.0.0". |
|
Pubblicato su 23/11/2018 14:03:54
|
|
|
|
