Documentation (website) not generated anymore

[CyrilleB79]

I have recently updated the documentation for NVDA Dev & Test Toolbox add-on:
/website/addons/nvdaDevTestToolbox.mdwn

But the corresponding po files are not updated anymore, e.g.:
/website/addons/nvdaDevTestToolbox.ne.po

We can see that:

• Revision 84864: /website/addons/nvdaDevTestToolbox.mdwn updated
• Revision 84865: all po files /website/addons/nvdaDevTestToolbox.*.po updated according to the modifications done in revision 84864
• Revision 84868: /website/addons/nvdaDevTestToolbox.mdwn updated
• Revision 84872: /website/addons/nvdaDevTestToolbox.mdwn updated

The files /website/addons/nvdaDevTestToolbox.*.po have not been updated after revision 84868 and 84872, whereas they should have been.

[CyrilleB79]

@nvdaes have you access to information on the server?

Else, NV Access (@michaelDCurran or @seanbudd) should have a look, but the add-on translation framework maintenance is becoming an issue...

By the way, thanks @nvdaes for your investigation on an alternative framework.

[nvdaes]

I don't know how to see info about the NV Access server. I try to be cautious about commands to avoid breaking something.
BTW, the french team has access to my nvda addons project in Crowdin.
If someone wants to help me to manage the project, maybe great too in case it has to be used.

[nvdaes]

If the documentation is not generated, I think we should recommend Crowdin. For reference, my project can be found at

https://crowdin.com/project/nvdaaddons

We use a crowding.yml file in the root of each repo, and a GitHub Actions workflow which creates a subfolder named like the repo, creates a pot file considered the source, and in Crowdin, at this moment, the project contains 25 languages. Translations are addonName/locale/twoLettersCode, for now.
Regarding documentation, a .pot file is generated from the readme.md file, and then translations are considered files stored in addonName/doc/languageWithTwoCharacters/readme.po.
When po files for documentation are downloaded, GitHub Actions convert them to markdown and the artifact with markdown files is uploaded, to be downloaded and user in a second job, so that markdown files can be replaced.
The main problem is how to import existing documentation to crowdin.
This is the state of the alternative project that I suggest in case documentation cannot be generated from the website.

[nvdaes]

Also, seems that now the English documentation is not updated. I've submitted to SVN repo for testing (duplicate) changes for emoticons add-on.
According to the log:
(84934; Actions: Action column; Author: norrumar; Date: lunes, 28 de abril de 2025 8:49:24; Message: Update emoticons add-on documentation

And I don't see updated documentation in

https://addons.nvda-project.org/addons/emoticons.en.html

As a person in charge of registering new add-ons, I'll contact privately NV Access to explain this situation and talking about the experimental Crowdin project.

[nvdaes]

@CyrilleB79 , please, can you look at the website now?
Seems that Mick has fixed the issue.
BTW, I'll keep experimenting with Crowdin in case some day we should use it, but for now we can use SVN.

[CyrilleB79]

Yes, seems to be fixed. Thanks.

@michaelDCurran, for reference, what was the issue?

[michaelDCurran]

Looks like somehow nvdaDevToolbox.ru.po contained some corrupt or incorrect strings. And the svn checkout of the website for Ikiwiki was strangely frozen in time. I really can't explain what was going on or what state things were in. However, I re checked out that repo for Ikiwiki and it seems to be fine again. Unfortunately Ikiwiki's post-commit script that merges those po files does not give useful errors. Even if we keep add-on translation work on this server, we are at very least are starting to work on a new add-on website front-end that no longer uses Ikiwiki, and instead is integrated into addonStore.nvaccess.org directly. But we'll say more when that project is further along.

[CyrilleB79]

OK. Many thanks for this additional information.

So I can close the issue.