მზა markdown2pdf გადაწყვეტა წყაროს კოდით Linux-ისთვის

წინასიტყვაობა

Markdown შესანიშნავი გზაა მოკლე სტატიის დასაწერად და ზოგჯერ საკმაოდ ბევრი ტექსტისთვის, მარტივი დახრილი და თამამი ფორმატირებით. Markdown ასევე კარგია სტატიების დასაწერად წყაროს კოდით. მაგრამ ხანდახან გინდა უსაშველოდ იცეკვო ტამბურით, რომ გადალახო ის ჩვეულებრივ, კარგად ჩამოყალიბებულ PDF ფაილში და ისე, რომ კონვერტაციის დროს პრობლემები არ შეგექმნას, რაც, მაგალითად, მე მქონდა - რუსულად ვერ დაწერ კოდის კომენტარები, ძალიან გრძელი ხაზები არ არის გადაცემული, მაგრამ ამოჭრილია და სხვა მცირე პრობლემები. ინსტრუქცია საშუალებას მოგცემთ სწრაფად დააყენოთ კონვერტორი md2pdf იმის გაგების გარეშე, თუ როგორ მუშაობს იგი. მეტ-ნაკლებად ავტომატური ინსტალაციის სკრიპტი მოცემულია ქვემოთ შესაბამის განყოფილებაში.

ჩემი ნიმუში TeX შაბლონი კონვერტაციისთვის იყენებს PSCyr შრიფტის პაკეტს, რომელიც მოიცავს Microsoft-ის შრიფტების მხარდაჭერას, კერძოდ Times New Roman. ასეთი მოთხოვნები არსებობდა დიპლომისთვის GOST-ის მიხედვით. თუ იცით როგორ, შეგიძლიათ შეცვალოთ შაბლონი თქვენს საჭიროებებზე. ჩემივე ინსტრუქციებით, თქვენ ჯერ მოგიწევთ მოტყუება PSCyr პარამეტრით TexLive-ში. დაყენება კეთდება Linux Mint Mate დისტრიბუციაში, სხვა დისტრიბუციებისთვის შეიძლება დაგჭირდეთ თქვენი სისტემის სტანდარტული TexLive პაკეტის საქაღალდეების მოძიება.

TexLive-ის ინსტალაცია

რა თქმა უნდა, ამ პაკეტის მხოლოდ საჭირო ნაწილების დაყენება შეგიძლიათ. მაგრამ პირადად მე გულწრფელად ძალიან ზარმაცი ვიყავი მინიმალური სამუშაო ინსტალაციის მოსაძებნად. იმისათვის, რომ დარწმუნდეთ, რომ ყველაფერი მუშაობს, დააინსტალირეთ მთელი TexLive პაკეტი. მას ეძახიან ტექსტლაივ-სრული და იწონის 2 გიგაბაიტზე ოდნავ მეტს, გაითვალისწინეთ ეს ფაქტი. ჩვენ ვასრულებთ ბრძანებას:

user@hostname:~$ sudo apt install texlive-full -y

საკმარისად ხანგრძლივი ინსტალაციის შემდეგ, შეგიძლიათ გადახვიდეთ შემდეგ პუნქტზე.

Pandoc Converter-ის ინსტალაცია

Pandoc არის Linux პაკეტი, რომელიც საშუალებას გაძლევთ გადაიყვანოთ ზოგიერთი ტექსტის ფორმატი სხვაზე. მას აქვს ბევრი საინტერესო ფუნქცია, რომელიც შეგიძლიათ იპოვოთ ინტერნეტში. ჩვენ მხოლოდ გვაინტერესებს მარკდაუნის ფაილის PDF-ში გადაყვანის შესაძლებლობა. შეამოწმეთ არის თუ არა დაინსტალირებული Pandoc და თუ არა, დააინსტალირეთ. მაგალითად ასე:

user@hostname:~$ dpkg -s pandoc

თუ გამომავალი ამბობს, რომ ის არ არის დაინსტალირებული, დააინსტალირეთ:

user@hostname:~$ sudo apt install pandoc -y

PSCyr პაკეტის ინსტალაცია TexLive-ისთვის

ჯერ უნდა ჩამოტვირთოთ PSCyr. ამ დროისთვის ის ჯერ კიდევ ხელმისაწვდომია ლინკები, თუ სტატიის წაკითხვის დროს ის რაიმე მიზეზით მიუწვდომელია, არ დაიდარდოთ, ადვილია მისი პოვნა ინსტალაციის ინსტრუქციებთან ერთად გუგლში მსგავსი რამის „ინსტალაცია PsCyr texlive“-ის აკრეფით. თუ ის ხელმისაწვდომია, მაშინ თქვენთვის უფრო ადვილია, ჩამოტვირთეთ და ჩვენ ვივარაუდებთ, რომ თქვენ ამოშალეთ არქივი თქვენს მთავარ საქაღალდეში და, შესაბამისად, არქივში შემავალი საქაღალდისკენ მიმავალი გზა ასე გამოიყურება ~/PSCyr. შემდეგ გადადით ტერმინალში და შეასრულეთ შემდეგი ბრძანებები თანმიმდევრობით:

user@hostname:~$ cd
user@hostname:~$ mkdir ./PSCyr/fonts/map ./PSCyr/fonts/enc
user@hostname:~$ cp ./PSCyr/dvips/pscyr/*.map ./PSCyr/fonts/map/
user@hostname:~$ cp ./PSCyr/dvips/pscyr/*.enc ./PSCyr/fonts/enc/
user@hostname:~$ echo "fadr6t AdvertisementPSCyr "T2AEncoding ReEncodeFont"" > ./PSCyr/fonts/map/pscyr.map

შემდეგი, გაარკვიეთ, სად მდებარეობს ადგილობრივი დირექტორია textmf. ჩვენ ვასრულებთ ბრძანებას:

user@hostname:~$ kpsewhich -expand-var='$TEXMFLOCAL'

დიდი ალბათობით თქვენ გაქვთ ეს დირექტორია - /usr/local/share/texmf/და შემდეგ ვაკეთებთ:

user@hostname:~$ sudo cp -R ./PSCyr/* /usr/local/share/texmf/

კარგად, ან თქვენ არ შეგიძლიათ შეწუხება და გაუშვით ბრძანება, რომელიც დააკოპირებს საქაღალდეში textmf სადაც არ უნდა იყოს ის:

user@hostname:~$ sudo cp -R ./PSCyr/* $(kpsewhich -expand-var='$TEXMFLOCAL')

დაინსტალირებულია PSCyr შრიფტები, დაუკავშირდით TexLive-ს:

user@hostname:~$ sudo texhash
user@hostname:~$ updmap --enable Map=pscyr.map
user@hostname:~$ sudo mktexlsr

LaTeX შაბლონი md2pdf კონვერტაციისთვის

მე არ აღვწერ ზუსტად როგორ არის კონფიგურირებული ეს შაბლონი და უბრალოდ მივცემ მას სპოილერის ქვეშ ბევრი ახსნა-განმარტების გარეშე. საკმარისია იმის თქმა, რომ ის კარგად არის კონფიგურირებული, ყოველ შემთხვევაში იმის მხრივ, თუ როგორ ამუშავებს ტექსტებს ბევრი წყარო კოდით. თუ არ ხართ კმაყოფილი ჩაღრმავების ზომით, სტრიქონების მანძილით, სექციებისა და ქვესექციების ნუმერაციის ნაკლებობით, მაშინ, ჩემი აზრით, საკმაოდ მარტივია ინტერნეტში კითხვის მოძიება "როგორ გავაკეთოთ ეს ლატექსში ..." და მაშინ თქვენი საჭიროება. თუ საერთოდ არ არის გასაგები, დაწერეთ კომენტარებში, ვეცდები ჩავუღრმავდე 4 წლის წინ საკუთარ პარამეტრებს და აღვწერო შაბლონის რომელი ხაზი რაზეა პასუხისმგებელი. ამასობაში მე დავწერ როგორ გავაკეთე ეს ჩემს კომპიუტერზე და თქვენ თავისუფლად შეგიძლიათ გაიმეოროთ ან შეცვალოთ იგი თქვენთვის.

შექმენით ფაილი თარგი.ტექს კატალოგში /usr/share/texlive/:

user@hostname:~$ sudo touch /usr/share/texlive/template.tex

მიეცით მას წაკითხვის უფლება:

user@hostname:~$ sudo chmod 444 /usr/share/texlive/template.tex

გახსენით ის ფესვის ქვეშ და ჩასვით მასში სპოილერის ქვეშ დამალული შიგთავსი:

user@hostname:~$ sudo nano /usr/share/texlive/template.tex

შაბლონის შინაარსი /usr/share/texlive/template.tex

documentclass[oneside,final,14pt]{extreport}
usepackage{extsizes}
usepackage{pscyr}
renewcommand{rmdefault}{ftm}
usepackage[T2A]{fontenc}
usepackage[utf8]{inputenc}
usepackage{amsmath}
usepackage{mathtext}
usepackage{multirow}
usepackage{listings}
usepackage{ucs}
usepackage{hhline}
usepackage{tabularx}
usepackage{booktabs}
usepackage{longtable}
usepackage{titlesec}
usepackage{hyperref}
usepackage{graphicx}
usepackage{setspace}
usepackage[center,it,labelsep=period]{caption}
usepackage[english,russian,ukrainian]{babel}
usepackage{vmargin}
newcommand{specialcell}[2][c]{%
    begin{tabular}[#1]{@{}c@{}}#2end{tabular}}
setpapersize{A4}
setmarginsrb {1cm}{1cm}{1cm}{1cm}{0pt}{0mm}{0pt}{13mm}
usepackage{indentfirst}
setlengthparindent{1cm}
renewcommand{baselinestretch}{1}
renewcommandthechapter{}
renewcommandthesection{}
renewcommandthesubsection{}
renewcommandthesubsubsection{}
titleformat
{chapter} % command
{bfseriesnormalsizecentering} % format
{thechapter} % label
{0.5ex} % sep
{
    centering
}
[
vspace{-1.5ex}
] % after-code
titleformat
{section}
[block]
{normalfontbfseries}
{thesection}{0.5em}{}
sloppy
letoldenumerateenumerate
renewcommand{enumerate}{
  oldenumerate
  setlength{itemsep}{1pt}
  setlength{parskip}{0pt}
  setlength{parsep}{0pt}
}
letolditemizeitemize
renewcommand{itemize}{
  olditemize
  setlength{itemsep}{1pt}
  setlength{parskip}{0pt}
  setlength{parsep}{0pt}
}
providecommand{tightlist}{%
  setlength{itemsep}{0pt}setlength{parskip}{0pt}}

titlespacing{subsubsection}{parindent}{3mm}{3mm}
titlespacing{subsection}{parindent}{3mm}{3mm}
usepackage{color}

lstset{
    basicstyle=footnotesizettfamily,
    inputencoding=utf8,
    extendedchars=true,
    showspaces=false,
    keepspaces=true
    showstringspaces=false,
    showtabs=false,
    tabsize=4,
    captionpos=b,
    breaklines=true,
    breakatwhitespace=true,
    breakautoindent=true,
    linewidth=textwidth
}

begin{document}
$if(title)$
maketitle
$endif$
$if(abstract)$
begin{abstract}
$abstract$
end{abstract}
$endif$

$for(include-before)$
$include-before$

$endfor$
$if(toc)$
{
$if(colorlinks)$
hypersetup{linkcolor=$if(toccolor)$$toccolor$$else$black$endif$}
$endif$
setcounter{tocdepth}{$toc-depth$}
tableofcontents
}
$endif$
$if(lot)$
listoftables
$endif$
$if(lof)$
listoffigures
$endif$
$body$

$if(natbib)$
$if(bibliography)$
$if(biblio-title)$
$if(book-class)$
renewcommandbibname{$biblio-title$}
$else$
renewcommandrefname{$biblio-title$}
$endif$
$endif$
bibliography{$for(bibliography)$$bibliography$$sep$,$endfor$}

$endif$
$endif$
$if(biblatex)$
printbibliography$if(biblio-title)$[title=$biblio-title$]$endif$

$endif$
$for(include-after)$
$include-after$

$endfor$
end{document}

ფაილის შენახვა /usr/share/texlive/template.tex და დაწერეთ სკრიპტი, რომელიც გადააქცევს Makrdown ფაილს PDF-ად, იმავე საქაღალდეში შექმნით ფაილს სახელწოდებით Markdown ფაილი პრეფიქსით .pdf, ანუ კონვერტაციის შემდეგ. ფაილის სახელი.md გამოჩნდება საქაღალდეში. ფაილის სახელი.md.pdf. მოდით დავურეკოთ სკრიპტს md2pdf და გზას დაადგა / usr / ბინ. მოდით შევასრულოთ ბრძანებები თანმიმდევრობით:

user@hostname:~$ cd
user@hostname:~$ touch md2pdf
user@hostname:~$ echo "#!/bin/bash" > md2pdf
user@hostname:~$ echo "pandoc --output=$1.pdf --from=markdown_github --latex-engine=pdflatex --listings --template=/usr/share/texlive/template.tex $1" >> md2pdf
user@hostname:~$ sudo cp md2pdf /usr/bin/
user@hostname:~$ sudo chmod 111 /usr/bin/md2pdf

მე-4 სტრიქონი რეალურად შეიცავს კონვერტაციის ბრძანებას. ყურადღება მიაქციე --from=markdown_github. Markdown-ის GitHub ვერსია უკუთავსებადია ორიგინალურ Markdown-თან, ასე რომ, თუ მასში თქვენი ტექსტია დაწერილი, არ უნდა ინერვიულოთ. თუ თქვენი MD ფაილი დაწერილია მარკდაუნის კონკრეტულ დიალექტზე, წაიკითხეთ პანდოკის სახელმძღვანელო (man pandoc), დარწმუნდით, რომ თქვენი განხორციელება მხარდაჭერილია მასში და შეასწორეთ /usr/bin/md2pdf თუ საჭიროა.

სკრიპტი მეტ-ნაკლებად ავტომატური ინსტალაციისთვის

თუ ნამდვილად არ გსურთ არაფრის კონფიგურაცია და გაქვთ Ubuntu-ს მსგავსი დისტრიბუცია, შეგიძლიათ სცადოთ შექმნათ სკრიპტი სპოილერის ქვეშ დამალული შიგთავსით და დიდი ალბათობით ყველაფერი თავისთავად დაინსტალირდება, ერთადერთი, დააკოპირეთ TeX შაბლონი განთავსებულია ზემოთ სპოილერის ქვეშ, სადაც საჭიროა. გახსენით ტერმინალი და გაუშვით:

user@hostname:~$ cd
user@hostname:~$ touch installmd2pdf.sh

შემდეგ შეავსეთ იგი შემდეგი შინაარსით:

$HOME/installmd2pdf.sh სკრიპტის შინაარსი

#!/bin/bash
cd /tmp
sudo apt install texlive-full pandoc -y
wget http://blog.harrix.org/wp-content/uploads/2013/02/PSCyr.zip
unzip -qq PSCyr.zip
cd
mkdir ./PSCyr/fonts/map ./PSCyr/fonts/enc
cp ./PSCyr/dvips/pscyr/*.map ./PSCyr/fonts/map/
cp ./PSCyr/dvips/pscyr/*.enc ./PSCyr/fonts/enc/
echo "fadr6t AdvertisementPSCyr "T2AEncoding ReEncodeFont"" > ./PSCyr/fonts/map/pscyr.map
sudo cp -R ./PSCyr/* $(kpsewhich -expand-var='$TEXMFLOCAL')
sudo texhash
updmap --enable Map=pscyr.map
sudo mktexlsr
sudo touch /usr/share/texlive/template.tex
touch md2pdf
echo "#!/bin/bash" > md2pdf
echo "pandoc --output=$1.pdf --from=markdown_github --latex-engine=pdflatex --listings --template=/usr/share/texlive/template.tex $1" >> md2pdf
sudo cp md2pdf /usr/bin/
sudo chmod 111 /usr/bin/md2pdf

გაუშვით ბრძანებით:

user@hostname:~$ sudo bash $HOME/installmd2pdf.sh

Არ დაგავიწყდეს ეს /usr/share/texlive/template.tex უნდა იყოს შევსებული, როგორც მითითებულია განყოფილებაში "LaTeX შაბლონი md2pdf კონვერტაციისთვის» შინაარსი.

md2pdf-ის გამოყენებით

უბრალოდ გახსენით საქაღალდე Markdown ფაილით (some_file.md) ტერმინალში და გაუშვით ბრძანება:

user@hostname:~$ md2pdf some_file.md

შედეგად, ფაილი გამოჩნდება საქაღალდეში some_file.md.pdf.

დასკვნა

აღწერილი მეთოდის საფუძველზე, თქვენ შეგიძლიათ შექმნათ ნებისმიერი სტილის PDF ფაილი, ასევე შეგიძლიათ სხვა ფორმატების გარდაქმნა md-ის ნაცვლად, ნებისმიერი მხარდაჭერილი Pandoc-ის მიერ. ვიმედოვნებ, რომ ერთ დღეს ეს ინსტრუქცია გამოადგება 3 და ნახევარ ადამიანს.

წყარო: www.habr.com