man: add self-contained example of notify protocol

[thirdparty/systemd.git] / docs / TRANSLATORS.md

diff --git a/docs/TRANSLATORS.md b/docs/TRANSLATORS.md
index 38c2487b90d665b4637906218d5205551be39293..2f578cc6f582a9b30720054dcfff664c8e8cfb91 100644 (file)
--- a/docs/TRANSLATORS.md
+++ b/docs/TRANSLATORS.md
@@ -1,3 +1,10 @@
+---
+title: Notes for Translators
+category: Contributing
+layout: default
+SPDX-License-Identifier: LGPL-2.1-or-later
+---
+
 # Notes for Translators
 
 systemd depends on the `gettext` package for multilingual support.
@@ -14,7 +21,7 @@ Finally, it is able to compile the translations (to `*.gmo` files), so that
 they can be used by systemd software. (This step is also useful to confirm the
 syntax of the `*.po` files is correct.)
 
-# Creating a New Translation
+## Creating a New Translation
 
 To create a translation to a language not yet available, start by creating the
 initial template:
@@ -25,21 +32,21 @@ $ ninja -C build/ systemd-pot
 
 This will generate file `po/systemd.pot` in the source tree.
 
-Then simply copy it to a new <code><i>${lang_code}</i>.po</code> file, where
-<code><i>${lang_code}</i></code> is the two-letter code for a language
+Then simply copy it to a new `${lang_code}.po` file, where
+`${lang_code}` is the two-letter code for a language
 (possibly followed by a two-letter uppercase country code), according to the
 ISO 639 standard.
 
 In short:
 
-<pre>
-$ cp po/systemd.pot po/<i>${lang_code}</i>.po
-</pre>
+```
+$ cp po/systemd.pot po/${lang_code}.po
+```
 
-Then edit the new <code>po/<i>${lang_code}</i>.po</code> file (for example,
+Then edit the new `po/${lang_code}.po` file (for example,
 using the `poedit` GUI editor.)
 
-# Updating an Existing Translation
+## Updating an Existing Translation
 
 Start by updating the `*.po` files from the latest template:
 
@@ -63,7 +70,7 @@ Once you're done, create a git commit for the update of the `po/*.po` file you
 touched. Remember to undo the changes to the other `*.po` files (for instance,
 using `git checkout -- po/` after you commit the changes you do want to keep.)
 
-# Recompiling Translations
+## Recompiling Translations
 
 You can recompile the `*.po` files using the following command: