notes/index.md

74 lines
2.2 KiB
Markdown
Raw Normal View History

2017-03-09 18:16:08 +00:00
---
layout: default
title: Home
nav_order: 1
---
2017-03-24 13:47:37 +00:00
# Focus on writing documentation, not building a website for it.
{: .mt-4 .mt-md-0 :}
2017-03-09 18:16:08 +00:00
2017-03-24 13:47:37 +00:00
<div class="d-sm-flex my-sm-7">
<div class="px-8 pl-sm-0 pr-sm-6 mb-5 mb-sm-0">
<img src="/assets/images/just-the-docs.png" alt="" class="mt-sm-2">
</div>
<div markdown="1">
Just the Docs gives your documentation a home with a responsive Jekyll theme that is easily customizable and hosted on GitHub pages.
{: .fs-6 .fw-300 }
[Get Started](#getting-started){: .btn .btn-purple .mr-2 } [View GitHub](https://github.com/pmarsceill/just-the-docs){: .btn }
</div>
</div>
2017-03-09 18:16:08 +00:00
---
## Getting started
### Dependancies
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 Jekyll compiler.
### Installation
1. Install the Ruby Gem
```bash
$ gem install just-the-docs
```
```yaml
# .. or add it to your your Jekyll sites Gemfile
gem "just-the-docs"
```
2. Add Just the Docs to your Jekyll sites `config.yml`
```yaml
theme: "just-the-docs"
```
3. Run you local Jekyll server
```bash
2017-03-24 13:47:37 +00:00
$ jekyll serve
```
```bash
# .. or if you're using a Gemfile (bundler)
2017-03-09 18:16:08 +00:00
$ bundle exec jekyll serve
```
4. Point your web browser to [http://localhost:4000](http://localhost:4000)
---
## About the project
2017-03-24 13:47:37 +00:00
Just the Docs is &copy; 2017 by [Patrick Marsceill](http://patrickmarsceill.com).
2017-03-09 18:16:08 +00:00
### License
Just the Docs is distributed by an [MIT license](https://github.com/pmarsceill/just-the-docs/tree/master/LICENSE.txt).
### 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][954661c7].
[954661c7]: https://github.com/pmarsceill/just-the-docs/tree/master/CONTRIBUTING.md "Contributing.md on Just the Docs GitHub repository"
### Code of Conduct
Just the Docs is committed to fostering a welcoming community.
[View our Code of Conduct](https://github.com/pmarsceill/just-the-docs/tree/master/CODE_OF_CONDUCT.md) on our GitHub repository.