{"id":37877933,"url":"https://github.com/mohamedelhefni/zahi","last_synced_at":"2026-01-16T16:46:16.351Z","repository":{"id":222559464,"uuid":"757745382","full_name":"mohamedelhefni/zahi","owner":"mohamedelhefni","description":"Arabic Hugo Template","archived":false,"fork":false,"pushed_at":"2024-04-28T06:15:23.000Z","size":167,"stargazers_count":12,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-04-28T08:16:57.928Z","etag":null,"topics":["go","hugo","template"],"latest_commit_sha":null,"homepage":"https://zahi.netlify.app/","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mohamedelhefni.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-02-14T22:16:35.000Z","updated_at":"2024-04-28T06:15:26.000Z","dependencies_parsed_at":"2024-02-14T23:27:24.056Z","dependency_job_id":"45cce76f-4abb-42cc-b89d-c823d21efccf","html_url":"https://github.com/mohamedelhefni/zahi","commit_stats":null,"previous_names":["mohamedelhefni/zahi"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mohamedelhefni/zahi","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mohamedelhefni%2Fzahi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mohamedelhefni%2Fzahi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mohamedelhefni%2Fzahi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mohamedelhefni%2Fzahi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mohamedelhefni","download_url":"https://codeload.github.com/mohamedelhefni/zahi/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mohamedelhefni%2Fzahi/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28480081,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T11:59:17.896Z","status":"ssl_error","status_checked_at":"2026-01-16T11:55:55.838Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["go","hugo","template"],"created_at":"2026-01-16T16:46:16.242Z","updated_at":"2026-01-16T16:46:16.329Z","avatar_url":"https://github.com/mohamedelhefni.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Zahi - Arabic Digital Garden Hugo Theme\n\n![Zahi Hugo Theme](https://raw.githubusercontent.com/mohamedelhefni/zahi/main/images/screenshot.png)\n\nZahi (زاهي) is a modern, fast Hugo theme designed for Arabic content with RTL support. It's built as a digital garden / personal knowledge base with Obsidian-like features.\n\n## Features\n\n### Core Features\n- **RTL \u0026 Arabic Optimized** - Built from the ground up for Arabic content with proper RTL layout\n- **Dark/Light Mode** - Toggle between themes with smooth transitions, no flash on page load\n- **Responsive Design** - Looks great on all devices\n- **Fast Performance** - Minimal JavaScript, optimized assets\n\n### Digital Garden Features\n- **Wiki-style Links** - Use `[[Page Title]]` syntax to link between notes (green = valid, red = broken)\n- **Knowledge Graph** - Interactive D3.js force-directed graph showing connections between posts and tags\n- **Enhanced Graph Page** - Full-page graph with filtering (pages/tags/connected), search, zoom controls, and fullscreen mode\n- **Backlinks** - Automatically shows which pages link to the current page\n- **Series Support** - Group related posts into ordered collections with progress tracking\n\n### Portfolio / Projects Section\n- **Project Showcase** - Beautiful grid layout for displaying your projects\n- **Project Types** - Support for personal, open-source, client, and contribution projects with color-coded badges\n- **Project Status** - Track project status (completed, in-progress, maintained, archived)\n- **Featured Projects** - Highlight your best work with featured badges\n- **Technology Tags** - Display tech stack with stylish badges\n- **Filtering** - Filter projects by type with smooth animations\n- **Responsive Cards** - Project cards with thumbnails, descriptions, and action buttons\n\n### Content Features\n- **Table of Contents** - Collapsible TOC for easy navigation\n- **Reading Time** - Auto-calculated based on word count\n- **Search** - Fast client-side search with Fuse.js (Ctrl+K / Cmd+K)\n- **Tags** - Organize content with tags\n- **Syntax Highlighting** - Beautiful code blocks with Dracula theme (Chroma-based)\n- **Copy Code Button** - One-click code copying\n- **Disqus Comments** - Optional comment integration\n\n### SEO Features\n- **Open Graph** - Full social media preview support\n- **Twitter Cards** - Optimized Twitter sharing\n- **JSON-LD** - Structured data for articles and breadcrumbs\n- **Sitemap \u0026 RSS** - Auto-generated feeds\n- **Canonical URLs** - Proper URL handling\n\n## Demo\n\nLive demo: [https://zahi.netlify.app/](https://zahi.netlify.app/)\n\n## Installation\n\n### Method 1: Git Submodule (Recommended)\n\n```bash\ncd your-hugo-site\ngit submodule add https://github.com/mohamedelhefni/zahi.git themes/zahi\n```\n\n### Method 2: Hugo Module\n\nAdd to your `hugo.toml`:\n\n```toml\n[module]\n  [[module.imports]]\n    path = \"github.com/mohamedelhefni/zahi\"\n```\n\nThen run:\n\n```bash\nhugo mod get -u\n```\n\n### Method 3: Direct Download\n\nDownload the theme and extract it to `themes/zahi` in your Hugo site.\n\n## Configuration\n\nAdd to your `hugo.toml`:\n\n```toml\ntheme = \"zahi\"\nlanguageCode = \"ar\"\ndefaultContentLanguage = \"ar\"\n\n[taxonomies]\ntag = \"tags\"\nseries = \"series\"\n\n[outputs]\nhome = [\"HTML\", \"RSS\", \"JSON\"]\n\n[params]\ndescription = \"وصف موقعك\"\nauthor = \"اسمك\"\n\n[params.social]\ntwitter = \"username\"\ngithub = \"username\"\nlinkedin = \"username\"\n\n[menu]\n[[menu.main]]\nname = \"الرئيسية\"\nurl = \"/\"\nweight = 1\n\n[[menu.main]]\nname = \"المقالات\"\nurl = \"/posts/\"\nweight = 2\n\n[[menu.main]]\nname = \"المشاريع\"\nurl = \"/projects/\"\nweight = 3\n\n[[menu.main]]\nname = \"الوسوم\"\nurl = \"/tags/\"\nweight = 4\n\n[[menu.main]]\nname = \"السلاسل\"\nurl = \"/series/\"\nweight = 5\n\n[[menu.main]]\nname = \"الشبكة\"\nurl = \"/graph/\"\nweight = 6\n```\n\n## Content\n\n### Basic Post\n\n```yaml\n---\ntitle: \"عنوان المقالة\"\ndate: 2024-01-15\ntags: [\"وسم1\", \"وسم2\"]\ntoc: true\n---\n\nمحتوى المقالة...\n```\n\n### Wiki Links\n\nLink to other posts using wiki-style syntax:\n\n```markdown\nاقرأ المزيد في [[عنوان صفحة أخرى]]\n```\n\n### Series\n\nCreate a series by adding to frontmatter:\n\n```yaml\n---\ntitle: \"الجزء الأول: المقدمة\"\nseries: \"اسم السلسلة\"\nseriesOrder: 1\nseriesDescription: \"وصف السلسلة\"\n---\n```\n\n### Pinned Posts\n\nPin posts to the homepage:\n\n```yaml\n---\ntitle: \"مقالة مثبتة\"\npinned: true\n---\n```\n\n### Projects\n\nCreate projects in `content/projects/`:\n\n```yaml\n---\ntitle: \"اسم المشروع\"\ndate: 2024-01-15\ndescription: \"وصف قصير للمشروع\"\nthumbnail: \"/images/project-thumb.png\"\ntype: \"personal\"  # personal, open-source, client, contribution\nstatus: \"completed\"  # completed, in-progress, maintained, archived\nfeatured: true\ntechnologies: [\"Hugo\", \"Tailwind CSS\", \"JavaScript\"]\ndemoUrl: \"https://demo.example.com\"\nrepoUrl: \"https://github.com/user/repo\"\nwebsiteUrl: \"https://example.com\"\n---\n\nوصف تفصيلي للمشروع...\n```\n\n## Knowledge Graph\n\nThe theme includes an interactive knowledge graph that visualizes connections between your content:\n\n- **Article Graph**: Each post shows a mini-graph of related content\n- **Full Graph Page**: Navigate to `/graph/` for the complete knowledge map\n- **Features**:\n  - Filter by pages, tags, or connected nodes only\n  - Search for specific content\n  - Zoom and pan controls\n  - Fullscreen mode\n  - Click nodes to navigate\n  - Hover to highlight connections\n\n## Development\n\n### Prerequisites\n\n- Hugo Extended v0.112.0+\n- Node.js (for Tailwind CSS)\n\n### Setup\n\n```bash\n# Clone the repository\ngit clone https://github.com/mohamedelhefni/zahi.git\ncd zahi\n\n# Install dependencies\npnpm install\n\n# Start Hugo server\ncd exampleSite \u0026\u0026 hugo server\n\n# Watch Tailwind CSS (in another terminal)\nnpx tailwindcss -i ./static/css/style.css -o ./static/css/output.css --watch\n```\n\n### Build CSS\n\n```bash\nnpx tailwindcss -i ./static/css/style.css -o ./static/css/output.css --minify\n```\n\n## Directory Structure\n\n```\nzahi/\n├── archetypes/\n│   ├── default.md\n│   └── projects.md        # Project template\n├── exampleSite/           # Demo site\n├── images/\n│   ├── screenshot.png     # Theme screenshot\n│   └── tn.png             # Thumbnail\n├── layouts/\n│   ├── _default/\n│   ├── graph/             # Knowledge graph pages\n│   ├── partials/\n│   ├── projects/          # Projects section\n│   ├── series/            # Series taxonomy\n│   └── shortcodes/\n├── static/\n│   ├── css/\n│   │   ├── style.css      # Source styles\n│   │   ├── output.css     # Compiled Tailwind\n│   │   └── syntax.css     # Code highlighting\n│   └── js/\n├── hugo.toml              # Hugo version requirements\n├── theme.toml             # Theme metadata\n└── README.md\n```\n\n## Credits\n\n- [IBM Plex Sans Arabic](https://fonts.google.com/specimen/IBM+Plex+Sans+Arabic) - Font\n- [Tailwind CSS](https://tailwindcss.com/) - Styling\n- [D3.js](https://d3js.org/) - Knowledge graph\n- [Fuse.js](https://fusejs.io/) - Search\n\n## License\n\n[MIT License](LICENSE)\n\n## Author\n\n**Mohamed Elhefni**\n- GitHub: [@mohamedelhefni](https://github.com/mohamedelhefni)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmohamedelhefni%2Fzahi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmohamedelhefni%2Fzahi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmohamedelhefni%2Fzahi/lists"}