Scroll Release Notes

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

25.5.1 7-22-2022

• 🏥 minor grammar fix

25.5.0 7-22-2022

• 🏥 path fixes for Windows thanks to @celtic-coder

25.4.0 7-14-2022

• 🎉 50% faster builds

25.3.2 7-14-2022

• 🎉 added cacheing for 40% faster builds

25.3.1 7-14-2022

• 🏥 fixed links in treeTable

25.3.0 7-14-2022

• 🎉 added `treeTable`

console.log("Hello world")

# A code block
print "Hello world"

25.2.1 7-01-2022

• 🏥 fixed broken links in feed.xml

25.2.0 6-22-2022

• 🎉 added `htmlTitle` and `sourceLink` keywords so an article can override the defaults

25.1.0 6-19-2022

• 🎉 if scroll has an rss feed add a tag to built pages

25.0.0 6-15-2022

• ⚠️ on single article pages, the header will now span across all columns.

24.9.0 6-15-2022

• 🎉 added "css" setting. Set `css split` to write CSS to `scroll.css` instead of inline, or `css none` to not generate CSS.
• 🏥 removed extra blank lines in snippets.html generation

24.8.0 6-15-2022

• 🎉 if "baseUrl" is set building will also generate an RSS "feed.xml"

24.7.0 6-13-2022

• 🏥 fix when using Scroll programmatically image sizeOf check will use correct folder
• 🎉 add param to specify index/snippets page when using programmatically

24.6.0 6-10-2022

• 🎉 added `wrap` keyword for advanced custom wraps in aftertext.

Some simple and advanced usages. An absolute link and a relative link. Show some added text or some deleted text.

24.5.0 6-10-2022

• 🎉 added `wrapsOn` keyword to aftertext.

Support for traditional bold, code, and italics in aftertext with the keyword wrapsOn.

24.4.0 6-08-2022

• 🎉 if your scroll has an article(s) with "endSnippet", scroll will create "snippets.html".

24.3.1 5-25-2022

• 🏥 fix bug where images were stuck at 35ch even when the browser sized columns wider

24.3.0 2-16-2022

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

• 🎉 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.

Link Quote Example

This report showed the treatment had a big impact.

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:

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

• ⚠️ 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.

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?

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:

22.4.0 11-25-2021

• 🎉 add basic caption support to images

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.

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

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:

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

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:

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

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