solrevdev.github.io
Static Jekyll driven website to replace solrevdev.com blogger account
testing the site locally
bundle install
bundle update github-pages
bundle exec jekyll serve --baseurl ''
bundle exec jekyll serve --drafts --baseurl ''
bundle exec jekyll serve --drafts --baseurl '' 2>/dev/null
bundle exec jekyll serve --drafts 2>/dev/null
To get rid of warnings you can use this
bundle exec jekyll serve --drafts --baseurl '' 2>/dev/null
bundle exec jekyll serve --drafts 2>/dev/null
Now open your browser and go to : http://localhost:4000
http://localhost:4000
gem install github-pages
gem update github-pages
jekyll build
jekyll serve
Now open your browser and go to http://localhost:4000
It is a brazen two-column theme that pairs a prominent sidebar with uncomplicated content. It's based on Poole, the Jekyll butler.
Contents
Usage
Hyde is a theme built on top of Poole, which provides a fully furnished Jekyll setup—just download and start the Jekyll server. See the Poole usage guidelines for how to install and use Jekyll.
Options
Hyde includes some customizable options, typically applied via classes on the <body>
element.
Sidebar menu
Create a list of nav links in the sidebar by assigning each Jekyll page the correct layout in the page's front-matter.
---
layout: page
title: About
---
Why require a specific layout? Jekyll will return all pages, including the atom.xml
, and with an alphabetical sort order. To ensure the first link is Home, we exclude the index.html
page from this list by specifying the page
layout.
Sticky sidebar content
By default Hyde ships with a sidebar that affixes it's content to the bottom of the sidebar. You can optionally disable this by removing the .sidebar-sticky
class from the sidebar's .container
. Sidebar content will then normally flow from top to bottom.
<!-- Default sidebar -->
<div class="sidebar">
<div class="container sidebar-sticky">
...
</div>
</div>
<!-- Modified sidebar -->
<div class="sidebar">
<div class="container">
...
</div>
</div>
Themes
Hyde ships with eight optional themes based on the base16 color scheme. Apply a theme to change the color scheme (mostly applies to sidebar and links).
There are eight themes available at this time.
To use a theme, add anyone of the available theme classes to the <body>
element in the default.html
layout, like so:
<body class="theme-base-08">
...
</body>
To create your own theme, look to the Themes section of included CSS file. Copy any existing theme (they're only a few lines of CSS), rename it, and change the provided colors.
Reverse layout
Hyde's page orientation can be reversed with a single class.
<body class="layout-reverse">
...
</body>
Development
Hyde has two branches, but only one is used for active development.
master
for development. All pull requests should be submitted againstmaster
.gh-pages
for our hosted site, which includes our analytics tracking code. Please avoid using this branch.
Jekyll commands used to get setup
sudo chown -R $(whoami) /usr/local
sudo chown -R $(whoami) /Library/Ruby
brew install ruby
gem install bundler
gem install rouge
gem update --system
sudo gem cleanup
bundle install
bundle exec jekyll serve
bundle exec jekyll serve --baseurl ''
bundle exec jekyll serve --drafts
gem install jekyll-import
ruby -rubygems -e 'require "jekyll-import";
JekyllImport::Importers::Blogger.run({
"source" => "_blogger.xml",
"no-blogger-info" => false, # not to leave blogger-URL info (id and old URL) in the front matter
"replace-internal-link" => false, # replace internal links using the post_url liquid tag.
})'
bundle exec htmlproofer ./_site
bundle exec htmlproofer ./_site --check-html --disable-external --checks-to-ignore ImageCheck,LinkCheck, HtmlCheck
bundle exec htmlproofer ./_site --disable-external --checks-to-ignore ImageCheck,LinkCheck,HtmlCheck
htmlproofer ./_site
Travis and Github custom domain resources
- http://sgoettschkes.me/p/deploying-a-jekyll-website-to-github-pages-using-travisci.html
- http://intenseagile.com/2015/04/27/running-jekyll-on-codeanywhere.html
- http://www.steveklabnik.com/automatically_update_github_pages_with_travis_example/
- http://awestruct.org/auto-deploy-to-github-pages/
- https://github.com/mbonaci/mbo-storm/wiki/Integrate-Travis-CI-with-your-GitHub-repo
- https://travis-ci.org/profile/solrevdev
- https://docs.travis-ci.com/user/for-beginners
- https://docs.travis-ci.com/user/getting-started/
- https://help.github.com/articles/troubleshooting-custom-domains/#dns-configuration-errors
- https://help.github.com/articles/setting-up-a-www-subdomain/
- https://tinypress.co/settings
- https://github.com/blog/2100-github-pages-now-faster-and-simpler-with-jekyll-3-0
- https://github.com/solrevdev/solrevdev.github.io
- https://dnsimple.com/dashboard
- https://help.github.com/articles/troubleshooting-jekyll-builds/
- https://gist.github.com/razor-x/8166421
- https://github.com/mfenner/jekyll-travis
Prose
I am using the following Prose config
prose:
siteurl: 'https://solrevdev.com'
media: 'media'
Author
Mark Otto
John Smith
License
Open sourced under the MIT license.
<3