Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/andrewbanchich/lens-jekyll-theme
A Jekyll version of the "Lens" theme by HTML5 UP.
https://github.com/andrewbanchich/lens-jekyll-theme
html jekyll jekyll-themes lens-theme ruby-gem static static-site theme
Last synced: 3 months ago
JSON representation
A Jekyll version of the "Lens" theme by HTML5 UP.
- Host: GitHub
- URL: https://github.com/andrewbanchich/lens-jekyll-theme
- Owner: andrewbanchich
- License: other
- Archived: true
- Created: 2016-07-17T16:23:01.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2022-12-10T03:08:31.000Z (about 2 years ago)
- Last Synced: 2024-09-25T02:33:35.369Z (3 months ago)
- Topics: html, jekyll, jekyll-themes, lens-theme, ruby-gem, static, static-site, theme
- Language: SCSS
- Homepage: https://andrewbanchich.github.io/lens-jekyll-theme/
- Size: 3.42 MB
- Stars: 63
- Watchers: 5
- Forks: 91
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE.txt
Awesome Lists containing this project
README
# Lens - Jekyll Theme
A Jekyll version of the "Lens" theme by [HTML5 UP](https://html5up.net/).
# How to Use
For those unfamiliar with how Jekyll works, check out [https://jekyllrb.com/](https://jekyllrb.com/) for all the details,
or read up on just the basics of [front matter](https://jekyllrb.com/docs/frontmatter/), [writing posts](https://jekyllrb.com/docs/posts/),
and [creating pages](https://jekyllrb.com/docs/pages/).
- **GitLab**: Simply fork this repository and start editing the `_config.yml` file!
- **GitHub**: Fork this reposity and create a branch named `gh-pages`, then start editing the `_config.yml` file!
# Issues
If you would like to report a bug, ask a question, request a feature, feel free to do so on [the GitLab repository](https://gitlab.com/andrewbanchich/lens-jekyll-theme) and I will be more than happy to help!
Alternatively, you can open an issue via email by emailing [incoming+andrewbanchich/[email protected]](mailto:incoming+andrewbanchich/[email protected]).
The GitHub repository is simply a mirror of the GitLab repository.
# Credits
Original README from HTML5 UP:
```
Lens by HTML5 UP
html5up.net | @ajlkn
Free for personal and commercial use under the CCA 3.0 license (html5up.net/license)
This is Lens, a full screen (and entirely responsive) photo gallery design. Unlike previous
designs I've done in this vein (Parallelism, for instance), this one eschews the usual
lightbox in favor of a completely full screen experience -- one that I'm happy to say
translates awesomely all the way down to the tiniest of mobile devices. Full instructions
below!
Demo images* courtesy of Unsplash, a radtastic collection of CC0 (public domain) images
you can use for pretty much whatever.
(* = Not included)
Feedback, bug reports, and comments are not only welcome, but strongly encouraged :)
AJ
[email protected] | @ajlkn
Instructions:
Overview:
Lens is made up of three primary components:
- The "main wrapper": The skinny little column on the right. Home to what little
"regular" content you may have (header, footer, anything else you want to cram
in there), as well as ...
- The "thumbnails" section: A grid of thumbnails pointing to their respective
full size images.
- The "viewer": Basically the rest of the page, and basically where your full size
images will show up when a thumbnail is clicked.
Note: Only the main wrapper and the thumbnails section are actually present in
index.html. The viewer will be dynamically created on page load.
How it works:
Just add your thumbnails to the thumbnails section in the following format:
Title
Description.
And that's it. Lens will figure out the rest.
The "data-position" attribute:
As a full screen experience, the viewer will be subject to changes in its size and,
consequently, its aspect ratio. Since your full size images are basically applied as
backgrounds to the viewer itself, this means they'll probably (okay, definitely) get
cropped. All is not lost, however, as you can use the optional "data-position" attribute
to control how the full size image is positioned within the viewer. To do this, simply
add it to your thumbnail's element and set it to any valid "background-position"
value. For example, this:
... positions this particular full size image in the top left corner of the viewer (as
opposed to its center, the default), effectively limiting cropping to everything but
the top left corner.
Keyboard shortcuts:
Lens is set up to respond to the following keyboard shortcuts:
- Left Arrow: Go to previous image.
- Right Arrow: Go to next image.
- Up Arrow: Go to image above the current one in the thumbnails section.
- Down Arrow: Go to image below the current one in the thumbnails section.
- Space: Go to next image.
- Escape: Toggle the main wrapper.
Note: All keyboard shortcuts are disabled when the "xsmall" breakpoint is active
(since they don't really make a whole lot of sense there).
Other stuff:
- The main wrapper can be moved to the left by changing the "misc.main-side" variable
in assets/sass/libs/_vars.scss to "left" (and of course recompiling your CSS).
- Additional tweakable settings can be found at the top of assets/js/main.js, but
be aware most of these need to sync with certain Sass variables (see comments
for details).
Credits:
Demo Images:
Unsplash (unsplash.com)
Icons:
Font Awesome (fortawesome.github.com/Font-Awesome)
Other:
jQuery (jquery.com)
html5shiv.js (@afarkas @jdalton @jon_neal @rem)
Respond.js (j.mp/respondjs)
Skel (skel.io)
```
Repository [Jekyll logo](https://github.com/jekyll/brand) icon licensed under a [Creative Commons Attribution 4.0 International License](http://choosealicense.com/licenses/cc-by-4.0/).
