Тема: Перетворення офіційного посібника Kronos Vulkan у формат pdf

Спочатку треба завантажити відповідний репозиторій звідси Kronos Vulkan tutorial

    Власне текст посібника знаходиться в теці en, файли в форматі .adoc,
які можна перетворити на pdf за допомогою програми asciidoctor-pdf.

    При цьому я виявив чотири проблеми:
    1) Умовні шляхи до зображень написані лише зі слешем, наприклад image::/шлях. У мене термінал xfce4(Manjaro), який вимагає крапку перед слешем для умовного шляху (image::./). Тому я просто відкрив у Kate (текстовий редактор) всі файли разом, знайшов відповідні шляхи і додав потрібну крапку за допомогою масового пошуку і заміни. У розділі по Ray tracing там взагалі шлях деяких зображень до теки з малюнками треба замінити.
    2) Кожен окремий файл вимагає, щоб тека з малюнками (images) була в одній директорії з ним, тому при початковому перетворенні файлів з adoc на pdf вам потрібно мати цю теку поруч із відповідними файлами.
    3) Для gif зображень треба встановлювати окрему програму, але там їх усього три і в одному розділі (Ray tracing), тому лишив як є, без гіфок.
    4) Посилання всередині файла не працюють, треба багато редагувати, щоб запрацювали, бо вони створені під структуру репозиторія, а не окремого файла pdf.

    Коли ви перетворили всі потрібні вам файли в формат pdf,
далі потрібно зібрати ці файли в один. Для цього я використав pdfmixtool,
тому що ця програма зберігає таблицю змісту кожного файлу. Це потрібно, щоб в результаті була якісна загальна таблиця змісту, з якою легко працювати.

    Послідовність збирання файлів:
1) Зібрати декілька файлів з окремого розділу в один файл. Якщо файл у розділі лише один, лишайте як є.
2) Зібрати всі окремі файли розділів в один кінцевий файл посібника.

    Така послідовність потрібна для формування таблиці змісту. Якщо просто всі файли відразу зібрати в один, то таблиця змісту, звісно, згенерується, але там усе в купу перемішається і буде незручно користуватися. Pdfmixtool назву кожного окремого файлу сприймає як назву окремого розділу з таблиці змісту.

P.S. Хотів додати свій файл для ознайомлення, але тут, певно, якісь обмеження на розмір файлу діють.

Подякували: Torbins1