Skip to content

Commit

Permalink
0.1.0 🚀
Browse files Browse the repository at this point in the history
  • Loading branch information
zcraber committed Nov 6, 2024
1 parent 1c9db60 commit f58832f
Show file tree
Hide file tree
Showing 14 changed files with 325 additions and 2 deletions.
6 changes: 6 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
*.gem
.bundle
.jekyll-cache
.sass-cache
_site
Gemfile.lock
2 changes: 2 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
# [0.1.0](https://github.com/digitalmalayalistudio/unstruction-jekyll-theme/releases/tag/v0.1.0) (06-11-2024)
- Initial release.
6 changes: 6 additions & 0 deletions Gemfile
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
# frozen_string_literal: true

source "https://rubygems.org"
gemspec

gem 'wdm', '>= 0.1.0' if Gem.win_platform?
21 changes: 21 additions & 0 deletions LICENSE.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
The MIT License (MIT)

Copyright (c) 2024 zcraber

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
131 changes: 129 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,129 @@
# unstruction-jekyll-theme
Unstruction is a free Jekyll theme for setting up a simple and easy 'website under construction' page.
<div align="center">

# Unstruction

[![Static Badge](https://img.shields.io/badge/jekyll-~%3E%204.3-grey?logo=jekyll&labelColor=%23CC0000)](https://jekyllrb.com)
[![Gem Version](https://img.shields.io/gem/v/unstruction-jekyll-theme?logo=rubygems&logoColor=white&labelColor=%23E9573F&color=grey)](https://rubygems.org/gems/unstruction-jekyll-theme)
[![Gem Total Downloads](https://img.shields.io/gem/dt/unstruction-jekyll-theme?logo=rubygems&logoColor=white&labelColor=%23E9573F&color=grey)](https://rubygems.org/gems/unstruction-jekyll-theme)

[![Static Badge](https://img.shields.io/badge/html-template-grey?logo=html5&logoColor=white&labelColor=E34F26)](https://github.com/digitalmalayalistudio/unstruction)

[![Static Badge](https://img.shields.io/badge/liberapay-donate-F6C915?logo=liberapay)](https://liberapay.com/zcraber)

A minimal, lightweight, easy and free Jekyll theme to create a 'website under construction' page.

[![mockup](mockup.png)](https://digitalmalayalistudio.github.io/unstruction-jekyll-theme/)

[**Live Demo ◉**](https://digitalmalayalistudio.github.io/unstruction-jekyll-theme/)

</div>

## Contents
- [Unstruction](#unstruction)
- [Contents](#contents)
- [Features](#features)
- [Installation](#installation)
- [Use GitHub Template (Easiest Way)](#use-github-template-easiest-way)
- [Install as GitHub Remote Theme](#install-as-github-remote-theme)
- [Install as Ruby Gem](#install-as-ruby-gem)
- [Configuration](#configuration)
- [`_config.yml`](#_configyml)
- [Contributing](#contributing)
- [Development](#development)
- [License](#license)

## Features
- 😊 Based on the [Unstruction](https://github.com/digitalmalayalistudio/unstruction) template.
- 👞 Powered by [Shoelace](https://shoelace.style/), an amazing web components library.
- ⏱️ Displays a countdown timer until the website launch date.
- 🌙 Automatically chooses dark/light mode based on user's system preference.
- ☎️ Option to show the necessary contact info.

## Installation
There are multiple ways to install and set up Unstruction. Let's explore each of them.

### Use GitHub Template (Easiest Way)
If you need the quickest way to set this up or if you're a complete beginner to Jekyll, using the GitHub template is the easiest option. Setting this up doesn't require any coding skills. You can also fork the repo.

1. Visit [Unstruction](https://github.com/digitalmalayalistudio/unstruction-jekyll-theme) theme repository.
2. Click the **Use this template** button.
3. Select **Create a new repository**.
4. Give it a name and click **Create repository**.
5. Edit the `_config.yml` file for customization. Check the [Configuration](#configuration) guide for details.
6. Go to **Settings** > **Pages**. Under **Build and deployment**, select **GitHub Actions** as the source.
7. If you have a [custom domain](https://docs.github.com/articles/using-a-custom-domain-with-github-pages/), you can enter it. Otherwise, you can view the published website at `https://<username>.github.io/unstruction-jekyll-theme` once the building is complete!

### Install as GitHub Remote Theme
Go to your site's `_config.yml` and replace `theme:` with `remote_theme: digitalmalayalistudio/unstruction-jekyll-theme`.

### Install as Ruby Gem
Add this line to your Jekyll site's `Gemfile`:

```ruby
gem "unstruction-jekyll-theme"
```

And add this line to your Jekyll site's `_config.yml`:

```yaml
theme: unstruction-jekyll-theme
```
And then execute:
$ bundle
Or install it yourself as:
$ gem install unstruction-jekyll-theme
## Configuration
Unstruction is super-easy to customize! There is only one `layout` and that is [default.html](_layouts/default.html).

Edit the [_config.yml](_config.yml) file to add your website's name, favicon, image, color theme, launch date and contact details.

### `_config.yml`
```yml
# Jekyll
theme: unstruction-jekyll-theme
# Site Configuration
name: Unstruction # Name of your website
favicon: assets/favicon.svg # SVG favicon of your website
url: https://digitalmalayalistudio.github.io/linkhub-jekyll-theme # URL of your website
image: assets/preview.webp # Also used for SEO (og:image)
color: orange # Preferred theme color based on the Shoelace color tokens. Visit https://shoelace.style/tokens/color#theme-tokens.
date: Jan 1, 3000, 00:00:00 # Set the planned launch date and time in an ISO 8601 format or use the format shown in the example. Time is optional. Remove this variable if you don't need a countdown.
# Contacts
phone: +91123456789 #Remove any that are not needed
mail: mail@example.com
whatsapp: 91123456789
location: https://maps.google.com/location
# Defaults
defaults:
-
scope:
path: ""
values:
layout: "default"
# Exclude
exclude: [README.md, Gemfile.lock, .jekyll-cache/, .github/, CHANGELOG.md, Gemfile, LICENSE.txt, funding.yml, unstruction-jekyll-theme.gemspec]
```

## Contributing
[Bug reports](https://github.com/digitalmalayalistudio/unstruction-jekyll-theme) and [pull requests](https://github.com/digitalmalayalistudio/unstruction-jekyll-theme/pulls) are welcome. If you like this theme, please give it a star! And if you've used this theme on your website, feel free to add it below.

## Development
To set up your environment to develop this theme, run `bundle install`.

Your theme is set up just like a normal Jekyll site! To test your theme, run `bundle exec jekyll serve` and open your browser at `http://localhost:4000`. This starts a Jekyll server using your theme. Add pages, documents, data, etc. like normal to test your theme's contents. As you make modifications to your theme and to your content, your site will regenerate and you should see the changes in the browser after a refresh, just like normal.

When your theme is released, only the files in [_layouts](_layouts), [_includes](_includes), [_data](_data) and [assets](assets) tracked with Git will be bundled.

To add a custom directory to your theme-gem, please edit the regexp in [unstruction-jekyll-theme.gemspec](unstruction-jekyll-theme.gemspec) accordingly.

## License
The theme is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
27 changes: 27 additions & 0 deletions _config.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
# Jekyll
theme: unstruction-jekyll-theme

# Site Configuration
name: Unstruction # Name of your website
favicon: assets/favicon.svg # SVG favicon of your website
url: https://digitalmalayalistudio.github.io/linkhub-jekyll-theme # URL of your website
image: assets/preview.webp # Also used for SEO (og:image)
color: orange # Preferred theme color based on the Shoelace color tokens. Visit https://shoelace.style/tokens/color#theme-tokens.
date: Jan 1, 3000, 00:00:00 # Set the planned launch date and time in an ISO 8601 format or use the format shown in the example. Time is optional. Remove this variable if you don't need a countdown.

# Contacts
phone: +91123456789 #Remove any that are not needed
mail: mail@example.com
whatsapp: 91123456789
location: https://maps.google.com/location

# Defaults
defaults:
-
scope:
path: ""
values:
layout: "default"

# Exclude
exclude: [README.md, Gemfile.lock, .jekyll-cache/, .github/, CHANGELOG.md, Gemfile, LICENSE.txt, funding.yml, unstruction-jekyll-theme.gemspec]
25 changes: 25 additions & 0 deletions _includes/contacts.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
<br><small>Feel free to reach out to us.</small>
<div slot="footer">
<sl-button-group label="Alignment">
{% if site.phone %}
<sl-button size="medium" circle href="tel:{{ site.phone }}">
<sl-icon name="telephone" label="Phone"></sl-icon>
</sl-button>
{% endif %}
{% if site.mail %}
<sl-button size="medium" circle href="mailto:{{ site.mail }}">
<sl-icon name="envelope" label="Mail"></sl-icon>
</sl-button>
{% endif %}
{% if site.whatsapp %}
<sl-button size="medium" circle href="https://wa.me/{{ site.whatsapp }}">
<sl-icon name="whatsapp" label="WhatsApp"></sl-icon>
</sl-button>
{% endif %}
{% if site.location %}
<sl-button size="medium" circle href="{{ site.location }}" target="_blank">
<sl-icon name="geo-alt" label="Map"></sl-icon>
</sl-button>
{% endif %}
</sl-button-group>
</div>
77 changes: 77 additions & 0 deletions _layouts/default.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,77 @@
<!DOCTYPE html>
<html lang="en">

<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description"
content="This website is under construction. Please check back later.">
<meta property="og:title" content="{{ site.name }} - Under Construction">
<meta property="og:description"
content="This website is under construction. Please check back later.">
<meta property="og:type" content="website">
<meta property="og:url" content="{{ site.url }}">
<meta property="og:image" content="{{ site.url }}/{{ site.image }}">
<title>{{ site.name }} - Under Construction</title>
<link rel="icon" href="{{ site.favicon }}" type="image/svg+xml">
<script src="https://cdn.jsdelivr.net/npm/@shoelace-style/shoelace@2.18.0/dist/utilities/shoelace.js"
data-shoelace="https://cdn.jsdelivr.net/npm/@shoelace-style/shoelace@2.0.0/dist/"></script>
<link rel="stylesheet" media="(prefers-color-scheme:light)"
href="https://cdn.jsdelivr.net/npm/@shoelace-style/shoelace@2.18.0/cdn/themes/light.css" />
<link rel="stylesheet" media="(prefers-color-scheme:dark)"
href="https://cdn.jsdelivr.net/npm/@shoelace-style/shoelace@2.18.0/cdn/themes/dark.css"
onload="document.documentElement.classList.add('sl-theme-dark');" />
<script type="module"
src="https://cdn.jsdelivr.net/npm/@shoelace-style/shoelace@2.18.0/cdn/components/card/card.js"></script>
{% if site.phone or site.mail or site.whatsapp or site.location %}
<script type="module"
src="https://cdn.jsdelivr.net/npm/@shoelace-style/shoelace@2.18.0/cdn/components/button/button.js"></script>
<script type="module"
src="https://cdn.jsdelivr.net/npm/@shoelace-style/shoelace@2.18.0/cdn/components/icon/icon.js"></script>
<style>
.card-overview small{ color: var(--sl-color-neutral-700);} .card-overview [slot='footer']{ display: flex; justify-content: space-between; align-items: center;} sl-button::part(base){ color: var(--sl-color-gray-50); background-color: var(--theme-color-600); border-color: var(--theme-color-300);} sl-button::part(base):hover{ background-color: var(--theme-color-500);}
</style>
{% endif %}
<script type="module"
src="https://cdn.jsdelivr.net/npm/@shoelace-style/shoelace@2.18.0/cdn/components/icon-button/icon-button.js"></script>
<script type="module"
src="https://cdn.jsdelivr.net/npm/@shoelace-style/shoelace@2.18.0/cdn/components/button-group/button-group.js"></script>
<script type="module"
src="https://cdn.jsdelivr.net/npm/@shoelace-style/shoelace@2.18.0/cdn/components/badge/badge.js"></script>
<style>
:root {
--theme-color-300: var(--sl-color-{{ site.color | downcase }}-300);
--theme-color-500: var(--sl-color-{{ site.color | downcase }}-500);
--theme-color-600: var(--sl-color-{{ site.color | downcase }}-600);
}
body{ min-height: 100dvh; display: flex; flex-direction: column; justify-content: center; align-items: center; font-family: var(--sl-font-sans); line-height: var(--sl-line-height-normal);} .card-overview{ max-width: 350px;} sl-badge::part(base){ background-color: var(--theme-color-600); --pulse-color: var(--theme-color-600);} sl-icon-button::part(base):hover{ color: var(--theme-color-600);} .copyright{ color: var(--sl-color-neutral-600); text-align: center; margin-top: 2rem;} .copyright a{ color: var(--theme-color-600);}
</style>
</head>

<body>
<sl-card class="card-overview">
<img slot="image" src="assets/preview.webp" alt="{{ site.name }} - Under Construction" width="350">
<strong>Unstruction</strong><br>
This website is under construction.
{% if site.date %}
<br>Please check back later in <sl-badge pill pulse
class="days"></sl-badge> days, <sl-badge pill pulse class="hr"></sl-badge> hours, <sl-badge
pill pulse class="min"></sl-badge> minutes and <sl-badge pill pulse
class="sec"></sl-badge> seconds!
<script>
const id=setInterval(timer, 1000); function timer(){ const target=new Date('{{ site.date}}').getTime(); const current=new Date().getTime(); const diff=target - current; const s=1000; const m=s * 60; const h=m * 60; const d=h * 24; let days=Math.floor(diff / d); let hr=Math.floor((diff % d) / h); let min=Math.floor((diff % h) / m); let sec=Math.floor((diff % m) / s); document.querySelector('.days').textContent=days; document.querySelector('.hr').textContent=hr; document.querySelector('.min').textContent=min; document.querySelector('.sec').textContent=sec; if (diff <=0){ clearInterval(id); document.querySelector('.days').textContent='0'; document.querySelector('.hr').textContent='0'; document.querySelector('.min').textContent='0'; document.querySelector('.sec').textContent='0';}} timer();
</script>
{% else %}
<br>Please check back later!
{% endif %}
{% if site.phone or site.mail or site.whatsapp or site.location %}
{% include contacts.html %}
{% endif %}
</sl-card>

<small class="copyright"><sl-icon-button name="github" label="Settings" style="font-size: 1.2rem;"
href="https://github.com/digitalmalayalistudio/unstruction-jekyll-theme/"
target="_blank"></sl-icon-button><br>Unstruction v{{ theme.version }} by
<a href="http://studio.digitalmalayali.in/">Digital Malayali Studio</a><br>
© {{ "now" | date: "%Y" }} {{ site.name }}</small>
</body>
5 changes: 5 additions & 0 deletions assets/favicon.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/preview.webp
Binary file not shown.
1 change: 1 addition & 0 deletions funding.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
liberapay: zcraber
2 changes: 2 additions & 0 deletions index.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
---
---
Binary file added mockup.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
24 changes: 24 additions & 0 deletions unstruction-jekyll-theme.gemspec
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
Gem::Specification.new do |spec|
spec.name = "unstruction-jekyll-theme"
spec.version = "0.1.0"
spec.authors = ["Digital Malayali Studio"]
spec.email = ["studio@digitalmalayali.in"]

spec.summary = "Unstruction is a free Jekyll theme for setting up a simple and easy 'website under construction' page."
spec.homepage = "https://digitalmalayalistudio.github.io/linkhub-jekyll-theme"
spec.license = "MIT"

spec.metadata = {
"bug_tracker_uri" => "https://github.com/digitalmalayalistudio/unstruction-jekyll-theme/issues",
"changelog_uri" => "https://github.com/digitalmalayalistudio/unstruction-jekyll-theme/blob/main/CHANGELOG.md",
"documentation_uri" => "https://github.com/digitalmalayalistudio/unstruction-jekyll-theme#readme",
"source_code_uri" => "https://github.com/digitalmalayalistudio/unstruction-jekyll-theme",
"funding_uri" => "https://liberapay.com/zcraber"
}

spec.files = `git ls-files -z`.split("\x0").select { |f| f.match(%r!^(assets|_data|_layouts|_includes|LICENSE|README|_config\.yml)!i) }

spec.add_runtime_dependency "jekyll", "~> 4.3"

spec.add_development_dependency "bundler", "~> 2.4"
end

0 comments on commit f58832f

Please sign in to comment.