Project

deagol

0.0
No commit activity in last 3 years
No release in over 3 years
Short description See https://github.com/nathankleyn/deagol for more information.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 2.14.1

Runtime

~> 3.0.0
 Project Readme

Déagol - A static documentation generator with search

Déagol is a work-in-progress. The below README is a decription of what will become v1.0.0. Please feel free to contribute and/or try master out in the meantime!

Déagol is a tool for generating static documentation. It takes a Gollum wiki in, and a static site comes out. Déagol adds many desirable features atop the normal Gollum wiki:

  • Generates Static Output - The output from Déagol is completely static HTML, allowing you to distribute and host your documentation easily.
  • Search - We use the excellent Lunr.js to build an offline index for all your Wiki pages, and use that to provide search for your static documentation.
  • Site Templates - Déagol allows you to define templates for your site using the Liquid template engine. It comes with a default template that has a clean and responsive design which you can use as is, or build atop of!
  • GitHub Pages support - Déagol has a single command which you can use to generate and upload your documentation to GitHub Pages.
  • Format agnostic - Thanks to Gollum, you can write your documentation in almost any format you can imagine (Markdown, GFM Markdown, Textile, ReStructuredText, MediaWiki, and many others!)

Quick Start

Install Déagol via RubyGems:

gem install deagol

Now, in the root of any Gollum based Wiki, you can generate static documentation:

deagol generate

Or, you can deploy straight to the GitHub Pages branch of the current repository:

deagol deploy

For more commands, and instructions, run the deagol help command.

Documentation (And Demo!)

Dégol eats its own dog food and has documentation available at https://nathankleyn.github.io/deagol which is generated using itself. You can find the raw source of the documentation at https://github.com/nathankleyn/deagol-docs.

Developing Dégol

Dégol is written in Ruby. Please attempt to adhere strictly to the GitHub Ruby Styleguide, and document all methods using TomDoc. All releases are versioned using Semantic Versioning.

All unit tests are written using RSpec, and integration tests use Cucumber with RSpec expectations.

To contribute, please follow the guide in [CONTRIBUTING.md]. I'll do our best to accept any pull requests in a timely fashion, and will endeavour to give you the love and admiration your work deserves!

What's With The Name?

Geeky Explanation: In The Lord of the Rings, Déagol is the relative of Sméagol, whom you all know by a better name: Gollum. Slightly Less Geeky Explanation: It's an admittedly poor excuse to use a non-ASCII character in a project name.

License

Dégol is licensed with the simple and permissive MIT license. You can find a copy of this license both in the root of this repository, and in the Gem file that you can download from RubyGems.