Skip to content

Plugin obsidian rdf updates#8

Merged
DarrenZal merged 4 commits into
gaiav0.1.9from
plugin-obsidian-rdf-updates
May 24, 2025
Merged

Plugin obsidian rdf updates#8
DarrenZal merged 4 commits into
gaiav0.1.9from
plugin-obsidian-rdf-updates

Conversation

@DarrenZal
Copy link
Copy Markdown

Relates to

Risks

Low risk - This is an additive feature that doesn't break existing functionality. All existing plugin-obsidian actions remain unchanged, and
the new RDF functionality is optional and self-contained.

Background

What does this PR do?

This PR adds comprehensive RDF/semantic knowledge graph functionality to the plugin-obsidian package, enabling users to:

  • Convert Markdown files with YAML frontmatter into RDF triples for semantic analysis
  • Automatically generate ontologies from vault structure in TTL format
  • Perform semantic search using SPARQL queries
  • Debug and inspect RDF graph structures
  • Enhanced search capabilities that can convert natural language to SPARQL

What kind of change is this?

Features (non-breaking change which adds functionality)

  • Adds new RDF data loading capabilities
  • Implements ontology generation from vault structure
  • Introduces SPARQL query support for semantic search
  • Provides RDF graph inspection and debugging tools

Documentation changes needed?

My changes require a change to the project documentation.
I have updated the documentation accordingly.

  • Updated /packages/plugin-obsidian/README.md with comprehensive documentation
  • Added new feature descriptions for RDF/semantic functionality
  • Included detailed workflow guides for RDF knowledge graph operations
  • Added code examples for new actions
  • Updated actions list with new RDF-related actions

Testing

Where should a reviewer start?

  1. Review the updated README.md to understand the new RDF functionality
  2. Examine the new action files in src/actions/:
    • loadRDF.ts - Core RDF data loading
    • generateOntology.ts - Ontology generation
    • viewRDFGraph.ts - Graph inspection
  3. Check the helper files in src/helper/:
    • RDFmanager.ts - RDF graph management
    • sparqlGenerator.ts - SPARQL query generation
    • generateOntologyTtl.ts - TTL ontology export

Detailed testing steps

Automated tests are acceptable.

To manually test the new functionality:

  1. Set up an Obsidian vault with markdown files containing YAML frontmatter
  2. Use the "Load RDF data from vault" action to convert files to RDF
  3. Use "Generate ontology from vault" to create TTL ontology files
  4. Use "View RDF graph structure" to inspect the loaded data
  5. Test enhanced search with semantic queries

Key Benefits

  • Semantic Search: Convert natural language queries to SPARQL for more precise results
  • Knowledge Graph: Build structured semantic representations of vault content
  • Ontology Generation: Automatically create reusable ontology definitions
  • Data Interoperability: Export semantic data in standard RDF/TTL formats
  • Enhanced Analytics: Query relationships and patterns in vault data

Files Changed

  • packages/plugin-obsidian/README.md - Comprehensive documentation update
  • packages/plugin-obsidian/src/index.ts - Added new actions to plugin
  • packages/plugin-obsidian/src/actions/ - New RDF-related actions
  • packages/plugin-obsidian/src/helper/ - New RDF management utilities

This enhancement significantly expands the plugin-obsidian capabilities while maintaining full backward compatibility.

DarrenZal and others added 4 commits April 11, 2025 03:23
- Add RDF data loading from markdown YAML frontmatter
- Implement ontology generation from vault structure
- Add SPARQL query capabilities for semantic search
- Include RDF graph inspection and debugging tools
- Update README.md with comprehensive RDF workflow documentation
- Add support for TTL format ontology export
- Enhance search with semantic capabilities

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

Co-Authored-By: Claude <noreply@anthropic.com>
@DarrenZal DarrenZal merged commit a39dffe into gaiav0.1.9 May 24, 2025
4 of 9 checks passed
@DarrenZal DarrenZal deleted the plugin-obsidian-rdf-updates branch May 24, 2025 01:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant