🥇פתרון markdown2pdf מוכן עם קוד מקור עבור לינוקס

פְּתִיחַ

Markdown היא דרך מצוינת לכתוב מאמר קצר, ולפעמים טקסט ארוך למדי, עם עיצוב פשוט בצורת נטוי ופונט עבה. Markdown טוב גם לכתיבת מאמרים הכוללים קוד מקור. אבל לפעמים אתה רוצה להעביר אותו לקובץ PDF רגיל ומעוצב ללא הפסד, לרקוד עם טמבורין, וכדי שלא יהיו בעיות במהלך ההמרה, מה שהיה לי למשל - אתה לא יכול לכתוב ברוסית בתגובות של קוד המקור, שורות ארוכות מדי אינן מועברות, ובעיות קלות אחרות מנותקות. ההוראות יאפשרו לך להגדיר במהירות את הממיר md2pdf בלי להתעמק באמת איך זה עובד. התסריט להתקנה אוטומטית פחות או יותר נמצא למטה בחלק המתאים.

תבנית TeX לדוגמה שלי להמרה משתמשת בחבילת הגופנים PSCyr, הכוללת תמיכה בגופנים של מיקרוסופט, כלומר Times New Roman. אלו היו הדרישות לתעודה על פי GOST. אם אתה יודע איך, אתה יכול לשנות את התבנית כך שתתאים לצרכים שלך. בהוראות שלי, תחילה תצטרך להתעסק בהגדרת PSCyr ב-TexLive. ההגדרה מתבצעת בהפצת Linux Mint Mate; עבור הפצות אחרות, ייתכן שתצטרך לחפש בגוגל את תיקיות החבילות הסטנדרטיות של TexLive עבור המערכת שלך.

התקנת TexLive

כמובן, אתה יכול להתקין רק את החלקים של חבילה נתונה שאתה צריך. אבל באופן אישי, למען האמת התעצלתי לחפש את ההתקנה המינימלית הנדרשת. כדי להבטיח שהכל עובד כשורה, אנו מתקינים את כל חבילת TexLive. זה נקרא מלא טקסטיל ושוקל קצת יותר מ-2 גיגה-בייט, זכור עובדה זו. אנו מבצעים את הפקודה:

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

לאחר התקנה ארוכה מספיק, אתה יכול לעבור לשלב הבא.

התקנת ממיר Pandoc

Pandoc היא חבילת לינוקס המאפשרת לך להמיר כמה פורמטים של טקסט לאחרים. יש לו הרבה תכונות מעניינות שתוכלו להכיר באינטרנט. אנו מעוניינים רק באפשרות להמיר קובץ סימון ל-PDF. בוא נבדוק אם Pandoc מותקן ואם לא, התקן אותה. למשל ככה:

user@hostname:~$ dpkg -s pandoc

אם הפלט אומר שהוא לא מותקן, התקן אותו:

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

התקנת חבילת PSCyr עבור TexLive

ראשית עליך להוריד PSCyr. בינתיים זה עדיין זמין כאן קשר, אם בזמן קריאת המאמר הוא אינו זמין מסיבה כלשהי, אל ייאוש, קל למצוא יחד עם הוראות התקנה על ידי הקלדת משהו כמו "התקנת 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

תבנית LaTeX להמרת md2pdf

לא אתאר איך בדיוק התבנית הזו מוגדרת, ופשוט אציג אותה תחת ספוילר בלי הרבה הסבר. די לומר שהוא מוגדר היטב, לפחות באופן שבו הוא מעבד טקסטים עם הרבה קוד מקור. אם אתה לא מרוצה מגודל השקעים, מרווח בין שורות, חוסר מספור של קטעים ותתי סעיפים, אז לדעתי די קל לחפש בגוגל את השאלה "איך עושים בלטקס..." ואז את הצורך שלך. אם זה לגמרי לא ברור, כתבו בתגובות, אני אנסה להתעמק בהגדרות שלי מלפני 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 ולכתוב סקריפט שימיר את קובץ Makrdown ל-PDF, תוך יצירת באותה תיקיה קובץ בשם Markdown file עם קידומת .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 של Markdown תואמת לאחור ל-Markdown המקורי, כך שאם הטקסט שלך כתוב בה, אינך צריך לדאוג. אם קובץ ה-MD שלך כתוב בניב ספציפי של Markdown, קרא את המדריך של Pandoc (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 יש למלא כפי שמצוין בסעיף "תבנית LaTeX להמרת md2pdf» תוכן.

שימוש ב-md2pdf

פשוט פתח את התיקיה עם קובץ Markdown (some_file.md) בטרמינל, והפעל את הפקודה:

user@hostname:~$ md2pdf some_file.md

כתוצאה מכך, יופיע קובץ בתיקייה some_file.md.pdf.

מסקנה

בהתבסס על השיטה המתוארת, אתה יכול לבנות כל סגנון של קבצי PDF; אתה יכול גם להמיר פורמטים אחרים, כל הנתמכים על ידי Pandoc, במקום md. אני מעז לקוות שיום אחד ההוראה הזו תהיה שימושית ל-3 וחצי אנשים.

מקור: www.habr.com

פתרון markdown2pdf מוכן עם קוד מקור עבור לינוקס