Project

gitdoc

0.0
No commit activity in last 3 years
No release in over 3 years
A light-weight web app for serving up a folder of markdown files
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

~> 3.0.25
~> 1.4.6
~> 1.5.8
~> 1.0
 Project Readme

GitDoc

GitDoc is another attempt at a tiny content system.

I mostly use it to share research notes with people I'm working with.

You don't actually need to use git with it.

Here's how you can use it to put some content on the internet:

mkdir resume
cd resume
gitdoc init
mate index.md
# then edit document
rake
# preview in browser
git init && git commit -m ''
heroku add
git push heroku master

My two primary goals with GitDoc are simplicity and stability.

Simplicity in the sense that the smallest GitDoc instance contains 4 files: config.ru, Gemfile, Rakefile and index.md and once you've filled index.md (and any other files you create) with your content the signal-to-noise ratio should be pretty high.

Stability in the sense that you should be able to come back to a GitDoc instance 15 months later, type rake and see the content without too much fiddling with technology.

There are literally hundreds of similar projects to GitDoc. A couple that I like are:

  • Gollum - If you don't mind waiting after you've committed your changes to see them rendered then this thing is pretty cool. Power's the GitHub wikis.
  • Brochure - Supports partials and pages can be written in any Tilt based template language.