Project

isodoc-i18n

0.0
The project is in a healthy, maintained state
isodoc-i18nmetanorma/isodoc-i18nHomepageDocumentationSource CodeBug TrackerWiki
Internationalisation for Metanorma rendering
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Popularity
Downloads
182,159
Stars
0
Forks
0
Watchers
9
 Releases
Current version
1.5.3
Total releases
37
First release
2022-03-23
Latest release
2026-05-25
 Issues
Open Issues
1
Closed Issues
12
Total Issues
13
Issue Closure Rate
92%
 Pull Requests
Open Pull Requests
0
Closed Pull Requests
0
Merged Pull Requests
12
Pull Request Acceptance Rate
100%
 Development
Primary Language
Ruby
Licenses
BSD-2-Clause
Average date of last 50 commits
2026-02-13
Reverse Dependencies
2

 Dependencies

Development

canon
>= 0
rubocop-performance
>= 0
debug
>= 0
equivalent-xml
~> 0.6
guard
~> 2.14
guard-rspec
~> 4.7
rake
~> 13.0
rspec
~> 3.6
rubocop
~> 1
simplecov
~> 0.15
timecop
~> 0.9
webmock
>= 0

Runtime

liquid
~> 5
base64
>= 0
japanese_calendar
>= 0
roman-numerals
>= 0
htmlentities
~> 4.3.4
metanorma-utils
>= 1.7.0
twitter_cldr
>= 0
 Project Readme

isodoc-i18n

Gem Version Build Status Pull Requests Commits since latest

Internationalisation for Metanorma rendering.

isodoc-i18n is the shared i18n/l10n base layer used across the metanorma flavours. It provides:

  • YAML-driven locale labels (IsoDoc::I18n#labels, populate) — per-language label sets loaded from i18n YAML, with cross-file references and Liquid template interpolation.

  • CLDR-backed l10n of punctuation and spacing (#l10n) — CJK contextual half-width/full-width punctuation, French spacing rules, bidi wrapping for RTL scripts.

  • Grammatical inflection and ordinals (#inflect, #inflect_ordinal) — number/case/gender/person inflection driven by per-language YAML inflection tables, plus CLDR OrdinalRules and SpelloutRules formatting.

  • Liquid filter integration (IsoDoc::I18n::Liquid) — inflect, ordinal_num, ordinal_word, etc. registered globally on Liquid::Environment.default for use in metanorma templates.

  • Boolean conjunction list rendering (#boolean_conj) — locale-correct "A, B, and C"-style joins.

  • Extended date formatting (IsoDoc::I18n#date, IsoDoc::ExtendedDateFormatter) — see below.

Extended date formatting

isodoc-i18n ships an extended strftime-style date formatter, IsoDoc::ExtendedDateFormatter, that adds POSIX-flavoured era and alternative-numbering surfaces (Japanese era years, kanji spell-out, Han digits, Roman months) on top of Ruby’s Date#strftime. It is the engine behind IsoDoc::I18n#date and metanorma’s <date value="…" format="…"/> element, and can also be used standalone:

require "isodoc-i18n"

f = IsoDoc::ExtendedDateFormatter.new(lang: "ja", script: "Jpan")
f.format("2024-09-30", "%EY年%-m月%-d日")        # => "令和6年9月30日"

g = IsoDoc::ExtendedDateFormatter.new(lang: "en", script: "Latn")
g.format("2024-09-30", "%-d.%Om{roman}.%Y")      # => "30.IX.2024"

Full token reference, calendar dispatch rules, and a comparison with twitter_cldr, japanese_calendar, ffi-icu, and other adjacent tooling: docs/extended-date-format.adoc.