File: FAQ.md

package info (click to toggle)
libtemplate-plugin-gettext-perl 1.0-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 352 kB
  • sloc: perl: 1,317; makefile: 2
file content (34 lines) | stat: -rw-r--r-- 1,409 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
# Frequently Asked Questions

Well, not all of them are frequently asked but rather just interesting.

## Why Do Template Syntax Errors Go Through Unnoticed

The message extractor `xgettext-tt2` is not a syntax checker for template
files.  It just understands enough of Template Toolkit's syntax to extract
translatable strings from templates according to the options you have
invoked it with.

See https://github.com/gflohr/Template-Plugin-Gettext/issues/2 for
more aspects.

## Can I Use `xgettext-tt2` For [Log::Report::Template](http://search.cpan.org/~markov/Log-Report-Template/)?

Yes, like this:

```shell
xgettext-tt2 --plug-in --keyword --keyword=loc --flag=loc:1:perl-brace-format --add-comments=TRANSLATORS: --from-code=utf-8 TEMPLATEFILE...
```

Using the option `--plug-in` without an argument has the
effect that `xgettext-tt2` will recognize template functions
in the root namespace.

Extracting strings for `Log::Report::Template` with `xgettext-tt2` has a number of advantages:

* easier integration into build processes
* correct flags for extracted messages
* translator comments
* all boiler-plate options from [Locale::XGettext](http://search.cpan.org/~guido/Locale-XGettext/) like `--msgid-bugs-address`, `--from-code`, etc.

You need at least version `xgettext-tt2` version 0.5 (contained in Locale-XGettext-TT2 version 0.5) for extracting strings from functions in the root namespace.