oleeskild/obsidian-digital-garden
Obsidian Digital Garden
Acest proiect este un plugin Obsidian care funcționează ca un generator de site-uri statice, conceput pentru a transforma vault-urile locale de note markdown în site-uri web publice. Automatizează conversia fișierelor text structurate într-o bază de cunoștințe live, permițând utilizatorilor să partajeze cercetări personale și documentație direct din stocarea lor locală.
Platforma se distinge printr-o abordare „security-first” a gestionării conținutului, utilizând flag-uri bazate pe frontmatter pentru a se asigura că doar notele marcate explicit sunt publicate pe web. Acest mecanism de publicare selectivă previne expunerea accidentală a datelor private din vault, în timp ce un pipeline de deployment bazat pe git automatizează sincronizarea conținutului către furnizorii de hosting remote.
Sistemul suportă o gamă largă de capabilități de gestionare a site-ului, inclusiv generarea de instrumente de navigare interactive precum arbori de fișiere și descoperirea backlink-urilor. De asemenea, oferă opțiuni extinse pentru personalizarea vizuală prin layout-uri bazate pe template-uri și suprascrieri de stil, permițând integrarea conținutului media bogat, cum ar fi diagrame și ecuații matematice, în output-ul publicat.
Features
- Digital Garden Frameworks - Provides a framework for publishing networked personal knowledge bases as websites with interactive navigation and backlink discovery.
- Static Site Generators - Transforms local markdown files into a complete static website for public knowledge sharing.
- Publishing Extensions - Extends the local note-taking application to automate the publishing and deployment of markdown content to the web.
- Private Content Access Controls - Restricts public visibility of notes using explicit frontmatter flags to prevent accidental exposure.
- Knowledge Base Publishing - Enables users to share personal knowledge bases directly from their local storage to the web.
- Markdown Site Publishing - Transforms collections of local markdown files into structured, navigable web presences for public knowledge sharing.
- Frontmatter Management - Uses frontmatter metadata to programmatically determine which notes are included in the public build.
- Git-Push Deployments - Automates site deployment by triggering build pipelines upon pushing content to a version-controlled repository.
- Public Access Blocks - Ensures only explicitly marked notes are uploaded to the web, acting as a safety block against private data exposure.
- Template-Driven Generators - Uses predefined layout templates to inject markdown content into consistent site structures.
- Static Site Deployment Tools - Automates the deployment of generated static documentation sites to cloud hosting providers.
- Rich Content Rendering - Renders complex content like diagrams and mathematical equations within published notes.
- Client-Side Search Indices - Generates a searchable index of all published notes for client-side discovery without requiring a backend.
- Technical Content Sites - Supports the integration of custom templates and interactive components to extend site functionality for technical content.
- Site Navigation Generators - Automatically parses content to generate site navigation structures and link indexes for improved discoverability.
- Local File Syncing - Syncs local markdown directories to remote hosting providers to keep published content updated.
- Cloud or Self-Hosted Deployments - Automates the deployment of static content to various cloud hosting providers.
- Selective Publishing Workflows - Ensures only explicitly marked notes are published to the web, preventing accidental exposure of private vault data.
- Repository Access Controls - Limits deployment credentials to specific projects to prevent unauthorized access to sensitive vault data.
- CSS Variable Theming - Maps design tokens to native CSS variables to enable user-defined visual themes and style overrides.
- Site-Specific Layouts - Allows structural customization of the site layout to align with specific branding and design goals.
- Site-Wide Theme Controls - Provides site-wide theme controls and CSS overrides to customize the visual appearance of the published knowledge base.
