From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.text.pandoc/19469 Path: news.gmane.org!.POSTED!not-for-mail From: Daniel Staal Newsgroups: gmane.text.pandoc Subject: Re: Reference links / label vs title Date: Wed, 7 Feb 2018 10:49:36 -0500 Message-ID: <14690b10-3aa6-7f6b-6678-18c0def43d55@usa.net> References: <78db5f71-ac0e-4b1e-982d-40c0b9a59b84@googlegroups.com> Reply-To: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8"; format=flowed Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1518018481 18198 195.159.176.226 (7 Feb 2018 15:48:01 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Wed, 7 Feb 2018 15:48:01 +0000 (UTC) User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.13; rv:52.0) Gecko/20100101 Thunderbird/52.6.0 To: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org Original-X-From: pandoc-discuss+bncBCGYLPE23UARBEOA5TJQKGQEBM5LU7Q-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org Wed Feb 07 16:47:57 2018 Return-path: Envelope-to: gtp-pandoc-discuss@m.gmane.org Original-Received: from mail-it0-f58.google.com ([209.85.214.58]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ejRwb-000322-4y for gtp-pandoc-discuss@m.gmane.org; Wed, 07 Feb 2018 16:47:33 +0100 Original-Received: by mail-it0-f58.google.com with SMTP id e64sf2170445itd.1 for ; Wed, 07 Feb 2018 07:49:39 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1518018578; cv=pass; d=google.com; s=arc-20160816; b=H8LuHi6UKo1B8It/0ACLh6+FOluZUnUaYUn2deFMHuCFJ/xiG6CrLa0+J/Hai6nFFF +vlPyHgYCba7eaBbyr+3neXLocKPrdBCpDMiCvxKHmEgvdH8x9rXIJQJFgByoL1PAOe6 5HAZtOBjyw0dxHSer/veamCcFHKnK2e0X9BnFbL+l7Ek9m+YksyGKciIPjGxIVWxdMoR GwXZvGAx5Cu372gfxTsT3UDS3RIpfyJBa+FTqdMgwBGf6Re7BtmMy3NeAU9/ARtgq1UT vbsVZ/BqNE2T5RYXBfttqvF9TdIlvW9peRsBPYNmrUtbPxptpuvKUStJ+0n7lQFUEPLJ G7Nw== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :list-id:mailing-list:precedence:reply-to:content-transfer-encoding :content-language:in-reply-to:mime-version:user-agent:date :message-id:from:references:to:subject:arc-authentication-results :arc-message-signature:sender:dkim-signature :arc-authentication-results; bh=AlDss14Y+wh/r118yuVtCkdGeali01p/kDpBlnmjLCQ=; b=fLv7hxnYlboNqIdHj36p69v7LdZyH6Tf94rOvttlGJC6dDIoqTjN0C6/gS2MF3D2Yi xoGCyZMGgqFKP1IxREA3Tq/2YrgElyX4ZWDi6ELi5+pmFTKLbBBY3HzGSOt0fqGvNGWM lrW45IFk3E+8D7xRR2EQUaZxlT9GPES2uTEZmPXu2BfN06+NdohQ+qWORPiuo/ahTsYY LyplWaH9ec+8q9wFJqlFF91Y2WFbOMYTc17+Qg6bdzd0XCBMgzKNdvIqLNHyIJR2V1dR DuBRp8kfc98r7apZCfAg9JZmfewkH6Gw36LdpqPjdNk/Y ARC-Authentication-Results: i=2; gmr-mx.google.com; spf=neutral (google.com: 71.191.170.84 is neither permitted nor denied by domain of dstaal-Jdbf3xiKgS8@public.gmane.org) smtp.mailfrom=DStaal-Jdbf3xiKgS8@public.gmane.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=usa.net DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlegroups.com; s=20161025; h=sender:subject:to:references:from:message-id:date:user-agent :mime-version:in-reply-to:content-language:content-transfer-encoding :x-original-sender:x-original-authentication-results:reply-to :precedence:mailing-list:list-id:list-post:list-help:list-archive :list-subscribe:list-unsubscribe; bh=AlDss14Y+wh/r118yuVtCkdGeali01p/kDpBlnmjLCQ=; b=MtfvXksgWajJx0OitFdpBlF4eS3oa8Rpzc16Iz79OMq6AJRtTMKbhClPNRVxtbsH7G Ka95AxahKZi8fYxGdoVUWg+Oos1jpWb9aY9m8P8ruD6rjlOSaqNhzgZlQptVkk4c4YmQ A1awOLn6/nkh6ETS8IYzmKr0eTdXyGQaNzz2XBY2E4J3o1r7fFdx0JH0287GtBBzw6aO uYurwWIqLrYD1MYRA2z1NRr08spOqHStd9zUsJDb+FAwI/PQ0NTqgpuc0+rySt9h9xu+ buLANRuThAk+dluvaXrGbykJInqy1cR06m1pfMX9uQjfZAF1UCZQf4LOI9RAZHtI16Gx gb1w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=sender:x-gm-message-state:subject:to:references:from:message-id :date:user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding:x-original-sender :x-original-authentication-results:reply-to:precedence:mailing-list :list-id:x-spam-checked-in-group:list-post:list-help:list-archive :list-subscribe:list-unsubscribe; bh=AlDss14Y+wh/r118yuVtCkdGeali01p/kDpBlnmjLCQ=; b=fak0EFnfRmtz7c0Wf7QIuNDLBgcSUh04xCF7bjAFA/HKIwOXZUgmve1Ua1q+rlKnqO 2K1/HWCHA5oPXtPVXJL8MrEg3ZMyM0ArnWpl5+B8LMfgqLsafGeb3coGrw4ra8o9bY3x 7TA0nGZnxPqo7m+yJB3Up56r8OLBl/nbCpG6jxLYRPF9bNe51hOmmyAQYUHYjFiRM2UI QUhY28Hw1Q+Ih5B7ZGJYfPPCNuvqox5JJaM51YrHInNIBaPCy4eFlkPOj30a5a8ZYk9v QpJZR//RzOhqPlL/PgPoREqETB8mxaySx/k3 Original-Sender: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org X-Gm-Message-State: APf1xPASF4AblnNU7IVxBeyoptELO62YbUBDO92quidJjRdV9Vti1o/Z DJKVbcaI+j2gsaMBii5hvu4= X-Google-Smtp-Source: AH8x2265b5oTB71g1G3g+2pchLEAHxvtYMRFSZ2RLEOOrsLrAsmwZQOOG5O/oZpm9wNBbBf8TZFGXg== X-Received: by 10.36.25.143 with SMTP id b137mr120955itb.2.1518018578491; Wed, 07 Feb 2018 07:49:38 -0800 (PST) X-BeenThere: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org Original-Received: by 10.99.119.65 with SMTP id s62ls474110pgc.3.gmail; Wed, 07 Feb 2018 07:49:37 -0800 (PST) X-Received: by 10.99.115.69 with SMTP id d5mr1131414pgn.127.1518018577143; Wed, 07 Feb 2018 07:49:37 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1518018577; cv=none; d=google.com; s=arc-20160816; b=TOJGwjyzsmGmsXjJyCllS4oSGAISmgygH4sOoq11zDOPIAw7EPmLC1YoyTvnfzRgEU XqOsCGOtxzLy20dlKWlz3d253RPwwomg0PmaWCkQEiWAZ1J0g2gWVJXeDWP/1WKGWI7E bTYDL3sJPQ0o2m0BfGAEFpoSH+RwQ4AKmfxGTWfLN0LUgp8OFrs1m83bAUA5WorxZk9Q k7+uueYZMxNb+6QA8/aEucdZfS9dRHOitpPkorCEbLfGvMvItXi+QRTByR88GotrBzfl wmi6ETfRzLRb23zXKy2al+0T5CScp38xTVp2n4NAA0mZSbxLJTb3RHVjfGtfw6CFmwHc oGWQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:content-language:in-reply-to:mime-version :user-agent:date:message-id:from:references:to:subject :arc-authentication-results; bh=UpGe/luyPQKsROYjZm95n4TT6iLTbmWODMTnxUZb6Wc=; b=CGPZLoYmqkOCCvFKTzTLaovpHTBgqqA93I4oRX+LntuMNTpyl+3pu/7BpNxzu3Z8SQ vyPUbFyjcdxfi1o2EFN/Pb8DnLKfjZwUydKjIug0l5zBh+CsWnsD1jLdkHhdLy2sprK1 ZWrn9o17pdqmNSpPg3vrpmwzSk5DckBIMrfHgNZjh1pIOw7VG/3P3PI/7kgEyDuI2WWT 7pBr6d7IUW8N7zIUZ2sQtNvW+XncaoiVcDcWl+LAJUSMXLE0TvVpeJDP4Nmbz/hzd44C nbE+xYjqKOdWwbuV+wczWAWWybxLEb7KBxA+oXVltAl7pRLE9tDD0BqfRravG9gAjvTe LP/A== ARC-Authentication-Results: i=1; gmr-mx.google.com; spf=neutral (google.com: 71.191.170.84 is neither permitted nor denied by domain of dstaal-Jdbf3xiKgS8@public.gmane.org) smtp.mailfrom=DStaal-Jdbf3xiKgS8@public.gmane.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=usa.net Original-Received: from mail.magehandbook.com (static-71-191-170-84.washdc.fios.verizon.net. [71.191.170.84]) by gmr-mx.google.com with ESMTP id m193si43954pga.5.2018.02.07.07.49.37 for ; Wed, 07 Feb 2018 07:49:37 -0800 (PST) Received-SPF: neutral (google.com: 71.191.170.84 is neither permitted nor denied by domain of dstaal-Jdbf3xiKgS8@public.gmane.org) client-ip=71.191.170.84; Original-Received: from Daniels-MacBook-Pro.local (unknown [192.168.1.164]) by mail.magehandbook.com (Postfix) with ESMTP id 3zc5Nw24WGzZs for ; Wed, 7 Feb 2018 10:49:36 -0500 (EST) In-Reply-To: <78db5f71-ac0e-4b1e-982d-40c0b9a59b84-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org> Content-Language: en-US X-Original-Sender: DStaal-Jdbf3xiKgS8@public.gmane.org X-Original-Authentication-Results: gmr-mx.google.com; spf=neutral (google.com: 71.191.170.84 is neither permitted nor denied by domain of dstaal-Jdbf3xiKgS8@public.gmane.org) smtp.mailfrom=DStaal-Jdbf3xiKgS8@public.gmane.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=usa.net Precedence: list Mailing-list: list pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org; contact pandoc-discuss+owners-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org List-ID: X-Spam-Checked-In-Group: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org X-Google-Group-Id: 1007024079513 List-Post: , List-Help: , List-Archive: , List-Unsubscribe: , Xref: news.gmane.org gmane.text.pandoc:19469 Archived-At: On 2/4/18 11:40 PM, JM Marcastel wrote: > Reference links allow for reusability of links. The denomination (or=20 > title) associated with the link differs from one context to another. A=20 > typical example is when referencing multiple URLs that pertain to a same= =20 > subject. Giving a consistent naming convention, that provides both a=20 > visually pleasant and compliant to regular writing conventions in=20 > whatever language your Markdown text is written, can be quite challenging= . >=20 > As an example, I often keep track of software I am interested in. I=20 > have, within a same Markdown document, a table where I keep track of=20 > home pages, GitHub repository, latest release, etc. Elsewhere is the=20 > Markdown document I may discuss a given software, sometimes referring to= =20 > its home page, and sometimes referring to its GitHub repository. Take=20 > the example of Pandoc: >=20 > | > [pandoc-ws]:https://pandoc.org "Pandoc" > [pandoc-gh]:https://github.com/jgm/pandoc "Pandoc" > | >=20 >=20 > Displaying pandoc-gb =C2=A0and pandow-ws =C2=A0in my = tables=20 > and in the body of my text is clumsy. Using variations like /Pandoc=20 > (homepage)/=C2=A0and /Pandoc (github)/=C2=A0remains clumsy. Redefining th= e=20 > reference link is even more clumsy; reference links are here for reuse=20 > not redefinition. With the proposed approach I can consistently say=20 > Pandoc =C2=A0for Pandoc's website or Pandoc=20 > =C2=A0for Pandoc's GitHub repository depending of the= =20 > context in which I am. Two things: First off, this proposal conflicts with the main purpose of=20 link titles, which is to provide hover-text for languages like HTML.=20 Having it replace the main text would compromise that. Secondly, do explicit reference links not work for you? For your=20 example, you should be able to say: [Pandoc][pandoc-ws] or=20 [Pandoc][pandoc-gh] as appropriate to refer to each link as needed, with=20 whatever text is appropriate. (Instead of embedding that text in some=20 random other place in the document.) Daniel T. Staal --=20 --------------------------------------------------------------- This email copyright the author. Unless otherwise noted, you are expressly allowed to retransmit, quote, or otherwise use the contents for non-commercial purposes. This copyright will expire 5 years after the author's death, or in 30 years, whichever is longer, unless such a period is in excess of local copyright law. --------------------------------------------------------------- --=20 You received this message because you are subscribed to the Google Groups "= pandoc-discuss" group. To unsubscribe from this group and stop receiving emails from it, send an e= mail to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org To post to this group, send email to pandoc-discuss-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org To view this discussion on the web visit https://groups.google.com/d/msgid/= pandoc-discuss/14690b10-3aa6-7f6b-6678-18c0def43d55%40usa.net. For more options, visit https://groups.google.com/d/optout.