Re: [libreoffice-documentation] Placing Basic macro code on the wiki

2021-01-09 Thread Ilmari Lauhakangas
It looked fine, thanks for the work. I added {{#translation:}} suffixes 
to the macro page links, so they will always point to the pages in the 
relevant language.


Ilmari

On 9.1.2021 17.53, Steve Fanning wrote:
I have completed creating English versions of the wiki pages that 
include the Basic macros from Chapter 13 of the Calc Guide.


The index page for these files can be found at 
https://wiki.documentfoundation.org/Macros/Calc. I have added some 
translation markups to this index page . However, I've never done this 
before. Would it be possible for Ilmari (or somebody else with the 
appropriate knowledge) to have a look at this page and advise if any of 
these translation markups are inappropriate?


Thanks in advance.

Regards,

Steve



On 05/01/2021 16:35, Steve Fanning wrote:

Thanks Ilmari.

I expect there to be twelve of these pages. I plan to create all of 
the pages first and then add the translation markups afterwards.


I will confirm via the email list when I am finished. Maybe you or 
somebody else with suitable knowledge would give the pages a quick 
check at that point, just to make sure that I have not done anything 
wrong in terms of adding the translation markups.


The technical details of the pages shouldn't need much checking as 
they are mostly copied directly from the published 7.0 Calc Guide.


Regards,

Steve


On 05/01/2021 06:56, Ilmari Lauhakangas wrote:
The translation needs to be prepared by hand according to these 
instructions: 
https://wiki.documentfoundation.org/TDF_Wiki/Multilingual#Content_with_global_focus 



In this case it is a bit tedious as you ideally have to include many 
snippets in the translation (while excluding the content and markup 
that should remain untranslated). I guess the argument names in the 
description section could be included in the translation. You would 
also want to include every single comment in the example code block.


Ilmari

On 4.1.2021 22.33, Steve Fanning wrote:

Thanks Ilmari,

I have created one of the pages at 
https://wiki.documentfoundation.org/Macros/Calc/ba019. Do I need to 
do anything to prepare it for translation?


Regards,

Steve


On 04/01/2021 11:09, Ilmari Lauhakangas wrote:

On 4.1.2021 12.54, Steve Fanning wrote:

Hi Ilmari,

Could you give me some advice with regards to the wiki please?

I am in the process of updating Chapter 13 of the Calc Guide to 
change its emphasis away from macro programming. There are some 
useful LibreOffice Basic macro code snippets which are to be 
removed from the document, but I do not want to lose them 
completely. Therefore, I propose to add them to the wiki – the 
page at https://wiki.documentfoundation.org/Macros/Calc seems a 
good place to start.


Two questions arise:

1. Can I view a list of all the pages currently in the
    https://wiki.documentfoundation.org/Macros/Calc area?


https://wiki.documentfoundation.org/Special:PrefixIndex?prefix=Macros%2FCalc&namespace=0 




2. What would be the best material for me to read to understand the
    markup that should be included to format the code snippets 
nicely?


I think we found that lang set to vbnet is the best for syntax 
highlighting, so put your code inside a block like:





Ilmari









--
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
List archive: https://listarchives.libreoffice.org/global/documentation/
Privacy Policy: https://www.documentfoundation.org/privacy


Re: [libreoffice-documentation] Placing Basic macro code on the wiki

2021-01-09 Thread Steve Fanning
I have completed creating English versions of the wiki pages that 
include the Basic macros from Chapter 13 of the Calc Guide.


The index page for these files can be found at 
https://wiki.documentfoundation.org/Macros/Calc. I have added some 
translation markups to this index page . However, I've never done this 
before. Would it be possible for Ilmari (or somebody else with the 
appropriate knowledge) to have a look at this page and advise if any of 
these translation markups are inappropriate?


Thanks in advance.

Regards,

Steve



On 05/01/2021 16:35, Steve Fanning wrote:

Thanks Ilmari.

I expect there to be twelve of these pages. I plan to create all of 
the pages first and then add the translation markups afterwards.


I will confirm via the email list when I am finished. Maybe you or 
somebody else with suitable knowledge would give the pages a quick 
check at that point, just to make sure that I have not done anything 
wrong in terms of adding the translation markups.


The technical details of the pages shouldn't need much checking as 
they are mostly copied directly from the published 7.0 Calc Guide.


Regards,

Steve


On 05/01/2021 06:56, Ilmari Lauhakangas wrote:
The translation needs to be prepared by hand according to these 
instructions: 
https://wiki.documentfoundation.org/TDF_Wiki/Multilingual#Content_with_global_focus


In this case it is a bit tedious as you ideally have to include many 
snippets in the translation (while excluding the content and markup 
that should remain untranslated). I guess the argument names in the 
description section could be included in the translation. You would 
also want to include every single comment in the example code block.


Ilmari

On 4.1.2021 22.33, Steve Fanning wrote:

Thanks Ilmari,

I have created one of the pages at 
https://wiki.documentfoundation.org/Macros/Calc/ba019. Do I need to 
do anything to prepare it for translation?


Regards,

Steve


On 04/01/2021 11:09, Ilmari Lauhakangas wrote:

On 4.1.2021 12.54, Steve Fanning wrote:

Hi Ilmari,

Could you give me some advice with regards to the wiki please?

I am in the process of updating Chapter 13 of the Calc Guide to 
change its emphasis away from macro programming. There are some 
useful LibreOffice Basic macro code snippets which are to be 
removed from the document, but I do not want to lose them 
completely. Therefore, I propose to add them to the wiki – the 
page at https://wiki.documentfoundation.org/Macros/Calc seems a 
good place to start.


Two questions arise:

1. Can I view a list of all the pages currently in the
    https://wiki.documentfoundation.org/Macros/Calc area?


https://wiki.documentfoundation.org/Special:PrefixIndex?prefix=Macros%2FCalc&namespace=0 




2. What would be the best material for me to read to understand the
    markup that should be included to format the code snippets 
nicely?


I think we found that lang set to vbnet is the best for syntax 
highlighting, so put your code inside a block like:





Ilmari







--
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
List archive: https://listarchives.libreoffice.org/global/documentation/
Privacy Policy: https://www.documentfoundation.org/privacy


[libreoffice-documentation] Contributors Guide

2021-01-09 Thread Peter Schofield
2-ProducingLOGuides-PS-RL-PS-DB-PS-20210109 has been uploaded to the Work In 
Progress folder ready for review. 
There is still work to do when this clean version process has been finalised.

Regards
Peter Schofield
psaut...@gmail.com




-- 
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
List archive: https://listarchives.libreoffice.org/global/documentation/
Privacy Policy: https://www.documentfoundation.org/privacy