# 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