.\"                                      Hey, EMACS: -*- nroff -*-
.\" (C) Copyright 2017 Boyuan Yang <073plan@gmail.com>,
.\"
.TH "DEEPIN-DESKTOP-TS-CONVERT" "1" "2017-08-11" "Deepin Gettext Tools"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
deepin-desktop-ts-convert \- convert between .desktop file and .ts file to ease translation
.SH SYNOPSIS
.B deepin-desktop-ts-convert init
\fIdesktopFile outputTsDir\fR
.br
.B deepin-desktop-ts-convert desktop2ts
\fIdesktopFile outputTsDir\fR
.br
.B deepin-desktop-ts-convert ts2desktop
\fIdesktopFile tsDir outputDesktopFile\fR
.SH DESCRIPTION
This manual page documents briefly the
.B deepin-desktop-ts-convert
command as provided by
.B deepin-gettext-tools
package.
.PP
\fBdeepin-desktop-ts-convert\fP is a utility that helps developers convert
translatable strings in desktop files into ts files to ease translation
work. Translated strings in ts files can be merged back to original
desktop file too with the help of this utility.
.PP
Such workflow is adopted by most Deepin software.
.SH USAGE
.PP
To initialise conversion, use \fIdeepin-desktop-ts-convert init\fR subcommand.
In which case source ts file will be put into \fIoutputTsDir/desktop.ts\fR
and translation ts files should be named as \fIoutputTsDir/desktop_\<lang\>.ts\fR.
.sp
.if n \{\
.RS 4
.\}
.nf
deepin-desktop-ts-convert init desktopFile outputTsDir
.fi
.if n \{\
.RE
.\}
.PP
To update ts files from a new version of desktop file, use
\fIdeepin-desktop-ts-convert desktop2ts\fR subcommand.
The updated ts file given as outputTsDir/desktop.ts file.
.sp
.if n \{\
.RS 4
.\}
.nf
deepin-desktop-ts-convert desktop2ts desktopFile outputTsDir
.fi
.if n \{\
.RE
.\}
.PP
To generate translated desktop files, use
\fIdeepin-desktop-ts-convert ts2desktop\fR subcommand.
.sp
.if n \{\
.RS 4
.\}
.nf
deepin-desktop-ts-convert ts2desktop desktopFile tsDir outputDesktopFile
.fi
.if n \{\
.RE
.\}
.SH SEE ALSO
.PP
.BR deepin-update-pot (1),
.BR deepin-generate-mo (1),
.BR deepin-policy-ts-convert (1).
.PP
The programs are further documented in the
.IR README.md
as provided with this debian package under
.IR /usr/share/doc/deepin-gettext-tools/
directory.
.SH AUTHOR
.PP
.B deepin-gettext-tools
is written by Deepin Technology Co., Ltd.
.PP
This manual page was written by
.MT 073plan@\:gmail.com
Boyuan Yang
.ME
for the Debian Project (but may be used by others).