public inbox archive for pandoc-discuss@googlegroups.com
 help / color / mirror / Atom feed
From: Milan Bracke <milan.bracke-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
To: pandoc-discuss <pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org>
Subject: Re: Proposed new list type
Date: Tue, 11 May 2021 07:04:45 -0700 (PDT)	[thread overview]
Message-ID: <11e20690-21cc-4287-81b0-e5f3e191cf1bn@googlegroups.com> (raw)
In-Reply-To: <m2mtta1jr7.fsf-jF64zX8BO08an7k8zZ43ob9bIa4KchGshsV+eolpW18@public.gmane.org>


[-- Attachment #1.1: Type: text/plain, Size: 3733 bytes --]

Hi,

Thanks for your feedback, and sorry for taking a while to respond.

Your objections are very reasonable and parsing these lists as regular
paragraphs is a decent alternative, but it also has its drawbacks. So I 
came up
with a third solution. The main drawback was that these lists without 
markers
are often used to add paragraphs in a list item without visually adding a 
new
list element or ending the list. By using paragraphs, we would visually end 
the
list. My solution to this is to add the list items without markers as
paragraphs to the last item of the list immediately before if there is one. 
In
the other cases we propose to just use paragraphs as you suggested.

I have attached a docx file and an HTML file to demonstrate both cases and 
how
they would be rendered with my solution.

What are your thoughts on this solution? If you think it's good I'll send a
pull request either Friday or in two weeks.
On Tuesday, May 4, 2021 at 7:39:23 PM UTC+2 John MacFarlane wrote:

>
> I guess I do have objections to features that get implemented
> in just a couple of formats, leaving the work of implementing
> them in others to other people.
>
> There's also a question whether it makes sense to support
> this kind of list -- that depends on whether it has a reasonable
> rendering in enough of the formats we support. (Particularly
> in Markdown, which is supposed to be expressive enough for
> everything in the AST, with the current exception of some of
> the new table features.)
>
> What about parsing these docx lists as just lists of regular
> paragraphs? Then they'll render pretty well in every output
> format.
>
> Milan Bracke <milan....-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> writes:
>
> > Hi,
> >
> > Both docx and HTML have a list type named "none", where no marker is 
> shown.
> > However, Pandoc doesn't support these types of lists and will put numbers
> > instead. See the attached docx file for an example.
> >
> > We would like to add a ListNumberStyle called None in pandoc-types and 
> use 
> > it in
> > the docx reader and HTML writer. For HTML5, we can't use the "type" 
> > attribute so
> > we will have to fall back on the "list-style-type" CSS as described here:
> > https://www.w3schools.com/tags/att_ol_type.asp, and for docx the change 
> > seems
> > simple since all the types can be set with w:numFmt.
> >
> > We'd prefer not to implement the usage of the new type in the other 
> readers 
> > and
> > writers yet. (We'll of course avoid breaking them.) We only need it in 
> the 
> > two
> > mentioned above and we don't master all the file types in Pandoc. Is 
> this 
> > OK and
> > should we make an issue to track the progress in the other readers and 
> > writers
> > when people implement the new type there?
> >
> > Do you have any feedback or objections? If there are no objections, 
> we'll 
> > make
> > a pull request soon.
> >
> > -- 
> > 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/4e936aa2-41d6-4d68-ba5a-bea916754922n%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/11e20690-21cc-4287-81b0-e5f3e191cf1bn%40googlegroups.com.

[-- Attachment #1.2: Type: text/html, Size: 5303 bytes --]

[-- Attachment #2: desired_output.html --]
[-- Type: text/html, Size: 312 bytes --]

[-- Attachment #3: list_without_markers.docx --]
[-- Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document, Size: 13414 bytes --]

  parent reply	other threads:[~2021-05-11 14:04 UTC|newest]

Thread overview: 6+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-05-04 14:29 Milan Bracke
     [not found] ` <4e936aa2-41d6-4d68-ba5a-bea916754922n-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org>
2021-05-04 17:39   ` John MacFarlane
     [not found]     ` <m2mtta1jr7.fsf-jF64zX8BO08an7k8zZ43ob9bIa4KchGshsV+eolpW18@public.gmane.org>
2021-05-11 14:04       ` Milan Bracke [this message]
     [not found]         ` <11e20690-21cc-4287-81b0-e5f3e191cf1bn-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org>
2021-05-25 13:20           ` Milan Bracke
2021-05-25 16:49           ` John MacFarlane
     [not found]             ` <m2czte21xq.fsf-jF64zX8BO08an7k8zZ43ob9bIa4KchGshsV+eolpW18@public.gmane.org>
2021-05-26  8:40               ` Milan Bracke

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=11e20690-21cc-4287-81b0-e5f3e191cf1bn@googlegroups.com \
    --to=milan.bracke-re5jqeeqqe8avxtiumwx3w@public.gmane.org \
    --cc=pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).