From nobody Fri Jun 26 20:22:50 2026 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4gn6YQ6Pgcz6hqSr for ; Fri, 26 Jun 2026 20:22:50 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "YR1" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 4gn6YQ5R6sz3n2Y for ; Fri, 26 Jun 2026 20:22:50 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1782505370; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=sErw/T5a3yzQSuuQ+YIcbKwnZuwLPg7JGHr3C3RkuEw=; b=hO20kLfxRNOudmCZXwjCOKkZPgyJqcwlckv6ekXgTIjzEhPggV777HhsVMjODvtXB6gxZ2 MUFkooxzO+64CMGNi4dqynPNCWYxrvAtcvRPS6fC/PbBiFe21y1NFIJNxcHmTR42huWs/k xgFHiBsYRrh3BZgRJlizxUNl5Bzag+R00vicG4dpBDhW6kqcXrkTjbsV1UpZXlPAGhx+dk Gt2BJ08e8QVQJ8oKQYBM3spiV2LOqfNNoo1tBgnG9ui+PLlX8K9/xIrID5bhRInOyAJYmS BK+8p4/nax9b0ZyVaANFWcO8ScqnowUn193GzhGQcoc7t3bL9v4wC4J37nv3HQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1782505370; a=rsa-sha256; cv=none; b=T16A7W5XT1WIJysekxUyc9snKsQv+bBi0yr+1GsTlaySmEKA+KbWggtlhQruu2P/HBLqSO Dp0MlbJBPVA7+3d7+FQp9xYj4VEzv2O+1PrQcUdxijjufiKuVIgoJKubLY+tEcpOtI0+W8 6Yffj5N0SMRsZjzAw1MAL5xIB6qpLOF9yxFlX9S3IsGYOQTctDbuzBm/KILc4AL8f07eeN aURjEs28Pzho58Y9mWIX9zZDpmmjiUecASe4sd/4b7gOTqljCrFtQ12mx6ovOTuylIJRQ4 8be+W7uBQ9XLtU+A+2J6FEHN+X3K+zsdok2ovvquUmlfLmbBxCt5z9a0rJv8Cg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1782505370; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=sErw/T5a3yzQSuuQ+YIcbKwnZuwLPg7JGHr3C3RkuEw=; b=Ls/GAUihE176FhoTTKJjy6cq9CXEVmnLBBd7Hbbo1lsWHasPPbMllrRvSC7JMTpb+Epl3P NKxh7Q8HfM/4OdpD1pU9lmOGdEO5ApfQCxzD8OPcbpBhg5P30TpK0k7qka1M6UMc0TZd9g +sdmExtLikLA9fwntc74GCI6Deb0GrimhocvSex6eOvOG+JUjd1aQZYuldBWvkR7zrP++i 6ORVRtD3VUSHF0CdHqFx6ymnIiyXMR2RU4lq12+wZ4snEBBvHwNmwAqu8OTlcYASA4TEkQ NHhHZw/aUUW8dB+Xue/xX5ykcYBPK20HGBgfIqeB0z/YUgXCjK08jNDeO9RsIA== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4gn6YQ49NNzt8r for ; Fri, 26 Jun 2026 20:22:50 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 1a3ad by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Fri, 26 Jun 2026 20:22:50 +0000 To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org Cc: Alexey Shuvaev From: Benedict Reuschling Subject: git: 64b3126c0d - main - fdp-primer: Mention that .po files are generated nightly List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bcr X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 64b3126c0db9dcc8cf9a2f003b3a52dbb76a7fd1 Auto-Submitted: auto-generated Date: Fri, 26 Jun 2026 20:22:50 +0000 Message-Id: <6a3edf9a.1a3ad.3b55d9bd@gitrepo.freebsd.org> The branch main has been updated by bcr: URL: https://cgit.FreeBSD.org/doc/commit/?id=64b3126c0db9dcc8cf9a2f003b3a52dbb76a7fd1 commit 64b3126c0db9dcc8cf9a2f003b3a52dbb76a7fd1 Author: Alexey Shuvaev AuthorDate: 2026-06-26 20:15:24 +0000 Commit: Benedict Reuschling CommitDate: 2026-06-26 20:22:33 +0000 fdp-primer: Mention that .po files are generated nightly There is no need to generate the .po files manually as they are generated every night. Describe this fact in the PO translations chapter. PR: 295901 Event: Halifax Hackathon 202606 Location: Back in my old chair --- .../content/en/books/fdp-primer/po-translations/_index.adoc | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/documentation/content/en/books/fdp-primer/po-translations/_index.adoc b/documentation/content/en/books/fdp-primer/po-translations/_index.adoc index 2391b8d257..5341057012 100644 --- a/documentation/content/en/books/fdp-primer/po-translations/_index.adoc +++ b/documentation/content/en/books/fdp-primer/po-translations/_index.adoc @@ -100,6 +100,8 @@ The path is the same except for the name of the language directory. % cp ~/doc/documentation/content/en/articles/leap-seconds/_index.po \ ~/doc/documentation/content/es/articles/leap-seconds/ .... +If you are making changes to the english version of the documentation, do not edit `.po` files! +They are regenerated automatically every night by Weblate. Suppose the document or language is also being translated via Weblate. In that case, it is good to get the `.po` file from there and upload the translation document back into the platform, centralizing the translating efforts via Weblate to avoid rework. @@ -285,7 +287,8 @@ Now the document structure is ready for the translator to begin translating with The gettext system greatly reduces the number of things that must be tracked by a translator. Strings to be translated are extracted from the original document into a PO file. -Then a PO editor is used to enter the translated versions of each string. +This is done automatically every night by Weblate, and there is no need to edit original `.po` files manually! +A PO editor is used to enter the translated versions of each string. The FreeBSD PO translation system does not overwrite PO files, so the extraction step can be run at any time to update the PO file.