Giter Site home page Giter Site logo

itstorque / sandslate Goto Github PK

View Code? Open in Web Editor NEW
2.0 1.0 0.0 274 KB

A Minimal Portfolio Theme for Jekyll Sites

License: MIT License

HTML 34.24% Ruby 1.07% CSS 59.89% JavaScript 4.80%
jekyll-theme website minimal-portfolio-theme minimal-theme theme

sandslate's Introduction

Sandslate

A Minimal Portfolio Theme for Jekyll Sites.

Sandslate is a customizable light-weight minimal theme you can use on your jekyll site, whether you are hosting on GitHub or your own servers. Whether you want a minimal personal portfolio to showcase your work, log your journeys or put your art on, Sandslate is an awesome theme you can use to spice up that portfolio easily.

Preview the theme on Sandslate's official page: tareqdandachi.github.io/sandslate.

Theme Properties & Customization

Color Theme

The theme's default color scheme is the light-mode theme, however, this can be changed in the site's settings in _config.yml to be in dark mode as such:

color_mode: dark

The allowed values are light and dark, otherwise it will default to light-mode.

Alignment

Changing the alignment of the site affect where the navigation sidebar is and some behavior of the content to match a right-aligned theme. A right-aligned theme can be chosen for aesthetic purposes, standing out and/or better support for right-to-left languages.

Site Definition:

You can change your whole site's alignment in _config.yml by adding:

right_aligned: true

By default, the property is set to false, meaning that it should be left aligned.

Page Definition:

You can also overwrite the site definition by changing the alignment parameter of a page in its front-matter. If left undefined or defined incorrectly, it will default to the site definition of alignment.

The valid values for the alignment parameter are 'left' and 'right', otherwise it will default to the site definition. Here is an example of what front-matter with a page defined alignment might look like:

title: Home
layout: home
alignment: left

Changing the main fonts

This theme uses 3 main fonts: 'Allison Script', 'Dancing Script', 'Hind'.

However, these fonts can all be changed in the _config.yml:

logo_font: 'Allison Script'
title_font: 'Dancing Script'
content_font: 'Hind'

You can also import the fonts from an external link using the font-link-source parameter in _config.yml:

font_link_source: 'https://fonts.googleapis.com/css?family=Dancing+Script:400,700|Hind:300,500,600&display=swap'

You can also resort to adding fonts manually by editing _includes/head.html or assets/css/fonts.css.

Customizing content

Multiple Columns of Text

This theme support putting text (<p> tags) into multiple columns on devices that have a large enough window width. This mainly means laptops and tablets will view them as multiple columns while mobile devices preview it as one block of text.

To do so you can add the class multicols or multicols3 to your text. multicols results in the paragraph being seperated into 2 equal width columns, while multicols3 splits them into 3 columns.

See how to add classes in markdown for further details on adding classes to markdown.

Adding Images

Adding images in markdown is done as such:

![IMAGE](https://images.unsplash.com/photo-1554296048-b59c9fca4857?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=1966&q=80)

This theme comes with multiple image types, the default being change this. Here is a table of properties of images:


FILL: THIS IN: LATER

Image Embedded Titles

FILL THIS IN LATER

Adding Custom Stylesheets and Scripts

You can specify a stylesheet and script to accompany a page in your page's front matter, with the following attributes: stylesheet and script. This is an example of a valid front matter with a custom css and js file

---
title: 'Home'
layout: home

stylesheet: assets/home.css
script: home.js
---

How to add classes in markdown

To add a class to markdown, you can use {:.class} to the beginning of the paragraph. For example, to add the class multicols to a paragraph, it would look like this:

{:.multicols}
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

The result would be similar to doing that in HTML as such:

<p class="multicols">
  Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
</p>

sandslate's People

Contributors

dependabot[bot] avatar itstorque avatar

Stargazers

 avatar  avatar

Watchers

 avatar

sandslate's Issues

Dynamic logo width

Change max-width property of #page-title based on width of first word in site.page_title

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.