Sectionlist macro prototype (now updated!)

Hi everyone, this macro is for creating section headings and lists of transcluded note tiddlers underneath them, and sources can get automatically added to notes.

Please watch the instructional video and play with this macro, and give feedback here, in case there are things I need to refine before turning it into a plugin.

https://giffmex.org/experiments/sectionlist.template.html

2 Likes

Nice fit for purpose implementation Dave, thanks for sharing again.

Especially good for people taking notes from various sources.

1 Like

Hi everyone,

I updated the Sectionlist macro this afternoon with a few new features. I also did up a new video walk through to include the new features.

Same link as before: Section list update 4-18-2022

Not to be confused with Mohammad’s Section editor plugin, which is more for long form writing in sections. My macro is for fast and furious note creation by topic and source.

Thanks for sharing an update.

Perhaps you could allow the auto generated new tiddler names to be customised since I would one would prefer to hide them behind the $:/ system name space so they do not appear in recent etc…

To keep it simple, perhaps just an option to add a prefix eg $:/sections/

This feature is in Streams as an example.

1 Like

That was a good idea Tones. I added the prefix $:/zsl/ to push it near the bottom of the system tab yet keep it short and identifiable. Drag the editortoolbar button tiddler and it should work.

1 Like

Oops, problem. I think the $ in the prefix interferes with the $imagelabel$ in the macro . Items are not listing. And now the internet is down in my neighborhood so I can’t revert it back to the pre-Tones version until I get internet back.

Thanks Dave,

I’ll replace my ā€œClassic Slidersā€ from a few weeks ago.

BTW, this was the link in the email, Section list update 4-21-2022

Thx again!

oops, yes, that is the right link but I forgot to update the SiteTitle…Thanks Shell_Functions for the heads up.

It’s in Spanish, but if anyone wants to see a pdf I quickly created using the Sectionlist macro, see https://giffmex.org/b/pdf/credos.confesiones.intro.pdf. That will give you an idea of why I created this macro.

@DaveGifford that looks good. I am keen to understand how we best do the page handling.

If you look at the bottom of page 1, under ā€œAntecedentes bĆ­blicosā€ item 2 is effectively split across pages. If a style or class on ā€œAntecedentes bĆ­blicosā€ or the list item (2) (or all list items), has the break-inside: avoid; then this will not occur. see using media print applies it only to print output, I presume you print to PDF?, however you usually can not see these breaks in the browser.

Also, I have seen elsewhere the code to replace the details icon ![Snag_485b9e|16x17]
(upload://fJf63rktFu9oYRpJP5dhnUTINRv.png) to something more appropriate to print. Using the css @media print can also ONLY do this for print.

I am yet to fully resolve this print preparation step, that is deciding when to break to a new page around logical elements rather than simply lines. I would like to automate it, but since I can’t see in tiddlywiki how to see where it would break during print (Print settings, print driver and page size dependant).

  • In some ways when to break is actually a craft rather than a simple technical issue we can automate.
  • However just stopping the smallest element from breaking is a good start, eg list items as above.

I have experience with this at an advanced level since I built a commercial solution for generating distributable PDF’s, (my only paid tiddlywiki work) in that case I was able to rely on the table break features as it was mostly tables that I needed to ā€œbreak across pagesā€ and thus repeat the table headings.

@TW_Tones

Two FYI’s:

Item 2 on p. 1 has two paragraphs. So the break did not split any paragraphs. But it did split the list item. In my case I could add the ā€˜inside avoid’ to the macro li’s.

I am on the fence about exporting to html (where the details marker would make sense) or printing as pdf (where it does not, as you mention). For the moment I left it in, having pushed the list out quickly, to get feedback from my Facebook group of Spanish speakers. You will note that I didn’t even add my name or the date.

Yes, tables are the element that causes the most headaches re page breaks. And some of the tables I have done are pretty long…

Blessings!

Actually I have solved this ā€œtable breaks across pagesā€ but have trouble with effective control of non-table based page breaks. eg break on paragraphs, list items or section in an automated way. One ends up with some empty and some crowded pages.

Table breaks across pages

Thanks for the tip, Tones!

1 Like

Since I"m on 5.1.2, (and looking for help getting to 5.2…), here’s what i see using the SL buttion for the time:

<<sectionlist headertext:ā€œFirst Headerā€ itemlabel:"">>

~ Marty McGowan, aka @shell_functions a/o @applemcg

I’m thinking if I get to 5.2.n, the itemlabel will have a value?

I am not sure what is causing that. I go to Section list update 4-21-2022 and the SL button works fine.

Wow, I had a GREAT time taking notes on a book I read today. To give you an idea of how the Sectionlist macro helped me:

  1. See sectionlist 2021-2022 Q4 (closed version) for how the tiddler looked while I was taking notes. I could see numerous topics at the same time, and use the + buttons to create tiddlers for each topic and save and close them to return to the closed list.

  2. See sectionlist 2021-2022 Q4 (open version) for the same list, with all the sliders open. Note that the @'s are links to sections in the book in Logos Bible Software. This book had no page numbers. If you don’t have the book in Logos the @ links won’t work. Also, I removed the details marker arrows, removed the ol and li from the list in the macro, and added indentation to the list items. So this is slightly customized from the online version of the macro.

  3. See https://giffmex.org/SL/Common.Rule.Earley.pdf for the printed pdf version. Not sure which I like better.

  4. After adding the notes by topic within the source’s tiddler, I can transfer the macros to a centralized tiddler for topical macros. See Command center first draft) for my first draft.

I am super pumped at how fast it is and how good the results look. This is a workflow I have wanted for years. You might never see me again on this forum! Time to stop tweaking and start producing!

Thanks to all who helped!

1 Like