Tweaking the template can resolve almost all code colorization presentation
issues as explained below. (Process issues can be worked on separately.)

Key findings:
* Process is a bit of a black art
* LibreOffice_7.x_Template.ott has no Character Styles for colored computer
code
* Code Colorizer Formatter
https://extensions.libreoffice.org/en/extensions/show/71 is used but an
extension bug ignores the configuration dialog Font name, Text sizes and
Tab width
* Fortunately, the extension does not define styles defined in a document
* The Getting Started Guide 7.3 code looks good but Character Styles for
colored code seem to have been manually reformatted
* Adhoc processes will continue to occur in the absence of a standard
process as demonstrated in the Getting Started Guide 7.3 which essentially
duplicates character style trees with _LOCodeBase and OOoComputerCode

Suggested template workaround changes for existing extension:
* Use Paragraph Style Code Font Size of 10pt (extension mixes sizes and end
of line comment bug affects following line)
* Use Paragraph Style Code Spacing Do not add spacing to paragraphs of the
same style (reduces BG7309 page count by 15% and looks better)
* Use Character Style OOoComputerCode parent of Code (to carry style
through as intended)
* Character Style Code descendants must only configure color

Furthermore, define the following Character Styles in the Documentation
template instead of the extension:
OOoComputerCode
_OOoComputerBase
_OOoComputerComment      Grey
_OOoComputerBaseNoLocale
_OOoComputerSpecial
_OOoComputerLiteral      Red
_OOoComputerNumber       Red
_OOoComputerKeyWord      Blue
_OOoComputerAltKeyWord   Blue
_OOoComputerIdent        Green

The LibreOffice color palette should be used, for example, assuming no
color shades: (Grey), Orange Accent, Blue 1, Green 1. Other styles might be
needed for Bash, SQL, Java, and XML.

>
On Fri, Apr 1, 2022 at 9:23 AM Olivier Hallot <
> olivier.hal...@libreoffice.org> wrote:
>
>> Documentation Team Meeting Minutes March 31st 2022 at 18:00 UTC.
>> ... Code Colorizing:
>>      [3/31 - VN]: -
>> As the developer community uses Writer and Impress to communicate code
>> snippets with their peers, code highlighting or colorizing is a
>> beneficial feature.
>> Enhancing existing features in Writer (Styles -> Source Text) to include
>> colorizing and indentation can be the starting point. However, this
>> requires UI and Engineering team to take it forward.
>
>

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

Reply via email to