Re: [ELPA] New package: toc-mode

[dalanicolai <dalanicolai@gmail.com>]

[-- Attachment #1: Type: text/plain, Size: 3773 bytes --]

I guess it does no harm to explicitly mention it again here (it is also in
the usage instructions
<https://github.com/dalanicolai/toc-mode#software-generated-pdfs-with-pdftocgen--httpskrasjetcomvoicepdftocgen>
)...

If you have a scanned pdf, then it is strongly recommended to use the
pdf.tocgen <https://pypi.org/project/pdf.tocgen/> functionality.
Using that, then in most cases, you can really extract the TOC and add it
to the document in
a (few) minute(s).

On Sun, 25 Sept 2022 at 18:47, dalanicolai <dalanicolai@gmail.com> wrote:

> Thanks for the feedback!
>
> However, I am not sure if I understand every point correctly.
>
> For point 1, I would say just keeping (S)-<left/right> pressed works so
> fast, that I think
> it is not necessary to set the page number by reading from the user
> (b.t.w. I think,
> generally, C-<left/right> are the most useful keys in tabular-mode). As
> mentioned in
> the instructions for the tabular mode
> <https://github.com/dalanicolai/toc-mode#3-toc-tabular-adjust-pagenumbers>
> the contents of every field in tabular mode can be
> updated by reading from the user through placing the cursor on the field
> and then pressing
> C-r. I see now, that the phrasing of that instruction could be a improved.
>
> For point 2, the answer again is that you can press C-r on the field to
> update it. However,
> the tabular-mode should mainly be used for adjusting the page numbers.
> Cleaning up, and
> setting levels, should preferably be done in the 'cleanup' stage
> <https://github.com/dalanicolai/toc-mode#2-toc-cleanup>.
>
> As far as I know, the most use keybindings are major-mode keybindings, and
> automatically
> listed when checking the mode documentation using C-h m, as mentioned in
> the first section of the usage instructions
> <https://github.com/dalanicolai/toc-mode#usage>. Or are you thinking
> about something else?
>
> Of course if you see any improvement, then patches are welcome (although I
> prefer pull
> requests, but all is fine).
>
> On Sun, 25 Sept 2022 at 13:44, Visuwesh <visuweshm@gmail.com> wrote:
>
>> [செவ்வாய் செப்டம்பர் 20, 2022] dalanicolai wrote:
>>
>> > This package has been for a while on MELPA now, but it would be nice if
>> it
>> > could be moved to ELPA. The source can be found at
>> > https://github.com/dalanicolai/toc-mode.
>> >
>> > I would like to mention that the PDF functionalities largely depend on
>> > pdf-tools, which is not on
>> > ELPA of course (doc-view unfortunately does not provide the right
>> > features). I am not sure
>> > if that somehow is a problem.
>> >
>> > [...]
>>
>> Thanks for this package, it simplified adding TOC to a pdf file
>> immensely but I had a couple hiccups when using it:
>>
>>     1. Can we have a command that sets the page number of an outline
>>        item by reading it from the user?  I.e., if I say M-x
>>        toc-set-page-number RET 20, it would set the heading's page
>>        number to 20, and a respective -remaining command.  This would be
>>        a very nice complement to <right> and S-<right> that we already
>>        have.  Equivalently, we could also accept a numeric argument for
>>        <right> and S-<right>.
>>     2. AFAICT, there is no way to edit the outline level from the
>>        tabular buffer?  Is this possible, I figured out the way to
>>        adjust the level is to edit the spaces in the first buffer, but
>>        that took some trying to figure out.
>>     3. Finally, can you put the commonly used keybinding in the
>>        major-mode's documentation?
>>
>> If you would like to have these as patches instead, then I can try to
>> shoot some in two weeks time.
>>
>

[-- Attachment #2: Type: text/html, Size: 4881 bytes --]