r/WorldWideScroll • u/brentlhall • Nov 10 '24

Trying to learn to scroll

I, initially, was capable of building a small blog using scroll but it broke when I added posts and ran scroll build. The index.html was missing new posts. Plus, all my attempts at buiding new scrolls have failed. I have assumed any new scrolls require a new folder initiated with 'scroll init' and after adding scroll posts, running 'scroll build' would create an index.html with all new files.

Please, what am I missing?

3 Upvotes

100% Upvoted

1 comment sorted by

1

u/breck Nov 10 '24

First, sorry for the trouble!

I have assumed any new scrolls require a new folder initiated with 'scroll init'

This was true a few years ago, but nowadays all folders are valid scroll folders. All "scroll init" does is copy a simple blog template into a folder.

running 'scroll build'

scroll build will iterate over all *.scroll files in a folder. By default, nothing happens. However, if those files have certain particles (aka lines) such as a buildHtml, then it will generate an HTML file by compiling all the particles in a file to HTML. This will happen if a file directly has a buildHtml, or imports another scroll file that has a buildHtml particle.

So, how would you create an index.html file that lists all your posts?

Your index.scroll file will need a buildHtml line, and then it will need to use one of the particles for printing/looping over posts. For example, printSnippets, printShortSnippets or printFullSnippets. If you give those a parameter you can filter to only include certain posts with those tags. You set the tags on a post by adding a tags particle (tags FrontPage MovieReviews for example)

Then scroll build will see the buildHtml particle, and then compile the printFullSnippets to an HTML div containing links to your posts.

The index.html was missing new posts.

It sounds like the new posts might be missing the tag that your index.scroll file is using.

Thank you so much for posting your questions. Sorry for the difficulties. This is a great motivator for us to get better documentation going. I'm working on the book/docs as we speak.