🥇लिनक्स के लिए स्रोत कोड के साथ मार्कडाउन2पीडीएफ समाधान का उपयोग करने के लिए तैयार

प्रस्तावना

मार्कडाउन सरल इटैलिक और बोल्ड फ़ॉर्मेटिंग के साथ एक छोटा लेख और कभी-कभी काफी सारा टेक्स्ट लिखने का एक शानदार तरीका है। मार्कडाउन स्रोत कोड सहित लेख लिखने के लिए भी अच्छा है। लेकिन कभी-कभी आप निडरता से एक टैम्बोरिन के साथ नृत्य करना चाहते हैं ताकि इसे एक नियमित, अच्छी तरह से बनाई गई पीडीएफ फाइल में बदल दिया जा सके, और ताकि रूपांतरण के दौरान कोई समस्या न हो, उदाहरण के लिए, मेरे पास था - आप रूसी में नहीं लिख सकते स्रोत कोड की टिप्पणियाँ, बहुत लंबी लाइनें स्थानांतरित नहीं होती हैं, लेकिन कट और अन्य छोटी समस्याएं होती हैं। निर्देश आपको कनवर्टर को शीघ्रता से स्थापित करने की अनुमति देगा md2pdf वास्तव में यह समझे बिना कि यह कैसे काम करता है। अधिक या कम स्वचालित स्थापना के लिए स्क्रिप्ट उपयुक्त अनुभाग में नीचे है।

रूपांतरण के लिए मेरा नमूना TeX टेम्पलेट PSCyr फ़ॉन्ट पैकेज का उपयोग करता है, जिसमें Microsoft फ़ॉन्ट के लिए समर्थन शामिल है टाइम्स न्यू रोमन. GOST के अनुसार डिप्लोमा के लिए ऐसी आवश्यकताएँ थीं। यदि आप जानते हैं कि कैसे, तो आप अपनी आवश्यकताओं के अनुरूप टेम्पलेट को संशोधित कर सकते हैं। मेरे अपने निर्देशों में, आपको सबसे पहले टेक्सलाइव में PSCyr सेटिंग के साथ खिलवाड़ करना होगा। सेटअप लिनक्स मिंट मेट वितरण में किया गया है, अन्य वितरणों के लिए आपको अपने सिस्टम के लिए मानक टेक्सलाइव पैकेज फ़ोल्डर्स को गूगल करना पड़ सकता है।

टेक्सलाइव स्थापित करना

बेशक, आप इस पैकेज के केवल आवश्यक हिस्से ही स्थापित कर सकते हैं। लेकिन व्यक्तिगत रूप से, मैं न्यूनतम आवश्यक कार्यशील स्थापना की तलाश में बहुत आलसी था। यह सुनिश्चित करने के लिए कि सब कुछ काम करता है, संपूर्ण टेक्सलाइव पैकेज स्थापित करें। यह कहा जाता है texlive-full और इसका वजन 2 गीगाबाइट से थोड़ा अधिक है, इस तथ्य को ध्यान में रखें। हम आदेश निष्पादित करते हैं:

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

पर्याप्त रूप से लंबी स्थापना के बाद, आप अगले आइटम पर आगे बढ़ सकते हैं।

पांडोक कनवर्टर स्थापित करना

पांडोक एक लिनक्स पैकेज है जो आपको कुछ टेक्स्ट प्रारूपों को अन्य में बदलने की अनुमति देता है। इसमें बहुत सारी दिलचस्प विशेषताएं हैं जिन्हें आप इंटरनेट पर स्वयं पा सकते हैं। हम केवल मार्कडाउन फ़ाइल को पीडीएफ में परिवर्तित करने की संभावना में रुचि रखते हैं। जांचें कि क्या पंडोक स्थापित है और यदि नहीं, तो इसे स्थापित करें। उदाहरण के लिए इस प्रकार:

user@hostname:~$ dpkg -s pandoc

यदि आउटपुट कहता है कि यह स्थापित नहीं है, तो इंस्टॉल करें:

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

TexLive के लिए PSCyr पैकेज स्थापित करना

सबसे पहले आपको PSCyr डाउनलोड करना होगा। फिलहाल यह अभी भी यहीं उपलब्ध है लिंक, यदि लेख पढ़ने के समय यह किसी कारण से उपलब्ध नहीं है, तो निराश न हों, Google में "इंस्टॉलिंग PsCyr texlive" जैसा कुछ टाइप करके इंस्टॉलेशन निर्देशों के साथ इसे ढूंढना आसान है। यदि यह उपलब्ध है, तो आपके लिए इसे डाउनलोड करना आसान है और हम मान लेंगे कि आपने संग्रह को अपने होम फ़ोल्डर में अनपैक कर दिया है और इस प्रकार संग्रह में मौजूद फ़ोल्डर का पथ इस तरह दिखता है ~/पीएससीआईआर. फिर टर्मिनल पर जाएं और निम्नलिखित कमांड को क्रम से निष्पादित करें:

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/स्थानीय/शेयर/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 पर खोजना काफी आसान है। फिर आपकी जरूरत. यदि यह बिल्कुल स्पष्ट नहीं है, तो टिप्पणियों में लिखें, मैं 4 साल पहले की अपनी सेटिंग्स में जाने की कोशिश करूंगा और वर्णन करूंगा कि टेम्पलेट की कौन सी पंक्ति किसके लिए जिम्मेदार है। इस बीच, मैं लिखूंगा कि मैंने इसे अपने पीसी पर कैसे किया, और आप इसे अपने लिए दोहराने या संशोधित करने के लिए स्वतंत्र हैं।

एक फ़ाइल बनाएँ टेम्पलेट.tex कैटलॉग में /usr/शेयर/टेक्सलाइव/:

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 और एक स्क्रिप्ट लिखें जो मकरडाउन फ़ाइल को पीडीएफ में परिवर्तित कर देगी, उसी फ़ोल्डर में .pdf उपसर्ग के साथ मार्कडाउन फ़ाइल नामक एक फ़ाइल बनाएगी, यानी रूपांतरण के बाद फ़ाइलनाम.md फ़ोल्डर में दिखाई देगा. फ़ाइलनाम.md.pdf. आइए स्क्रिप्ट को कॉल करें md2pdf और रास्ते पर डाल दिया / Usr / bin. आइए आदेशों को क्रम से निष्पादित करें:

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. मार्कडाउन का GitHub संस्करण मूल मार्कडाउन के साथ पीछे की ओर संगत है, इसलिए यदि आपका टेक्स्ट इसमें लिखा गया है, तो आपको चिंता करने की ज़रूरत नहीं है। यदि आपकी एमडी फ़ाइल एक विशिष्ट मार्कडाउन बोली में लिखी गई है, तो पांडोक मैनुअल पढ़ें (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.

निष्कर्ष

वर्णित विधि के आधार पर, आप किसी भी शैली की पीडीएफ फाइलें बना सकते हैं, आप एमडी के बजाय पांडोक द्वारा समर्थित किसी भी अन्य प्रारूप को भी परिवर्तित कर सकते हैं। मैं यह आशा करने का साहस करता हूं कि एक दिन यह निर्देश साढ़े तीन लोगों के लिए उपयोगी होगा।

स्रोत: www.habr.com

लिनक्स के लिए स्रोत कोड के साथ रेडी-मेड मार्कडाउन2पीडीएफ समाधान