Ferdig løsning markdown2pdf med kildekode for Linux

Forord

Markdown er en flott måte å skrive en liten artikkel på, og noen ganger kan det også være nokså omfattende tekst, med enkel formatering i form av kursiv og fet skrift. Markdown er også bra for å skrive artikler som inkluderer kodesnutter. Men noen ganger ønsker man å konvertere dette til en vanlig, godt formatert PDF-fil uten tap eller problemer ved konverteringen, som for eksempel de jeg har hatt - man kan ikke skrive på russisk i kommentarene til koden, for lange linjer brytes ikke og andre små problemer. Denne guiden vil raskt konfigurere konvertereren. md2pdf uten å gå særlig inn i hvordan det fungerer. Skriptet for en mer eller mindre automatisk installasjon er nedenfor i den relevante seksjonen.

Mitt eksempel TeX-mal for konvertering bruker fonts-pakken PSCyr, som inkluderer støtte for Microsoft-skrifter, nemlig Times New Roman. Slike krav ble stilt for diplomet i henhold til GOST. Hvis du kan, kan du modifisere malen etter behov. I min veiledning må man imidlertid først gjøre litt arbeid med å konfigurere PSCyr i TexLive. Konfigurasjonen er utført i Linux Mint Mate-distribusjonen, for andre distribusjoner må man muligens google de standard mappene til TexLive-pakken for systemet ditt.

Installasjon av TexLive

Selvfølgelig kan man bare installere de nødvendige delene av denne pakken. Men jeg var rett og slett for lat til å lete etter en minimum nødvendig arbeidsinstallasjon. For å sikre at alt fungerer nøyaktig, installerer vi hele TexLive-pakken. Den heter texlive-full og veier litt over 2 gigabyte, husk dette faktum. Vi utfører kommandoen:

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

Etter en relativt lang installasjon kan vi gå til neste punkt.

Installasjon av konvertereren Pandoc

Pandoc er en Linux-pakke som gjør det mulig å konvertere noen tekstformater til andre. Den har mange interessante funksjoner som du kan finne ut av selv på internett. Vi er imidlertid bare interessert i muligheten for å konvertere markdown-filer til PDF. La oss sjekke om Pandoc er installert, og hvis ikke, så installer vi det. For eksempel slik:

user@hostname:~$ dpkg -s pandoc

Hvis det i utdataene står at det ikke er installert - installer:

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

Installasjon av PSCyr-pakken for TexLive

For å begynne må du laste ned PSCyr. Det er fremdeles tilgjengelig her. lenken, hvis artikkelen på lesetidspunktet av en eller annen grunn ikke er tilgjengelig, ikke fortvil, det er ikke vanskelig å finne sammen med installasjonsveiledningen ved å søke i Google etter noe som "Installasjon av PsCyr texlive". Hvis den er tilgjengelig, er det enklere for deg, last ned og vi kan anta at du har pakket ut arkivet i hjemmemappen din, og dermed ser banen til mappen som er i arkivet ut som ~\/PSCyr. Da går vi til Terminalen og utfører kommandoene:

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

Videre finner vi ut hvor den lokale katalogen ligger texmf. Utfør kommandoen:

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

Sannsynligvis er denne katalogen din - /usr/local/share/texmf/, og så utfører vi:

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

Eller du kan enkelt utføre kommandoen som kopierer til mappen texmf uansett hvor den er:

user@hostname:~$ sudo cp -R .\/PSCyr\/* $(kpsewhich -expand-var='$TEXMFLOCAL')

PSCyr-fontene er installert, koble til i TexLive:

user@hostname:~$ sudo texhash
user@hostname:~$ updmap --enable Map=pscyr.map
user@hostname:~$ sudo mktexlsr

LaTeX-mal for konvertering md2pdf

Jeg vil ikke beskrive hvordan denne malen er konfigurert, jeg vil bare vise den i en spoiler uten mye forklaring. Bare si at den er godt konfigurert, i hvert fall hvordan den behandler tekster med mye kildekode. Hvis du ikke er fornøyd med størrelsene på innrykk, linjeavstand, mangel på nummerering av seksjoner og underseksjoner, så mener jeg det er ganske lett å google spørsmålet på internett "hvordan man gjør i Latex..." og videre til dine behov. Hvis det er helt uklart, skriv i kommentarene, så skal jeg prøve å huske mine egne innstillinger fra for 4 år siden og forklare hva hver linje av malen svarer for. Foreløpig vil jeg skrive hvordan jeg gjorde det på PC-en min, og du står fritt til å gjenta eller modifisere det til ditt eget.

Opprett en fil template.tex i katalogen /usr/share/texlive/:

user@hostname:~$ sudo touch \/usr\/share\/texlive\/template.tex

Gi den leserettigheter:

user@hostname:~$ sudo chmod 444 \/usr\/share\/texlive\/template.tex

åpne den som root og lim inn innholdet som er skjult under spoileren nedenfor:

user@hostname:~$ sudo nano \/usr\/share\/texlive\/template.tex

Innholdet i malen \/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}

Lagring filen /usr/share/texlive/template.tex og skriver et skript som vil konvertere Markdown-filen til PDF, og oppretter i samme mappe en fil med navnet på Markdown-filen med endelsen .pdf, det vil si etter konverteringen filename.md i mappen vil det vises filename.md.pdf. Vi kaller skriptet md2pdf og plasserer det på stien /usr/bin. Vi utfører følgende kommandoer:

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

I den 4. linjen er kommandoen for konvertering spesifisert. Vær oppmerksom på —from=markdown_githubGitHub-versjonen av Markdown er bakoverkompatibel med original Markdown, så hvis teksten din er skrevet med den, trenger du ikke å bekymre deg. Hvis MD-filen din derimot er skrevet med en spesifikk dialekt av Markdown, kan du lese manualen for Pandoc (man pandoc), sørge for at implementeringen din støttes, og justere /usr/bin/md2pdf om nødvendig.

Et skript for mer eller mindre automatisk installasjon

Hvis du ikke ønsker å konfigurere noe i det hele tatt, og har en Ubuntu-lignende distribusjon, kan du prøve å lage et skript med innholdet skjult under spoileren, og mest sannsynlig vil alt bli installert automatisk. Bare husk at TeX-malen som er lagt ut under spoileren ovenfor, må du kopiere selv. Åpne Terminal og kjør:

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

Deretter fyll det med følgende innhold:

Innholdet i skriptet $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

Kjør det med kommandoen:

user@hostname:~$ sudo bash $HOME/installmd2pdf.sh

Husk at /usr/share/texlive/template.tex du må fylle det med innholdet angitt i seksjonen «LaTeX-mal for konvertering md2pdf».

Bruk av md2pdf

Bare åpne mappen med Markdown-filen (some_file.md) i Terminal, og kjør kommandoen:

user@hostname:~$ md2pdf some_file.md

Som et resultat vil en fil bli opprettet i mappen. some_file.md.pdf.

Konklusjon

Basert på den beskrevne metoden kan du lage hvilken som helst stil på PDF-filer, og du kan også konvertere andre formater enn md, så lenge de støttes av Pandoc. Jeg håper at denne instruksjonen vil komme til nytte for 3,5 personer en dag.

Kilde: habr.com