🥇 Linux साठी सोर्स कोडसह markdown2pdf सोल्यूशन तयार आहे

प्रस्तावना

मार्कडाउन हा एक छोटा लेख लिहिण्याचा एक उत्तम मार्ग आहे, आणि काहीवेळा बराच मोठा मजकूर, तिर्यक आणि जाड फॉन्टच्या स्वरूपात साध्या स्वरूपनासह. स्त्रोत कोड समाविष्ट करणारे लेख लिहिण्यासाठी मार्कडाउन देखील चांगले आहे. परंतु काहीवेळा तुम्हाला ते नियमित, सु-स्वरूपित पीडीएफ फाइलमध्ये न गमावता हस्तांतरित करायचे आहे, तंबोरीने नाचायचे आहे आणि जेणेकरून रूपांतरणादरम्यान कोणतीही अडचण येऊ नये, उदाहरणार्थ, मला होते - तुम्ही टिप्पण्यांमध्ये रशियनमध्ये लिहू शकत नाही. स्त्रोत कोडच्या, खूप लांब ओळी हस्तांतरित केल्या जात नाहीत आणि इतर किरकोळ समस्या कापल्या जातात. सूचना तुम्हाला कन्व्हर्टर त्वरीत सेट करण्याची परवानगी देतील md2pdf ते कसे कार्य करते याचा शोध न घेता. अधिक किंवा कमी स्वयंचलित स्थापनेसाठी स्क्रिप्ट संबंधित विभागात खाली आहे.

रूपांतरणासाठी माझे उदाहरण TeX टेम्पलेट PSCyr फॉन्ट पॅकेज वापरते, ज्यामध्ये मायक्रोसॉफ्ट फॉन्टसाठी समर्थन समाविष्ट आहे, म्हणजे टाइम्स न्यू रोमन. GOST नुसार डिप्लोमासाठी या आवश्यकता होत्या. तुम्हाला कसे माहित असल्यास, तुम्ही तुमच्या गरजेनुसार टेम्पलेट सुधारित करू शकता. माझ्या सूचनांनुसार, तुम्हाला प्रथम TexLive मध्ये PSCyr सेट करण्यासाठी टिंकर करावे लागेल. लिनक्स मिंट मेट वितरणामध्ये सेटअप केले जाते; इतर वितरणांसाठी, तुम्हाला तुमच्या सिस्टमसाठी मानक TexLive पॅकेज फोल्डर्स गुगल करावे लागतील.

TexLive स्थापित करत आहे

अर्थात, तुम्हाला आवश्यक असलेले पॅकेजचे फक्त भाग तुम्ही स्थापित करू शकता. परंतु वैयक्तिकरित्या, किमान आवश्यक कार्यरत इंस्टॉलेशन शोधण्यात मी स्पष्टपणे खूप आळशी होतो. सर्वकाही योग्यरित्या कार्य करते हे सुनिश्चित करण्यासाठी, आम्ही संपूर्ण TexLive पॅकेज स्थापित करतो. असे म्हणतात texlive-पूर्ण आणि त्याचे वजन 2 गीगाबाइट्सपेक्षा थोडे अधिक आहे, ही वस्तुस्थिती लक्षात ठेवा. आम्ही कमांड कार्यान्वित करतो:

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

प्रदीर्घ स्थापनेनंतर, आपण पुढील चरणावर जाऊ शकता.

Pandoc कनवर्टर स्थापित करत आहे

Pandoc एक लिनक्स पॅकेज आहे जे तुम्हाला काही मजकूर स्वरूप इतरांमध्ये रूपांतरित करण्याची परवानगी देते. यात अनेक मनोरंजक वैशिष्ट्ये आहेत जी आपण इंटरनेटवर स्वत: ला परिचित करू शकता. आम्हाला फक्त मार्कडाउन फाइल पीडीएफमध्ये रूपांतरित करण्याच्या शक्यतेमध्ये स्वारस्य आहे. Pandoc स्थापित आहे का ते तपासू आणि नसल्यास, ते स्थापित करू. उदाहरणार्थ यासारखे:

user@hostname:~$ dpkg -s pandoc

जर आउटपुट असे म्हणत असेल की ते स्थापित केलेले नाही, तर ते स्थापित करा:

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

TexLive साठी PSCyr पॅकेज स्थापित करत आहे

प्रथम आपण PSCyr डाउनलोड करणे आवश्यक आहे. सध्या तरी ते यावर उपलब्ध आहे दुवा, लेख वाचत असताना काही कारणास्तव तो उपलब्ध नसल्यास, निराश होऊ नका, Google मध्ये "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

पुढे आपण स्थानिक निर्देशिका कुठे आहे ते शोधू texmf. आम्ही कमांड कार्यान्वित करतो:

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

बहुधा तुमच्याकडे ही निर्देशिका असेल - /usr/local/share/texmf/, आणि मग आम्ही कार्यान्वित करतो:

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

बरं, किंवा तुम्ही त्रास देऊ शकत नाही आणि कमांड चालवू शकत नाही जी फोल्डरमध्ये कॉपी करेल texmf ती कुठेही असेल:

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

md2pdf रूपांतरणासाठी LaTeX टेम्पलेट

हे टेम्पलेट नेमके कसे कॉन्फिगर केले आहे याचे मी वर्णन करणार नाही आणि अधिक स्पष्टीकरणाशिवाय ते फक्त स्पॉयलर अंतर्गत सादर करेन. हे सांगणे पुरेसे आहे की ते चांगल्या प्रकारे कॉन्फिगर केले आहे, कमीतकमी ज्या प्रकारे ते भरपूर स्त्रोत कोडसह मजकूरांवर प्रक्रिया करते. जर तुम्ही इंडेंट्सचा आकार, रेषेतील अंतर, विभाग आणि उपविभागांची संख्या नसल्यामुळे समाधानी नसाल, तर माझ्या मते Google ला “Latex मध्ये कसे करायचे...” हा प्रश्न खूप सोपा आहे आणि मग तुमची गरज आहे. ते पूर्णपणे अस्पष्ट असल्यास, टिप्पण्यांमध्ये लिहा, मी 4 वर्षांपूर्वीच्या माझ्या स्वतःच्या सेटिंग्जमध्ये शोधण्याचा प्रयत्न करेन आणि टेम्पलेटची कोणती ओळ कशासाठी जबाबदार आहे याचे वर्णन करेन. यादरम्यान, मी माझ्या PC वर ते कसे केले याचे वर्णन करेन आणि तुम्ही स्वतःला अनुकूल करण्यासाठी ते पुनरावृत्ती किंवा सुधारण्यास मोकळे आहात.

एक फाइल तयार करा template.tex कॅटलॉगमध्ये /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 मध्ये रूपांतरित करेल, त्याच फोल्डरमध्ये .pdf उपसर्ग असलेली मार्कडाउन फाइल नावाची फाइल तयार करेल, म्हणजेच रूपांतरणानंतर. filename.md फोल्डरमध्ये दिसेल filename.md.pdf. चला स्क्रिप्टला कॉल करूया md2pdf आणि वाटेत ठेवा / यूएसआर / बिन. चला क्रमाने कमांड कार्यान्वित करू:

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

चौथ्या ओळीत प्रत्यक्षात रूपांतरण कमांड समाविष्ट आहे. कडे लक्ष देणे --from=markdown_github. मार्कडाउनची गिटहब आवृत्ती मूळ मार्कडाउनशी सुसंगत आहे, त्यामुळे जर तुमचा मजकूर त्यात लिहिलेला असेल तर तुम्हाला काळजी करण्याची गरज नाही. जर तुमची एमडी फाइल मार्कडाउनच्या विशिष्ट बोलीमध्ये लिहिली असेल, तर Pandoc मॅन्युअल वाचा (man pandoc), तुमची अंमलबजावणी द्वारे समर्थित असल्याची खात्री करा आणि चिमटा घ्या /usr/bin/md2pdf गरज असल्यास.

अधिक किंवा कमी स्वयंचलित स्थापनेसाठी स्क्रिप्ट

जर तुम्हाला खरोखर काहीही कॉन्फिगर करायचे नसेल आणि तुमच्याकडे उबंटूसारखे वितरण असेल, तर तुम्ही स्पॉयलरच्या खाली लपवलेल्या सामग्रीसह स्क्रिप्ट तयार करण्याचा प्रयत्न करू शकता आणि बहुधा सर्वकाही स्वतःच स्थापित होईल, फक्त 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 विभागात दर्शविल्याप्रमाणे भरणे आवश्यक आहे "md2pdf रूपांतरणासाठी LaTeX टेम्पलेट» सामग्री.

md2pdf वापरणे

फक्त मार्कडाउन फाइलसह फोल्डर उघडा (some_file.md) टर्मिनलमध्ये, आणि कमांड चालवा:

user@hostname:~$ md2pdf some_file.md

परिणामी, फोल्डरमध्ये एक फाइल दिसेल some_file.md.pdf.

निष्कर्ष

वर्णन केलेल्या पद्धतीवर आधारित, तुम्ही पीडीएफ फाइल्सची कोणतीही शैली तयार करू शकता; तुम्ही md ऐवजी Pandoc द्वारे समर्थित इतर फॉरमॅट्स देखील रूपांतरित करू शकता. एक दिवस ही सूचना साडेतीन लोकांना उपयोगी पडेल अशी आशा बाळगण्याचे धाडस मी करतो.

स्त्रोत: www.habr.com

लिनक्ससाठी सोर्स कोडसह रेडीमेड मार्कडाउन2पीडीएफ सोल्यूशन