f671f9d2c9
refs #5345, refs #3801 - Blog localisation - default is `en` (English) - you can change the language code in the admin panel, see https://github.com/TryGhost/Ghost-Admin/pull/703 - blog behaviour changes depending on the language e.g. date helper format - theme translation get's loaded if available depending on the language setting - falls back to english if not available - Theme translation - complete automatic translation of Ghost's frontend for site visitors (themes, etc.), to quickly deploy a site in a non-English language - added {{t}} and {{lang}} helper - no backend or admin panel translations (!) - easily readable translation keys - very simple translation - server restart required when adding new language files or changing existing files in the theme - no language code validation for now (will be added soon) - a full theme translation requires to translate Ghost core templates (e.g. subscriber form) - when activating a different theme, theme translations are auto re-loaded - when switching language of blog, theme translations are auto re-loaded - Bump gscan to version 1.3.0 to support more known helpers **Documentation can be found at https://themes.ghost.org/v1.20.0/docs/i18n.**
35 lines
1.5 KiB
JavaScript
35 lines
1.5 KiB
JavaScript
// # Plural Helper
|
|
// Usage example: `{{plural ../pagination.total empty='No posts' singular='1 post' plural='% posts'}}`
|
|
// or for translatable themes, with (t) translation helper's subexpressions:
|
|
// `{{plural ../pagination.total empty=(t "No posts") singular=(t "1 post") plural=(t "% posts")}}`
|
|
//
|
|
// Pluralises strings depending on item count
|
|
//
|
|
// The 1st argument is the numeric variable which the helper operates on
|
|
// The 2nd argument is the string that will be output if the variable's value is 0
|
|
// The 3rd argument is the string that will be output if the variable's value is 1
|
|
// The 4th argument is the string that will be output if the variable's value is 2+
|
|
|
|
var proxy = require('./proxy'),
|
|
_ = require('lodash'),
|
|
errors = proxy.errors,
|
|
i18n = proxy.i18n,
|
|
SafeString = proxy.SafeString;
|
|
|
|
module.exports = function plural(number, options) {
|
|
if (_.isUndefined(options.hash) || _.isUndefined(options.hash.empty) ||
|
|
_.isUndefined(options.hash.singular) || _.isUndefined(options.hash.plural)) {
|
|
throw new errors.IncorrectUsageError({
|
|
message: i18n.t('warnings.helpers.plural.valuesMustBeDefined')
|
|
});
|
|
}
|
|
|
|
if (number === 0) {
|
|
return new SafeString(options.hash.empty.replace('%', number));
|
|
} else if (number === 1) {
|
|
return new SafeString(options.hash.singular.replace('%', number));
|
|
} else if (number >= 2) {
|
|
return new SafeString(options.hash.plural.replace('%', number));
|
|
}
|
|
};
|