From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms11 with LMTPS id eAFcOemzml7AKgAA0tVLHw (envelope-from ) for ; Sat, 18 Apr 2020 08:01:45 +0000 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2 with LMTPS id YJSdBO6zml70bgAAB5/wlQ (envelope-from ) for ; Sat, 18 Apr 2020 08:01:50 +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 9BA2D941E9F for ; Sat, 18 Apr 2020 08:01:49 +0000 (UTC) Received: from localhost ([::1]:55756 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jPiQ7-0002E4-Qx for larch@yhetil.org; Sat, 18 Apr 2020 04:01:47 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:46103) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jPiOg-0002D5-EC for emacs-orgmode@gnu.org; Sat, 18 Apr 2020 04:00:19 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1jPiOd-0003um-RC for emacs-orgmode@gnu.org; Sat, 18 Apr 2020 04:00:17 -0400 Received: from relay1-d.mail.gandi.net ([217.70.183.193]:22171) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1jPiOd-0003cz-KF for emacs-orgmode@gnu.org; Sat, 18 Apr 2020 04:00:15 -0400 X-Originating-IP: 185.131.40.67 Received: from localhost (40-67.ipv4.commingeshautdebit.fr [185.131.40.67]) (Authenticated sender: admin@nicolasgoaziou.fr) by relay1-d.mail.gandi.net (Postfix) with ESMTPSA id B64E824000D; Sat, 18 Apr 2020 08:00:11 +0000 (UTC) From: Nicolas Goaziou To: Brian Powell Subject: Re: Inconsistent use of \ref and \eqref in ox-latex and ox-html References: Mail-Followup-To: Brian Powell , emacs-orgmode@gnu.org Date: Sat, 18 Apr 2020 10:00:10 +0200 In-Reply-To: (Brian Powell's message of "Fri, 10 Apr 2020 11:56:35 -1000") Message-ID: <87h7xhxlyt.fsf@nicolasgoaziou.fr> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.3 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 217.70.183.193 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: , Cc: emacs-orgmode@gnu.org Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: "Emacs-orgmode" X-Scanner: scn0 X-Spam-Score: -1.11 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=none; 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-Scan-Result: default: False [-1.11 / 13.00]; RCVD_VIA_SMTP_AUTH(0.00)[]; GENERIC_REPUTATION(0.00)[-0.57468437884801]; HAS_XOIP(0.00)[]; TO_DN_SOME(0.00)[]; R_SPF_ALLOW(-0.20)[+ip4:209.51.188.0/24:c]; IP_REPUTATION_HAM(0.00)[asn: 22989(0.25), country: US(-0.01), ip: 209.51.188.17(-0.57)]; MX_GOOD(-0.50)[cached: eggs.gnu.org]; RCPT_COUNT_TWO(0.00)[2]; MAILLIST(-0.20)[mailman]; FORGED_RECIPIENTS_MAILLIST(0.00)[]; RCVD_IN_DNSWL_LOW(-0.10)[209.51.188.17:from]; RCVD_TLS_LAST(0.00)[]; R_DKIM_NA(0.00)[]; ASN(0.00)[asn:22989, ipnet:209.51.188.0/24, country:US]; MID_RHS_MATCH_FROM(0.00)[]; TAGGED_FROM(0.00)[larch=yhetil.org]; ARC_NA(0.00)[]; RCVD_COUNT_FIVE(0.00)[6]; FROM_NEQ_ENVFROM(0.00)[mail@nicolasgoaziou.fr,emacs-orgmode-bounces@gnu.org]; FROM_HAS_DN(0.00)[]; URIBL_BLOCKED(0.00)[hawaii.edu:email]; MIME_GOOD(-0.10)[text/plain]; MIME_TRACE(0.00)[0:+]; DMARC_NA(0.00)[nicolasgoaziou.fr]; HAS_LIST_UNSUB(-0.01)[]; FORGED_SENDER_MAILLIST(0.00)[] X-TUID: rsgxGmURaeZR Hello, Brian Powell writes: > The issue is that when exporting equation numbers with ox-html, it uses MathJax's \eqref that wraps the equation in parentheses, for example: > > "Refer to (3) for more." > > However, when exporting the same document with ox-latex, it uses Latex's \ref that does not wrap the equation in parentheses. Would it be possible to add an option or variable to ox-html for the user to select whether to use \ref or \eqref on export? > > For those of us that publish to HTML and PDF, it is very difficult because you end up with either double or no parentheses. > > My proposed fix would be a change to ox-html from: > > (format "\\eqref{%s}" > (org-export-get-reference destination info)) > > to > > (format (if org-html-export-mathjax-ref "\\ref{%s}" "\\eqref{%s}") > (org-export-get-reference destination info)) > > The variable org-html-export-mathjax-ref is non-nil to use \ref vs. > nil to be the default \eqref. The variable could be more general, e.g., org-html-export-equation-reference-format, and default to "\\ref{%s}". Note the export back-ends do not use variables directly. It would be (format (plist-get info :html-equation-reference-format) (org-export-get-reference destination info)) where the correspondence between :html-equation-reference-format is set in back-end definition. Also, it needs to be referenced in "HTML specific properties" section of the manual. Would you want to propose a patch ? Regards, -- Nicolas Goaziou