Содействие

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

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

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

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

Пожалуйста сначала прочтите Contributor Covenant Code of Conduct.

Убедительно просим, следите за стилем написания кода:

  • Следуйте Google JavaScript Style Guide.
  • Используйте мягкие табы с двойным пробелом.
  • Не ставьте запятую в начале.

Кроме того, у Hexo есть своя собственная конфигурация ESLint config, поэтому, пожалуйста, убедитесь, что ваш вклад пройдёт ESLint проверку.

Workflow

  1. Создайте форк hexojs/site
  2. Клонируйте репозиторий на компьютер и установите все зависимости.
$ git clone https://github.com/<username>/hexo.git
$ cd hexo
$ npm install
$ git submodule update --init
  1. Создать отдельную ветку.
$ git checkout -b new_feature
  1. Start hacking.
  2. Push the branch:
$ git push origin new_feature
  1. Запросите принятие изменений с их описанием.

На заметку

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

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

Также мы будем рады PR или задачам на странице официальных плагинов. 🤗

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

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

Workflow

  1. Создайте форк hexojs/site
  2. Клонируйте репозиторий на компьютер и установите все зависимости.
$ npm install hexo-cli -g # If you don't have hexo-cli installed
$ git clone https://github.com/<username>/site.git
$ cd site
$ npm install
  1. Начать редактировать документацию. Вы можете запустить сервер для просмотра изменений.
$ hexo server
  1. Выгрузите ветку.
  2. Запросите принятие изменений с их описанием.

Перевод

Contribute translations

Crowdin

Now we use the Crowdin platform for translation, where anyone can contribute translations and vote for translations without manual git operations.

Add a new language

  1. Submit a new issue to let us know. The members with access to the Crowdin Project add the language in settings.
  2. After adding language in Crowdin, anyone can contribute translations on it.
  3. Добавьте новый язык в файл source/_data/language.yml.
  4. Скопируйте en.yml в themes/navy/languages и измените имя (всё в нижнем регистре).

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

Если Вы столкнулись с проблемой при использовании Hexo, то можно поискать решения в устранении неполадок или задать вопросы на GitHub или Google Group. Если решения не нашлось, пожалуйста, сообщите об этом на GitHub.

  1. Воспроизведите проблему в режиме отладки debug mode.
  2. Следуйте инструкциям из шаблона issue, чтобы предоставить сообщение об отладке и версию при создании нового issue на GitHub.
Пред