Differences

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

--- en:rpd:ai_wiki [2026/04/02 21:42] – AI Wiki: Document supported languages Mikhael
+++ en:rpd:ai_wiki [2026/06/05 15:47] (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
+**Supported Languages:**
+  * The wiki supports all 17 languages available in the game: English (en), Russian (ru), Spanish (es), French (fr), German (de), Portuguese (pt), Italian (it), Japanese (ja), Korean (ko), Chinese (cn), Traditional Chinese (zh), Polish (pl), Ukrainian (uk), Hungarian (hu), Turkish (tr), Greek (el), Indonesian (in), Malay (ms)
+==== 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