Come Utilizzare pandoc per Convertire i File sulla Riga di Comando di Linux

0
31
Fatmawati Achmad Zaenuri/Shutterstock

È possibile utilizzare pandoc su Linux per la conversione tra più di 40 formati di file. È anche possibile utilizzarlo per creare un semplice docs-come-il sistema di codice da scrivere in Markdown, la memorizzazione in git, e la pubblicazione in una qualsiasi delle sue formati supportati.

La Conversione di documenti e Documenti-come-Codice

Se si dispone di un documento in uno dei pandoc molti formati di file, la conversione di quasi tutti gli altri è un gioco da ragazzi. Questo è un utile strumento per avere.

Ma la vera forza di pandoc diventa evidente quando lo si utilizza come base di una semplice docs-come-il sistema del codice. La premessa di documenti-come-il codice è quello di adottare alcuni principi e tecniche di sviluppo software e di applicarli alla scrittura di documentazione, in particolare per progetti di sviluppo software. È possibile applicare per lo sviluppo di qualsiasi tipo di documentazione, però.

Gli sviluppatori di Software utilizzano il loro editor preferito o ambiente di sviluppo integrato (IDE) per scrivere i loro programmi. Il codice che tipo è salvato in un file di testo. Questi contengono il codice sorgente del programma.

Essi utilizzano un sistema di controllo di versione, o VCS (Git è il più popolare), per acquisire le modifiche al codice sorgente, come è sviluppata e migliorata. Questo significa che il programmatore ha una storia completa di tutte le versioni del file di codice sorgente. Lui o lei può accedere rapidamente a qualsiasi versione precedente di un file. Git memorizza i file in un archivio. C’è un repository locale sul computer di ogni sviluppatore e un centrale, condiviso, repository remoto che spesso cloud-hosted.

Quando sono pronti per produrre una versione funzionante del programma, è possibile utilizzare un compilatore per leggere il codice sorgente e generare un eseguibile binario.

Scrivendo i vostri documenti in un design leggero, il testo-base di markup language, è possibile utilizzare un VCS per il controllo di versione della tua scrittura. Quando sei pronto a distribuire o pubblicare un documento, è possibile utilizzare pandoc per generare differenti versioni della documentazione di cui avete bisogno, tra cui web-based (HTML), la parola di trattati o di impaginazione (LibreOffice, Microsoft Word, TeX), portable document format (PDF), e-book (ePub), e così via.

Si può fare tutto questo da un set di versione controllata, leggero e file di testo.

L’installazione di pandoc

Per installare pandoc su Ubuntu, utilizzare questo comando:

sudo apt-get install pandoc

Su Fedora, il comando è il seguente:

sudo dnf installare pandoc

Su Manjaro, è necessario digitare:

sudo pacman -Syu pandoc

È possibile controllare quale versione hai installato con l’opzione –versione:

pandoc –version

Utilizzando pandoc Senza File

Se si utilizza pandoc senza opzioni della riga di comando, si accetta anche digitato ingresso. Basta premere Ctrl+D per indicare di aver finito di digitare. pandoc si aspetta da voi che tipo di formato Markdown, e genera l’output HTML.

Vediamo un esempio:

pandoc

Abbiamo scritto un paio di righe di Markdown, e sono in procinto di premere Ctrl+D.

Come presto come noi, pandoc genera l’equivalente di output HTML.

Per fare qualcosa di utile con pandoc, però, abbiamo davvero bisogno di utilizzare dei file.

Markdown Nozioni Di Base

Markdown è un leggero linguaggio di markup, e di particolare significato è dato a certi personaggi. È possibile utilizzare un editor di testo per creare un file Markdown.

Markdown è possibile leggere facilmente, come non ci sono visivamente ingombrante tag per distrarre dal testo. La formattazione in Markdown documenti ricorda la formattazione che rappresenta. Qui di seguito sono alcuni dei principi fondamentali:

  • Per evidenziare il testo con il corsivo, avvolgetela con asterischi. *Questo è sottolineata*
  • Per il grassetto il testo, utilizzare i due asterischi. **Questo sarà in grassetto**
  • I titoli sono rappresentati dal numero segno/simbolo del cancelletto (#). Il testo è separato dall’hash da uno spazio. Usare un hash per un titolo di livello principale, due per il secondo livello, e così via.
  • Per creare un elenco puntato, iniziare ogni riga dell’elenco con un asterisco e inserire uno spazio prima del testo.
  • Per creare un elenco numerato, iniziare ogni riga con un numero seguito da un punto, e quindi inserire uno spazio prima del testo.
  • Per creare un collegamento ipertestuale, è necessario racchiudere il nome del sito in parentesi quadre ([]), e l’URL tra parentesi [()] in questo modo: [Link Come Geek](https://www.howtogeek.com/).
  • Per inserire un’immagine, digitare un punto esclamativo immediatamente prima parentesi (![]). Digitare qualsiasi testo alternativo per l’immagine in parentesi quadre. Quindi, è necessario racchiudere il percorso dell’immagine in parentesi [()“]. Ecco un esempio: ![Il giovane](HTG.png).

Parleremo esempi di tutti questi nella prossima sezione.

CORRELATI: che Cosa È Markdown e Come Si Utilizza?

Conversione Di File

Le conversioni di File è molto semplice. pandoc di solito può lavorare fuori formati di file che si sta lavorando con i loro nomi di file. Qui, stiamo andando a generare un file HTML da un file Markdown. -O (output) opzione dice pandoc il nome del file che si desidera creare:

pandoc -o sample.html esempio.md

Il nostro campione file Markdown, campione.md, contiene il breve tratto di Markdown, mostrato nell’immagine qui sotto.

Un file chiamato sample.html è stato creato. Quando si fa doppio clic sul file, il nostro browser predefinito per aprire l’applicazione.

Ora, cerchiamo di generare un Documento Aperto in Formato documento di testo, possiamo aprire con LibreOffice Writer:

pandoc -o campione.odt campione.md

I file ODT è lo stesso contenuto del file HTML.

Un pulito touch è il testo alternativo per l’immagine è utilizzato anche per generare automaticamente una didascalia per la figura.

Specificare I Formati Di File

-F (da) e -t (a) opzioni sono usate per dire pandoc formati di file che si desidera convertire da e per. Questo può essere utile se si sta lavorando con un formato di file che condivide l’estensione di un file di altri formati. Per esempio, TeX e LaTeX sia utilizzare l’ “.tex” estensione.

Stiamo anche usando l’opzione-s (autonomo) opzione in modo pandoc genera tutti gli Lattice preambolo necessario per un documento completo, autonomo e ben formato il documento LaTeX. Senza la-s (autonomo), l’opzione di uscita sarebbe ancora ben formato in Lattice, che potrebbe essere inserito in un altro documento LaTeX, non analizza correttamente come un autonomo documento LaTeX.

Digitiamo il seguente:

pandoc -f markdown -t latex-s-o campione.tex campione.md

Se si apre il “campione”.tex” file in un editor di testo, vedrai generato in Lattice. Se si dispone di un LaTeX editor, è possibile aprire il file TEX per visualizzare un’anteprima di come il Lattice composizione comandi vengono interpretati. Restringendo la finestra per inserire l’immagine sotto il fatto che il display look angusto, ma, in realtà, andava bene.

Abbiamo utilizzato un LaTeX editor chiamato Texmaker. Se si desidera installare in Ubuntu, digitare la seguente:

sudo apt-get install texmaker

In Fedora, il comando è:

sudo dnf installare texmaker

In Manjaro, utilizzare:

sudo pacman -Syu texmaker

Conversione di File con i Modelli

Probabilmente stai iniziando a capire la flessibilità che pandoc fornisce. Si può scrivere una sola volta e pubblicare in quasi qualsiasi formato. E ‘una grande impresa, ma i documenti non guardare un po’ di vaniglia.

Con i modelli, è possibile dettare stili pandoc utilizza quando genera i documenti. Per esempio, si può dire pandoc per utilizzare gli stili definiti in un foglio di Stile a Cascata (CSS) del file con l’ –css opzione.

Abbiamo creato un piccolo file CSS che contiene il testo riportato di seguito. Cambia la spaziatura sopra e sotto il livello di intestazione di uno stile. Cambia anche il colore del testo bianco, e il colore di sfondo di una tonalità di blu:

h1 {
color: #FFFFFF;
background-color: #3C33FF;
margin-top: 0px;
margin-bottom: 1px;
}

Il comando completo è al di sotto di notare che abbiamo usato anche l’opzione autonoma (-s):

pandoc -o sample.html -s –css di esempio.css di esempio.md

pandoc, utilizza l’unico stile dal nostro minimalista file CSS e lo applica al livello di una testata.

Un altro fine-tuning opzione disponibile quando si lavora con i file HTML è quello di includere i tag HTML nel tuo file Markdown. Questo sarà passato attraverso il codice HTML del file come standard di markup HTML.

Questa tecnica dovrebbe essere riservato per quando si sta solo generando output HTML, però. Se stai lavorando con più formati di file, pandoc ignora il markup HTML per file non HTML, e saranno passati a quelli come testo.

Siamo in grado di specificare gli stili che vengono utilizzati quando i file ODT sono generati, troppo. Aprire un vuoto documento di LibreOffice Writer e regolare la direzione e stili per soddisfare le vostre esigenze. Nel nostro esempio, abbiamo aggiunto anche una intestazione e piè di pagina. Salvare il documento come “odt-modello.odt.”

È possibile utilizzare questo come un modello con il-riferimento-doc opzione:

pandoc -o campione.odt –riferimento-doc=odt-modello.odt campione.md

Confronta questo con il ODT esempio precedente. Questo documento utilizza un tipo di carattere diverso, ha colorato le intestazioni, e include le intestazioni e i piè di pagina. Tuttavia, è stato generato dalla stessa esatta “del campione.md” file Markdown.

Documento di riferimento template può essere utilizzato per indicare le diverse fasi di un documento di produzione. Per esempio, si potrebbe avere i modelli di “Bozza” o “Revisione” filigrane. Un modello senza filigrana dovrebbe essere utilizzato per un documento finalizzato.

La Generazione Di File Pdf

Per impostazione predefinita, pandoc utilizza il Lattice PDF motore di generare file PDF. Il modo più semplice per assicurarsi che si sono appropriati di Lattice soddisfatte le dipendenze è quello di installare un LaTeX editor, come Texmaker.

Questa è una grande installazione, anche se—Tex e LaTeX sono entrambi abbastanza pesante. Se il vostro hard disk lo spazio è limitato, sai che non dovrete mai usare TeX o LaTeX, si potrebbe preferire di generare un file ODT. Quindi, è possibile aprirlo in LibreOffice Writer e salvarlo come PDF.

Docs-come-Codice

Ci sono molti vantaggi di utilizzare Markdown come lingua di scrittura, tra cui i seguenti:

  • Lavoro in un file di testo è veloce: Sono in grado di caricare più velocemente di dimensioni simili word processor file, e tendono a muoversi attraverso il documento più veloce, troppo. Molti editori, tra cui gedit , Vim e Emacs, utilizzare l’evidenziazione della sintassi con Markdown testo.
  • Avrete una linea temporale di tutte le versioni dei documenti: Se si memorizza la vostra documentazione in un VCS, come Git, si può facilmente vedere le differenze tra due versioni dello stesso file. Tuttavia, questo solo funziona davvero quando il file di testo normale, come un VCS si aspetta di lavorare con.
  • Un VCS può record che ha fatto tutte le modifiche e quando: Questo è particolarmente utile se vi capita spesso di collaborare con gli altri su progetti di grandi dimensioni. Inoltre, fornisce un repository centrale per i documenti stessi. Molti cloud-hosted Git servizi, come GitHub, GitLab, e BitBucket, hanno livelli in loro modelli di pricing.
  • È possibile generare i vostri documenti in più formati: Con solo un paio di semplici script di shell, si possono tirare in stili CSS e documenti di riferimento. Se si memorizzano i vostri documenti in un repository VCS che si integra con la Continuous Integration e Continuous Deployment (CI/CD) piattaforme, essi possono essere generati automaticamente ogni volta che il software è costruito.

CORRELATI: che Cosa È GitHub, e Per Cosa Viene Utilizzato?

Considerazioni Finali

Ci sono molte più opzioni e funzioni all’interno di pandoc di quello che abbiamo trattato qui. I processi di trasformazione per la maggior parte dei tipi di file possono essere modificati e perfezionati. Per saperne di più, controllare le eccellenti esempi sul sito ufficiale (ed estremamente dettagliato) pandoc pagina web.

CONTINUA A LEGGERE

  • “Come Utilizzare pandoc per Convertire i File sulla Riga di Comando di Linux
  • “Come risolvere un Rotto il Tasto della Tastiera su Windows 10 per PC
  • “Come Nascondere la Barra delle applicazioni in Windows 10
  • “Quello che Fa Apple T2 “Chip di Sicurezza” Fare nel Vostro Mac?
  • “Si può Davvero “Zoom e Migliorare” Filmati di Sicurezza?