= sfI18nExtract plugin =

The `sfI18nExtract` is a symfony plugin that provides i18n strings extraction.

This plugin is a backport of a symfony 1.1 native feature.

== Installation ==

  * Install the plugin
  
  {{{
    symfony plugin-install http://plugins.symfony-project.com/sfI18nExtractPlugin
  }}}
  
  * Clear you cache
  
  {{{
    symfony cc
  }}}

=== Usage ===

The `i18n-extract` task parses a symfony application to extract all the strings that need to be translated.

It takes an application and a culture as its arguments:

  {{{
    php symfony i18n-extract frontend en
  }}}

By default, the task does not modify your dictionaries, it just outputs the number of new and old i18n strings. 
To append the new strings to your dictionary, you can pass the `--auto-save` option:

  {{{
    php symfony i18n-extract --auto-save frontend en
  }}}

You can also delete old strings automatically by passing the `--auto-delete` option:

  {{{
    php symfony i18n-extract --auto-save --auto-delete frontend en
  }}}

=== Known limitations ===

  * Can only works with the default "messages" catalogue
  * For file backends (XLIFF and gettext), it only saves/deletes strings in the `apps/myapp/i18n/messages.XX.xml` file

=== Patch ===

The patches needed to convert the symfony 1.1 implementation to the one used in this plugin can be obtained with the 2 following commands:

  {{{
    svn diff http://svn.symfony-project.com/trunk/lib/i18n/extract/ http://svn.symfony-project.com/plugins/sfI18nExtractPlugin/lib
    svn diff http://svn.symfony-project.com/trunk/data/tasks/sfPakeI18N.php http://svn.symfony-project.com/plugins/sfI18nExtractPlugin/data/tasks/sfPakeI18N.php
  }}}