---
title: Содействие
---

Добро пожаловать в команду разработчиков Hexo. 🤗

## Разработчикам

Мы рады желающим присоединиться к развитию Hexo. Этот документ поможет вам начать.

### Прежде, чем начать

Пожалуйста, следите за стилем написания кода:

- Следуйте [Google JavaScript Style Guide](https://google.github.io/styleguide/jsguide.html).
- Используйте мягкие табы с двойным пробелом.
- Не ставьте запятую в начале.

### Рабочее пространство

1. Создайте форк [hexojs/site]
2. Клонируйте репозиторий на компьютер и установите все зависимости.

    {% code %}
    $ git clone https://github.com/<username>/hexo.git
    $ cd hexo
    $ npm install
    $ git submodule update --init
    {% endcode %}

3. Создать отдельную ветку.

    {% code %}
    $ git checkout -b new_feature
    {% endcode %}

4. Вносите изменения.
5. Выгрузите ветку:

    {% code %}
    $ git push origin new_feature
    {% endcode %}

6. Запросите принятие изменений с их описанием.

### На заметку

- Не изменяйте номер версии в `package.json`.
- Ваш запрос могут только принять, когда все тесты пройдут. Не забудьте провести испытания перед отправкой.

    {% code %}
    $ npm test
    {% endcode %}

## Обновление официальных плагинов

Также мы будем рады PR или задачам на странице [официальных плагинов](https://github.com/hexojs). 🤗

## Обновление документации

Документация Hexo имеет открытый исходный код, его можно найти по адресу [hexojs/site].

### Рабочее пространство

1. Создайте форк [hexojs/site]
2. Клонируйте репозиторий на компьютер и установите все зависимости.

    {% code %}
    $ git clone https://github.com/<username>/site.git
    $ cd site
    $ npm install
    {% endcode %}

3. Начать редактировать документацию. Вы можете запустить сервер для просмотра изменений.

    {% code %}
    $ hexo server
    {% endcode %}

4. Выгрузите ветку.
5. Запросите принятие изменений с их описанием.

### Перевод

1. Добавьте новую папку с языком в папке `source`. (Всё в нижнем регистре)
2. Скопируйте markdown файлы и шаблоны из папки `source` в папку с создаваемым переводом.
3. Добавьте новый язык в файл `source/_data/language.yml`.
4. Скопируйте `en.yml` в `themes/navy/languages` и измените имя (всё в нижнем регистре).

## Сообщение о проблеме

Если Вы столкнулись с проблемой при использовании Hexo, то можно поискать решения в [устранении неполадок](troubleshooting.html) или задать вопросы на [GitHub](https://github.com/hexojs/hexo/issues) или [Google Group](https://groups.google.com/group/hexo). Если решения не нашлось, пожалуйста, сообщите об этом на GitHub.

1. Воспроизведите проблему в режиме отладки [debug mode](commands.html#Режим-отладки).
2. Запустите `hexo version` и прочтите описание версии.
3. Создайте сообщение об ошибке с отладочными данными и номером используемой версии на GitHub.

[hexojs/hexo]: https://github.com/hexojs/hexo
[hexojs/site]: https://github.com/hexojs/site
