When translating the preferences in Pootle, the strings of every preference are prefixed with a string, keeping them unique and allowing for a more individual translation. In other words: you can use different translations for Use/don't use, activate/deactivate depending on context and the rest of the sentence. Now in the manual chapters for the system preferences, this does no longer work. There strings like Use/don't use and activate/deactivate are "collapsed" into one string. So you can only translate it once, which means you can't match the translations you picked for the Koha GUI. I am not sure how to solve this. Maybe we could think about formatting the preferences in the manual differently so the whole text descriptoin appears as one entry on Pootle?
For an example: Asks: ___ cash registers with the accounting system to track payments. Default: Don't use Values: Don't use Use So each of those lines get to be a separate string.
Hi Katrin. Just to make sure I've understand the problem. Previously you would get something like 'Don't use' and 'Use' as separate strings to translate. That way you could translate using the right word, depending on the rest of the sentence for the system preference. But now you are getting 'Don't use Use' as one string to translate. David
Actually it's the other way around: The problem is that they are separate strings. A lot of the system preferences use "use", "don't use", "activate", deactivate" as options in the pull downs. But when translating you don't always translate them the same way, especially for system preferences where you might need to move things around to make the sentence sound nice and work grammatically. But because I only get 1 tanslation for "don't use" per file I can't make it work and match what we have in the GUI. What I would much prefer is it being one string, something like: Asks: [Use|Don't use] cash registers with the accounting system to track payments. (Default: Don't use) But this is only one solution to the issue, which is why I wanted to discuss.
Maybe if you see it on pootle it explains a bit better (you might have to be logged in): https://translate.koha-community.org/de/21.11/translate/de-DE-pref.po#search=don't%20use&sfields=source,target&offset=10
current options 1) write the system preference descriptions as "[Use|Don't use] blah blah" (this works well with two options, but maybe not with more?) 2) somehow add context to the strings like we do in Koha (we need someone to develop this for us?) 3) somehow change how the strings are extracted so that each syspref is extracted individually like in Koha (we need someone to develop this for us?)
Created attachment 145555 [details] Generated HTML of circulation sysprefs chapter Hi all! I tried using method 1 ([Allow | Don't allow] blah blah) to see what could be the hurdles... See the attached HTML. I only changed the prefs in the "Holds policy" section. I put the default value in bold. I think it works really well for prefs with two options (Allow / Don't allow). I also like that it cuts a bit of the text since we don't have to have a Values and Default subsections. I don't think it will be possible to change them in batch since each is different (some have Allow as default, some have Don't allow as default, some have many choices or no choices). I had particular trouble with the ones with "nothing" as default and the ones with a multiselect rather than a drop down where you can only choose one (see decreaseLoanHighHolds et al. it has all the problems lol!) See also OPACHoldsIfAvailableAtPickupExceptions and StaticHoldsQueueWeight et al, which are special too. Let me know what you think!
The file is also here https://gitlab.com/carolinecyrlarose/koha-manual/-/blob/testsyspref/source/circulationpreferences.rst Ctrl + F and "Holds policy" to jump to the modified section
I realized the html I attached didn't have the CSS, so it was legible, but not pretty... Here are some screenshots of what I tried Simple allow/don't allow preferences, those work pretty well imo https://snipboard.io/jOqF7W.jpg Several sysprefs in the same block, with "nothing" as default, and a multiselect option https://snipboard.io/FytHOM.jpg Syspref with "empty" as default https://snipboard.io/1Hh6GM.jpg Syspref with number value (0 as default) https://snipboard.io/C3yEqe.jpg Another with several sysprefs in the same sentence, 0 as default value https://snipboard.io/2ZxHrt.jpg Let me know!
Any opinions on the first option? (see my last comment) Or should we wait for a developer to help us with either option 2 or 3?
If we aren't able to get some dev opinions on your options 2 and 3 in the next few months, Caroline, I'd say let's go for option 1! But I'm also hopeful we can ask some questions to friendly devs, at least to get an idea of what would be feasible :-)
Great work Caroline. The option 1 looks nice and tidy, and it's probably the easiest way to fix the issue from the documentation side. I'll be curious to hear more about option 2 and 3.
Docs team is not so keen on option 1 because it's not very readable. Option 2, to add context, we don't know how to add it in RST. Option 3, we'd have to explore how the strings are extracted for translations. In Koha, they delimit strings with <span>. I'll explore how to add span in RST. I'd need to know how to run the translation script locally to try stuff on my computer...
Adding Jonathan, maybe with his recent work on the manual/translations he knows about a possible solution.