Bug#861128: RFP: elpa-markdown-toc -- Generate a TOC in markdown file with Emacs
On 2018-09-17 22:40:10, Nicholas D Steeves wrote:
> Control: tag -1 + moreinfo
>
> Hi Antoine,
>
> On Mon, Apr 24, 2017 at 04:22:35PM -0400, Antoine Beaupre wrote:
>> Package: wnpp
>> Severity: wishlist
>>
>> * Package name : elpa-markdown-toc
>> Version : 0.1.2
>> Upstream Author : Antoine R. Dumont
>> * URL : https://github.com/ardumont/markdown-toc/
>> * License : GPL-3+
>> Programming Lang: Elisp
>> Description : Generate a TOC in markdown file
> [...]
>>
>> I use this when I write markdown reports that get translated in
>> standalone HTML documents that I ship to clients. I used to rely on
>> pandoc's --toc functionality, but that was too limited: I couldn't
>> control output levels and fix headings the way I wanted.
>>
>> It depends on markdown-mode, certain versions:
>>
>> https://github.com/ardumont/markdown-toc/issues/29
>>
>> Happy to comaintain...
>
> Re: a couple of markdown-toc bugs:
>
> https://github.com/ardumont/markdown-toc/issues/29
> * Solve in Debian with a hard depends on >= markdown-mode 2.2?
> * You mentioned markdown-mode 2.1 is bad, 20161222.1416 is good,
> and 2.2 is from 20170526, thus 2.2 should be good.
> * possibly fixed in markdown-toc?
>
> https://github.com/ardumont/markdown-toc/issues/15
> * "Don't assume that a document has an h1"
> * How serious is this one? Seems like it could be annoying.
>
> https://github.com/ardumont/markdown-toc/issues/35
> * "Lines starting with # in code sections are treated as headings"
> * I imagine this one will frustrate many users.
I'm not sure how that's relevant to this RFP. Sure, like any other
software, markdown-toc has bugs. :) Those are not critical and the thing
generally works in my use cases. I think it can be packaged as is.
> By the way, if you'd like I'd be happy to give you an intro on dh-elpa
> packaging. With the exception of a couple of autopkgtest on LXC
> workarounds it's easy stuff--the trickiest bit is identifying why an
> upstream self-test doesn't work on buildd. Also, we're working on
> improving dh-elpa's documentation, so alternatively it would be nice
> to hear about your experiences with it--and than make improvements if
> necessary! dh_elpa(1), dh_elpa_test(1), dh-make-elpa(1), plus
I'm sure you guys did a great job and it's nice to see so many ELPA
packages being added into Debian. Unfortunately, I don't have much time
to handle the packaging myself so if you do not mind I'll stay on this
side of the packaging for now. :) If I do find the time, you'll be the
first to know (here) that I can work on a package of course.
> Failing that I think I'd like to package this one :-)
Please be my guest!
a.
--
I believe that if someone choose arts as their subject but do not
criticize the issues of their society, they have have betrayed
themselves, their conscience, and their society.
- Atena Farghadani
Reply to: