Release Notes

Here's a list of the notable changes in Scroll and Scrolldown.

This tiny release adds some ways to include more caveats and context around words and references.

24.3.0 2-16-2022

• 🎉 added 'caveat' directive to aftertext for adding caveats around parts of text
• 🎉 added 'note' directive to aftertext links for providing more context around included links

Caveat Example

This is a great idea.

aftertext This is a great idea. caveat great I'm not actually sure if this is a great idea. But often I want to include a comment and link it back to the text, but don't quite want to footnote it.

Link Quote Example

This report showed the treatment had a big impact.

aftertext This report showed the treatment had a big impact. https://example.com/report This report note The average growth in the treatment group was 14.2x higher than the control group.

24.2.0 1-18-2022

• 🎉 added 'id' directive to aftertext for adding ids to paragraphs

• 🎉 added 'loremIpsum' nodeType to help in testing and exploring

Example demonstrating the above:

aftertext Click here to go to the middle paragraph. link #middleParagraph Click here loremIpsum 20 aftertext Here is the middle paragraph. id middleParagraph loremIpsum 20

24.1.1 1-13-2022

• 🏥 fix bug where migrator was not replacing 🔗 links in paragraphs when upgrading to aftertext
• 🏥 fix typo in release notes

24.1.0 1-13-2022

• 🎉 added migrate command to automate migrations when there are breaking changes
• 🎨 added background color and styling to inline code elements in default theme

24.0.0 1-11-2022

• 🎉 if a table has a column name ending in "Link", that will be used to link the matching column. See example below.
• ⚠️ if you have tables with a column ending in "Link" beware the new behavior

pipeTable name|nameLink Wikipedia|https://wikipedia.org

name
Wikipedia

• ⚠️ the first paragraph of an article no longer prints a dateline. Use aftertext instead. See example below.

By default the article's date will be used but you can also provide a custom date.

aftertext A truck transporting llamas collided into a pajama factory late last night. dateline 2/21/2020

February 21, 2020 — A truck transporting llamas collided into a pajama factory late last night.

To migrate and keep your existing datelines use the command scroll migrate.

23.2.0 12-22-2021

• 🎉 add "matchAll" and "match" support to aftertext for more advanced matching options
• 🎉 add "class" markup directive to aftertext
• 🎉 add "css" node for easier insertion of CSS
• 🏥 fix bug in aftertext when 2 tags started at same index
• 🏥 make basic dateline work in browser

Can you show an example of the new advanced aftertext features?

How much wood can a woodchuck chuck if a woodchuck could chuck wood?

aftertext How much wood can a woodchuck chuck if a woodchuck could chuck wood? link https://en.wikipedia.org/wiki/Groundhog woodchuck matchAll class standout wood match 0 3 css .standout { background-color: yellow; border: 1px dashed red; padding: 5px; }

23.1.0 12-21-2021

• 🎉 add dateline node to aftertext.

23.0.0 12-09-2021

• 🎉 add aftertext node type, with bold, italics, underline, link (& quick link), email, code and strikethrough keywords
• 🎉 add belowAsCode and aboveAsCode
• 🎉 split base grammar into files for easier extensibility

Can you show an example of aftertext?

You write some text. After your text, you add your markup instructions with selectors to select the text to markup, one command per line. For example, this paragraph is written in Aftertext and the source code looks like:

aftertext You write some text. After your text, you add your markup instructions with selectors to select the text to markup, one command per line. For example, this paragraph is written in Aftertext and the source code looks like: italics After your text italics selectors

22.4.0 11-25-2021

• 🎉 add basic caption support to images

image screenshot.png caption This is a caption

22.3.0 08-23-2021

• 🎉 columnWidth to set a custom column width per article or folder
• 🎉 maxColumns can be set globally in settings

22.2.0 08-23-2021

• 🎉 integrated design feedback into default theme for better readability

22.1.0 07-23-2021

• 🏥 you can now ignore custom grammar files in a dir with ignoreGrammarFiles

22.0.0 07-09-2021

• 🎉 scroll.settings file is now optional and you can use scroll to build a single page.
• 🎉 you can now set 'header' and/or 'footer' on articles.

21.4.0 07-08-2021

• 🎉 you can now set 'maxColumns' on articles.

21.3.0 07-07-2021

• 🎉 if all articles have 'skipIndexPage', 'index.html' will not be built

21.2.0 07-06-2021

• ⚠️ internal CSS changes

21.0.0 06-21-2021

• 🎉 built in support for custom grammars!
• ⚠️ internal nodejs API changes: Article is no longer exported and ScrollBuilder is now ScrollFolder

20.0.0 06-21-2021

• 🎉 new question nodetype. Simply compiles to an h4 for now but more semantic this way.
• 🎉 new section nodetype. Simply compiles to an h3 for now but more semantic this way.
• 🎉 new subsection nodetype. Simply compiles to an h4 for now but more semantic this way.
• ⚠️ title2-title6 have been removed. use question, section and subsection instead.

Why the new `question` nodes?

Question and answer structures are literally older than the Socratic Method. Such a common semantic pattern deserves it's own keywords.

How do I migrate from title# nodes?

The below regex may help.

Find ^title\d (.+\?) ReplaceWith question $1 Find ^title\d (.+) ReplaceWith section $1

19.3.1 06-20-2021

• 🎉 show the version in footer
• 🏥 fix title in single pages without a title

19.3.0 06-20-2021

• 🏥 fix bug where readme.scroll could be overwritten by init

19.2.0 06-17-2021

• 🎉 improved styling for tables

19.1.0 06-17-2021

• 🏥 fix bug with http links
• 🏥 simpler article padding and changed scroll title to h2 from h1

19.0.0 06-17-2021

• 🎉 ability to override header and footer

18.4.0 06-17-2021

• 🏥 improved alignment of images

18.3.0 06-16-2021

• 🎉 og meta tags for social media sharing

18.2.0 06-16-2021

• 🏥 title now links to "index.html". less magic and works much better locally

18.1.1 06-16-2021

• 🏥 fix regression where 2 columns on mobile were not downsizing to 1

18.1.0 06-16-2021

• 🎉 short articles now are put into 1 or 2 columns

18.0.0 06-15-2021

• 🎉 build is now ~46% faster
• 🏥 refactored html generation in preparation for easier extending and theming

17.5.0 06-05-2021

• 🏥 fixed numerous bugs in importing RSS feeds and added examples

17.4.0 06-04-2021

• 🎉 typography adjustments
• 🏥 fixed overlapping social icons up top on mobile. just keep git link

17.3.0 06-03-2021

• 🎉 images now link to the full size image

17.2.2 06-02-2021

• 🏥 fixed safari-only bug not painting overflowing code blocks on single pages

17.2.1 05-25-2021

• 🏥 fixed bug where sequential links were not getting parsed

17.2.0 05-25-2021

• 🏥 tables can now break on single pages for higher information density

17.1.0 05-25-2021

• 🎉 pipeTable

what	why
PipeTable	Because it's awesome!

17.0.0 05-25-2021

• 🎉 tabTable and commaTable
• ⚠️ table is now spaceTable
• 🏥 do not crash if an empty row in a table

16.2.0 05-24-2021

• 🏥 do not crash if an image is not found

16.1.0 05-24-2021

• 🎉 building a site is now ~2.4x faster 🏎

16.0.0 05-22-2021

• ⚠️ rename scrollSettings.map to scroll.settings

15.0.0 05-21-2021

• 🎉 Scroll will detect and emit image sizes during build to reduce layout shifts.

14.3.0 05-21-2021

• 🏥 Scroll is now somewhat usable as an NPM module.

14.2.0 05-20-2021

• 🏥 added html head meta viewport tag for better mobile experience.

14.1.0 05-20-2021

• 🏥 added doctype tag
• 🏥 added html head meta description tag

14.0.0 05-19-2021

• ⚠️ removed links nodeType
• ⚠️ fixed bug where sometimes permalinks were still using title and not filename

13.3.0 05-18-2021

• 🎉 html and image node types

To use an image node:

image foo.jpg

QuickParagraphs are now an error. When you want to drop in some HTML, do so with HTML node:

html <b>anything goes here</b>

13.2.0 05-18-2021

• 🎉 Added scroll check command

13.1.0 05-18-2021

• 🎉 🔗links in lists as well as paragraphs

13.0.0 05-17-2021

• 🎉 🔗links in paragraph nodes.
• 🎉 skipIndexPage nodeType

How do I use the new single word links?

For single word links in paragraph nodes only (for now) you can now do:

paragraph This is a link🔗example.com

Below is a regex for migrating existing *.scroll files.

<a href="https://([^"]+)">([^ ]+)</a> $2🔗$1

How do I use the 🔗link tag with multiword links?

The 🔗link tag only supports single word links. Like everything with Scrolldown, you have a number of options if the conventional design doesn't work for you. Your options are:

• Link just one word. If you need more, perhaps camelCase or snake_case your words together into one concept.
• Repeat the link twice foo 🔗link bar 🔗link
• Use <a> tags.
• Extend the Scrolldown grammar for your site.

Can I not include a page in the index page?

Now you can! Sometimes you just want to publish an independent page without including it in the index. To do that, just add skipIndexPage.

12.1.0 05-14-2021

• 🎉 chat nodeType

12.0.0 05-12-2021

• ⚠️ scroll create is now scroll init
• ⚠️ Removed export command
• 🏥 removed example.com folder. Less code and now flat.

11.0.0 05-11-2021

• 🎉 list, orderedList, and links node types
• 🎉 codeWithLanguageNode
• 🏥 HTML escaped in code blocks

10.0.0 05-10-2021

• 🎉 table nodeType for SSVs with linkify
• 🎉 Better docs in Scrolldown grammar
• ⚠️ Removed list nodeType
• ⚠️ Removed link nodeType
• 🏥 Windows return character fix
• 🏥 multiline support in subheader nodeTypes

9.0.0 05-05-2021

• 🎉 Scrolldown now has a quote nodeType.
• 🏥 Code block format bug fixes.
• 🏥 Styling improvements

8.0.0 04-10-2021

• 🎉 Scroll now just builds files. No web server needed.

7.0.0 04-03-2021

• ⚠️ Scroll the language is now called Scrolldown (thanks FB!).
• 🏥 Bug fixes.
• 🎉 Better perf.

6.0.0 03-08-2021

• 🎉 By popular request, Scroll now also publishes each article to its own page.
• 🎉 Fewer links. Do less. KISS.
• 🎉 Better perf.
• 🎉 "permalink" nodeType

5.0.0 02-28-2021

• 🎉 Changed name of everything from dumbdown to Scroll per user feedback
• ⚠️ File extension of articles needs to be "scroll" and not "dd" now.

4.2.0 02-22-2021

• 🏥 Fixed paragraph parsing and rendering

4.1.0 02-22-2021

• 🎉 "git" scrollSetting for article source links.

Article source