Comments (9)
@nemoeslovo I think you have a few issues in your config. First of all, your source_dir
needs to point at English resources, because your source_language
set to en
, and this path will always stay the same (it shoudn't have any language-based macros). Now, both output_file_path
and ts_file_path
need to have a language-based macro to output final localized files and translation files properly under different paths for each destination language. Even if you are about to import translations (do the opposite of localize
), source_dir
points to your source language files, and output_file_path
points to your localized files. Also, Serge expects your entire job configuration to be valid before running any action, so this is why you get the error about ts_file_path
.
I assume you're working on some iOS or Mac project, so here are some relevant options for your job config:
source_language en
destination_languages ru es no pt pt-br zh-cn zh-tw # sample 'canonical' language names
source_dir ./Translation/en.lproj # English resources are the 'source' ones
source_match \.strings$ # process all .strings files
# This is where your localized resources will be generated
# (and on `serge import`, this is where Serge will find your previously
# existing localized resources
output_file_path ./Translation/%LANG%.lproj/%FILE%
# both iOS and Mac expect .strings files encoded in UTF-16LE and having BOM
output_encoding UTF-16LE
output_bom YES
# this is where your .po files will be generated on `serge localize`
ts_file_path ./po/%LOCALE%/%FILE%.po
# we need to rewrite some language codes when generating
# localized file paths the way iOS and Mac OS expects them
output_lang_rewrite
{
pt pt-PT
pt-br pt-BR
zh-cn zh-Hans
no nb-NO
zh-tw zh-Hant
}
from serge.
@nemoeslovo added this section: https://serge.io/docs/help/serge-import/#sel:ZGl2L2Rpdi4yL2Rpdi9kaXYuMS9wLjUvQC1kaXYvZGl2LjIvZGl2L2Rpdi4xL3AuNS9ALjI6NTE
from serge.
After serge import
all translations should be there in Serge database (I recommend looking at HTML report produced by the import step to see if it looks good, and then exploring Serge database using any SQLite DB explorer).
After successful import, running serge localize
should re-generate the target resource files, and all the translations should be there.
from serge.
It turns out there was a problem in my config file. I was running process_if and had it configured incorrectly so it would never translate any items. Running "serge localize --debug" allowed me to see that.
from serge.
Sorry if my problem is not fully related to the issue above, but I got some issue with serge import
which could be discussed here.
I was trying to make serge import
and it seems trivial for one language, but I got strange output when I was trying to make it work for few languages.
Here is my config for one language, which works:
jobs
{
:import
{
id job.import
name Initial Importing
debug YES
source_language en
destination_languages ru
source_dir ./Translation/ru.lproj
parser
{
plugin parse_strings
}
db_source DBI:SQLite:dbname=./translate.db3
db_namespace test_namespace
}
}
After that I tried to put use
destination_languages ru es
source_dir ./Translation/%LANG%.lproj
and got an error:
Job 'job.import' will be skipped: when there's more than one target language, 'ts_file_path' should have %LANG%, %LOCALE%, %CULTURE%, %LANGNAME%, or %LANGID% macro defined
Must be I misunderstand macros concept, but I expect it to be pre filed by serge with currently processing language. Also I don't fully understand why there is a demand to fill ts_file_path
when I just intended to import translations.
BTW, thanks for amazing framework! 🚀
from serge.
@nemoeslovo, also, just to reiterate: I see that you have created your job specifically for importing purposes. Instead, you need to create the job for the final task (localization), and then use it as is, without any modifications, to import your pre-existing translations (serge import
). After that you can use it to generate resources (serge localize
).
from serge.
Works like a charm 🔥. I got you point from your last comment. It makes sense if you know that job suppose to represent only full translation cycle and serge import
is just a complimentary, because otherwise it's a bit confusing why we are importing translations from output_file_path
. I would love to see your comment about output_file_path
in the sample config
from serge.
Serge expects your entire job configuration to be valid before running any action, so this is why you get the error about
ts_file_path
.
Do you think it'd make sense to have a serge command to do some sanity checks? This could check configuration is syntactically OK, and also ensure the paths being used for sources point to existing resources. If it also displayed a summary of what's going to be done, it could help users to easier adopt and customize the configuration files.
Another interesting option would be having the ability to initialize configuration files from presets or templates, this way allowing people to setup in a few keystrokes projects with specific configuration gotchas (can be the case for Mac-related projects).
from serge.
Do you think it'd make sense to have a serge command to do some sanity checks? This could check configuration is syntactically OK
This is what Serge already does — configs are checked against the schema, and also specific values are checked. The error reported above was exactly the kind of error provided by a validator before any localization/import task is actually executed.
and also ensure the paths being used for sources point to existing resources.
Serge does check what it can. However, due to their nature, some of the target paths/files might be missing (and then it's not an error — Serge is supposed to create these).
If it also displayed a summary of what's going to be done, it could help users to easier adopt and customize the configuration files.
Some Serge commands (including serge import
) have the --dry-run
option exactly for this purpose. In some cases, like with serge localize
, implementing a --dry-run
option can be non-trivial (because some parts of the code require information to be put into the database so that it can be reused at some later step, and --dry-run
mode implies no changes to database or files.
initialize configuration files from presets or templates, this way allowing people to setup in a few keystrokes projects with specific configuration gotchas
I think this can be done with better documentation (specifically, configuration 'recipes' for different platforms).
from serge.
Related Issues (20)
- parse_php_xhtml: add an ability to fine-tune the list of tags processed by default
- Serge always prints debug output on CI. HOT 1
- Qt Text Id based (ts files) HOT 5
- Localized file generation failed HOT 5
- Typo bug: DROP index items_file_id_string_id after CREATE HOT 1
- Add support for computed properties in parse_js parser
- Optimizations prevent reusing translations on existing unmodified files
- Cannot use env variable on boolean property
- Serge surprisingly cuts file name. HOT 3
- transliterate option of test_language plugin should not modify printf() parameter fields
- [Question] Are there any examples (e.g. GitLab CI)?
- Support multiple source files in single XLIFF file HOT 1
- Each <trans-unit> sets "approved=yes" for untranslated strings HOT 3
- parse nginx.conf bug,include not support wildcard HOT 1
- While put the mouse on (Notebooks section) we are unable to place mouse directly on scroll bar, please increase the mouse scroll width like how the size it as page right hand side up and down scroll bar size.
- Parse MD file
- run_command for jobs with several destination_languages dont change %OUTFILE% variable HOT 1
- export_to_ttx is not including the translated text
- Docs no longer easily accessible HOT 1
- Ownership transfer request HOT 2
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from serge.