From 7c24af074532e3e9b4a7e2536f905d442abe83d7 Mon Sep 17 00:00:00 2001 From: Patrick Marsceill <patrick.marsceill@gmail.com> Date: Fri, 16 Nov 2018 14:37:28 -0500 Subject: [PATCH] Add remote-theme docs --- index.md | 15 +++++++++++++-- 1 file changed, 13 insertions(+), 2 deletions(-) diff --git a/index.md b/index.md index 66c83390..192cfeca 100644 --- a/index.md +++ b/index.md @@ -20,7 +20,14 @@ Just the Docs gives your documentation a jumpstart with a responsive Jekyll them ### Dependencies Just the Docs is built for [Jekyll](https://jekyllrb.com), a static site generator. View the [quick start guide](https://jekyllrb.com/docs/quickstart/) for more information. Just the Docs requires no special Jekyll plugins and can run on GitHub Pages standard Jekyll compiler. -### Installation +### 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 +```yaml +remote_theme: pmarsceill/just-the-docs +``` +<small>You must have GitHub pages enabled on your repo, one or more markdown files, and a `_config.yml` file. [See an example repository](https://github.com/pmarsceill/jtd-remote)</small> + +### Local installation: Use the gem-based theme 1. Install the Ruby Gem ```bash $ gem install just-the-docs @@ -29,7 +36,7 @@ $ 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` +2. Add Just the Docs to your Jekyll site’s `_config.yml` ```yaml theme: "just-the-docs" ``` @@ -47,6 +54,10 @@ $ bundle exec jekyll serve ``` 4. Point your web browser to [http://localhost:4000](http://localhost:4000) +### Configure Just the Docs +- [See configuration options]({{ site.baseurl }}{% link docs/configuration.md %}) + + --- ## About the project -- GitLab