Scroll Release Notes

A list of what has changed in Scroll releases.

72.4.4 2/07/2024

72.4.3 11/04/2023

72.4.2 11/04/2023

72.4.1 11/04/2023

72.4.0 6/27/2023

This paragraph has a dropcap. It can be a useful visual aid for the reader to break up sections. You can read more about dropcaps on Wikipedia.

72.3.0 6/13/2023

72.2.0 5/31/2023

72.1.0 5/26/2023

72.0.0 5/25/2023

71.5.0 5/19/2023

71.4.0 5/9/2023

71.3.0 5/8/2023

71.2.0 5/07/2023

71.1.0 5/07/2023

71.0.0 5/06/2023

70.0.0 4/29/2023

69.3.0 4/26/2023

69.2.0 4/18/2023

69.1.4 4/13/2023

69.1.3 4/13/2023

69.1.1 4/13/2023

69.1.0 4/13/2023

69.0.0 4/9/2023

No one should be affected. This was an internal rewrite to upstream the imports code to TreeFileSystem in Jtree. No changes for Scroll users.

68.0.0 4/3/2023

Simplify theme building.

// Change `gazetteTheme noTags` to: gazetteCss tags false

67.1.0 4/3/2023

Maintenance release. Update packages and remove unused package and specify required NodeJs versions accurately.

67.0.0 4/2/2023

This is The Theme Release.

66.0.0 4/2/2023

65.0.0 3/30/2023

64.0.0 3/28/2023

63.1.0 3/27/2023

63.0.1 3/27/2023

63.0.0 3/27/2023

This was a big internal refactor to remove the outdated concept of ScrollFolder and rely on the file system parameter instead. This makes it easier to build webapps serving dynamic Scroll pages. It also simplifies the upcoming isomorphic release.

62.5.1 3/27/2023

62.5.0 3/23/2023

canonicalLink https://scroll.pub/tests/kitchenSink/maps.html?canonLinkTest=true

62.4.0 3/23/2023

62.3.0 3/22/2023

62.2.0 3/15/2023

62.1.0 3/13/2023

62.0.1 3/13/2023

62.0.0 3/11/2023

61.0.0 3/11/2023

60.0.0 3/10/2023

html <hr> <hr>

59.6.0 3/10/2023


59.5.0 3/9/2023

59.4.0 3/7/2023

59.3.0 3/6/2023

59.2.0 3/6/2023

59.1.0 3/6/2023

59.0.0 3/3/2023

58.5.1 3/2/2023

58.5.0 3/2/2023

58.4.0 3/1/2023

58.3.1 2/28/2023

58.3.0 2/28/2023

Scroll now has checklists!

58.2.3 2/22/2023

58.2.2 2/21/2023

58.2.1 2/21/2023

58.2.0 2/21/2023

58.1.0 2/16/2023

loop words #2a2d34ff #009ddcff #f26430ff #6761a8ff #009b72ff javascript `<span style="background-color: ${item}; width: 30px; height: 30px; display: inline-block;"> </span>`      

58.0.1 2/9/2023

58.0.0 2/9/2023

57.0.1 2/8/2023

57.0.0 2/8/2023

- ๐ŸŽ‰ added support for `css` one liners class blueOneLiner css .blueOneLiner { color: blue;}

56.1.0 2/8/2023

title The Long Beach Pub snippets 2023/index stories/index 2022/index

56.0.1 2/7/2023

56.0.0 2/7/2023

55.6.0 2/7/2023

55.5.0 1/31/2023

1. One 2. Two 3. Three
  1. One
  2. Two
  3. Three

55.4.1 1/31/2023

55.4.0 1/30/2023

name score
kaia 400
pemma 100
table && name&&score kaia&&400 pemma&&100

55.3.0 1/29/2023

css .classDemo {color:blue;} This whole text will be blue. class classDemo

This whole text will be blue.

55.2.0 1/26/2023

55.1.0 1/20/2023

55.0.1 1/19/2023

55.0.0 1/19/2023

nodemon -e scroll -x "scroll build"

Or alias it:

alias watch="nodemon -e scroll -x 'scroll build'"

You can add the following code to the page(s) you are working on to have them reload without manually refreshing the browser:

html <meta http-equiv="refresh" content="1;">

54.1.0 1/19/2023

54.0.0 1/19/2023

- ๐ŸŽ‰ `link` nodes can now have `target`. This link will open in blank tab. https://scroll.pub This link target _blank title Title can also be set.

53.0.2 1/18/2023

53.0.1 1/17/2023

53.0.0 1/17/2023

52.2.1 1/16/2023

52.2.0 1/13/2023

html <b>here is some html</b> here is some html

52.1.1 1/12/2023

52.1.0 1/12/2023

52.0.0 1/10/2023

51.0.0 1/9/2023

50.2.0 1/5/2023

50.1.0 1/5/2023

50.0.0 1/4/2023

For example^exampleFootnote

For example1

1 This is an example footnote. โฎ

^exampleFootnote This is an example footnote.

49.1.0 1/4/2023

49.0.0 1/4/2023

48.3.0 1/2/2023

48.2.0 1/2/2023

48.1.0 1/2/2023

48.0.0 1/1/2023

This release simplifies and removes things from the default install.

47.4.0 12/30/2022

47.3.0 12/29/2022

47.2.1 12/29/2022

47.2.0 12/29/2022

47.1.2 12/05/2022

47.1.1 11/30/2022

47.1.0 11/29/2022

47.0.0 11/28/2022

This is a major breaking refactor. Scroll now generates flat html. This release is NOT recommended for the feint of heart. Wait a day or two until the bugs are ironed out.

46.2.0 11/27/2022

46.1.0 11/27/2022

46.0.0 11/27/2022

This is a major breaking refactor. All the implicit imports are gone. Everything must be explicitly included now (perhaps with a few slight exceptions like meta tags). This migration guide is a work in progress. This release is NOT recommended for the feint of heart. Wait a day or two until the bugs are ironed out.

45.0.0 11/24/2022

Footnotes example

Brockton is a city in Massachusetts2. It was incorporated in 18813.

Notes

2 A state in the United States. โฎ

3 Incorporated as a city in 1881, but as a town in 1821. Wikipedia. โฎ

44.0.1 11/24/2022

44.0.0 11/24/2022

This is the title simplification refactor release.

43.1.1 2022.11.22

43.1.0 2022.11.14

43.0.1 2022.11.14

43.0.0 2022.11.12

42.0.0 2022.11.09

41.0.0 2022.11.08

search ^# (\d+\.\d+\.\d+) (\d+)\-(\d+)\-(\d+) replace # $1 $4.$2.$3

40.0.0 2022.11.05

You can now use all aftertext directives like bold in caption nodes. Note: in the future we may just remove the keyword caption and you can just use * directly.

39.0.0 2022.11.03

comment Add the content below to feed.scroll import settings.scroll permalink feed.xml template blank printFeed index comment Add the line below to your posts and/or settings import file. rssFeedUrl feed.xml

38.2.0 2022.11.01

38.1.0 2022.11.01

38.0.0 2022.10.31

37.1.1 2022.10.28

37.1.0 2022.10.28

37.0.0 2022.10.28

The goal of this release is to simplify and speed up Scroll by removing legacy features.

This is a major release that removes a bunch of the original keywords in favor of the newer more advanced aftertext nodes.

If you don't want to upgrade at this time, it's very easy to just add the removed grammar definitions from this commit into your existing scrolls using the normal extension pattern.

You can also easily alias the newer aftertext node types with the original keywords above if you'd prefer.

36.1.0 2022.10.27

36.0.1 2022.10.24

36.0.0 2022.10.22

35.1.2 2022.10.12

35.1.1 2022.10.12

35.1.0 2022.10.05

- ๐ŸŽ‰ Added new better way to do lists.

35.0.0 2022.10.04

34.2.0 2022.10.03

34.1.0 2022.10.02

34.0.3 2022.9.30

34.0.2 2022.9.30

34.0.1 2022.9.30

34.0.0 2022.9.30

33.1.0 2022.9.29

33.0.0 2022.9.29

32.0.0 2022.9.27

31.5.0 2022.9.9

A Header

A Subheader

Have you thought of the most important question?

31.4.1 2022.9.3

31.4.0 2022.9.3

This is a thought. It's like a condensed form of aftertext with bold and italics and code turned on by default.

* This is a _thought_. It's like a condensed form of aftertext with *bold* and _italics_ and `code` turned on by default. hoverNote default And it supports hover notes!

Reading lists

Projects I'm very actively working on:


readingList https://pldb.com PLDB.com https://scroll.pub Scroll https://breckyunits.com A Blog by Breck Yunits

31.3.0 2022.9.3

31.2.0 2022.9.2

31.1.0 2022.9.1

31.0.0 2022.8.31

30.1.1 2022.8.30

30.1.0 2022.8.29

30.0.0 2022.8.29

29.0.0 2022.8.28

28.3.2 2022.8.27

28.3.1 2022.8.27

28.3.0 2022.8.27

28.2.0 2022.8.26

28.1.0 2022.8.26

28.0.0 2022.8.26

This is a major update that radically simplifies Scroll and adds significant new capabilities.

From 3 file types to 1

scroll.settings and *.grammar files are gone. Everything is now done with .scroll files, and now every keyword is documented and usable on try.scroll.com and type checked.

Imports and variables

Use import [filepath] to import one file into another. Use replace and replaceDefault for variables.

Add your own Grammar extensions directly in your Scroll files

Define new nodeTypes or create your own aliases on a per file basis. Use the import keyword and build your own collection of common reusable node types for your project(s).

Unlimited Groups and Group Pages

Add files to one or more groups and then customize how each group page prints. No more magic or implicit creation of collection pages.

Multiple Compiler Passes

The new language features (imports, grammar nodes, and variables) required a change from a 1 one stage compilation process to a multi-stage compiler pass pattern. The compilers passes run in this order: imports, grammar extensions, then variables. So variables cannot be used in imports or grammar extensions.

Change list

scrollArticleDateComponent => scrollDateComponent scrollArticlePageComponent => scrollFilePageComponent scrollSingleArticleTitle => scrollFilePageTitle scrollIndexPageArticleContainerComponent => scrollGroupPageFileContainerComponent scrollArticleSourceLinkComponent => scrollFileViewSourceUrlComponent scrollIndexPageComponent => scrollGroupPageComponent scrollIndexPageFileContainerComponent => scrollGroupPageFileContainerComponent

Updating custom CSS

comment Put this in a file named style.scroll permalink style.css settings noTemplate printScrollCSS

27.1.1 2022.8.24

27.1.0 2022.8.24

27.0.1 2022.8.23

27.0.0 2022.8.23

26.1.0 2022.8.23

26.0.0 2022.8.23

25.6.0 2022.8.19

25.5.1 2022.7.22

25.5.0 2022.7.22

25.4.0 2022.7.14

25.3.2 2022.7.14

25.3.1 2022.7.14

25.3.0 2022.7.14

treeTable row name Javascript example console.log("Hello world") row name Python example # A code block print "Hello world"
name example
Javascript
console.log("Hello world")
Python
# A code block
print "Hello world"

25.2.1 2022.7.01

25.2.0 2022.6.22

25.1.0 2022.6.19

25.0.0 2022.6.15

24.9.0 2022.6.15

24.8.0 2022.6.15

24.7.0 2022.6.13

24.6.0 2022.6.10

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

Some !simple! and *advanced* usages. An #absolute link# and @@@a relative link@@@. Show some ++added text++ or some --deleted text--. wrap ! em wrap * b wrap # https://example.com wrap @@@ a href="potato.html" wrap ++ span style="color:green" wrap -- span style="color:red; text-decoration: line-through;"

24.5.0 2022.6.10

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

Support for traditional *bold*, `code`, and _italics_ in aftertext with the keyword `wrapsOn`.

24.4.0 2022.6.08

24.3.1 2022.5.25

24.3.0 2022.2.16

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

Caveat Example

This is a great idea.

This is a great idea. hoverNote 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.

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

24.2.0 2022.1.18

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 2022.1.13

24.1.0 2022.1.13

24.0.0 2022.1.11

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

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

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 2021.12.22

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

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

How much wood can a woodchuck chuck if a woodchuck could chuck wood? 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 2021.12.21

23.0.0 2021.12.09

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:

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 2021.11.25

This is a caption

image blog/screenshot.png caption This is a caption

22.3.0 2021.08.23

22.2.0 2021.08.23

22.1.0 2021.07.23

22.0.0 2021.07.09

21.4.0 2021.07.08

21.3.0 2021.07.07

21.2.0 2021.07.06

21.0.0 2021.06.21

20.0.0 2021.06.21

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 2021.06.20

19.3.0 2021.06.20

19.2.0 2021.06.17

19.1.0 2021.06.17

19.0.0 2021.06.17

18.4.0 2021.06.17

18.3.0 2021.06.16

18.2.0 2021.06.16

18.1.1 2021.06.16

18.1.0 2021.06.16

18.0.0 2021.06.15

17.5.0 2021.06.05

17.4.0 2021.06.04

17.3.0 2021.06.03

17.2.2 2021.06.02

17.2.1 2021.05.25

17.2.0 2021.05.25

17.1.0 2021.05.25

what why
PipeTable Because it's awesome!

17.0.0 2021.05.25

16.2.0 2021.05.24

16.1.0 2021.05.24

16.0.0 2021.05.22

15.0.0 2021.05.21

14.3.0 2021.05.21

14.2.0 2021.05.20

14.1.0 2021.05.20

14.0.0 2021.05.19

13.3.0 2021.05.18

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 2021.05.18

13.1.0 2021.05.18

13.0.0 2021.05.17

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 ScrollScript, you have a number of options if the conventional design doesn't work for you. Your options are:

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 2021.05.14

You can now do dialogues
Cool!

12.0.0 2021.05.12

11.0.0 2021.05.11

10.0.0 2021.05.10

9.0.0 2021.05.05

8.0.0 2021.04.10

7.0.0 2021.04.03

6.0.0 2021.03.08

5.0.0 2021.02.28

4.2.0 2021.02.22

4.1.0 2021.02.22

View source