Skip to content

voothi/20260113230706-goldendict

Repository files navigation

GoldenDict Configuration

Version License: MIT

A repository for tracking and managing user-specific configurations, styles, and settings for GoldenDict. This setup ensures that your dictionary environment is portable and version-controlled.

Table of Contents


Description

This project maintains the GoldenDict application data directory under version control. It tracks the core configuration, custom styles, and provides a structured way to handle transient data like history and favorites through a curated .gitignore.

Return to Top

Features

  • Versioned Configuration: Track changes to config and other XML settings.
  • Custom Styles: Centralized management of .css files in the styles/ directory.
  • Smart Git Filtering: Automatically ignores transient files (history, favorites) and timestamped backups.
  • Portable Setup: Easily sync your GoldenDict environment across multiple machines.

Return to Top

Environment

This configuration is verified with GoldenDict-ng:

  • OS: Windows 11 (x86_64)
  • Version: 25.06.0.8a87a79 (2025-06-18)
  • Qt Version: 6.7.2

This version is included in release v1.0.0.

Installation

To install, take the release archive and unpack it into your Program Files directory (e.g., C:\Program Files\GoldenDict).

Known Issues

  • Transition Problem: There is a known issue with transitions. See goldendict-ng#2683 for details.

Return to Top

Project Structure

  • config: The main configuration file for GoldenDict.
  • styles/: Contains custom CSS files for tweaking the look and feel of dictionary entries.
  • index/: (Ignored) Directory for regeneratable search indexes.
  • a/: (Ignored) Directory containing timestamped automated backups.
  • crash/: (Ignored) Crash dump reports.

Return to Top

Git Integration

The project uses a specific .gitignore to keep the repository clean of user-specific or transient data:

# History & favorites (transient, user-specific)
.history/
# history
# favorites

# Backups
a/
*.bak
*.old
*.tmp
* [0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9]*

Note

History and favorites are currently commented out in .gitignore as per user preference, but remain listed for easy toggling.

Return to Top

Kardenwort Ecosystem

This project is part of the Kardenwort environment, designed to create a focused and efficient learning ecosystem.

Return to Top

Related Projects

Return to Top

License

MIT License. See LICENSE file for details.

Return to Top