From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2.migadu.com ([2001:41d0:303:e16b::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms13.migadu.com with LMTPS id +KNkJw0fDGcF6AAAe85BDQ:P1 (envelope-from ) for ; Sun, 13 Oct 2024 19:27:09 +0000 Received: from aspmx1.migadu.com ([2001:41d0:303:e16b::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2.migadu.com with LMTPS id +KNkJw0fDGcF6AAAe85BDQ (envelope-from ) for ; Sun, 13 Oct 2024 21:27:09 +0200 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=city17.xyz header.s=dkim header.b=fX5kXrBU; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org"; dmarc=pass (policy=reject) header.from=city17.xyz ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1728847629; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding:list-id:list-help: list-unsubscribe:list-subscribe:list-post:dkim-signature; bh=SaIMK0tUVVHqdLpb7ntwLTM3IrdNWt6MmmEcuhtbyv0=; b=UoGQ0pWHg5TpWjfUff7qXRFdKOgV+yfYxHDkx5L2xxPrDNfHSKzBSaNykB5tu7UmFT4PDl 7szDuk3NMf6Ix6YJwJRvpySqmvEGQUPjpUJZIkVyWitBjuSOdyi1ovYwiAlE57r6kH81y/ WBwTYITjKgRthUowNvuCLNMRaP2NQi1Ay5UtEK4ScSfskFYWctuxk/cEowxy0v5pfjSqm2 G7z1VpvImrMMw8Y93RUwuwXZcmuFNCwOAcXSRVKP+MzqKxNx8QFLFhLFBk9asrqep7pYxo d14g5MM/y4N7ontIpMRT5TzIZMWyPshhLzcUYJEZYcLrH9Ezj5wnctjlThuUlw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1728847629; a=rsa-sha256; cv=none; b=d4wZ1aMwcplCD5lWgeSykW5wCYJsG/IjshUW1N0AtqkccBy7ZZOiEm6oKpNiOYRXlUeAD9 VPtyhgcuUQy89iWPmVeJAHz5MGGNL6LbK0U/9O2NZ6RmxVEUCGcEPclKo/oV+GKniVIrfy NGz/DowPLtjMqzigPukTGk0kV6KwHk4qlWCxKuDMKjZI5I3MM3GmpLVWa8fAfFCXRyQjsF mLqHs2usm4LUpTAEQrc4zw/4dAm7Nr5zUGmDzfjt1Y0ZGkW0y5T+IKOPWx1578i1OU17hY NPskzct4khbePpnkXO92PhufVS8WpdVGht/30c8J5Uri1jRnSZVDrMYqq2GwDg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=city17.xyz header.s=dkim header.b=fX5kXrBU; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org"; dmarc=pass (policy=reject) header.from=city17.xyz Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id EB2005C646 for ; Sun, 13 Oct 2024 21:27:08 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1t04EU-0004C7-7Q; Sun, 13 Oct 2024 15:26:26 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1t04EC-00047c-R0 for emacs-orgmode@gnu.org; Sun, 13 Oct 2024 15:26:10 -0400 Received: from mail.city17.xyz ([45.91.101.53]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1t04E6-0000lc-OR for emacs-orgmode@gnu.org; Sun, 13 Oct 2024 15:26:07 -0400 Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id DDB1B4E26F for ; Sun, 13 Oct 2024 21:25:53 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=city17.xyz; s=dkim; t=1728847554; h=from:subject:date:message-id:to:mime-version:content-type: content-transfer-encoding; bh=SaIMK0tUVVHqdLpb7ntwLTM3IrdNWt6MmmEcuhtbyv0=; b=fX5kXrBU5KOE5gruYpAhPVAoxCTxJ8sPiMykjOhbNqRPlrNWv2okSlhQ9OPPbB8GHxoLHW nmFm3oRQ/nP3g0Jq0bIqXHCjxJa5UNOOMOz7CWf34X4SsaObIRkm4dVdZf5INkQVV2Q7v+ i2liotaTEnSE1THkBr8f1JC8jVtDPG5PR0b8iFJkav6oDCSMr1Q8Nm/bsjMwEewiD0ib0B uEKbJtOnOs6mMHZJKrkY8bO8Wo6LMwdF4WVX9vWZsywzNoAodGQDW3+5R+8hUM4GI63TGX 6yF1/DPhK9kCJueHsPy6S4plxCIb3YFGMJQj/wSl8/dTNXSlUrXbQ6Lxiz8DXA== From: jman To: Emacs orgmode Subject: Understanding Publish (ox-publish.el) Date: Sun, 13 Oct 2024 21:25:53 +0200 Message-ID: <871q0j3iv2.fsf@city17.xyz> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: quoted-printable X-Last-TLS-Session-Version: TLSv1.3 Received-SPF: pass client-ip=45.91.101.53; envelope-from=emacs-orgmode@city17.xyz; helo=mail.city17.xyz X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-orgmode@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: emacs-orgmode-bounces+larch=yhetil.org@gnu.org X-Migadu-Flow: FLOW_IN X-Migadu-Country: US X-Migadu-Spam-Score: -2.81 X-Spam-Score: -2.81 X-Migadu-Queue-Id: EB2005C646 X-Migadu-Scanner: mx13.migadu.com X-TUID: nN/DFkQMRClB Hello, I'm trying to learn more about the publish export option or Org mode. Speci= fically I am using the=20 function `org-latex-publish-to-pdf` to export Orgmode files into PDF. Since this export backend is transparently using Latex, there is stuff goin= g on behind my back that=20 makes it a bit difficult debugging or customizing the formatting. My header in the Orgmode file started as simple as: #+TITLE: Title of the document #+OPTIONS: toc:nil date:nil author:nil #+latex_header: \usepackage[a4paper,top=3D4cm,bottom=3D4cm]{geometry} The Orgmode file is nothing but a long ordered list of items: * Title ** Subtitle (Lots of text) ** Subtlte II * Title II (Lots of text) ... more ... and so on. After compiling to PDF, I learn that the default "template" (how= is it called in Latex=20 lingo? `\documentclass`?) used by `org-latex-publish-to-pdf` does not handl= e content exceeding the=20 page length so I have to manually add some page breaks, clearly a hack: * Title ** Subtitle (Lots of text) #+latex: \clearpage ** Subtlte II #+latex: \clearpage * Title II (Lots of text) ... more ... Why isn't this handled automatically for me? Is there a setting I should ad= d in the org file? What's=20 the default template used by `org-latex-publish-to-pdf`? Second issue: I want hyperlinks to other documents to not have a border. On= Latex the solution seems=20 to use the hyperref package: +latex_header: \usepackage[hidelinks]{hyperref} again, compiling triggers this error: ! LaTeX Error: Option clash for package hyperref. This error hints at some defaults I cannot see, making the document customi= zation difficult. Where=20 are these defaults? How can I get a feeling of what's happening when using this PDF publish opt= ion? I think I need a bit=20 of a high-level overview, hope the author David O=E2=80=99Toole is around f= or some support :-) Ideally I'm looking into a simple way to export from Orgmode to PDF, withou= t needing to learn Latex. Thank you for suggestions, ideas, etc. Best,