.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" 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
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'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 >0, 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.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "LOCALE::PO4A::YAML.3PM 1"
.TH LOCALE::PO4A::YAML.3PM 1 2025-11-22 "perl v5.42.0" "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
.SH NAME
Locale::Po4a::Yaml \- convert YAML files from/to PO files
.SH DESCRIPTION
.IX Header "DESCRIPTION"
Locale::Po4a::Yaml is a module to help the translation of Yaml files into other
[human] languages.
.PP
The module extracts the value of YAML hashes and arrays. Hash keys are
not extracted.
.PP
NOTE: This module parses the YAML file with YAML::Tiny.
.SH "OPTIONS ACCEPTED BY THIS MODULE"
.IX Header "OPTIONS ACCEPTED BY THIS MODULE"
These are this module\*(Aqs particular options:
.IP \fBkeys\fR 4
.IX Item "keys"
Space\-separated list of hash keys to process for extraction, all
other keys are skipped.  Keys are matched with a case\-sensitive match.
If \fBpaths\fR and \fBkeys\fR are used together, values are included if they are
matched by at least one of the options.
Arrays values are always returned unless the \fBskip_array\fR option is
provided.
.IP \fBpaths\fR 4
.IX Item "paths"
Comma\-separated list of hash paths to process for extraction, all
other paths are skipped. Paths are matched with a case\-sensitive match.
If \fBpaths\fR and \fBkeys\fR are used together, values are included if they are
matched by at least one of the options.
Arrays values are always returned unless the \fBskip_array\fR option is
provided.
.IP \fBskip_array\fR 4
.IX Item "skip_array"
Do not translate array values.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBLocale::Po4a::TransTractor\fR\|(3pm), \fBpo4a\fR\|(7)
.SH AUTHORS
.IX Header "AUTHORS"
.Vb 1
\& Brian Exelbierd <bex@pobox.com>
.Ve
.SH "COPYRIGHT AND LICENSE"
.IX Header "COPYRIGHT AND LICENSE"
.Vb 2
\& Copyright © 2017 Brian Exelbierd.
\& Copyright © 2022 Martin Quinson <mquinson#debian.org>.
.Ve
.PP
This program is free software; you may redistribute it and/or modify it
under the terms of GPL v2.0 or later (see the COPYING file).