From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id OBEMCpnoaWMOlgAAbAwnHQ (envelope-from ) for ; Tue, 08 Nov 2022 06:26:49 +0100 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id WOrgCZnoaWNjkQAA9RJhRA (envelope-from ) for ; Tue, 08 Nov 2022 06:26:49 +0100 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 EDC2722291 for ; Tue, 8 Nov 2022 06:26:48 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1osH7o-0007Lc-2O; Tue, 08 Nov 2022 00:26:16 -0500 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 1osH7m-0007LH-Ig for emacs-orgmode@gnu.org; Tue, 08 Nov 2022 00:26:14 -0500 Received: from mout01.posteo.de ([185.67.36.65]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1osH7k-0000xw-Au for emacs-orgmode@gnu.org; Tue, 08 Nov 2022 00:26:14 -0500 Received: from submission (posteo.de [185.67.36.169]) by mout01.posteo.de (Postfix) with ESMTPS id 698BA240027 for ; Tue, 8 Nov 2022 06:26:09 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017; t=1667885169; bh=8YqdnJ6B+6iGTHxW6QnPkZIXGdzflPBiUo7jEK/kwL0=; h=From:To:Cc:Subject:Date:From; b=JxOdn5prHDTZASlv70ooR5NxLOC3/AhJPEqlyw71Q3B+fghtf0rzp9/0kUptRgn2l jQea4smrTNl36GcftzO5V6xT+rhE3YN9+jPFJ1R9879MW6yEHzG45WFe1+d8w5005/ 3rynIdEr6XbCTk9l9lpR/SiBzFhhyGarSk91EPV0fD6aCT3W2L0z9ZQ9KhZUmenNSN 7W+xRQCRC28BbliWoKrNI+9IFNFnfPn50luYwFB57UPTNgzIiXz+NaxRJjMHuExJXT F4emoBmlwOgUnuzmY2GbXCzsCSDBFgYlt6Dz1MRlg8rd8H+UclT8IISuKcMyQvgDxF kGHKIvLR2kn0Q== Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4N5xQm00mcz6tmB; Tue, 8 Nov 2022 06:26:07 +0100 (CET) From: Ihor Radchenko To: =?utf-8?Q?Andr=C3=A1s?= Simonyi Cc: emacs-orgmode list Subject: Re: [PATCH] oc-csl: Improve LaTeX bibliography formatting In-Reply-To: References: <87o7tja3ag.fsf@localhost> Date: Tue, 08 Nov 2022 05:26:46 +0000 Message-ID: <87sfiu10fd.fsf@localhost> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Received-SPF: pass client-ip=185.67.36.65; envelope-from=yantar92@posteo.net; helo=mout01.posteo.de X-Spam_score_int: -43 X-Spam_score: -4.4 X-Spam_bar: ---- X-Spam_report: (-4.4 / 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_DNSWL_MED=-2.3, 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 ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1667885209; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post:dkim-signature; bh=w1xnY+BgsxdelozahcwkGJU2ImU6G9s7SEzzRsPZZhA=; b=gnwHD5Bfyl+iTF43W0bLyDDavtfYDCDvnn4oQbT+u08aJaaqiILVgWsGxSl8ppcmbxWppP nmpohW/kwti8CN4EpgL9RZHkJj1/0L16KnM51UAeVxmlmhyhYxaffvMaMbU6VqMgURRJjZ hpmY+slV3XygXPF+2FRyF+kyErZqtbzmvg0cdlwvvmSG2hU/iPkfqbuchRZoiZxqTBiquj a30dpJWLjkMiX5OS7GbtmEnedXnfQtZ/kl7c5yO/2gbVocoVZ5PdCxZbeQUZLPqO1qXsWv L+bgJ7t5U2YWCCDTcwHGPqpoB8dpG2oqkYJ8KqHB1t+sI4xnnD7EP5lmCSbzEw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1667885209; a=rsa-sha256; cv=none; b=hCiP68x8RW3uBKe6rlFYeQ77v+CL4+SzHSxQPFetjEG6pvX+Rx+VgrykUHQlQ9k7H53h2a WdY1Su6kXpK7DyGGyDH/lKQsMROF0/G3x8MNlTHTe3YCAS+hMrntyXmDk0XCdOe7LWeVAK loALBwQaDMF6ByZEgcNAbjSvr/ZXefSKaD4RT8mN5vupJC8q89LH5TlWN5yqRKPFSjZ9BE AMogu0IYNmZnQQDy6PGC6p/82e7G/p1Bu+dK/ox4ZxNXVUHkUQAeL7pH1KMw121rzHOXHE DPBEp/PVmnv7x0pa5ChjXBpdwakJ1v+Z025LuZ+XJMPjaCUuzSNHTvTM4AZjOg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=posteo.net header.s=2017 header.b=JxOdn5pr; dmarc=pass (policy=none) header.from=posteo.net; 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" X-Migadu-Spam-Score: -3.51 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=posteo.net header.s=2017 header.b=JxOdn5pr; dmarc=pass (policy=none) header.from=posteo.net; 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" X-Migadu-Queue-Id: EDC2722291 X-Spam-Score: -3.51 X-Migadu-Scanner: scn1.migadu.com X-TUID: 2yOGivGydeJY Andr=C3=A1s Simonyi writes: >> Also, it would be nice to describe CSL usage and tweaks in the manual. > > Time permitting I may try to add something, but wouldn't it be a > problem if the CSL export processor was discussed in much more detail > than the others? > I was also thinking about providing a list of available citation > substyles but I do not want to make the manual very unbalanced. Maybe not in the release, but otherwise we need to finish the citation section of the manual one way or another. May as well start from CSL part. >> I have two comments here: >> 1. Where are all these new commands coming from? They are not used >> directly in the code. Are you tweaking citeproc.el output this way? M= ay >> it be better to use customizations provided by citeproc.el itself? > > Yes, the citeproc org-latex formatter, which I added specifically for > Org, uses these commands in the LaTeX code produced for the > bibliography. As citeproc doesn't have customizable variables by > design (if I recall correctly, the only exception is 2 hooks), and > oc-csl already had some variables concerned with very similar > formatting settings (org-cite-csl-latex-hanging-indent, > org-cite-csl-html-hanging-indent, > org-cite-csl-html-label-width-per-char) I think it is more consistent > to have the new ones also in Org. Thanks for the clarification. I'd prefer to see a similar explanation and the details about what the LaTeX variables/commands do in the docstring. >> 2. You are declaring this variable as defcustom, but it is not clear >> what is going to happen if the user changes it. It is not how to >> change this template in meaningful ways either. > > Right, I can try to detail a bit in the docstring what type of > commands and environments have to be provided by the preamble (are > expected by citeproc). I tried to follow Timothy's handling of the > ox-latex engraved preamble, but a simpler alternative would be to > treat it simply as a constant template, at least for the time being -- > WDYT? Note that `org-latex-engraved-preamble' explains which packages need to be loaded and which commands need to be defined in the preamble. This at least make it more clear what the users may change and not break the export. I see not problem keeping this a defcustom, but we definitely need to explain the default value and what is required to be in there. At least, to make the code readable for future contributors. --=20 Ihor Radchenko // yantar92, Org mode contributor, Learn more about Org mode at . Support Org development at , or support my work at