소스 코드가 포함된 즉시 사용 가능한 markdown2pdf 솔루션 Linux

머리말

마크다운은 간단한 이탤릭체와 볼드체 서식을 사용하여 짧은 기사를 작성할 수 있는 좋은 방법이며 때로는 상당히 많은 텍스트를 작성할 수 있습니다. Markdown은 소스 코드가 포함된 기사를 작성하는 데에도 좋습니다. 그러나 때때로 당신은 손실없이 탬버린과 춤을 추고 규칙적이고 잘 구성된 PDF 파일로 추월하고 변환 중에 문제가 없도록하고 싶습니다. 예를 들어 러시아어로 쓸 수 없습니다. 소스 코드의 주석, 너무 긴 줄은 전송되지 않지만 잘림 및 기타 사소한 문제. 지침을 통해 변환기를 빠르게 설정할 수 있습니다. md2pdf 작동 방식을 실제로 이해하지 못한 채. 어느 정도 자동 설치를 위한 스크립트는 아래의 해당 섹션에 있습니다.

변환을 위한 내 샘플 TeX 템플릿은 Microsoft 글꼴 지원을 포함하는 PSCyr 글꼴 패키지를 사용합니다. 타임즈 새로운 로마이것들은 GOST에서 요구하는 학위 요건입니다. GOST에 익숙하시다면 필요에 맞게 템플릿을 수정하실 수 있습니다. 제 지침에 따라 먼저 TexLive에서 PSCyr을 설정해야 합니다. 설정은 배포판에서 진행됩니다. Linux Mint Mate 사용자라면 해당 시스템의 기본 TexLive 패키지 폴더를 구글에서 검색해야 할 수도 있습니다. 다른 배포판의 경우 해당 시스템의 기본 TexLive 패키지 폴더를 검색해 보세요.

TexLive 설치

물론 이 패키지의 필요한 부분만 설치할 수 있습니다. 그러나 개인적으로 나는 솔직히 필요한 최소한의 작업 설치를 찾기에는 너무 게으르다. 모든 것이 제대로 작동하는지 확인하려면 전체 TexLive 패키지를 설치하십시오. 그것은이라고 texlive 전체 무게는 2GB가 조금 넘습니다. 이 사실을 명심하십시오. 다음 명령을 실행합니다.

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

충분히 긴 설치가 끝나면 다음 항목으로 진행할 수 있습니다.

Pandoc 변환기 설치

Pandoc — 패키지 LinuxPandoc은 여러 텍스트 형식을 다른 형식으로 변환할 수 있는 도구입니다. 다양한 흥미로운 기능이 있으니 온라인에서 살펴보세요. 우리는 Markdown 파일을 PDF로 변환하는 데만 관심이 있습니다. 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에 검색하는 것이 매우 쉽습니다. 그런 다음 당신의 필요. 명확하지 않은 경우 의견을 작성하십시오. 4 년 전 내 설정을 조사하고 템플릿의 어떤 줄이 무엇을 담당하는지 설명하겠습니다. 그 동안 나는 내 PC에서 어떻게 했는지 적어둘 것이고, 당신은 자유롭게 반복하거나 스스로 수정할 수 있다.

파일 만들기 템플릿.tex 카탈로그에 /usr/공유/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인 Markdown 파일이라는 파일을 생성합니다. 즉, 변환 후 파일명.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. 마크다운의 깃허브 버전은 기존 마크다운과 역호환이 가능하기 때문에 거기에 글을 쓴다면 걱정할 필요가 없다. MD 파일이 특정 Markdown 방언으로 작성된 경우 Pandoc 설명서(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 " 섹션에 표시된 대로 입력해야 합니다.md2pdf 변환을 위한 LaTeX 템플릿" 콘텐츠.

md2pdf 사용

Markdown 파일(some_file.md) 터미널에서 다음 명령을 실행합니다.

user@hostname:~$ md2pdf some_file.md

결과적으로 폴더에 파일이 나타납니다. some_file.md.pdf.

결론

설명된 방법을 기반으로 PDF 파일의 모든 스타일을 빌드할 수 있으며 Pandoc에서 지원하는 md 대신 다른 형식을 변환할 수도 있습니다. 언젠가 이 지침이 3명 반에게 도움이 되기를 감히 바랍니다.

출처 : habr.com