From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2 ([2001:41d0:2:bcc0::]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id cBDSNDBeYmDRJgAAgWs5BA (envelope-from ) for ; Tue, 30 Mar 2021 01:09:36 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2 with LMTPS id gATALjBeYmCPVwAAB5/wlQ (envelope-from ) for ; Mon, 29 Mar 2021 23:09:36 +0000 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 03E91E227 for ; Tue, 30 Mar 2021 01:09:36 +0200 (CEST) Received: from localhost ([::1]:48914 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lR10o-0008FK-V7 for larch@yhetil.org; Mon, 29 Mar 2021 19:09:34 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:54952) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lR10J-0008FC-EZ for emacs-orgmode@gnu.org; Mon, 29 Mar 2021 19:09:03 -0400 Received: from mail-pf1-x430.google.com ([2607:f8b0:4864:20::430]:33684) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lR10E-0000Mu-SM for emacs-orgmode@gnu.org; Mon, 29 Mar 2021 19:09:03 -0400 Received: by mail-pf1-x430.google.com with SMTP id x26so10906771pfn.0 for ; Mon, 29 Mar 2021 16:08:57 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=references:user-agent:from:to:subject:date:in-reply-to:message-id :mime-version; bh=qCE1cTgYsspLlS8WWweFO08URdttGZHNjUvY04FZid0=; b=OsTLH79ldFyJ0LaT2p0Ju2oad8WpdBcBmrbj1oGgQjKOpvu+tUT4lCfGTJIbr4zuFF 7YxieBoMQbpvlwkwrASVSWNYP9DCJC9scGpkSvcD0w/39+B7vOecjjfHuUos8Tov8eVr yD7i4XyaCoCPQHgXG9VwD6JOstZBgvvDVyjtjJCBLeKyGdopFEg+4nwck+RSq/JiHGbj RccPWrPrbxNlSGHGIXbufE2X+s5WIGD//eaMjmKzG/aWupDGfm9TqBAhVDmafutOrqpD e/Gqz2yBFzuUmsUt7shFR6yGvA+oJDmmYgfceotdIRYELneqlZEuWV1yv/+CiIaDw5Hr Qdvg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:references:user-agent:from:to:subject:date :in-reply-to:message-id:mime-version; bh=qCE1cTgYsspLlS8WWweFO08URdttGZHNjUvY04FZid0=; b=m1xbvv1/CVbQlACoetTJDiIH/eTAp/JFDyv7igLuCzxS6hcV3+5XyuUUubH5uZ7YeS M/NSV/14aRZ9GkBI6nWv/8pedDBzW5aVNijCf6huuGUa4jq5d7wmgLnljCj+2MvjFM8G lKfau82OdtiKevXPQQncjK+W0UIxktl+4oUf4g4/YjAg6Jbo/hfQHtSb7sgLhaWz6fG3 4+aDnShBhp/8tRsmROJhSdFIRTNk6ykJDcLRDMun7Rz5FMYQ4svuybX6YoWY9b3gjdGQ dGGC5YLEcVg1HeJyEKa9+DHIgRQI1HNvR7KVSEm1HA5ke9Q+SrhREDuNH1v0xY579yfZ I9ZA== X-Gm-Message-State: AOAM533bdzS5JvJWLdEIl31JP5/AHpAftM9hMrman+Btz9gSettnw96A Tif4eXoviQb5NEJLYpK46qG6bV1PmpQ= X-Google-Smtp-Source: ABdhPJzv9zdxk+NOnnzGiw8c21YFyxn8ysq3fGKJga5PkrEz8q8MIcYk0hT+A+85dmFqi/ENHG4zFg== X-Received: by 2002:a63:6d4e:: with SMTP id i75mr25484119pgc.97.1617059336582; Mon, 29 Mar 2021 16:08:56 -0700 (PDT) Received: from tim-desktop (106-69-141-46.dyn.iinet.net.au. [106.69.141.46]) by smtp.gmail.com with ESMTPSA id y29sm18259979pfp.206.2021.03.29.16.08.54 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 29 Mar 2021 16:08:56 -0700 (PDT) References: <88a3facd-2f95-42b7-135a-d2ec6a730ba7@gmail.com> User-agent: mu4e 1.5.11; emacs 27.2.50 From: Tim Cross To: emacs-orgmode@gnu.org Subject: Re: About exporting Date: Tue, 30 Mar 2021 09:06:28 +1100 In-reply-to: <88a3facd-2f95-42b7-135a-d2ec6a730ba7@gmail.com> Message-ID: <87v999fth8.fsf@gmail.com> MIME-Version: 1.0 Content-Type: text/plain Received-SPF: pass client-ip=2607:f8b0:4864:20::430; envelope-from=theophilusx@gmail.com; helo=mail-pf1-x430.google.com 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, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, 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.23 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" X-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1617059376; 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:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=qCE1cTgYsspLlS8WWweFO08URdttGZHNjUvY04FZid0=; b=Hki3/HQm9KoEsXpwcxP1jJYPw2qyFfvgvjhxxviHcC+zOsKCGZ576cR78oItDjiShNZaBc PIM4Ous0C0S61A97Ph+7CigXSTjRavWcODN2T8FrY6ZinJygpLhoesafcuO0tf0wCVNzel QuQnCAcDilosQ9LvusI3KwZ5jOqm853OIQ93BU1g3dGR5M41YcgTPU+2GbXspi6cjlYH+E zqINKy1L/8pgbpV9hhMY5+PTRULlPdgXlLDJhYwBI19UiLA4bLKs3I5F1i6rd/gwWwVn3F dmzwFnCWVV0jHSEloSQSh57pdt/DUisPTjQuusWswU0I1QvERnYVlqOW57Oi2w== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1617059376; a=rsa-sha256; cv=none; b=PuD1imwqU+Axg92iYbwwh2bAriMZcQLRnUNkeDXGY/KnYyT/vwWWk0iE6azEwKL36kiN/L VZjT3egzg/R+n0IHviXwhrnaWTcmlcHFra4YRUBXW3UbxsuoNTGzR/padqDbDYPO6GsG9O kSvCnXWGCb1W1qPiEcwjgUr9kFjiARwcm3Zxep4NtjtPoS0KBb4HdO16bPtT+DdRariHeR 8hbC9c2GSsibMg7QmIraIjojYmoO/n1ROY9CjssVVAJxG56a6f0WGaKAqno592caTgR9v3 9CiZjs4YouWt2x727gRgbomyCbLUYUsIDhBTQ60TLrCLsrXWKwHpW/KiI0jIQQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20161025 header.b=OsTLH79l; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of emacs-orgmode-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=emacs-orgmode-bounces@gnu.org X-Migadu-Spam-Score: -1.62 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20161025 header.b=OsTLH79l; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of emacs-orgmode-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=emacs-orgmode-bounces@gnu.org X-Migadu-Queue-Id: 03E91E227 X-Spam-Score: -1.62 X-Migadu-Scanner: scn0.migadu.com X-TUID: ew/sQBrVDKTk Ypo writes: > Hi > > After some years of using orgmode, and exporting using its defaults, I would like to take a quality leap and find a way of exporting for life. My options: > LaTeX, ODT, HTML. > Forget your goal. Technology and user expectations moves too fast and you will never find a solution 'for life' in the sense you mean. More important is to learn how to adapt and change. > LaTeX: I can see some masters here that make professional books, and I have some friends that publish scientific papers using LaTeX. But, it looks like a > like a rabbit hole to me, since even the masters seem to have to modify the tex file directly (is this correct?), not being sufficient orgmode to culminate > the work by itself. And to learn LaTeX seems a lifelong activity (almost like "learning" orgmode). BTW, when I export to LaTeX although it gets the job > done, it sends a lot of error messages. > I've been using Latex since 1990 and it hasn't changed much. The two biggest mistakes I see people make all the time with Latex are - 1. Trying to heavily customize document format using Latex and Tex macros and low level Latex/Tex commands instead of using available packages to modify the output in a consistent manner. 2. Breaking the 'word' habit of believing your a typsetting expert and need to tweak margins, line spacing, headers, list indentation, etc etc. Your not a typsetting expert (at least most of us are not) and your far better off trusting those who write the packages. Reality is, very few of us have the expertise to know what a well formatted and typeset document actually looks like. It is actually a complex skill with lots of subtleties and pitfalls. Problem is, we have been swamped by poor document formatting due to programs like MS Word and grown to accept the poor practices it exhibits. Latex itself is actually very easy with only a few commands. It only gets complex when you try to work at a very low level and even that complexity is mainly because it looks unusual with what is considered these days to be a weird syntax. In 30 years of use, I've hardly done any Latex or Tex, rarely used Latex macros and have never had to write more than a line or two of Latex or Tex code. With very few exceptions, whenever I wanted something, it has almost certainly been done by someone else and all I really need to do is add a package and configure it. The trick with Latex is to go with the flow, not against it. When you do find areas of the default document style you don't like, look for packages to adjust the formatting rather than try to tweak it yourself. For example, nearly everyone will want to adjust the page margins. don't try to do this by using low level Latex commands to adjust line length, paragraph width, line spacing etc. Instead, use a package like the geometry package. If you want additional options for tables or modify how tables look, try some of the many available table formatting packages. If you simply don't like the default document style, then look into the various other document style packages that are available. What you end up with is one or two sets of 'default' packages which generate the documents formatted how you want. It may take some initial research to find these, but once you have them, you will very rarely need to do any tweaking. Once you know which packages you want and have your 'sets', then you can modify your org configuration to use those packages. for example, I have latex 'classes' defined in my org config for work, technical documents, letters, beamer presentations, general documentation and default. I select which one I want by adding the #+LATEX_CLASS: option at the top of the document. The 'work' group is a highly custom document which includes logo and colour which make my documents conform to the document style policy where I work, technical documents use the HiTech package, general documents use the koma-script document format and default uses the default Latex format. I rarely have to modify the *.tex files generated in exports - like maybe once or twice in a year and I produce quite a lot of documents. The hardest one to get working was the work class, but that was because the policy was rather complex regarding colours, logo size and position, margin, line spacing, font, hyperlink colour/font etc. Once I got it working though, it has not required modification until the policy is modified. With respect to errors from Latex when crating your documents. A lot of those are probably better classified as warnings rather than errors. Latex will tell you when you have things like long words it cannot hyphenate well and when it cannot determine when/where to break a line to avoid an 'overfilled' element. Often these can be ignored. However, sometimes, you may need to give Latex a 'hint' or helping hand by slightly modifying your content (for example, a table with a column which is too wide may need you to manually add line breaks or an included image may need some size hints etc. > ODT: I take this one as a lower level solution than LaTeX, but it looks easier to tame, and it even allows to use templates, for example to make reports in > the workplace. Do you think it is worth focusing on ODT exporting? Could it be a definitive solution to publish papers and books directly from orgmode? > ODT exporting sends some error message to me, but at least I understand it. > I've never liked the ODT output. I find the documents I produce using ODT to be 'uglier' than those with Latex. However, if I need to produce the document in a format which allows others to edit it, ODT can be useful. > HTML: I have seen some themes designed to export in LaTeX format using HTML. Here we would have the "definitive tool": The power of LaTeX in the > versatility that could give the use of different themes for different purposes. But, do you think it could get, some day, the quality of a direct LaTeX export? > No errors by my side when exporting to HTML. > No, because they serve different purposes. Latex is superior in every way when it comes to producing a PDF or a printed document. HTML is superior when you want to display the content in a browser. HTML is terrible when you want to print the output. I think it is a mistake to try and just focus on one export format. The great benefit of org mode is that you can export in multiple formats with minimal or no changes to the source. If you need to export in a format which will allow others to edit the document, ODT is great, if you need to export to publish on the web, HTML, if you need a PDF Latex, if you need a presentation, either beamer or something like reveal. They all have a role to play. A better use of time is getting to know org and how it can be configured so that you can setup your export environments with defaults which suit your requirements. When I see people modifying *.tex files generated by org, it is often because they have not worked out how to add the additional packages or set the configuration for those packages in org. -- Tim Cross