Compare commits

...

16 Commits

Author SHA1 Message Date
Patrick Marsceill
74693a0b2a Merge pull request #13 from pmarsceill/add-ci
Add CI for testing
2018-10-25 12:43:05 -04:00
Patrick Marsceill
6400e79e02 Update README.md 2018-10-25 11:22:11 -04:00
Patrick Marsceill
6a6efba27a fix linting / rules 2018-10-25 11:17:10 -04:00
Patrick Marsceill
d554236ba3 Update .travis.yml 2018-10-25 11:00:40 -04:00
Patrick Marsceill
6d14c454f1 Update package.json 2018-10-25 10:54:17 -04:00
Patrick Marsceill
9d51b4601c Update .travis.yml 2018-10-25 10:53:28 -04:00
Patrick Marsceill
62fc067441 Update .travis.yml 2018-10-25 10:53:03 -04:00
Patrick Marsceill
ea61589b12 Add travis yaml 2018-10-25 10:48:35 -04:00
Patrick Marsceill
89f9c5f38c Merge pull request #12 from jakebresnehan/patch-1
Update README.md
2018-10-25 10:41:21 -04:00
Jake Bresnehan
caf5311feb Update README.md 2018-10-25 18:40:36 +11:00
Patrick Marsceill
3a32d20f18 Merge pull request #11 from pmarsceill/rake-mkdir
rake search:init fails if dirs don't exist
2018-10-24 16:45:43 -04:00
Patrick Marsceill
651ed922b0 Just the Docs build packaging cleanup 2018-10-24 16:39:13 -04:00
Patrick Marsceill
64ed5ef369 Just the Docs build packaging 2018-10-24 16:39:13 -04:00
Patrick Marsceill
82e1873460 bump version number 2018-10-24 16:39:03 -04:00
Patrick Marsceill
46782d9352 Rake fails when dirs dont exist 2018-10-24 16:34:11 -04:00
Patrick Marsceill
d558234885 Merge pull request #10 from pmarsceill/rake-runtime
Rake runtime
2018-10-24 14:25:11 -04:00
10 changed files with 42 additions and 21 deletions

View File

@@ -1,4 +1,7 @@
{ {
"ignoreFiles" : [
"assets/css/just-the-docs.scss"
],
"extends": [ "extends": [
"stylelint-config-primer" "stylelint-config-primer"
] ]

13
.travis.yml Normal file
View 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

View File

@@ -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.
![jtd](https://user-images.githubusercontent.com/896475/47384541-89053c80-d6d5-11e8-98dc-dba16e192de9.gif) ![jtd](https://user-images.githubusercontent.com/896475/47384541-89053c80-d6d5-11e8-98dc-dba16e192de9.gif)
@@ -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).

View File

@@ -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;
} }

View File

@@ -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;

View File

@@ -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;

View File

@@ -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;
} }
} }

View File

@@ -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"]

View File

@@ -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 %}
}' }'

View File

@@ -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'"
}
} }