maliang

repository·main·Indexed 22 days ago

https://github.com/xiaokang2022/maliang

A lightweight Python UI framework based on tkinter where all UI components are drawn directly on a Canvas. It supports optional dependencies for OS theme detection and Windows-specific styling, as well as official extensions for matplotlib (maliang-mpl), media files (maliang-media), 3D drawing (maliang-three), and table widgets (maliang-table). Requires Python >=3.10.

Tokens
15.3K
Snippets
56
Records
83
Agent score
78%

What's inside maliang

  1. Overview of maliang

    main
    maliang is a lightweight UI framework based on tkinter where all UI elements are drawn in a Canvas. This approach allows for custom drawing and potentially more flexible UI designs compared to standard tkinter widgets.
  2. Create an article summary using the `<!-- more -->` tag

    main

    To define an article summary (excerpt) for the blog homepage, insert the <!-- more --> HTML comment into your Markdown file. Everything written before this tag will be treated as the article's overview/summary on the main listing page. If you omit this tag, the system will attempt to generate a summary automatically.

    # Article Title
    
    This is the summary text that appears on the homepage.
    
    <!-- more -->
    
    This is the full content of the article that follows the summary.
  3. Install maliang with optional dependencies

    main

    For enhanced functionality, it is recommended to install the optional dependencies. These include darkdetect for OS theme detection, pillow for image processing, and various Windows-specific styling packages (pywinstyles, hPyT, win32material). You can install all optional packages at once using the [opt] extra.

    pip install maliang[opt]
  4. Install official maliang extensions

    main

    Official extensions are available to provide specific functionality. Current official extensions include:

    • maliang-mpl: Support for matplotlib.
    • maliang-media: Support for media files.
    • maliang-three: Support for simple 3D plotting.
    • maliang-table: Support for table controls.

    To install all official extensions at once, use the [ext] extra.

    pip install maliang[ext]
  5. How to sponsor maliang

    main

    You can support the maliang project financially or through non-monetary means.

    Financial Sponsorship

    The primary supported method is via WeChat Appreciation Code.

    Non-Monetary Support

    If you cannot provide financial support, you can still show your gratitude by starring the project on GitHub.

    Sponsorship Format

    When sponsoring, please include your information in the following format to ensure you are correctly credited in the sponsors list:

    maliang [your nickname or your GitHub Username]

    Note: For GitHub usernames, include the @ symbol (e.g., @username). You may also choose to remain anonymous.

  6. Install maliang official extensions

    main

    Maliang provides official extension packs for specific functionalities. You can install all available official extensions using the [ext] extra.

    Available official extensions include:

    • maliang-mpl: matplotlib support
    • maliang-media: media file support
    • maliang-three: simple 3D drawing support
    • maliang-table: table widget support
    pip install maliang[ext]
  7. How to contribute your project to the maliang gallery

    main

    If you have developed a project using maliang and want to include it in the official project gallery, ensure your project meets the following requirements:

    1. Dependency Declaration: Add maliang to your project's requirements.txt file and specify the version used. This allows the maintainer to identify your project's usage of the library.
    2. Visual Preview: Include a preview image in your project's own README file.

    Note: If you provide both light and dark theme preview images, the gallery will support switching between them using the website's theme toggle.