{"id":18174550,"url":"https://github.com/zizdlp/zbook","last_synced_at":"2025-04-01T15:31:50.357Z","repository":{"id":252790011,"uuid":"841049058","full_name":"zizdlp/zbook","owner":"zizdlp","description":"ZBook,An alternative solution for team-level GitBook","archived":false,"fork":false,"pushed_at":"2024-10-25T00:10:38.000Z","size":3859,"stargazers_count":125,"open_issues_count":1,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-10-25T10:44:39.550Z","etag":null,"topics":["full-stack","gitbook","goldmark","knowledge-base","markdown","markdown-documentation","markdown-to-html","nextjs","self-hosted","zbook"],"latest_commit_sha":null,"homepage":"https://zizdlp.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zizdlp.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-11T13:44:38.000Z","updated_at":"2024-10-25T04:39:57.000Z","dependencies_parsed_at":"2024-08-26T13:20:49.981Z","dependency_job_id":"f403308c-ac32-4778-b0d4-f3f2538873b8","html_url":"https://github.com/zizdlp/zbook","commit_stats":null,"previous_names":["zizdlp/zbook"],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zizdlp%2Fzbook","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zizdlp%2Fzbook/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zizdlp%2Fzbook/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zizdlp%2Fzbook/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zizdlp","download_url":"https://codeload.github.com/zizdlp/zbook/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246662375,"owners_count":20813738,"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","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":["full-stack","gitbook","goldmark","knowledge-base","markdown","markdown-documentation","markdown-to-html","nextjs","self-hosted","zbook"],"created_at":"2024-11-02T16:03:34.130Z","updated_at":"2025-04-01T15:31:45.513Z","avatar_url":"https://github.com/zizdlp.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eZBook\u003c/h1\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/zizdlp/zbook-docs\"\u003eDocumentation\u003c/a\u003e - \u003ca href=\"https://github.com/zizdlp/zbook-helm-chart\"\u003eHelm Chart\u003c/a\u003e  - \u003ca href=\"https://discord.com/channels/1250069935594536960/1250069935594536963\"\u003eDiscord\u003c/a\u003e - \u003ca href=\"https://www.youtube.com/channel/UC9D6VAJRoG7bD38dz8F9CSg\"\u003eYoutube\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n[![BUILD_MAIN](https://github.com/zizdlp/zbook/actions/workflows/build_main.yml/badge.svg?branch=main)](https://github.com/zizdlp/zbook/actions/workflows/build_main.yml)\n[![TEST_BACKEND](https://github.com/zizdlp/zbook/actions/workflows/test_backend.yml/badge.svg?branch=main)](https://github.com/zizdlp/zbook/actions/workflows/test_backend.yml)\n[![TEST_FRONTEND](https://github.com/zizdlp/zbook/actions/workflows/test_frontend.yml/badge.svg?branch=main)](https://github.com/zizdlp/zbook/actions/workflows/test_frontend.yml)\n[![CircleCI](https://dl.circleci.com/status-badge/img/gh/zizdlp/zbook/tree/release.svg?style=svg)](https://dl.circleci.com/status-badge/redirect/gh/zizdlp/zbook/tree/release)\n\n\u003c/div\u003e\n\n[中文版](docs/README_zh.md)\n\n------\n\u003cp align=\"center\"\u003eWelcome to ZBook, a fully open-source full-stack knowledge base management software for teams.\u003c/p\u003e\n\u003cp align=\"center\"\u003eThis repository contains the open-source code used to render and serve ZBook\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg alt=\"group_demo\" src=\"./zbook_frontend/public/group_demo.png\"\u003e\n\u003c/p\u003e\n\n## Table of Contents\n\n- [Getting Started](#getting-started)\n- [Features](#features)\n- [Deployment](#deployment)\n- [Licensing](#license)\n- [Acknowledgements](#acknowledgements)\n\n## Getting Started\n\nTo run a local version of this project, please follow these simple steps.\n\n### Prerequisites\n\n- docker \u0026 docker-compose\n\n### Set up\n\n1. Clone the repo into a **public** GitHub repository. If you plan to distribute the code, keep the source code public to comply with GNU GPLv3.\n\n    ```shell\n    git clone https://github.com/zizdlp/zbook.git\n    ```\n\n2. Build \u0026 run your local development server\n\n    ```shell\n    make compose_pull\n    ```\n\n3. Then open the space in your web browser, using \u003chttp://localhost:3000/\u003e\n\n4. 🍻 To use email services and third-party account login, please apply first. For details, please refer to [ZBook Documentation](https://github.com/zizdlp/zbook-docs).\n\n### CI and testing\n\nAll pull-requests will be tested against both visual and performances testing to prevent regressions.\nZBook is fully open-source and built on top of [Next.js](https://nextjs.org/).\n\n### Types of contributions\n\nWe encourage you to contribute to ZBook to help us build the best tool for documenting technical knowledge. If you're looking for some quick ways to contribute, continue reading to learn more about popular contributions.\n\n#### Translations\n\nThe ZBook UI is rendered using a set of translation files found in [`zbook_frontend/messages`](/zbook_frontend/messages/). We welcome all additional translations for the UI.\n\nIf you are submitting new language support, please first refer to the documentation [Language Support](https://github.com/zizdlp/zbook-docs/blob/main/Development/LanguageSupport.md) and follow the necessary procedures. You can refer to these commits: `ec05f3a1d75d3f88619489a44f77104a37295ba3`,\n`92e4b2933a9e23d08c15042b9b9085f4fea556f7`\n\n#### Bugs\n\nEncounter a bug or find an issue you'd like to fix? Helping us fix issues related to ZBook greatly improves the experience for everyone. Head to the issues section of this repository to learn more about the types of bugs you can already help out with.\n\n## Features\n\nSupport:\n\n- **full-stack**: a full-stack software utilizing Next.js and Tailwind CSS for the frontend, Golang gRPC for backend services, PostgreSQL for database management, and MinIO for storage, and WebSocket for real-time messaging notifications.\n- **multi-level permission management**: Support for various repository visibility options including public, login-only, selected users, and creator-only access.\n- **Comments**\n- **Notifications**\n- **open source**\n\nNot Support:\n\nZBook does **not support online editing**. We believe that tools like Git in local environments such as VS Code and Typora are sufficient for editing and collaborating on content. **Online editing is not essential** in our view. Additionally, enabling online editing would require granting write permissions to Git repositories, which could pose **security risks**.\n\n### TODO\n\nZBook plans to support the following features:\n\n- [x] Branch switching, allowing users to preview specific branches before merging into the main branch.\n- [x] MkDocs-style collapsible admonitions.\n- [ ] MkDocs-style theme extensions.\n- [ ] GitHub-style admonitions.\n\n## Deployment\n\nFor privacy and other reasons (for private repositories, you may need to input an access token; although GitHub supports fine-grained access tokens that can grant specific permissions to specific repositories, such as read-only), we encourage you to deploy ZBook yourself. You can use docker-compose or a k8s cluster for deployment. For details, please refer to the [ZBook Documentation](https://github.com/zizdlp/zbook-docs).\n\n## License\n\nDistributed under the [GNU GPLv3 License](https://github.com/zizdlp/zbook/LICENSE).\n\nIf you plan to distribute the code, you must the source code public to comply with GNU GPLv3.\nSee `LICENSE` for more information.\n\n## Acknowledgements\n\nZBook wouldn't be possible without these projects:\n\n- [Next.js](https://nextjs.org/)\n- [Tailwind CSS](https://tailwindcss.com/)\n- [GoldMark](https://github.com/yuin/goldmark)\n\n## Contributors\n\n\u003ca href=\"https://github.com/zizdlp/zbook/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=zizdlp/zbook\" /\u003e\n\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzizdlp%2Fzbook","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzizdlp%2Fzbook","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzizdlp%2Fzbook/lists"}