index.md

layout: default
title: Home
nav_order: 1
description: "Just the Docs is a responsive Jekyll theme with built-in search that is easily customizable and hosted on GitHub Pages."
permalink: /

Focus on writing good documentation

{: .fs-9 }

Just the Docs gives your documentation a jumpstart with a responsive Jekyll theme that is easily customizable and hosted on GitHub Pages. {: .fs-6 .fw-300 }

Get started now{: .btn .btn-primary .fs-5 .mb-4 .mb-md-0 .mr-2 } View it on GitHub{: .btn .fs-5 .mb-4 .mb-md-0 }

---

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.

Quick start: Use as a GitHub Pages remote theme

1. Add Just the Docs to your Jekyll site's _config.yml as a remote theme

remote_theme: pmarsceill/just-the-docs

You must have GitHub Pages enabled on your repo, one or more Markdown files, and a _config.yml file. See an example repository

Local installation: Use the gem-based theme

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

3. Run you local Jekyll server

$ jekyll serve

# .. or if you're using a Gemfile (bundler)
$ bundle exec jekyll serve

4. Point your web browser to http://localhost:4000

Configure Just the Docs

• See configuration options

---

About the project

Just the Docs is © 2017 by Patrick Marsceill.