Перевод документации Laravel 8.x
laravelrus / docs Goto Github PK
View Code? Open in Web Editor NEWДокументация на русском языке.
License: MIT License
Документация на русском языке.
License: MIT License
Перевод документации Laravel 8.x
Сабж: Предлагаю сохранение номеров строк в переводах документации 8.х относительно оригинальных файлов документации.
На мой скромный взгляд, это позволит свободнее ориентироваться в файле и при реализации перевода сразу переходить к нужной строке, а не как сейчас, искать её через Ctrl+f
Переведу доку по Laravel Homestead
Уведомление, чтобы не делать с кем-то параллельной одной и той же работы.
Перечеркиваются подзаглавия "Поддоменные роуты" и "Префикс пути" — http://joxi.ru/vAWYG38tVGkjmW
Было бы здорово добиться стандартизации переводов, чтобы они следовали чётко установленным правилам и форматам. В этом нам может помочь https://github.com/DavidAnson/markdownlint который предлагает широкий набор правил для оформления и согласованности.
При использовании два стиля для объявления кода в одном файле будет приводить к ошибке:
Laravel изначально поддерживает работу с SQL Server;
однако, потребуется добавить настройку подключения к БД в конфиге `config/database.php`:
'sqlsrv' => [
'driver' => 'sqlsrv',
'host' => env('DB_HOST', 'localhost'),
'database' => env('DB_DATABASE', 'forge'),
'username' => env('DB_USERNAME', 'forge'),
'password' => env('DB_PASSWORD', ''),
'charset' => 'utf8',
'prefix' => '',
],
Вы также можете получить низкоуровневый объект PDO
для этого подключения методом `getPdo` на экземпляре подключения:
'''php
$pdo = DB::connection()->getPdo();
'''
К тому же стоит отметить, что markdownlint корректно обрабатывает YAML-префиксы в документах и не признает их нарушением. Пример такого префикса:
---
layout: post
title: Title
---
Мы могли бы добавить это как GitHub Action в этот репозиторий, для новых веток.
Неактивная ссылка в левом сайдбаре в документации v5.2 ("API")
http://laravel.su/docs/5.2/installation
Здравствуйте, планируете 6 версию переводить, или это не так важно, как мне кажется?
Заметил, что в некоторых местах комментарии в коде переведены на русский, а в некоторых оставлен оригинал. Думаю, было бы не плохо принять единое соглашение и добавить его в инструкцию по переводу.
Лично моё мнение — комментарии в коде должны оставаться на языке оригинала, исключение только в случае, если без перевода совсем не понятно что происходит. Вижу для этого, как минимум, две причины: комментарии в коде на языке отличном от английского являются плохой практикой, а если в документации примеры будут с русскими комментариями, может сложиться мнение что это наоборот хорошо; при работе с кодом, создании файлов с помощью artisan комментарии будут на английском :)
В качестве исключения, можно переводить подобные вещи
// Validate that a string is exactly 12 characters long...
'title' => 'size:12';
// Validate that a provided integer equals 10...
'seats' => 'integer|size:10';
// Validate that an array has exactly 5 elements...
'tags' => 'array|size:5';
// Validate that an uploaded file is exactly 512 kilobytes...
'image' => 'file|size:512';
т.к. они, по сути, являются продолжением текста документации.
Куда же делась ваша команда:
Перевод документации Laravel 8.x, выполненный командой https://rularavel.com
У вас в разделе http://laravel.su/docs/5.2/blade и в других версиях вместо
@parent
написано @
конкретно в этом коде:
@section('sidebar')
@
<p>This is appended to the master sidebar.</p>
@endsection
Данные раздел имеет пустой файл (и, соответственно, пустую страницу на сайте перевода) + в разделе "Статус перевода" стоит статус "перевод не требуется". Это баг или страница не нуждается в переводе?
Переведу доку по Laravel Horizon
Уведомление, чтобы не делать с кем-то параллельной одной и той же работы.
Переведу доку по HTTP Redirects
Уведомление, чтобы не делать с кем-то параллельной одной и той же работы.
Добавлю в репозиторий и переведу доку по Laravel Octane
Уведомление, чтобы не делать с кем-то параллельной одной и той же работы.
В файле https://github.com/LaravelRUS/docs/blame/8.x/installation.md#L1 требуется поправить номер коммита git 13f770acbfe97eaa2e77534144ab8d4513d04a04
Сейчас egit 13f770acbfe97eaa2e77534144ab8d4513d04a04
с пробелами в начале
http://laravel.su/docs/5.0/migrations
php artisan make:migrate create_users_table --table=users --create
правильно
php artisan make:migration create_users_table --table=users --create
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google ❤️ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.