< >

Scroll Release Notes

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

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 Massachusetts1. It was incorporated in 18812.

Notes

1. A state in the United States.

2. 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. footnote default And it supports footnotes!

Projects list

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

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`. 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. 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.

* 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 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? 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 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 public/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

index.html Β· releaseNotes.html Β· index.html

View source

Built with Scroll v47.1.1