Skip to content

Latest commit

 

History

History
65 lines (51 loc) · 4.02 KB

CONTRIBUTING.md

File metadata and controls

65 lines (51 loc) · 4.02 KB
Raw

Submitting Styles

Important: Before submitting a style to our repository, please make sure that your style validates and meets our other requirements.

There are three ways to submit styles: you can create a so-called pull request by using just the GitHub website (option A), or by using the website in combination with a Git client (option B). If you have trouble creating a pull request, you can also post your style online by creating a gist on the GitHub website (option C). Option A is usually the easiest, for you and for us.

Styles submitted via a pull request are automatically validated and checked for additional requirements. For this we rely on a Test-Environment set up at Travis-CI.org. A few minutes after creating a pull request, Travis CI will indicate whether the pull request can be accepted (see the [Travis blog] (http://about.travis-ci.org/blog/2012-09-04-pull-requests-just-got-even-more-awesome/)). If there are any problems, the test report will describe what is wrong.

(A) Pull Request - GitHub Website only

If you wish to edit an existing style:

  1. Create a GitHub.com account and sign in.
  2. Go to https://github.com/citation-style-language/styles, and find the style you want to change (dependent styles are stored in the "dependent" directory).
  3. Click on the style name, which will bring you to a page like https://github.com/citation-style-language/styles/blob/master/apa.csl.
  4. Click the "Edit" button (see the GitHub blog. This will open a code editor in which you can make your changes (e.g. you can copy and paste your modified style into this window).
  5. Once you have made your changes in the "Code" tab (and previewed the changes in the "Preview" tab), click the "Propose File Change" button.
  6. In the next window, describe the changes you've made. When finished, click the "Send pull request" button.

If you wish to submit a new style:

  1. Create a GitHub.com account and sign in.
  2. Go to https://github.com/citation-style-language/styles, and click the plus button (with a "Fork this project and create a new file" tooltip, see the GitHub blog). If you wish to submit a dependent style, first navigate to the "dependent" directory.
  3. Name your new style, and paste the style code into the code editor window.
  4. Click the "Propose New File" button.
  5. In the next window, describe the changes you've made. When finished, click the "Send pull request" button.

Based on your GitHub notification settings, you will now automatically receive updates when your changes have been accepted, or when the CSL team has comments or questions about your changes.

(B) Pull Request - GitHub Website and Git client

Start by forking the style repository. Commit your changes, and create a pull request. You can use your git client of choice, such as GitHub for Mac, GitHub for Windows, or SmartGit.

(C) Creating a gist

Visit http://gist.github.com and paste the style code into the text box. Give the style a name ("name this file...") and click the "Create Public Gist" button. Copy the URL of the gist (e.g. https://gist.github.com/1320111) and include it in your message to us. You can either start a new discussion in the Citation Styles section of the Zotero forums, or create a new GitHub issue in the styles repository.

Gists have to be checked by hand and take longer to get accepted, so please try option A first.