Skip to content

Commit d46bd17

Browse files
author
Benedikt Wannemacher
committed
adapted to Template
1 parent c308d0c commit d46bd17

File tree

370 files changed

+27742
-185
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

370 files changed

+27742
-185
lines changed

.gitignore

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,7 @@
1-
_site
1+
*.gem
2+
.bundle
23
.sass-cache
3-
.jekyll-cache
4-
.jekyll-metadata
5-
vendor
4+
_site
5+
Gemfile.lock
6+
node_modules
7+
.install

.stylelintrc.json

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
{
2+
"ignoreFiles" : [
3+
"assets/css/just-the-docs.scss",
4+
"assets/css/dark-mode-preview.scss",
5+
"_sass/vendor/**/*.scss"
6+
],
7+
"extends": [
8+
"stylelint-config-primer"
9+
]
10+
}

404.html

Lines changed: 6 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,11 @@
11
---
2-
permalink: /404.html
32
layout: default
3+
title: Page not found
4+
permalink: /404
5+
nav_exclude: true
6+
search_exclude: true
47
---
58

6-
<style type="text/css" media="screen">
7-
.container {
8-
margin: 10px auto;
9-
max-width: 600px;
10-
text-align: center;
11-
}
12-
h1 {
13-
margin: 30px 0;
14-
font-size: 4em;
15-
line-height: 1;
16-
letter-spacing: -1px;
17-
}
18-
</style>
9+
<h1>Page not found</h1>
1910

20-
<div class="container">
21-
<h1>404</h1>
22-
23-
<p><strong>Page not found :(</strong></p>
24-
<p>The requested page could not be found.</p>
25-
</div>
11+
<p>The page you requested could not be found. Try using the navigation {% if site.search_enabled %}or search {% endif %}to find what you're looking for or go to this <a href="{{ site.url }}{{ site.baseurl }}">site's home page</a>.</p>

CNAME

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+

CODE_OF_CONDUCT.md

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
# Contributor Covenant Code of Conduct
2+
3+
## Our Pledge
4+
5+
In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.
6+
7+
## Our Standards
8+
9+
Examples of behavior that contributes to creating a positive environment include:
10+
11+
* Using welcoming and inclusive language
12+
* Being respectful of differing viewpoints and experiences
13+
* Gracefully accepting constructive criticism
14+
* Focusing on what is best for the community
15+
* Showing empathy towards other community members
16+
17+
Examples of unacceptable behavior by participants include:
18+
19+
* The use of sexualized language or imagery and unwelcome sexual attention or advances
20+
* Trolling, insulting/derogatory comments, and personal or political attacks
21+
* Public or private harassment
22+
* Publishing others' private information, such as a physical or electronic address, without explicit permission
23+
* Other conduct which could reasonably be considered inappropriate in a professional setting
24+
25+
## Our Responsibilities
26+
27+
Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.
28+
29+
Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.
30+
31+
## Scope
32+
33+
This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.
34+
35+
## Enforcement
36+
37+
Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at [email protected]. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
38+
39+
Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.
40+
41+
## Attribution
42+
43+
This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [http://contributor-covenant.org/version/1/4][version]
44+
45+
[homepage]: http://contributor-covenant.org
46+
[version]: http://contributor-covenant.org/version/1/4/

Gemfile

Lines changed: 1 addition & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,29 +1,2 @@
11
source "https://rubygems.org"
2-
# Hello! This is where you manage which Jekyll version is used to run.
3-
# When you want to use a different version, change it below, save the
4-
# file and run `bundle install`. Run Jekyll with `bundle exec`, like so:
5-
#
6-
# bundle exec jekyll serve
7-
#
8-
# This will help ensure the proper Jekyll version is running.
9-
# Happy Jekylling!
10-
gem "jekyll", "~> 4.0.0"
11-
# This is the default theme for new Jekyll sites. You may change this to anything you like.
12-
gem "minima", "~> 2.5"
13-
# If you want to use GitHub Pages, remove the "gem "jekyll"" above and
14-
# uncomment the line below. To upgrade, run `bundle update github-pages`.
15-
# gem "github-pages", group: :jekyll_plugins
16-
# If you have any plugins, put them here!
17-
group :jekyll_plugins do
18-
gem "jekyll-feed", "~> 0.12"
19-
end
20-
21-
# Windows and JRuby does not include zoneinfo files, so bundle the tzinfo-data gem
22-
# and associated library.
23-
install_if -> { RUBY_PLATFORM =~ %r!mingw|mswin|java! } do
24-
gem "tzinfo", "~> 1.2"
25-
gem "tzinfo-data"
26-
end
27-
28-
# Performance-booster for watching directories on Windows
29-
gem "wdm", "~> 0.1.1", :install_if => Gem.win_platform?
2+
gemspec

Gemfile.lock

Lines changed: 26 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,11 @@
1+
PATH
2+
remote: .
3+
specs:
4+
just-the-docs (0.2.7)
5+
jekyll (~> 3.8.5)
6+
jekyll-seo-tag (~> 2.0)
7+
rake (~> 12.3.1)
8+
19
GEM
210
remote: https://rubygems.org/
311
specs:
@@ -12,73 +20,54 @@ GEM
1220
ffi (1.12.2-x64-mingw32)
1321
forwardable-extended (2.6.0)
1422
http_parser.rb (0.6.0)
15-
i18n (1.8.2)
23+
i18n (0.9.5)
1624
concurrent-ruby (~> 1.0)
17-
jekyll (4.0.0)
25+
jekyll (3.8.6)
1826
addressable (~> 2.4)
1927
colorator (~> 1.0)
2028
em-websocket (~> 0.5)
21-
i18n (>= 0.9.5, < 2)
22-
jekyll-sass-converter (~> 2.0)
29+
i18n (~> 0.7)
30+
jekyll-sass-converter (~> 1.0)
2331
jekyll-watch (~> 2.0)
24-
kramdown (~> 2.1)
25-
kramdown-parser-gfm (~> 1.0)
32+
kramdown (~> 1.14)
2633
liquid (~> 4.0)
2734
mercenary (~> 0.3.3)
2835
pathutil (~> 0.9)
29-
rouge (~> 3.0)
36+
rouge (>= 1.7, < 4)
3037
safe_yaml (~> 1.0)
31-
terminal-table (~> 1.8)
32-
jekyll-feed (0.13.0)
33-
jekyll (>= 3.7, < 5.0)
34-
jekyll-sass-converter (2.1.0)
35-
sassc (> 2.0.1, < 3.0)
38+
jekyll-sass-converter (1.5.2)
39+
sass (~> 3.4)
3640
jekyll-seo-tag (2.6.1)
3741
jekyll (>= 3.3, < 5.0)
3842
jekyll-watch (2.2.1)
3943
listen (~> 3.0)
40-
kramdown (2.1.0)
41-
kramdown-parser-gfm (1.1.0)
42-
kramdown (~> 2.0)
44+
kramdown (1.17.0)
4345
liquid (4.0.3)
4446
listen (3.2.1)
4547
rb-fsevent (~> 0.10, >= 0.10.3)
4648
rb-inotify (~> 0.9, >= 0.9.10)
4749
mercenary (0.3.6)
48-
minima (2.5.1)
49-
jekyll (>= 3.5, < 5.0)
50-
jekyll-feed (~> 0.9)
51-
jekyll-seo-tag (~> 2.1)
5250
pathutil (0.16.2)
5351
forwardable-extended (~> 2.6)
5452
public_suffix (4.0.3)
53+
rake (12.3.3)
5554
rb-fsevent (0.10.3)
5655
rb-inotify (0.10.1)
5756
ffi (~> 1.0)
5857
rouge (3.16.0)
5958
safe_yaml (1.0.5)
60-
sassc (2.2.1-x64-mingw32)
61-
ffi (~> 1.9)
62-
terminal-table (1.8.0)
63-
unicode-display_width (~> 1.1, >= 1.1.1)
64-
thread_safe (0.3.6)
65-
tzinfo (1.2.6)
66-
thread_safe (~> 0.1)
67-
tzinfo-data (1.2019.3)
68-
tzinfo (>= 1.0.0)
69-
unicode-display_width (1.6.1)
70-
wdm (0.1.1)
59+
sass (3.7.4)
60+
sass-listen (~> 4.0.0)
61+
sass-listen (4.0.0)
62+
rb-fsevent (~> 0.9, >= 0.9.4)
63+
rb-inotify (~> 0.9, >= 0.9.7)
7164

7265
PLATFORMS
7366
x64-mingw32
7467

7568
DEPENDENCIES
76-
jekyll (~> 4.0.0)
77-
jekyll-feed (~> 0.12)
78-
minima (~> 2.5)
79-
tzinfo (~> 1.2)
80-
tzinfo-data
81-
wdm (~> 0.1.1)
69+
bundler (~> 2.0.1)
70+
just-the-docs!
8271

8372
BUNDLED WITH
84-
2.1.4
73+
2.0.1

LICENSE

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2020 infar-buw
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

README.md

Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
1+
<p align="right">
2+
<a href="https://badge.fury.io/rb/just-the-docs"><img src="https://badge.fury.io/rb/just-the-docs.svg" alt="Gem version"></a> <a href="https://github.com/pmarsceill/just-the-docs/actions"><img src="https://github.com/pmarsceill/just-the-docs/workflows/CI/badge.svg" alt="Build status"></a>
3+
</p>
4+
<br><br>
5+
<p align="center">
6+
<h1 align="center">Just the Docs</h1>
7+
<p align="center">A modern, highly customizable, and responsive Jekyll theme for documentation with built-in search.<br>Easily hosted on GitHub Pages with few dependencies.</p>
8+
<p align="center"><strong><a href="https://pmarsceill.github.io/just-the-docs/">See it in action!</a></strong></p>
9+
<br><br><br>
10+
</p>
11+
12+
![jtd](https://user-images.githubusercontent.com/896475/47384541-89053c80-d6d5-11e8-98dc-dba16e192de9.gif)
13+
14+
## Installation
15+
16+
Add this line to your Jekyll site's Gemfile:
17+
18+
```ruby
19+
gem "just-the-docs"
20+
```
21+
22+
And add this line to your Jekyll site's `_config.yml`:
23+
24+
```yaml
25+
theme: just-the-docs
26+
```
27+
28+
And then execute:
29+
30+
$ bundle
31+
32+
Or install it yourself as:
33+
34+
$ gem install just-the-docs
35+
36+
## Usage
37+
38+
[View the documentation](https://pmarsceill.github.io/just-the-docs/) for usage information.
39+
40+
## Contributing
41+
42+
Bug reports and pull requests are welcome on GitHub at https://github.com/pmarsceill/just-the-docs. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
43+
44+
### Submitting code changes:
45+
46+
- Open a [Pull Request](https://github.com/pmarsceill/just-the-docs/pulls)
47+
- Ensure all CI tests pass
48+
- Await code review
49+
- Bump the version number in `just-the-docs.gemspec` and `package.json` according to [semantic versioning](https://semver.org/).
50+
51+
### Design and development principles of this theme:
52+
53+
1. As few dependencies as possible
54+
2. No build script needed
55+
3. First class mobile experience
56+
4. Make the content shine
57+
58+
## Development
59+
60+
To set up your environment to develop this theme, run `bundle install`.
61+
62+
Your theme is set up just like a normal Jekyll site! To test your theme, run `bundle exec jekyll serve` and open your browser at `http://localhost:4000`. This starts a Jekyll server using your theme. Add pages, documents, data, etc. like normal to test your theme's contents. As you make modifications to your theme and to your content, your site will regenerate and you should see the changes in the browser after a refresh, just like normal.
63+
64+
When the theme is released, only the files in `_layouts`, `_includes`, and `_sass` tracked with Git will be released.
65+
66+
## License
67+
68+
The theme is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

Rakefile

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
Dir.glob('lib/tasks/*.rake').each {|r| import r}

0 commit comments

Comments
 (0)