Usage of kateschema converter

Last weekend I went nuts and wrote a script to convert my old theme for Kate/KDevelop, I truly almost lost it.

The script as I made it only works with files exported by the GUI, when you export whole scheme and save it somewhere. I don’t think it will work with only data for one file type (it can be easily modified to do so). So, if you try to use your full kateschema/highlighting file which stores multiple themes at once the script can “export” a random mix (I wonder how usable that would be, maybe we can get some funny results).

The interface/command line options part of the script was done at the last moment when it was actually working (for me that is) and I was deadly tired. Before you start open the script in some text editor and look at the top for “settings” dictionary and its values, which I tried to briefly explain there. There are two configuration options available:

  1. prefferStandAloneData
  2. IncludeCustoms

prefferStandAloneData forces script to use settings stored for that data type. The reasoning for this option is simple, in old file format you could specify color/style settings for one data type differently based on current file type. In other words your CSS file content could be styled in different way when opened standalone in editor, different when viewed in HTML (inside <style></style>), different in PHP and so on. This is one of the reason for moving to theme files, but it is pain to convert. SO select what you wish or design a better solution. A sad thing is that you will not see the generated values as defaults, but I can live with that.

IncludeCustoms allows script to attempt (I am only aware of one tester which is me) to convert the style for all data types/syntax highlighting settings available. When set to False it will generate simple theme file without any custom things, it is nice base to start adapting your current theme which you spent years using.

And start the program:

script.py ThemeName mytheme.kateschema

The script requires 2 arguments.

  1. ThemeName - specify how you wish to name the theme, it is so far only used for metadata
  2. kateschema file - path to your exported kateschema file.

The results will be printed to stdout. I was too tired and this was the simplest way I could think of. You can always redirect the output to the file with your shell:

script.py ThemeName mytheme.kateschema > new.theme

And in the end, import the theme to Kate/KDevelop and enjoy.

For brave one here are my suggestions on improvements.

  • The theme name could be used to select right highlighting setting from global kateschema file, probably by just adding check if string ends with the name. The INI file section for highlighting are names as “Highlighting language - Schema MySchemaName” and such I think this.
  • Some user interface could be made to select theme to export from global file (in my thoughts this is done when you export it from Kate/KDevelop directly). It can be useful in the future
  • There re probably many checks which I did not do in the code. It is probably not possible to convert files for single data type/language.

In short:

  1. Export your theme
  2. Open script in text editor and adjust settings to your needs
  3. Run the script and save the output. (the result is printed to stdout)
  4. Import theme to Kate/KDevelop
  5. Use the script as an example and create even better one.

And I almost forgot, the script can be either found at my repository or in KDE Syntax Highlighting repository.

Articles from blogs I follow:

ARPA2CM released – some CMake modules

One of the more broadly-useful things to come out of KDE Frameworks efforts is, in my opinion, the KDE Extra CMake Modules (ECM). Since KDE software nearly-universally uses CMake as (meta-)build system, a lot of common functionality is distilled into the …

via [bobulate] January 20, 2022

Help Chile write free software values, privacy, and digital sovereignty into their constitution

For those out of the loop, a group which included myself up until recently,1 Chile is in the midst of a revolution. They’re fighting against the increased cost of living, privatization of essential services, and worsening inequality — problems facing everyon…

via Drew DeVault's blog January 19, 2022

About Logging

TL;DR: This post also talks about the problems I faced while working on my logging. To log to syslog from within my containers that do not support configuring a remote syslog server, I had syslog-ng expose a unix domain socket and mounte…

via PapaTutuWawa's Blog April 16, 2021

Generated by openring