Re: [Firebird-docs] Upload of German lang ref

[Mark R. <ma...@la...>]

On 22-11-2021 11:36, Mark Rotteveel wrote:
> On 22-11-2021 11:29, Mark Rotteveel wrote:
>> On 21-11-2021 19:21, Köditz, Martin wrote:
>>> Hi,
>>>
>>> I just finished the German translation of the FB 3.0 language reference.
>>>
>>> I cannot upload any files to the homepage. CKEdit says „file not 
>>> found“. Can someone help?
>>
>> What is CKEdit? And how do you use it to upload files? Have you been 
>> able to upload files in the past? I use WinSCP to upload files.
>>
>> I'll see if I can upload a build of the docs.
> 
> I noticed a number of broken references within the document because of a 
> missing `-de` suffix. If this CKEdit (which I guess is CKEditor) 
> validates the links between generated HTML files, that might cause the 
> error.
> 
> I also saw some syntax problems (or at least the highlighter in IntelliJ 
> breaks, which generally points to some syntax problem). I'll try to fix 
> those and upload.

I fixed the issues and uploaded it. However, I noticed that the file is 
called firebird-30-language-reference-de (.html/.pdf), while the 
previous one was called firebird-25-sprachreferenz. Changing this to 
firebird-30-sprachreferenz is more in line with the naming convention 
documented in the Docwriting Guide[1] (specifically in "Other file 
naming conventions").

Do you have any objections if I make this change, or did you have a 
specific reason for using firebird-30-language-reference-de?

  [1]: 
https://firebirdsql.org/file/documentation/html/en/firebirddocs/docwritehowto/firebird-docwriting-guide.html#docwritehowto-asciidoc-project-layout

Mark
-- 
Mark Rotteveel