moodlebox.net

Сайт «moodlebox.net»

Этот репозиторий содержит страницы содержимого веб-сайта MoodleBox, Moudlebox.net.

Содействие

Вы можете улучшить текст, исправить опечатки и т. д., а также добавить другие переводы. Страницы написаны в формате Markdown.

Как внести свой вклад в перевод на новый язык

Примечание. Важно, чтобы версии веб-сайта на разных языках были синхронизированы (т.е. имели одинаковую структуру и отражали один и тот же смысл). Ваш перевод должен быть эквивалентен оригинальному содержанию страниц на английском языке (та же структура, тот же смысл). Если вы хотите добавить контент на страницу (или изменить его значение) или добавить новые страницы помощи, пожалуйста, свяжитесь со мной заранее!

1. Создайте форк этого репозитория, нажав «Разветвить» в правом верхнем углу этой страницы.
2. Клонируйте свою вилку на свой компьютер: git clone https://github.com/<your-username>/moodlebox.net .
3. На своем компьютере продублируйте папку, содержащую англоязычное содержимое веб-сайта. Эта папка находится здесь: content/en . Переименуйте дублированную папку, указав ISO-код вашего языка, например, es для испанского, ja для японского, zh для китайского, ru для русского и т. д. Не меняйте иерархическую структуру новой папки.
4. Откройте в текстовом редакторе страницу(ы), которые вы хотите перевести, переведите ее(их) и сохраните. Не меняйте имена файлов. Затем зафиксируйте свои изменения, например: git add content/es/<name-of-the-translated-page>.md ; git commit -a . Не фиксируйте файлы, которые вы еще не перевели.
5. Отправьте изменения на Github: git push .
6. Создайте запрос на включение, посетив https://github.com/<your-username>/moodlebox.net и следуя инструкциям в верхней части экрана.

А как насчет названий файлов?

Имена файлов, включая расширение .md , ни в коем случае нельзя изменять , поскольку они используются для обеспечения связи страницы с ее переводами с помощью переключателя языка на веб-сайте.

Что делать с заголовком файла?

Каждая страница имеет заголовок, который не отображается непосредственно на веб-сайте, но его правильность очень важно получить. Вот несколько правил, которые помогут сделать это правильно.

• title : заголовок страницы, который будет переведен на ваш язык. Он отображается в основном шапке страницы и служит заголовком внутренних ссылок. Слова заголовка также имеют больший вес во внутренней поисковой системе.

• авторы : автор(ы) страницы. Когда вы редактируете уже существующую страницу, добавьте свое имя в новой строке после существующих имен через тире, например:

   authors :
    - Jane Doe
    - Nicolas Martignoni

  Примечание. Имя автора нигде на сайте не отображается.

• тип : Не следует изменять . Должно оставаться точно идентичным английской версии переведенной версии.

• date : дата создания новой страницы в формате ГГГГ-ММ-ДД, например

   date : 2018-12-23

  Не меняйте его, если вы редактируете существующую страницу, поскольку он предназначен для обозначения даты первого создания страницы.

• вес : Не подлежит изменению . Должно оставаться точно идентичным английской версии переведенной версии.

• slug : устанавливает постоянную ссылку на страницу на вашем языке. Очевидно, это должно быть что-то связанное с заголовком и содержанием страницы. Слаг должен содержать только символы нижнего регистра и дефисы . Никаких специальных символов, никаких знаков препинания. Для страницы, переведенной на французский язык, следующий фрагмент

   slug : une-page-inutile

  предоставит постоянную ссылку https://moodlebox.net/fr/help/une-page-inutile .

• категории : Не следует изменять . Должно оставаться точно идентичным английской версии переведенной версии.

Как исправить опечатки или улучшить существующий перевод?

Мы хотим, чтобы документация MoodleBox была как можно лучше. Мы открыли исходный код документа и приветствуем любые запросы на включение, если вы обнаружите, что он отсутствует. Более простой способ — открыть задачу с описанием исправления, которое необходимо реализовать. В противном случае вы можете использовать следующую процедуру.

1. Создайте форк этого репозитория, нажав «Разветвить» в правом верхнем углу этой страницы.
2. Клонируйте свою вилку на свой компьютер: git clone https://github.com/<your-username>/moodlebox.net .
3. Исправьте опечатки и/или перефразируйте текст.
4. Зафиксируйте изменения: git commit -a
5. Отправьте изменения на Github: git push .
6. Создайте запрос на включение, посетив https://github.com/<your-username>/moodlebox.net и следуя инструкциям в верхней части экрана.