News for hackers. Stuff that matters.
Re:How to make a book with Pollen by aaronbasssett on Sunday August 09, 2015 @02:32PM (#10030986)
I have no idea what Pollen does. The homepage really doesn't explain anything, and even after skimming the tutorials and the quick tour I still don't know.

Is it a static site generator? A blogging engine? Does it create PDFs? Epub? I have no idea.

Re:How to make a book with Pollen by capnrefsmmat on Sunday August 09, 2015 @02:48PM (#10031054)
I think of it as LaTeX for HTML. You write markup and Racket code that produce websites; the author used it for his web book Practical Typography: http://practicaltypography.com/

Since you can write arbitrary Racket, you can create markup for anything you want. Write some code that automatically generates plots, formats code examples, makes custom asides and footnotes -- just like you can write arbitrary macros for LaTeX to do all sorts of things. Except with Racket instead of TeX macro goo.

It natively outputs HTML but you could have it render anything vaguely XML-y.

At the moment it feels more like TeX than LaTeX, since it provides the low-level features but not a default setup for building specific things. I'd like to try it to write a website, but there's a steep startup cost of reimplementing all the basic macros first.

Re:How to make a book with Pollen by gus_massa on Sunday August 09, 2015 @03:16PM (#10031201)
The author should copy this in the site. The information is available in the menu, but you must enter in each one and read them to understand the general idea.
Re:How to make a book with Pollen by chipotle_coyote on Sunday August 09, 2015 @02:41PM (#10031019)
The first sentence of the documentation tells you:

"Pollen is a publishing system that helps authors create beautiful and functional web-based books."

I think it might be good to get something like that on that introductory page, though, you're right.

Re:How to make a book with Pollen by michael_storm on Sunday August 09, 2015 @08:34PM (#10032118)
Which could be, as the GP said, a static site generator, blogging engine, ePubs, etc.

If your one-line intro for anything includes the word "system", stop and rewrite. For example:

Pollen helps authors create beautiful and functional web-based books that are written as programs that generate HTML.

Never-have-I-ever seen anything that confuses "feature" and "benefit" so much as this project. Why do I want my next book to be a program? A 20-minute video explaining it is almost condescending.

Re:How to make a book with Pollen by userbinator on Monday August 10, 2015 @12:41AM (#10032687)
If your one-line intro for anything includes the word "system", stop and rewrite.

Or "solution", for that matter; regardless of whether "enterprise" is also present.

Re:How to make a book with Pollen by Semiapies on Sunday August 09, 2015 @08:19PM (#10032060)
And when someone does that, people here complain about reading through lengthy introductions before they see any code. I presume it's a misguided attempt to satisfy such people that the book goes Installation, Quick Tour, then Backstory (before the Tutorials). In the end, it's not worthwhile to cater to this sort of "reader".
Re:How to make a book with Pollen by Semiapies on Sunday August 09, 2015 @06:29PM (#10031797)
If you "skimmed" the tour and tutorials and don't know what it is, stop skimming. Then, start reading.

This isn't some arcane library you need domain-specific knowledge to understand, it's a system with a purpose and intent that's quite explicitly explained.