5 ms·
How to make a book with Pollen
- asimjalis 11y agoHow is this better or different from Pandoc?
- qznc 11y agoDifferent. 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.
- aaronbasssett 11y agoI 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.
- chipotle_coyote 11y agoThe 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.
- Semiapies 11y agoAnd 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".
- michael_storm 11y agoWhich 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.
- userbinator 11y agoIf 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.
- capnrefsmmat 11y agoI 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/ 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.
- gus_massa 11y agoThe 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.
- Semiapies 11y agoIf 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.
- macmac 11y agoPlease 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
- vermontdevil 11y agoIt's web based book here's an book published by the author/developer to get the idea. http://practicaltypography.com http://practicaltypography.com
- omaranto 11y agoIs there any written discussion of advantages that Pollen has over racket Scribble? It sounds extremely similar.
- jimhefferon 11y agoIs there any way to include a good amount of mathematical text?
- xrayspec 11y agoSupports MathJax http://pkg-build.racket-lang.org/doc/pollen/mini-tutorial.html#%28part._.Math_typesetting_with_.Math.Jax%29 http://pkg-build.racket-lang.org/doc/pollen/mini-tutorial.ht...
- oandrei 11y agoI developed this: http://andreimikhailov.com/slides/bystroTeX/slides-manual/index.html http://andreimikhailov.com/slides/bystroTeX/slides-manual/in... and it seems to work, for example: http://andreimikhailov.com/teaching/gdmc/exterior-calculus/index.html 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.
- criddell 11y agoI'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?
- Semiapies 11y agoIt's absolutely a DSL.
- dsr_ 11y agoI 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.
- weeksie 11y agoMan, I feel out of touch. Dr. Scheme is now called Racket? I'll crawl back under my rock. . . .
- pseingatl 11y agoIt 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?