[libreoffice-documentation] Python ideas

2021-01-26 Thread Peter Heijink

Hi all,

A revision of a tutorial on python and LibreOffice is present in

https://nextcloud.documentfoundation.org/apps/files/?dir=/LibreOffice%20Documentation/English/Contributor%20Resources=81380

The tutorial is intended for those who start exploring macro codes 
written in python. It covers the relation between LibreOffice and 
python, (embedded/PyUno), contains sample code for writer, calc, base, 
XML extraction, a debug printer. It explores supplied python macros, and 
along the way touches upon specific python basics. In the end the 
follower will have a first impression of the functionality that can be 
achieved with python, and a basic set of macro utilities to continue 
writing macros.


It is not a tutorial on how to write python code.

I believe it is an extension to existing documentation on this subject, 
a bundled set of information to go from ignorant to prepared to start.


Of course I am open to receive comments.

Peter Heijink


--
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] phishing mail?

2021-01-07 Thread Peter Heijink

Hi team,

about 1.09 hr ago i received a message  through 
documentation@global.libreoffice.org


the sender has a cyrillic name with email adres lach...@gmail.com

lachend is dutch for laughing.

then it says that a page needs correction

This page   needs a correction. ? A page at gmail.com?

Is this some phishing mail?


--
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] Re: python documentation, a step up

2021-01-05 Thread Peter Heijink

Hi Alain and Ilmari,

Op 31-12-2020 om 12:24 schreef LibreOfficiant:

Hi Peter,

As suggested by Ilmari, writing tutorials in the wiki looks like the
appropriate approach as Python newbies are your intended audience. I
understand you seek for guidance, here's my take on a potential "Macros and
Scripting" tutorials page for Basic, Beanshell, (C++, Java,) Javascript, and
more precisely for Python:

- Running Python example scripts
   - using LibO UI
   - checking for/ installing Python scripting framework (may be included in
installation pages) on  *nix platforms

- Using the Python interactive console
   - native Python examples
 - e.g ScriptforgePythonHelper.py
   - typing Python UNO example scripts
 - import uno vs. XSCRIPTCONTEXT
   - APSO benefits here...
   - EDI benefits here..


I found it difficult to transfer what I had in mind via the mailing 
list. Therefore I have put my ideas in a document: python_ideas.odt


It is available in 
https://nextcloud.documentfoundation.org/apps/files/?dir=/LibreOffice%20Documentation/English/Contributor%20Resources=81380


It is an attempt to cover the things you suggested above.

It is a document of about eight pages, do not know whether that is 
suited for a wiki.


So now there is a concrete proposal to react on, it also reflects the 
level of my skills.


Open for comments on the approach taken, and corrections on  the content.

For the moment I will leave the other thread (on wiki.documentation) as 
it is.


regards peter


--
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] Docs wiki

2021-01-01 Thread Peter Heijink

This is an addition to the remarks of Jean, here concerning Python.


Hi team,
I was poking around the Docs section of the wiki looking up info and
following links, and I discovered there’s still a lot of out-of-date info
on pages linked to up-to-date pages. No wonder newcomers often get
confused. I don’t know how much energy I have for tracking down and fixing
problems, and I know that others have been doing the same, but there is so
much of it.

Jean

1) from https://wiki.documentfoundation.org/Macros > programmers guide > 
useful functions>
you land on 
https://wiki.documentfoundation.org/Macros/Python_Guide/Useful_functions


it contains some code, also the msgbox function. This page does not have 
a link to the next landing


2) from https://wiki.documentfoundation.org/Macros > programmers guide > 
working with documents > you land on 
https://wiki.documentfoundation.org/Macros/Python_Guide/Documents


much more code snippets, in the middle with a remark referencing the 
previous page


3) https://wiki.documentfoundation.org/Macros/Python_Guide/Documents#Open
same contents as previous page, don't know how i landed there

4) In the menu bar of mentioned pages, there are entries for writer - 
calc and so on, clicking on these will bring you to

https://wiki.documentfoundation.org/Macros/writer
showing how to manipulate libreoffice objects in various languages side 
by side. Objects different from all the previous pages


5) an entry in the same menu bar is labelled as Basic/Python which 
brings you to

https://wiki.documentfoundation.org/Macros/Basic_Primitives
loads of basic code (interesting for 
https://gitlab.com/LibreOfficiant/scriptforge/-/tree/scriptforge-7-1/Help)?, 
no python (intention failed?). Anyhow, the menu title suggests otherwise


I have the feeling that information, for python, is scattered over the 
website. In general I should say a webpage starts with a wide focus, and 
upon navigating the focus is narrowed by descriptive links.
Of course you can navigate trough different ways to end on the same 
page. But now there are concurrent ways that never meet and lead to 
different pages with different content


? who does the webpage content and navigation, most of the mails here 
seem to  be dealing with the information in nextcloud.


peter heijink



--
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] python documentation, a step up

2020-12-30 Thread Peter Heijink

Alain, Thanks for the welcome and links you sent.

If there are better locations to share the load of information in this 
mail, I would like to receive directions. As newbie I did not discover them.


For a quick digestion read the more fundamental question thrown at the 
bottom.


In the Q+A site there is a question about an autoincremented number 
inserted in a document (receipt or order) as a barcode. I answered the 
question in python code. The poster will be left with a working answer 
that he can not implement. The post is viewed about once a day.

The moderate BASIC user, posting a question, it the user I have in mind.
My own background is that i am not educated as a programmer, but I can 
teach myself new things, if information is available at the right 
starting level.


https://wiki.documentfoundation.org/Macros/Python_Design_Guide   -- Alain
I know the page. The page is loaded with information, and follows cocurrent and 
alternative paths, I find it not an easy step by step guide for a newbie. How 
to enter debug mode with APSO is not clear to me, the screenshot is suddenly 
there.
 
Above pages confirm my impression that python users are in general educated programmers and know already the concepts and can work with it. The python rocket is ignited from the top of the himalaya. I would like to stay with the users in the valley and guide them a bit uphill and do the ignition there.
 
https://gitlab.com/LibreOfficiant/scriptforge/-/tree/scriptforge-7-1/Help  -- Alain

Is an interesting project, as I understand it, it will result in the 7.1 
version to a list of macros in the 'LibreOffice macros' section. These macros 
in basic and python.

That will certainly be useful. However, I fear it will be restricted to 
LibreOffice functions only. It raises the strategic question:

?? Is the document foundation only responsible for documentation to run 
LibreOffice, or should we also include additional functionality: be more 
outreaching. Make that available in a tutorial: reading XML invoices, sending 
invoices directly to a customer, the barcode example given in the top.

If there is a strict border then I leave a major part out of the idea I have in 
mind.


--
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] get access to nextcloud / olivier hallot

2020-12-27 Thread Peter Heijink

Hi reader, ?Olivier Hallot?

with reference to "After your login is confirmed, contact the 
Documentation leader through the mailing list to obtain access to the 
LibreOffice Documentation folder on TDF NextCloud."
i would like to get access to see what is going on. My SSO account name 
is peterH


Among others i would like to add to the wiki pages regarding python. 
/Lowering the threshold/ for BASIC users to make the step to python, in 
a simple manner, no IDE environment. Part of the idea is to create a 
downloadable python file with functions that will make python 
/attractive/ to implement. The file contains functions that show an 
extension of the functionality of LibreOffice, that can not be achieved 
with basic:

- insert an autoincremented number as barcode or QR code
- send a document as PDF attachment using the address book of Thunderbird
- store invoice data in a database, data extracted from a received 
invoice in XML format

- MRI objects (trivial but useful )
- use the dispatcher (identical)
- write debug output to a writer document
So it remains at the application level, and leave the user prepared for 
the next step, own macro writing, upgrading to IDE...


Of course if this interacts with projects/ideas in development i would 
like to share with that.



--
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] new member

2020-12-22 Thread Peter Heijink

Hi reader,

I'm a satisfied user of LO, since seven years now. Focus on base and 
programming macros, some of them written in python.


The question of this mail is:

 * can you assign me to the right team / tasks?

 * is the contribution driven by the needs of the documentation team,
   or can initiatives of the volunteer  be granted as well?

I noticed that (base) python programming is less abundant, in usage and 
documentation. I'm willing to contribute and add documentation on this 
subject.


Regarding skills, i am 64, retired and not educated as a programmer, 
though with a background in engineering and some programming languages.



Looking forward to what you believe can be a suitable area to work on.

kind regards peter heijink


--
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