command-line-interface-pages / v2-tooling

Tools for handling v2.*.* syntax
6 stars 3 forks source link

Color theme support #22

Closed EmilyGraceSeville7cf closed 1 year ago

EmilyGraceSeville7cf commented 1 year ago

closes #15

60 color settings available (use bash ./clip-view.sh -h | grep '\$' | wc -l to check):

image

Notes

-cc|--clear-cache flag is replaced with -cpc|--clear-page-cache.

EmilyGraceSeville7cf commented 1 year ago

image

@blueglyph, here is how to use color themes. :) default theme is located here. After first usage any color theme is cached and reused until it's requested explicitly to refresh it. The same applies for all CLIP pages. yq is used for parsing yaml files.

How to get intellisence? Install this Red Hat VS Code extension or anything like that if another editor is used. Then change VS Code settings like this:

{
    "yaml.schemas": {
        "path/to/theme.json": "path/to/file_where_to_enable_intellisence.yaml"
    }
}

The first file was put here. Download it locally and write path to it. Personally I don't like such manual intellisence setup and I guess we can provide some default color schema (rename it to make it's name more unique, for instance to clip-view-default-color-theme.yaml) and mention it in SchemaStore to automatically be used when default theme config is opened.

@hyperupcall, wdyt about including my JSON schema for this project in SchemaStore repo like a link to this .json?

hyperupcall commented 1 year ago

@EmilySeville7cfg SchemaStore has a requirement that schemas must have some minimal level of popularity - I don't think personal schemas as these meet that requirement?

EmilyGraceSeville7cf commented 1 year ago

@EmilySeville7cfg SchemaStore has a requirement that schemas must have some minimal level of popularity - I don't think personal schemas as these meet that requirement?

In other words, how many project stars should I have in your opinion?

hyperupcall commented 1 year ago

@EmilySeville7cfg My personal limit when adding schemas for other repositories is a thousand stars - there is always a risk of the project not working out and needing to remove the stale schema. If somebody else chooses to write the schema, then I guess the bar doesn't have to be as high - say a few hundred or so stars, but the point is that there are a more than a few dozen people benefiting from the schema and that each schema is from some community where people would at least recognize the project.