phpunit documentation french

Проект PHPUnit больше не занимается переводом своей документации на другие языки. Этот репозиторий теперь заархивирован.

Документация PHPUnit на французском языке

Этот репозиторий содержит французскую документацию для PHPUnit.
Документация доступна по адресу https://phpunit.readthedocs.io/en/latest/.

Оригинальная документация на английском языке: https://github.com/sebastianbergmann/phpunit-documentation-english.

Переводы

Каждый перевод документации хранится в специальном репозитории:

• Документация на английском языке
• Документация на испанском языке
• Документация на французском языке
• Документация на бразильском и португальском языках.
• Документация на японском языке
• Упрощенная китайская документация
• Документация на русском языке

Добавить новый перевод

Если вы хотите создать новый перевод, откройте вопрос на трекере английской документации, указав язык, который вы хотите перевести. Будет создан репозиторий, в который будут добавлены доступные переводы.

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

Создайте документацию

Предварительные условия

• Питон
• Сфинкс
• Прочтите тему Docs Sphinx

Создание HTML-документации

Чтобы создать документацию, выполните следующую командную строку:

 $ make html

Затем вы найдете файлы HTML в build/html .

Автоматизированная корректура

Средство

 $ pip install docutils-ast-writer
$ npm install

Использовать

 $ ./node_modules/.bin/textlint src

Способствовать

Спасибо, что нашли время, чтобы помочь.

Ожидаемые вклады

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

Инструкция по применению

• Ознакомьтесь с руководством по переводу
• Сделайте документированные запросы на включение в мастер (в идеале из «функциональной ветки»).
• Прежде чем делать запрос на включение, убедитесь, что компиляция прошла успешно.
• Оставьте примеры кода на английском языке
• Соблюдайте разрывы строк в исходной документации для облегчения поиска и сравнения (номера строк в английской и французской документации должны быть одинаковыми).

Руководство по переводу

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

Английский	Французский
действительный	наблюдаемое (значение)
множество	переводится массивом, за исключением случаев явной ссылки на PHP
утверждение	переводится как утверждение, более красноречивое, чем утверждение
составной	компонуемый (ничего лучшего не найдено)
ожидал	ожидаемое (значение)
рамки	рамки
изолированный	независимый (утепление неоднозначное, водонепроницаемость чуть меньше...)
инструкции	ЗАМЕЧАНИЕ
возвращаться	возвращается, а не возвращается
требования	предпосылки
расширение	расширения
покрытие кода	покрытие кода
приложение	приложение
приспособление	приспособление (лучшего на французском языке не найти)
заглушка	пробка
глагол	в названиях переводится инфинитивом: тестирование => тестер

Рекомендуемое чтение:

• https://framacalc.org/jargon-francais
• https://www.24joursdeweb.fr/2017/on-dit-numerique-et-pas-digital-bordel/