From 9738f349d4707bd164dd1f0f34451a4f51df225c Mon Sep 17 00:00:00 2001 From: Matthew Butterick Date: Mon, 24 Mar 2014 17:48:58 -0700 Subject: [PATCH] updates --- scribblings/command.scrbl | 2 +- scribblings/pollen.scrbl | 9 ++++++--- 2 files changed, 7 insertions(+), 4 deletions(-) diff --git a/scribblings/command.scrbl b/scribblings/command.scrbl index e6eaabe..4b8bbfe 100644 --- a/scribblings/command.scrbl +++ b/scribblings/command.scrbl @@ -10,7 +10,7 @@ @(define (at-exp-racket) @racket[#, @hash-lang[] #, @racketmodname[at-exp] #, @racketidfont{racket}]) -@title[#:tag "reader"]{Pollen ◊ command overview} +@title[#:tag "reader"]{◊ command overview} @section{The golden rule} diff --git a/scribblings/pollen.scrbl b/scribblings/pollen.scrbl index 02b4139..83345d5 100644 --- a/scribblings/pollen.scrbl +++ b/scribblings/pollen.scrbl @@ -25,13 +25,13 @@ At the core of Pollen is an argument: @item{Third, that the way we make digital books better than their predecessors is by exploiting this programmability.}] -How? Pollen. +That's what Pollen is for. Not that you need to be a programmer to use Pollen. On the contrary, the Pollen language is markup-based, so you can write & edit text naturally. But when you want to automate repetitive tasks, add cross-references, or pull in data from other sources, you can access a full programming language from within the text. That language is Racket. I chose Racket because while the idea for Pollen had been with me for several years, it simply wasn't possible to build it with other languages. So if it's unfamiliar to you, don't panic. It was unfamiliar to me. Once you see what you can do with Pollen & Racket, you may be persuaded. I was. -Or, if you can find a better digital book-publishing tool, use that. Personally, I'm never going back to the way I used to work. +Or, if you can find a better digital publishing tool, use that. Personally, I'm never going back to the way I used to work. @local-table-of-contents[] @@ -51,7 +51,7 @@ After that, you can update the package from the command line: @include-section["why-pollen.scrbl"] -@section{Pollen source formats} +@section{Source formats} @defmodulelang[pollen] @@ -70,6 +70,9 @@ If the file extension is ``@(format ".~a" world:markdown-source-ext)'', the sour @defmodulelang[pollen/markdown] +@include-section["command.scrbl"] + + @include-section["module-reference.scrbl"]