Popularity
9.5
Stable
Activity
8.2
-
10,789
279
1,507

Monthly Downloads: 0
Programming language: JavaScript
License: Do What The F*ck You Want To Public License
Tags: Wikis    
Latest version: v5.0.1

Gollum alternatives and similar software solutions

Based on the "Wikis" category

  • Outline

    An open, extensible, wiki for your team built using React and Node.js.
  • Wiki.js

    Wiki.js | A modern, lightweight and powerful wiki app built on NodeJS, Git and Markdown
  • TiddlyWiki

    A reusable non-linear personal web notebook.
  • BookStack

    BookStack is a simple, self-hosted, easy-to-use platform for organizing and storing information. It allows for documentation to be stored in a book like fashion.
  • Dokuwiki

    An easy to use, lightweight, standards-compliant wiki engine with a simple syntax allowing reading the data outside the wiki. All data is stored in plain files, therefore no database is required.
  • Mediawiki

    MediaWiki is a free and open-source wiki software package written in PHP. It serves as the platform for Wikipedia and the other Wikimedia projects, used by hundreds of millions of people each month.
  • Raneto

    Raneto is an open source Knowledgebase platform that uses static Markdown files to power your Knowledgebase
  • Gitit

    A wiki program that stores pages and uploaded files in a git repository, which can then be modified using the VCS command line tools or the wiki's web interface. Supported markups include pandoc's extended version of markdown, reStructuredText, LaTeX, and HTML. Pages can be exported in a number of different formats, including LaTeX, RTF, OpenOffice ODT, and MediaWiki markup. Other features include: plugins, syntax highlighting, caching, ATOM feeds.
  • django-wiki

    A wiki system with complex functionality for simple integration and a superb interface. Store your knowledge with style: Use django models.
  • jingo

    A git based wiki engine written for node.js, with a decent design, a search capability and a good typography.
  • XWiki

    A second generation wiki that allows the user to extend its functionalities with a powerful extension-based architecture.
  • Documize

    Modern Docs + Wiki software with built-in workflow, single binary executable, just bring MySQL/Percona.
  • Wikitten

    Wikitten is a small, fast, PHP wiki, and the perfect place to store your notes, code snippets, ideas, and so on.
  • Realms

    A git-backed wiki inspired by Gollum.
  • Olelo

    Olelo is a wiki that stores pages in a Git repository, supports many markup styles and has an extensible, hackable architecture.
  • Cowyo

    Cowyo is a feature-rich wiki for minimalists.
  • Gruik

    An open-source markdown note-taking web app.
  • commonplace

    A server for your markdown files. Give it a directory, and Commonplace gives you a url, pretty pages, and quick editing.
  • Codex

    Codex is a simple file-based Markdown documentation platform built on top of Laravel.
  • Wikifeat

    Wikifeat is an open source collaboration platform built around the ever-popular Wiki concept.
  • Pepperminty Wiki

    A complete markdown-powered wiki contained in a single PHP file.
  • amusewiki

    Text::Amuse-based publishing platform
  • wiki

    Simple Markdown based wiki engine.
  • Tiki

    2.0 0.0 L2 Gollum VS Tiki
    Wiki CMS Groupware with the most built-in features.
  • Blazekiss

    BlazeKiss is a KISS-based wiki
  • MoinMoin

    An advanced, easy to use and extensible WikiEngine with a large community of users.
  • ikiwiki

    A wiki compiler.
  • Zim

    Graphical text editor used to maintain a collection of wiki pages. Each page can contain links to other pages, simple formatting and images.
  • PmWiki

    Wiki-based system for collaborative creation and maintenance of websites.
  • TWiki

    TWiki is a Perl-based structured wiki application, typically used to run a collaboration platform, knowledge or document management system, a knowledge base, or team portal.
  • WiKiss

    A Wiki, simple to use and install.

Do you think we are missing an alternative of Gollum or a related project?

Add another 'Wikis' Software solution

README

gollum -- A git-based Wiki

Gem Version Build Status Open Source Helpers

Gollum version 5.0 is out! See here for a list of changes and new features compared to Gollum version 4.x, and see some Screenshots of Gollum's features.

DESCRIPTION

Gollum is a simple wiki system built on top of Git. A Gollum Wiki is simply a git repository of a specific nature:

  • A Gollum repository's contents are human-editable text or markup files.
  • Pages may be organized into directories any way you choose.
  • Other content can also be included, for example images, PDFs and headers/footers for your pages.
  • Gollum pages:
    • May be written in a variety of markups.
    • Can be edited with your favourite system editor or IDE (changes will be visible after committing) or with the built-in web interface.
    • Can be displayed in all versions, reverted, etc.
  • Gollum strives to be compatible with GitHub wikis (see --lenient-tag-lookup)
  • Gollum supports advanced functionality like:

SYSTEM REQUIREMENTS

Gollum runs on Unix-like systems using its adapter for rugged by default. You can also run Gollum on JRuby via its adapter for RJGit. On Windows, Gollum runs only on JRuby.

INSTALLATION

  1. Ruby is best installed either via RVM or a package manager of choice.
  2. Gollum is best installed via RubyGems:
    [sudo] gem install gollum

Installation examples for individual systems can be seen here.

To run, simply:

  1. Run: gollum /path/to/wiki.
  2. Open http://localhost:4567 in your browser.

See below for information on running Gollum from source, as a Rack app, and more.

Markups

Gollum allows using different markup languages on different wiki pages. It presently ships with support for the following markups:

You can easily activate support for other markups by installing additional renderers (any that are supported by github-markup):

  • AsciiDoc -- [sudo] gem install asciidoctor
  • Creole -- [sudo] gem install creole
  • MediaWiki -- [sudo] gem install wikicloth
  • Org -- [sudo] gem install org-ruby
  • Pod -- requires Perl >= 5.10 (the perl command must be available on your command line)
    • Lower versions should install Pod::Simple from CPAN.
  • ReStructuredText -- requires python >= 2 (the python2 command must be available on your command line)
    • Note that Gollum will also need you to install docutils for your Python 2.
  • Textile -- [sudo] gem install RedCloth

Markdown flavors

By default, Gollum ships with the kramdown gem to render Markdown. However, you can use any Markdown renderer supported by github-markup. This includes CommonMark support via the commonmarker gem. The first installed renderer from the list will be used (e.g., redcarpet will NOT be used if github/markdown is installed). Just gem install the renderer of your choice.

See here for instructions on how to use custom rendering gems and set custom options.

RUNNING FROM SOURCE

  1. git clone https://github.com/gollum/gollum
  2. cd gollum
  3. [sudo] bundle install
  4. bundle exec bin/gollum
  5. Open http://localhost:4567 in your browser.

Rack

Gollum can also be ran with any rack-compatible web server. More on that over here.

Rack, with an authentication server

Gollum can also be ran alongside a CAS (Central Authentication Service) SSO (single sign-on) server. With a bit of tweaking, this adds basic user-support to Gollum. To see an example and an explanation, navigate over here.

Docker

Gollum can also be ran via Docker. More on that over here.

Service

Gollum can also be ran as a service. More on that over here.

CONFIGURATION

Gollum comes with the following command line options:

Option Arguments Description
--host [HOST] Specify the hostname or IP address to listen on. Default: '0.0.0.0'.1
--port [PORT] Specify the port to bind Gollum with. Default: 4567.
--config [FILE] Specify path to Gollum's configuration file.
--ref [REF] Specify the git branch to serve. Default: master.
--bare none Tell Gollum that the git repository should be treated as bare.
--adapter [ADAPTER] Launch Gollum using a specific git adapter. Default: rugged.2
--base-path [PATH] Specify the leading portion of all Gollum URLs (path info). Setting this to /wiki will make the wiki accessible under http://localhost:4567/wiki/. Default: /.
--page-file-dir [PATH] Specify the subdirectory for all pages. If set, Gollum will only serve pages from this directory and its subdirectories. Default: repository root.
--static, --no-static none Use static assets. Defaults to false in development/test, true in production/staging.
--assets [PATH] Set the path to look for static assets.
--css none Tell Gollum to inject custom CSS into each page. Uses custom.css from wiki root.3
--js none Tell Gollum to inject custom JS into each page. Uses custom.js from wiki root.3
--no-edit none Disable the feature of editing pages.
--follow-renames, --no-follow-renames none Follow pages across renames in the History view. Default: true.
--allow-uploads [MODE] Enable file uploads. If set to dir, Gollum will store all uploads in the /uploads/ directory in repository root. If set to page, Gollum will store each upload at the currently edited page.4
--mathjax none Enables MathJax (renders mathematical equations). By default, uses the TeX-AMS-MML_HTMLorMML config with the autoload-all extension.5
--critic-markup none Enable support for annotations using CriticMarkup.
--irb none Launch Gollum in "console mode", with a predefined API.
--h1-title none Tell Gollum to use the first <h1> as page title.
--no-display-metadata none Do not render metadata tables in pages.
--user-icons [MODE] Tell Gollum to use specific user icons for history view. Can be set to gravatar, identicon or none. Default: none.
--mathjax-config [FILE] Specify path to a custom MathJax configuration. If not specified, uses the mathjax.config.js file from repository root.
--template-dir [PATH] Specify custom mustache template directory.
--template-page none Use _Template in root as a template for new pages. Must be committed.
--emoji none Parse and interpret emoji tags (e.g. :heart:) except when the leading colon is backslashed (e.g. \:heart:).
--lenient-tag-lookup none Internal links resolve case-insensitively, will treat spaces as hyphens, and will match the first page found with a certain filename, anywhere in the repository. Provides compatibility with Gollum 4.x.
--help none Display the list of options on the command line.
--version none Display the current version of Gollum.
--versions none Display the current version of Gollum and auxiliary gems.

Notes:

  1. The 0.0.0.0 IP address allows remote access. Should you wish for Gollum to turn into a personal Wiki, use 127.0.0.1.
  2. Before using --adapter, you should probably read this first.
  3. When --css or --js is used, respective files must be committed to your git repository or you will get a 302 redirect to the create a page.
  4. Files can be uploaded simply by dragging and dropping them onto the editor's text area when --allow-uploads is used.

Config file

When --config option is used, certain inner parts of Gollum can be customized. This is used throughout our wiki for certain user-level alterations, among which customizing supported markups will probably stand out.

All of the mentioned alterations work both for Gollum's config file (config.rb) and Rack's config file (config.ru).

CONTRIBUTING

Please consider helping out! See [CONTRIBUTING](CONTRIBUTING.md) for information on how to submit issues, and how to start hacking on gollum.