.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.ie \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.el \{\
.    de IX
..
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "Jifty::Script::Po 3pm"
.TH Jifty::Script::Po 3pm "2010-12-08" "perl v5.14.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SS "options"
.IX Subsection "options"
Returns a hash of all the options this script takes. (See the usage message for details)
.SS "run"
.IX Subsection "run"
Runs the \*(L"update_catalogs\*(R" method.
.SS "_check_mime_type \s-1FILENAME\s0"
.IX Subsection "_check_mime_type FILENAME"
This routine returns a mimetype for the file \f(CW\*(C`FILENAME\*(C'\fR.
.SS "update_catalogs"
.IX Subsection "update_catalogs"
Extracts localizable messages from all files in your application, finds
all your message catalogs and updates them with new and changed messages.
.SS "update_catalog \s-1FILENAME\s0"
.IX Subsection "update_catalog FILENAME"
Reads \f(CW\*(C`FILENAME\*(C'\fR, a message catalog and integrates new or changed 
translations.
.SS "extract_messages"
.IX Subsection "extract_messages"
Find all translatable messages in your application, using 
Locale::Maketext::Extract.
.SS "print_help"
.IX Subsection "print_help"
Prints out help for the package using pod2usage.
.PP
If the user specified \-\-help, prints a brief usage message
.PP
If the user specified \-\-man, prints out a manpage
.SS "pot_name"
.IX Subsection "pot_name"
Returns the name of the po template.
.SH "NAME"
Jifty::Script::Po \- Extract translatable strings from your application
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 2
\&  jifty po \-\-language <lang>  Creates a <lang>.po file for translation
\&  jifty po                    Updates all existing po files
\&
\& Options:
\&   \-\-language         Language to deal with
\&   \-\-dir              Additional directories to extract from
\&   \-\-js               Generate json files from the current po files
\&
\&   \-\-help             brief help message
\&   \-\-man              full documentation
.Ve
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-\-language\fR" 8
.IX Item "--language"
This script an option, \f(CW\*(C`\-\-language\*(C'\fR, which is optional; it is the
name of a message catalog to create.
.IP "\fB\-\-dir\fR" 8
.IX Item "--dir"
Specify explicit directories to extract from. Can be used multiple
times.  The default directories will not be extracted if you use this option.
.IP "\fB\-\-template_name\fR" 8
.IX Item "--template_name"
Specify the name of the po template.  Default to the lower-cased application name.
.IP "\fB\-\-podir\fR" 8
.IX Item "--podir"
Specify the directory of the po templates.
.IP "\fB\-\-js\fR" 8
.IX Item "--js"
If \f(CW\*(C`\-\-js\*(C'\fR is given, other options are ignored and the script will
generate json files for each language under
\&\fIshare/web/static/js/dict\fR from the current po files.  Before doing
so, you might want to run \f(CW\*(C`jifty po\*(C'\fR with \f(CW\*(C`\-\-dir share/web/static/js\*(C'\fR
to include messages from javascript in your po files.
.IP "\fB\-\-help\fR" 8
.IX Item "--help"
Print a brief help message and exits.
.IP "\fB\-\-man\fR" 8
.IX Item "--man"
Prints the manual page and exits.
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
Extracts message catalogs for your Jifty app. When run, Jifty will update
all existing message catalogs, as well as create a new one if you specify
a \-\-language option.