Dev blog built with Jekyll https://old.tiffanywhite.dev
Find a file
2023-07-04 00:52:23 -04:00
.github Update something 2020-08-04 00:51:30 -04:00
.vscode Update something 2020-12-17 16:44:48 -05:00
_components Update branding 2020-10-09 23:12:43 -04:00
_includes Update substack.html 2023-07-04 00:52:23 -04:00
_layouts New stuff 2021-12-19 21:38:38 -05:00
_plugins New post 2020-12-18 00:05:47 -05:00
_posts New stuff 2021-12-19 21:38:38 -05:00
_sass New stuff 2021-12-19 21:38:38 -05:00
assets Add files via upload 2023-07-04 00:46:20 -04:00
icons Update branding 2020-10-09 23:12:43 -04:00
js Update something 2020-08-04 00:50:53 -04:00
.gitignore Change notes page in nav 2022-02-10 15:05:12 -05:00
.ruby-version Contact form update 2021-07-31 23:32:00 -04:00
.tabnineignore Update something 2020-12-17 16:44:48 -05:00
404.css Contact form update 2021-07-31 23:32:00 -04:00
404.html New post, css enhancements 2021-12-12 20:35:53 -05:00
_config.yml Update _config.yml 2023-07-04 00:48:41 -04:00
_redirects Create _redirects 2022-06-18 19:01:42 -04:00
about.md New stuff 2021-12-19 21:38:38 -05:00
archive.md Add archive page 2019-11-14 16:59:30 -05:00
Changelog.md Switched back to Jekyll 2019-11-03 19:26:11 -05:00
contact.html Update form styles 2021-08-01 00:22:24 -04:00
docker-compose.yml Font, notice, and bigfoot updates. New post 2020-05-25 19:32:55 -04:00
favicon.ico Update branding 2020-10-09 23:12:43 -04:00
favicon.png Update branding 2020-10-09 23:12:43 -04:00
feed.xml Update something 2020-03-13 19:50:16 -04:00
Gemfile Remove webmentions, add giscus 2021-10-06 00:34:48 -04:00
index.html Update something 2019-12-16 18:14:02 -05:00
opt-out.html Update uses and add plausible self opt-out 2021-06-14 01:37:24 -04:00
package-lock.json Remove webmentions, add giscus 2021-10-06 00:34:48 -04:00
package.json Removed blank posts 2020-02-05 02:15:07 -05:00
plausible-exclusion.css Update uses and add plausible self opt-out 2021-06-14 01:37:24 -04:00
privacy-policy.md Update privacy policy 2021-01-26 01:47:40 -05:00
README.md Switched back to Jekyll 2019-11-03 19:26:11 -05:00
search-data.json Switched back to Jekyll 2019-11-03 19:26:11 -05:00
search.md Switched back to Jekyll 2019-11-03 19:26:11 -05:00
server.sh New post, substack, bmac 2021-09-19 20:07:27 -04:00
thank-you.html Switched back to Jekyll 2019-11-03 19:26:11 -05:00
uses.md New stuff 2021-12-19 21:38:38 -05:00

Horace Jekyll Theme v1.2.0

Theme Live Demo

Features

  • Mobile-ready
  • Contact form built-in
  • Social icons built-in
  • Social sharing built-in
  • Mailchimp subscription form
  • Free images pack for your blog cover
  • Code Syntax Highlight with Prism.js
  • Support for Disqus comments

Getting Started

Table of Contents

    1. Theme Configuration
    1. Author configuration
    1. Contact form setings
    1. Social Links
    1. Site Navigation
    1. Images
    1. Local Installation
    1. Deployment
    1. Support

1. Theme Configuration

The theme configuration options can be found within the _config.yml file. More information about Jekyll configuration can be found in the Jekyll documentation.

  • description - the description of your site for social meta tag, search engines, and feed.xml.
  • name - the title of your blog, shown in the page and description areas.
  • logo - the image for site logo.
  • favicon - the icon for your site.
  • baseurl - the subpath of your site, e.g. /blog, for generating urls. If baseurl is set, you will need to prepend the baseurl to these settings: author image, site navigation, post images.
  • production_url - the base hostname and protocol of your site for where absolute urls are needed.
  • disqus - your Disqus shortname. Enter the Disqus shortname here if you wish to have Disqus comments enabled, leave blank to disable comments.
  • mailchimp_url - your form action URL for MailChimp newsletter signup form.
  • cover_image - the cover image used for you site home page.

2. Author configuration

  • name - the name of the post/blog author.
  • image - the author profile image, shown at the bottom of each post and in the intro section on the home page. The author image can be found in the horace/assets/images/authorimage.jpg location.
  • greetings - used in the home page for the author intro section.
  • description - used in the home page for the author intro section.
  • bio - the author biography shown at the bottom of each post.

3. Contact form setings

To make contact form work make sure you have defined "email: youremail@email.com" in _config.yml file and verify your form on formspree.io.

  • email - email used for contact form.
  • contact_page_description: - description used in contact form page (contact.html).
  • thankyou_page_description - description used in thank you page (thank-you.html).

To enable social links on your blog simply enter your social profile username, for example, twitter: "justgoodthemes" . If a field is left blank, the social icon will not be shown.

5. Site Navigation

The site navigation can be found in the _config.yml file. To add a page to the site navigation simply add your new page in the markdown format (e.g. newpage.md) in the theme root folder. Next edit your navigation menu located in _config.yml file on line 26. To add a new item to the navigation you have to add the item name and url. For example:

navigation:
- text: New Page
url: /newpage/

6. Images

Images for pages are located in the horace/assets/images folder and images for posts are located in the horace/assets/images/posts directory.

Image With Caption

Within your blog posts you can include captions for images. This requires using some HTML markup.

The example below illustrates how to include an image with a caption in a blog post:

{% include image-caption.html imageurl="/images/posts/Apple-Watch-In-Car.jpg" 
title="Apple Super" caption="supertest" %}

Add the following code into your post/page markdown and change its attributes accordingly.

Full Width Image With Caption

To have wide images in posts or pages simply add #wide word with the hashtag at the end of image path like in the example below:

{% include image-caption.html imageurl="/images/posts/Apple-Watch-In-Car.jpg#wide" 
title="Apple" caption="This is caption" %}

Add the following code into your post/page markdown and change its attributes accordingly.

Image alignment

To align images left or right you have to use #left and #right words with the hashtag at the end of the image path. Please, check the example below:

![My helpful screenshot]("/assets/screenshot.jpg#left")

7. Local Instalation

To set up Jekyll on local machine please follow the official documentation that can be found here -> https://jekyllrb.com/docs/.

8. Deployment

Sites built using Jekyll can be deployed in a large number of ways due to the static nature of the generated output. Here are some of the most common ways:

Manual Deployment

Jekyll generates your static site to the _site directory by default. You can transfer the contents of this directory to almost any hosting provider to get your site live. Here are some manual ways of achieving this:

Netlify

This theme is prepared to be hosted on Netlify. All you need to do is create a new private repository on GitHub or GitLab. Upload the theme to the repository and link your repo to Netlify. Please check this link with the step by step guidelines.

FTP

Most traditional web hosting providers let you upload files to their servers over FTP. To upload a Jekyll site to a web host using FTP, run the jekyll build command and copy the contents of the generated _site folder to the root folder of your hosting account. This is most likely to be the httpdocs or public_html folder on most hosting providers.

Amazon S3

If you want to host your site on Amazon S3, you can do so by using the s3_website application. It will push your site to Amazon S3 where it can be served like any web server, dynamically scaling to almost unlimited traffic.

9. Support

The documentation included provides all the information you need to get started with the theme. However, if you have any questions you can email us at hello@justgoodthemes.com, and we will be happy to help you.

Also, if you have any bug reports, or feature requests, please let us know!