From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.text.pandoc/28877 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Connor Patrick Jackson Newsgroups: gmane.text.pandoc Subject: Re: Markdown -> CommonMark extensions tracker Date: Wed, 21 Jul 2021 11:09:13 -0700 (PDT) Message-ID: References: <11d4e07a-6151-42f1-8a2f-56ce4bb2ae1bn@googlegroups.com> Reply-To: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="----=_Part_1564_1129148067.1626890953121" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="4658"; mail-complaints-to="usenet@ciao.gmane.io" To: pandoc-discuss Original-X-From: pandoc-discuss+bncBDVNJU66TMLRBSWF4GDQMGQEMD6E2IA-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org Wed Jul 21 20:09:17 2021 Return-path: Envelope-to: gtp-pandoc-discuss@m.gmane-mx.org Original-Received: from mail-ot1-f61.google.com ([209.85.210.61]) by ciao.gmane.io with esmtps (TLS1.3:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.92) (envelope-from ) id 1m6Gei-0000sE-KL for gtp-pandoc-discuss@m.gmane-mx.org; Wed, 21 Jul 2021 20:09:16 +0200 Original-Received: by mail-ot1-f61.google.com with SMTP id i2-20020a0568300102b02904cd320591a0sf1982286otp.18 for ; Wed, 21 Jul 2021 11:09:16 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlegroups.com; s=20161025; h=sender:date:from:to:message-id:in-reply-to:references:subject :mime-version:x-original-sender:reply-to:precedence:mailing-list :list-id:list-post:list-help:list-archive:list-subscribe :list-unsubscribe; bh=uUDQUJ8wHiDfes39ERAWlMXN5ImGJqaDCuzQeiLesew=; b=ZC/LF6mGqjliYUt3dgW4YZUKlQujVRaRxaR1QL+c6GbW4BkUSHzQTkFiGhjHQrbdUu 6Lw1hfIfdY3/vE6VgvP4vKcL1LkRdkU8BdtnZndhXiKXbV/0mPbS5RB5qzcPkHTbmxu7 y0aq8YK+EN9ey4P10DWfFgqBkOFY9UcD60ktEI4sbPtOzqyCUizndsamt4SOzZwUJdP+ aW3EWDaE0RhOA63RvHumNjI1PW9Ut1e10RWgtuusZ2xmRb8biACdoaR/n4O9M2mJ5ZBc 8l06CH8epdy/UngObXd67MpC52aXKf9AyB8AA+2zCaXKLz3jZtugfXwsULE1LrdDWawL OvDw== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=berkeley-edu.20150623.gappssmtp.com; s=20150623; h=date:from:to:message-id:in-reply-to:references:subject:mime-version :x-original-sender:reply-to:precedence:mailing-list:list-id :list-post:list-help:list-archive:list-subscribe:list-unsubscribe; bh=uUDQUJ8wHiDfes39ERAWlMXN5ImGJqaDCuzQeiLesew=; b=smTcnpF+6SEZhDMS4/YpVpFQ3DIQ0kwEv/74uaxg8sHDZt06qrSCE8zHMdBeoAZlti 2ZEP3HugM8/0qjO7yQsfhNGWCrcciTpsZwDSKPDrt8vhcsP23WIgo6zPs2NQV+ZpLRqM vidwk0nSfzNTj5qk1e8rQHac4Apf0PtHn73UyAIoTvcFqBQC0iMTwqmiNr8VWMgktVUg sKeOs9YFTCzjDe0bllOY1uJiZZq/6y6m9Ln7g52DST3ZOidJy8Tv+KbBrz+2xwZdIA+f 4IXtgaQr04h/QBJcEJ6zVOaFjq01yKBP34SaN2+spOWXAx3pVgD3aOkSmG0KX8L3N1NB gMVg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=sender:x-gm-message-state:date:from:to:message-id:in-reply-to :references:subject:mime-version:x-original-sender:reply-to :precedence:mailing-list:list-id:x-spam-checked-in-group:list-post :list-help:list-archive:list-subscribe:list-unsubscribe; bh=uUDQUJ8wHiDfes39ERAWlMXN5ImGJqaDCuzQeiLesew=; b=ptHtp18xgkBZlV786vGEK/V86J9xJ5v22TKlC6mWKZxAcpwUah3hATT3YAxRyfF9kP djaPkN1mp/GlvXJYCLqJElK9hsTVyyOZELjXTdk9p9h6e/ZYYSjX8BkDBBvQcZ/ZDGoM 1oDxgvJG8wJltZ2O239h/ElOIOCrhnLHvXB5PN5vrSeyfFeZidCsLH/XmqqtztI+/B9Q dgMfvoB/Mjkcc0IVA7MnPx0AGpa9O/HehIplqsIi7C/lml7lEbpG+zi1lXygzRm1oqV1 j2ijo+cvQB5i3D8r3/SjYfpgq7B9+sLj2pQxDkEQvMnGhNEZk48HJWVG2w8ogQwt+6yF bTqg== Original-Sender: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org X-Gm-Message-State: AOAM530yVtZlMHyk//fH5ouV+ZmmQQP5glYNevQjE0aGJsmTe5LDZGXx t22jlekrNlG5G1G8buccLN4= X-Google-Smtp-Source: ABdhPJxQ7eDiJ0/Y32R4Y/dZBjUWtGLEC1JQ7xnNEUdgkELyPW0Geuvg0Luy6bUhR+Fd152IrXN5XQ== X-Received: by 2002:aca:f410:: with SMTP id s16mr25224240oih.22.1626890955609; Wed, 21 Jul 2021 11:09:15 -0700 (PDT) X-BeenThere: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org Original-Received: by 2002:a9d:5a01:: with SMTP id v1ls1026172oth.3.gmail; Wed, 21 Jul 2021 11:09:14 -0700 (PDT) X-Received: by 2002:a9d:6044:: with SMTP id v4mr26088078otj.117.1626890953685; Wed, 21 Jul 2021 11:09:13 -0700 (PDT) In-Reply-To: X-Original-Sender: cpjackson-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org Precedence: list Mailing-list: list pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org; contact pandoc-discuss+owners-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org List-ID: X-Google-Group-Id: 1007024079513 List-Post: , List-Help: , List-Archive: , List-Unsubscribe: , Xref: news.gmane.io gmane.text.pandoc:28877 Archived-At: ------=_Part_1564_1129148067.1626890953121 Content-Type: multipart/alternative; boundary="----=_Part_1565_1544424500.1626890953121" ------=_Part_1565_1544424500.1626890953121 Content-Type: text/plain; charset="UTF-8" --list-extensions can only tell you an extension is not available, it does not tell you *why*. If I have a document I was previously compiling using Pandoc's markdown plus some extensions, and I wanted to know if I can use the commonmark(_x) reader instead, --list-extensions=commonmark cannot answer that question. I will see only that an extension does not exist. I would then need to delve into the commonmark spec to infer whether it has been incorporated into core commonmark and thus is already available, or if the extension has yet to be developed for commonmark (but will eventually) and thus I need to wait for a later version of pandoc to make the switch. Obviously, people could just wait until commonmark_x becomes the default, but it would be useful to have that information compiled in one place. On Wednesday, July 21, 2021 at 11:00:14 AM UTC-7 BP wrote: > What would such a table/list achieve which is not already available, more > reliably since it is always up to date, with --list-extensions=FORMAT ? > > I guess one could write a script which takes a list of formats as input, > calls --list-extensions=FORMAT for each of them and assembles a pipe table > from the results. Providing such a script would arguably be more useful > than providing a static table which becomes out of date. > > > Den ons 21 juli 2021 19:42Connor Patrick Jackson > skrev: > >> re: not allowed by spec: Oh okay. I guess that only really makes sense >> for the handful of extensions that are allowed by commonmark but not by >> markdown, but that isn't really all that useful information. Are there any >> markdown extensions that, for whatever reason, will *never* be >> incorporated into commonmark, either within the spec or as an extension? >> That might be useful to know as well but there might not be any in that >> situation. >> >> Perhaps more useful would just be a list for each of the latter two >> categories: >> >> Former markdown packages that are permanently incorporated into the >> commonmark spec (this could be added to the manual rather than on the wiki, >> since it is essentially fixed, and would be a useful reference?) >> Markdown packages yet to be implemented in commonmark (this list belongs >> on the wiki as it gradually shrinks) >> >> I would happily volunteer to give myself a periodic calendar reminder and >> check in with pandoc --list-extensions and the release notes to see if >> any new extensions have been implemented, and update the Wiki list >> accordingly. If someone could put together the first list (I'm not super >> read-up on the details of the commonmark spec) I can put together the >> second. >> >> For convenience, the full list of markdown packages not available in >> commonmark (union of the two lists) as of 2.14.0.3 (and I don't believe >> 2.14.1 added any new commonmark extensions): >> abbreviations >> all_symbols_escapable >> angle_brackets_escapable >> auto_identifiers >> backtick_code_blocks >> blank_before_blockquote >> blank_before_header >> citations >> compact_definition_lists >> escaped_line_breaks >> example_lists >> fenced_code_attributes >> fenced_code_blocks >> four_space_rule >> grid_tables >> gutenberg >> header_attributes >> ignore_line_breaks >> inline_code_attributes >> inline_notes >> intraword_underscores >> latex_macros >> line_blocks >> link_attributes >> lists_without_preceding_blankline >> literate_haskell >> markdown_attribute >> markdown_in_html_blocks >> mmd_header_identifiers >> mmd_link_attributes >> mmd_title_block >> multiline_tables >> native_divs >> native_spans >> old_dashes >> pandoc_title_block >> shortcut_reference_links >> simple_tables >> space_in_atx_header >> spaced_reference_links >> startnum >> table_captions >> tex_math_double_backslash >> tex_math_single_backslash >> >> On Wednesday, July 21, 2021 at 10:17:45 AM UTC-7 John MacFarlane wrote: >> >>> Connor Patrick Jackson writes: >>> >>> > - Not allowed by the spec (cannot be enabled) >>> >>> This one doesn't really apply. Officially, the spec fully >>> specifies behavior, so no extension is "allowed by the spec." >>> >>> But it might be useful to distinguish between: >>> >>> > - required by the spec (cannot be disabled) >>> > - Not available (under development) >>> >>> If you have specific questions regarding this, I'd be >>> happy to answer. A table may be useful, but of course >>> there's the danger that it will become out of date and >>> thus misleading. >>> >>> -- >> 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 >> email to pandoc-discus...-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org >> To view this discussion on the web visit >> https://groups.google.com/d/msgid/pandoc-discuss/ec4a5de6-77a4-4a48-86cc-e3d2610f5257n%40googlegroups.com >> >> . >> > -- 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 email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/d1d1e4ab-26c6-467b-9a61-40acdfc03aa8n%40googlegroups.com. ------=_Part_1565_1544424500.1626890953121 Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable --list-extensions can only tell you an extension is not available, it does = not tell you why. If I have a document I was previously compiling us= ing Pandoc's markdown plus some extensions, and I wanted to know if I can u= se the commonmark(_x) reader instead, --lis= t-extensions=3Dcommonmark cannot answer that question. I will see on= ly that an extension does not exist. I would then need to delve into the co= mmonmark spec to infer whether it has been incorporated into core commonmar= k and thus is already available, or if the extension has yet to be develope= d for commonmark (but will eventually) and thus I need to wait for a later = version of pandoc to make the switch. 

Obviously, p= eople could just wait until commonmark_x becomes the default, but it would = be useful to have that information compiled in one place. 

On Wedn= esday, July 21, 2021 at 11:00:14 AM UTC-7 BP wrote:
What would such a = table/list achieve which is not already available, more reliably since it i= s always up to date, with=C2=A0--list-extensions=3DFORMAT ?

I guess one could write a script which takes = a list of formats as input, calls=C2=A0--list-extensions=3DFORMAT for each = of them and assembles a pipe table from the results. Providing such a scrip= t would arguably be more useful than providing a static table which becomes= out of date.


Den ons 21 juli 2021 19:42Connor Patrick Jackson <cpja...-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org> skrev:
re: not allowed= by spec: Oh okay. I guess that only really=C2=A0makes sense for the handfu= l of extensions that are allowed by commonmark but not by markdown, but tha= t isn't really all that useful information. Are there any markdown exte= nsions that, for whatever reason, will never=C2=A0be incorporated in= to commonmark, either within the spec or as an extension? That might be use= ful to know as well but there might not be any in that situation.=C2=A0
Perhaps more useful would just be a list for each of the la= tter two categories:=C2=A0

Former markdown package= s that are permanently incorporated into the commonmark spec (this could be= added to the manual rather than on the wiki, since it is essentially fixed= , and would be a useful reference?)
Markdown packages yet to be i= mplemented in commonmark (this list belongs on the wiki as it gradually shr= inks)

I would happily volunteer to give myself a p= eriodic calendar reminder and check in with pand= oc --list-extensions=C2=A0and the release notes to see if any new ex= tensions have been implemented, and update the Wiki list accordingly. If so= meone could put together the first list (I'm not super read-up on the d= etails of the commonmark spec) I can put together the second.=C2=A0

For convenience, the full list of markdown packages not a= vailable in commonmark (union of the two lists) as of 2.14.0.3 (and I don&#= 39;t believe 2.14.1 added any new commonmark extensions):=C2=A0
<= div>abbreviations
all_symbols_escapable
angle_brackets_escapable
a= uto_identifiers
backtick_code_b= locks
blank_before_blockquote
blank_before_header
=
citations
compact_definition_lists
escaped_line_breaks
exampl= e_lists
fenced_code_attributes<= /font>
fenced_code_blocks
=
four_space_rule
grid_tables
gu= tenberg
header_attributes
ignore_line_breaks
= inline_code_attributes
inline_notes
intraword_underscores
latex_ma= cros
line_blocks
link_attributes
lists_without_preceding_blankline
literate_haskell
markdown_attribute
markdo= wn_in_html_blocks
mmd_header_id= entifiers
mmd_link_attributes
mmd_title_block
multiline_tables
native_divs
nativ= e_spans
old_dashes
=
pandoc_title_block
shortcut_reference_links
simple_tables
spa= ce_in_atx_header
spaced_referen= ce_links
startnum
<= div>table_captions
tex_math_double_backslash
tex_math_single_backslash

On Wednesday,= July 21, 2021 at 10:17:45 AM UTC-7 John MacFarlane wrote:
Connor Patrick Jackson <cpja...-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org> writes:

> - Not allowed by the spec (cannot be enabled)

This one doesn't really apply. Officially, the spec fully
specifies behavior, so no extension is "allowed by the spec."

But it might be useful to distinguish between:

> - required by the spec (cannot be disabled)
> - Not available (under development)=20

If you have specific questions regarding this, I'd be
happy to answer. A table may be useful, but of course
there's the danger that it will become out of date and
thus misleading.

--
You received this message because you are subscribed to the Google Groups &= quot;pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an e= mail to pandoc-discus= ...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-dis= cuss/ec4a5de6-77a4-4a48-86cc-e3d2610f5257n%40googlegroups.com.

--
You received this message because you are subscribed to the Google Groups &= quot;pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an e= mail to pand= oc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org.
To view this discussion on the web visit https://groups.google.com/d= /msgid/pandoc-discuss/d1d1e4ab-26c6-467b-9a61-40acdfc03aa8n%40googlegroups.= com.
------=_Part_1565_1544424500.1626890953121-- ------=_Part_1564_1129148067.1626890953121--