From 30a42690188e32c74eceb52db55d83de289d514a Mon Sep 17 00:00:00 2001
From: Pierre Rudloff <contact@rudloff.pro>
Date: Sat, 30 Nov 2019 15:16:34 +0100
Subject: [PATCH] xgettext: add page (#3635)

---
 pages/common/xgettext.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)
 create mode 100644 pages/common/xgettext.md

diff --git a/pages/common/xgettext.md b/pages/common/xgettext.md
new file mode 100644
index 0000000000..3d8b8a375a
--- /dev/null
+++ b/pages/common/xgettext.md
@@ -0,0 +1,20 @@
+# xgettext
+
+> Extract gettext strings from code files.
+> More information: <https://www.gnu.org/software/gettext/manual/html_node/xgettext-Invocation.html>.
+
+- Scan file and output strings to `messages.po`:
+
+`xgettext {{path/to/input_file}}`
+
+- Use a different output filename:
+
+`xgettext --output {{path/to/output_file}} {{path/to/input_file}}`
+
+- Append new strings to an existing file:
+
+`xgettext --join-existing --output {{path/to/output_file}} {{path/to/input_file}}`
+
+- Don't add a header containing metadata to the output file:
+
+`xgettext --omit-header {{path/to/input_file}}`