more on github pages

CSL Development
1

So I prettied up the index page:

http://citation-style-language.github.com/styles/

And I have a feeling we can get pretty far with github pages support.

I guess the key question is how to get style previews in this environment?

Possible options:

  1. use citeproc-js client side

  2. pre-cook the previews, maybe using pandoc to run the style and
    output markdown files that jekyll can process

Any thoughts on which is the better/more practical approach?

On design, something like this might be adaptable:

http://www.sohtanaka.com/web-design/examples/smart-columns/

So create the full index page, have a filter field using jquery at the
top, and stick the previews in the image area, maybe where hovering
over it expands it?

Bruce

2

Ad 2) — do github pages support requiring custom gems? If so it would (soon) be easy to make Jekyll process the preview items every time the page is generated using citeproc-ruby inside of a Jekyll Converter (*).

(*) https://github.com/mojombo/jekyll/wiki/Plugins

This is something I could look into once I have put together a gem version 0.0.1.

3

That would be awesome if we could do that, though I kind of doubt
github would allow it.

Bruce

5

Bruce,On Mar 20, 2011, at 3:12 PM, Bruce D’Arcus wrote:

On this …

On Thu, Mar 17, 2011 at 1:11 PM, Bruce D’Arcus <@Bruce_D_Arcus1> wrote:

On Thu, Mar 17, 2011 at 12:50 PM, Sylvester Keil <@Sylvester_Keil> wrote:

…

Ad 2) — do github pages support requiring custom gems? If so it would (soon) be easy to make Jekyll process the preview items every time the page is generated using citeproc-ruby inside of a Jekyll Converter (*).

(*) Home · jekyll/jekyll Wiki · GitHub

This is something I could look into once I have put together a gem version 0.0.1.

That would be awesome if we could do that, though I kind of doubt
github would allow it.

Here’s someone that recently came across the issue, and a) concluded
the answer to your question is “no”, but b) found a workaround of
sorts.

http://ilkka.github.com/blog/2010/11/20/hosting-a-jekyll-blog-with-extensions-on-github/

Nice. :wink: That’s a clever solution!

As for a Jekyll Converter, I thought it would be cool to have it simply convert an entire .bib file (containing lots of CSL relevant custom tags) — or would you suggest a different data format for input?

Sylvester

6

I’m not a fan of bibtex. I would support the CSL json as the main
input format, but add other format mappings (like bibtex) as you like.

For comparison, with pandoc, citeproc-hs just figures out the bib
input format by the extension (and uses bibutils to do the actual
conversion to MODS, which citeproc-hs parses). That’s a good approach
in my view.

Though it’s not now adequate, I started to create some json files to
describe mappings of the formats:

https://github.com/bdarcus/bibmaps

Bruce

7

Yes, I’ve used exactly such mappings as input filters, too. The main reason I’d been using bibtex as the ‘parent’ format was that it has such widespread application support, thus allows for easy management of you bibliographies on most platforms. If you’re sticking with json what tool are you using to manage the data? Zotero? Or do you edit them by hand? Just curious.

Sylvester