Compare commits
2 Commits
bae65861e4
...
602795ad1e
| Author | SHA1 | Date |
|---|---|---|
 Saku Laesvuori
|
602795ad1e | |
|
Saku Laesvuori
|
50a0759a96 |
|
|
@ -1,16 +0,0 @@
|
|||
# editorconfig.org
|
||||
root = true
|
||||
|
||||
[*]
|
||||
indent_style = space
|
||||
indent_size = 2
|
||||
end_of_line = lf
|
||||
charset = utf-8
|
||||
trim_trailing_whitespace = true
|
||||
insert_final_newline = true
|
||||
|
||||
[*.md]
|
||||
trim_trailing_whitespace = false
|
||||
|
||||
[*.svg]
|
||||
trim_trailing_whitespace = false
|
||||
24
.eslintrc.js
24
.eslintrc.js
|
|
@ -1,24 +0,0 @@
|
|||
module.exports = {
|
||||
"env": {
|
||||
"browser": true
|
||||
},
|
||||
"extends": "eslint:recommended",
|
||||
"rules": {
|
||||
"indent": [
|
||||
"error",
|
||||
"tab"
|
||||
],
|
||||
"linebreak-style": [
|
||||
"error",
|
||||
"unix"
|
||||
],
|
||||
"quotes": [
|
||||
"error",
|
||||
"single"
|
||||
],
|
||||
"semi": [
|
||||
"error",
|
||||
"always"
|
||||
]
|
||||
}
|
||||
};
|
||||
|
|
@ -1,5 +0,0 @@
|
|||
_assets/css/vendor/* linguist-vendored
|
||||
_assets/js/plugins/* linguist-vendored
|
||||
_assets/js/vendor/* linguist-vendored
|
||||
assets/fonts/* linguist-vendored
|
||||
assets/js/vendor/* linguist-vendored
|
||||
|
|
@ -1,2 +0,0 @@
|
|||
github: mmistakes
|
||||
custom: ['https://www.paypal.me/mmistakes']
|
||||
|
|
@ -1,68 +0,0 @@
|
|||
---
|
||||
name: "Bug Report"
|
||||
about: "Is something not working as expected?"
|
||||
---
|
||||
|
||||
<!--
|
||||
Before opening a new issue please:
|
||||
|
||||
- Verify you have the latest versions of Jekyll and Basically Basic
|
||||
installed by running `bundle update`.
|
||||
- Thoroughly read the theme's documentation at
|
||||
https://github.com/mmistakes/jekyll-theme-basically-basic
|
||||
- Search all issues at https://github.com/mmistakes/jekyll-theme-basically-basic/issues
|
||||
for solutions and to avoid duplication.
|
||||
- Ask for help at https://talk.jekyllrb.com/
|
||||
|
||||
After exhausting these suggestions use the format below.
|
||||
-->
|
||||
|
||||
## Environment
|
||||
|
||||
<!--
|
||||
Please include theme version, Jekyll version, public git repository, whether
|
||||
you are hosting with GitHub Pages, and the operating system you tested with.
|
||||
|
||||
Issues without a link to a public repository or ZIP file will likely go ignored.
|
||||
Being able to see your actual files is necessary to troubleshoot, as most
|
||||
issues stem from invalid/missing YAML Front Matter, a mis-configured _config.sys
|
||||
file, or problematic site content.
|
||||
-->
|
||||
|
||||
- Basically Basic version:
|
||||
- Ruby gem or remote theme version:
|
||||
- Jekyll version:
|
||||
- Git repository URL:
|
||||
- GitHub Pages hosted (if yes provide URL to site):
|
||||
- Operating system:
|
||||
|
||||
## Expected behavior
|
||||
|
||||
<!--
|
||||
What is it you expected to happen? This should be a description of how the
|
||||
functionality you tried to use is supposed to work.
|
||||
-->
|
||||
|
||||
## Steps to reproduce the behavior
|
||||
|
||||
<!--
|
||||
Describe the steps you took for this problem to exist. Such as: you installed
|
||||
the theme, customized _config.yml, added your own posts, and started up a
|
||||
Jekyll server locally.
|
||||
|
||||
If an error occurred on GitHub Pages when pushing, please test a local version
|
||||
following these setup instructions:
|
||||
https://help.github.com/articles/setting-up-your-github-pages-site-locally-with-jekyll/
|
||||
|
||||
Then provide a complete log by running `bundle exec jekyll build --trace --verbose`
|
||||
and include this output in the filed issue.
|
||||
|
||||
Screenshots can also be included if they help illustrate a behavior.
|
||||
-->
|
||||
|
||||
## Other
|
||||
|
||||
<!--
|
||||
NOTE: Please provide a code repository, gist, code snippet, sample files,
|
||||
screenshots, or anything else you think will aid in reproducing the issue.
|
||||
-->
|
||||
|
|
@ -1,16 +0,0 @@
|
|||
---
|
||||
name: "Documentation"
|
||||
about: "Found a typo or something that needs clarification?"
|
||||
---
|
||||
|
||||
<!-- Thanks for taking the time to open an issue and help make the docs better -->
|
||||
|
||||
## Motivation
|
||||
|
||||
<!-- Why should we update our docs? -->
|
||||
|
||||
<!-- What should we do instead? -->
|
||||
|
||||
## Suggestion
|
||||
|
||||
<!-- What should we do instead? -->
|
||||
|
|
@ -1,26 +0,0 @@
|
|||
<!--
|
||||
Thanks for creating a Pull Request! Before you submit, please make sure
|
||||
you've done the following:
|
||||
|
||||
- Read the contributing document at https://github.com/mmistakes/jekyll-theme-basically-basic#contributing
|
||||
-->
|
||||
|
||||
<!--
|
||||
Choose one of the following by uncommenting it:
|
||||
-->
|
||||
|
||||
<!-- This is a bug fix. -->
|
||||
<!-- This is an enhancement or feature. -->
|
||||
<!-- This is a documentation change. -->
|
||||
|
||||
## Summary
|
||||
|
||||
<!--
|
||||
Provide a description of what your pull request changes.
|
||||
-->
|
||||
|
||||
## Context
|
||||
|
||||
<!--
|
||||
Is this related to any GitHub issue(s)?
|
||||
-->
|
||||
262
.scss-lint.yml
262
.scss-lint.yml
|
|
@ -1,262 +0,0 @@
|
|||
# Default application configuration that all configurations inherit from.
|
||||
|
||||
scss_files: "_sass/**/*.scss"
|
||||
exclude:
|
||||
- "_sass/basically-basic/_reset.scss"
|
||||
- "_sass/basically-basic/vendor/**"
|
||||
plugin_directories: ['.scss-linters']
|
||||
|
||||
# List of gem names to load custom linters from (make sure they are already
|
||||
# installed)
|
||||
plugin_gems: []
|
||||
|
||||
# Default severity of all linters.
|
||||
severity: warning
|
||||
|
||||
linters:
|
||||
BangFormat:
|
||||
enabled: true
|
||||
space_before_bang: true
|
||||
space_after_bang: false
|
||||
|
||||
BemDepth:
|
||||
enabled: false
|
||||
max_elements: 1
|
||||
|
||||
BorderZero:
|
||||
enabled: false
|
||||
convention: zero # or `none`
|
||||
|
||||
ChainedClasses:
|
||||
enabled: false
|
||||
|
||||
ColorKeyword:
|
||||
enabled: true
|
||||
|
||||
ColorVariable:
|
||||
enabled: false
|
||||
|
||||
Comment:
|
||||
enabled: false
|
||||
style: silent
|
||||
|
||||
DebugStatement:
|
||||
enabled: true
|
||||
|
||||
DeclarationOrder:
|
||||
enabled: true
|
||||
|
||||
DisableLinterReason:
|
||||
enabled: false
|
||||
|
||||
DuplicateProperty:
|
||||
enabled: true
|
||||
|
||||
ElsePlacement:
|
||||
enabled: true
|
||||
style: same_line # or 'new_line'
|
||||
|
||||
EmptyLineBetweenBlocks:
|
||||
enabled: true
|
||||
ignore_single_line_blocks: true
|
||||
|
||||
EmptyRule:
|
||||
enabled: true
|
||||
|
||||
ExtendDirective:
|
||||
enabled: false
|
||||
|
||||
FinalNewline:
|
||||
enabled: true
|
||||
present: true
|
||||
|
||||
HexLength:
|
||||
enabled: true
|
||||
style: short # or 'long'
|
||||
|
||||
HexNotation:
|
||||
enabled: true
|
||||
style: lowercase # or 'uppercase'
|
||||
|
||||
HexValidation:
|
||||
enabled: true
|
||||
|
||||
IdSelector:
|
||||
enabled: true
|
||||
|
||||
ImportantRule:
|
||||
enabled: false
|
||||
|
||||
ImportPath:
|
||||
enabled: true
|
||||
leading_underscore: false
|
||||
filename_extension: false
|
||||
|
||||
Indentation:
|
||||
enabled: true
|
||||
allow_non_nested_indentation: false
|
||||
character: space # or 'tab'
|
||||
width: 2
|
||||
|
||||
LeadingZero:
|
||||
enabled: true
|
||||
style: include_zero # or 'exclude_zero'
|
||||
|
||||
MergeableSelector:
|
||||
enabled: true
|
||||
force_nesting: true
|
||||
|
||||
NameFormat:
|
||||
enabled: true
|
||||
allow_leading_underscore: true
|
||||
convention: hyphenated_lowercase # or 'camel_case', or 'snake_case', or a regex pattern
|
||||
|
||||
NestingDepth:
|
||||
enabled: false
|
||||
max_depth: 3
|
||||
ignore_parent_selectors: false
|
||||
|
||||
PlaceholderInExtend:
|
||||
enabled: true
|
||||
|
||||
PrivateNamingConvention:
|
||||
enabled: false
|
||||
prefix: _
|
||||
|
||||
PropertyCount:
|
||||
enabled: false
|
||||
include_nested: false
|
||||
max_properties: 10
|
||||
|
||||
PropertySortOrder:
|
||||
enabled: true
|
||||
order: smacss
|
||||
ignore_unspecified: true
|
||||
min_properties: 2
|
||||
separate_groups: false
|
||||
|
||||
PropertySpelling:
|
||||
enabled: true
|
||||
extra_properties: []
|
||||
disabled_properties: []
|
||||
|
||||
PropertyUnits:
|
||||
enabled: true
|
||||
global: [
|
||||
'ch', 'em', 'ex', 'rem', # Font-relative lengths
|
||||
'cm', 'in', 'mm', 'pc', 'pt', 'px', 'q', # Absolute lengths
|
||||
'vh', 'vw', 'vmin', 'vmax', # Viewport-percentage lengths
|
||||
'deg', 'grad', 'rad', 'turn', # Angle
|
||||
'ms', 's', # Duration
|
||||
'Hz', 'kHz', # Frequency
|
||||
'dpi', 'dpcm', 'dppx', # Resolution
|
||||
'%'] # Other
|
||||
properties: {}
|
||||
|
||||
PseudoElement:
|
||||
enabled: true
|
||||
|
||||
QualifyingElement:
|
||||
enabled: false
|
||||
allow_element_with_attribute: true
|
||||
allow_element_with_class: false
|
||||
allow_element_with_id: false
|
||||
|
||||
SelectorDepth:
|
||||
enabled: false
|
||||
max_depth: 3
|
||||
|
||||
SelectorFormat:
|
||||
enabled: true
|
||||
convention: hyphenated_lowercase # or 'strict_BEM', or 'hyphenated_BEM', or 'snake_case', or 'camel_case', or a regex pattern
|
||||
|
||||
Shorthand:
|
||||
enabled: true
|
||||
allowed_shorthands: [1, 2, 3, 4]
|
||||
|
||||
SingleLinePerProperty:
|
||||
enabled: true
|
||||
allow_single_line_rule_sets: true
|
||||
|
||||
SingleLinePerSelector:
|
||||
enabled: true
|
||||
|
||||
SpaceAfterComma:
|
||||
enabled: true
|
||||
style: one_space # or 'no_space', or 'at_least_one_space'
|
||||
|
||||
SpaceAfterComment:
|
||||
enabled: false
|
||||
style: one_space # or 'no_space', or 'at_least_one_space'
|
||||
allow_empty_comments: true
|
||||
|
||||
SpaceAfterPropertyColon:
|
||||
enabled: true
|
||||
style: one_space # or 'no_space', or 'at_least_one_space', or 'aligned'
|
||||
|
||||
SpaceAfterPropertyName:
|
||||
enabled: true
|
||||
|
||||
SpaceAfterVariableColon:
|
||||
enabled: true
|
||||
style: one_space # or 'no_space', 'at_least_one_space' or 'one_space_or_newline'
|
||||
|
||||
SpaceAfterVariableName:
|
||||
enabled: true
|
||||
|
||||
SpaceAroundOperator:
|
||||
enabled: true
|
||||
style: one_space # or 'at_least_one_space', or 'no_space'
|
||||
|
||||
SpaceBeforeBrace:
|
||||
enabled: true
|
||||
style: space # or 'new_line'
|
||||
allow_single_line_padding: false
|
||||
|
||||
SpaceBetweenParens:
|
||||
enabled: true
|
||||
spaces: 0
|
||||
|
||||
StringQuotes:
|
||||
enabled: true
|
||||
style: single_quotes # or double_quotes
|
||||
|
||||
TrailingSemicolon:
|
||||
enabled: true
|
||||
|
||||
TrailingWhitespace:
|
||||
enabled: true
|
||||
|
||||
TrailingZero:
|
||||
enabled: false
|
||||
|
||||
TransitionAll:
|
||||
enabled: false
|
||||
|
||||
UnnecessaryMantissa:
|
||||
enabled: true
|
||||
|
||||
UnnecessaryParentReference:
|
||||
enabled: true
|
||||
|
||||
UrlFormat:
|
||||
enabled: true
|
||||
|
||||
UrlQuotes:
|
||||
enabled: true
|
||||
|
||||
VariableForProperty:
|
||||
enabled: false
|
||||
properties: []
|
||||
|
||||
VendorPrefix:
|
||||
enabled: false
|
||||
identifier_list: base
|
||||
additional_identifiers: []
|
||||
excluded_identifiers: []
|
||||
|
||||
ZeroUnit:
|
||||
enabled: true
|
||||
|
||||
Compass::*:
|
||||
enabled: false
|
||||
159
CHANGELOG.md
159
CHANGELOG.md
|
|
@ -1,159 +0,0 @@
|
|||
# Change Log
|
||||
|
||||
All notable changes to this project will be documented in this file.
|
||||
|
||||
The format is based on [Keep a Changelog](http://keepachangelog.com/)
|
||||
and this project adheres to [Semantic Versioning](http://semver.org/).
|
||||
|
||||
## [1.4.5] - 2021-07-05
|
||||
|
||||
## Added
|
||||
- Add translation keys for CV layout. [#145](https://github.com/mmistakes/jekyll-theme-basically-basic/pull/145)
|
||||
- Display 'Posts' header only if the site has posts. [#144](https://github.com/mmistakes/jekyll-theme-basically-basic/pull/144)
|
||||
|
||||
## Changed
|
||||
- Improve remote theme upgrading documentation.
|
||||
- Simplify image assigns.
|
||||
### Fixed
|
||||
- Fix to use current `bundle info` syntax. [#127](https://github.com/mmistakes/jekyll-theme-basically-basic/pull/127)
|
||||
- Add `relative_url` filter to author profile image. [#125](https://github.com/mmistakes/jekyll-theme-basically-basic/issues/125)
|
||||
- Fix rake vulnerability in `.gemspec` file.
|
||||
|
||||
## [1.4.4] - 2019-08-20
|
||||
|
||||
### Fixed
|
||||
- Fix MIME-type issues with Lunr search by renaming `search-data.json` to `lunr/lunr.store.js`. [#82](https://github.com/mmistakes/jekyll-theme-basically-basic/issues/82)
|
||||
|
||||
## [1.4.3] - 2019-08-20
|
||||
|
||||
### Changed
|
||||
- Relax Jekyll dependency to allow for version 4.0.
|
||||
|
||||
## [1.4.2] - 2019-07-18
|
||||
|
||||
### Added
|
||||
- Document `site.copyright` override for customizing footer copyright text.
|
||||
|
||||
### Changed
|
||||
- Update links to LICENSE. [#102](https://github.com/mmistakes/jekyll-theme-basically-basic/pull/102)
|
||||
- Update GitHub issue templates.
|
||||
|
||||
### Fixed
|
||||
- Fix theme text strings for `search_placeholder_text` and `results_found`. [#104](https://github.com/mmistakes/jekyll-theme-basically-basic/issues/104)
|
||||
- Remove stray `console.log` from lunr-search-scripts [#105](https://github.com/mmistakes/jekyll-theme-basically-basic/pull/105)
|
||||
- Add missing `/` in icon-gitlab.html. [#80](https://github.com/mmistakes/jekyll-theme-basically-basic/pull/80)
|
||||
|
||||
## [1.4.1] - 2018-08-07
|
||||
|
||||
### Added
|
||||
- Add sample "404 not found page" to `/docs/404.html` and `/example/404.html`. [#12](https://github.com/mmistakes/jekyll-theme-basically-basic/issues/12)
|
||||
|
||||
### Changed
|
||||
- Adjust default skin colors to meet WCAG 2 AA. [#68](https://github.com/mmistakes/jekyll-theme-basically-basic/pull/68)
|
||||
|
||||
### Fixed
|
||||
- Remove extra footer from cv.html `layout`. [#69](https://github.com/mmistakes/jekyll-theme-basically-basic/pull/69)
|
||||
- Fix JavaScript error when search is not enabled. [#66](https://github.com/mmistakes/jekyll-theme-basically-basic/pull/66)
|
||||
|
||||
## [1.4.0] - 2018-04-02
|
||||
|
||||
### Changed
|
||||
- Lint JavaScript.
|
||||
- Update gemspec to use jekyll-seo-tag version `2.4`. [#47](https://github.com/mmistakes/jekyll-theme-basically-basic/pull/47)
|
||||
|
||||
### Added
|
||||
- Accessibility enhancements for Lunr search form.
|
||||
- Add SCSS `$intro-image-color-overlay` variable to enable color overlay on hero images (disabled by default). [#55](https://github.com/mmistakes/jekyll-theme-basically-basic/issues/55)
|
||||
- Add new archive layouts: `posts`, `categories`, `category`, `collection`, `tag`, and `tags`.
|
||||
- Add grid layout via `entries_layout: grid` front matter.
|
||||
- Add support for image thumbnails vial `image.thumbnail` front matter.
|
||||
|
||||
### Fixed
|
||||
- Fix Firefox [flexbox bug](https://bugzilla.mozilla.org/show_bug.cgi?id=939897) when printing pages.
|
||||
- Fix search excerpts that run together because of implied spaces.
|
||||
- Moved `<footer>` outside of `<main>` to be semantically correct.
|
||||
|
||||
## [1.3.1] - 2018-02-16
|
||||
|
||||
### Changed
|
||||
- Only include jQuery when using default Lunr search. [#49](https://github.com/mmistakes/jekyll-theme-basically-basic/issues/49)
|
||||
|
||||
### Fixed
|
||||
- Focus on search input after clicking on toggle.
|
||||
|
||||
## [1.3.0] - 2018-02-16
|
||||
|
||||
### Added
|
||||
- Add jQuery script.
|
||||
- Add site-wide search toggle.
|
||||
- Add support for [Lunr](https://lunrjs.com/) search. [#48](https://github.com/mmistakes/jekyll-theme-basically-basic/pull/48)
|
||||
- Add support for [Algolia](https://www.algolia.com/) search. [#48](https://github.com/mmistakes/jekyll-theme-basically-basic/pull/48)
|
||||
- Add [Algolia search demo](https://mmistakes.github.io/jekyll-theme-basically-basic-algolia-search/).
|
||||
|
||||
### Changed
|
||||
- New installation and upgrade instructions.
|
||||
- Absolutely position navigation menu instead of sticking it to the top.
|
||||
- Visually hide "Menu" label.
|
||||
- Improve alignment of menu toggle when search is enabled.
|
||||
|
||||
### Fixed
|
||||
- Fix `border-bottom` for Gist line numbers.
|
||||
|
||||
## [1.2.0] - 2018-01-05
|
||||
|
||||
### Added
|
||||
- Use [jekyll-remote-theme](https://github.com/benbalter/jekyll-remote-theme) for demo site.
|
||||
|
||||
### Changed
|
||||
- Update GitHub Pages compatible installation instructions to include jekyll-remote-theme method.
|
||||
- Update `site.gems` references to `site.plugins`. [#39](https://github.com/mmistakes/jekyll-theme-basically-basic/pull/39)
|
||||
- Update license and copyright.
|
||||
- Improve syntax highlighting styles and colors.
|
||||
|
||||
### Fixed
|
||||
- Fix primary navigation skip link to use correct anchor ID. [#41](https://github.com/mmistakes/jekyll-theme-basically-basic/pull/41)
|
||||
- Fix Susy deprecation warnings by updating to version 3. [#21](https://github.com/mmistakes/jekyll-theme-basically-basic/issues/21)
|
||||
|
||||
## [1.1.3] - 2017-10-19
|
||||
|
||||
### Fixed
|
||||
- Fix `{nil, "picture"=>nil"}` in `_layouts/about.html` when author image isn't set. [#34](https://github.com/mmistakes/jekyll-theme-basically-basic/issues/34)
|
||||
|
||||
## [1.1.2] - 2017-09-14
|
||||
|
||||
### Fixed
|
||||
- Adjust `/_sass/_print.scss` to reduce blank pages when printing in Chrome. [#29](https://github.com/mmistakes/jekyll-theme-basically-basic/issues/29)
|
||||
- Fix sidebar visibility bug in Firefox and Safari by adding toggling `visibility: hidden`. [#31](https://github.com/mmistakes/jekyll-theme-basically-basic/issues/31)
|
||||
|
||||
## [1.1.1] - 2017-09-06
|
||||
|
||||
### Changed
|
||||
- Change `gems` key in `_config.yml` to `plugins`. [#23](https://github.com/mmistakes/jekyll-theme-basically-basic/pull/23)
|
||||
|
||||
### Fixed
|
||||
- Fix Liquid syntax error: "Expected id but found end_of_string_in `cv.skills.`" in `/cv/skills.html` include.
|
||||
|
||||
## [1.1.0] - 2017-03-30
|
||||
|
||||
### Added
|
||||
- Improve installation documentation. [#8](https://github.com/mmistakes/jekyll-theme-basically-basic/issues/8)
|
||||
- Add Google Analytics tracking ID, Disqus comments, to `/docs` demo site.
|
||||
|
||||
### Changed
|
||||
- Change source order of `.sidebar` and `.canvas` so menu items can easily be "tabbed" to. [#10](https://github.com/mmistakes/jekyll-theme-basically-basic/issues/10)
|
||||
- Refactor sidebar off-canvas menu and improve animation. [#9](https://github.com/mmistakes/jekyll-theme-basically-basic/issues/9) [#15](https://github.com/mmistakes/jekyll-theme-basically-basic/issues/15)
|
||||
- Remove tinted background from `<th>` elements.
|
||||
- Update permalink structure of `/docs` demo site.
|
||||
|
||||
### Fixed
|
||||
- Fix `body` height and `.wrapper` box shadow. [#13](https://github.com/mmistakes/jekyll-theme-basically-basic/issues/13)
|
||||
- Fix unclickable main content links in Internet Explorer 10. [#9](https://github.com/mmistakes/jekyll-theme-basically-basic/issues/9)
|
||||
|
||||
## [1.0.1] - 2017-03-23
|
||||
|
||||
### Added
|
||||
- New responsive embed helper classes for videos. [#2](https://github.com/mmistakes/jekyll-theme-basically-basic/issues/2)
|
||||
- New print styles for improved readability of printed pages. [#4](https://github.com/mmistakes/jekyll-theme-basically-basic/pull/4)
|
||||
- Icon list to README.
|
||||
|
||||
## [1.0.0] - 2017-03-20
|
||||
994
README.md
994
README.md
|
|
@ -1,987 +1,15 @@
|
|||
# [Basically Basic Jekyll Theme][1]
|
||||
# [Datat.fi](https://datat.fi)
|
||||
|
||||
[](https://github.com/mmistakes/jekyll-theme-basically-basic/blob/master/LICENSE)
|
||||
[](https://jekyllrb.com/)
|
||||
[](https://rubygems.org/gems/jekyll-theme-basically-basic)
|
||||
[](https://www.paypal.me/mmistakes)
|
||||
[](https://www.buymeacoffee.com/mmistakes)
|
||||
Tämä Git-tietovarasto sisältää [datat.fi](https://datat.fi)-sivun
|
||||
"lähdekoodin", eli sivun tuottamiseen käytettävät
|
||||
[markdown](https://www.markdownguide.org)-tiedostot sekä [basically
|
||||
basic](https://mmistakes.github.io/jekyll-theme-basically-basic/)
|
||||
-Jekyll-teeman. Nettisivut päivitetään automaattisesti vastaamaan uusinta
|
||||
versiota `main`-kehityshaarasta.
|
||||
|
||||
Basically Basic is a [Jekyll theme](https://jekyllrb.com/docs/themes/) meant as
|
||||
a substitute for the default [Minima](https://github.com/jekyll/minima), with a
|
||||
few enhancements thrown in for good measure:
|
||||
Muutoksia nettisivuille voi ehdottaa Gitean issues- ja pull requests
|
||||
-toiminnoilla sekä lähettämällä muutosehdotuksia sähköpostilla osoitteeseen
|
||||
<saku@laesvuori.fi> käyttäen komentoa `git send-email`. Kirjoitusoikeuden
|
||||
tietovarastoon voi saada hallitukselta tai ylläpitäjiltä.
|
||||
|
||||
- Clean responsive design with [six customizable skins](#skin)
|
||||
- Curriculum Vitæ/Resume layout powered by [JSON data](http://registry.jsonresume.org/)
|
||||
- About page layout
|
||||
- Site-wide search provided by [Algolia](https://www.algolia.com/) or [Lunr](https://lunrjs.com/).
|
||||
- Disqus Comments and Google Analytics support
|
||||
- SEO best practices via [Jekyll SEO Tag](https://github.com/jekyll/jekyll-seo-tag/)
|
||||
|
||||
**If you enjoy this theme, please consider sponsoring:**
|
||||
|
||||
[](https://www.buymeacoffee.com/mmistakes)
|
||||
[](https://www.paypal.me/mmistakes)
|
||||
|
||||
[![Basically Basic live preview][2]][1]
|
||||
|
||||
[1]: https://mmistakes.github.io/jekyll-theme-basically-basic/
|
||||
[2]: https://cloud.githubusercontent.com/assets/1376749/24117647/6dede894-0d81-11e7-9c2c-f19bea45e219.jpg (live preview)
|
||||
|
||||
## Installation
|
||||
|
||||
If you're running Jekyll v3.5+ and self-hosting you can quickly install the
|
||||
theme as a Ruby gem. If you're hosting with GitHub Pages you can install as a
|
||||
remote theme or directly copy all of the theme files (see [structure](#structure)
|
||||
below) into your project.
|
||||
|
||||
### Ruby Gem Method
|
||||
|
||||
1. Add this line to your Jekyll site's `Gemfile`:
|
||||
|
||||
```ruby
|
||||
gem "jekyll-theme-basically-basic"
|
||||
```
|
||||
2. Add this line to your Jekyll site's `_config.yml` file:
|
||||
|
||||
```yaml
|
||||
theme: jekyll-theme-basically-basic
|
||||
```
|
||||
|
||||
2. Then run [Bundler](http://bundler.io/) to install the theme gem and dependencies:
|
||||
|
||||
```terminal
|
||||
bundle install
|
||||
```
|
||||
|
||||
### GitHub Pages Method
|
||||
|
||||
GitHub Pages has added [full support](https://github.com/blog/2464-use-any-theme-with-github-pages)
|
||||
for any GitHub-hosted theme.
|
||||
|
||||
1. Replace `gem "jekyll"` with:
|
||||
|
||||
```ruby
|
||||
gem "github-pages", group: :jekyll_plugins
|
||||
```
|
||||
|
||||
2. Run `bundle update` and verify that all gems install properly.
|
||||
|
||||
3. Add `remote_theme: "mmistakes/jekyll-theme-basically-basic@1.4.5"` to your
|
||||
`_config.yml` file. Remove any other `theme:` or `remote_theme:` entries.
|
||||
|
||||
---
|
||||
|
||||
**Note:** Your Jekyll site should be viewable immediately at
|
||||
<http://USERNAME.github.io>. If it's not, you can force a rebuild by
|
||||
**Customizing Your Site** (see below for more details).
|
||||
|
||||
If you're hosting several Jekyll based sites under the same GitHub username you
|
||||
will have to use Project Pages instead of User Pages. Essentially you rename the
|
||||
repo to something other than **USERNAME.github.io** and create a `gh-pages`
|
||||
branch off of `master`. For more details on how to set things up check
|
||||
[GitHub's documentation](https://help.github.com/articles/user-organization-and-project-pages/).
|
||||
|
||||
#### Remove the Unnecessary
|
||||
|
||||
If you forked or downloaded the `jekyll-theme-basically-basic` repo you can
|
||||
safely remove the following files and folders:
|
||||
|
||||
- `.editorconfig`
|
||||
- `.gitattributes`
|
||||
- `.github`
|
||||
- `.scss-lint.yml`
|
||||
- `CHANGELOG.md`
|
||||
- `jekyll-theme-basically-basic.gemspec`
|
||||
- `LICENSE`
|
||||
- `Rakefile`
|
||||
- `README.md`
|
||||
- `screenshot.png`
|
||||
- `/docs`
|
||||
- `/example`
|
||||
|
||||
## Upgrading
|
||||
|
||||
If you're using the Ruby Gem or remote theme versions of Basically Basic,
|
||||
upgrading is fairly painless.
|
||||
|
||||
To check which version you are currently using, view the source of your built
|
||||
site and you should something similar to:
|
||||
|
||||
```
|
||||
<!--
|
||||
Basically Basic Jekyll Theme 1.4.5
|
||||
Copyright 2017-2018 Michael Rose - mademistakes.com | @mmistakes
|
||||
Free for personal and commercial use under the MIT license
|
||||
https://github.com/mmistakes/jekyll-basically-theme/blob/master/LICENSE
|
||||
-->
|
||||
```
|
||||
|
||||
At the top of every `.html` file, `/assets/css/main.css`, and `/assets/js/main.js`.
|
||||
|
||||
### Ruby Gem
|
||||
|
||||
Simply run `bundle update` if you're using Bundler (have a `Gemfile`) or `gem
|
||||
update jekyll-theme-basically-basic` if you're not.
|
||||
|
||||
### Remote Theme
|
||||
|
||||
Verify you have the [latest version](https://github.com/mmistakes/jekyll-theme-basically-basic/releases) assigned in `_config.yml`
|
||||
|
||||
```
|
||||
remote_theme: "mmistakes/jekyll-theme-basically-basic@1.4.5"
|
||||
```
|
||||
|
||||
Note: If `@x.x.x` is omitted the theme's current `master` branch will be used. It is advised to ["lock" `remote_theme`](https://github.com/benbalter/jekyll-remote-theme#declaring-your-theme) at a specific version to avoid introducing breaking changes to your site.
|
||||
|
||||
The next step requires rebuilding your [GitHub Pages](https://pages.github.com/) site so it can pull down the latest theme updates. This can be achieved by pushing up a commit to your GitHub repo.
|
||||
|
||||
An empty commit will get the job done too if you don't have anything to push at the moment:
|
||||
|
||||
```terminal
|
||||
git commit --allow-empty -m "Force rebuild of site"
|
||||
```
|
||||
|
||||
### Use Git
|
||||
|
||||
If you want to get the most out of the Jekyll + GitHub Pages workflow, then
|
||||
you'll need to utilize Git. To pull down theme updates you must first ensure
|
||||
there's an upstream remote. If you forked the theme's repo then you're likely
|
||||
good to go.
|
||||
|
||||
To double check, run `git remote -v` and verify that you can fetch from `origin https://github.com/mmistakes/jekyll-theme-basically-basic.git`.
|
||||
|
||||
To add it you can do the following:
|
||||
|
||||
```terminal
|
||||
git remote add upstream https://github.com/mmistakes/jekyll-theme-basically-basic.git
|
||||
```
|
||||
|
||||
#### Pull Down Updates
|
||||
|
||||
Now you can pull any commits made to theme's `master` branch with:
|
||||
|
||||
```terminal
|
||||
git pull upstream master
|
||||
```
|
||||
|
||||
Depending on the amount of customizations you've made after forking, there's
|
||||
likely to be merge conflicts. Work through any conflicting files Git flags,
|
||||
staging the changes you wish to keep, and then commit them.
|
||||
|
||||
### Update Files Manually
|
||||
|
||||
Another way of dealing with updates is [downloading the theme](https://github.com/mmistakes/jekyll-theme-basically-basic/archive/master.zip)
|
||||
--- replacing your layouts, includes, and assets with the newer ones manually.
|
||||
To be sure that you don't miss any changes it's probably a good idea to review
|
||||
the theme's [commit history](https://github.com/mmistakes/jekyll-theme-basically-basic/commits/master)
|
||||
to see what's changed since.
|
||||
|
||||
Here's a quick checklist of the important folders/files you'll want to be
|
||||
mindful of:
|
||||
|
||||
| Name | |
|
||||
| ---- | --- |
|
||||
| `_layouts` | Replace all. Apply edits if you customized any layouts. |
|
||||
| `_includes` | Replace all. Apply edits if you customized any includes. |
|
||||
| `assets` | Replace all. Apply edits if you customized stylesheets or scripts. |
|
||||
| `_sass` | Replace all. Apply edits if you customized Sass partials. |
|
||||
| `_data/theme.yml` | Safe to keep. Verify that there were no major structural changes or additions. |
|
||||
| `_config.yml` | Safe to keep. Verify that there were no major structural changes or additions. |
|
||||
|
||||
---
|
||||
|
||||
**Note:** If you're not seeing the latest version, be sure to flush browser and
|
||||
CDN caches. Depending on your hosting environment older versions of
|
||||
`/assets/css/main.css`, `/assets/js/main.js`, or `*.html` may be cached.
|
||||
|
||||
## Structure
|
||||
|
||||
Layouts, includes, Sass partials, and data files are all placed in their default
|
||||
locations. Stylesheets and scripts in `assets`, and a few development related
|
||||
files in the project's root directory.
|
||||
|
||||
**Please note:** If you installed Basically Basic via the Ruby Gem method, theme
|
||||
files found in `/_layouts`, `/_includes`, `/_sass`, and `/assets` will be
|
||||
missing. This is normal as they are bundled with the [`jekyll-theme-basically-basic`](https://rubygems.org/gems/jekyll-theme-basically-basic) gem.
|
||||
|
||||
```terminal
|
||||
jekyll-theme-basically-basic
|
||||
├── _data # data files
|
||||
| └── theme.yml # theme settings and custom text
|
||||
├── _includes # theme includes and SVG icons
|
||||
├── _layouts # theme layouts (see below for details)
|
||||
├── _sass # Sass partials
|
||||
├── assets
|
||||
| ├── javascripts
|
||||
| | └── main.js
|
||||
| └── stylesheets
|
||||
| └── main.scss
|
||||
├── _config.yml # sample configuration
|
||||
└── index.md # sample home page (all posts/not paginated)
|
||||
```
|
||||
|
||||
### Starting Fresh
|
||||
|
||||
After creating a `Gemfile` and installing the theme you'll need to add and edit
|
||||
the following files:
|
||||
|
||||
- [`_config.yml`](_config.yml)
|
||||
- [`/_data/theme.yml`](_data/theme.yml)
|
||||
- [`index.md`](index.md)
|
||||
|
||||
**Note:** Consult the [**pagination**](#pagination) documentation below for
|
||||
instructions on how to enable it for the home page.
|
||||
|
||||
### Starting from `jekyll new`
|
||||
|
||||
Using the `jekyll new` command will get you up and running the quickest.
|
||||
|
||||
Edit `_config.yml` and create `_data/theme.yml` as instructed above and you're
|
||||
good to go.
|
||||
|
||||
## Configuration
|
||||
|
||||
Configuration of site-wide elements (`lang`, `title`, `description`, `logo`,
|
||||
`author`, etc.) happens in your project's `_config.yml`. See the
|
||||
[example configuration](example/_config.yml) in this repo for additional
|
||||
reference.
|
||||
|
||||
| | Description |
|
||||
| ------------------ | ------------------------------------------------------------------------- |
|
||||
| `lang` | Used to indicate the language of text (e.g., en-US, en-GB, fr) |
|
||||
| `title` | Your site's title (e.g., Dungan's Awesome Site) |
|
||||
| `description` | Short site description (e.g., A blog about grasshopper mash) |
|
||||
| `url` | The full URL to your site (e.g., https://groverloaf.org) |
|
||||
| `author` | Global author information (see below) |
|
||||
| `logo` | Path to a site-wide logo ~100x100px (e.g., /assets/your-company-logo.png) |
|
||||
| `twitter_username` | Site-wide Twitter username, used as a link in sidebar |
|
||||
| `github_username` | Site-wide GitHub username, used as a link in sidebar |
|
||||
|
||||
For more configuration options be sure to consult the documentation for:
|
||||
[**jekyll-seo-tag**][jekyll-seo-tag], [**jekyll-feed**][jekyll-feed],
|
||||
[**jekyll-paginate**][jekyll-paginate], and [**jekyll-sitemap**][jekyll-sitemap].
|
||||
|
||||
[jekyll-seo-tag]: https://github.com/jekyll/jekyll-seo-tag
|
||||
[jekyll-feed]: https://github.com/jekyll/jekyll-feed
|
||||
[jekyll-paginate]: https://github.com/jekyll/jekyll-paginate
|
||||
[jekyll-sitemap]: https://github.com/jekyll/jekyll-sitemap
|
||||
|
||||
### Skin
|
||||
|
||||
This theme comes in six different skins (color variations). To change skins add
|
||||
one of the following to your [`/_data/theme.yml`](_data/theme.yml) file:
|
||||
|
||||
| `skin: default` | `skin: night` | `skin: plum` |
|
||||
| --- | --- | --- |
|
||||
|  |  |  |
|
||||
|
||||
| `skin: sea` | `skin: soft` | `skin: steel` |
|
||||
| --- | --- | --- |
|
||||
|  |  |  |
|
||||
|
||||
### Google Fonts
|
||||
|
||||
This theme allows you to easily use [Google Fonts](https://fonts.google.com/)
|
||||
throughout the theme. Simply add the following to your
|
||||
[`/_data/theme.yml`](_data/theme.yml), replacing the font `name` and `weights`
|
||||
accordingly.
|
||||
|
||||
```yaml
|
||||
google_fonts:
|
||||
- name: "Fira Sans"
|
||||
weights: "400,400i,600,600i"
|
||||
- name: "Fira Sans Condensed"
|
||||
```
|
||||
|
||||
### Text
|
||||
|
||||
To change text found throughout the theme add the following to your
|
||||
[`/_data/theme.yml`](_data/theme.yml) file and customize as necessary.
|
||||
|
||||
```yaml
|
||||
t:
|
||||
skip_links: "Skip links"
|
||||
skip_primary_nav: "Skip to primary navigation"
|
||||
skip_content: "Skip to content"
|
||||
skip_footer: "Skip to footer"
|
||||
menu: "Menu"
|
||||
search: "Search"
|
||||
site_search: "Site Search"
|
||||
results_found: "Result(s) found"
|
||||
search_placeholder_text: "Enter your search term..."
|
||||
home: "Home"
|
||||
newer: "Newer"
|
||||
older: "Older"
|
||||
email: "Email"
|
||||
subscribe: "Subscribe"
|
||||
read_more: "Read More"
|
||||
posts: "Posts"
|
||||
page: "Page"
|
||||
of: "of"
|
||||
min_read: "min read"
|
||||
present: "Present"
|
||||
cv_awards: "Awards"
|
||||
cv_summary_contact: "Contact"
|
||||
cv_summary_contact_email: "Email"
|
||||
cv_summary_contact_phone: "Phone"
|
||||
cv_summary_contact_website: "Website"
|
||||
cv_location: "Location"
|
||||
cv_education: "Education"
|
||||
cv_education_courses: "Courses"
|
||||
cv_interests: "Interests"
|
||||
cv_languages: "Languages"
|
||||
cv_publications: "Publications"
|
||||
cv_references: "References"
|
||||
cv_skills: "Skills"
|
||||
cv_volunteer: "Volunteer"
|
||||
cv_work: "Work"
|
||||
```
|
||||
|
||||
### Navigation
|
||||
|
||||
By default all internal pages with a `title` will be added to the "off-canvas"
|
||||
menu. For more granular control and sorting of these menu links:
|
||||
|
||||
1. Create a custom list to override the default setting by adding a
|
||||
`navigation_pages` array to your [`/_data/theme.yml`](_data/theme.yml) file.
|
||||
|
||||
2. Add raw page paths in the order you'd like:
|
||||
|
||||
```yaml
|
||||
navigation_pages:
|
||||
- about.md
|
||||
- cv.md
|
||||
```
|
||||
|
||||
Each menu link's title and URL will be populated based on their `title` and
|
||||
`permalink` respectively.
|
||||
|
||||
### Pagination
|
||||
|
||||
Break up the main listing of posts into smaller lists and display them over
|
||||
multiple pages by [enabling pagination](http://jekyllrb.com/docs/pagination/).
|
||||
|
||||
1. Include the `jekyll-paginate` plugin in your `Gemfile`.
|
||||
|
||||
```ruby
|
||||
group :jekyll_plugins do
|
||||
gem "jekyll-paginate"
|
||||
end
|
||||
```
|
||||
|
||||
2. Add `jekyll-paginate` to `gems` array in your `_config.yml` file and the
|
||||
following pagination settings:
|
||||
|
||||
```yaml
|
||||
paginate: 5 # amount of posts to show per page
|
||||
paginate_path: /page:num/
|
||||
```
|
||||
|
||||
3. Create `index.html` (or rename `index.md`) in the root of your project and
|
||||
add the following front matter:
|
||||
|
||||
```yaml
|
||||
layout: home
|
||||
paginate: true
|
||||
```
|
||||
|
||||
### Search
|
||||
|
||||
To enable site-wide search add `search: true` to your `_config.yml`.
|
||||
|
||||
#### Lunr (default)
|
||||
|
||||
The default search uses [**Lunr**](https://lunrjs.com/) to build a search index of all your documents. This method is 100% compatible with sites hosted on GitHub Pages.
|
||||
|
||||
**Note:** Only the first 50 words of a post or page's body content is added to the Lunr search index. Setting `search_full_content` to `true` in your `_config.yml` will override this and could impact page load performance.
|
||||
|
||||
#### Algolia
|
||||
|
||||
For faster and more relevant search ([see demo](https://mmistakes.github.io/jekyll-theme-basically-basic-algolia-search/)):
|
||||
|
||||
1. Add the [`jekyll-algolia`](https://github.com/algolia/jekyll-algolia) gem to your `Gemfile`, in the `:jekyll_plugins` section.
|
||||
|
||||
```ruby
|
||||
group :jekyll_plugins do
|
||||
gem "jekyll-feed"
|
||||
gem "jekyll-seo-tag"
|
||||
gem "jekyll-sitemap"
|
||||
gem "jekyll-paginate"
|
||||
gem "jekyll-algolia"
|
||||
end
|
||||
```
|
||||
|
||||
Once this is done, download all dependencies by running `bundle install`.
|
||||
|
||||
2. Switch search providers from `lunr` to `algolia` in your `_config.yml` file:
|
||||
|
||||
```yaml
|
||||
search_provider: algolia
|
||||
```
|
||||
|
||||
3. Add the following Algolia credentials to your `_config.yml` file. *If you don't have an Algolia account, you can open a free [Community plan](https://www.algolia.com/users/sign_up/hacker). Once signed in, you can grab your credentials from [your dashboard](https://www.algolia.com/licensing).*
|
||||
|
||||
```yaml
|
||||
algolia:
|
||||
application_id: # YOUR_APPLICATION_ID
|
||||
index_name: # YOUR_INDEX_NAME
|
||||
search_only_api_key: # YOUR_SEARCH_ONLY_API_KEY
|
||||
powered_by: # true (default), false
|
||||
```
|
||||
|
||||
4. Once your credentials are setup, you can run the indexing with the following command:
|
||||
|
||||
```
|
||||
ALGOLIA_API_KEY=your_admin_api_key bundle exec jekyll algolia
|
||||
```
|
||||
|
||||
For Windows users you will have to use `set` to assigned the `ALGOLIA_API_KEY` environment variable.
|
||||
|
||||
```
|
||||
set ALGOLIA_API_KEY=your_admin_api_key
|
||||
bundle exec jekyll algolia
|
||||
```
|
||||
|
||||
Note that `ALGOLIA_API_KEY` should be set to your admin API key.
|
||||
|
||||
To use the Algolia search with GitHub Pages hosted sites follow [this deployment guide](https://community.algolia.com/jekyll-algolia/github-pages.html). Or this guide for [deploying on Netlify](https://community.algolia.com/jekyll-algolia/netlify.html).
|
||||
|
||||
**Note:** The Jekyll Algolia plugin can be configured in several ways. Be sure to check out [their full documentation](https://community.algolia.com/jekyll-algolia/options.html "Algolia configuration") on how to exclude files and other valuable settings.
|
||||
|
||||
### Author
|
||||
|
||||
Author information is used as meta data for post "by lines" and propagates the
|
||||
`creator` field of Twitter summary cards with the following front matter in
|
||||
`_config.yml`:
|
||||
|
||||
```yaml
|
||||
author:
|
||||
name: John Doe
|
||||
twitter: johndoetwitter
|
||||
picture: /assets/images/johndoe.png
|
||||
```
|
||||
|
||||
Site-wide author information can be overridden in a document's front matter in
|
||||
the same way:
|
||||
|
||||
```yaml
|
||||
author:
|
||||
name: Jane Doe
|
||||
twitter: janedoetwitter
|
||||
picture: /assets/images/janedoe.png
|
||||
```
|
||||
|
||||
Or by specifying a corresponding key in the document's front matter, that
|
||||
exists in `site.data.authors`. E.g., you have the following in the document's
|
||||
front matter:
|
||||
|
||||
```yaml
|
||||
author: megaman
|
||||
```
|
||||
|
||||
And you have the following in `_data/authors.yml`:
|
||||
|
||||
```yaml
|
||||
megaman:
|
||||
name: Mega Man
|
||||
twitter: megamantwitter
|
||||
picture: /assets/images/megaman.png
|
||||
|
||||
drlight:
|
||||
name: Dr. Light
|
||||
twitter: drlighttwitter
|
||||
picture: /assets/images/drlight.png
|
||||
```
|
||||
|
||||
Currently `author.picture` is only used in `layout: about`. Recommended size is
|
||||
`300 x 300` pixels.
|
||||
|
||||
### Reading Time
|
||||
|
||||
To enable reading time counts add `read_time: true` to a post or page's YAML
|
||||
Front Matter.
|
||||
|
||||
### Comments (via Disqus)
|
||||
|
||||
Optionally, if you have a [Disqus](https://disqus.com/) account, you can show a
|
||||
comments section below each post.
|
||||
|
||||
To enable Disqus comments, add your [Disqus shortname](https://help.disqus.com/customer/portal/articles/466208) to your project's
|
||||
`_config.yml` file:
|
||||
|
||||
```yaml
|
||||
disqus:
|
||||
shortname: my_disqus_shortname
|
||||
```
|
||||
|
||||
Comments are enabled by default and will only appear in production when built
|
||||
with the following [environment value](http://jekyllrb.com/docs/configuration/#specifying-a-jekyll-environment-at-build-time):
|
||||
`JEKYLL_ENV=production`
|
||||
|
||||
If you don't want to display comments for a particular post you can disable
|
||||
them by adding `comments: false` to that post's front matter.
|
||||
|
||||
### Google Analytics
|
||||
|
||||
To enable Google Analytics, add your [tracking ID](https://support.google.com/analytics/answer/1032385)
|
||||
to `_config.yml` like so:
|
||||
|
||||
```yaml
|
||||
google_analytics: UA-NNNNNNNN-N
|
||||
```
|
||||
|
||||
Similar to comments, the Google Analytics tracking script will only appear in
|
||||
production when using the following environment value: `JEKYLL_ENV=production`.
|
||||
|
||||
### Copyright
|
||||
|
||||
By default the copyright line in the footer displays the current year
|
||||
(at build time) followed by your site's title. e.g. `© 2018 Basically Basic.`
|
||||
|
||||
If you would like to change this add `copyright` to your `_config.yml` file
|
||||
with appropriate text:
|
||||
|
||||
```yaml
|
||||
copyright: "My custom copyright."
|
||||
```
|
||||
|
||||
## Layouts
|
||||
|
||||
This theme provides the following layouts, which you can use by setting the
|
||||
`layout` [Front Matter](https://jekyllrb.com/docs/frontmatter/) on each page,
|
||||
like so:
|
||||
|
||||
```yaml
|
||||
---
|
||||
layout: name
|
||||
---
|
||||
```
|
||||
|
||||
### `layout: default`
|
||||
|
||||
This layout handles all of the basic page scaffolding placing the page content
|
||||
between the masthead and footer elements. All other layouts inherit this one
|
||||
and provide additional styling and features inside of the `{{ content }}` block.
|
||||
|
||||
### `layout: post`
|
||||
|
||||
This layout accommodates the following front matter:
|
||||
|
||||
```yaml
|
||||
# optional alternate title to replace page.title at the top of the page
|
||||
alt_title: "Basically Basic"
|
||||
|
||||
# optional sub-title below the page title
|
||||
sub_title: "The name says it all"
|
||||
|
||||
# optional intro text below titles, Markdown allowed
|
||||
introduction: |
|
||||
Basically Basic is a Jekyll theme meant to be a substitute for the default --- [Minima](https://github.com/jekyll/minima). Conventions and features found in Minima are fully supported by **Basically Basic**.
|
||||
|
||||
# optional call to action links
|
||||
actions:
|
||||
- label: "Learn More"
|
||||
icon: github # references name of svg icon, see full list below
|
||||
url: "http://url-goes-here.com"
|
||||
- label: "Download"
|
||||
icon: download # references name of svg icon, see full list below
|
||||
url: "http://url-goes-here.com"
|
||||
|
||||
image: # URL to a hero image associated with the post (e.g., /assets/page-pic.jpg)
|
||||
|
||||
# post specific author data if different from what is set in _config.yml
|
||||
author:
|
||||
name: John Doe
|
||||
twitter: johndoetwitter
|
||||
|
||||
comments: false # disable comments on this post
|
||||
```
|
||||
|
||||
**Note:** Hero images can be overlaid with a transparent "accent" color to unify them with the theme's palette. To enable, [customize the CSS](#customizing-sass-scss) with the following Sass variable override:
|
||||
|
||||
```scss
|
||||
$intro-image-color-overlay: true;
|
||||
```
|
||||
|
||||
### `layout: page`
|
||||
|
||||
Visually this layout looks and acts the same as `layout: post`, with two minor
|
||||
differences.
|
||||
|
||||
- Author "by line" and publish date are omitted.
|
||||
- Disqus comments are omitted.
|
||||
|
||||
### `layout: home`
|
||||
|
||||
This layout accommodates the same front matter as `layout: page`, with the
|
||||
addition of the following:
|
||||
|
||||
```yaml
|
||||
paginate: true # enables pagination loop, see section above for additional setup
|
||||
entries_layout: # list (default), grid
|
||||
```
|
||||
|
||||
By default, posts are shown in a list view. To change to a grid view add `entries_layout: grid` to the page's front matter.
|
||||
|
||||
### `layout: posts`
|
||||
|
||||
This layout displays all posts grouped by the year they were published. It accommodates the same front matter as `layout: page`.
|
||||
|
||||
By default, posts are shown in a list view. To change to a grid view add `entries_layout: grid` to the page's front matter.
|
||||
|
||||
### `layout: categories`
|
||||
|
||||
This layout displays all posts grouped category. It accommodates the same front matter as `layout: page`.
|
||||
|
||||
By default, posts are shown in a list view. To change to a grid view add `entries_layout: grid` to the page's front matter.
|
||||
|
||||
### `layout: tags`
|
||||
|
||||
This layout displays all posts grouped by tag. It accommodates the same front matter as `layout: page`.
|
||||
|
||||
By default, posts are shown in a list view. To change to a grid view add `entries_layout: grid` to the page's front matter.
|
||||
|
||||
### `layout: collection`
|
||||
|
||||
This layout displays all documents grouped by a specific collection. It accommodates the same front matter as `layout: page` with the addition of the following:
|
||||
|
||||
```yaml
|
||||
collection: # collection name
|
||||
entries_layout: # list (default), grid
|
||||
show_excerpts: # true (default), false
|
||||
sort_by: # date (default) title
|
||||
sort_order: # forward (default), reverse
|
||||
```
|
||||
|
||||
To create a page showing all documents in the `recipes` collection you'd create `recipes.md` in the root of your project and add this front matter:
|
||||
|
||||
```yaml
|
||||
title: Recipes
|
||||
layout: collection
|
||||
permalink: /recipes/
|
||||
collection: recipes
|
||||
```
|
||||
|
||||
By default, documents are shown in a list view. To change to a grid view add `entries_layout: grid` to the page's front matter. If you want to sort the collection by title add `sort_by: title`. If you want reverse sorting, add `sort_order: reverse`.
|
||||
|
||||
### `layout: category`
|
||||
|
||||
This layout displays all posts grouped by a specific category. It accommodates the same front matter as `layout: page` with the addition of the following:
|
||||
|
||||
```yaml
|
||||
taxonomy: # category name
|
||||
entries_layout: # list (default), grid
|
||||
```
|
||||
|
||||
By default, posts are shown in a list view. To change to a grid view add `entries_layout: grid` to the page's front matter.
|
||||
|
||||
To create a page showing all posts assigned to the category `foo` you'd create `foo.md` in the root of your project and add this front matter:
|
||||
|
||||
```yaml
|
||||
title: Foo
|
||||
layout: category
|
||||
permalink: /categories/foo/
|
||||
taxonomy: foo
|
||||
```
|
||||
|
||||
### `layout: tag`
|
||||
|
||||
This layout displays all posts grouped by a specific tag. It accommodates the same front matter as `layout: page` with the addition of the following:
|
||||
|
||||
```yaml
|
||||
taxonomy: # tag name
|
||||
entries_layout: # list (default), grid
|
||||
```
|
||||
|
||||
By default, posts are shown in a list view. To change to a grid view add `entries_layout: grid` to the page's front matter.
|
||||
|
||||
To create a page showing all posts assigned to the tag `foo bar` you'd create `foo-bar.md` in the root of your project and add this front matter:
|
||||
|
||||
```yaml
|
||||
title: Foo Bar
|
||||
layout: tag
|
||||
permalink: /tags/foo-bar/
|
||||
taxonomy: foo bar
|
||||
```
|
||||
|
||||
### `layout: about`
|
||||
|
||||
This layout accommodates the same front matter as `layout: page`, with the
|
||||
addition of the following to display an author picture:
|
||||
|
||||
```yaml
|
||||
author:
|
||||
name: John Doe
|
||||
picture: /assets/images/johndoe.png
|
||||
```
|
||||
|
||||
Recommended `picture` size is approximately `300 x 300` pixels. If `author`
|
||||
object is not explicitly set in the about page's front matter the theme
|
||||
will default to the value set in `_config.yml`.
|
||||
|
||||
If blank there no image will appear.
|
||||
|
||||
### `layout: cv`
|
||||
|
||||
This layout accommodates the same front matter as `layout: page`. It
|
||||
leverages a [JSON-based file standard](https://jsonresume.org/schema/) for
|
||||
resume data to conveniently render a curriculum vitæ or resume painlessly.
|
||||
|
||||
Simply use JSON Resume's [in-browser resume builder](http://registry.jsonresume.org/)
|
||||
to export a JSON file and save to your project as `_data/cv.json`.
|
||||
|
||||
## Images
|
||||
|
||||
Suggested image sizes in pixels are as follows:
|
||||
|
||||
| Image | Description | Size |
|
||||
| ----- | ----------- | ---- |
|
||||
| `page.image.path` | Large full-width document image. | Tall images will push content down the page. `1600 x 600` is a good middle-ground size to aim for. |
|
||||
| `page.image` | Short-hand for `page.image.path` when used alone (without `thumbnail`, `caption`, or other variables). | Same as `page.image.path` |
|
||||
| `page.image.thumbnail` | Small document image used in grid view. | `400 x 200` |
|
||||
| `author.picture` | Author page image. | `300 x 300` |
|
||||
|
||||
## Customization
|
||||
|
||||
The default structure, style, and scripts of this theme can be overridden and
|
||||
customized in the following two ways.
|
||||
|
||||
### Overriding Includes and Layouts
|
||||
|
||||
Theme defaults can be [overridden](http://jekyllrb.com/docs/themes/#overriding-theme-defaults)
|
||||
by placing a file with the same name into your project's `_includes` or
|
||||
`_layouts` directory. For instance:
|
||||
|
||||
- To specify a custom style path or meta data to the [`_includes/head.html `](_includes/head.html)
|
||||
file, create an `_includes` directory in your project, copy
|
||||
`_includes/head.html` from Basically Basic's gem folder to
|
||||
`<your_project>/_includes` and start editing that file.
|
||||
|
||||
**ProTip:** to locate the theme's files on your computer run
|
||||
`bundle info jekyll-theme-basically-basic`. This returns the location of the
|
||||
gem-based theme files.
|
||||
|
||||
### Customizing Sass (SCSS)
|
||||
|
||||
To override the default [Sass](http://sass-lang.com/guide) (located in theme's
|
||||
`_sass` directory), do one of the following:
|
||||
|
||||
1. Copy directly from the Basically Basic gem
|
||||
|
||||
- Go to your local Basically Basic gem installation directory (run
|
||||
`bundle info jekyll-theme-basically-basic` to get the path to it).
|
||||
- Copy the contents of `/assets/stylesheets/main.scss` from there to
|
||||
`<your_project>`.
|
||||
- Customize what you want inside `<your_project>/assets/stylesheets/main.scss`.
|
||||
|
||||
2. Copy from this repo.
|
||||
|
||||
- Copy the contents of [assets/stylesheets/main.scss](assets/stylesheets/main.scss)
|
||||
to `<your_project>`.
|
||||
- Customize what you want inside `<your_project/assets/stylesheets/main.scss`.
|
||||
|
||||
**Note:** To make more extensive changes and customize the Sass partials bundled
|
||||
in the gem. You will need to copy the complete contents of the `_sass` directory
|
||||
to `<your_project>` due to the way Jekyll currently reads those files.
|
||||
|
||||
To make basic tweaks to theme's style Sass variables can be overridden by adding
|
||||
to `<your_project>/assets/stylesheets/main.scss`. For instance, to change the
|
||||
accent color used throughout the theme add the following:
|
||||
|
||||
```scss
|
||||
$accent-color: red;
|
||||
```
|
||||
|
||||
### Customizing JavaScript
|
||||
|
||||
To override the default JavaScript bundled in the theme, do one of the following:
|
||||
|
||||
1. Copy directly from the Basically Basic gem
|
||||
|
||||
- Go to your local Basically Basic gem installation directory (run
|
||||
`bundle info jekyll-theme-basically-basic` to get the path to it).
|
||||
- Copy the contents of `/assets/javascripts/main.js` from there to
|
||||
`<your_project>`.
|
||||
- Customize what you want inside `<your_project>/assets/javascripts/main.js`.
|
||||
|
||||
2. Copy from this repo.
|
||||
|
||||
- Copy the contents of [assets/javascripts/main.js](assets/javascripts/main.js)
|
||||
to `<your_project>`.
|
||||
- Customize what you want inside `<your_project>/assets/javascripts/main.js`.
|
||||
|
||||
### SVG Icons
|
||||
|
||||
The theme uses social network logos and other iconography saved as SVGs for
|
||||
performance and flexibility. Said SVGs are located in the `_includes` directory
|
||||
and prefixed with `icon-`. Each icon has been sized and designed to fit a
|
||||
`16 x 16` viewbox and optimized with [SVGO](https://github.com/svg/svgo).
|
||||
|
||||
| Icon | Filename |
|
||||
| --- | --- |
|
||||
| <img src="https://cdn.rawgit.com/mmistakes/jekyll-theme-basically-basic/master/_includes/icon-arrow-left.svg" width="16" height="16"> | icon-arrow-left.svg |
|
||||
| <img src="https://cdn.rawgit.com/mmistakes/jekyll-theme-basically-basic/master/_includes/icon-arrow-right.svg" width="16" height="16"> | icon-arrow-right.svg |
|
||||
| <img src="https://cdn.rawgit.com/mmistakes/jekyll-theme-basically-basic/master/_includes/icon-bitbucket.svg" width="16" height="16"> | icon-bitbucket.svg |
|
||||
| <img src="https://cdn.rawgit.com/mmistakes/jekyll-theme-basically-basic/master/_includes/icon-calendar.svg" width="16" height="16"> | icon-calendar.svg |
|
||||
| <img src="https://cdn.rawgit.com/mmistakes/jekyll-theme-basically-basic/master/_includes/icon-codepen.svg" width="16" height="16"> | icon-codepen.svg |
|
||||
| <img src="https://cdn.rawgit.com/mmistakes/jekyll-theme-basically-basic/master/_includes/icon-download.svg" width="16" height="16"> | icon-download.svg |
|
||||
| <img src="https://cdn.rawgit.com/mmistakes/jekyll-theme-basically-basic/master/_includes/icon-dribbble.svg" width="16" height="16"> | icon-dribbble.svg |
|
||||
| <img src="https://cdn.rawgit.com/mmistakes/jekyll-theme-basically-basic/master/_includes/icon-email.svg" width="16" height="16"> | icon-email.svg |
|
||||
| <img src="https://cdn.rawgit.com/mmistakes/jekyll-theme-basically-basic/master/_includes/icon-facebook.svg" width="16" height="16"> | icon-facebook.svg |
|
||||
| <img src="https://cdn.rawgit.com/mmistakes/jekyll-theme-basically-basic/master/_includes/icon-flickr.svg" width="16" height="16"> | icon-flickr.svg |
|
||||
| <img src="https://cdn.rawgit.com/mmistakes/jekyll-theme-basically-basic/master/_includes/icon-github.svg" width="16" height="16"> | icon-github.svg |
|
||||
| <img src="https://cdn.rawgit.com/mmistakes/jekyll-theme-basically-basic/master/_includes/icon-gitlab.svg" width="16" height="16"> | icon-gitlab.svg |
|
||||
| <img src="https://cdn.rawgit.com/mmistakes/jekyll-theme-basically-basic/master/_includes/icon-googleplus.svg" width="16" height="16"> | icon-googleplus.svg |
|
||||
| <img src="https://cdn.rawgit.com/mmistakes/jekyll-theme-basically-basic/master/_includes/icon-instagram.svg" width="16" height="16"> | icon-instagram.svg |
|
||||
| <img src="https://cdn.rawgit.com/mmistakes/jekyll-theme-basically-basic/master/_includes/icon-lastfm.svg" width="16" height="16"> | icon-lastfm.svg |
|
||||
| <img src="https://cdn.rawgit.com/mmistakes/jekyll-theme-basically-basic/master/_includes/icon-linkedin.svg" width="16" height="16"> | icon-linkedin.svg |
|
||||
| <img src="https://cdn.rawgit.com/mmistakes/jekyll-theme-basically-basic/master/_includes/icon-pdf.svg" width="16" height="16"> | icon-pdf.svg |
|
||||
| <img src="https://cdn.rawgit.com/mmistakes/jekyll-theme-basically-basic/master/_includes/icon-pinterest.svg" width="16" height="16"> | icon-pinterest.svg |
|
||||
| <img src="https://cdn.rawgit.com/mmistakes/jekyll-theme-basically-basic/master/_includes/icon-rss.svg" width="16" height="16"> | icon-rss.svg |
|
||||
| <img src="https://cdn.rawgit.com/mmistakes/jekyll-theme-basically-basic/master/_includes/icon-soundcloud.svg" width="16" height="16"> | icon-soundcloud.svg |
|
||||
| <img src="https://cdn.rawgit.com/mmistakes/jekyll-theme-basically-basic/master/_includes/icon-stackoverflow.svg" width="16" height="16"> | icon-stackoverflow.svg |
|
||||
| <img src="https://cdn.rawgit.com/mmistakes/jekyll-theme-basically-basic/master/_includes/icon-stopwatch.svg" width="16" height="16"> | icon-stopwatch.svg |
|
||||
| <img src="https://cdn.rawgit.com/mmistakes/jekyll-theme-basically-basic/master/_includes/icon-tumblr.svg" width="16" height="16"> | icon-tumblr.svg |
|
||||
| <img src="https://cdn.rawgit.com/mmistakes/jekyll-theme-basically-basic/master/_includes/icon-twitter.svg" width="16" height="16"> | icon-twitter.svg |
|
||||
| <img src="https://cdn.rawgit.com/mmistakes/jekyll-theme-basically-basic/master/_includes/icon-xing.svg" width="16" height="16"> | icon-xing.svg |
|
||||
| <img src="https://cdn.rawgit.com/mmistakes/jekyll-theme-basically-basic/master/_includes/icon-youtube.svg" width="16" height="16"> | icon-youtube.svg |
|
||||
|
||||
Fill colors are defined in the `_sass/basically-basic/_icons.scss` partial and
|
||||
set with `.icon-name` where class name matches the corresponding icon.
|
||||
|
||||
For example the Twitter icon is given a fill color of `#1da1f2` like so:
|
||||
|
||||
```html
|
||||
<span class="icon icon--twitter">{% include icon-twitter.svg %}</span>
|
||||
```
|
||||
|
||||
Alongside the SVG assets, there are icon helper includes to aid in generating
|
||||
social network links.
|
||||
|
||||
| Include Parameter | Description | Required |
|
||||
| ----------------- | ---------------------------------| ----------------------- |
|
||||
| `username` | Username on given social network | **Required** |
|
||||
| `label` | Text used for hyperlink | Optional, defaults to `username` |
|
||||
|
||||
For example, the following `icon-github.html` include:
|
||||
|
||||
```liquid
|
||||
{% include icon-github.html username=jekyll label='GitHub' %}
|
||||
```
|
||||
|
||||
Will output the following HTML:
|
||||
|
||||
```html
|
||||
<a href="https://github.com/jekyll">
|
||||
<span class="icon icon--github"><svg viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg" fill-rule="evenodd" clip-rule="evenodd" stroke-linejoin="round" stroke-miterlimit="1.414"><path d="M8 0C3.58 0 0 3.582 0 8c0 3.535 2.292 6.533 5.47 7.59.4.075.547-.172.547-.385 0-.19-.007-.693-.01-1.36-2.226.483-2.695-1.073-2.695-1.073-.364-.924-.89-1.17-.89-1.17-.725-.496.056-.486.056-.486.803.056 1.225.824 1.225.824.714 1.223 1.873.87 2.33.665.072-.517.278-.87.507-1.07-1.777-.2-3.644-.888-3.644-3.953 0-.873.31-1.587.823-2.147-.09-.202-.36-1.015.07-2.117 0 0 .67-.215 2.2.82.64-.178 1.32-.266 2-.27.68.004 1.36.092 2 .27 1.52-1.035 2.19-.82 2.19-.82.43 1.102.16 1.915.08 2.117.51.56.82 1.274.82 2.147 0 3.073-1.87 3.75-3.65 3.947.28.24.54.73.54 1.48 0 1.07-.01 1.93-.01 2.19 0 .21.14.46.55.38C13.71 14.53 16 11.53 16 8c0-4.418-3.582-8-8-8"></path></svg></span>
|
||||
<span class="label">GitHub</span>
|
||||
</a>
|
||||
```
|
||||
|
||||
### Customizing Sidebar Content
|
||||
|
||||
---
|
||||
|
||||
## Development
|
||||
|
||||
To set up your environment to develop this theme:
|
||||
|
||||
1. Clone this repo
|
||||
2. `cd` into `/example` and run `bundle install`.
|
||||
|
||||
To test the theme the locally as you make changes to it:
|
||||
|
||||
1. `cd` into the root folder of the repo (e.g. `jekyll-theme-basically-basic`).
|
||||
2. Run `bundle exec rake preview` and open your browser to
|
||||
`http://localhost:4000/example/`.
|
||||
|
||||
This starts a Jekyll server using the theme's files and contents of the
|
||||
`example/` directory. As modifications are made, refresh your browser to see
|
||||
any changes.
|
||||
|
||||
## Contributing
|
||||
|
||||
Found a typo in the documentation? Interested in adding a feature or
|
||||
[fixing a bug][issues]? Then by all means [submit an issue][new-issue] or take a
|
||||
stab at submitting a [pull request][using-pull-requests]. If this is your first
|
||||
pull request, it may be helpful to read up on the [GitHub Flow][github-flow].
|
||||
|
||||
[issues]: https://github.com/mmistakes/jekyll-theme-basically-basic/issues
|
||||
[new-issue]: https://github.com/mmistakes/jekyll-theme-basically-basic/issues/new
|
||||
[using-pull-requests]: https://help.github.com/articles/using-pull-requests/
|
||||
[github-flow]: https://guides.github.com/introduction/flow/
|
||||
|
||||
### Pull Requests
|
||||
|
||||
When submitting a pull request:
|
||||
|
||||
1. Clone the repo.
|
||||
2. Create a branch off of `master` and give it a meaningful name (e.g.
|
||||
`my-awesome-new-feature`) and describe the feature or fix.
|
||||
3. Open a pull request on GitHub.
|
||||
|
||||
Sample pages can be found in the [`/docs`](docs) and [`/example`](/example)
|
||||
folders if you'd like to tackle any "low-hanging fruit" like fixing typos, bad
|
||||
grammar, etc.
|
||||
|
||||
---
|
||||
|
||||
## Credits
|
||||
|
||||
### Creator
|
||||
|
||||
**Michael Rose**
|
||||
|
||||
- <https://mademistakes.com>
|
||||
- <https://twitter.com/mmistakes>
|
||||
- <https://github.com/mmistakes>
|
||||
|
||||
### Icons + Demo Images:
|
||||
|
||||
- [Simple Icons](https://simpleicons.org/)
|
||||
- [Noun Project](https://thenounproject.com)
|
||||
- [Unsplash](https://unsplash.com/)
|
||||
|
||||
### Other:
|
||||
|
||||
- [Jekyll](http://jekyllrb.com/)
|
||||
- [Susy](http://susy.oddbird.net/)
|
||||
- [Breakpoint](http://breakpoint-sass.com/)
|
||||
|
||||
---
|
||||
|
||||
## License
|
||||
|
||||
The MIT License (MIT)
|
||||
|
||||
Copyright (c) 2017-2021 Michael Rose and contributors
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to deal
|
||||
in the Software without restriction, including without limitation the rights
|
||||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||
copies of the Software, and to permit persons to whom the Software is
|
||||
furnished to do so, subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in all
|
||||
copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||
SOFTWARE.
|
||||
|
||||
Basically Basic incorporates icons from [The Noun Project](https://thenounproject.com/).
|
||||
Icons are distributed under Creative Commons Attribution 3.0 United States (CC BY 3.0 US).
|
||||
|
||||
Basically Basic incorporates photographs from [Unsplash](https://unsplash.com).
|
||||
|
||||
Basically Basic incorporates [Susy](http://susy.oddbird.net/),
|
||||
Copyright (c) 2017, Miriam Eric Suzanne.
|
||||
Susy is distributed under the terms of the [BSD 3-clause "New" or "Revised" License](https://opensource.org/licenses/BSD-3-Clause).
|
||||
|
||||
Basically Basic incorporates [Breakpoint](http://breakpoint-sass.com/).
|
||||
Breakpoint is distributed under the terms of the [MIT/GPL Licenses](http://opensource.org/licenses/MIT).
|
||||
|
|
|
|||
75
Rakefile
75
Rakefile
|
|
@ -1,75 +0,0 @@
|
|||
require "bundler/gem_tasks"
|
||||
require "jekyll"
|
||||
require "listen"
|
||||
|
||||
def listen_ignore_paths(base, options)
|
||||
[
|
||||
/_config\.ya?ml/,
|
||||
/_site/,
|
||||
/\.jekyll-metadata/
|
||||
]
|
||||
end
|
||||
|
||||
def listen_handler(base, options)
|
||||
site = Jekyll::Site.new(options)
|
||||
Jekyll::Command.process_site(site)
|
||||
proc do |modified, added, removed|
|
||||
t = Time.now
|
||||
c = modified + added + removed
|
||||
n = c.length
|
||||
relative_paths = c.map{ |p| Pathname.new(p).relative_path_from(base).to_s }
|
||||
print Jekyll.logger.message("Regenerating:", "#{relative_paths.join(", ")} changed... ")
|
||||
begin
|
||||
Jekyll::Command.process_site(site)
|
||||
puts "regenerated in #{Time.now - t} seconds."
|
||||
rescue => e
|
||||
puts "error:"
|
||||
Jekyll.logger.warn "Error:", e.message
|
||||
Jekyll.logger.warn "Error:", "Run jekyll build --trace for more information."
|
||||
end
|
||||
end
|
||||
end
|
||||
|
||||
task :preview do
|
||||
base = Pathname.new('.').expand_path
|
||||
options = {
|
||||
"source" => base.join('example').to_s,
|
||||
"destination" => base.join('example/_site').to_s,
|
||||
"force_polling" => false,
|
||||
"serving" => true,
|
||||
"theme" => "jekyll-theme-basically-basic"
|
||||
}
|
||||
|
||||
options = Jekyll.configuration(options)
|
||||
|
||||
ENV["LISTEN_GEM_DEBUGGING"] = "1"
|
||||
listener = Listen.to(
|
||||
base.join("_includes"),
|
||||
base.join("_layouts"),
|
||||
base.join("_sass"),
|
||||
base.join("assets"),
|
||||
options["source"],
|
||||
:ignore => listen_ignore_paths(base, options),
|
||||
:force_polling => options['force_polling'],
|
||||
&(listen_handler(base, options))
|
||||
)
|
||||
|
||||
begin
|
||||
listener.start
|
||||
Jekyll.logger.info "Auto-regeneration:", "enabled for '#{options["source"]}'"
|
||||
|
||||
unless options['serving']
|
||||
trap("INT") do
|
||||
listener.stop
|
||||
puts " Halting auto-regeneration."
|
||||
exit 0
|
||||
end
|
||||
|
||||
loop { sleep 1000 }
|
||||
end
|
||||
rescue ThreadError
|
||||
# You pressed Ctrl-C, oh my!
|
||||
end
|
||||
|
||||
Jekyll::Commands::Serve.process(options)
|
||||
end
|
||||
BIN
screenshot.png
BIN
screenshot.png
Binary file not shown.
|
Before Width: | Height: | Size: 138 KiB |
Loading…
Reference in New Issue