From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp10.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id cDRRCridtmIMjwAAbAwnHQ (envelope-from ) for ; Sat, 25 Jun 2022 07:31:36 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp10.migadu.com with LMTPS id WJFdCbidtmKgqQAAG6o9tA (envelope-from ) for ; Sat, 25 Jun 2022 07:31:36 +0200 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 B159BA75 for ; Sat, 25 Jun 2022 07:31:35 +0200 (CEST) Received: from localhost ([::1]:56318 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1o4yOM-0000L7-Ai for larch@yhetil.org; Sat, 25 Jun 2022 01:31:34 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:41212) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1o4yLE-0000Ky-MV for emacs-orgmode@gnu.org; Sat, 25 Jun 2022 01:28:20 -0400 Received: from mail-pf1-x42a.google.com ([2607:f8b0:4864:20::42a]:41475) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1o4yLC-00036b-Lc for emacs-orgmode@gnu.org; Sat, 25 Jun 2022 01:28:20 -0400 Received: by mail-pf1-x42a.google.com with SMTP id i64so4255234pfc.8 for ; Fri, 24 Jun 2022 22:28:18 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:in-reply-to:references:date:message-id :mime-version:content-transfer-encoding; bh=AC2oJvy4Z3EUEKPbdOlTun6HcRQv0b1CM+hJOoRgybU=; b=FOIj30Qjm8GjZnYozC43RroWu0hg/FDJxdPOojmnXoIDShiboMv2IjjXlnMhL4xCJa gfrzaAFh8nC72FEKM/Cd0uCtie2mVfnmNylwijIoS38pmgmHgtHq7gIU1F2KllFYM/e4 vWk8tKN+KzOf7hhuNoO/NI2ysel7pybuagbWVdRKsv8apmQ9cy5wGUBP01u6eo7KTNMX 4T8eeaTLjH0hu7n5OEEFuLEWeJi5WFArR9Aotg2+/A+XlbF+0c2WG+BTS0UcoHGnWs7g sxnW4frZSiz6VrxLj4nnf5oVaSN+nanKewIjs4EykNr9RoRzg73TTZ02aM0eW2Nzo1dA Dzug== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:in-reply-to:references:date :message-id:mime-version:content-transfer-encoding; bh=AC2oJvy4Z3EUEKPbdOlTun6HcRQv0b1CM+hJOoRgybU=; b=BavPcQQKYAFTJUnStBWQuOsIYwpOxxFy6slwTy9D3cI96B1To54bs7lM/r+SXLiOdC XpGBgO9tVpgwUv86WcAXt1g/G6iE+ZUSr8sSwycbzpmuYm4kRRKt/mFXpRHqTCsxZg1Z UQylvcsWnajP0hLGeOJsrOMoOpvZ0tPATCtWabH+hfm4gjiUrBBJuoD2s/CJZbQX1Ik9 wdZBv+oovp7zJWpuOaJHeLlv07BH7UpEb7Dd5jbrAf8pGIi935l7f3QYeNURwjlFRImD bM7CTxUAx7YjDKZ4TPLBANL6uJee+o0ZBg7EM3O+/QMDegSYopNOC/yx7jak7HS9ETiR d2HA== X-Gm-Message-State: AJIora/VjPCvF1GvF5fwRLpiDmfMbpZOMtWoFzwv1x6Ap42Eh8bhQdKb x74VRT4xWHj5wSM/FPeEYIRl68ympWWd+Uux X-Google-Smtp-Source: AGRyM1uWhgDm+To2yVm97XI6ix2XlSygpW+LMx0p+UxQd4IGc9hlLUQJXRDkbL25vt/lhPXJyhgVvg== X-Received: by 2002:a05:6a00:1150:b0:524:dd4e:dba2 with SMTP id b16-20020a056a00115000b00524dd4edba2mr2665234pfm.41.1656134897307; Fri, 24 Jun 2022 22:28:17 -0700 (PDT) Received: from localhost ([192.161.177.252]) by smtp.gmail.com with ESMTPSA id b188-20020a621bc5000000b0052580e77280sm1262787pfb.184.2022.06.24.22.28.15 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 24 Jun 2022 22:28:16 -0700 (PDT) From: Ihor Radchenko To: Max Nikulin Cc: emacs-orgmode@gnu.org Subject: Re: [BUG] manual: confusing example of adding attributes to a link (affiliated keywords) In-Reply-To: References: Date: Sat, 25 Jun 2022 13:29:29 +0800 Message-ID: <87zgi1ux8m.fsf@localhost> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Received-SPF: pass client-ip=2607:f8b0:4864:20::42a; envelope-from=yantar92@gmail.com; helo=mail-pf1-x42a.google.com X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 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_ENVFROM_END_DIGIT=0.25, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 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" X-Migadu-Flow: FLOW_IN X-Migadu-To: larch@yhetil.org X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1656135096; 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=AC2oJvy4Z3EUEKPbdOlTun6HcRQv0b1CM+hJOoRgybU=; b=TwiRibfbHNwUabny2QvnkwgHy0OUu6VsxUO3XNd4oBkllptbQ0NAH+rdezgwiZLWwlm3x5 2GZ3NChrkaKIOQP6ibJH5OUv0o160pAByoQoqPQ6v3lOgsarDPxPUYt/gLbQPr718iezqX AOaQbOz34a22+SSSN9DguAZsBK1aZbCO6BzCnVp8E+oRfCsRNN0p1oQcs4Czx4+IEbB8S1 oMzglxCEfAXE5obogdX6JOTrLdStSetE7ugwVKbHEyg0i+WX6+/p/b2FIpyw6k+F1vPPok s0Exe5L1OF42iqimbR4pzX+HI0JOwh9gIqz3br9sgHrnI0p9puZ0J+3A3ce62g== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1656135096; a=rsa-sha256; cv=none; b=Fu/tnXMIqSEbeiabINe8nEKluDEShRpYsFknJEcFdGNnNpKrj48gdUyickmIsyAPMIbtFo IH/NobOz+TRwknxawkbG3RaUOOz/tDZGUf8uAi0tsxDZ1eiohjUOmEgmEm5Se/C4sOuH4Y gpF46BlXMCLnMzX5ztOEVqlll719RKdoIVVSnqnm9/d1T0OZ/e1aBTbEHBgb2c9L3f3aNv ONLiMclUJZhjyDruLGO1oEyMvdzIUMBNMbIdTByc3HOLfqc/ZD+yxKVlrYaC0J9RS7JSC9 uFeOSF+dq8I8QJbmd/Sq28nOr3K54TW1dkmpgx7p+F+3Rxx0CYrYy3Vfc3TyIw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=FOIj30Qj; dmarc=pass (policy=none) header.from=gmail.com; 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.47 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=FOIj30Qj; dmarc=pass (policy=none) header.from=gmail.com; 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: B159BA75 X-Spam-Score: -3.47 X-Migadu-Scanner: scn1.migadu.com X-TUID: Ragz0BySs2qt Max Nikulin writes: > Org Manual in info "(org) Links in HTML export"=20 > https://orgmode.org/manual/Links-in-HTML-export.html has the following=20 > example: > >> Org files can also have special directives to the HTML export >> back-end. For example, by using =E2=80=98#+ATTR_HTML=E2=80=99 lines to s= pecify new >> format attributes to or tags. This example shows changing >> the link=E2=80=99s title and style: >>=20 >> #+ATTR_HTML: :title The Org mode homepage :style color:red; >> [[https://orgmode.org]] > > Likely I have seen similar suggestions in this list as well. > > Actually it assigns attribute to paragraphs in addition to links. That=20 > is why, I think, this fragment should be removed from manual as a=20 > confusing one since it gives impression of support of per-link attributes. Could we clarify that the attributes will apply to the paragraph instead? > It states that styles and similar stuff may solve the issue with=20 > attributes for inline objects. From my point of view it is wrong and in=20 > some cases per-object attributes are necessary. While noreferrer" href=3D"..."> or may be ad= ded=20 > through style, attributes like "alt" for images, "title", "lang", etc.=20 > for links are individual. You examples are pretty much dedicated to html. Do you know if per-object attributes could be actually useful for other export backends? Best, Ihor