Skip to content

Conversation

@konard
Copy link
Member

@konard konard commented Sep 13, 2025

Summary

This PR updates all SVG images in the documentation to use gray colors instead of black, making them visible on both light and dark backgrounds. This addresses GitHub's dark mode support as requested in issue #17.

Changes Made

  • Updated 24 SVG files with black colors (#000, #000000) to use medium gray (#666666)
  • Created systematic approach using Python script to identify and replace black colors
  • Generated backups of all original files for reference
  • Tested changes to ensure proper color replacement and file integrity

Files Modified

Core Documentation SVGs

  • doc/links-edge-to-edge.svg
  • doc/links.svg, doc/links-en.svg, doc/links-ru.svg

Introduction Diagrams (13 files)

  • doc/Intro/1.svg through doc/Intro/12.svg

Mathematical Diagrams

  • doc/Math/Links_Set_Cartesian_Product.svg
  • doc/Math/Links_Set_Cartesian_Product_Selected.svg

Theory Comparison Diagrams

  • doc/TheoriesComparison/graph_theory.svg
  • doc/TheoriesComparison/links_theory.svg
  • doc/TheoriesComparison/links_theory_3_links.svg
  • doc/TheoriesComparison/theories_comparison.svg

Dependency Diagrams

  • doc/Dependencies/Platform.Data.Doublets.svg
  • doc/Dependencies/Platform.Data.Doublets.cpp.svg

Color Choice

Used #666666 (medium gray) as it provides optimal contrast on both light and dark backgrounds, following the suggestion to use "GitHub's half-dark mode" approach.

Testing

All updated SVG files have been verified to:

  • ✅ No longer contain black colors (#000, #000000)
  • ✅ Properly display the new gray color (#666666)
  • ✅ Maintain file structure and functionality

Note on Other Image Formats

The repository contains 73 PNG files and 46 JPG/JPEG files that also have black elements. These raster images would require manual editing with image editing software and are beyond the scope of this automated solution. The SVG updates provide immediate improvement for the most commonly used documentation diagrams.

Fixes #17

🤖 Generated with Claude Code

Adding CLAUDE.md with task information for AI processing.
This file will be removed when the task is complete.

Issue: #17
@konard konard self-assigned this Sep 13, 2025
…ompatibility

Replace black colors (#000, #000000) with medium gray (#666666) in 24 SVG files
to ensure visibility on both light and dark backgrounds. This addresses GitHub's
dark mode support as requested in issue #17.

Changes:
- Updated all SVG files containing black stroke/fill colors
- Used #666666 (medium gray) for optimal contrast on both themes
- Created backups of original files for reference

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
@konard konard changed the title [WIP] Update images to use gray color instead of black color (so it will be possible to see images with transparent background on both white and black background) Update SVG images to use gray instead of black for better dark mode compatibility Sep 13, 2025
@konard konard marked this pull request as ready for review September 13, 2025 15:16
🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>'
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

2 participants