Silme:0.7: Difference between revisions

no edit summary
No edit summary
 
Line 35: Line 35:


== Feature Summary ==
== Feature Summary ==
# Support for plurals
* Support for plurals
* '''Feature explanation:''' Add support for entities requiring plural forms in silme.core
** '''Feature explanation:''' Add support for entities requiring plural forms in silme.core
**  Bug [https://bugzilla.mozilla.org/show_bug.cgi?id=496359 496359] tracks the progress on this feature.
***  Bug [https://bugzilla.mozilla.org/show_bug.cgi?id=496359 496359] tracks the progress on this feature.
* Both gettext and l20n have support for plural forms
** Both gettext and l20n have support for plural forms
* Presently, Silme is pretty specific to gettext, and we want to migrate it closer to l20n one day
** Presently, Silme is pretty specific to gettext, and we want to migrate it closer to l20n one day


# Get a flat list of entities from a structure
* Get a flat list of entities from a structure
* '''Feature explanation:''' Present a flat list of untranslated entities as output, instead of the nested package structure
** '''Feature explanation:''' Present a flat list of untranslated entities as output, instead of the nested package structure
** When asking for untranslated entities in a flat list, Silme will now return a list of pairs:  entity *with* the path
*** When asking for untranslated entities in a flat list, Silme will now return a list of pairs:  entity *with* the path
**  Using the path, you can write back to the proper place in the structure
***  Using the path, you can write back to the proper place in the structure
* End-user can work on entity-list without having to dig through structure
** End-user can work on entity-list without having to dig through structure
* This will be used by Koala project
** This will be used by Koala project
* Bug [https://bugzilla.mozilla.org/show_bug.cgi?id=497196 497196] tracks Silme's ability for L10nPackage.get_entities to return entities with paths
** Bug [https://bugzilla.mozilla.org/show_bug.cgi?id=497196 497196] tracks Silme's ability for L10nPackage.get_entities to return entities with paths
*  Bug [https://bugzilla.mozilla.org/show_bug.cgi?id=496372 496372] provides the entity list of untranslated strings
**  Bug [https://bugzilla.mozilla.org/show_bug.cgi?id=496372 496372] provides the entity list of untranslated strings


# Simplification of the API
* Simplification of the API
* '''Feature explanation:''' Rename Silme's long method and class names with shorter names
** '''Feature explanation:''' Rename Silme's long method and class names with shorter names
* Made class names shorter when possible
** Made class names shorter when possible
* Bug [https://bugzilla.mozilla.org/show_bug.cgi?id=498915 498915] tracks this progress
** Bug [https://bugzilla.mozilla.org/show_bug.cgi?id=498915 498915] tracks this progress


# Processing
* Processing
* '''Feature explanation:''' Process entities so that processed value of an entity is provided in place of the source name
** '''Feature explanation:''' Process entities so that processed value of an entity is provided in place of the source name
*  DTD files are loaded with variables like "%sBrandShortName"
**  DTD files are loaded with variables like "%sBrandShortName"
* Take entity, process it, and not return the source name of the entity, but the "processed" value
** Take entity, process it, and not return the source name of the entity, but the "processed" value
* Silme users then can see the actual structure of the sentence
** Silme users then can see the actual structure of the sentence


# Split to repositories
* Split to repositories
* Silme Library
** Silme Library
* Silme Scripts
** Silme Scripts
* Easier to package in easy_install  
** Easier to package in easy_install  
* Maintain the library code
** Maintain the library code
* Does rely on any script
** Does rely on any script


# Extended l20n format serializer
* Extended l20n format serializer
* '''Feature explanation:''' Write l20n files with Silme
** '''Feature explanation:''' Write l20n files with Silme
** Bug [https://bugzilla.mozilla.org/show_bug.cgi?id=499145 499145] tracks this feature
*** Bug [https://bugzilla.mozilla.org/show_bug.cgi?id=499145 499145] tracks this feature


# HTML diff output
* HTML diff output
*  '''Feature explanation:''' With this feature, we plan to add an HTML format serializer for silme.diff.* to Silme so we can present diffs generated from Silme's compare-locales in HTML format
**  '''Feature explanation:''' With this feature, we plan to add an HTML format serializer for silme.diff.* to Silme so we can present diffs generated from Silme's compare-locales in HTML format
*  Bug [https://bugzilla.mozilla.org/show_bug.cgi?id=491715 491715]  
**  Bug [https://bugzilla.mozilla.org/show_bug.cgi?id=491715 491715]  


# Clean obsolete scripts
* Clean obsolete scripts
*  '''Feature explanation:'''  This feature will allow obsolete entities within a localization to be removed using a Silme command.
**  '''Feature explanation:'''  This feature will allow obsolete entities within a localization to be removed using a Silme command.
*  Bug [https://bugzilla.mozilla.org/show_bug.cgi?id=500339 500339] tracks this progress.
**  Bug [https://bugzilla.mozilla.org/show_bug.cgi?id=500339 500339] tracks this progress.