AutorÃa | Ultima modificación | Ver Log |
## Reporting BugsEach bug report MUST have a [Codepen/JSFiddle] recreation before any work can begin. [further instructions »](http://fullcalendar.io/wiki/Reporting-Bugs/)## Requesting FeaturesPlease search the [Issue Tracker] to see if your feature has already been requested, and if so, subscribe to it. Otherwise, read these [further instructions »](http://fullcalendar.io/wiki/Requesting-Features/)## Contributing FeaturesThe FullCalendar project welcomes [Pull Requests][Using Pull Requests] for new features, but because there are so many feature requests (over 100), and because every new feature requires refinement and maintenance, each PR will be prioritized against the project's other demands and might take a while to make it to an official release.Furthermore, each new feature should be designed as robustly as possible and be useful beyond the immediate usecase it was initially designed for. Feel free to start a ticket discussing the feature's specs before coding.## Contributing BugfixesIn the description of your [Pull Request][Using Pull Requests], please include recreation steps for the bug as well as a [JSFiddle/JSBin] demo. Communicating the buggy behavior is a requirement before a merge can happen.## Contributing LocalesPlease edit the original files in the `locale/` directory. DO NOT edit anything in the `dist/` directory. The build system will responsible for merging FullCalendar's `locale/` data with the [MomentJS locale data].## Other Ways to Contribute[Read about other ways to contribute »](http://fullcalendar.io/wiki/Contributing/)## Getting Set UpYou will need [Git][git], [Node][node], and NPM installed. For clarification, please view the [jQuery readme][jq-readme], which requires a similar setup.Also, you will need the [gulp-cli][gulp-cli] package installed globally (`-g`) on your system:npm install -g gulp-cliThen, clone FullCalendar's git repo:git clone git://github.com/fullcalendar/fullcalendar.gitEnter the directory and install FullCalendar's dependencies:cd fullcalendarnpm install## What to editWhen modifying files, please do not edit the generated or minified files in the `dist/` directory. Please edit the original `src/` files.## Development WorkflowAfter you make code changes, you'll want to compile the JS/CSS so that it can be previewed from the tests and demos. You can either manually rebuild each time you make a change:gulp devOr, you can run a script that automatically rebuilds whenever you save a source file:gulp watchWhen you are finished, run the following command to write the distributable files into the `./dist/` directory:gulp distIf you want to clean up the generated files, run:gulp clean## Style GuidePlease follow the [Google JavaScript Style Guide] as closely as possible. With the following exceptions:```jsif (true) {}else { // please put else, else if, and catch on a separate line}// please write one-line array literals with a one-space padding insidevar a = [ 1, 2, 3 ];// please write one-line object literals with a one-space padding insidevar o = { a: 1, b: 2, c: 3 };```Other exceptions:- please ignore anything about Google Closure Compiler or the `goog` library- please do not write JSDoc commentsNotes about whitespace:- **use *tabs* instead of spaces**- separate functions with *2* blank lines- separate logical blocks within functions with *1* blank lineRun the command line tool to automatically check your style:gulp lint## Before Submitting your CodeIf you have edited code (including **tests** and **translations**) and would like to submit a pull request, please make sure you have done the following:1. Conformed to the style guide (successfully run `gulp lint`)2. Written automated tests. View the [Automated Test Readme][Codepen/JSFiddle]: http://fullcalendar.io/wiki/Reporting-Bugs/[Issue Tracker]: https://github.com/fullcalendar/fullcalendar/issues[Using Pull Requests]: https://help.github.com/articles/using-pull-requests/[MomentJS locale data]: https://github.com/moment/moment/tree/develop/locale[git]: http://git-scm.com/[node]: http://nodejs.org/[gulp-cli]: https://github.com/gulpjs/gulp/blob/master/docs/getting-started.md[jq-readme]: https://github.com/jquery/jquery/blob/master/README.md#what-you-need-to-build-your-own-jquery[Google JavaScript Style Guide]: http://google-styleguide.googlecode.com/svn/trunk/javascriptguide.xml[Automated Test Readme]: https://github.com/fullcalendar/fullcalendar/wiki/Automated-Tests