# Поддержка руководства

ОБРАТИТЕ ВНИМАНИЕ, ЧТО ЭТА СТРАНИЦА ОТНОСИТСЯ ТОЛЬКО К ОРИГИНАЛЬНОМУ РУКОВОДСТВУ НА АНГЛИЙСКОМ ЯЗЫКЕ. ЭТО ВСЕГО ЛИШЬ ПЕРЕВОД С АНГЛИЙСКОГО ЯЗЫКА.

ВАЖНОЕ ПРИМЕЧАНИЕ: Прежде чем следовать этой странице, убедитесь, что ваш вклад не касается самого перевода:

Примечание: Это руководство поддерживается сообществом, и которое официально не одобрено Acidanthera. Пожалуйста, не сообщайте Acidanthera о проблемах, связанных с этим руководством.

Хотите помочь поддержать руководство? Что ж, есть несколько способов помочь!

Примечание: Для тех, кто хочет внести свой финансовый вклад, мы серьёзно это ценим, но мы являемся некоммерческой организацией. Мы делаем это, чтобы обучать, а не зарабатывать на этом деньги. Если у вас есть лишние деньги, мы можем порекомендовать пожертвовать их на благотворительность. Crohn's and Colitis Canada (opens new window) - это то, что мы рекомендуем в этом случае, если вы ничего не думаете.

# Содействие через Issues

Внести свой вклад через Issues довольно просто, но есть некоторые правила:

  • Вкладка "Issues" посвящена только проблемам с руководствами, никаких личных проблем с Хакинтошем. Это не место для обсуждения проблем с установкой.
  • Если это опечатка или улучшения объяснения каких-то моментов, пожалуйста, укажите на какой странице эта проблема присутствует. Были бы признательны, если бы не отправились на охоту за чепухой в то место, где находятся эти проблемы.

Вы можете найти баг-трекер здесь: Bugtracker (opens new window)

# Содействие через PRs

Некоторые рекомендации при внесении вклада через PR:

  • Используйте свой мозг (пожалуйста).
  • Корректируйте свои материалы.
  • Pull Requests могут быть отклонены, если мы считаем, что они не подходят или содержат неточную информацию. Как правило, мы сообщаем вам, почему он отклонен или просим внести изменения.
    • Мы также будем признательны за источники для любых крупных коммитов, чтобы упростить нам проверку достоверности предоставленной вами информации
  • Изображения должны размещаться локально в репозитории в папке ../images/
  • Вам PR должен проходить линтинг markdown и исправлять проблемы.
  • В общем, старайтесь по возможности избегать использования инструментов не от Acidanthera. Как правило, мы хотим избежать использования сторонних инструментов - однако, когда иначе это совсем невозможно, вы можете использовать их.
    • Явно запрещенные инструменты:
      • UniBeast, MultiBeast и KextBeast
      • TransMac
        • Известен за создание заблокированных USB-накопителей
      • Установщики Niresh
        • Мы бы хотели избежать пиратства в этих руководствах

# Как внести свой вклад

Лучший способ проверить ваши коммиты и убедиться, что они правильно отформатированны, - это загрузить Node.js и запустить npm install, чтобы установить зависимости. Когда вы запустите npm run dev, он настроит локальный веб-сервер, к которому вы можете подключиться для просмотра внесенных вами изменений. npm test также выдаст вам любые ошибки, касающиеся форматирования и орфографии. Если вы хотите, чтобы markdownlint автоматически пытался исправить линтинг, запустите npm run fix-lint.

Шаг за шагом:

  • Создайте форк этого репозитория (opens new window)
  • Установите необходимые инструменты:
  • Внесите свои изменения.
  • Постройте сайт:
    • npm install (Для установки всех необходимых плагинов)
    • npm run dev (Предпросмотр сайта)
      • Сайт можно найти по адресу http://localhost:8080
  • Проверьте линтинг и орфографию:
    • npm test
    • npm run lint и npm run spellcheck (для индивидуальной проверки)
    • npm run fix-lint (Чтобы исправить любые потенциальные проблемы)
    • Для слов, не поддерживаемых проверкой орфографии по умолчанию, пожалуйста, добавьте их в dictionary.txt и запустите npm run sort-dict

# Подсказка

Некоторые инструменты, которые немного упростят создание вклада:

# Содействие через Переводы

Хотя руководства от Dortania написаны на базовом английском, мы знаем, что в мире есть много других языков, и что не все свободно владеют английским. Если вы хотите помочь перевести наши руководства на разные языки, мы будем более чем рады помочь вам.

Главное, что нужно иметь в виду:

  • Переводы должны быть отдельным форком и не будут объединены с руководством от Dortania
  • Форки должны указывать на то, что они являются переводом Dortania и не являются официальными
  • Форки также должны соответствовать нашей Лицензии (opens new window)

Если все вышеперечисленное выполнено, вы можете разместить свой перевод без проблем! Сайты Dortania построены на VuePress (opens new window) используя Travis-CI (opens new window) и размещаются на Github Pages (opens new window), поэтому размещение вашего собственного перевода - бесплатно.

Если у вас есть какие-либо вопросы или проблемы с переводом или хостингом, не стесняйтесь обращаться к нашему Bugtracker (opens new window).

Текущие известные переводы:

И обратите внимание, что эти переводы зависят от предпочтений авторов, могут быть внесены изменения при переводе и присутствовать человческие ошибки. Пожалуйста, имейте это в виду, когда читаете их, поскольку они не являются официальными руководствами от Dortania.