Generate single PDF from multiple Asciidoc files
I'm trying to convert my existing asciidoc documentation into pdf. Asciidoctor-pdf seems quite easy and I'm able to convert single files into pdf.
asciidoctor-pdf -a pdf-theme='./theme/styles.yml' -a pdf-fontsdir='GEM_FONTS_DIR, theme/fonts/' 01-intro.adoc
But my docs are spread across many files. I want do create a single pdf from all those files. Does anyone know how to do this?
Secondly I don't want the generated pdf to be located next du the adoc file. I want to specify a target path.
I'd appreciate every hint. Thanks and best regards. Sebastian
The easiest and most convenient way is to use the VSCode editor with the AsciiDoc extension installed. This extension is developed by the same team that develops the AsciiDoctor text processor. This is a GUI-based approach to solve all your problems so I'm pretty sure u're gonna love it.
(Step 1) After the extension is installed, use the keyboard shortcut Cmd + , to go to the settings and then enter asciidoc.use_asciidoctorpdf in the search bar and tick the check box (see the demonstration below)
(Step 2) To create a single pdf file from multiple .adoc files, just simply put all of them in a single .adoc file with include::directory-to-the-adoc-file.adoc[] (see the illustration below)
(Step 3) Press F1, then type in as pdf and hit Enter to export this single .adoc file as a single PDF file, this will allow u to specify the target export directory for the PDF. Please be patient and wait for a few seconds for the export to complete, the editor will immediately inform u as soon as the export is complete (see the image at the bottom)
- Antora playbook execution crashes when having multiple source repositories
- Text to the right of an embedded image in AsciiDoc
- How to include custom attributes in asciidoc book
- How to add a cover image to an asciidoc document
- How to add an external link to a bibliography item in AsciiDoc
- How to set Asciidoc toc.section.depth value from simple 'asciidoctor file.txt -o file.html' command?
- Define color using local variable
- Add break line in bulleted list
- In Asciidoc (and Asciidoctor), how do I format console output best?
- How to convert asciidoc to pdf?
- Asciidoc define variable local to file
- Why do asciidoc attributes docdatetime and localdatetime always display the same value?
- How do I set an OG image for a docs page to render on socials (twitter, linkedin, etc)?
- How to set scope for document attributes in AsciiDoc
- How to bulk edit large asciidoc tables in VSCode, or do so with a table editor UI?
- Generate ascii doc api documentation from spring rest docs using Spock
- Automating Frontmatter Removal: Streamlining Hugo and AsciiDoctor PDF Integration
- Path Predicament: Navigating Image Rendering Discrepancies Between AsciiDoctor PDF and Hugo
- AsciiDoc: Stock images for admonitions?
- Is there a way to combine curly quotes and em dash in AsciiDoc?
- Is there a way to render the document attributes of an asciidoc file and output to an adoc file?
- asciidoctor: FAILED: 'asciidoctor-plantuml' could not be loaded
- How to write callouts using reStructuredText?
- Render a PlantUML diagram in an asciidoc readme in GitLab
- How to do word break in Ascii Doc?
- I am getting `Error creating DOCX from AsciiDoc file` in IntelliJ Idea, How can this be resolved?
- Auto-width columns (or TeX-like tabular) in AsciiDoc?
- Custom css with supplemental-ui in Antora does not work
- Asciidoctor: Is it possible to activate section numbering in themes yml
- Generate single PDF from multiple Asciidoc files