Po4a staged merge

.github/workflows/po4a.yml

@@ -0,0 +1,189 @@
+name: run-po4a
+
+on:
+  push:
+    paths:
+    - '**.po'
+    - '**.pot'
+    - '**.md' #temp for all md files.
+    branches: po4a-staged
+  workflow_dispatch:
+    inputs:
+      run_on_all:
+        description: 'Run po4a on all files'
+        required: false
+        default: 'false'
+
+jobs:
+  changed_files:
+    runs-on: ubuntu-latest  # windows-latest || macos-latest
+    permissions:
+      # Give the default GITHUB_TOKEN write permission to commit and push the changed files back to the repository.
+      contents: write
+      pull-requests: write
+    name: Test changed-files
+    steps:
+      - name: Clone po4a repository at specific commit
+        run: |
+          git clone https://github.com/mquinson/po4a.git
+          cd po4a
+          git checkout v0.69
+
+      - name: Install Debian dependencies
+        run: |
+          sudo apt update 
+          sudo apt install -y liblocale-gettext-perl libtext-wrapi18n-perl libunicode-linebreak-perl libpod-parser-perl libtest-pod-perl libyaml-tiny-perl libsyntax-keyword-try-perl
+          sudo apt install -y cpanminus gettext docbook-xml docbook-xsl docbook xsltproc 
+          sudo apt install -y texlive-binaries texlive-latex-base opensp libsgmls-perl
+
+      - name: Install CPAN dependencies
+        run: |
+          cpanm Locale::gettext
+          cpanm http://search.cpan.org/CPAN/authors/id/R/RA/RAAB/SGMLSpm-1.1.tar.gz
+          cpanm Text::WrapI18N
+          cpanm Unicode::GCString
+          cd po4a
+          cpanm -v --installdeps --notest .
+
+      - name: Build
+        run: |
+          cd po4a
+          perl Build.PL
+          COLUMNS=120 ./Build verbose=1
+
+      - name: Install po4a
+        run: |
+          cd po4a
+          sudo ./Build install
+          cd ..
+          rm -rf po4a
+
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.head }}
+          fetch-depth: 0  # OR "2" -> To retrieve the preceding commit.
+
+      - name: Get changed files
+        id: changed-files
+        uses: tj-actions/changed-files@v44
+      # NOTE: `since_last_remote_commit: true` is implied by default and falls back to the previous local commit.
+      - name: Run step if po/pot files are changed
+        env:
+          ALL_CHANGED_FILES: ${{ steps.changed-files.outputs.all_changed_files }}
+          RUN_ON_ALL: ${{ github.event.inputs.run_on_all }}
+        run: |
+          RUN_ON_ALL=${RUN_ON_ALL:="false"}
+          ALL_CHANGED_FILES_ARRAY=()
+          CHANGED_MD_FILES_ARRAY=()
+
+          # Check if RUN_ON_ALL is set to 'true'
+          if [ "$RUN_ON_ALL" == "true" ]; then
+              echo "list of all .md files in user-guides and moneropedia..."
+
+              # Add all user-guides and moneropedia .md files
+              for guide in _i18n/en/resources/user-guides/*.md; do
+                echo "-> Adding ${guide} to file list"
+                ALL_CHANGED_FILES_ARRAY+=("${guide}")
+              done
+
+              for entry in _i18n/en/resources/moneropedia/*.md; do
+                echo "-> Adding ${entry} to file list"
+                ALL_CHANGED_FILES_ARRAY+=("${entry}")
+              done
+          else
+            echo "Running po4a on modified po/pot files only..."
+
+            # Split ALL_CHANGED_FILES into an array
+            IFS=' ' read -r -a ALL_CHANGED_FILES_ARRAY <<< "$ALL_CHANGED_FILES"
+            for file in "${ALL_CHANGED_FILES_ARRAY[@]}"; do
+              if [[ "$file" == *.po || "$file" == *.pot ]]; then
+                directory=$(echo "$file" | sed -E 's|_i18n/[^/]+/resources/([^/]+)/.*|\1|')
+                base_filename=$(basename "$file" | sed -E 's/\.(po|pot)$//')
+                md_file="_i18n/en/resources/${directory}/${base_filename}.md"
+                if [ -f "$md_file" ]; then
+                  echo "-> Adding ${md_file} to file list"
+                  CHANGED_MD_FILES_ARRAY+=("${md_file}")
+                fi
+              else
+                CHANGED_MD_FILES_ARRAY+=("${file}")
+              fi
+              #remove duplicates
+              ALL_CHANGED_FILES_ARRAY=($(printf "%s\n" "${CHANGED_MD_FILES_ARRAY[@]}" | sort -u))
+
+            done
+          fi
+          for file in ${ALL_CHANGED_FILES_ARRAY}; do
+            echo "$file was changed"
+          done
+          git config --global user.name "weblate-po4a"
+          git config --global user.email "weblate-po4a@example.com"
+          ERROR=0
+          for md_file in "${ALL_CHANGED_FILES_ARRAY[@]}"; do
+            cd po
+            # Determine the base directory and base filename
+            directory=$(echo "$md_file" | sed -E 's|_i18n/[^/]+/resources/([^/]+)/.*|\1|')
+            base_filename=$(basename "$md_file" | sed -E 's/\.md$//')
+
+            # Construct the po4a configuration dynamically
+            lang=$(echo "$md_file" | sed -E 's|_i18n/([^/]+)/resources/.*|\1|')
+            if [ "$RUN_ON_ALL" == "true" ] || [ "$lang" == "en" ]; then
+              po4a_config="[po4a_langs] es it pl fr ar ru de nl pt-br tr zh-cn zh-tw nb-no\n"
+            else
+              po4a_config="[po4a_langs] ${lang}\n"
+            fi
+            po4a_config+="[po4a_paths] ../_i18n/en/resources/${directory}/weblate/${base_filename}.pot \$lang:../_i18n/\$lang/resources/${directory}/weblate/${base_filename}.po\n"
+            po4a_config+="[options] opt:\"--keep=0\"\n"
+            po4a_config+="[options] opt:\"--localized-charset=UTF-8\"\n"
+            po4a_config+="[options] opt:\"--master-charset=UTF-8\"\n"
+            po4a_config+="[options] opt:\"--master-language=en_US\"\n"
+            po4a_config+="[options] opt:\"--msgmerge-opt='--no-wrap'\"\n"
+            po4a_config+="[options] opt:\"--wrap-po=newlines\"\n"
+            po4a_config+="[po4a_alias:markdown] text opt:\"--option markdown\"\n"
+            po4a_config+="[type: markdown] ../_i18n/en/resources/${directory}/${base_filename}.md \$lang:../_i18n/\$lang/resources/${directory}/${base_filename}.md\n"
+
+            echo -e "${po4a_config}" > po4a-config.txt
+            cat po4a-config.txt
+
+            if po4a po4a-config.txt; then
+              echo "po4a ran successfully on ${md_file}"
+            else
+              echo "::warning file=${md_file}::po4a didn't run successfully"
+              ERROR=1
+            fi
+            rm po4a-config.txt
+            cd ..
+            git add .
+            COMMIT_MESSAGE="po4a: ${directory}/${base_filename} updates"
+            git commit -m "${COMMIT_MESSAGE}" || echo "No changes to commit for ${directory}/${base_filename}"
+          done
+
+      #- name: Check if PR exists
+      #  id: check
+      #  env:
+      #    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      #  run: |
+      #    prs=$(gh pr list \
+      #        --repo "$GITHUB_REPOSITORY" \
+      #        --head 'po4a-staged' \
+      #        --base 'master' \
+      #        --json title \
+      #       --jq 'length')
+      #    if ((prs > 0)); then
+      #        echo "skip=true" >> "$GITHUB_OUTPUT"
+      #    fi
+
+      - name: push to po4a-staged
+        #if: 'steps.check.outputs.skip'
+        uses: ad-m/github-push-action@master
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          branch: po4a-staged
+          #force: true
+
+      #- name: Create pull request
+      #  if: '!steps.check.outputs.skip'
+      #  uses: peter-evans/create-pull-request@v6
+      #  with:
+      #    token: ${{ secrets.GITHUB_TOKEN }}
+      #    branch: po4a-staged
+      #  continue-on-error: true

_i18n/ar/resources/moneropedia/address.md

@@ -9,8 +9,8 @@ terms: ["address", "addresses"]
 
 When you send Monero to someone you only need one piece of information, and
 that is their Monero address. A *raw* Monero address is a set of 95
-characters starting with a '4'. The Monero donation address, for instance,
-is
+characters starting with a '4' or an '8'. The Monero donation address, for
+instance, is
 888tNkZrPN6JsEgekjMnABU4TBzc2Dt29EPAvkRxbANsAnjyPbb3iQ1YBRk1UXcdRsiKc9dhwMVgN5S9cQUiyoogDavup3H.
 
 Because those addresses are long and complex, you will often encounter an

_i18n/ar/resources/moneropedia/clearnet.md

@@ -16,7 +16,7 @@ that *all* of your connections can be tracked, traced, and monitored by:
 - the website/service/person you're communicating with
 
 - possibly a [Five Eyes](https://en.wikipedia.org/wiki/5_Eyes) capable
-entity
+  entity
 
 and even if you use [HTTPS](https://en.wikipedia.org/wiki/HTTPS) or similar
 (which *encrypts* your transmission), your route is not hidden nor is it

_i18n/ar/resources/moneropedia/locally-unique-host.md

@@ -26,8 +26,8 @@ you wish.
 ### Notes
 
 - Monero primarily uses @canonically-unique-host resolution while I2P only
-uses @locally-unique-host resolution.
+  uses @locally-unique-host resolution.
 
 - I2P's and @Kovri's assigned top-level domain is currently `.i2p` and
-@Kovri intends to only process/use the `.i2p` [top-level
-domain](https://en.wikipedia.org/wiki/Top_level_domain)
+  @Kovri intends to only process/use the `.i2p` [top-level
+  domain](https://en.wikipedia.org/wiki/Top_level_domain)

_i18n/ar/resources/moneropedia/p2pool.md

@@ -9,10 +9,10 @@ terms: ["P2Pool", "monero-p2pool"]
 ### The Basics
 
 Monero P2Pool is a peer-to-peer Monero @mining pool developed by SChernykh
-(also known as sech1). P2Pool was a concept first developed for the
-Bitcoin blockchain but was never fully realized due to certain limitations,
-mainly because it had a problem with orphaned @blocks which is solved in
-Monero P2Pool with uncle blocks.
+(also known as sech1). P2Pool was a concept first developed for the Bitcoin
+blockchain but was never fully realized due to certain limitations, mainly
+because it had a problem with orphaned @blocks which is solved in Monero
+P2Pool with uncle blocks.
 
 Unlike a traditional mining pool, P2Pool allows it's users to fully control
 their own @node and what it mines. P2Pool has no central server that can be

_i18n/ar/resources/moneropedia/pruning.md

@@ -16,15 +16,15 @@ node.
 There are three ways to prune:
 
 - *Synchronize a pruned node from scratch:* You will download and sync only
-1/3 of the full blockchain.
+  1/3 of the full blockchain.
 
 - *Prune an existing node:* The already existing blockchain will be pruned,
-but this will not result in a smaller blockchain. Instead, it will mark
-parts of the file as free, so that future data will use that free space,
-causing the file to not grow until free space grows scarce.
+  but this will not result in a smaller blockchain. Instead, it will mark
+  parts of the file as free, so that future data will use that free space,
+  causing the file to not grow until free space grows scarce.
 
 - *Create a new pruned blockchain from a full one:* A full blockchain that
-you already have will be used to create a new, pruned blockchain.
+  you already have will be used to create a new, pruned blockchain.
 
 Pruned nodes are very useful and preferable to @remote-nodes, but if
 possible, users should run a full node and opt for pruning only in case if

_i18n/ar/resources/moneropedia/remote-node.md

@@ -37,21 +37,22 @@ port, or use a public one.
 Public nodes are reachable in the network using two systems:
 
 - **Node aggregators**, which are basically lists of open remote nodes. The
-operators of those nodes decided to add them to the aggregator so that other
-people can use them. The aggregator will provide to the person who want to
-use a remote node a simple URL. This URL connects to one of the nodes in the
-list and will need to be inserted in the Monero wallet (GUI or CLI). The
-wallet will then contact one of the nodes provided by the URL and will allow
-the end user to immediately receive and send transactions. One of the most
-famous node aggregators is [MoneroWorld](https://moneroworld.com/#nodes).
+  operators of those nodes decided to add them to the aggregator so that
+  other people can use them. The aggregator will provide to the person who
+  want to use a remote node a simple URL. This URL connects to one of the
+  nodes in the list and will need to be inserted in the Monero wallet (GUI
+  or CLI). The wallet will then contact one of the nodes provided by the URL
+  and will allow the end user to immediately receive and send
+  transactions. One of the most famous node aggregators is
+  [MoneroWorld](https://moneroworld.com/#nodes).
 
 - **Native public nodes**. This is one of the new coolest features the
-Monero devs came up with to improve the user experience and to make easier
-to connect to the network. The @daemon allows to make a node public by
-simply adding the flag `--public-node`. Doing so, it will be advertised on
-the P2P network and people will be able to connect to it (or to another
-public node advertising itself in the same way) using the related option in
-the GUI and CLI wallets.
+  Monero devs came up with to improve the user experience and to make easier
+  to connect to the network. The @daemon allows to make a node public by
+  simply adding the flag `--public-node`. Doing so, it will be advertised on
+  the P2P network and people will be able to connect to it (or to another
+  public node advertising itself in the same way) using the related option
+  in the GUI and CLI wallets.
 
 Be aware that using public remote nodes can be risky. Node operators can
 link transactions to IP addresses. These risks can be mitigated, but you

_i18n/ar/resources/moneropedia/wallet.md

@@ -23,10 +23,10 @@ overwritten.  As soon as a cold wallet is connected to the Internet or its
 mnemonic phrase or @spend-key is entered on an Internet-connected device,
 it's no longer "cold" and should be considered "hot".
 
-A Monero @paper-wallet can be generated by downloading the source code of
-https://moneroaddress.org/.  Verify the signature of the code on a trusted
-airgapped device.  Create the wallet and print or store it on the media of
-your choice.
+A Monero @paper-wallet can be generated by downloading the [wallet-generator
+page on Getmonero]({{ site.baseurl }}/generator). Verify the signature of
+the code on a trusted airgapped device.  Create the wallet and print or
+store it on the media of your choice.
 
 Monero accounts and paper-wallets can be stored on any media - paper, USB
 drive, CD/DVD, or a hardware wallet device (Ledger available since June

_i18n/ar/resources/moneropedia/weblate/account.po

@@ -7,7 +7,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
-"POT-Creation-Date: 2021-08-27 12:18+0200\n"
+"POT-Creation-Date: 2024-06-23 08:34+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -16,13 +16,13 @@ msgstr ""
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 
-#. type: YAML Front Matter: summary
+#. type: Yaml Front Matter Hash Value: summary
 #: ../_i18n/en/resources/moneropedia/account.md:1
 #, no-wrap
 msgid "similar in function to a bank account, contains all of your sent and received transactions"
 msgstr ""
 
-#. type: YAML Front Matter: terms
+#. type: Yaml Front Matter Hash Value: terms
 #: ../_i18n/en/resources/moneropedia/account.md:1
 #, no-wrap
 msgid "[\"account\", \"accounts\", \"wallet\", \"wallets\"]"

_i18n/ar/resources/moneropedia/weblate/address.po

@@ -7,7 +7,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
-"POT-Creation-Date: 2021-08-30 11:19+0200\n"
+"POT-Creation-Date: 2024-06-23 08:34+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -16,13 +16,13 @@ msgstr ""
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 
-#. type: YAML Front Matter: summary
+#. type: Yaml Front Matter Hash Value: summary
 #: ../_i18n/en/resources/moneropedia/address.md:1
 #, no-wrap
 msgid "either an alias, such as donate.getmonero.org, or a set of 95 characters starting with a 4"
 msgstr ""
 
-#. type: YAML Front Matter: terms
+#. type: Yaml Front Matter Hash Value: terms
 #: ../_i18n/en/resources/moneropedia/address.md:1
 #, no-wrap
 msgid "[\"address\", \"addresses\"]"
@@ -41,7 +41,7 @@ msgstr ""
 
 #. type: Plain text
 #: ../_i18n/en/resources/moneropedia/address.md:11
-msgid "When you send Monero to someone you only need one piece of information, and that is their Monero address. A *raw* Monero address is a set of 95 characters starting with a '4'. The Monero donation address, for instance, is 888tNkZrPN6JsEgekjMnABU4TBzc2Dt29EPAvkRxbANsAnjyPbb3iQ1YBRk1UXcdRsiKc9dhwMVgN5S9cQUiyoogDavup3H."
+msgid "When you send Monero to someone you only need one piece of information, and that is their Monero address. A *raw* Monero address is a set of 95 characters starting with a '4' or an '8'. The Monero donation address, for instance, is 888tNkZrPN6JsEgekjMnABU4TBzc2Dt29EPAvkRxbANsAnjyPbb3iQ1YBRk1UXcdRsiKc9dhwMVgN5S9cQUiyoogDavup3H."
 msgstr ""
 
 #. type: Plain text

_i18n/ar/resources/moneropedia/weblate/airgap.po

@@ -7,7 +7,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
-"POT-Creation-Date: 2021-08-30 12:38+0200\n"
+"POT-Creation-Date: 2024-06-23 08:34+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -16,13 +16,13 @@ msgstr ""
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 
-#. type: YAML Front Matter: summary
+#. type: Yaml Front Matter Hash Value: summary
 #: ../_i18n/en/resources/moneropedia/airgap.md:1
 #, no-wrap
 msgid "An airgap is a security measure to physically separate a computer or device from all other networks, such as the Internet."
 msgstr ""
 
-#. type: YAML Front Matter: terms
+#. type: Yaml Front Matter Hash Value: terms
 #: ../_i18n/en/resources/moneropedia/airgap.md:1
 #, no-wrap
 msgid "[\"airgap\"]"