ដំណោះស្រាយ markdown2pdf ដែលផលិតរួចរាល់ជាមួយនឹងកូដប្រភពសម្រាប់លីនុច

បុព្វកថា

Markdown គឺជាវិធីដ៏ល្អមួយក្នុងការសរសេរអត្ថបទខ្លីៗ ហើយជួនកាលមានអត្ថបទច្រើន ដោយមានទម្រង់ទ្រេតសាមញ្ញ និងដិត។ Markdown ក៏ល្អសម្រាប់ការសរសេរអត្ថបទដែលមានកូដប្រភពផងដែរ។ ប៉ុន្តែពេលខ្លះអ្នកចង់បាត់បង់ រាំជាមួយ tambourine ដើម្បីយកឈ្នះវាទៅជាឯកសារ PDF ធម្មតាដែលមានទម្រង់ល្អ ហើយដើម្បីកុំឱ្យមានបញ្ហាកំឡុងពេលបម្លែង ដែលឧទាហរណ៍ខ្ញុំមាន - អ្នកមិនអាចសរសេរជាភាសារុស្សីនៅក្នុង មតិយោបល់នៃកូដប្រភព បន្ទាត់វែងពេកមិនត្រូវបានផ្ទេរទេ ប៉ុន្តែកាត់ និងបញ្ហាតូចតាចផ្សេងទៀត។ ការណែនាំនឹងអនុញ្ញាតឱ្យអ្នករៀបចំកម្មវិធីបម្លែងបានយ៉ាងឆាប់រហ័ស md2pdf ដោយមិនយល់ពីរបៀបដែលវាដំណើរការ។ ស្គ្រីបសម្រាប់ការដំឡើងស្វ័យប្រវត្តិច្រើន ឬតិចគឺខាងក្រោមនៅក្នុងផ្នែកដែលសមស្រប។

គំរូ TeX គំរូរបស់ខ្ញុំសម្រាប់ការបំប្លែងប្រើកញ្ចប់ពុម្ពអក្សរ PSCyr ដែលរួមបញ្ចូលការគាំទ្រសម្រាប់ពុម្ពអក្សរ Microsoft ពោលគឺ ដងរ៉ូម៉ាំងថ្មី។. មានតម្រូវការបែបនេះសម្រាប់សញ្ញាប័ត្រយោងទៅតាម GOST ។ ប្រសិនបើអ្នកដឹងពីរបៀប អ្នកអាចកែប្រែគំរូឱ្យសមនឹងតម្រូវការរបស់អ្នក។ នៅក្នុងការណែនាំផ្ទាល់ខ្លួនរបស់ខ្ញុំ ដំបូងអ្នកនឹងត្រូវបញ្ឆោតជាមួយនឹងការកំណត់ PSCyr នៅក្នុង TexLive។ ការដំឡើងត្រូវបានធ្វើរួចនៅក្នុងការចែកចាយ Linux Mint Mate សម្រាប់ការចែកចាយផ្សេងទៀត អ្នកប្រហែលជាត្រូវ google នូវស្តង់ដារកញ្ចប់ TexLive packages សម្រាប់ប្រព័ន្ធរបស់អ្នក។

ការដំឡើង TexLive

ជាការពិតណាស់អ្នកអាចដំឡើងតែផ្នែកចាំបាច់នៃកញ្ចប់នេះ។ ប៉ុន្តែ​ដោយ​ផ្ទាល់ ខ្ញុំ​ខ្ជិល​ពេក​ក្នុង​ការ​ស្វែង​រក​ការ​ដំឡើង​ការងារ​ចាំបាច់​អប្បបរមា។ ដើម្បីប្រាកដថាអ្វីៗដំណើរការបាន សូមដំឡើងកញ្ចប់ TexLive ទាំងមូល។ វា​ហៅថា អត្ថបទពេញ និងមានទម្ងន់លើសពី 2 ជីហ្គាបៃបន្តិច សូមរក្សាការពិតនេះក្នុងចិត្ត។ យើងប្រតិបត្តិពាក្យបញ្ជា៖

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

បន្ទាប់ពីការដំឡើងយូរគ្រប់គ្រាន់ អ្នកអាចបន្តទៅធាតុបន្ទាប់។

ការដំឡើងកម្មវិធីបម្លែង Pandoc

Pandoc គឺជាកញ្ចប់លីនុចដែលអនុញ្ញាតឱ្យអ្នកបំប្លែងទម្រង់អត្ថបទមួយចំនួនទៅអ្នកដទៃ។ វាមានលក្ខណៈពិសេសគួរឱ្យចាប់អារម្មណ៍ជាច្រើនដែលអ្នកអាចរកឃើញដោយខ្លួនឯងនៅលើអ៊ីនធឺណិត។ យើងចាប់អារម្មណ៍តែលើលទ្ធភាពនៃការបំប្លែងឯកសារ markdown ទៅជា PDF ប៉ុណ្ណោះ។ ពិនិត្យមើលថាតើ Pandoc ត្រូវបានដំឡើងឬអត់ ដំឡើងវា។ ឧទាហរណ៍ដូចនេះ៖

user@hostname:~$ dpkg -s pandoc

ប្រសិនបើលទ្ធផលនិយាយថាវាមិនត្រូវបានដំឡើង សូមដំឡើង៖

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

ការដំឡើងកញ្ចប់ PSCyr សម្រាប់ TexLive

ដំបូងអ្នកត្រូវទាញយក PSCyr ។ សម្រាប់ពេលនេះវានៅតែមាននៅនេះ។ តំណភ្ជាប់ប្រសិនបើនៅពេលអានអត្ថបទវាមិនមានសម្រាប់ហេតុផលមួយចំនួន កុំអស់សង្ឃឹម វាជាការងាយស្រួលក្នុងការស្វែងរកវាជាមួយនឹងការណែនាំអំពីការដំឡើងដោយវាយបញ្ចូលអ្វីមួយដូចជា "ការដំឡើង PsCyr texlive" នៅក្នុង Google ។ ប្រសិនបើវាមាន នោះវាកាន់តែងាយស្រួលសម្រាប់អ្នក ទាញយក ហើយយើងនឹងសន្មត់ថាអ្នកបានពន្លាប័ណ្ណសារទៅក្នុងថតផ្ទះរបស់អ្នក ហើយដូច្នេះផ្លូវទៅកាន់ថតដែលមាននៅក្នុងប័ណ្ណសារមើលទៅដូច ~/PSCyr. បន្ទាប់មកចូលទៅកាន់ Terminal ហើយប្រតិបត្តិពាក្យបញ្ជាខាងក្រោមតាមលំដាប់លំដោយ៖

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

បន្ទាប់​មក​រក​មើល​កន្លែង​ដែល​ថត​មូលដ្ឋាន​មាន​ទីតាំង អត្ថបទ. យើងប្រតិបត្តិពាក្យបញ្ជា៖

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

ភាគច្រើនទំនងជាអ្នកមានថតនេះ - /usr/local/share/texmf/ហើយបន្ទាប់មកយើងធ្វើ៖

user@hostname:~$ sudo cp -R ./PSCyr/* /usr/local/share/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

គំរូ LaTeX សម្រាប់ការបំប្លែង md2pdf

ខ្ញុំនឹងមិនរៀបរាប់ច្បាស់អំពីរបៀបដែលគំរូនេះត្រូវបានកំណត់រចនាសម្ព័ន្ធនោះទេ ហើយនឹងផ្តល់ឱ្យវាយ៉ាងសាមញ្ញនៅក្រោម spoiler ដោយគ្មានការពន្យល់ច្រើន។ វាគ្រប់គ្រាន់ក្នុងការនិយាយថាវាត្រូវបានតំឡើងយ៉ាងល្អ យ៉ាងហោចណាស់ទាក់ទងនឹងរបៀបដែលវាគ្រប់គ្រងអត្ថបទជាមួយនឹងកូដប្រភពច្រើន។ ប្រសិនបើអ្នកមិនពេញចិត្តនឹងទំហំនៃការចូលបន្ទាត់ គម្លាតបន្ទាត់ កង្វះលេខរៀងនៃផ្នែក និងផ្នែករង នោះតាមគំនិតរបស់ខ្ញុំ វាងាយស្រួលណាស់ក្នុងការ google សំណួរនៅលើអ៊ីនធឺណិត "របៀបធ្វើវានៅក្នុង 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

បើកវានៅក្រោម root ហើយបិទភ្ជាប់មាតិកាដែលលាក់នៅក្រោម spoiler ខាងក្រោមទៅក្នុងវា៖

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. កំណែ GitHub នៃ Markdown គឺត្រូវគ្នាទៅនឹង Markdown ដើម ដូច្នេះប្រសិនបើអត្ថបទរបស់អ្នកត្រូវបានសរសេរនៅក្នុងវា អ្នកមិនចាំបាច់បារម្ភទេ។ ប្រសិនបើឯកសារ MD របស់អ្នកត្រូវបានសរសេរជាគ្រាមភាសា Markdown ជាក់លាក់ បន្ទាប់មកអានសៀវភៅណែនាំ Pandoc (man pandoc) ត្រូវប្រាកដថាការអនុវត្តរបស់អ្នកត្រូវបានគាំទ្រដោយវា ហើយកែប្រែ /usr/bin/md2pdf បើចាំបាច់។

ស្គ្រីបសម្រាប់ការដំឡើងដោយស្វ័យប្រវត្តិច្រើន ឬតិច

ប្រសិនបើអ្នកពិតជាមិនចង់កំណត់រចនាសម្ព័ន្ធអ្វីទាំងអស់ ហើយអ្នកមានការចែកចាយដូច Ubuntu អ្នកអាចសាកល្បងបង្កើតស្គ្រីបជាមួយនឹងមាតិកាដែលលាក់នៅក្រោម spoiler ហើយភាគច្រើនទំនងជាអ្វីៗនឹងដំឡើងដោយខ្លួនឯង រឿងតែមួយគត់គឺចម្លង គំរូ TeX ដែលបានបង្ហោះនៅក្រោម spoiler ខាងលើទៅកន្លែងដែលអ្នកត្រូវការដោយខ្លួនឯង។ បើកស្ថានីយហើយដំណើរការ៖

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) នៅក្នុង Terminal ហើយដំណើរការពាក្យបញ្ជា៖

user@hostname:~$ md2pdf some_file.md

ជាលទ្ធផល ឯកសារមួយនឹងបង្ហាញនៅក្នុងថត some_file.md.pdf.

សេចក្តីសន្និដ្ឋាន

ដោយផ្អែកលើវិធីសាស្រ្តដែលបានពិពណ៌នា អ្នកអាចបង្កើតរចនាប័ទ្មណាមួយនៃឯកសារ PDF អ្នកក៏អាចបំប្លែងទម្រង់ផ្សេងទៀតជំនួសឱ្យ md ដែលគាំទ្រដោយ Pandoc ។ ខ្ញុំ​ហ៊ាន​សង្ឃឹម​ថា ថ្ងៃ​ណា​មួយ​ការ​ណែនាំ​នេះ​នឹង​មាន​ប្រយោជន៍​ដល់​មនុស្ស ៣​នាក់​កន្លះ។

ប្រភព: www.habr.com