maria-docs team mailing list archive

[Ian Gilfillan <ian@xxxxxxxxxxx>]

On 01/18/2015 01:08 AM, Jean Weisbuch wrote:
> I translated an article that is on this untranslated category 
> (https://mariadb.com/kb/fr/mariadb/what-is-mariadb/) but i havent been 
> able to use the usual ways to put links to other translated KB 
> articles ("mariadb-vs-mysql-compatibility", 
> "mariadb-vs-mysql-features" and 
> "source-getting-the-mariadb-source-code") where the usual links of the 
> form "fr/english-link" and "translated-link" doesnt works.
> I had to put the full URL (excluding "https://mariadb.com/kb/fr/";) 
> which are "mariadb/la-compatibilite-entre-mariadb-et-mysql", 
> "mariadb/mariadb-vs-mysql-features/" and 
> "mariadb/les-premiers-pas/obtenir-installer-et-actualiser-mariadb/comment-compiler-mariadb-a-partir-de-la-source/source-getting-the-mariadb-source-code/".
> Would it be possible to have by default links on translated articles 
> to point to translated articles (when available) when the "default" 
> URL (using the English KB page link without specifying the language) 
> is used on the code ; having to check and fix almost every links when 
> doing a translation is time consuming and could easily lead to mistakes.

I've checked the page, and updated the links to work as expected. The 
one that didn't work was "source-getting-the-mariadb-source-code" and 
this is because an identical slug was used in English and in French 
(perhaps you first created the page in French with the English text), so 
when faced with the ambiguity, the English link was used. I've updated 
the primary slug in French to use the French text, and replaced the link 
with this.

I agree that when there's two of the same slugs, the one chosen should 
be in the current language (or perhaps it should not be possible to 
duplicate slugs across languages). I thought it did work like this, so 
not sure if it's a regression, or perhaps has always worked this way. 
I'll suggest looking at this to Bryan.
> --
> Another small issue : The documentation about translating KB pages 
> (https://mariadb.com/kb/en/meta/translation-howto/) states that : "All 
> translated articles must be placed in a translated category. If the 
> translated parent does not exist, the article will be placed in the 
> grandparent or root category. Please take the time to translate the 
> parent category before translating any articles in that category.".
>
> But if i try to translate a category such as 
> https://mariadb.com/kb/en/mariadb/faq/ i got an error message : 
> "Sorry, you do not have permission to create an article here."
Agree, it doesn't make sense to have permission to create an article and 
not a category, I will suggest to Bryan that this is changed. In the 
meantime I've created the FAQ category at 
https://mariadb.com/kb/fr/mariadb/mariadb-faq-fr/

Bryan or Daniel will need to give you permission to create categories, 
in the meantime if you need any created, send them through to me (or 
ping me on IRC greenman_ for a quicker response)

ian