Re: [libreoffice-documentation] Updated LO Chapter Template for user guides

2022-06-19 Thread flywire
The changes look about right, with the exception of the comment line's
missing 's' as the eightieth character, but the template styles need more
work.

1a) Code End paragraph style is not required and should be removed
(approved
https://listarchives.libreoffice.org/global/documentation/2022/msg00391.html)
because
extra line spacing below paragraphs now occurs when paragraphs change.

1b) The code explanation would be better placed after the code to
demonstrate the extra space which isn't obvious before a heading.

2. Code syntax character styles should be added to the template and linked
to the code style. If the styles exist in the document the macro will use
them rather than creating new styles not linked to the code style. The
example code had 5 character styles which have been replaced with user
formatting, bypassing the main template purpose of enforcing consistent
styles. We look forward to a better solution being developed (
https://listarchives.libreoffice.org/global/documentation/2022/msg00341.html
),

Following
https://wiki.documentfoundation.org/Documentation/DocumentationTeamInfo/ProducingLibreOfficeUserGuides#How_to_for_syntax_highlighting_code
adds OOoComputerCode to the document. Possibly (??) the only change needed
is deleting it and changing _OOoComputerBase character style to inherit
from Code. I've previously suggested the lo palette colors should be used.

3. These changes are probably best tested by someone that hasn't been
formatting code for the guides. To avoid all sorts of anomalies I have
hacked the extension and changed the styles, and I'm not confident I've
fully reset it to what others get after deleting the lodev version config.

-- 
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] Updated LO Chapter Template for user guides

2022-06-19 Thread Peter Schofield
Hello Flywire

I have changed to the template and the info about the Code paragraph style as 
follows. Also, I have used the code example that you sent me.

The following is an example of code. Please note that lines of code are 
generally a single line of text that normally do not line wrap. When samples of 
code are entered into a LibreOffice document, there maybe some line wrapping 
due to the constraints of line width caused by margins.

Regards
Peter Schofield
psaut...@gmail.com
Technical Writer, LO Documentation Team

> On 19 Jun 2022, at 02:34, flywire  wrote:
> 
> def open_greeting(args=None):
> # Code lines with a maximum length of 80 characters will not wrap over 
> line
> print("Hello World" + 1 * "!")


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