Re: Understanding Publish (ox-publish.el)

[jman <emacs-orgmode@city17.xyz>]

Christian Moe <mail@christianmoe.com> writes:

> 1. First issue:
>
> Not quite sure what you mean by saying that it "does not handle content
> exceeding the page length". If the problem is with placing images,
> tables etc., latex does its best, and manually adding \clearpage or
> \newpage as needed tends to be the way it's done.

Hey thanks for the tips!

To be clearer about what I mean I'll provide two sample documents. I hope they're good to reproduce 
the issue.

1) Compiling with ox-publish the following document produces the expected result. Text is 
automatically distributed on subsequent pages
https://paste.sr.ht/~jman/06239fa6624a1af23edfbb5154f5d9dcfdf8427a

2) Compiling this other document will produce strange empty pages. The content of the ordered list 
doesn't fit one page and instead of filling the next page, it will just "overflow" and "disappear":
https://paste.sr.ht/~jman/35434b0fdf08164abf6c59a413d60ea6a4d0e943

These samples are compiled with:

$ emacs --batch <file>.org --load ol-pdf.el --funcall org-publish-current-file

`ol-pdf.el` is nothing special, I think:

(require 'ol)
(require 'ox-publish)
(setq org-publish-project-alist
      '(("org-to-pdf"
         :base-directory "~/src"
         :base-extension "org"
         :publishing-directory "~/pdf"
         :publishing-function org-latex-publish-to-pdf
         :recursive t
         :with-toc nil
         :with-date nil
         :with-author nil
         )))

Additional info:
- I am using Emacs 29.4 (Org mode 9.6.15)
- I compile these file using the Debian/testing texlive-latex-* (2024.20240829-2) packages 
  (pdfTeX-1.40.26)
- I also tried compiling the PDF using `latexmk` (4.85) but the end result doesn't change

> 2. Second issue: Getting rid of link borders.
[...]

Thanks! Your suggestions gave me a few ideas to explore and this is now understood.

Best,