{"id":25878464,"url":"https://github.com/seigr-lab/seigrkodeks","last_synced_at":"2026-06-28T18:31:01.863Z","repository":{"id":279656509,"uuid":"939504873","full_name":"Seigr-lab/SeigrKodeks","owner":"Seigr-lab","description":"📝 SeigrKodeks – A standalone Markdown book creator with media embedding, automatic format conversion, and export to static HTML.","archived":false,"fork":false,"pushed_at":"2025-02-27T15:43:15.000Z","size":80,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-05T20:52:33.111Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Seigr-lab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-02-26T16:41:13.000Z","updated_at":"2025-02-27T15:43:19.000Z","dependencies_parsed_at":"2025-06-01T12:41:37.927Z","dependency_job_id":"81e6bcef-67bc-4156-ba2b-d13763e948e7","html_url":"https://github.com/Seigr-lab/SeigrKodeks","commit_stats":null,"previous_names":["seigr-lab/seigrkodeks"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Seigr-lab/SeigrKodeks","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Seigr-lab%2FSeigrKodeks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Seigr-lab%2FSeigrKodeks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Seigr-lab%2FSeigrKodeks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Seigr-lab%2FSeigrKodeks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Seigr-lab","download_url":"https://codeload.github.com/Seigr-lab/SeigrKodeks/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Seigr-lab%2FSeigrKodeks/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271751917,"owners_count":24814705,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-23T02:00:09.327Z","response_time":69,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-03-02T12:31:18.400Z","updated_at":"2025-08-23T14:12:10.568Z","avatar_url":"https://github.com/Seigr-lab.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# **SeigrKodeks - Structured Documentation for the Binary World**  \n\n## 🛠️ Overview  \n\n**SeigrKodeks** is a **desktop application** developed within **Seigr-lab** for **creating structured books and technical documentation** in **Markdown**. Designed for **binary-driven ecosystems**, it provides **a fully offline, structured, and media-integrated framework** to write, manage, and export books.  \n\nWith **SeigrKodeks**, you can:  \n- 📖 **Create books with structured chapters** stored as Markdown.  \n- ✍ **Write in Markdown or MediaWiki**, with seamless format conversion.  \n- 🎨 **Embed images, videos, and audio**, keeping structured media organization.  \n- 🌍 **Export books as static HTML sites**, preserving **interlinked chapters**.  \n- 🖥️ **Run entirely offline**, ensuring **full control over documentation**.  \n\n### **SeigrKodeks is built for:**  \n✅ **Technical documentation in binary-driven environments.**  \n✅ **Structured book-writing without cloud dependencies.**  \n✅ **Offline, standalone documentation for specialized projects.**  \n✅ **Future-proof Markdown-based documentation.**  \n\n---\n\n## 🎯 **Why SeigrKodeks?**  \n\nMost documentation tools:  \n- **Are web-based**, requiring an internet connection (e.g., MkDocs, GitBook).  \n- **Lack structured media embedding**, making multimedia-heavy books difficult.  \n- **Restrict users to specific formats**, preventing seamless **Markdown ↔ MediaWiki interoperability**.  \n\nSeigrKodeks **solves these issues** by providing:  \n1️⃣ **A standalone, offline-first approach** – No browser, no web dependencies.  \n2️⃣ **Flexible content management** – Supports **Markdown and MediaWiki**.  \n3️⃣ **Comprehensive media handling** – Images, videos, and audio **integrated into Markdown**.  \n4️⃣ **One-click export to structured static HTML** – Books remain readable **forever**, no compatibility issues.  \n\n---\n\n## 🔄 **How It Works**  \n\n### **📘 1. Create \u0026 Manage Books**  \n- Define a **book title** and **store it anywhere** on your system.  \n- Chapters are **individual Markdown files**, keeping content structured and portable.  \n- Easily **organize, rename, and edit** chapters.  \n\n### **🖼 2. Embed \u0026 Manage Media**  \nSeigrKodeks supports seamless **multimedia integration**:  \n- **Images**: `![Alt Text](media/image.jpg)`  \n- **Videos**: `\u003cvideo src=\"media/video.mp4\" controls\u003e`  \n- **Audio**: `\u003caudio src=\"media/audio.mp3\" controls\u003e`  \n- Media files are **automatically stored in structured directories** (`media/`).  \n\n### **🌍 3. Export as Static HTML**  \n- Generates **a fully interactive website** from your book.  \n- The HTML output includes:  \n  ✅ **A Table of Contents**.  \n  ✅ **Interlinked chapters** with navigation.  \n  ✅ **Embedded images, videos, and audio**.  \n- 📂 **Perfect for hosting or local reading**.  \n\n---\n\n## 📦 **Project Structure**  \n\n```\nSeigrKodeks/\n│── seigr_kodeks/                 # Core Framework\n│   ├── parsers/                   # Format detection \u0026 conversion\n│   │   ├── format_detector.py      # Detects if content is Markdown or MediaWiki\n│   │   ├── mediawiki_to_md.py      # Converts MediaWiki to Markdown\n│   ├── storage_manager.py          # Manages storage preferences \u0026 settings\n│   ├── file_manager.py             # Handles book file organization\n│   ├── media_manager.py            # Embeds and manages media\n│   ├── markdown_parser.py          # Processes Markdown content\n│   ├── html_renderer.py            # Converts Markdown to styled HTML\n│   ├── exporter.py                 # Handles full book export to HTML\n│   ├── desktop_gui.py              # The Tkinter-based GUI\n│── books/                          # User-created books (each book is a directory)\n│── output/                         # Exported HTML books\n│── assets/                         # Shared resources (icons, UI elements)\n│── requirements.txt                # Dependencies (minimal)\n│── README.md                       # Documentation\n```\n\n---\n\n## 🛠 **Features**  \n\n✅ **Fully Standalone Desktop Application** – No browser, no cloud dependencies.  \n✅ **Multi-Format Support** – Write in **Markdown or MediaWiki**, and export to HTML.  \n✅ **Full Book \u0026 Chapter Organization** – Manage, reorder, and structure books easily.  \n✅ **Rich Media Embedding** – **Images, video, and audio seamlessly integrated**.  \n✅ **One-Click HTML Export** – Generate **a fully linked static book site**.  \n✅ **Minimal \u0026 Portable** – Runs on **Linux, WSL, and Windows**.  \n\n---\n\n## 🔥 **Next Steps**  \n\n✅ **Format Detection \u0026 Markdown Conversion**  \n✅ **Fully Functional Desktop UI**  \n✅ **Comprehensive Book \u0026 Chapter Management**  \n✅ **Seamless Media Embedding \u0026 File Handling**  \n✅ **Static HTML Export for Fully Linked Book Sites**  \n\n📌 **Upcoming Features**:  \n- 📜 **PDF Export Support**  \n- 🌍 **GitHub Integration for Book Hosting**  \n- 📝 **WYSIWYG Markdown Editing Mode**  \n\n---\n\n## 🚀 **SeigrKodeks \u0026 The Seigr Ecosystem**  \n\nSeigrKodeks is **a Seigr-lab project**, developed to **provide structured documentation solutions in the binary world**.  \n\n🔹 **It is NOT a part of Seigr OS but follows Seigr principles of structured, modular, and future-proof documentation.**  \n\n🔹 **It is built for offline-first, long-term technical writing, ensuring interoperability between Markdown, MediaWiki, and HTML.**  \n\n🔹 **While it aligns with the Seigr ecosystem, SeigrKodeks is an independent tool designed to function outside Seigr OS.**  \n\n---\n\n## **Final Notes**  \n\nSeigrKodeks is built to **simplify book creation** while staying **lightweight, portable, and powerful**. It follows the **Seigr philosophy** of structured, secure, and future-proofed development.  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseigr-lab%2Fseigrkodeks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fseigr-lab%2Fseigrkodeks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseigr-lab%2Fseigrkodeks/lists"}