Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/GitbookIO/gitbook
The open source frontend for GitBook doc sites
https://github.com/GitbookIO/gitbook
documentation git gitbook markdown
Last synced: about 1 month ago
JSON representation
The open source frontend for GitBook doc sites
- Host: GitHub
- URL: https://github.com/GitbookIO/gitbook
- Owner: GitbookIO
- License: gpl-3.0
- Created: 2014-03-31T03:01:56.000Z (about 10 years ago)
- Default Branch: main
- Last Pushed: 2024-05-16T16:05:59.000Z (about 1 month ago)
- Last Synced: 2024-05-16T18:18:19.138Z (about 1 month ago)
- Topics: documentation, git, gitbook, markdown
- Language: TypeScript
- Homepage: https://www.gitbook.com
- Size: 35.7 MB
- Stars: 26,436
- Watchers: 710
- Forks: 3,799
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
Lists
- awesome-devrel - gitbook.com
- awesome-markdown - GitBook :octocat: - a command line tool (and Node.js library) for building beautiful books using GitHub/Git and Markdown (or AsciiDoc) (Book Services / JSON to Markdown)
- awesome-stars - GitbookIO/gitbook
- awesome-devops - Gitbook - Modern documentation format and toolchain using Git and Markdown. (Sharing)
- awesome-from-stars - GitbookIO/gitbook
- awesome-node-modules - gitbook - Modern book format and toolchain using Git and Markdown. (Uncategorized / Uncategorized)
- awesome-stars - GitbookIO/gitbook - The open source frontend for GitBook doc sites (TypeScript)
- awesome-stars - GitbookIO/gitbook - The open source frontend for GitBook doc sites (TypeScript)
- awesome-stars - GitbookIO/gitbook - The open source frontend for GitBook doc sites (TypeScript)
- awesome-stars - gitbook
- awesome-stars - GitbookIO/gitbook - The open source frontend for GitBook doc sites (TypeScript)
- awesome-stars - GitbookIO/gitbook - The open source frontend for GitBook doc sites (TypeScript)
- awesome-stars - gitbook
- awesome-stars - GitbookIO/gitbook - The open source frontend for GitBook doc sites (TypeScript)
- awesome-stars - gitbook
- awesome - GitbookIO / gitbook
- awesome-stars - GitbookIO/gitbook - The open source frontend for GitBook doc sites (TypeScript)
- awesome-stars - gitbook
- awesome-technical-writing - GitBook
- awesome-stars - GitbookIO/gitbook - The open source frontend for GitBook doc sites (TypeScript)
- awesome - gitbook - 📝 Modern documentation format and toolchain using Git and Markdown (JavaScript)
- awesome-stars - gitbook - Modern book format and toolchain using Git and Markdown (JavaScript)
- awesome-stars - gitbook
- awesome-stars - gitbook - Modern book format and toolchain using Git and Markdown (JavaScript)
- awesome-stars - gitbook - 📝 Modern documentation format and toolchain using Git and Markdown (JavaScript)
- alex-mikhalev-awesome-stars - gitbook - Modern book format and toolchain using Git and Markdown (JavaScript)
- awesome-stars - gitbook - 📝 Modern documentation format and toolchain using Git and Markdown (JavaScript)
- awesome-stars - gitbook - 📝 Modern documentation format and toolchain using Git and Markdown (JavaScript)
- awesome-stars - gitbook - Modern book format and toolchain using Git and Markdown (JavaScript)
- awesome-sauce - GitBook
- awesome-stars - GitbookIO/gitbook - The open source frontend for GitBook doc sites (TypeScript)
- awesome-stars - GitbookIO/gitbook - The open source frontend for GitBook doc sites (TypeScript)
- awesome-stars - gitbook
- awesome-starred - gitbook - 📝 Modern documentation format and toolchain using Git and Markdown (JavaScript)
- project-awesome - GitbookIO/gitbook - The open source frontend for GitBook doc sites (TypeScript)
- awesome - GitbookIO/gitbook - 📝 Modern documentation format and toolchain using Git and Markdown (JavaScript)
- my-awesome-stars - GitbookIO/gitbook - The open source frontend for GitBook doc sites (TypeScript)
- awesome-stars - gitbook - 📝 Modern documentation format and toolchain using Git and Markdown (JavaScript)
- awesome-starred - GitbookIO/gitbook - 📝 Modern documentation format and toolchain using Git and Markdown (others)
- starred-awesome - gitbook - 📝 Modern documentation format and toolchain using Git and Markdown (JavaScript)
- awesome-stars - GitbookIO/gitbook - The open source frontend for GitBook doc sites (TypeScript)
- awesome-stars - GitbookIO/gitbook - The open source frontend for GitBook doc sites (TypeScript)
- awesome-stars - GitbookIO/gitbook - The open source frontend for GitBook doc sites (TypeScript)
- awesome-stars - GitbookIO/gitbook - `★26568` The open source frontend for GitBook doc sites (TypeScript)
- awesome-stars - GitbookIO/gitbook - The open source frontend for GitBook doc sites (TypeScript)
- awesome - GitbookIO/gitbook - The open source frontend for GitBook doc sites (TypeScript)
- my-awesome-github-stars - GitbookIO/gitbook - The open source frontend for GitBook doc sites (TypeScript)
- awesome-stars - GitbookIO/gitbook - The open source frontend for GitBook doc sites (TypeScript)
- awesome-stars - GitbookIO/gitbook - The open source frontend for GitBook doc sites (TypeScript)
- my-awesome-stars - GitbookIO/gitbook - The open source frontend for GitBook doc sites (TypeScript)
- my-awesome-stars - GitbookIO/gitbook - 📝 Modern documentation format and toolchain using Git and Markdown (JavaScript)
- awesome-github-repos - GitbookIO/gitbook - The open source frontend for GitBook doc sites (TypeScript)
- awesome-stars - GitbookIO/gitbook - The open source frontend for GitBook doc sites (TypeScript)
- awesome-stars - GitbookIO/gitbook - 📝 Modern documentation format and toolchain using Git and Markdown (JavaScript)
- awesome - gitbook - 📝 Modern documentation format and toolchain using Git and Markdown (JavaScript)
- awesome - gitbook - 📝 Modern documentation format and toolchain using Git and Markdown (JavaScript)
- docsify-awesome-stars - GitbookIO/gitbook - 📝 Modern documentation format and toolchain using Git and Markdown (JavaScript)
- awesome-stars - gitbook - 📝 Modern documentation format and toolchain using Git and Markdown (JavaScript)
README
GitBook
Docs - Community - Developer Docs - Changelog - Bug reportsWelcome to GitBook, the platform for managing technical knowledge for teams.
This repository contains the open-source code used to render GitBook's published content.
![]()
## Table of Contents
- [Getting Started](#getting-started)
- [Contributing](#contributing)
- [Types of contributions](#types-of-contributions)
- [Licensing](#license)
- [Acknowledgements](#acknowledgements)
- [Legacy GitBook](#legacy-gitbook-deprecated)## Getting Started
To run a local version of this project, please follow these simple steps.
### Prerequisites
- Node.js (Version: >=18.x)
- Bun### Set up
1. 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. To clone in a private repository, acquire a [commercial license](https://www.gitbook.com/pricing).
```
git clone https://github.com/gitbookIO/gitbook.git
```2. Install the project's dependencies through Bun.
```
bun install
```3. Start your local development server.
```
bun dev
```Then open the space in your web browser, using http://localhost:3000// (example: http://localhost:3000/docs.gitbook.com).
### Other development commands
- `bun format`: format the code
- `bun lint`: lint the code### CI and testing
All pull-requests will be tested against both visual and performances testing to prevent regressions.
## Contributing
GitBook's rendering engine is fully open-source and built on top of [Next.js](https://nextjs.org/). Head to our [contributing guide](https://github.com/GitbookIO/gitbook/.github/CONTRIBUTING.md) to learn more about the workflow on adding your first Pull Request.
### Types of contributions
We encourage you to contribute to GitBook 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.
#### Translations
The GitBook UI is rendered using a set of translation files found in [`src/intl/translations`](/src/intl/translations/). We welcome all additional translations for the UI.
#### Bugs
Encounter a bug or find an issue you'd like to fix? Helping us fix issues related to GitBook 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.
## Deployment
> [!WARNING]
> While it is possible to self-host this project, we do not recommend this unless you are certain this option fits your need.
>
> _Looking to add a specific feature in GitBook? Head to our [contributing guide](/.github/CONTRIBUTING.md) to get started._
>
> Self-hosting this project puts the responsibility of maintaining and merging future updates on **you**. We cannot guarantee support, maintenance, or updates to forked and self-hosted instances of this project.
>
> We want to make it as easy as possible for our community to collaborate and push the future of GitBook, which is why we encourage you to contribute to our product directly instead of creating your own version.This project allows you to self-host the rendering portion of your GitBook published content. Self-hosting has pros and cons.
On the pro side, you can customize the look and feel of your content, and better embed your documentation in your application.
On the con side, you become responsible for the reliability of your published site, and keeping the renderer up-to-date with the changes made to the GitBook platform.
## License
Distributed under the [GNU GPLv3 License](https://github.com/GitBookIO/gitbook/blob/main/LICENSE).
If you plan to distribute the code, you must the source code public to comply with GNU GPLv3. To clone in a private repository, acquire a [commercial license](https://www.gitbook.com/pricing).
See `LICENSE` for more information.
## Acknowledgements
GitBook wouldn't be possible without these projects:
- [Next.js](https://nextjs.org/)
- [Bun](https://bun.sh/)
- [Tailwind CSS](https://tailwindcss.com/)
- [Framer Motion](https://www.npmjs.com/package/framer-motion)## Legacy GitBook (Deprecated)
Our previous version of GitBook and it's CLI tool are now deprecated. You can still view the old repository and it's commits on this [branch](https://github.com/GitbookIO/gitbook/tree/legacy).