Focus on writing good documentation

Just the Docs gives your documentation a jumpstart with a responsive Jekyll theme that is easily customizable and hosted on GitHub pages.

Get started now View it on GitHub


Getting started

Dependencies

Just the Docs is built for Jekyll, a static site generator. View the quick start guide for more information. Just the Docs requires no special Jekyll plugins and can run on GitHub Pages standard Jekyll compiler.

Installation

  1. Install the Ruby Gem
    $ gem install just-the-docs
    
    # .. or add it to your your Jekyll site’s Gemfile
    gem "just-the-docs"
    
  2. Add Just the Docs to your Jekyll site’s config.yml
    theme: "just-the-docs"
    
  3. Optional: Initialize search data (creates search-data.json)
    $ bundle exec just-the-docs rake search:init
    
  4. Run you local Jekyll server
    $ jekyll serve
    
    # .. or if you're using a Gemfile (bundler)
    $ bundle exec jekyll serve
    
  5. Point your web browser to http://localhost:4000

About the project

Just the Docs is © 2017 by Patrick Marsceill.

License

Just the Docs is distributed by an MIT license.

Contributing

When contributing to this repository, please first discuss the change you wish to make via issue, email, or any other method with the owners of this repository before making a change. Read more about becoming a contributor in our GitHub repo.

Code of Conduct

Just the Docs is committed to fostering a welcoming community.

View our Code of Conduct on our GitHub repository.