{"size": 2640, "ext": "scrbl", "max_stars_repo_path": "pollen/scribblings/pollen.scrbl", "max_stars_repo_name": "Bogdanp/pollen", "max_stars_repo_stars_event_min_datetime": null, "max_stars_repo_stars_event_max_datetime": null, "max_issues_repo_path": "pollen/scribblings/pollen.scrbl", "max_issues_repo_name": "Bogdanp/pollen", "max_issues_repo_issues_event_min_datetime": null, "max_issues_repo_issues_event_max_datetime": null, "max_forks_repo_path": "pollen/scribblings/pollen.scrbl", "max_forks_repo_name": "Bogdanp/pollen", "max_forks_repo_forks_event_min_datetime": null, "max_forks_repo_forks_event_max_datetime": null}
{"max_stars_count": null, "max_issues_count": null, "max_forks_count": null, "avg_line_length": 47.1428571429, "max_line_length": 441, "alphanum_fraction": 0.7662878788}
#lang scribble/manual

@title[#:style 'toc]{Pollen: the book is a program}

@author[(author+email "Matthew Butterick" "mb@mbtype.com")]

@defmodulelang[pollen]

Pollen is a publishing system that helps authors make functional and beautiful digital books.

I created Pollen so I could make my web-based books @link["http://practicaltypography.com"]{@italic{Practical Typography}}, @link["http://typographyforlawyers.com"]{@italic{Typography for Lawyers}}, and @link["http://beautifulracket.com"]{@italic{Beautiful Racket}}. Sure, go take a look. Are they better than the last digital books you encountered? Yes they are. Would you like your next digital book to work like that? If so, keep reading.

At the core of Pollen is an argument:

@itemlist[#:style 'ordered

@item{Digital books should be the best books we've ever had. So far, they're not even close.}

@item{Because digital books are software, an author shouldn't think of a book as merely data. @bold{The book is a program.}}

@item{The way we make digital books better than their predecessors is by exploiting this programmability.}]

That's what Pollen is for.

Not that you need to be a programmer to start using 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 @link["http://racket-lang.org"]{Racket}. I chose Racket because it has some unique features that made Pollen possible. So if it's unfamiliar to you, don't panic. It was unfamiliar to me. Once you see what you can do with Racket & Pollen, you may be persuaded. I was.

Or, if you can find a better digital-publishing tool, use that. But I'm never going back to the way I used to work.


@local-table-of-contents[]


@include-section["installation.scrbl"]
@include-section["quick.scrbl"]
@include-section["story.scrbl"]
@include-section["big-picture.scrbl"]
@include-section["tutorial-first.scrbl"]
@include-section["tutorial-second.scrbl"]
@include-section["tutorial-third.scrbl"]
@include-section["tutorial-fourth.scrbl"]
@include-section["tutorial-mini.scrbl"]
@include-section["raco.scrbl"]
@include-section["formats.scrbl"]
@include-section["command.scrbl"]
@include-section["programming-pollen.scrbl"]
@include-section["module-reference.scrbl"]
@include-section["unstable-module-reference.scrbl"]
@include-section["more-help.scrbl"]
@include-section["acknowledgments.scrbl"]
@include-section["license.scrbl"]
@include-section["version-history.scrbl"]

@index-section[]
