Steps to setup the project:

1. Run raco pkg install --auto tr in the project
2. Creates a directory mkdir your-site and goes into it
3. Run raco tr init then update site.json

raco tr init do the following

1. Create .gitignore with

   _tmp/
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             _build/
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             assets/

2. Create site.json with

   {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               "domain": "your domain",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               "title": "your site title",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               "description": "your site description"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             }

3. git clone https://git.sr.ht/\~dannypsnl/tr-assets assets
4. Create directory content and content/post
5. git init

Now you can add some *.scrbl in content/ directory as you wanted. Each *.scrbl is called a card.

Directory content/post is treated specially in that RSS only use cards in this directory as items.

A card addr.scrbl (no matter its full path) has an address addr, and the address must be unique in the whole TR project.

The content of card mostly are just HTML in at-exp form, scribble HTML describes more about what can be used.

Further guide will teach you what's in the toolbox.

There are several metadata can be set to a card, list as below:

1. @taxon{...} it accepts a text
2. @title{...} it accepts a list of forms
3. @author{...} it only accepts a card address
4. @author/literal{...} it accepts a text
5. @date{...} it accepts a text, but I suggest in yyyy/mm/dd format
6. @toc/depth[n] it accepts an integer, which is the depth of generated TOC, the default value is 2

You can use @mention{addr} to mention a card, it will tell addr it has a backlinks, e.g. I can mention the guide itself Guide. If the mentioned card has taxon Reference, it will not be a related card, but a references card, let me mention a cool book as an example 10 PRINT CHR$(205.5+RND(1)); : GOTO 10.

You can use @transclude{addr} to include a card, it will tell addr it has a context. This guide itself is an example of transclude.

Embed external web page

Since you can use any HTML, iframe for sure is counted, you can embed external web page, e.g.

tr use Katex in two forms: @m{...} and @mm{...}. One for inline and one for block, e.g. @m{a \in \R} produces $a \in \R$ ; @mm{ \int_{a}^{b} x^2 \,dx } produces

Except Katex, tr also supports backend LaTeX solution, you can put tikz program in @tikzcd{...} block to draw quiver, for example

Or @texfig{...} for more flexible input (anything allowed in LaTeX document block). For example

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          @texfig{
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          ...
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          

If you want to use packages, write as below (the change is introduced since texfig now must manually assigns LaTeX header part)

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          @texfig[#:header @"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          \usepackage{tikz}
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          \usetikzlibrary{spath3, intersections, backgrounds}
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          "]{
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          ...
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          

If you face error like raco tr cannot find such command, run raco setup.

1. Run raco tr build to build HTMLs
2. Run raco tr watch to watch content changes and build on fly
3. Run raco tr next to get next available address, for example, you might like to run

   vi $(raco tr next xxx).scrbl

   to work on a new file (replace vi with any command line editor command)

The output directory is _build, run python3 -m http.server -d _build to view result, or upload it to host.