লিনাক্সের জন্য সোর্স কোড সহ রেডিমেড markdown2pdf সমাধান

ভূমিকা

মার্কডাউন হল একটি ছোট নিবন্ধ লেখার একটি দুর্দান্ত উপায়, এবং কখনও কখনও অনেকগুলি পাঠ্য, সহজ তির্যক এবং বোল্ড ফর্ম্যাটিং সহ। মার্কডাউন সোর্স কোড সহ নিবন্ধ লেখার জন্যও ভাল। কিন্তু কখনও কখনও আপনি হারিয়ে যেতে চান, একটি নিয়মিত, সুগঠিত পিডিএফ ফাইলে এটিকে ছাড়িয়ে যাওয়ার জন্য একটি খঞ্জনীর সাথে নাচতে চান এবং যাতে রূপান্তরের সময় কোনও সমস্যা না হয়, উদাহরণস্বরূপ, আমার ছিল - আপনি রাশিয়ান ভাষায় লিখতে পারবেন না সোর্স কোডের মন্তব্য, খুব দীর্ঘ লাইন স্থানান্তর করা হয় না, কিন্তু কাটা এবং অন্যান্য ছোটখাটো সমস্যা. নির্দেশ আপনাকে দ্রুত রূপান্তরকারী সেট আপ করার অনুমতি দেবে md2pdf এটা কিভাবে কাজ করে তা সত্যিই না বুঝে। একটি কম বা কম স্বয়ংক্রিয় ইনস্টলেশনের জন্য স্ক্রিপ্টটি উপযুক্ত বিভাগে নীচে রয়েছে৷

রূপান্তরের জন্য আমার নমুনা TeX টেমপ্লেট PSCyr ফন্ট প্যাকেজ ব্যবহার করে, যার মধ্যে মাইক্রোসফ্ট ফন্টগুলির জন্য সমর্থন রয়েছে, যথা টাইমস নিউ রোমান. GOST অনুযায়ী ডিপ্লোমার জন্য এই ধরনের প্রয়োজনীয়তা ছিল। আপনি যদি জানেন কিভাবে, আপনি আপনার প্রয়োজন অনুসারে টেমপ্লেট পরিবর্তন করতে পারেন. আমার নিজস্ব নির্দেশাবলীতে, আপনাকে প্রথমে টেক্সলাইভে PSCyr সেটিং দিয়ে বোকা বানাতে হবে। লিনাক্স মিন্ট মেট ডিস্ট্রিবিউশনে সেটআপ করা হয়, অন্যান্য ডিস্ট্রিবিউশনের জন্য আপনাকে আপনার সিস্টেমের জন্য স্ট্যান্ডার্ড টেক্সলাইভ প্যাকেজ ফোল্ডারগুলি গুগল করতে হতে পারে।

টেক্সলাইভ ইনস্টল করা হচ্ছে

অবশ্যই, আপনি এই প্যাকেজের শুধুমাত্র প্রয়োজনীয় অংশগুলি ইনস্টল করতে পারেন। কিন্তু ব্যক্তিগতভাবে, আমি ন্যূনতম প্রয়োজনীয় কাজের ইনস্টলেশনের জন্য খুব অলস ছিলাম। সবকিছু কাজ করে তা নিশ্চিত করতে, সম্পূর্ণ টেক্সলাইভ প্যাকেজ ইনস্টল করুন। এটা কে বলে টেক্সলাইভ-পূর্ণ এবং ওজন 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 টেক্সলাইভ ইনস্টল করা" এর মতো কিছু টাইপ করে ইনস্টলেশন নির্দেশাবলী সহ এটি খুঁজে পাওয়া সহজ। যদি এটি উপলব্ধ থাকে, তবে এটি আপনার জন্য সহজ, ডাউনলোড করুন এবং আমরা ধরে নেব যে আপনি আপনার হোম ফোল্ডারে সংরক্ষণাগারটি আনপ্যাক করেছেন এবং এইভাবে সংরক্ষণাগারে থাকা ফোল্ডারটির পথটি এমন দেখাচ্ছে ~/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 টেমপ্লেট

এই টেমপ্লেটটি কীভাবে কনফিগার করা হয়েছে তা আমি বর্ণনা করব না এবং খুব বেশি ব্যাখ্যা ছাড়াই এটিকে স্পয়লারের অধীনে দেব। এটি বলা যথেষ্ট যে এটি ভালভাবে কনফিগার করা হয়েছে, অন্ততপক্ষে এটি কীভাবে প্রচুর উত্স কোড সহ পাঠ্যগুলি পরিচালনা করে। আপনি যদি ইন্ডেন্টের আকার, লাইন ব্যবধান, বিভাগ এবং উপবিভাগের সংখ্যার অভাব নিয়ে সন্তুষ্ট না হন, তবে আমার মতে ইন্টারনেটে প্রশ্নটি গুগল করা বেশ সহজ "ল্যাটেক্সে এটি কীভাবে করবেন ..." এবং তারপর আপনার প্রয়োজন. যদি এটি একেবারেই পরিষ্কার না হয়, মন্তব্যগুলিতে লিখুন, আমি 4 বছর আগে আমার নিজস্ব সেটিংসে অনুসন্ধান করার চেষ্টা করব এবং টেমপ্লেটের কোন লাইনটি কীসের জন্য দায়ী তা বর্ণনা করব। ইতিমধ্যে, আমি আমার পিসিতে এটি কীভাবে করেছি তা লিখব এবং আপনি নিজের জন্য এটি পুনরাবৃত্তি বা সংশোধন করতে মুক্ত।

একটি ফাইল তৈরি করুন 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 এবং একটি স্ক্রিপ্ট লিখুন যা মাকরডাউন ফাইলটিকে পিডিএফ-এ রূপান্তর করবে, একই ফোল্ডারে একটি ফাইল তৈরি করবে যাকে মার্কডাউন ফাইল বলা হয় উপসর্গ .pdf সহ, অর্থাৎ রূপান্তরের পরে। filename.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

৪র্থ লাইনে আসলে কনভার্সন কমান্ড থাকে। মনোযোগ দিন --from=markdown_github. মার্কডাউনের গিটহাব সংস্করণটি আসল মার্কডাউনের সাথে পিছনের দিকে সামঞ্জস্যপূর্ণ, তাই যদি আপনার পাঠ্য এতে লেখা থাকে তবে আপনাকে চিন্তা করতে হবে না। যদি আপনার MD ফাইলটি একটি নির্দিষ্ট মার্কডাউন উপভাষায় লেখা হয়, তাহলে প্যানডক ম্যানুয়ালটি পড়ুন (man pandoc), নিশ্চিত করুন যে আপনার বাস্তবায়ন এটি দ্বারা সমর্থিত এবং টুইক করুন /usr/bin/md2pdf যদি প্রয়োজন হয় তাহলে.

কম বা কম স্বয়ংক্রিয় ইনস্টলেশনের জন্য স্ক্রিপ্ট

আপনি যদি সত্যিই কিছু কনফিগার করতে না চান, এবং আপনার কাছে একটি উবুন্টুর মতো বিতরণ থাকে, আপনি স্পয়লারের নীচে লুকানো বিষয়বস্তু দিয়ে একটি স্ক্রিপ্ট তৈরি করার চেষ্টা করতে পারেন এবং সম্ভবত সবকিছু নিজেই ইনস্টল হয়ে যাবে, একমাত্র জিনিস হল, অনুলিপি TeX টেমপ্লেটটি উপরে স্পয়লারের নীচে পোস্ট করা হয়েছে যেখানে আপনার নিজের প্রয়োজন। টার্মিনাল খুলুন এবং চালান:

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

তারপরে নিম্নলিখিত সামগ্রী দিয়ে এটি পূরণ করুন:

$HOME/instalmd2pdf.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 দ্বারা সমর্থিত। আমি সাহস করে আশা করি যে একদিন এই নির্দেশটি সাড়ে 3 জনের কাজে লাগবে।

উত্স: www.habr.com