Re: [pollen] Citations

2017-12-19 Thread Matthew Butterick

> On Dec 19, 2017, at 8:13 AM, jakedrake.r...@gmail.com wrote:
> 
> AFAICT, the main advantage of Pollen over Scribble is that Pollen is more 
> extensible so that a user could customize the latex template and easily add 
> new tag functions. Is that indeed the case?

You can add tags to Scribble too. But with Scribble you're working through an 
intermediate abstraction (that is, the Scribble document model). With Pollen, 
you aren't. 

It's analogous to using a big JavaScipt app framework vs. vanilla JavaScript. 
With a framework, you get a lot of functionality for free. But you have to 
learn the framework. And accept its limitations. Without it, you have to handle 
more heavy lifting at the outset. But you get more control over the outcome.




> Faced with a new writing project, it would be useful to learn the advantages 
> of pollen vs scribble and other products. I believe you make the case, in 
> part, for something like pandoc vs pollen. As a suggestion, this might be a 
> useful item to add to the documentation

I agree. But I've never seriously used Pandoc or LaTeX, so I have no insights 
on how Pollen compares. (Though someone who does would be welcome to contribute 
a relevant section to the docs.)

-- 
You received this message because you are subscribed to the Google Groups 
"Pollen" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to pollenpub+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.


Re: [pollen] Citations

2017-12-19 Thread Matthew Butterick

> On Dec 19, 2017, at 4:22 AM, J Lorieau  wrote:
> 
> 1. I'd like to test out the functionality for bibtex citation rendering in 
> Scribble, but the API from Racket is somewhat opaque and difficult to 
> use--this is largely due to my inexperience with racket and lisps. I have yet 
> to use these functions to render a single citation from a bibtex file.

That might be a better question for the main Racket mailing list, because many 
of its members are publishing academic papers with Scribble, using its 
templates that target LaTeX:

https://docs.racket-lang.org/scribble/generic-prose.html?q=sigplan 
 




> 2. I believe an alternative would be to try to incorporate scribbler code 
> that renders into pollen tags. Would this approach be feasible?
> 
> https://docs.racket-lang.org/scriblib/autobib.html

Scribble is designed more as an end-to-end system. I've found it's hard to 
usefully extract parts of Scribble and use them elsewhere, because they assume 
cooperation the Scribble document model:

https://docs.racket-lang.org/scribble/core.html?q=prepart#%28part._parts%29 


No such model exists in Pollen (deliberately).

-- 
You received this message because you are subscribed to the Google Groups 
"Pollen" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to pollenpub+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.


[pollen] Citations

2017-12-19 Thread J Lorieau
I'm coding up tags for a textbook, and I'm not stuck with citations tags. 
I'm sending this note to ask for advice on how to implement this 
functionality.

As far as I can tell, there are at least 3 options:

1. I'd like to test out the functionality for bibtex citation rendering in 
Scribble, but the API from Racket is somewhat opaque and difficult to 
use--this is largely due to my inexperience with racket and lisps. I have 
yet to use these functions to render a single citation from a bibtex file.

2. I believe an alternative would be to try to incorporate scribbler code 
that renders into pollen tags. Would this approach be feasible?

https://docs.racket-lang.org/scriblib/autobib.html

3. Finally, I could try to use external programs to render the citation. I 
haven't cobbled together a set of programs that can do this robustly, but I 
like this option since the citations would appear identically between pdf 
and html outputs.

Once I've coded this up, I'd be happy to contribute some of the code back. 
Joel has done some nice work with most html/latex tags, but there are some 
that could use additional functionality. For example, I've coded equations 
that render to svg in html (and natively in latex), since mathjax can be 
somewhat limited (and slow) for some equations. Also, I've made figure and 
image tags that natively convert images for html.

Thanks!

J Lorieau


-- 
You received this message because you are subscribed to the Google Groups 
"Pollen" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to pollenpub+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.