symfony-fr/symfony-docs-fr

French translation for Symfony2 documentation

Documentation de Symfony

Attention, cette documentation n'est plus à jour et le dépot n'est plus maintenu. La seule documentation officielle et à jour est celle en anglais, disponible sur symfony.com.

Merci à celles et ceux qui ont contribué à maintenir ce dépot à jour pendant plusieurs années.

Contribuer

Merci de lire la page d'informations sur les contributions.

Discuter de la documentation

Vous pouvez nous contacter sur IRC à l'adresse suivante: #[email protected]

symfony-docs-fr's Issues

FrameworkTemplateController documentation

Hi,

There is a mistake in the documentation talking about the FrameworkTemplateController and cache's pages

It is not sharedMaxAge: 86400 but it appears to be sharedAge: 86400

Update process

Warning message on "current" version

If I search symfony2 book fr with Google or Bing, the first result is http://symfony.com/fr/doc/current/book/index.html

A warning message appears at the top of the page (this message is not on the English page):

Caution: You are browsing the documentation for Symfony version current which is not maintained anymore. If some of your projects are still using this version, consider upgrading to Symfony 2.6.

How the current version can be outdated?

And the link in this text leads to the version checker page but the GET parameter current is not accepted and it displays an error: http://symfony.com/roadmap?version=current#checker

Wrong version format (should be X.Y or X.Y.Z where X, Y, and Z are integers).

Add documentation for the Routing Component

Undefined $crawler variable on testing/simulating_authentication.html

The $crawler variable is not defined on the French version of this page:

$this->client->request('GET', '/demo/secured/hello/Fabien');

[...]
$this->assertGreaterThan(0, $crawler->filter('html:contains("Hello Fabien")')->count());

http://symfony.com/fr/doc/2.3/cookbook/testing/simulating_authentication.html

$crawler is defined on the English version:

$crawler = $this->client->request('GET', '/demo/secured/hello/Fabien');

[...]
$this->assertGreaterThan(0, $crawler->filter('html:contains("Hello Fabien")')->count());

http://symfony.com/doc/2.3/cookbook/testing/simulating_authentication.html

Traduction terminée du book/http_cache

Bonjour à tous,

La traduction de la page HTTP_Cache du Book est terminé.

Readme is not up to date

In the readme, I can see toutes les « pull requests » doivent être basées sur la branche 2.0, et non pas sur la branche master ou la branche 2.1. but this branch is removed

[Cookbook][Routing] & [Book][Routing] update "_method" to "methods"

Hello,

Looking at English version of http://symfony.com/doc/master/book/routing.html#adding-http-method-requirements, (YAML tab) we have:

# app/config/routing.yml
contact:
    path:     /contact
    defaults: { _controller: AppBundle:Main:contact }
    methods:  [GET]

contact_process:
    path:     /contact
    defaults: { _controller: AppBundle:Main:processContact }
    methods:  [POST]

whereas in http://symfony.com/fr/doc/master/cookbook/routing/method_parameters.htm and http://symfony.com/fr/doc/master/book/routing.html#ajouter-des-conditions-requises-pour-la-methode-httpl, we have this semantic:

        _method:  GET
        _method:  PUT
       ...

It seems that the [methods] option was introduced in version 2.2 http://symfony.com/doc/2.2/book/routing.html#adding-http-method-requirements.

Should the http://symfony.com/fr/doc/master/cookbook/routing/method_parameters.html and http://symfony.com/fr/doc/master/book/routing.html#ajouter-des-conditions-requises-pour-la-methode-http be updated with the latest option, for consistency sake?

Kind regards

Useless opening parenthesis

The number of parenthesis is incorrect in the following code, the first parenthesis should be removed / Le nombre de parenthèses n'est pas correct dans le code suivant, il faut supprimer la première parenthèse :

$this->assertLessThan((500, $profile->getCollector('time')->getDuration());

Source : https://github.com/symfony-fr/symfony-docs-fr/blob/92f85f1cd6f877bf165d7d66f2a47da257dfadf6/cookbook/testing/profiling.rst#comment-utiliser-le-profiler-dans-un-test-fonctionnel

http://documentation-symfony.fr/ down ?

Hi.

Unfortunately, the docs have vanished from the Web : http://downforeveryoneorjustme.com/http://documentation-symfony.fr/

Still, https://web.archive.org/web/20160314025200/http://documentation-symfony.fr/ may be useable :-/

Typo in reference/configuration/security.rst

Missing word "défaut" in BCrypt section.

You should create the 2.4 branch to fix the symfony.com website

The contributing guide speaks about a 2.0 branch

It looks like this branch no longer exists... where are we supposed to do our pull requests?

Wrong translation about form errors

Hello,
the sentence

Note that you can't use form.errors to determine if a form is valid [...]

(see here) has been translated to

Notez que vous pouvez utiliser form.errors pour déterminer si un champ est valide [...]

(see here). It should be

Notez que vous ne pouvez pas utiliser form.errors pour déterminer si un champ est valide [...]

instead.

This error appears in all versions from the 2.2 version:

• 2.2
• 2.3
• 2.4 (current)
• master

Add missing translation of DI component doc in master version

Some of the doc of the Dependency injection is now obselete. So I'm offering to translate it in french :)

Add How to remove the AcmeDemoBundle missing doc

Correct wording in console page

In this (page)(http://symfony.com/fr/doc/2.3/cookbook/console/logging.html), I saw the event console.termine but the real event is console.terminate

Stable branches can't be merged to master

There are many conflicts when the 2.1, 2.2 and even 2.3 are merged to master which means that:

• New contributions made for a specific version of Symfony can't be easily merged back to master
• Some contributions have been made directly to the master branch, which means that Symfony's current version documentation (and previous versions as well) doesn't benefit from latest updates. That's alright if these corrections only concern a future of Symfony (currently 2.4). To fix this, these corrections made on master should be merged back to the stable version branches and future PR concerning fixes should only be made on a specific version branch.

I can help trying to do the right merges and make Pull Requests for each of the version branches and therefore make them not conflicting when merged on master.

What do you think @gregquat?

(BTW, should I write issues and commit messages in French as only French people take part of this French specific project?)

2.1 branch

Maintenant que la version 2.1 est sortie, il faudrait créer une branche 2.1 pour refléter le repo en anglais.

Merci,

Le Book

First link of the french doc is http://symfony.com/fr/doc/master/book/index.html

it's full of english, how can we translate that ?

Same for "Le Book" it sounds like an animal in french, can we use "Le Bouquin" or more commonly "Le Livre" ?

How to contribute?

Hello,

I would like to contribute to the translation of the documentation but when I read the part "Contribuer à la traduction française" it doesn't say to do pull request on master. But all pull requests are done from master to master.

Thanks

[Cookbook][Form]

How to personalise global errors vs. field errors: not up to date and does not make any sense.

http://symfony.com/fr/doc/current/cookbook/form/form_customization.html#personnaliser-l-affichage-des-erreurs

Error in internals chapter's book

There is an error in the internals chapter's book, in the kernel.view section, in the sample code, I could see a getter getReturnValue() in the GetResponseForControllerResultEvent class but it doesn't exist.

The true method to use is getControllerResult()

The sample is good in the English doc

Deprecated data_class for class form

In the French doc, there is still the reference to the deprecated function public function setDefaultOptions(OptionsResolverInterface $resolver) and no mention of public function configureOptions(OptionsResolver $resolver), which is properly mention in the English doc.

Checked for the French and English doc v2.7.

URL de la traduction incorrecte

L'url indiquée http://symfony.com/fr/doc/current/ retourne une 404.

2 typos in testing Doctrine and releases pages

A dot is missing at the end of this sentence:

Heureusement, vous pouvez facilement tester vos requêtes avec une vraie base de données, comme décrit ci-dessous

http://symfony.com/fr/doc/2.3/cookbook/testing/doctrine.html

Verb agreement

(don't know how to say this in English) se mettent doit être accordé avec l'écosystème, il doit donc être écrit l'écosystème Symfony [...] se mettent.

attendre que tout l'écosystème Symfony (bibliothèques tierces, bundles et projets qui utilisent Symfony) se mettent à jour.

http://symfony.com/fr/doc/2.3/contributing/community/releases.html#developpement

Ces changements concernent Symfony 2.3+.

[CookBook] Secure with annotations don't work anymore

Hello guys,
did you try this chapter ?
http://symfony.com/fr/doc/current/cookbook/security/securing_services.html

Because it don't seems to work with 2.6 version of symfony. I cleared the cache and it still let me display the page...

@secure("ROLE_ADMINOS") is not working anymore could someone confirm ?

Missing 2.1 branch mentioned on homepage

On the homepage it is written / Sur la page d'accueil de ce dépôt il est écrit :

Ce qui précède concerne le dépôt de la documentation anglaise, et non pas ce dépôt. Si vous trouvez une erreur de traduction, vous êtes prié de faire une Pull Request sur la branche 2.1 et non pas sur la master.

The branch 2.1 doesn't exist / La branche 2.1 n'existe pas : https://github.com/symfony-fr/symfony-docs-fr/branches

[Bundles][DoctrineMigrationsBundle] update

Hello,

Looking at http://symfony.com/doc/master/bundles/DoctrineFixturesBundle/index.html, there is only one require. The dependencies being managed by https://github.com/doctrine/DoctrineFixturesBundle/blob/master/composer.json.

{
    "require": {
        "doctrine/doctrine-fixtures-bundle": "2.2.*"
    }
}

However in http://symfony.com/doc/master/bundles/DoctrineMigrationsBundle/index.html, we have:

{
    "require": {
        "doctrine/migrations": "1.0.*@dev",
        "doctrine/doctrine-migrations-bundle": "2.1.*@dev"
    }
}

Shouldn't the doctrine/migrations dependency be handled only by https://github.com/doctrine/DoctrineMigrationsBundle/blob/master/composer.json ? It would avoid a repetition.

Kind regards

README.md is misleading

There does not seem to be a 2.0 branch in this repository.

Fix code-block on security.rst:1258

dans le book/security.rst:1258 le code proposé n’est pas le bon (la version uk donne le bon )

chain_provider:
    providers: [in_memory, user_db]

doit devenir

chain_provider:
   chain : 
        providers: [in_memory, user_db]

Typo in components/http_foundation/introduction.rst

Located in the #creer-un-flux-de-reponse section

La fonction flush() ne vide par le tampon

should be :

La fonction flush() ne vide pas le tampon

SF 2.1 renderBlock

there's a problem here :
http://symfony.com/fr/doc/current/cookbook/form/form_customization.html#theme-de-formulaire-en-php

the renderBlock function doesn't exist in SF2.1

English version works well

Change spaces by non-breaking spaces

We must change all common spaces by non-breaking spaces before "!", "?", ":" and ";".

Translate HttpKernel documentation

I'm offering my help to translate the HttpKernel documentation to french for 2.3 and upper versions (2.4 at this time).

quiz

2.2 branch

As of the https://github.com/symfony/symfony-docs, we should create a 2.2 branch and use master for 2.3 version.

LInk to PSR0 is not up to date

I could see on multiple pages the broken links of PSR0

Typo in image security_authentication_authorization.png

There's a typo in this image security_authentication_authorization.png (book/security).

It says Securiser les objets et les mothodes
It should be Sécuriser les objets et les méthodes

Translating images

For instance the websequence diagrams shouldn't be hard to translate.

I'll try to do a first pr this evening

wrong 'rendered as' Reference/Documents Form/Types Reference/integer Field Type

the right 'rendered as' of integer field is 'input integer and not 'input text'.

session pdo handler

In the cookbook, you don't explain to add something like this

calls:
    - [ setAttribute, [3, 2] ] 
    # \PDO::ATTR_ERRMODE, \PDO::ERRMODE_EXCEPTION
 

after the pdo service definition.

Therefore we get this error :

InvalidArgumentException: "Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler" requires PDO error mode attribute be set to throw Exceptions (i.e. $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION))

Typo

Dans la doc française sur les formulaires (2.2 à 2.4)
http://symfony.com/fr/doc/current/book/forms.html
sous "Désactiver la validation" :

Parfois, il peut être utilise

devrait être :

Parfois il peut être utile

Wrong current version in select for french documentation

Hello,
In the french documentation (all pages), the select box to choose symfony version indicates that the current version is 2.6
Choices are

• 2.3
• 2.4
• 2.5
• 2.6 / current
• 2.7
• 3.0 / master

English version is Ok and marks 2.7 as current

Added translation for the ExpressionLanguage component

I'm going to translate the ExpressionLanguage component documentation to french.

Fix build errors

Hi Frenchmen,

Could you please take a look at the build errors page and try to fix the errors in the correct branches of the French docs? If you need help, you can always ping me :)

thank you!