Giter Club home page Giter Club logo

jekyll-serif-theme's Introduction

Jekyll Serif Theme

Serif is a modern business theme for Jekyll. It contains multiple content types for a typical brochure/marketing website. The theme is fully responsive, blazing fast and artfully illustrated.

Live Demo | Zerostatic Themes

Buy Me A Coffee

Jekyll Serif Theme screenshot

Theme features

  • Jekyll 4.2+
  • Netlify & Github Pages ready
  • Services (Collection)
  • Team (Collection)
  • Features (Data)
  • SCSS
  • 100% Responsive design, animated hamburger and mobile slide in menu
  • Bootstrap 4.6 - Only the bootstrap grid and utilites are imported by default. If you want to use more of the Boostrap library you can uncomment the @import in style.scss
  • 100/100 Google Lighthouse speed score
  • 100/100 Google Lighthouse seo score
  • 100/100 Google Lighthouse accessibility score
  • 100/100 Google Lighthouse best practices score
  • Under 50KB without images or 80KB with images and illustrations ⚡
  • Under 20KB without Google fonts ⚡⚡⚡
  • Robust example content included
  • Royalty free illustrations included

Installation

Installing Ruby & Jekyll

If this is your first time using Jekyll, please follow the Jekyll docs and make sure your local environment (including Ruby) is setup correctly.

Installing Theme

Download or clone the theme.

To run the theme locally, navigate to the theme directory and run:

bundle install

To start the Jekyll local development server.

bundle exec jekyll serve

To build the theme.

bundle exec jekyll build

Deployment

Netlify

Use Netlify to deploy this theme. This theme contains a valid and tested netlify.toml - Feel free to use the 1-click deploy below.

Deploy to Netlify

Github Pages

This theme has been tested to work with Github Pages (and Github Project Pages). When using Github Pages you will need to update the baseurl in the _config.yml otherwise all the css, images and paths will be broken.

For example the site https://zerostaticthemes.github.io/jekyll-serif-theme would have baseurl: "/jekyll-serif-theme/"

Extras

License

  • You cannot create ports of this theme
  • You cannot re-sell this theme

Credits

Support My Work

I've been building open source themes for all the main static site generators for over 4 years now. My premium themes allow me to continue to allocate time to maintain, improve and build new open source themes.

  1. Leave a star ⭐🙏🏻
  2. Make a contribution to this theme, add a feature, fix a bug, nothing is to small
  3. Mention this theme on twitter @zerostaticio 📢
  4. Purchase a premium theme 🔥

All Jekyll Themes by Zerostatic

🇦🇺 Made in Australia by Robert Austin

jekyll-serif-theme's People

Contributors

andreif avatar arnaud-m avatar dpshelio avatar jugglerx avatar kalehmann avatar ofekih avatar peter1357908 avatar pme8hw0krfqa avatar sanujar avatar viraat avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar

jekyll-serif-theme's Issues

adding jekyll-seo-tag and other minor issues

Hi - thank you for building this. I took the repo and made a few changes for my own site. I'm wondering if something like incorporating the jekyll-seo-tag (so it handles all the title/description) stuff would be useful. It's very easy, but I'm not sure if it's something you'd like to see in the project.

How to change text margin width?

Hello, awesome theme so far, this is great!

Clicking on the 'services' tab of the theme, I have text/image populating my whole window. Then I click the individual tabs under services (Accounting, Business Advisory, etc.) or if I click the 'About' tab the .md file text only fills up about 3/5 of the page width. Is there a way to change this so I can use more real estate? I assume this is referenced in the _layouts folder, but my untrained eyes cannot locate where.

I have a map that is difficult to see due to the size. I know I can increase the image width in my about.md file, but the text stays in the same margin width and makes the whole page look kind of goofy. Any help would be most appreciated!

Having trouble using as a GitHub Pages remote theme

When I add the following to my configuration file:

remote_theme: zerostaticthemes/jekyll-serif-theme
baseurl: username.github.io/site-repo/

I get this error:

Error: Invalid CSS after " margin-top: math": expected ";", was ".div($hamburger..." on line 60 Remote Theme: Cleaning up /tmp/jekyll-remote-theme-20240327-8-19mxtv2

which seems to be related to either the version of hamburgers or the version of sass. It's discussed here: https://issueantenna.com/repo/jonsuh/hamburgers/issues/116

Just a heads up that this is not working with remote_theme.

Unable to build the site due to SCSS error.

Hi,

I'm trying to build your theme and I'm having issue with bundle exec jekyll build.

Here are the gems versions:

Using public_suffix 5.0.1
Using addressable 2.8.4
Using bundler 2.3.25
Using colorator 1.1.0
Using concurrent-ruby 1.2.2
Using eventmachine 1.2.7
Using http_parser.rb 0.8.0
Using em-websocket 0.5.3
Using ffi 1.15.5
Using forwardable-extended 2.6.0
Using google-protobuf 3.23.3 (x86_64-linux)
Using i18n 1.14.1
Using sass-embedded 1.63.6 (x86_64-linux-musl)
Using jekyll-sass-converter 3.0.0
Using rb-fsevent 0.11.2
Using rb-inotify 0.10.1
Using listen 3.8.0
Using jekyll-watch 2.2.1
Using rexml 3.2.5
Using kramdown 2.4.0
Using kramdown-parser-gfm 1.1.0
Using liquid 4.0.4
Using mercenary 0.4.0
Using pathutil 0.16.2
Using rouge 4.1.2
Using safe_yaml 1.0.5
Using unicode-display_width 2.4.2
Using terminal-table 3.0.2
Using webrick 1.8.1
Using jekyll 4.3.2
Using jekyll-environment-variables 1.0.1

and here is the error that I get:

Configuration file: /srv/jekyll/_config.yml
            Source: /srv/jekyll
       Destination: /srv/jekyll/_site
 Incremental build: disabled. Enable with --incremental
      Generating... 
  Conversion error: Jekyll::Converters::Scss encountered an error while converting 'assets/css/style.scss':
                    Broken pipe
                    ------------------------------------------------
      Jekyll 4.3.2   Please append `--trace` to the `build` command 
                     for any additional information or backtrace. 
                    ------------------------------------------------
/usr/gem/gems/sass-embedded-1.63.6-x86_64-linux-musl/lib/sass/embedded/varint.rb:35:in `write': Broken pipe (Errno::EPIPE)
...
...

This goes further through the stack trace, I'm not including it for the brevity.

Can you please help? Thanks!

Images similar to the one already inserted

Hello,
I was wondering if there is a repository of svg images in the style you already put in the illustration folder.
It would be amazing since of course those two images don't fit every use case.

Thanks a lot for the amazing work

Team overview page does not link to individual pages

Hey all,

I am really happy about being able to use this theme, it's really clean and fun to work with!

I found that in the teams.html, there is no link to the individual pages from anywhere on the team member's pages. This is especially confusing since the promoted teams have their bio's truncated. I was able to verify that the pages were in fact rendered and exist on the site, I just don't think that there is any link that actually points to them.

I'm not sure if that was taken into consideration, but I thought it was worth bringing up as it was really the only part of the site that has been non-intuitive thus far. Keep up the good work!

Blog / News?

Hello,

Thank you for the amazing theme.

Is there a quick way to add a blog / news?

Best,
Bastiaan

home.html: Missing quotation marks in alt attribute in intro image

In home.html :

<img alt={{ page.title }} class="intro-image{% if page.intro_image_absolute %} intro-image-absolute{% endif %}{% if page.intro_image_hide_on_mobile %} intro-image-hide-mobile{% endif %}" src="{{ page.intro_image | relURL }}" />

Once the site is generated :

<img alt="Jekyll" serif="" theme="" class="intro-image intro-image-absolute intro-image-hide-mobile" src="images/illustrations/pointing.svg">

Solved in #44 with this solution :

<img alt="{{ page.title }}" class="intro-image{% if page.intro_image_absolute %} intro-image-absolute{% endif %}{% if page.intro_image_hide_on_mobile %} intro-image-hide-mobile{% endif %}" src="{{ page.intro_image | relURL }}" />

Pointing.svg is not aligned correctly on landing page.

image

The pointing.svg is not aligned correctly. [check the red box]

I am new to Jekyll so not sure where is the style sheet so I could fix it.

Can someone please fix and let me know so I can fix in my current project too as I have customized everything except this.

Trillion thanks in advance.

BR/MUnivercity

General project comments

Hi, firstly thanks for a great theme. Absolutely love working with it.

I'm wondering - it seems pretty popular with 146 stars and 178 forks - perhaps it would be worth considering some or all of the following:

  • It would be nice if git commit messages were a bit more explanatory - it's not that easy from git log to follow what has been done, one always needs to go into the commits.
  • In massive commits like 570b0b4, it would be great to know what the thinking was behind the changes. My site is simple, yet it was pretty challenging to rebase on this commit when I wanted to pull in the latest changes. Perhaps a CHANGELOG.md?
  • Perhaps using Pull Requests would provide part of a framework for the above?

Again, no complaints, just food for thought. :)

Ruby Sass deprecated

From initial install:


Ruby Sass is deprecated and will be unmaintained as of 26 March 2019.

* If you use Sass as a command-line tool, we recommend using Dart Sass, the new
  primary implementation: https://sass-lang.com/install

* If you use Sass as a plug-in for a Ruby web framework, we recommend using the
  sassc gem: https://github.com/sass/sassc-ruby#readme

* For more details, please refer to the Sass blog:
  http://sass.logdown.com/posts/7081811```

Error after running : bundle exec jekyll serve

Hi,

Thank you for the good work.

I tried to run bundle exec jekyll serve but it is giving me an erro below:



bundler: failed to load command: jekyll (/Users/shmuhammad/Document/Git/myproject/jekyll-serif-theme/vendor/bundle/ruby/2.6.0/bin/jekyll)
LoadError: cannot load such file -- google/protobuf_c
  /Users/shmuhammad/Document/Git/myproject/jekyll-serif-theme/vendor/bundle/ruby/2.6.0/gems/google-protobuf-3.21.12-x86_64-darwin/lib/google/protobuf.rb:51:in `require'
  /Users/shmuhammad/Document/Git/myproject/jekyll-serif-theme/vendor/bundle/ruby/2.6.0/gems/google-protobuf-3.21.12-x86_64-darwin/lib/google/protobuf.rb:51:in `rescue in <top (required)>'
  /Users/shmuhammad/Document/Git/myproject/jekyll-serif-theme/vendor/bundle/ruby/2.6.0/gems/google-protobuf-3.21.12-x86_64-darwin/lib/google/protobuf.rb:48:in `<top (required)>'
  /Users/shmuhammad/Document/Git/myproject/jekyll-serif-theme/vendor/bundle/ruby/2.6.0/gems/sass-embedded-1.57.1-x86_64-darwin/ext/sass/embedded_sass_pb.rb:4:in `require'
  /Users/shmuhammad/Document/Git/myproject/jekyll-serif-theme/vendor/bundle/ruby/2.6.0/gems/sass-embedded-1.57.1-x86_64-darwin/ext/sass/embedded_sass_pb.rb:4:in `<top (required)>'
  /Users/shmuhammad/Document/Git/myproject/jekyll-serif-theme/vendor/bundle/ruby/2.6.0/gems/sass-embedded-1.57.1-x86_64-darwin/lib/sass/embedded.rb:4:in `require_relative'
  /Users/shmuhammad/Document/Git/myproject/jekyll-serif-theme/vendor/bundle/ruby/2.6.0/gems/sass-embedded-1.57.1-x86_64-darwin/lib/sass/embedded.rb:4:in `<top (required)>'
  /Users/shmuhammad/Document/Git/myproject/jekyll-serif-theme/vendor/bundle/ruby/2.6.0/gems/sass-embedded-1.57.1-x86_64-darwin/lib/sass-embedded.rb:4:in `require_relative'
  /Users/shmuhammad/Document/Git/myproject/jekyll-serif-theme/vendor/bundle/ruby/2.6.0/gems/sass-embedded-1.57.1-x86_64-darwin/lib/sass-embedded.rb:4:in `<top (required)>'
  /Users/shmuhammad/Document/Git/myproject/jekyll-serif-theme/vendor/bundle/ruby/2.6.0/gems/jekyll-sass-converter-3.0.0/lib/jekyll/converters/scss.rb:8:in `require'
  /Users/shmuhammad/Document/Git/myproject/jekyll-serif-theme/vendor/bundle/ruby/2.6.0/gems/jekyll-sass-converter-3.0.0/lib/jekyll/converters/scss.rb:8:in `<top (required)>'
  /Users/shmuhammad/Document/Git/myproject/jekyll-serif-theme/vendor/bundle/ruby/2.6.0/gems/jekyll-sass-converter-3.0.0/lib/jekyll-sass-converter.rb:4:in `require'
  /Users/shmuhammad/Document/Git/myproject/jekyll-serif-theme/vendor/bundle/ruby/2.6.0/gems/jekyll-sass-converter-3.0.0/lib/jekyll-sass-converter.rb:4:in `<top (required)>'
  /Users/shmuhammad/Document/Git/myproject/jekyll-serif-theme/vendor/bundle/ruby/2.6.0/gems/jekyll-4.3.1/lib/jekyll.rb:195:in `require'
  /Users/shmuhammad/Document/Git/myproject/jekyll-serif-theme/vendor/bundle/ruby/2.6.0/gems/jekyll-4.3.1/lib/jekyll.rb:195:in `<top (required)>'
  /Users/shmuhammad/Document/Git/myproject/jekyll-serif-theme/vendor/bundle/ruby/2.6.0/gems/jekyll-4.3.1/exe/jekyll:8:in `require'
  /Users/shmuhammad/Document/Git/myproject/jekyll-serif-theme/vendor/bundle/ruby/2.6.0/gems/jekyll-4.3.1/exe/jekyll:8:in `<top (required)>'
  /Users/shmuhammad/Document/Git/myproject/jekyll-serif-theme/vendor/bundle/ruby/2.6.0/bin/jekyll:23:in `load'
  /Users/shmuhammad/Document/Git/myproject/jekyll-serif-theme/vendor/bundle/ruby/2.6.0/bin/jekyll:23:in `<top (required)>'

Please, can you kindly advise.

Thank you.

Using a blog with this template

Does anyone have a good example they can share? I have found a few blogs that I am interested in seeing if I can add to this template. Also I am new to this so I was looking for the proper label for this

Search menu

Hello and thanks for this amazing theme !
Is there any plan to add a search menu for this theme ?

Thanks
regards

gh-pages and master branches have different functionality

I am building a website for a student research lab with GitHub pages. This theme looks fantastic, but when I try to deploy it, I run into some issues.

The gh-pages branch automatically generates a functional website after I change baseurl in _config.yml, but it seems to lack some of the functionality or layout details available in the master branch. In particular, the teams page does not include pictures of individuals who do not have the promoted tag set to true.

Using the master branch in GitHub Pages does not work, and I think the logs show the following errors:

Warning:  github-pages can't satisfy your Gemfile's dependencies.
To use retry middleware with Faraday v2.0+, install `faraday-retry` gem
  Conversion error: Jekyll::Converters::Scss encountered an error while converting 'assets/css/style.scss':
                    Invalid CSS after " margin-top: math": expected ";", was ".div($hamburger..." on line 60
/usr/local/bundle/gems/jekyll-sass-converter-1.5.2/lib/jekyll/converters/scss.rb:123:in `rescue in convert': Invalid CSS after "  margin-top: math": expected ";", was ".div($hamburger..." on line 60 (Jekyll::Converters::Scss::SyntaxError)

and

	from /usr/local/bundle/gems/github-pages-228/bin/github-pages:6:in `<top (required)>'
	from /usr/local/bundle/bin/github-pages:23:in `load'
	from /usr/local/bundle/bin/github-pages:23:in `<main>'
/github/workspace/_sass/libraries/hamburgers/_base.scss:60: Invalid CSS after "  margin-top: math": expected ";", was ".div($hamburger..." (Sass::SyntaxError)
	from /github/workspace/_sass/libraries/hamburgers/hamburgers.scss:68
	from (sass):79

I was wondering if there was any way to deploy this site easily on GitHub such that the progress and corrections made on the main branch can be available on GitHub Pages deployment (for someone with limited knowledge about how to edit these things).

Thanks for a great theme and for any guidance you might be able to offer.

The mobile menu does not work with the baseurl

Steps to reproduce

Checkout the jekyll-serif-theme repository

git clone https://github.com/zerostaticthemes/jekyll-serif-theme.git

Install all dependencies

cd jekyll-serif-theme
bundle install

Set the parameter baseurl inside the file _config.yaml, e.g. to subpath

sed -i "s/baseurl: ''/baseurl: '\/subpath'/g" _config.yml

Serve the site

bundle exec jekyll serve

Open the site /subpath in the Browser, switch to the "Responsive Design Mode" and then open the mobile menu and click onone of the links, e.g. "About" or "Contact".

Expected behavior

Clicking on a link would lead me to /subpath/<target>, e.g. /subpath/about/ or /subpath/contact/

Details

The problem originates in the file _includes/main-menu-mobile.html.

{% for item in mainmenu %}
<li class="{% if item.url == page.url %}active{% endif %}">
    <a href="{{ item.url }}">{{ item.name }}</a>
</li>
{% endfor %}

The link target is taken directly from _data/menus.yml without concatenation of the baseurl.

Possible solutions

Use the relative_url filter as in _includes/main-menu.html.

Fontawesome Icons

Sorry but I am new to this. I am trying to include a fontawesome icon on my page and it is not showing. I tried including it in the buttons, footer and text but it won't show the icon.

Replace `math.div(x, y)` with `(x/y)`

In order to run locally I needed to change _sass/libraries/hamburgers/_base.scss and _sass/libraries/hamburgers/types/_slider.scss to replace the use of math.div(x, y) with (x/y)

Changing Serif Theme Color and webpage tab icon

Hello, I forked your Serif Jekyll theme and I am struggling with how to change the primary colors of the theme. For instance, the repository I forked from you has Red as the primary color, I see the demo image however is Blue, I’d like it to be a shade of green. EDIT: I found the answer to this question in assets -> css -> style.scss.

I found the webpage logo, but can’t find the place where the ‘favicon-32x32.svg’ is referenced so I can change the icon that appears on the webpage tab. But I suppose I could swap a different file with the same name and it might work.

Query regarding SEO: Site not showing up on searches

Thanks a lot for such a beautiful and clean design. I have added the meta descriptions and other details needed for the SEO. However, even after 2 days of publishing the website, I do not see the website appearing when I search it on google or safari. I have gone further and added meta keywords to the index.md and subsequently to default.html. I researched online for SEO with Jekyll and see that jekyll-seo-plugin is very popular amongst jekyll developers. But, I do not see that plugin being called in the GEM file or config.yaml. If not a particular plugin, how does the seo of this template navigate? I am a beginner and still very much in the learning process, so apologies if the query is quite obvious/basic. Thank you in advance for your help.

What is intro_image_absolute used for?

As per subject really - I saw the images moving around when I added or removed text on the left of the intro row, then I noticed the hard-coded widths. After digging into the _sass/components/_intro-image.scss, I saw that this was done on purpose.

Setting intro_image_absolute: false worked well for me, but I'd be interested to know the use case for true.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.