git-wiki
Git-wiki is a modular and full featured wiki powered by Git, GitHub/Gitlab Pages and pull requests!
The git-wiki project is composed by 3 different repository:
-
git-wiki-theme: This is the repository of the theme that implements the wiki functionalities. You would have not fork it unless you need to send a Pull Request or create your wiki project from scratch.
-
git-wiki-skeleton: This is the repo that you should fork or use as a template. It uses the jekyll remote theme functionality that allows you to create your own wiki based on git-wiki-theme. By using the remote functionality you can automatically keep your wiki always updated with latest features from the git-wiki-theme, but you can also fully customize it.
-
git-wiki: This is the documentation repository and website of the git-wiki-theme project. You would have not fork it unless you want to contribute to the git-wiki project documentation.
Getting started
The easier and faster way to use git-wiki is the "skeleton" method.
You don't need to install anything locally!
-
Simply fork/clone skeleton repo or click on the "Use this template" button to create your copy of the skeleton project.
-
Edit _config.yml and other pages as you need and then deploy it on GitHub/Gitlab Pages.
Done! Now wait that your page will be published and you're ready to wiki!
Features
- Improvements in the cooperative aspect: forks, pull requests and roles.
- You can customize your wiki as you want with stylesheets and even changing the layout (see customization section below).
- No databases! Only static files that can be downloaded in a few seconds.
- Blazing fast and free thankfully to GitHub/Gitlab Pages and Jekyll Server Side Generation process!
- Markdown and HTML mixed together!
- Multiple free search engines! on a static site!
- History, revision comparison and everything you need from a wiki platform.
- You can edit your pages with the standard git editor, prose.io (integrated) or any kind of editor you prefer.
- Non-existent wiki page links are "red", you can click on them to automatically create a new page!
- External links get the right icon automatically.
- Component system with hooks that allows you to completely customize your wiki UI (see customization section below).
- Some nice internal themes to change your entire wiki UI with 1 simple configuration (see customization section below).
- Integrated Blogging feature thanks to Jekyll!
- Automatically generated TOC!
- You can download the entire wiki for offline usage and even navigate directly using a Markdown reader!
You can use it with the Jekyll "remote_theme" feature or fork/copy the master branch and start your wiki in just 1 minute.
Instructions and full documentation: http://drassil.github.io/git-wiki