mirror of
https://github.com/snachodog/just-the-docs.git
synced 2025-09-16 14:23:31 -06:00
Compare commits
16 Commits
Author | SHA1 | Date | |
---|---|---|---|
|
74693a0b2a | ||
|
6400e79e02 | ||
|
6a6efba27a | ||
|
d554236ba3 | ||
|
6d14c454f1 | ||
|
9d51b4601c | ||
|
62fc067441 | ||
|
ea61589b12 | ||
|
89f9c5f38c | ||
|
caf5311feb | ||
|
3a32d20f18 | ||
|
651ed922b0 | ||
|
64ed5ef369 | ||
|
82e1873460 | ||
|
46782d9352 | ||
|
d558234885 |
@@ -1,4 +1,7 @@
|
|||||||
{
|
{
|
||||||
|
"ignoreFiles" : [
|
||||||
|
"assets/css/just-the-docs.scss"
|
||||||
|
],
|
||||||
"extends": [
|
"extends": [
|
||||||
"stylelint-config-primer"
|
"stylelint-config-primer"
|
||||||
]
|
]
|
||||||
|
13
.travis.yml
Normal file
13
.travis.yml
Normal file
@@ -0,0 +1,13 @@
|
|||||||
|
language: ruby
|
||||||
|
rvm:
|
||||||
|
- 2.3.0
|
||||||
|
env:
|
||||||
|
- TRAVIS_NODE_VERSION="9.3.0"
|
||||||
|
|
||||||
|
install:
|
||||||
|
- npm install
|
||||||
|
- bundle install
|
||||||
|
|
||||||
|
script:
|
||||||
|
- npm run test
|
||||||
|
- bundle exec jekyll build
|
19
README.md
19
README.md
@@ -1,6 +1,6 @@
|
|||||||
# Just the Docs
|
# Just the Docs
|
||||||
|
|
||||||
A nice looking, high customizable, responsive Jekyll theme for documention with built-in search. Easily hosted on GitHub pages.
|
A nice looking, high customizable, responsive Jekyll theme for documentation with built-in search. Easily hosted on GitHub pages.
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
@@ -35,6 +35,13 @@ Or install it yourself as:
|
|||||||
|
|
||||||
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.
|
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.
|
||||||
|
|
||||||
|
### Submitting code changes:
|
||||||
|
|
||||||
|
- Open a [Pull Request](https://github.com/pmarsceill/just-the-docs/pulls)
|
||||||
|
- Ensure all CI tests pass
|
||||||
|
- Await code review
|
||||||
|
- Bump the version number in `just-the-docs.gemspec` and `package.json` according to [semantic versioning](https://semver.org/).
|
||||||
|
|
||||||
## Development
|
## Development
|
||||||
|
|
||||||
To set up your environment to develop this theme, run `bundle install`.
|
To set up your environment to develop this theme, run `bundle install`.
|
||||||
@@ -43,16 +50,6 @@ Your theme is setup just like a normal Jekyll site! To test your theme, run `bun
|
|||||||
|
|
||||||
When the theme is released, only the files in `_layouts`, `_includes`, and `_sass` tracked with Git will be released.
|
When the theme is released, only the files in `_layouts`, `_includes`, and `_sass` tracked with Git will be released.
|
||||||
|
|
||||||
|
|
||||||
### When your changes are ready:
|
|
||||||
|
|
||||||
- Open a [Pull Request](https://github.com/pmarsceill/just-the-docs/pulls)
|
|
||||||
- Await code review
|
|
||||||
- Bump the version number in `just-the-docs.gemspec`
|
|
||||||
- Run `script/build` to package the gem
|
|
||||||
- Run `gem push just-the-docs-<version>.gem` to publish the gem to Rubygems.org
|
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
||||||
The theme is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
|
The theme is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
|
||||||
|
|
||||||
|
@@ -12,9 +12,9 @@
|
|||||||
margin-right: $sp-1;
|
margin-right: $sp-1;
|
||||||
margin-left: $sp-1;
|
margin-left: $sp-1;
|
||||||
color: $white;
|
color: $white;
|
||||||
|
text-transform: uppercase;
|
||||||
vertical-align: middle;
|
vertical-align: middle;
|
||||||
background-color: $blue-100;
|
background-color: $blue-100;
|
||||||
text-transform: uppercase;
|
|
||||||
@include fs-2;
|
@include fs-2;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@@ -115,6 +115,7 @@
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// stylelint-disable selector-no-type
|
||||||
body {
|
body {
|
||||||
position: relative;
|
position: relative;
|
||||||
padding-bottom: $sp-10;
|
padding-bottom: $sp-10;
|
||||||
@@ -124,6 +125,7 @@ body {
|
|||||||
padding-bottom: 0;
|
padding-bottom: 0;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
// stylelint-enable selector-no-type
|
||||||
|
|
||||||
.site-footer {
|
.site-footer {
|
||||||
position: absolute;
|
position: absolute;
|
||||||
|
@@ -11,9 +11,9 @@
|
|||||||
position: absolute;
|
position: absolute;
|
||||||
top: 0;
|
top: 0;
|
||||||
right: 0;
|
right: 0;
|
||||||
|
z-index: 101;
|
||||||
height: 60px;
|
height: 60px;
|
||||||
padding-top: $sp-4;
|
padding-top: $sp-4;
|
||||||
z-index: 101;
|
|
||||||
box-shadow: inset 0 -1px 0 $border-color;
|
box-shadow: inset 0 -1px 0 $border-color;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -89,7 +89,6 @@
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
.navigation-list-toggle {
|
.navigation-list-toggle {
|
||||||
position: absolute;
|
position: absolute;
|
||||||
right: $sp-4;
|
right: $sp-4;
|
||||||
|
@@ -15,20 +15,22 @@
|
|||||||
@media (min-width: rem($value)) {
|
@media (min-width: rem($value)) {
|
||||||
@content;
|
@content;
|
||||||
}
|
}
|
||||||
} @else {
|
}
|
||||||
|
|
||||||
|
@else {
|
||||||
@warn "No value could be retrieved from `#{$media-query}`. "
|
@warn "No value could be retrieved from `#{$media-query}`. "
|
||||||
+ "Please make sure it is defined in `$media-queries` map.";
|
+ "Please make sure it is defined in `$media-queries` map.";
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
// Responsive container
|
// Responsive container
|
||||||
|
|
||||||
@mixin container {
|
@mixin container {
|
||||||
padding-left: $gutter-spacing-sm;
|
|
||||||
padding-right: $gutter-spacing-sm;
|
padding-right: $gutter-spacing-sm;
|
||||||
|
padding-left: $gutter-spacing-sm;
|
||||||
|
|
||||||
@include mq(md) {
|
@include mq(md) {
|
||||||
padding-left: $gutter-spacing;
|
|
||||||
padding-right: $gutter-spacing;
|
padding-right: $gutter-spacing;
|
||||||
|
padding-left: $gutter-spacing;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
@@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
Gem::Specification.new do |spec|
|
Gem::Specification.new do |spec|
|
||||||
spec.name = "just-the-docs"
|
spec.name = "just-the-docs"
|
||||||
spec.version = "0.1.4"
|
spec.version = "0.1.5"
|
||||||
spec.authors = ["Patrick Marsceill"]
|
spec.authors = ["Patrick Marsceill"]
|
||||||
spec.email = ["patrick.marsceill@gmail.com"]
|
spec.email = ["patrick.marsceill@gmail.com"]
|
||||||
|
|
||||||
|
@@ -2,6 +2,7 @@ namespace :search do
|
|||||||
desc 'Generate the files needed for search functionality'
|
desc 'Generate the files needed for search functionality'
|
||||||
task :init do
|
task :init do
|
||||||
puts 'Creating search data json file...'
|
puts 'Creating search data json file...'
|
||||||
|
mkdir_p 'assets/js'
|
||||||
touch 'assets/js/search-data.json'
|
touch 'assets/js/search-data.json'
|
||||||
content = %Q[{{ page.content | markdownify | strip_html | xml_escape | remove: 'Table of contents' | strip_newlines | replace: '\\', ' ' }}]
|
content = %Q[{{ page.content | markdownify | strip_html | xml_escape | remove: 'Table of contents' | strip_newlines | replace: '\\', ' ' }}]
|
||||||
puts 'Done.'
|
puts 'Done.'
|
||||||
@@ -15,7 +16,8 @@ namespace :search do
|
|||||||
"id": "{{ forloop.index0 }}",
|
"id": "{{ forloop.index0 }}",
|
||||||
"title": "{{ page.title | xml_escape }}",
|
"title": "{{ page.title | xml_escape }}",
|
||||||
"content": "'+content+'",
|
"content": "'+content+'",
|
||||||
"url": "{{ page.url | xml_escape }}"
|
"url": "{{ page.url | absolute_url | xml_escape }}",
|
||||||
|
"relUrl": "{{ page.url | xml_escape }}"
|
||||||
}{% if forloop.last %}{% else %},
|
}{% if forloop.last %}{% else %},
|
||||||
{% endif %}{% endfor %}
|
{% endif %}{% endfor %}
|
||||||
}'
|
}'
|
||||||
|
@@ -10,5 +10,8 @@
|
|||||||
"stylelint": "^7.9.0",
|
"stylelint": "^7.9.0",
|
||||||
"stylelint-config-primer": "^1.4.0"
|
"stylelint-config-primer": "^1.4.0"
|
||||||
},
|
},
|
||||||
"dependencies": {}
|
"dependencies": {},
|
||||||
|
"scripts": {
|
||||||
|
"test": "stylelint '**/*.scss'"
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
Reference in New Issue
Block a user