# CSL editor update

**URL:** <https://discourse.citationstyles.org/t/csl-editor-update/1122>\
**Category:** CSL Development\
**Created:** [September 5, 2012, 3:09pm UTC](https://discourse.citationstyles.org/t/csl-editor-update/1122 "2012-09-05T15:09:42Z")\
**Posts on this page:** 5\
**Page:** 2

<div class="post-metadata">

**Author:** ![Rintze\_Zelle](https://yyz1.discourse-cdn.com/flex029/user_avatar/discourse.citationstyles.org/rintze_zelle/32/175_2.png) [@Rintze\_Zelle](https://discourse.citationstyles.org/u/Rintze_Zelle)\
**Post date:** [September 13, 2013, 1:08pm UTC](https://discourse.citationstyles.org/t/csl-editor-update/1122/21 "2013-09-13T13:08:45Z")

</div>

Thanks, Steve. By the way, I’m always a bit confused about the exact  
relationship between the  
[https://github.com/citation-style-editor/csl-editor](https://github.com/citation-style-editor/csl-editor) and  
[https://github.com/citation-style-editor/csl-editor-demo-site](https://github.com/citation-style-editor/csl-editor-demo-site)  
repositories, and the live versions at  
[http://editor.citationstyles.org/](http://editor.citationstyles.org/) and [http://csl.mendeley.com/](http://csl.mendeley.com/) . Could  
you give a brief explanation? Are there any differences between the  
versions at the two domains? And what is the current workflow to  
deploy at [http://editor.citationstyles.org/](http://editor.citationstyles.org/) ?

Rintze

---

<div class="post-metadata">

**Author:** ![Steve\_Ridout1](https://avatars.discourse-cdn.com/v4/letter/s/258eb7/32.png) [@Steve\_Ridout1](https://discourse.citationstyles.org/u/Steve_Ridout1)\
**Post date:** [September 13, 2013, 2:02pm UTC](https://discourse.citationstyles.org/t/csl-editor-update/1122/22 "2013-09-13T14:02:47Z")

</div>

I know it’s a bit confusing, I’ll try to explain.

# The Different Repos

The motivation for having different repos was that different ref-managers  
or clients should be able to share common code, but also be able to  
customise their instance to work within their own websites or applications.  
So we have:

## Core Library - [https://github.com/citation-style-editor/csl-editor](https://github.com/citation-style-editor/csl-editor)

- The vast majority of code is here
- Load and Save style functions _not_ provided, this is up to the specific  
instance to implement
- All ref-manager instances should use and contribute back to this
- No reference manager specific code allowed!

## Demo Instance

> **[citation-style-language/csl-editor-demo-site](https://github.com/citation-style-language/csl-editor-demo-site)**
>
> Reference implementation of the CSL editor. Contribute to citation-style-language/csl-editor-demo-site development by creating an account on GitHub.

- The instance hosted by github pages at [http://editor.citationstyles.org](http://editor.citationstyles.org)
- Contains the Core Library as a git submodule
- Adds the top navigation bar and /about page
- Code to load and save styles to disk
- Script to deploy to github pages
- Intended to be forked by others and changed completely to suit their needs

## Mendeley Instance - [http://csl.mendeley.com/about/](http://csl.mendeley.com/about/)

- Forked from the csl-editor-demo-site
- Contains the Core Library as a git submodule
- Code to authorise and load/save styles to Mendeley’s web service
- Ask Carles for more info

# Deployment

1. If you alter the core library  
[https://github.com/citation-style-editor/csl-editor](https://github.com/citation-style-editor/csl-editor), you may need to  
re-convert the schema files and re-generate the example citations. To do  
this, you’ll need node.js and it’s package manager npm installed, and then  
you simply run ./configure.sh  
It takes a good few minutes to generate all the example citations, but  
results of the configure are committed to the repo here:  
[https://github.com/citation-style-editor/csl-editor/tree/master/generated](https://github.com/citation-style-editor/csl-editor/tree/master/generated) so  
you’ll only need to reconfigure if you actually change the schema, or  
anything affecting the example citations.

2. To re-deploy the demo-site to gh-pages:  
[https://github.com/citation-style-editor/csl-editor-demo-site#to-deploy](https://github.com/citation-style-editor/csl-editor-demo-site#to-deploy)

(you’ll have to be a member of the github organisation to do this:  
[https://github.com/citation-style-editor](https://github.com/citation-style-editor) - ask myself or Carles if you want  
to join)

---

<div class="post-metadata">

**Author:** ![Bruce\_D\_Arcus1](https://avatars.discourse-cdn.com/v4/letter/b/4bbf92/32.png) [@Bruce\_D\_Arcus1](https://discourse.citationstyles.org/u/Bruce_D_Arcus1)\
**Post date:** [September 13, 2013, 2:09pm UTC](https://discourse.citationstyles.org/t/csl-editor-update/1122/23 "2013-09-13T14:09:34Z")

</div>

So how about Mendeley taking responsibility for maintaining the repos/projects?

😉

---

<div class="post-metadata">

**Author:** ![Rintze\_Zelle](https://yyz1.discourse-cdn.com/flex029/user_avatar/discourse.citationstyles.org/rintze_zelle/32/175_2.png) [@Rintze\_Zelle](https://discourse.citationstyles.org/u/Rintze_Zelle)\
**Post date:** [February 13, 2015, 1:21am UTC](https://discourse.citationstyles.org/t/csl-editor-update/1122/24 "2015-02-13T01:21:31Z")

</div>

Hi all,

I ran into an issue the other day with [validator.nu](http://validator.nu), which didn’t  
accept the (deprecated) text/x-csl MIME content type of an uploaded  
CSL style. (see [https://github.com/validator/validator/issues/30](https://github.com/validator/validator/issues/30) and  
[https://github.com/zotero/zotero-standalone-build/issues/36](https://github.com/zotero/zotero-standalone-build/issues/36))

Dan suggested in 2012 to switch to  
"application/vnd.citationstyles.style+xml", and has been using this  
content type for the Zotero Style Repository for quite a while now.  
Unless there are any objections, I would like to register this content  
type at [http://www.iana.org/form/media-types](http://www.iana.org/form/media-types), and make it the official  
content type for CSL styles.

Somewhat related is this thread,  
[http://xbiblio-devel.2463403.n2.nabble.com/CSL-editor-update-td7578209.html](http://xbiblio-devel.2463403.n2.nabble.com/CSL-editor-update-td7578209.html),  
where Dan mentions that Zotero uses  
"application/vnd.citationstyles.csl+json" for CSL JSON, which we might  
want to register at a later date.

Rintze

---

<div class="post-metadata">

**Author:** ![Rintze\_Zelle](https://yyz1.discourse-cdn.com/flex029/user_avatar/discourse.citationstyles.org/rintze_zelle/32/175_2.png) [@Rintze\_Zelle](https://discourse.citationstyles.org/u/Rintze_Zelle)\
**Post date:** [February 24, 2015, 3:34am UTC](https://discourse.citationstyles.org/t/csl-editor-update/1122/25 "2015-02-24T03:34:25Z")

</div>

application/vnd.citationstyles.style+xml is now registered for use  
with CSL styles:

[http://www.iana.org/assignments/media-types/application/vnd.citationstyles.style+xml](http://www.iana.org/assignments/media-types/application/vnd.citationstyles.style+xml)

Rintze

[Previous page](https://discourse.citationstyles.org/t/csl-editor-update/1122.md?page=1)