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.

Re:How to make a book with Pollen by dsr_ on Sunday August 09, 2015 @05:15PM (#10031621)
I don't think I can forgive the use of ◊ as an escape character, though. It is not on any commonly used keyboard, so unless the intent was to make users avoid it as much as possible, it's just too awful to put up with.
Re:How to make a book with Pollen by Tomte on Sunday August 09, 2015 @11:14PM (#10032477)
You can define the command character to be anything you like by setting a single variable.
Re:How to make a book with Pollen by brudgers on Sunday August 09, 2015 @11:25PM (#10032497)
Per the docs it's option-shift-V on a Mac...and more effort on other systems.
Re:How to make a book with Pollen by omaranto on Sunday August 09, 2015 @03:10PM (#10031158)
Is there any written discussion of advantages that Pollen has over racket Scribble? It sounds extremely similar.
Re:How to make a book with Pollen by Semiapies on Sunday August 09, 2015 @06:31PM (#10031800)
In the documentation.

It's built on top of Scribble.

Re:How to make a book with Pollen by omaranto on Tuesday August 11, 2015 @11:31PM (#10045876)
I knew it was built on top of scribble, I was looking for a concise description of why it was built at all (instead of just using scribble directly).
Re:How to make a book with Pollen by macmac on Sunday August 09, 2015 @02:33PM (#10030991)
Please note that on OSX you have to manually add the Racket binaries to your path. If you use zsh and Racket v6.2 for instance you could add the following to your .zshrc: export PATH=$PATH:/Applications/Racket\ v6.2/bin
Re:How to make a book with Pollen by weeksie on Sunday August 09, 2015 @06:27PM (#10031792)
Man, I feel out of touch. Dr. Scheme is now called Racket?

I'll crawl back under my rock. . . .

Re:How to make a book with Pollen by criddell on Sunday August 09, 2015 @04:56PM (#10031555)
I've been thinking about Pollen a little bit lately after reading about it when I was researching Racket and domain specific languages (DSL's).

Would it be wrong to call Pollen a DSL?

Re:How to make a book with Pollen by Semiapies on Sunday August 09, 2015 @06:30PM (#10031798)
It's absolutely a DSL.
Re:How to make a book with Pollen by vermontdevil on Sunday August 09, 2015 @03:06PM (#10031147)
It's web based book

here's an book published by the author/developer to get the idea.

http://practicaltypography.com

Re:How to make a book with Pollen by pseingatl on Monday August 10, 2015 @09:51AM (#10034540)
It needs a front end. If this is the web version of TeX, it needs LaTeX and TeXshop or Kile. You're not suggesting that text be originally written in Pollen, are you?
Re:How to make a book with Pollen by asimjalis on Sunday August 09, 2015 @04:18PM (#10031426)
How is this better or different from Pandoc?
Re:How to make a book with Pollen by qznc on Sunday August 09, 2015 @04:49PM (#10031531)
Different.

Pandoc is about reading lots of formats (eg Markdown) and writing lots of formats (eg epub, pdf, html). It has enough config options that you can reasonably produce books with it.

Pollen is like TeX. It has one input format, which is a Turing-complete programming language. It can output a limited number of formats. You have much more control about the output than with Pandoc, so can do visually pleasing typography.

Re:How to make a book with Pollen by jimhefferon on Sunday August 09, 2015 @03:25PM (#10031245)
Is there any way to include a good amount of mathematical text?
Re:How to make a book with Pollen by oandrei on Sunday August 09, 2015 @11:08PM (#10032465)
I developed this: http://andreimikhailov.com/slides/bystroTeX/slides-manual/in... and it seems to work, for example: http://andreimikhailov.com/teaching/gdmc/exterior-calculus/i... I wish I had time to polish it more. It is also Scribble, but unrelated to Pollen.
Re:How to make a book with Pollen by xrayspec on Sunday August 09, 2015 @04:14PM (#10031406)