Bagaimana Saya Mengubah Konversi Github-Flavoured Menjadi PDF

Saya baru-baru ini mulai mempelajari penurunan harga untuk digunakan dengan dokumentasi, dan perlu mencetak beberapa halaman penurunan harga saya. Saya ingin menggunakan utilitas command-line, Terminal, dll. Yang memungkinkan saya untuk mengonversi Markdown dengan Github menjadi PDF. Perlu memiliki penyorotan sintaks yang tepat dan tidak harus terlihat mengerikan. Terima kasih atas bantuannya.

Saya telah berhasil menggunakan pegangan untuk menampilkan penurunan harga di Chrome dan kemudian menggunakan opsi "Simpan sebagai PDF" Chrome dalam dialog Print.

pip install grip  
grip your_markdown.md

grip akan membuat penurunan harga di localhost: 5000 - cukup sunting dan segarkan browser. Cetak saat siap.

Ini memberikan representasi yang lebih dapat diandalkan daripada pandoc dan lebih ringan daripada menginstal lateks (diperlukan oleh pandoc untuk pembuatan pdf).

Hasil cetak bukan baris perintah dalam jawaban ini, tetapi masih menemukan ini lebih mudah / lebih dapat diandalkan (tampak 100% seperti Github untuk dokumen yang panjang termasuk gambar yang relatif terkait dan penyorotan kode).

Anda juga dapat menggunakan markdown-pdf berbasis Node.js

npm install -g markdown-pdf
markdown-pdf /path/to/markdown

Lihatlah pandoc . Itu memang memiliki penyorotan sintaksis. Mungkin mengharuskan Anda membuat perubahan (kecil) pada dokumen Anda karena memiliki rasa penurunan harga sendiri dan saya tidak tahu seberapa dekat itu cocok dengan rasa GitHub.

Jika file penurunan harga di-host di repositori github, gitprint adalah pilihan yang menarik untuk membuat pdf / print.

Yang perlu Anda lakukan adalah mengganti github.comdengan gitprint.comdi URL. Berikut adalah contoh dari beranda gitprint.

Sayangnya, ini tidak bekerja pada inti penurunan harga, dan hanya bekerja dengan file penurunan harga di repositori.

Ada konverter online yang tersedia di http://www.markdowntopdf.com.
Ini menyediakan sintaks yang menyoroti di luar kotak dan merupakan solusi paling sederhana yang pernah saya lihat sejauh ini. Itu juga dengan benar menangani fitur-fitur lain khusus untuk GFM misalnya tabel.

Seperti yang saya nyatakan dalam komentar saya, Github menggunakan Linguist untuk memberikan penyorotan sintaksis. Di Github, Anda dapat menggunakan ini untuk menentukan penyorotan sintaks seperti:

```ruby
require 'redcarpet'
markdown = Redcarpet.new("Hello World!")
puts markdown.to_html
```

Sayangnya, tidak ada cara yang baik untuk mengonversi Markdown langsung ke file PDF dengan penyorotan sintaksis.

Alternatif:

Vim :

Jika Anda memiliki vim, Anda dapat dengan mudah mencapai penyorotan sintaks dengan menjalankan yang berikut dari terminal:

vim -c hardcopy -c quit /path/to/file.ps

Atau di dalam vim:

:hardcopy >/path/to/file.ps

Ini akan menghasilkan file PostScript yang dapat dikonversi ke pdf menggunakan, misalnya, ps2pdf:

ps2pdf /path/to/file.ps

Sorotan sumber :

Jika Anda ingin memilih rute HTML atau LaTeX, Anda dapat mencoba Sumber-highlight sebagai gantinya. Daftar semua bahasa yang didukung oleh Sumber-highlight dapat ditemukan di sini .

Beberapa contoh perintah Sumber-sorot meliputi:

source-highlight -s java -f html -i Hello.java -o Hello1.html
source-highlight -s java -f html --input Hello.java --output Hello2.html --doc
source-highlight -s java -f html -i Hello.java -o Hello3.html --title "Happy Java with java2html :-)" --tab 3

Menggunakan file input ini

Dan masing-masing mengeluarkan file HTML masing-masing:

Hello1.html
Hello2.html
Hello3.html

Contoh lebih lanjut dari penggunaan Sumber-sorotan dapat ditemukan di sini

Windows :

Vim , ps2pdf (disediakan oleh Ghostscript ) dan Source-highlight semuanya tersedia melalui Cygwin .

Bagi mereka yang menggunakan Linux, gunakan pandoc .

Pasang:

sudo apt install pandoc texlive-latex-extra

Ya, Anda perlu -extrapaket karena font.

Mengubah:

pandoc --from markdown -o output.pdf my-file.md

Baru-baru ini saya membuat layanan untuk mengonversi dokumen penurunan harga ke PDF. Ini mendukung penurunan rasa Github serta penyorotan sintaksis. Layanan ini terletak di: http://markdown2pdf.com

Solusi tambang: konversi markdown pandocmenjadi html (jangan lupa gunakan css untuk pandoc untuk menampilkan batas tabel) , lalu buka dengan libreoffice, pilih opsi export as pdf.

NB : tak satu pun dari yang disebutkan di sini dan di Internet solusi yang bekerja untuk saya: 1) solusi berbasis browser (yaitu pegangan) menambahkan info berlebih, seperti nomor halaman, yang saya tidak berhasil menghapus, 2) konversi pandoc ke pdf adalah rusak, bagi saya itu menghasilkan tabel kosong (mungkin karena unicode, dan ya, saya mengkonfigurasinya untuk menggunakan xetex) , 3) solusi berbasis situs (yaitu gitprint.com) juga menambahkan hal-hal yang berlebihan, seperti margin seperti github, sedangkan Saya hanya perlu tabel sederhana yang saya hasilkan dengan awk!

Saya telah mencoba beberapa plugin chrome dan konverter online.
MDtr2PDF adalah yang terbaik. Ini mendukung Github-flavored-markdown dan unicode.

Saya memperbaiki cuplikan ini untuk kebutuhan pribadi saya:

# sudo apt install grip wkhtmltopdf

MD=${1:-README.md}
PDF=${2:-"$MD".pdf}
PORT=8971
DELAY=10

printf "Converting $MD to $PDF on port $PORT\n"
printf "Waiting $DELAY seconds for server to start...\n"

grip "$MD" localhost:$PORT &
sleep $DELAY
wkhtmltopdf http://localhost:$PORT "$PDF"
kill $(ps -eo pid,command | grep grip | grep -v grep | awk '{print $1}')

Simpan sebagai /usr/local/bin/md2pdfdan sudo chmod +x /usr/local/bin/md2pdfsetelahnya.

Pemakaian:

• md2pdf mengonversi README.md ke README.md.pdf

• md2pdf foo.md mengkonversi foo.md ke foo.md.pdf

• md2pdf foo.md bar.pdf mengkonversi foo.md ke bar.pdf