From 3c39efdeada7c64594f32d14f36a393dbe409d30 Mon Sep 17 00:00:00 2001 From: Joel Dueck Date: Wed, 17 Jun 2020 21:34:29 -0500 Subject: [PATCH] small edits --- pollen/scribblings/tutorial-first.scrbl | 2 +- pollen/scribblings/tutorial-second.scrbl | 3 --- 2 files changed, 1 insertion(+), 4 deletions(-) diff --git a/pollen/scribblings/tutorial-first.scrbl b/pollen/scribblings/tutorial-first.scrbl index 6bcfccd..8305baf 100644 --- a/pollen/scribblings/tutorial-first.scrbl +++ b/pollen/scribblings/tutorial-first.scrbl @@ -32,7 +32,7 @@ As I mentioned in the @secref["big-picture"], Pollen is built using Racket, and But if not, or if you're just a curious character: -One of the key features of Racket as a programming language is that it provides tools to create @italic{other} programming languages. These languages might look & behave @link["http://docs.racket-lang.org/ts-guide/index.html"]{like Racket}. Or they @link["http://hashcollision.org/brainfudge/"]{might not}. These languages might serve a general purpose, but more often they're specialized for a particular purpose, in which case they're known as @italic{domain-specific languages}, or @italic{DSLs}. +One of the key features of Racket as a programming language is that it provides tools to create @italic{other} programming languages. These languages might look & behave @link["http://docs.racket-lang.org/ts-guide/index.html"]{like Racket}. Or they @link["http://hashcollision.org/brainfudge/index.html"]{might not}. These languages might serve a general purpose, but more often they're specialized for a particular purpose, in which case they're known as @italic{domain-specific languages}, or @italic{DSLs}. If you find this a strange idea, you're not alone. Most programmers — and until recently, me too — have never made or used DSLs. If you have a programming problem to solve, you start with a general-purpose language like Python or Java or Ruby, and go from there. Nothing wrong with that. diff --git a/pollen/scribblings/tutorial-second.scrbl b/pollen/scribblings/tutorial-second.scrbl index b22094a..303f6f7 100644 --- a/pollen/scribblings/tutorial-second.scrbl +++ b/pollen/scribblings/tutorial-second.scrbl @@ -371,9 +371,6 @@ Finally, we need to include the X-expression from our source file. By convention ◊(->html (html (head (meta #:charset "UTF-8")) (body doc))) } - -@margin-note{You can change the name of @code{doc} by overriding @racket[default-main-export].} - To summarize: this template contains a skeletal HTML page (in X-expression format). We drop @code{doc} into the template to indicate where the X-expression of our source file should be inserted. Finally, we convert the whole X-expression to HTML with @racket[->html]. ``So I have to convert my HTML template to an X-expression?'' No. That's optional. You can also put hard-coded HTML in your template. Here's an equivalent way of writing @filepath{fallback.html.p}, with explicit HTML: