#BASIC SYNTAX FOR SIMPLETAG IS CODE#

For true mutation, you could also use set! - not wrong, but not idiomatic. Though you’re not really mutating the variable - you’re creating copies, all of which have the same name. Let* is the idiomatic Racket way to do what looks like mutation. If you don’t use a rest argument, and pass multiple text arguments to your tag function, you’ll get an error (namely an “arity error,” which means the function got more arguments than it expected).

Why? Because in Pollen notation, the is a multiline block). Tag functions should end with a rest argument. Tx-elements is a rest argument, as in “put the rest of the arguments here.” Most definitions of If we don’t have anything to link, use url as the link text too. Tx-elements is an optional argument that represents the text (or other content) that gets linked. The definition of link follows the arguments above.Ĭss-class is a keyword argument (= must be introduced with #:class) and also optional (if it’s not provided, it will default to #f). '(a ((href 'url')(class 'name')) 'text to link') If we were using #lang racket, these next libraries would already be imported. Though require declarations can live anywhere at the top layer of a source file, it’s typical to consolidate them at the top. Same directory or subdirectories (unless superseded by another 'pollen.rkt' within a subdirectory).įor more, see Introducing 'pollen.rkt' in the main Pollen docs. Everything provided from a 'pollen.rkt' is automatically available to #lang pollen source files in the The 'pollen.rkt' source file is the main source of functions and values for the source files in a Pollen project.

#BASIC SYNTAX FOR SIMPLETAG IS CODE#

The result is that if you require this file normally, you’ll get the usual functions and values but if you run it with Scribble, it turns into the documentation you see here.Īside from that wrinkle, all the code shown here is standard racket/base, and can be copied & adapted for your own 'pollen.rkt' files written in #lang racket/base (or #lang racket). There’s nothing special about the chunk name - it’s just a label that #lang scribble/lp2 will use to snap the code together at the end. 1.4.2.1 Making tagged X- expressions (txexprs)

Basic syntax for simpletag is