Differences

This shows you the differences between two versions of the page.

--- en:rpd:ai_wiki [2026/01/02 11:39] – Auto-fix: Apply dokuwiki linter fixes mike
+++ en:rpd:ai_wiki [2026/01/04 22:25] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
+====== AI Tools for Wiki Maintenance ======
+This page documents automated tools and suggestions for maintaining the Remixed Dungeon wiki, particularly for AI and automated systems to help with maintenance tasks.
+==== Automated Tools ====
+**Python-based Tools** (Located in ''tools/py-tools/'' directory):
+  * ''find_red_links.py'' - Identifies internal wiki links that point to non-existent pages (redlinks)
+  * ''scale_sprites_for_wiki.py'' - Processes game sprites for wiki use with proper scaling and borders
+  * ''check_broken_images.py'' - Verifies that all images referenced in wiki pages exist
+  * ''dokuwiki_linter.py'' - Validates DokuWiki syntax and identifies potential formatting issues
+==== AI-Targeted Documentation ====
+**Machine-Readable Data:**
+  * The ''mr:'' namespace contains machine-readable reference pages
+  * These pages contain raw data about entities extracted from source code
+  * Created for different entity types: mobs, items, spells, etc.
+**Entity Tracking:**
+  * AI systems should track entity relationships across the codebase
+  * Information sources: Java classes, Lua scripts, JSON configs, string resources
+  * Cross-reference ''getEntityKind()'' method results with file names
+==== Recommended Tools for AI Systems ====
+  * **Static Analysis**: Tools that scan code for entities and their properties
+  * **Wiki Link Validation**: Automated checking of internal links
+  * **Content Freshness**: Tools to identify pages that haven't been updated in a long time
+  * **Naming Consistency**: Validation that page names follow the convention ''{entity_name}_{type}'' (e.g., ''tengu_mob'', ''ankh_item'')
+==== Potential Tool Ideas ====
+The following tools would be beneficial for wiki maintenance:
+  * ''entity_extractor.py'' - Automatically extract entity data from Java/Lua/JSON files and suggest wiki page content
+  * ''page_updater.py'' - Compare existing wiki pages with current code and suggest updates
+  * ''translation_validator.py'' - Verify that pages in different languages contain consistent information
+  * ''link_suggester.py'' - Suggest relevant pages that should be linked together
+  * ''naming_consistency_checker.py'' - Check for pages that don't follow the proper naming convention and suggest renames
+  * ''content_verifier.py'' - Automatically verify game mechanics information against source code and flag outdated content
+  * ''redlink_resolver.py'' - Automatically create new pages for redlinks based on available code data
+  * ''multilingual_content_sync.py'' - Ensure consistency of content across different language versions of the same page
+==== Automation Guidelines ====
+When implementing AI-based wiki maintenance:
+  * Verify all information against the actual source code before updating
+  * Maintain consistency in naming conventions across all pages
+  * Preserve the existing formatting and structure when possible
+  * When creating new pages, follow the established template for that entity type
+  * Include references to the source code that confirms the information
+==== Detailed Tool Recommendations ====
+**Content Analysis Tools:**
+  * ''string_resource_analyzer.py'' - Analyze string resources across different languages to ensure consistency and completeness
+  * ''image_reference_checker.py'' - Verify that all referenced images exist and are properly named
+  * ''tag_validator.py'' - Ensure all pages have appropriate tags and that tags are consistent across similar entities
+**Quality Assurance Tools:**
+  * ''fact_checker.py'' - Cross-reference wiki content with codebase to detect inconsistencies
+  * ''duplicate_content_detector.py'' - Identify duplicated information across different pages
+  * ''content_gap_analyzer.py'' - Identify entities that exist in the game but don't have wiki pages
+**Localization Enhancement Tools:**
+  * ''auto_translation_suggester.py'' - Suggest translations based on string resources and existing localized pages
+  * ''completeness_tracker.py'' - Track which pages exist in which languages and identify missing translations
+==== Existing Code References ====
+  * For Java code: Reference the specific classes and methods that define entity behavior
+  * For Lua scripts: Include the specific files that implement custom mechanics
+  * For JSON configs: Reference the exact files and fields that contain the configuration data
+  * For string resources: Include links to the string definitions in various languages
+==== Additional Tool Suggestions ====
+**Automated Verification Tools:**
+  * ''spell_check_wiki.py'' - Perform spell-checking and grammar validation across all wiki pages
+  * ''link_health_checker.py'' - Verify that all external links are still valid and accessible
+  * ''image_size_optimizer.py'' - Optimize image sizes and formats for better wiki performance
+  * ''consistency_checker.py'' - Verify consistent formatting and DokuWiki syntax across pages
+**AI Enhancement Tools:**
+  * ''auto_content_updater.py'' - Automatically update wiki pages when corresponding code changes are detected
+  * ''summary_generator.py'' - Create automatic summaries of changes made to wiki pages
+  * ''entity_relationship_mapper.py'' - Create visual maps of relationships between different game entities
+  * ''template_generator.py'' - Automatically create template pages for new entity types based on existing patterns
+**Workflow Improvement Tools:**
+  * ''multi_language_sync.py'' - Synchronize updates across language versions of wiki pages
+  * ''merge_conflict_resolver.py'' - Automatically handle merge conflicts in wiki content
+  * ''version_diff_analyzer.py'' - Highlight differences when wiki pages are updated
+  * ''validation_report_generator.py'' - Create reports of all verification checks and their status
+**Content Enhancement Tools:**
+  * ''stat_extractor.py'' - Extract statistics from game code and automatically format them for wiki pages
+  * ''code_comment_linker.py'' - Link wiki explanations to relevant comments in source code
+  * ''example_generator.py'' - Create game scenario examples based on code mechanics
+  * ''cross_reference_builder.py'' - Build automatic cross-references between related wiki pages