Можете користити пандоц на Линук-у за конверзију између више од 40 формата датотека. Такође можете да га користите за креирање једноставног система документи као код тако што ћете писати у Маркдовн, чувати у гит-у и објављивати у било ком од подржаних формата.
Преглед садржаја
Конверзија документа и Доцс-ас-Цоде
Ако имате документ у било ком од пандоц-а многи подржани формати датотека, претворити га у било који други је лак. То је згодан алат!
Али права моћ пандоц-а постаје очигледна када га користите као основу једноставног система документи као код. Премиса доцс-ас-цоде је да усвоји неке од техника и принципа развоја софтвера и примени их на писање документације, посебно за пројекте развоја софтвера. Међутим, можете га применити на развој било које врсте документације.
Програмери софтвера користе свој омиљени уређивач или интегрисано развојно окружење (ИДЕ) да напишу своје програме. Код који укуцају се чува у текстуалним датотекама. Ове садрже изворни код за програм.
Они користе а систем контроле верзија, или ВЦС (Гит је најпопуларнији), да би се ухватиле промене у изворном коду како се развија и унапређује. То значи да програмер има комплетну историју свих верзија датотека изворног кода. Он или она могу брзо приступити било којој претходној верзији датотеке. Гит чува датотеке у спремишту. Постоји локално спремиште на рачунару сваког програмера и централно, заједничко, удаљено спремиште које се често налази у облаку.
Када су спремни да направе радну верзију програма, користе а компајлер да прочита изворни код и генерише бинарни извршни фајл.
Писањем докумената на лаганом, текстуалном језику за означавање, можете користити ВЦС за контролу верзије. Када будете спремни да дистрибуирате или објавите документ, можете да користите пандоц да генеришете онолико различитих верзија ваше документације колико вам је потребно, укључујући веб-базиране (ХТМЛ), обрађени текстом или куцани (ЛибреОффице, Мицрософт Ворд, ТеКс), преносиви формат документа (ПДФ), е-књига (еПуб), и тако даље.
Све ово можете да урадите из једног скупа лаганих текстуалних датотека контролисаних верзијама.
Инсталирање пандоц-а
Да бисте инсталирали пандоц на Убунту, користите ову команду:
sudo apt-get install pandoc
На Федора-и, команда која вам је потребна је следећа:
sudo dnf install pandoc
На Мањаро, потребно је да откуцате:
sudo pacman -Syu pandoc
Можете да проверите коју верзију сте инсталирали користећи опцију –версион:
pandoc --version
Коришћење пандоц-а без датотека
Ако користите пандоц без опција командне линије, он такође прихвата куцани унос. Само притисните Цтрл+Д да бисте показали да сте завршили са куцањем. пандоц очекује да куцате у Маркдовн формату и генерише ХТМЛ излаз.
Погледајмо пример:
pandoc
Откуцали смо неколико редова Маркдовн-а и спремамо се да притиснемо Цтрл+Д.
Чим то урадимо, пандоц генерише еквивалентни ХТМЛ излаз.
Међутим, да бисмо урадили било шта корисно са пандоц-ом, заиста морамо да користимо датотеке.
Маркдовн Басицс
Маркдовн је лагани језик за означавање, а одређеним знаковима се даје посебно значење. Можете користити уређивач обичног текста да бисте креирали Маркдовн датотеку.
Маркдовн се може лако прочитати, јер нема визуелно гломазних ознака које би одвратиле пажњу од текста. Форматирање у Маркдовн документима личи на форматирање које представља. Испод су неке од основа:
Да бисте нагласили текст курзивом, умотајте га у звездице. *Ово ће бити наглашено*
Да бисте подебљали текст, користите две звездице. **Ово ће бити подебљано**
Наслови су представљени знаком броја/хеш ознаком (#). Текст је одвојен од хеша размаком. Користите један хеш за наслов највишег нивоа, два за други ниво и тако даље.
Да бисте креирали листу са набрајањем, започните сваки ред листе звездицом и уметните размак испред текста.
Да бисте направили нумерисану листу, започните сваки ред цифром праћеном тачком, а затим уметните размак испред текста.
Да бисте направили хипервезу, ставите назив сајта у угласте заграде ([]), и УРЛ у загради [()] овако: [Link to How to Geek](хттпс://ввв.вдзвдз.цом/).
Да бисте уметнули слику, откуцајте узвичник непосредно испред заграда (![]). Унесите било који алтернативни текст за слику у заградама. Затим ставите путању до слике у заграде [()“]. Ево примера: .
У следећем одељку ћемо покрити више примера свега овога.
Конвертовање датотека
Конверзије датотека су једноставне. пандоц обично може да утврди са којим форматима датотека радите из њихових имена. Овде ћемо генерисати ХТМЛ датотеку из Маркдовн датотеке. Опција -о (излаз) говори пандоц-у име датотеке коју желимо да креирамо:
pandoc -o sample.html sample.md
Наш узорак Маркдовн датотеке, сампле.мд, садржи кратак одељак Маркдовн-а приказан на слици испод.
Креира се датотека под називом сампле.хтмл. Када двапут кликнемо на датотеку, наш подразумевани претраживач ће је отворити.
Сада, хајде да генеришемо ан Отворите формат документа текстуални документ у којем можемо да отворимо ЛибреОффице Вритер:
pandoc -o sample.odt sample.md
ОДТ датотека има исти садржај као и ХТМЛ датотека.
Добар додир је алтернативни текст за слику који се такође користи за аутоматско генерисање натписа за слику.
Одређивање формата датотека
Опције -ф (од) и -т (до) се користе да кажу пандоцу у које формате датотека желите да конвертујете. Ово може бити корисно ако радите са форматом датотеке који дели екстензију датотеке са другим сродним форматима. На пример, ТеКс, и ЛаТеКс оба користе екстензију „.тек“.
Такође користимо опцију -с (самостална) тако да ће пандоц генерисати сву ЛаТеКс преамбулу потребну да би документ био потпун, самосталан и добро формиран ЛаТеКс документ. Без опције -с (самостална), излаз би и даље био добро формиран ЛаТеКс који би могао да се убаци у други ЛаТеКс документ, не би се правилно анализирао као самостални ЛаТеКс документ.
Укуцавамо следеће:
pandoc -f markdown -t latex -s -o sample.tex sample.md
Ако отворите датотеку “сампле.тек” у уређивачу текста, видећете генерисани ЛаТеКс. Ако имате ЛаТеКс уређивач, можете отворити ТЕКС датотеку да видите преглед начина на који се тумаче ЛаТеКс команде за куцање. Смањивање прозора да би се уклопило у слику испод учинило је да екран изгледа скучено, али у стварности је било у реду.
Користили смо ЛаТеКс едитор тзв Текмакер. Ако желите да га инсталирате у Убунту, откуцајте следеће:
sudo apt-get install texmaker
У Федори, команда је:
sudo dnf install texmaker
У Мањароу користите:
sudo pacman -Syu texmaker
Конвертовање датотека са шаблонима
Вероватно почињете да схватате флексибилност коју пандоц пружа. Можете писати једном и објавити у скоро сваком формату. То је сјајан подвиг, али документи изгледају помало вани.
Са шаблонима можете да диктирате које стилове ће пандоц користити када генерише документе. На пример, можете рећи пандоц-у да користи стилове дефинисане у а Каскадни листови стилова (ЦСС) датотеку са опцијом –цсс.
Направили смо малу ЦСС датотеку која садржи текст испод. Он мења размак изнад и испод заглавља нивоа један стил. Такође мења боју текста у белу, а боју позадине у нијансу плаве:
h1 {
color: #FFFFFF;
background-color: #3C33FF;
margin-top: 0px;
margin-bottom: 1px;
}
Комплетна команда је испод – имајте на уму да смо користили и самосталну опцију (-с):
pandoc -o sample.html -s --css sample.css sample.md
пандоц користи један стил из наше минималистичке ЦСС датотеке и примењује га на заглавље првог нивоа.
Још једна опција финог подешавања која вам је доступна када радите са ХТМЛ датотекама је да укључите ХТМЛ ознаке у вашу Маркдовн датотеку. Ово ће бити прослеђено до генерисане ХТМЛ датотеке као стандардне ХТМЛ ознаке.
Међутим, ова техника би требало да буде резервисана за када генеришете само ХТМЛ излаз. Ако радите са више формата датотека, пандоц ће игнорисати ХТМЛ ознаке за датотеке које нису ХТМЛ и биће прослеђене њима као текст.
Такође можемо одредити који стилови се користе када се генеришу ОДТ датотеке. Отворите празан ЛибреОффице Вритер документ и прилагодите наслове и стилове фонта како би одговарали вашим потребама. У нашем примеру смо такође додали заглавље и подножје. Сачувајте документ као „одт-темплате.одт“.
Сада можемо да користимо ово као шаблон са опцијом –референце-доц:
pandoc -o sample.odt --reference-doc=odt-template.odt sample.md
Упоредите ово са претходним примером ОДТ-а. Овај документ користи другачији фонт, има наслове у боји и укључује заглавља и подножја. Међутим, генерисан је из исте „сампле.мд“ Маркдовн датотеке.
Референтни шаблони докумената се могу користити за означавање различитих фаза израде документа. На пример, можда имате шаблоне који имају водене жигове „Нацрт“ или „За преглед“. Шаблон без воденог жига би се користио за финализовани документ.
Генерисање ПДФ-ова
Подразумевано, пандоц користи ЛаТеКс ПДФ машину за генерисање ПДФ датотека. Најлакши начин да се уверите да сте задовољили одговарајуће ЛаТеКс зависности је да инсталирате ЛаТеКс едитор, као што је Текмакер.
Међутим, то је прилично велика инсталација — и Тек и ЛаТеКс су прилично велики. Ако вам је простор на чврстом диску ограничен или знате да никада нећете користити ТеКс или ЛаТеКс, можда бисте радије генерисали ОДТ датотеку. Затим га можете једноставно отворити у ЛибреОффице Вритер-у и сачувати га као ПДФ.
Документи као код
Постоји неколико предности коришћења Маркдовн-а као језика за писање, укључујући следеће:
Рад у датотекама обичних текстова је брз: учитавају се брже од датотека процесора текста сличне величине, а такође имају тенденцију да се брже крећу кроз документ. Многи уређивачи, укључујући гедит, Вим и Емацс, користе истицање синтаксе са Маркдовн текстом.
Имаћете временску линију свих верзија ваших докумената: Ако своју документацију складиштите у ВЦС, као што је Гит, лако можете видети разлике између било које две верзије исте датотеке. Међутим, ово заиста функционише само када су датотеке обичан текст, јер то ВЦС очекује да ради.
ВЦС може да забележи ко је извршио промене и када: Ово је посебно корисно ако често сарађујете са другима на великим пројектима. Такође обезбеђује централно складиште за саме документе. Многе Гит услуге које се налазе у облаку, као што је ГитХуб, ГитЛаб, и БитБуцкет, имају бесплатне нивое у својим моделима цена.
Можете да генеришете своје документе у више формата: Са само неколико једноставних схелл скрипти, можете извући стилове из ЦСС-а и референтних докумената. Ако своје документе чувате у ВЦС спремишту које се интегрише са Континуирана интеграција и континуирана примена (ЦИ/ЦД) платформе, могу се аутоматски генерисати кад год се софтвер изгради.
Последње мисли
Постоји много више опција и функција унутар пандоц од онога што смо овде покрили. Процеси конверзије за већину типова датотека могу се подесити и фино подесити. Да бисте сазнали више, погледајте одличне примере на званичним (и изузетно детаљним) пандоц веб страница.