[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH 1/2] ox-texinfo: Turn a description list item with "+" bullet
From: |
Jonas Bernoulli |
Subject: |
Re: [PATCH 1/2] ox-texinfo: Turn a description list item with "+" bullet into @itemx |
Date: |
Wed, 05 Jan 2022 14:12:36 +0100 |
Nicolas Goaziou <mail@nicolasgoaziou.fr> writes:
>> For example:
>>
>> - Key: C-c C-w (forge-browse-TYPE) ::
>> + Key: C-c C-w (forge-browse-dwim) ::
>> + Key: N b I (forge-browse-issues) ::
>> + Key: N b P (forge-browse-pullreqs) ::
>> + Key: N b t (forge-browse-topic) ::
>> + Key: N b i (forge-browse-issue) ::
>> + Key: N b p (forge-browse-pullreq) ::
>>
>> These commands visit the topic, issue(s), pull-request(s), post,
>> branch, commit, or remote at point in a browser. ...
>>
>> vs.
>>
>> - Key: C-c C-w (forge-browse-TYPE), C-c C-w (forge-browse-dwim), N b I
>> (forge-browse-issues), N b P (forge-browse-pullreqs), N b t
>> (forge-browse-topic), N b i (forge-browse-issue), N b p
>> (forge-browse-pullreq) ::
>>
>> These commands visit the topic, issue(s), pull-request(s), post,
>> branch, commit, or remote at point in a browser. ...
>>
>> I am sure I am gonna make mistakes when using the latter approach.
>
> True, but OTOH, the first option is not really possible. However, there
> are still alternatives. For example, you could check blank lines between
> items:
>
> - key: a ::
> - key: b ::
>
> - key: c ::
> - key: d ::
>
> I suggest to require a special attribute before doing so, e.g.,
>
> #+attr_texinfo: :compact t
> - key: a ::
> - key: b ::
>
> - key: c ::
> - key: d ::
I went with that approach.
> Another option would be to merge consecutive lists with such an
> attribute, for the same result:
>
> #+attr_texinfo: :compact t
> - key: a ::
> - key: b ::
>
> #+attr_texinfo: :compact t
> - key: c ::
> - key: d ::
>
>
> - This is a regular list since it does not have :compact attribute.
Ordered lists are transcoded to @itemize, while description lists are
transcoded to @table or some other table command. So they cannot be
combined into one list-like thing in Texinfo.
The first two lists could be combined, but IMO it is better to only
require the :compact t once and avoid splitting the list and then
recombining the lists back into one.
Jonas
Ps: Slightly sad about loosing the +.
It looks very much like the x at the end of @itemx.
- Re: [PATCH 1/2] ox-texinfo: Turn a description list item with "+" bullet into @itemx,
Jonas Bernoulli <=